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.