Skip to main content
Version: Latest

Eventos de Webhook en Formato XML

Payload definido en XML en caso de que el operador no pueda enviar la informacion con el estándar de AveOnline

Se debe contar con el token para el uso de este Servicio

Request 🚀​

url​

https://api.aveonline.co/api-webhook/public/api/v1/shipping-events-hook

Method​

POST

Content-Type: application/xml
Accept: application/xml
Ave-Hub-signature: <Token JWT Firmado Por AveOnline>

Params JSON​

  • tipo* String "xml" Descripción del formato de la trama a guardar
  • body* Object -> [{}] Trama o tramas para procesar enviada en un Array
    • id_envio* String Número del envio generado por el proveedor
    • cod_estado* String Código del estado de la guia generado por el proveedor
    • nombre_estado* String Nombre del estado de la guia, formato definido por el proveedor
    • fecha_estado* String AAAA-MM-DD HH:MM:ss Fecha actualizada del estado de la guia
    • cod_novedad String "" | null | 0 , si no existe Código de novedad, formato definido por proveedor
    • nombre_novedad String "" | null | 0 , si no existe Nombre de la novedad generado y formato definido por proveedor
    • fecha_novedad String AAAA-MM-DD HH:MM:ss "" | null | 0 , si no existe Código de novedad, formato definido por proveedor
    • estado_novedad String "" | null , si no existe En que estado se encuentra la novedad
    • guia_reeemplazo String "" | null | 0 , si no existe ¡En caso de devolución! Nueva guia de rastreo del envio "CONT" ¡En caso de continuidad!
    • tipo_guia_reeemplazo String "" | null , si no existe reemplazo "DEV" ¡En caso de devolución! "REEMP" ¡En caso de reemplazo de la guia anterior!
    • ruta_digitalizada String "" | null Url de la guia para su posterior descarga
    • base64_entrega_digitalizada Object -> [{}] Trama con el base 64
      • base64 String Cadena de texto con el comprobante de entrega en Base64
      • mime_typeString Cadena de texto con el tipo del archivo, solo con los siguientes formatos: image/jpeg image/png application/pdf
    • observaciones String "" | null Observaciones relevantes al envio

Ejemplo con soporte para XML​

<document>
    <tipo>xml</tipo>
    <body>
        <id_envio>123-522-322</id_envio>
        <cod_estado>10</cod_estado>
        <nombre_estado>DIRECCION ERRADA</nombre_estado>
        <fecha_estado>2022-11-09T13:27:27+00:00</fecha_estado>
        <nombre_novedad>DIRECCION ERRADA</nombre_novedad>
        <estado_novedad>EJECUTADA</estado_novedad>
        <cod_novedad>2</cod_novedad>
        <fecha_novedad>2022-12-11 11:31:00</fecha_novedad>
        <guia_reemplazo>123-444-222 </guia_reemplazo>
        <tipo_guia_reemplazo>DEV | REEMP | CONT </tipo_guia_reemplazo>
        <ruta_digitalizada>www.laruta.com/docs/ </ruta_digitalizada>
        <base64_entrega_digitalizada>
            <base64>Base64 was here</base64>
            <mime_type>application/pdf</mime_type>
        </base64_entrega_digitalizada>
        <observaciones>no se encuentra la dirección</observaciones>
    </body>
</document>

Importante
  • En el body se puede enviar información de más de una guia, en caso de ser XML se repite el string con la tag body dentro de la tag padre <documen></document> .
  • De ser solo la información de una guia, tambien debe ir dentro de un array.
  • Verifica que el token este vigente, no ser asi no se acepta la petición.
  • Cambios y sugerencias: desarrollo2@aveonline.co, desarrollo3@aveonline.co
  • Si se cambian los campos una vez establecidos, no se tendrá en cuenta esa información.

Response 📄​

Created​

  • status String Estado del resultado
  • message String Mensaje de respuesta
  • status_code String Codigo de estado de la respuesta
<?xml version="1.0" encoding="UTF-8"?>
<document>
    <status>success</status>
    <data>Your webhook was received successfully</data>
    <status_code>201</status_code>
</document>

Unauthenticated​

Este error se da comunmente cuando el el token espiró

  • title String Estado del resultado
  • detail String Mensaje descriptivo del error
  • status_code String Codigo de estado de la respuesta
<?xml version="1.0" encoding="UTF-8"?>
<document>
    <errors>
        <title>Unauthenticated</title>
        <detail>The signature is invalid.</detail>
        <status_code>401</status_code>
    </errors>
</document>

Unprocessable Content​

Errores de validacion

  • title String Estado del resultado
  • detail String Mensaje descriptivo del error
  • status_code String Codigo de estado de la respuesta
<?xml version="1.0" encoding="UTF-8"?>
<document>
    <errors>
        <title>Unprocessable Content </title>
        <detail>El campo id_envio es obligatorio</detail>
        <status_code>422</status_code>
    </errors>
</document>

Bad Request​

Mala peticion, la request presenta un error de estructura en la informacion enviadaSe recomienda verificar los headers

<?xml version="1.0" encoding="UTF-8"?>
<document>
    <errors>
        <title>Bad Request</title>
        <detail>The JWT string must have two dots</detail>
        <status_code>400</status_code>
    </errors>
</document>