If you need help don't forget to use our artificial intelligence
Request for Sabueso APP to use your Webhook
If you need the Sabueso system to notify your system of any change in status in some of the processes that it consumes from our system, you can do so through a Webhook.
How does a webhook work?
Webhooks are user-defined http request submissions that are triggered by specific events. For webhooks to work, it is necessary to register a URL to notify you each time an event occurs. The path created must contain the logic that will be executed once the event occurs.
When the Sabueso system responds from the webhook it returns the following:
REQUEST
Guide Status
Field Name Type Comment Format location String This value contains the location of the user. observations String This value explains the reason for the status change. statusObj Object For more details see the StatusObj table. value String This value is a guide number date String This value contains the date of change in UTC-06:00. dd/MM/yyyy HH:mm dateTime String This value contains the date of change in UTC-06:00. yyyy-MM-dd HH:mm:ss POD ByteArray This byte array value to attachment if exist POD_B64 String This base 64 value to attachment if exist POD_fileName String This value to attachment if exist
Status Obj
Field Name Type Comments id Integer This value contains the id of the state. code String This value contain the prefix of the state . description String This value contain the description Spanish of the state. description_en String This value contain the description English of the state. long_description String This value contain the long description Spanish of the state. long_description_en String This value contain the long description English of the state.
JSON example:
{
"dateTime": "2024-04-03 14:57:00",
"location": "Ciudad de Mexico",
"observations": "WebHook Test",
"statusObj": {
"id": 2,
"code": "DLV",
"description": "ENTREGADO POD EN SISTEMA",
"description_en": "DELIVERED POD IN SYSTEM",
"long_description": "El mensajero logra concretar la entrega a la direcci?n impresa en la etiqueta del paquete y se obtiene evidencia (una fotograf?a y/o firma) para comprobar la entrega del paquete ",
"long_description_en": "The courier manages to make the delivery to the address printed on the package label and evidence is obtained (a photograph and / or signature) to verify the delivery of the package"
},
"POD": [-119,80,78,71,13,10,26,10,0,0,0,13,73,72,68,82,0,0,0,-108,0,0,0,-44,8,3,0,0,0,77,-70,-6,-118,0,0,0,1,115,82,71,66,0,-82,-50,28,-23,0,0,0,4,103,65,77,65,0,0,-79,-113,11,-4,97,5,0,0,0,111,80,76,84,69,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,109,-22,-67,70,0,0,0,36,116,82,78,83,0,5,7,15,24,25,30,37,38,44,48,50,52,72,74,77,78,83,99,102,105,108,110,113,-119,-105,-103,-79,-77,-63,-45,-31,-21,-20,-6,-4,105,57,-53,-48,0,0,0,9,112,72,89,115,0,0,50,-64,0,0,50,-64,1,40,100,90,-37,0,0,0,-97,73,68,65,84,120,94,-19,-50,89,78,-126,65,16,-123,-47,95,20,28,0,113,22,100,112,-86,-3,-81,-111,78,-68,123,-24,78,60,-25,-91,82,-33,-45,-99,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,-2,-81,-117,-36,97,44,15,-97,63,-11,125,122,-51,59,-124,-121,-118,93,-62,8,-114,-39,84,53,79,25,-64,111,38,85,-35,-89,-12,119,-107,69,-51,83,82,127,-41,89,-44,-68,39,-11,-73,-56,-94,-26,57,-87,-65,-53,44,106,30,-109,6,-16,-107,73,85,-85,-108,1,108,51,-87,-114,9,35,-104,125,-4,109,-38,-33,37,-116,-31,102,-3,-14,-74,-71,-51,3,0,0,0,0,0,0,0,0,0,0,0,0,93,77,-45,25,118,-20,15,60,-1,23,-87,-86,0,0,0,0,73,69,78,68,-82,66,96,-126],
"POD_B64": "iVBORw0KGgoAAAANSUhEUgAAAJQAAADUCAMAAABNuvqKAAAAAXNSR0IArs4c6QAAAARnQU1BAACxjwv8YQUAAABvUExURQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAG3qvUYAAAAkdFJOUwAFBw8YGR4lJiwwMjRISk1OU2NmaWxucYmXmbGzwdPh6+z6/Gk5y9AAAAAJcEhZcwAAMsAAADLAAShkWtsAAACfSURBVHhe7c5ZToJBEIXRXxQcAHEWZHCq/a+RTrx76E4856VS39OdAAAAAAAAAAAAAAAAAAAAAP6vi9xhLA+fP/V9es07hIeKXcIIjtlUNU8ZwG8mVd2n9HeVRc1TUn/XWdS8J/W3yKLmOam/yyxqHpMG8JVJVauUAWwzqY4JI5h9/G3a3yWM4Wb98ra5zQMAAAAAAAAAAAAAAABdTdMZduwPPP8XqaoAAAAASUVORK5CYII=",
"POD_fileName": "file.png",
"value": "PRB0000000000001",
"date": "03/04/2024 14:57"
}
Image Example
The byteArray and B64 strings corresponds to the following image
To use the webhook and receive the update of the status of all the guides, you only have to share your end point and the key (if necessary) where you will receive the request explained above, do not forget to implement the response, to validate the receipt of the information.