Diferencia entre revisiones de «SIU-Sanaviron-Quilmes/version2.11.0/nucleo cobro sistema externo»
(→SQ-Núcleo para cobrar con sistemas externos) |
|||
| (No se muestran 16 ediciones intermedias de 2 usuarios) | |||
| Línea 5: | Línea 5: | ||
<big> | <big> | ||
| − | = SQ-Núcleo | + | = SQ-Núcleo | Cobro con sistemas externos = |
| + | </big> | ||
| + | Se define una URL '''(url_cobranza_callback)''' al momento de crear la venta desde el sistema externo en la cual recibirá notificaciones que se envían a través de HTTP POST cuando ocurre un evento de pago sobre la venta informada. | ||
| + | |||
| + | '''Modelo de Notificación:''' | ||
| + | |||
| + | Al momento de enviar una notificación el sistema realiza un POST a la url informada con un modelo de dato como el siguiente | ||
| + | <source lang="bash" enclose="div"> | ||
| + | { | ||
| + | "id": 2, | ||
| + | "unidad_venta": "a32dc022-b372-4539-a6b3-4e66c842f5d6", | ||
| + | "id_venta_origen": "4", | ||
| + | "leyenda": "Venta de comedor test", | ||
| + | "venta_estado": "COBRADA", | ||
| + | "cobranza": { | ||
| + | "id_medio_pago": 5, | ||
| + | "liberada_en": "2016-09-21 00:00:00", | ||
| + | "importe_total_neto": "500.0000", | ||
| + | "importe_total_comision": "5.0000", | ||
| + | "importe_total_retenciones": "2.0000", | ||
| + | "importe_total_cobrado": "500.0000", | ||
| + | "cobrado_en": "2025-09-23 17:18:02", | ||
| + | "id_transaccion": "897c1a2e-6376-4108-b8c8-67a2d13324c1" | ||
| + | } | ||
| + | } | ||
| + | </source> | ||
| + | '''Respuesta:''' | ||
| + | |||
| + | Para acusar recibo de una notificación el POST a su URL deberá devolver alguno de los siguientes código de estado HTTP 200 o 201 | ||
| + | |||
| + | '''Re-intentos:''' | ||
| + | |||
| + | Las notificaciones fallidas se puede volver a re-encolar para enviar configurando en el '''Planificador de tareas''' un nuevo proceso llamado: '''"Reenviar colas con error"''' | ||
| − | + | '''Otras consideraciones técnicas:'''<br> | |
| − | + | * La url_cobranza_callback debe ser un endpoint que sea accesible por SQ Núcleo para enviar la notificación sin autenticación en el sistema externo.<br> | |
| − | |||
| − | |||
| − | + | * Se debe tener corriendo un nuevo worker que se encargará de enviar estas notificaciones.<br> | |
| − | + | Para iniciar ejecutar: | |
| + | <source lang="bash" enclose="div"> | ||
| + | ./bin/sq iniciar_queue_workers | ||
| + | </source> | ||
| − | Las notificaciones fallidas almacenadas en la tabla messages contienen el detalle del error en la columna estado_detalle. | + | * Se crearon las tablas '''queue''' y '''messages''' en el esquema '''queue''' de la base de datos del Núcleo.<br> |
| + | * En la tabla queue se almacena temporalmente lo encolado, y en la tabla messages las notificaciones enviadas tanto las enviadas correctamente como las fallidas.<br> | ||
| + | * Si el mensaje en estado FALLIDO se reencola y se envía correctamente, se actualizará la tabla messages con estado ENVIADO.<br> | ||
| + | * Las notificaciones fallidas almacenadas en la tabla messages contienen el detalle del error en la columna estado_detalle. | ||
| − | + | ||
| + | |||
| + | == Workflow == | ||
| + | |||
| + | [[Archivo:Cobro_con_sistemas_externos.png|centro|1000px]] | ||
Revisión actual del 15:24 7 nov 2025
SQ-Núcleo | Cobro con sistemas externos
Se define una URL (url_cobranza_callback) al momento de crear la venta desde el sistema externo en la cual recibirá notificaciones que se envían a través de HTTP POST cuando ocurre un evento de pago sobre la venta informada.
Modelo de Notificación:
Al momento de enviar una notificación el sistema realiza un POST a la url informada con un modelo de dato como el siguiente
{
"id": 2,
"unidad_venta": "a32dc022-b372-4539-a6b3-4e66c842f5d6",
"id_venta_origen": "4",
"leyenda": "Venta de comedor test",
"venta_estado": "COBRADA",
"cobranza": {
"id_medio_pago": 5,
"liberada_en": "2016-09-21 00:00:00",
"importe_total_neto": "500.0000",
"importe_total_comision": "5.0000",
"importe_total_retenciones": "2.0000",
"importe_total_cobrado": "500.0000",
"cobrado_en": "2025-09-23 17:18:02",
"id_transaccion": "897c1a2e-6376-4108-b8c8-67a2d13324c1"
}
}
"id": 2,
"unidad_venta": "a32dc022-b372-4539-a6b3-4e66c842f5d6",
"id_venta_origen": "4",
"leyenda": "Venta de comedor test",
"venta_estado": "COBRADA",
"cobranza": {
"id_medio_pago": 5,
"liberada_en": "2016-09-21 00:00:00",
"importe_total_neto": "500.0000",
"importe_total_comision": "5.0000",
"importe_total_retenciones": "2.0000",
"importe_total_cobrado": "500.0000",
"cobrado_en": "2025-09-23 17:18:02",
"id_transaccion": "897c1a2e-6376-4108-b8c8-67a2d13324c1"
}
}
Respuesta:
Para acusar recibo de una notificación el POST a su URL deberá devolver alguno de los siguientes código de estado HTTP 200 o 201
Re-intentos:
Las notificaciones fallidas se puede volver a re-encolar para enviar configurando en el Planificador de tareas un nuevo proceso llamado: "Reenviar colas con error"
Otras consideraciones técnicas:
- La url_cobranza_callback debe ser un endpoint que sea accesible por SQ Núcleo para enviar la notificación sin autenticación en el sistema externo.
- Se debe tener corriendo un nuevo worker que se encargará de enviar estas notificaciones.
Para iniciar ejecutar:
./bin/sq iniciar_queue_workers
- Se crearon las tablas queue y messages en el esquema queue de la base de datos del Núcleo.
- En la tabla queue se almacena temporalmente lo encolado, y en la tabla messages las notificaciones enviadas tanto las enviadas correctamente como las fallidas.
- Si el mensaje en estado FALLIDO se reencola y se envía correctamente, se actualizará la tabla messages con estado ENVIADO.
- Las notificaciones fallidas almacenadas en la tabla messages contienen el detalle del error en la columna estado_detalle.
Workflow
