API Comprobantes

Esta API permite consultar la configuración de comprobantes fiscales, comerciales, contables, de stock, caja y bancos definidos en la empresa. Su objetivo es exponer la parametrización funcional de cada comprobante para su uso en integraciones, validaciones y automatizaciones.

La funcionalidad asociada en el sistema se encuentra en Configuración > Comprobantes.

Casos de uso

• Consultar comprobantes configurados en la empresa.
• Identificar el tipo funcional de un comprobante.
• Validar si un comprobante está activo, emite CFE o trabaja en contingencia.
• Obtener datos auxiliares de formatos, depósitos, numeradores y comportamiento operativo.
• Integrar reglas de negocio en sistemas externos según tipo de comprobante.

Endpoint del servicio

• WSDL: https://api.zetasoftware.com/z.apis.asoapcomprobantesv1?wsdl
• Servicio: https://api.zetasoftware.com/z.apis.asoapcomprobantesv1

Método Query

Permite obtener un listado paginado de comprobantes configurados, aplicando filtros por código, nombre, tipo, local y estado.

Requisitos previos

• Contar con acceso habilitado a la API.
• Definir el rango de códigos a consultar.
• Conocer, si aplica, el tipo básico de comprobante o el local a filtrar.

Parámetros de entrada

Estructura del request

CodigoDesde
CodigoHasta
NombreContiene
Tipo
LocalCodigo
Activo
Pagina

Estructura del response

Codigo
Nombre
Abreviacion
Tipo
TipoNombre
LocalCodigo
LocalNombre
ComprobanteGastos
ComprobanteResguardo
Activo
CFE
Contingencia
Exportacion
NotaDebito
RemitoInterno
IVA
FormatoCodigo
FormatoNombre
DepositoOrigenCodigo
DepositoOrigenNombre
DepositoDestinoCodigo
DepositoDestinoNombre
TomarParaActualizarCostos
PermiteSalidasSinStock
NumeradorCodigo
NumeradorNombre
FormaPagoCodigo
IncluirEnFichaComprobantes
IncluirEnLibros
PendienteFacturacionRemision
ConceptoObligatorio
SolicitaDatosReparto
Notas

Campos devueltos

Ejemplo de request

{
  "CodigoDesde": 1,
  "CodigoHasta": 999,
  "NombreContiene": "",
  "Tipo": "",
  "LocalCodigo": "",
  "Activo": "S",
  "Pagina": 1
}

Ejemplo de response

[
  {
    "Codigo": 3,
    "Nombre": "Venta Contado",
    "Abreviacion": "VC",
    "Tipo": 3,
    "TipoNombre": "Venta Contado",
    "LocalCodigo": 1,
    "LocalNombre": "Casa Central",
    "ComprobanteGastos": "N",
    "ComprobanteResguardo": "N",
    "Activo": "S",
    "CFE": "S",
    "Contingencia": "N",
    "Exportacion": "N",
    "NotaDebito": "N",
    "RemitoInterno": "N",
    "IVA": "S",
    "FormatoCodigo": 5,
    "FormatoNombre": "Factura estándar",
    "DepositoOrigenCodigo": 1,
    "DepositoOrigenNombre": "Principal",
    "DepositoDestinoCodigo": 0,
    "DepositoDestinoNombre": "",
    "TomarParaActualizarCostos": "N",
    "PermiteSalidasSinStock": "N",
    "NumeradorCodigo": 2,
    "NumeradorNombre": "Ventas",
    "FormaPagoCodigo": 1,
    "IncluirEnFichaComprobantes": "S",
    "IncluirEnLibros": "S",
    "PendienteFacturacionRemision": "N",
    "ConceptoObligatorio": "N",
    "SolicitaDatosReparto": "N",
    "Notas": ""
  }
]

Listado de tipos básicos de comprobantes

Observaciones

• Los parámetros CodigoDesde, CodigoHasta y Pagina son obligatorios.
• La API expone configuración funcional de comprobantes, no genera ni modifica comprobantes.
• El filtro Tipo permite acotar por tipo básico de comprobante.
• El filtro Activo permite consultar únicamente comprobantes activos o inactivos.

Consideraciones de integración

• Se recomienda consumir esta API como fuente de parametrización para otras integraciones operativas.
• Persistir localmente la configuración de comprobantes si otros procesos dependen de ella.
• Usar el catálogo de tipos básicos para validar reglas de negocio en sistemas externos.
• Verificar combinaciones como CFE, contingencia, IVA, depósitos y numeradores antes de automatizar procesos de emisión o movimiento.