API Balance Contable

Esta API permite consultar la información de un balance contable previamente generado en ZetaSoftware. No genera balances ni ejecuta procesos de cierre; únicamente expone los datos de un balance existente para su consulta e integración con sistemas externos.

Casos de uso

• Consultar saldos contables generados previamente en ZetaSoftware.
• Integrar información de balance con sistemas externos de reportes o análisis.
• Obtener cuentas contables y sus saldos paginados para procesamiento posterior.

Endpoint del servicio

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

Método de consulta

La operación permite recuperar registros del balance contable mediante filtros de consulta y paginación.

Requisitos previos

• El balance contable debe haber sido generado previamente en ZetaSoftware.
• Se debe contar con un código de usuario válido en el parámetro RolUsuario.
• La consulta requiere informar la página a recuperar mediante el parámetro Page.

Parámetros de entrada

Estructura del request

RolUsuario
CuentaCodigoDesde
CuentaCodigoHasta
CuentaNombreContiene
CuentaGrupo
Page

Ejemplo de request

{
  "RolUsuario": "001",
  "CuentaCodigoDesde": "0",
  "CuentaCodigoHasta": "",
  "CuentaNombreContiene": "",
  "CuentaGrupo": "",
  "Page": 1
}

Estructura del response

RolUsuario
CuentaCodigo
CuentaNombre
CuentaImputable
CuentaGrupo
CuentaNivel
CuentaCapitulo
Saldo1
Saldo2

Campos devueltos

Ejemplo de response

[
  {
    "RolUsuario": "001",
    "CuentaCodigo": "1.1.01",
    "CuentaNombre": "Caja",
    "CuentaImputable": "S",
    "CuentaGrupo": "ACT",
    "CuentaNivel": 3,
    "CuentaCapitulo": "Disponible",
    "Saldo1": 150000.25,
    "Saldo2": 3200.50
  }
]

Observaciones

• La API consulta únicamente balances ya generados en el sistema.
• La paginación es obligatoria y retorna hasta 100 registros por página.
• Los filtros de cuenta son opcionales y permiten acotar el conjunto de resultados.

Consideraciones de integración

• Se recomienda iterar por páginas hasta completar la extracción del balance requerido.
• Antes de integrar, validar el formato esperado de cada campo según su definición funcional y longitud informada.