API Cajas

Esta API permite gestionar las cajas asignadas a los locales comerciales de la empresa. Incluye operaciones de consulta, alta, modificación y eliminación de registros, dentro del alcance de configuración operativa de locales y cajas.

La funcionalidad asociada en el sistema se encuentra en Configuración > Locales y Cajas.

Endpoint del servicio

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

Método Query

Permite obtener un listado de cajas aplicando filtros por código, nombre y local.

Estructura del response

Codigo
Nombre
LocalCodigo
LocalNombre
LocalActivo
Notas

Campos devueltos

Campo	Descripción
Codigo	Código identificador de la caja.
Nombre	Nombre de la caja.
LocalCodigo	Código del local al que está asignada.
LocalNombre	Nombre del local asociado.
LocalActivo	Indica si el local asociado se encuentra activo.
Notas	Información adicional del registro.

Método Save

Permite crear una nueva caja o actualizar una caja existente.

Al actualizar el artículo, los campos que no se envían en el payload no conservan automáticamente su valor anterior.

El sistema toma como referencia únicamente la información recibida. Por este motivo, los campos que no se incluyen en  la solicitud quedan sin valor.

Parámetros de entrada.

Datos Obligatorios

Campo	Descripción
Codigo	Código identificador de la caja.
Nombre	Nombre de la caja.
LocalCodigo	Código del local asociado. El valor enviado debe existir previamente en la configuración de la empresa en ZetaSoftware.

Datos opcionales

{
"SaveIn": {
"Connection": {
"DesarrolladorCodigo": "DESARROLLADOR",
"DesarrolladorClave": "CLAVE_DESARROLLADOR",
"EmpresaCodigo": "EMPRESA",
"EmpresaClave": "CLAVE_EMPRESA",
"UsuarioCodigo": ,
"UsuarioClave": "",
"RolCodigo": 1
},
"Data": {
"Codigo": 1,
"Nombre": "Caja principal",
"LocalCodigo": 1,
"Notas": "Caja creada mediante integración"
}
}
}

Resultado

Succeed
Error
Mensaje

Método Load

Permite obtener una caja específica mediante su código.

Parámetro de entrada

• Codigo – Obligatorio.

Resultado

Codigo
Nombre
LocalCodigo
Notas

Método Delete

Permite eliminar una caja.

Parámetro de entrada

• Codigo – Obligatorio.

Restricción

No es posible eliminar una caja si existen comprobantes o documentos emitidos desde la misma.

Resultado

Succeed
Error
Mensaje

Observaciones

• El método Query permite búsquedas masivas de cajas.
• El método Load es apropiado para consultas puntuales.
• El método Save permite alta y modificación de registros.
• La creación de una caja requiere que el local exista previamente en el sistema.
• El método Delete está condicionado por el uso histórico de la caja en comprobantes o documentos.

Consideraciones de integración

• Utilizar paginación en consultas masivas.
• Validar previamente la existencia del local antes de crear una caja.
• Persistir la relación entre caja y local en sistemas externos si se requiere integración operativa.