API Movimientos de Caja

Esta API permite consultar movimientos de caja registrados en la empresa, incluyendo ingresos y egresos. La información expuesta corresponde a movimientos previamente generados en el sistema y está orientada a control operativo, conciliación y análisis contable.

La funcionalidad asociada en el sistema se encuentra en Gestión > Comprobantes > Caja y Bancos > Movimientos de Caja.

Casos de uso

• Consultar ingresos y egresos de caja por período.
• Filtrar movimientos por concepto, moneda, local o centro de costos.
• Auditar comprobantes de caja registrados en el sistema.
• Integrar movimientos de caja con sistemas externos de reporting o conciliación.

Endpoint del servicio

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

Método Query

Permite obtener movimientos de caja aplicando filtros por período, tipo de comprobante y atributos operativos del movimiento.

Requisitos previos

• Acceso habilitado a la API.
• Definir el período de consulta mediante mes y año.
• Conocer los códigos de concepto, moneda, local, centro de costos y comprobante cuando se requiera filtrado específico.

Parámetros de entrada

Estructura del request

Mes
Anio
FechaDesde
FechaHasta
ComprobanteTipo
ConceptoCodigo
MonedaCodigo
ComprobanteCodigo
Serie
Numero
LocalCodigo
CentroCostosCodigo
Referencia
Page

Estructura del response

RegistroId
ComprobanteCodigo
ComprobanteAbreviacion
Fecha
Serie
Numero
MonedaCodigo
MonedaSimbolo
ConceptoCodigo
ConceptoNombre
CajaCodigo
CajaNombre
LocalCodigo
LocalNombre
CentroCostosCodigo
CentroCostosNombre
Referencia
Descripcion
Conciliado
SubTotal
TotalIVA
Total
Notas
UsuarioCodigo
UsuarioNombre
RegistroHora
RegistroFecha

Campos devueltos

Ejemplo de request

{
  "Mes": "03",
  "Anio": "2026",
  "FechaDesde": "",
  "FechaHasta": "",
  "ComprobanteTipo": 41,
  "ConceptoCodigo": "",
  "MonedaCodigo": "",
  "ComprobanteCodigo": "",
  "Serie": "",
  "Numero": "",
  "LocalCodigo": "",
  "CentroCostosCodigo": "",
  "Referencia": "",
  "Page": 1
}

Ejemplo de response

[
  {
    "RegistroId": 1245,
    "ComprobanteCodigo": 41,
    "ComprobanteAbreviacion": "IC",
    "Fecha": "2026-03-15",
    "Serie": "A",
    "Numero": "125",
    "MonedaCodigo": 1,
    "MonedaSimbolo": "$",
    "ConceptoCodigo": "VARIOS",
    "ConceptoNombre": "Ingresos varios",
    "CajaCodigo": 1,
    "CajaNombre": "Caja Principal",
    "LocalCodigo": 1,
    "LocalNombre": "Casa Central",
    "CentroCostosCodigo": "ADM",
    "CentroCostosNombre": "Administración",
    "Referencia": "",
    "Descripcion": "Ingreso de efectivo",
    "Conciliado": "N",
    "SubTotal": 1000.00,
    "TotalIVA": 0.00,
    "Total": 1000.00,
    "Notas": "",
    "UsuarioCodigo": "001",
    "UsuarioNombre": "Administrador",
    "RegistroHora": "10:25:11",
    "RegistroFecha": "2026-03-15"
  }
]

Observaciones

• La API consulta únicamente movimientos de caja ya registrados en el sistema.
• El filtro ComprobanteTipo permite distinguir entre ingresos y egresos de caja.
• Se recomienda utilizar filtros de fecha y concepto para reducir el volumen de datos.

Consideraciones de integración

• Paginar resultados mediante el parámetro Page.
• Evitar consultas amplias sin filtros de período en ambientes productivos.
• Persistir los movimientos ya procesados para evitar reprocesamiento.
• Validar códigos de concepto, moneda, local y centro de costos antes de construir consultas automáticas.