Facturas de Proveedores

Esta API facilita la incorporación de diferentes tipos de comprobantes, entre ellos Compra Crédito, Compra Contado, y sus respectivas notas correctivas. Además, admite Movimientos de Stock de Proveedores en las modalidades de Pedidos y Remitos, así como Recibos de Pago.

• Requisitos de Uso: La API demanda una comprensión profunda de la configuración de la empresa, haciéndose necesaria la intervención de usuarios responsables para garantizar la fidelidad de los movimientos generados.
• Funcionalidades Específicas: Esta API está diseñada con el propósito exclusivo de incorporar nuevos movimientos, sin la capacidad de modificar movimientos previamente establecidos.
• Capacidades Expandidas: La API también ofrece funcionalidades para la generación de datos relativos a ventas, compras detalladas y balances pendientes de comprobantes de proveedores.

URL

• Descripción: https://api.zetasoftware.com/z.apis.asoapfacturaproveedorv1?wsdl
• Servicio: https://api.zetasoftware.com/z.apis.asoapfacturaproveedorv1

Método Agregar

Este método posibilita la generación de comprobantes en diversas categorías, tales como Compra Contado, Compra Contado de Gastos, Compra Crédito, Compra Crédito de Gastos, además de sus respectivas notas correctivas. Asimismo, se pueden incorporar Movimientos de Stock de Proveedores (remitos y pedidos) y Recibos de Pago.

Filtros

• CodigoComprobante: N(3) – Obligatorio. Define el tipo de movimiento.
• Serie: T(6) – Si el comprobante es un CFE, se asignará automáticamente al momento de emitir. Si no es un CFE, si no tiene Formato de Impresión y tiene Numerador asignado, la Serie se generará en forma automática.
• Numero: N(10) – Si el comprobante es un CFE, se asignará automáticamente al momento de emitir. Si no es un CFE, si no tiene Formato de Impresión y tiene Numerador asignado, el número se generará en forma automática.
• Fecha: AAAAMMDD – Obligatorio.
• CodigoMoneda: N(2) – Obligatorio.
• Cotizacion: N(7.7)
• CodigoProveedor: N(10)
• CodigoCondicionPago: N(3)
• CodigoDepositoOrigen: N(3)
• CodigoDepositoDestino: N(3)
• CodigoCentroCosto: T(10)
• CodigoReferencia: N(10)
• Notas: T(30)
• CodigoLocal: N(3)
• CodigoUsuario: N(3)
• CodigoCaja: N(3)

Líneas del Comprobante

• CodigoArticulo:
  • T(20) para Artículos en comprobantes de compra – Obligatorio.
  • T(10) para Conceptos en comprobantes de compra de gastos – Obligatorio.
• Concepto: T(50)
• CodigoLote: T(20) – Código del Lote del Artículo. Su aportación es imperativa si el artículo opera con lotes.
• Vencimiento: T(AAAA-MM-DD) – Fecha de vencimiento del lote del artículo. Su inclusión es mandatoria si el artículo tiene fechas de vencimiento asociadas.
• Cantidad: N(17.5) – Obligatorio y debe ser mayor a cero.
• PrecioUnitario: N(17.5) – Debe incluir o excluir el IVA, según lo dictamine la configuración del comprobante. ZetaSoftware calculará automáticamente el Neto, IVA y Total de las líneas del movimiento y el total del movimiento en función de diversas variables como la configuración del IVA del comprobante, el estatus impositivo del cliente y el IVA del artículo.
• Descuento1, Descuento2, Descuento3: N(5.2) – Los descuentos son opcionales y, si no aplican, deben consignarse como cero. En comprobantes de compra de gastos, estos campos deben ser siempre cero, ya que no se admiten descuentos.
• CodigoIVA: N(2) – Este campo puede o no coincidir con el código de IVA del artículo y es determinante para el cálculo del IVA en el movimiento.
• Notas: T(1000)

Formas de Pago

• CodigoFormaPago: N(3) – Define el método de pago empleado. Esto puede ser Efectivo, Cheque Recibido, Tarjeta de Crédito, Movimiento Bancario o Documento Recibido.
• CodigoMonedaPago: N(2) – Identifica la moneda en la que se efectuará el pago.
• MontoMonedaPago: N(17.2) – Especifica el monto pagado y este se expresa en la moneda del código previamente mencionado.
• MontoMonedaMovimiento: N(17.2) – Este es el monto en la moneda del movimiento. Es esencial que el total de las formas de pago coincida con el total del movimiento y la suma del total de las líneas del movimiento.

Resultado

Ok / Error / Mensaje

Método QueryCompras

El siguiente método se conoce como QueryCompras. Este método es particularmente útil para obtener información detallada acerca de los comprobantes de compra de un proveedor que ha sido registrado en el sistema de ZetaSoftware.

• Filtros:
  • Mes: T(MM) – Obligatorio.
  • Año: T(AAAA) – Obligatorio.
  • FechaDesde: AAAA-MM-DD
  • FechaHasta: AAAA-MM-DD
  • ProveedorCodigo: T(10) – Obligatorio.
  • ComprobanteCodigo: N(3)
  • MonedaCodigo: N(2)
  • LocalCodigo: N(3)
  • Page: N(2) – Obligatorio.
• Resultado:
  • RegistroId
  • Fecha
  • ComprobanteCodigo
  • ComprobanteNombre
  • ComprobanteTipo
  • ComprobanteTipoNombre
  • EsGasto
  • Serie
  • Numero
  • ProveedorCodigo
  • ProveedorNombre
  • ProveedorRazonSocial
  • ProveedorPaisCodigo
  • ProveedorPaisNombre
  • ProveedorDepartamentoCodigo
  • ProveedorDepartamentoNombre
  • ProveedorGrupoCodigo
  • ProveedorGrupoNombre
  • ProveedorGiroCodigo
  • ProveedorGiroNombre
  • ProveedorZonaCodigo
  • ProveedorZonaNombre
  • ProveedorCategoriaCodigo
  • ProveedorCategoriaNombre
  • MonedaCodigo
  • MonedaSimbolo
  • CotizacionEspecial
  • CondicionCodigo
  • CondicionNombre
  • LocalCodigo
  • LocalNombre
  • CajaCodigo
  • CajaNombre
  • CentroCostosCodigo
  • CentroCostosNombre
  • Referencia
  • DepositoOrigenCodigo
  • DepositoOrigenNombre
  • DepositoDestinoCodigo
  • DepositoDestinoNombre
  • Subtotal
  • SubtotalSigno
  • IVA
  • IVASigno
  • Total
  • TotalSigno
  • Saldo
  • SaldoSigno
  • Emitido
  • UsuarioCodigo
  • UsuarioNombre
  • RegistroFecha
  • RegistroHora

Método QueryMovimientosStock

Este método proporciona detalles sobre los comprobantes relacionados con movimientos de stock, tales como Remitos o Pedidos. A continuación se detallan los filtros y los datos que devuelve la respuesta de la API.

Filtros disponibles:

• Mes: T(MM) – Especifica el mes de la consulta. Obligatorio.
• Año: T(AAAA) – Especifica el año de la consulta. Obligatorio.
• FechaDesde: T(Date) – Fecha desde la cual se desea realizar la consulta. Opcional.
• FechaHasta: T(Date) – Fecha hasta la cual se desea realizar la consulta. Opcional.
• Serie: T(String) – Filtro opcional para especificar la serie del comprobante.
• NumeroDesde: T(Long) – Filtro opcional para especificar el número desde el cual iniciar la búsqueda.
• NumeroHasta: T(Long) – Filtro opcional para especificar el número hasta el cual finalizar la búsqueda.
• ProveedorCodigo: T(String) – Filtro opcional para especificar el código del proveedor asociado al comprobante.
• ComprobanteCodigo: T(Short) – Filtro opcional para especificar el tipo de comprobante.
• MonedaCodigo: T(Byte) – Filtro opcional para especificar el código de la moneda.
• LocalCodigo: T(Short) – Filtro opcional para especificar el código del local.
• PendienteSN: T(String) – Puede ser “S”, “N” o vacío. Indica si los comprobantes requeridos tienen artículos pendientes de entrega o facturación. Si se deja vacío el filtro no será aplicado.

Datos que devuelve el método:

• RegistroId: Identificador del registro.
• Fecha: Fecha en la que se realizó el comprobante.
• ComprobanteCodigo: Código del tipo de comprobante.
• ComprobanteNombre: Nombre del comprobante.
• EsCFE: Indica si el comprobante es un Comprobante Fiscal Electrónico (CFE).
• Serie: Serie del comprobante.
• Numero: Número del comprobante.
• ProveedorCodigo: Código del proveedor.
• ProveedorNombre: Nombre del proveedor.
• ProveedorRazonSocial: Razón social del proveedor.
• ProveedorPaisCodigo: Código del país del proveedor.
• ProveedorPaisNombre: Nombre del país del proveedor.
• ProveedorDepartamentoCodigo: Código del departamento del proveedor.
• ProveedorDepartamentoNombre: Nombre del departamento del proveedor.
• ProveedorGrupoCodigo: Código del grupo del proveedor.
• ProveedorGrupoNombre: Nombre del grupo del proveedor.
• ProveedorGiroCodigo: Código del giro del proveedor.
• ProveedorGiroNombre: Nombre del giro del proveedor.
• ProveedorZonaCodigo: Código de la zona del proveedor.
• ProveedorZonaNombre: Nombre de la zona del proveedor.
• ProveedorCategoriaCodigo: Código de la categoría del proveedor.
• ProveedorCategoriaNombre: Nombre de la categoría del proveedor.
• MonedaCodigo: Código de la moneda utilizada.
• MonedaSimbolo: Símbolo de la moneda.
• CotizacionEspecial: Cotización especial utilizada en la transacción.
• PrecioVentaCodigo: Código del precio de venta.
• PrecioVentaNombre: Nombre del precio de venta.
• CondicionCodigo: Código de la condición de pago.
• CondicionNombre: Nombre de la condición de pago.
• VendedorCodigo: Código del vendedor.
• VendedorNombre: Nombre del vendedor.
• LocalCodigo: Código del local donde se emitió el comprobante.
• LocalNombre: Nombre del local.
• CentroCostosCodigo: Código del centro de costos.
• CentroCostosNombre: Nombre del centro de costos.
• Referencia: Referencia adicional del comprobante.
• DepositoOrigenCodigo: Código del depósito de origen.
• DepositoOrigenNombre: Nombre del depósito de origen.
• DepositoDestinoCodigo: Código del depósito de destino.
• DepositoDestinoNombre: Nombre del depósito de destino.
• Subtotal: Subtotal de la transacción.
• IVA: Monto del IVA aplicado.
• Total: Total de la transacción.
• Pendiente: Puede ser “S”, “N”. Indica si el comprobante tiene artículos pendientes de entrega o facturación.
• Emitido: Indica si el comprobante fue emitido.
• Notas: Notas adicionales sobre el comprobante.
• UsuarioCodigo: Código del usuario que registró el comprobante.
• UsuarioNombre: Nombre del usuario que registró el comprobante.
• RegistroFecha: Fecha en la que se registró el comprobante.
• RegistroHora: Hora en la que se registró el comprobante.

Método QuerySaldosPendientes

Este método permite desplegar un listado con el saldo de comprobantes del tipo «venta crédito» y comprobantes del tipo «nota de crédito» emitidos a clientes. Un comprobante tendrá saldo cuando el importe total del mismo no esté completamente cancelado a través de su vinculación a otro comprobante.

Filtros

• ClienteCodigo: T(10) – Especifica el código del cliente. Si se deja vacío, se obtiene la información de todos los clientes.
• Id: Debe enviarse vacío.
• ComprobanteCodigo: N(3).
• FechaDesde: AAAAMMDD.
• FechaHasta: AAAAMMDD.
• Serie: T(6).
• Numero: N(10).
• MonedaCodigo: N(2).
• LocalCodigo: N(4).
• SaldoDesde: N(10) – Corresponde al importe mínimo del saldo a buscar. Puede enviarse con valor cero para incluir todos los saldos.
• SaldoHasta: N(10) – Corresponde al importe máximo del saldo a buscar. Si «SaldoDesde» es cero, se incluirán todos los saldos.
• Emitido: Valores admitidos son S=Si, N=No, o dejarlo vacío.
• Page: N(2) – Obligatorio.

Resultado

• RegistroId
• ComprobanteCodigo
• ComprobanteAbreviacion
• ComprobanteNombre
• ComprobanteTipo
• ComprobanteTipoNombre
• ClienteCodigo
• ClienteNombre
• ClienteRazonSocial
• Fecha
• Serie
• Numero
• MonedaCodigo
• MonedaSimbolo
• MonedaNombre
• CondicionCodigo
• CondicionNombre
• LocalCodigo
• LocalNombre
• Total: Corresponde al valor absoluto del total del comprobante.
• TotalSigno: Refleja el valor del total del comprobante, mostrándose en negativo para Notas de Crédito.
• Saldo: Corresponde al valor absoluto del saldo del comprobante.
• SaldoSigno: Refleja el saldo del comprobante, mostrándose en negativo para Notas de Crédito.
• Emitido
• Notas: Corresponde a las anotaciones del comprobante.

Método Compras

El método Compras es otra herramienta significativa que se centra en mostrar una lista detallada de los comprobantes de proveedores que han sido registrados en el sistema de la empresa. Este método es un instrumento crucial para un control efectivo y detallado de las transacciones relacionadas con proveedores.

• Filtros:
  • Mes: T(MM) – Obligatorio.
  • Año: T(AAAA) – Obligatorio.
  • Moneda: N(2)
• Resultado:
  • FacturaId
  • FacturaFecha
  • FacturaDia
  • FacturaMes
  • FacturaAnio
  • MonedaCodigo
  • MonedaSimbolo
  • Cotizacion
  • ComprobanteCodigo
  • ComprobanteNombre
  • ComprobanteTipo
  • FacturaGastos
  • FacturaSigno
  • FacturaSerie
  • FacturaNumero
  • FacturaSerieNumero
  • LocalCodigo
  • LocalNombre
  • DepositoOrigenCodigo
  • DepositoOrigenNombre
  • DepositoDestinoCodigo
  • DepositoDestinoNombre
  • CajaCodigo
  • CajaNombre
  • CondicionPagoCodigo
  • CondicionPagoNombre
  • FacturaReferencia
  • CentroCostosCodigo
  • CentroCostosNombre
  • UsuarioCodigo
  • UsuarioNombre
  • FacturaRegistroFecha
  • FacturaRegistroHora
  • ProveedorCodigo
  • ProveedorNombre
  • ProveedorRazonSocial
  • GrupoCodigo
  • GrupoNombre
  • GiroCodigo
  • GiroNombre
  • PaisCodigo
  • PaisNombre
  • DepartamentoCodigo
  • DepartamentoNombre
  • ZonaCodigo
  • ZonaNombre
  • CategoriaCodigo
  • CategoriaNombre
  • FacturaDescuentos
  • FacturaSubtotal
  • FacturaIVA
  • FacturaTotal
  • FacturaSaldo

Método ComprasDetalladas

El método ComprasDetalladas añade una capa adicional de especificidad al ofrecer detalles completos de los comprobantes de compra, incluyendo las líneas de artículos. Al igual que los métodos anteriores, este se integra en el sistema de ZetaSoftware, pero se distingue por su grado de profundidad en la información que proporciona.

• Filtros:
  • Mes: T(MM) – Obligatorio.
  • Año: T(AAAA) – Obligatorio.
  • Moneda: N(2) – Si se envía vacío, contempla todas las monedas.
• Resultado:
  • Detalles del encabezado del comprobante
    • FacturaId
    • FacturaFecha
    • FacturaDia
    • FacturaMes
    • FacturaAnio
    • MonedaCodigo
    • MonedaSimbolo
    • Cotizacion
    • ComprobanteCodigo
    • ComprobanteNombre
    • ComprobanteTipo
    • FacturaGastos
    • FacturaSigno
    • FacturaSerie
    • FacturaNumero
    • FacturaSerieNumero
    • LocalCodigo
    • LocalNombre
    • DepositoOrigenCodigo
    • DepositoOrigenNombre
    • DepositoDestinoCodigo
    • DepositoDestinoNombre
    • CajaCodigo
    • CajaNombre
    • CondicionPagoCodigo
    • CondicionPagoNombre
    • FacturaReferencia
    • CentroCostosCodigo
    • CentroCostosNombre
    • UsuarioCodigo
    • UsuarioNombre
    • FacturaRegistroFecha
    • FacturaRegistroHora
    • ProveedorCodigo
    • ProveedorNombre
    • ProveedorRazonSocial
    • GrupoCodigo
    • GrupoNombre
    • GiroCodigo
    • GiroNombre
    • PaisCodigo
    • PaisNombre
    • DepartamentoCodigo
    • DepartamentoNombre
    • ZonaCodigo
    • ZonaNombre

La sección «Detalles de las líneas del comprobante» en el método ComprasDetalladas representa un componente crucial para el entendimiento de las transacciones individuales en cada comprobante de compra. Esta parte del método se enfoca en el desglose pormenorizado de cada artículo o servicio adquirido, proporcionando una gran cantidad de detalles que pueden ser cruciales para diversos aspectos del negocio.

• Detalles de las líneas del comprobante:
  • CategoriaCodigo
  • CategoriaNombre
  • ArticuloCodigo
  • ArticuloNombre
  • MarcaCodigo
  • MarcaNombre
  • CategoriaArticuloCodigo
  • CategoriaArticuloNombre
  • FamiliaCodigo
  • FamiliaNombre
  • ConceptoCodigo
  • ConceptoNombre
  • LineaConcepto
  • LineaLoteCodigo
  • LineaLoteVencimiento
  • LineaCantidad
  • LineaPrecioDigitado
  • LineaPrecio
  • LineaDtoPorcentaje1
  • LineaDtoPorcentaje2
  • LineaDtoPorcentaje3
  • IVACodigo
  • IVATasa
  • IVANombre
  • IVATipo
  • LineaPendienteRemision
  • LineaDescuentos
  • LineaSubtotal
  • LineaIVA
  • LineaTotal

Método QuerySaldosPendientes

El método QuerySaldosPendientes se posiciona como un recurso vital para la gestión financiera, especialmente en lo que respecta al seguimiento de las obligaciones pendientes con proveedores. Este método es particularmente útil para las empresas que necesitan mantener un control estricto sobre sus cuentas por pagar, al permitir un entendimiento claro de qué comprobantes aún tienen saldos pendientes.

• Filtros:
  • ClienteProveedor: Código específico del proveedor. Al dejarlo vacío, se obtiene información de todos los proveedores, lo cual es útil para un análisis global.
  • RegistroId: Este campo se envía vacío.
  • ComprobanteCodigo: Para especificar el tipo de comprobante.
  • FechaDesde y FechaHasta: Campos obligatorios que definen el rango de tiempo para el cual se quiere consultar los saldos pendientes.
  • Serie y Numero: Opcionales, permiten filtrar aún más los comprobantes.
  • MonedaCodigo: Para especificar en qué moneda se están considerando los saldos.
  • LocalCodigo: Para filtrar por local específico, si se trata de una empresa con múltiples ubicaciones.
  • SaldoDesde y SaldoHasta: Para acotar los resultados a ciertos rangos de saldo.
  • Page: Obligatorio, define la página de resultados que se desea consultar.
• Resultado:
  • RegistroId
  • ComprobanteCodigo
  • ComprobanteAbreviacion
  • ComprobanteNombre
  • ComprobanteTipo
  • ComprobanteTipoNombre
  • ClienteProveedo
  • ProveedorNombre
  • ProveedorRazonSocial
  • Fecha
  • Serie
  • Numero
  • MonedaCodigo
  • MonedaSimbolo
  • MonedaNombre
  • CondicionCodigo
  • CondicionNombre
  • LocalCodigo
  • LocalNombre
  • Total
  • TotalSigno
  • Saldo
  • SaldoSigno