Recibo de Pago

La API de Recibos de Pago en ZetaSoftware proporciona acceso a la gestión integral de los recibos de pago, permitiendo consultar, modificar, cargar y registrar datos. A continuación, se detallan los métodos disponibles y cómo utilizarlos eficazmente.

URLs de la API

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

Métodos Disponibles

1. QueryPendientes: Genera un listado de recibos de pago pendientes.
2. Data: Obtiene detalles completos de un recibo específico.
3. Load: Carga o modifica datos de un recibo existente.
4. Save: Registra un nuevo recibo en la base de datos.
5. QueryComprobantes: Consulta y filtra comprobantes de pago registrados.

---

1. Método QueryPendientes

Permite obtener un listado de recibos de pago que presentan saldos pendientes, ideal para el seguimiento de pagos.

Filtros:

• ProveedorCodigo: Código del proveedor.
• Id: Dejar vacío; secuencial interno para uso en otros métodos.
• ComprobanteCodigo: Código del comprobante de pago.
• FechaDesde y FechaHasta: Rango de fechas.
• Serie y Numero: Detalles del comprobante.
• MonedaCodigo, LocalCodigo: Especificación de la moneda y local.
• SaldoDesde y SaldoHasta: Rango del saldo del comprobante.
• Emitido: Obligatorio, “S” (Sí) o “N” (No) para indicar emisión.
• Page: Controla la paginación de los resultados (obligatorio).

Datos de Salida:

• RegistroId, ComprobanteCodigo, ProveedorCodigo, Fecha, Serie, Numero, MonedaCodigo, Descripcion, LocalCodigo, CajaCodigo, Total, Saldo, Emitido, entre otros.

Consideraciones: Utilice los filtros para ajustar los resultados y asegure el uso adecuado de la paginación para grandes volúmenes de datos.

---

2. Método Data

Este método recupera la información completa de un recibo de pago específico.

Filtro:

• RegistroId: Obligatorio, se obtiene al ejecutar QueryPendientes.

Datos de Salida: La estructura de los datos es idéntica a QueryPendientes, pero se enfoca en un solo recibo. Cada campo ofrece detalles específicos del recibo.

Consideraciones: Asegúrese de obtener el RegistroId con QueryPendientes antes de ejecutar este método.

---

3. Método Load

Este método permite modificar datos en un recibo de pago existente.

Filtro:

• RegistroId: Obligatorio, identifica el recibo que se desea actualizar.

Datos de Salida:

• RegistroId, ComprobanteCodigo, ProveedorCodigo, Fecha, Serie, Numero, MonedaCodigo, Cotizacion, LocalCodigo, CajaCodigo, Total, UsuarioCodigo, Notas, y otros campos relevantes para la carga o actualización de datos.

Consideraciones: Load debe utilizarse para actualizar recibos existentes. Realice pruebas antes de implementar cambios en un entorno de producción para evitar errores en los datos.

---

4. Método Save

Permite registrar un nuevo recibo de pago. Importante: no se asignan formas de pago directamente; use la API correspondiente para ello.

Filtros:

• RegistroId: Enviar como cero para que se asigne automáticamente.
• ComprobanteCodigo, ProveedorCodigo, Fecha, MonedaCodigo, LocalCodigo, CajaCodigo, Total, UsuarioCodigo: Son obligatorios.
• Serie, Numero, Cotizacion, Descripcion, Notas: Opcionales para detallar el recibo.

Datos de Salida:

• Succeed / Mensaje: Indica éxito o falla, proporcionando un mensaje en caso de error.

Consideraciones: La precisión de los datos ingresados es crucial en la gestión financiera. Verifique antes de guardar en producción.

---

5. Método QueryComprobantes

Este método permite consultar comprobantes de pago con varios criterios de filtrado.

Filtros:

• Anio y Mes: Obligatorios, especifican el período.
• FechaDesde y FechaHasta: Rango de fechas opcional.
• ProveedorCodigo, ComprobanteCodigo, MonedaCodigo, LocalCodigo, CobradorCodigo: Filtros adicionales para especificar proveedor, tipo de comprobante, moneda, local y cobrador.
• Page: Controla la paginación de los resultados.

Datos de Salida:

• RegistroId, ComprobanteCodigo, ProveedorCodigo, Fecha, Serie, Numero, MonedaCodigo, Descripcion, LocalCodigo, CajaCodigo, Total, Saldo, Emitido, y otros campos clave.

Consideraciones: Este método permite filtrar y analizar el historial de comprobantes, siendo útil para auditorías y reportes.

---

Conexión y Seguridad

Para todos los métodos, es necesaria una conexión autenticada mediante el objeto SDTConnection con los siguientes parámetros:

• DesarrolladorCodigo y DesarrolladorClave: Credenciales del desarrollador.
• EmpresaCodigo y EmpresaClave: Identificación de la empresa.
• UsuarioCodigo y UsuarioClave: Identificación del usuario ejecutante.
• RolCodigo: Código del rol asignado.

---

Conclusión

Esta API de Recibos de Pago permite un control detallado y seguro sobre las transacciones de pago de proveedores. A través de estos métodos, los desarrolladores pueden gestionar, auditar y asegurar la precisión en los registros de pagos, optimizando el proceso de cuentas por pagar en ZetaSoftware.