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

Campo	Tipo	Descripción	Requerido
email	string	email asignado por Eprezto	Sí
password	string	password asignada por Eprezto	Sí

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

Campo	Descripción	Requerido
Authorization	Enviar el token generado al autenticarse	Sí

Cuerpo de la Solicitud

Campo	Tipo	Descripción	Requerido
insurancePdfUrl	string	URL del PDF de la póliza emitida.	Sí
codeGroup	string	Código de grupo.	Sí
policyId	string	Número de Póliza	Sí

Ejemplo de Uso

cURL

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

Campo	Descripción	Requerido
Authorization	Enviar el token generado al autenticarse	Sí

Cuerpo de la Solicitud

Campo	Tipo	Descripción	Requerido
reason	string	Motivo del error en la emisión de la póliza.	Sí
reasonCode	number	Código del motivo del error.	No
codeGroup	string	Código de grupo.	Sí

Ejemplo de Uso

cURL

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