Herramientas de usuario
ada:sicoferp:rentas:herramientas:ws.recaudo
Diferencias
Muestra las diferencias entre dos versiones de la página.
| Ambos lados, revisión anterior Revisión previa Próxima revisión | Revisión previa | ||
|
ada:sicoferp:rentas:herramientas:ws.recaudo [2026/07/16 13:08] 192.168.175.156 |
ada:sicoferp:rentas:herramientas:ws.recaudo [2026/07/16 13:45] (actual) 192.168.175.156 |
||
|---|---|---|---|
| Línea 1: | Línea 1: | ||
| - | * Servicio integracion Consulta y Recaudo | + | * Servicio integracion Consulta y Recaudo *. |
| | | ||
| - | Este documento detalla la especificación técnica para la integración con el servicio de consulta de facturas | + | Este documento detalla la especificación técnica para la integración con el servicio de consulta de facturas . |
| | | ||
| 1. Información General | 1. Información General | ||
| - | ** Nombre del Servicio:** `ConsultaFacturaServlet` | + | ** Nombre del Servicio:** `ConsultaFacturaServlet` |
| ** Endpoint:** `/factura/consulta` | ** Endpoint:** `/factura/consulta` | ||
| ** Método:** `POST` | ** Método:** `POST` | ||
| Línea 11: | Línea 11: | ||
| ** Descripción:** Verifica la existencia, integridad y estado de una factura (vencimiento, pagos previos, anulación) antes de permitir un recaudo. | ** Descripción:** Verifica la existencia, integridad y estado de una factura (vencimiento, pagos previos, anulación) antes de permitir un recaudo. | ||
| - | --- | + | |
| 2. Estructura de la Petición (Request) | 2. Estructura de la Petición (Request) | ||
| Línea 50: | Línea 50: | ||
| | Código | Mensaje | Razón | | | Código | Mensaje | Razón | | ||
| | :--- | :--- | :--- | | | :--- | :--- | :--- | | ||
| - | | **400** | "La petición no contiene información." | Cuerpo del POST vacío. | | + | | **400** | "La petición no contiene información." | Falta datos en el json. | |
| - | | **400** | "El JSON recibido no es válido." | Error de sintaxis en el JSON enviado. | | + | | **415** | "El JSON recibido no es válido." | Error de sintaxis en el JSON enviado. | |
| | **400** | "No se han especificado..." | Faltan campos obligatorios en el JSON. | | | **400** | "No se han especificado..." | Faltan campos obligatorios en el JSON. | | ||
| - | | **400** | "El campo 'consecutivo/valor' debe ser mayor que cero." | Validación de negocio: los números deben ser positivos. | | + | | **412** | "El campo 'consecutivo/valor' debe ser mayor que cero." | Validación de negocio: los números deben ser positivos. | |
| | **401** | "El usuario no esta autorizado..." | Credenciales inválidas o estado inactivo. | | | **401** | "El usuario no esta autorizado..." | Credenciales inválidas o estado inactivo. | | ||
| | **404** | "No se encontró una factura asociada..." | Factura inexistente o el valor no coincide con la base de datos. | | | **404** | "No se encontró una factura asociada..." | Factura inexistente o el valor no coincide con la base de datos. | | ||
| Línea 76: | Línea 76: | ||
| - | --- | ||
| 5. Reglas de Negocio Aplicadas | 5. Reglas de Negocio Aplicadas | ||
| Línea 87: | Línea 86: | ||
| 4. **Validación de Fecha:** Se comprueba que la factura no haya superado su fecha de vencimiento (`fecha_vencimiento`). | 4. **Validación de Fecha:** Se comprueba que la factura no haya superado su fecha de vencimiento (`fecha_vencimiento`). | ||
| - | --- | + | |
| | | ||
| - | # Servicio Recaudo. | + | * Servicio Recaudo. |
| Este documento detalla la especificación técnica para la integración con el servicio de recaudo de facturas. | Este documento detalla la especificación técnica para la integración con el servicio de recaudo de facturas. | ||
| Línea 97: | Línea 96: | ||
| * **Nombre del Servicio:** `RecaudoFacturaServlet` | * **Nombre del Servicio:** `RecaudoFacturaServlet` | ||
| - | * **Endpoint:** `/factura_recaudo` | + | * **Endpoint:** `/factura/recaudo` |
| * **Método:** `POST` | * **Método:** `POST` | ||
| * **Content-Type:** `application/json; charset=UTF-8` | * **Content-Type:** `application/json; charset=UTF-8` | ||
| * **Descripción:** Servicio encargado de validar, procesar y generar comprobante y notificación de pago para una factura específica en el sistema. | * **Descripción:** Servicio encargado de validar, procesar y generar comprobante y notificación de pago para una factura específica en el sistema. | ||
| - | --- | + | |
| 2. Estructura de la Petición (Request) | 2. Estructura de la Petición (Request) | ||
| Línea 143: | Línea 142: | ||
| | Código | Mensaje | Razón | | | Código | Mensaje | Razón | | ||
| | :--- | :--- | :--- | | | :--- | :--- | :--- | | ||
| - | | **400** | "La petición no contiene información." | El cuerpo del POST está vacío. | | + | |
| + | |||
| + | | **415** | "El JSON recibido no es válido." | Error de sintaxis en el JSON enviado. | | ||
| + | | **412** | "El campo 'consecutivo/valor' debe ser mayor que cero." | Validación de negocio: los números deben ser | ||
| + | | **400** | "La petición no contiene información." | Falta datos en el json. | | ||
| | **401** | "El usuario no esta autorizado..." | Credenciales inválidas o estado inactivo. | | | **401** | "El usuario no esta autorizado..." | Credenciales inválidas o estado inactivo. | | ||
| | **404** | "No se encontró un banco..." | El código de banco no existe en el maestro. | | | **404** | "No se encontró un banco..." | El código de banco no existe en el maestro. | | ||
| Línea 152: | Línea 155: | ||
| | **500** | "Error interno." | Error inesperado en el servidor o base de datos. | | | **500** | "Error interno." | Error inesperado en el servidor o base de datos. | | ||
| - | --- | + | |
| 4. Flujo de Validaciones y Reglas de Negocio | 4. Flujo de Validaciones y Reglas de Negocio | ||
| Línea 167: | Línea 170: | ||
| * Se guarda en un log el proceso de recaudo , tabla recaudo.log_pago_factura | * Se guarda en un log el proceso de recaudo , tabla recaudo.log_pago_factura | ||
| - | --- | + | |
| 5. Especificaciones Técnicas (Stack) | 5. Especificaciones Técnicas (Stack) | ||
| Línea 176: | Línea 179: | ||
| * **Logs:** Implementado vía `com.ada.utilidades.Log`. | * **Logs:** Implementado vía `com.ada.utilidades.Log`. | ||
| - | --- | + | |
| > **Nota para Integradores:** | > **Nota para Integradores:** | ||
| Línea 184: | Línea 187: | ||
| **Content-Type:** `application/json;charset=UTF-8` | **Content-Type:** `application/json;charset=UTF-8` | ||
| - | --- | + | |
| Parámetros de Entrada (Obligatorios) | Parámetros de Entrada (Obligatorios) | ||
ada/sicoferp/rentas/herramientas/ws.recaudo.1784207316.txt.gz · Última modificación: 2026/07/16 13:08 por 192.168.175.156
Herramientas de la página
