Diferencia entre revisiones de «SIU-Sanaviron-Quilmes/version2.11.0/nucleo cobro sistema externo»

De SIU
Saltar a: navegación, buscar
(Página creada con «__NOTOC__ <span style="float: right; margin: 0 0 15px 15px;">Archivo:ISOSIU-SQ.png|derecha|60px||derecha|link=SIU-Sanaviron-Quilmes/version2.11.0/documentacion_de_las_ope...»)
 
 
(No se muestran 22 ediciones intermedias de 2 usuarios)
Línea 2: Línea 2:
 
<span style="float: right; margin: 0 0 15px 15px;">[[Archivo:ISOSIU-SQ.png|derecha|60px||derecha|link=SIU-Sanaviron-Quilmes/version2.11.0/documentacion_de_las_operacionesf]] </span>
 
<span style="float: right; margin: 0 0 15px 15px;">[[Archivo:ISOSIU-SQ.png|derecha|60px||derecha|link=SIU-Sanaviron-Quilmes/version2.11.0/documentacion_de_las_operacionesf]] </span>
  
 +
[[SIU-Sanaviron-Quilmes/version2.11.0/otras.consid.tecnicas|'''< Volver''']]
 +
 +
<big>
 +
= 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"'''
  
−
[[SIU-Sanaviron-Quilmes/version2.11.0/otras.consid.tecnicas|'''< Volver''']]
+
'''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>
 +
 
 +
* 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 ==
  
−
= Redirección a pasarela de pago exceptuando SQ-Pagos =
+
[[Archivo:Cobro_con_sistemas_externos.png|centro|1000px]]

Revisión actual del 15:24 7 nov 2025

ISOSIU-SQ.png

< Volver

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"
    }
}

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

Cobro con sistemas externos.png
Obtenido de «https://documentacion.siu.edu.ar/wiki/index.php?title=SIU-Sanaviron-Quilmes/version2.11.0/nucleo_cobro_sistema_externo&oldid=110241»