Saltar al contenido principal

Webhooks

Autenticación​

Será necesario autenticarse antes de consumir los endpoints correspondientes. Para esto se le asignara un email y un password a cada aseguradora.

URL del Endpoint​

Desarrollo:

guatemala-lambdas.eprezto.com/dev/eprezto-auth-login  

Producción:

guatemala-lambdas.eprezto.com/dev/eprezto-auth-login  

Método HTTP​

POST

Cuerpo de la Solicitud​

CampoTipoDescripciónRequerido
emailstringemail asignado por EpreztoSí
passwordstringpassword asignada por EpreztoSí

Ejemplo de Respuesta 200​

{
"token":
"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VyIjp7Il9pZCI6InJiaU1YcUZybWs3bnFKdFJ0IiwiZW1haWwiOiJneXQt
Z3VhdGVtYWxhQGVwc6VeaG8uY29tIiwiZGV0YWlscyI6eyJjb3VudHJpZXMiOltdfSwiaXNBc2VndXJhZG9yYSI6bnVsbCwiYXNlZ3
VyYWRvcmEiOm51bGwsImlzSW5zcGVjdG9yIjpudWxsLCJjaWFTZWciOm51bGwsImdyb3VwSWRzIjpbIkRxMmFqV3BudzdRdW0yeEJl
Il0sImJyYW5kSWRzIjpbXX0sImlhdCI6MTcxMzU0MTU5NywiZXhwIjoxNzEzNjI3OTk3fQ.t_G-RbAZ1KaVjt58AFujexskTdnNHZq
IXPAODfZlH-I"
}

Confirmación de Emisión de Póliza​

Descripción​

Este webhook se encarga de confirmar a Eprezto que el vehículo ha pasado el proceso de inspección y que la póliza ha sido emitida.

URL del Endpoint​

Desarrollo:

https://guatemala-lambdas.eprezto.com/dev/seguros-gyt/issue-insurance-confirmation

Producción:

https://guatemala-lambdas.eprezto.com/prod/seguros-gyt/issue-insurance-confirmation

Método HTTP​

POST

Headers​

CampoDescripciónRequerido
AuthorizationEnviar el token generado al autenticarseSí

Cuerpo de la Solicitud​

CampoTipoDescripciónRequerido
insurancePdfUrlstringURL del PDF de la póliza emitida.Sí
codeGroupstringCódigo de grupo.Sí
policyIdstringNúmero de PólizaSí

Ejemplo de Uso​

curl --request POST \
--url 'https://guatemala-lambdas.eprezto.com/dev/seguros-gyt/issue-insurance-confirmation' \
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCIsImtCI6ImM3MmEwZDc4NiJ9.eyJleHAiOjE3MTM5NzE2NzcsImlhdCI0MTcxMzk2ODA3NywiaXNzIjoiZXByZXp0by5jb20iLCJzdWIiOiIyOWRiNDRiOS00NTU4LTQ3Y2UtYjA4My00NWQxZGUxODhmMGMiLCJqdGkiOiJjZjNmOThiOC01YWE1LTRjZDAtYTVmMy04MWNmZTllNDQ3ZGIiLCJhdXRoZW50aWNhdGlvblR5cGUiOiJQQVNTV09SRCIsImVtYWlsIjoiZ3l0LWd1YXRlbWFsYUBlcHJlenRvLmNvbSIsImVtYWlsX3ZlcmlmaWVkIjp0cnVlLCJwcmVmZXJyZWRfdXNlcm5hbWUiOiJneXQtZ3VhdGVtYWxhIn0.XtGXE1uzoRJJ20_HUbv6gza2xV5ngbNpERPbPoXmyHk' \
--header 'Content-Type: application/json' \
--data '{"insurancePdfUrl":"https://example.com/poliza.pdf", "codeGroup":"QG129005", "policyId":"00000000"}' \

Ejemplo de Respuesta 200​

{
"message": "Request received successfully"
}

Ejemplo de Respuesta 422​

{
"type": "https://developer.mozilla.org/docs/Web/HTTP/Status/422",
"title": "Unprocessable Entity",
"detail": "Event object failed validation",
"instance": "/seguros-gyt/issue-insurance-confirmation",
"status": 422,
"errors": [
{ "message": "must have required property 'insurancePdfUrl'" }
]
}

Ejemplo de Respuesta 401​

{
"type": "https://developer.mozilla.org/docs/Web/HTTP/Status/400",
"title": "AppError",
"detail": "Not Authorized",
"status": 401
}

Error al Emitir Póliza​

Descripción​

Este endpoint se encarga de notificar a Eprezto que la póliza no puede ser emitida, indicando también el motivo de esta situación.

URL del Endpoint​

Desarrollo:

https://guatemala-lambdas.eprezto.com/dev/seguros-gyt/issue-insurance-error

Producción:

https://guatemala-lambdas.eprezto.com/prod/seguros-gyt/issue-insurance-error

Método HTTP​

POST

Headers​

CampoDescripciónRequerido
AuthorizationEnviar el token generado al autenticarseSí

Cuerpo de la Solicitud​

CampoTipoDescripciónRequerido
reasonstringMotivo del error en la emisión de la póliza.Sí
reasonCodenumberCódigo del motivo del error.No
codeGroupstringCódigo de grupo.Sí

Ejemplo de Uso​

curl --request POST \
--url 'https://guatemala-lambdas.eprezto.com/dev/seguros-gyt/issue-insurance-error' \
--header 'Authorization: Bearer eyJhcGciOiJIUzI1NiIsInR5cCI6IkpXVCIsImtpZCI6ImM3MmEwZDc4NiJ9.eyJleHAiOjE3MTM5OTUwNzIsImlhdCI6MTcxMzk5MTQ3MiwiaXNzIjoiZXByZXp0by5jb20iLCJzdWIiOiIyOWRiNDRiOS00NTU4LTQ3Y2UtYjA4My00NWQxZGUxODhmMGMiLCJqdGkiOiJhYjc2MzI4MS01NGM4LTQyOGMtODIxOS1iYThlZmRkZDY4YjkiLCJhdXRoZW50aWNhdGlvblR5cGUiOiJQQVNTV09SRCIsImVtYWlsIjoiZ3l0LWd1YXRlbWFsYUBlcHJlenRvLmNvbSIsImVtYWlsX3ZlcmlmaWVkIjp0cnVlLCJwcmVmZXJyZWRfdXNlcm5hbWUiOiJneXQtZ3VhdGVtYWxhIn0.APyk2iFcD0B5bbOYMszBNQuKf7MCMEbCm6DSmk5ZUmg' \
--header 'Content-Type: application/json' \
--data '{
"reason": "rotura de vidrios",
"reasonCode": 3,
"codeGroup": "QG129010"
}'

Ejemplo de Respuesta 200​

{
"message": "Request received successfully"
}

Ejemplo de Respuesta 422​

{
"type": "https://developer.mozilla.org/docs/Web/HTTP/Status/422",
"title": "Unprocessable Entity",
"detail": "Event object failed validation",
"instance": "/seguros-gyt/issue-insurance-confirmation",
"status": 422,
"errors": [
{ "message": "must have required property 'codeGroup'" }
]
}