Para poder dejar representado el status de una transacción en Deals, existe la posibilidad de establecer un status sin la necesidad de generar una grilla específica para la misma. Los posibles status son:
- “Sin informar”: Estado por defecto cuando una transacción ingresa a Deals, pero no fue notificado ningún método GET.
- “Ok”: Se utiliza para indicar que la transacción pudo ser utilizada correctamente por el método GET asociado.
- “No procesado”: Es un status intermedio, sugerido para utilizar cuando la transacción no es utilizada en lo inmediato.
- “Error”: En caso de existir un fallo notificado por el método GET, marca dicha transacción como errónea, permitiendo que la misma sea reprocesada desde la interfaz gráfica del monitor.
2. Endpoints para actualizar status
Para actualizar el status de una transacción dentro de Deals, se utiliza el siguiente endpoint:
- Método: POST
- URL:
https://{go-env}.finneg.com/api/1/deals-logs/transaction
- Request Header:
Authorization Bearer Token
(Un token de Deals) - Request Body:
Copiar
{
"idTransaction": "",
"status": "",
"response": "",
"visibleFields": [
{
"field": "Asignatura",
"value": "Jua"
}
]
}
- idTransaction: Id de la transacción recibida desde Deals.
- status: Posibles valores:
PENDING
,ERROR
,SUCCESS
. - response: Log a visualizar en el botón de visualizar response.
- visibleFields: Listado de objetos opcional, por si se desea actualizar el valor que se muestra en el monitor de un campo en particular. Es importante tener en cuenta que solo modifica el valor visible en el monitor, no el contenido del JSON que se descargará en caso de ser reprocesado. De no mandarlo no afecta en el funcionamiento.
Nota: Los posibles valores de la variable go-env
pueden ser:
DEV
:go-dev
QA
:go-qa
PROD
:go-prod
3. Consideraciones en el desarrollo
El proceso que se encarga de llamar al método GET configurado en Deals generará la notificación a la URL definida y esperará 1 minuto para obtener un status 200 de respuesta. En caso de demorar más de eso, lo marcará como Error en el monitor.