API Cuotas Pendientes

Esta API permite consultar cuotas pendientes asociadas a clientes y proveedores. Su objetivo es exponer obligaciones financieras aún no cobradas o no pagadas, facilitando su integración con sistemas externos de gestión, seguimiento y control.

Casos de uso

• Consultar cuotas pendientes de cobro de clientes.
• Consultar cuotas pendientes de pago a proveedores.
• Integrar vencimientos y saldos con sistemas de gestión financiera.
• Automatizar procesos de seguimiento de cuentas por cobrar y cuentas por pagar.

Endpoint del servicio

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

Método QueryCliente

Permite consultar cuotas pendientes de cobro correspondientes a un cliente específico.

Requisitos previos

• Contar con acceso habilitado a la API.
• Disponer de un código de cliente válido.
• Definir el rango de vencimiento y el rango de saldo a consultar.

Parámetros de entrada

Estructura del request

RegistroId
ClienteCodigo
CuotaVencimientoDesde
CuotaVencimientoHasta
MonedaCodigo
CuotaSaldoDesde
CuotaSaldoHasta
Page

Estructura del response

RegistroId
ClienteCodigo
CuotaNumero
CuotaVencimiento
MonedaCodigo
CuotaTotal
CuotaSaldo
EsEntregaInicial

Campos devueltos

Método QueryProveedor

Permite consultar cuotas pendientes de pago correspondientes a un proveedor específico.

Requisitos previos

• Contar con acceso habilitado a la API.
• Disponer de un código de proveedor válido.
• Definir el rango de vencimiento y el rango de saldo a consultar.

Parámetros de entrada

Estructura del request

RegistroId
ProveedorCodigo
CuotaVencimientoDesde
CuotaVencimientoHasta
MonedaCodigo
CuotaSaldoDesde
CuotaSaldoHasta
Page

Estructura del response

RegistroId
ProveedorCodigo
CuotaNumero
CuotaVencimiento
MonedaCodigo
CuotaTotal
CuotaSaldo
EsEntregaInicial

Campos devueltos

Ejemplo de request

{
  "RegistroId": "",
  "ClienteCodigo": "C0001",
  "CuotaVencimientoDesde": "2026-03-01",
  "CuotaVencimientoHasta": "2026-03-31",
  "MonedaCodigo": 1,
  "CuotaSaldoDesde": 0,
  "CuotaSaldoHasta": 999999999.99999,
  "Page": 1
}

Ejemplo de response

[
  {
    "RegistroId": 1254,
    "ClienteCodigo": "C0001",
    "CuotaNumero": 3,
    "CuotaVencimiento": "2026-03-20",
    "MonedaCodigo": 1,
    "CuotaTotal": 15000.00000,
    "CuotaSaldo": 5000.00000,
    "EsEntregaInicial": "N"
  }
]

Observaciones

• Los métodos QueryCliente y QueryProveedor consultan únicamente cuotas pendientes.
• El parámetro RegistroId debe enviarse vacío en ambos métodos.
• La cantidad de registros por página difiere según el método.
• Se recomienda definir rangos de vencimiento y saldo acotados para mejorar precisión y rendimiento.

Consideraciones de integración

• Iterar por páginas hasta completar la recuperación de datos necesarios.
• Persistir el identificador del registro y el número de cuota para evitar reprocesamiento.
• Aplicar filtros por moneda cuando se maneje múltiples monedas.