Integración por API REST

Nuestra API REST es una interfaz de programación de aplicaciones diseñada para facilitar la comunicación entre tu plataforma ecommerce y nuestros sistemas de logística. Esta API te permite acceder a una las funciones y operaciones para gestionar envíos, cotizaciones y estados de los envíos de manera programática.

Si requieren un ambiente de pruebas, solicitar la URL a su contacto en iFLOW.

URL Ambiente Productivo: https://mpe.iflow21.com/api.

Registro

Para poder realizar envíos con iFLOW ecommerce es necesario que tengas tus credenciales de acceso es necesario que te registres. Si ya tenés credenciales podés avanzar al siguiente paso.

1. Ingresá a registro.iflow21.com/register

2. Completa tus datos

Una vez registrado, vas a recibir un correo de confirmación.

Iniciar Sesión en Portal iFlow y Aceptar Términos y Condiciones

1. Ingresá a track.iflow21.com con tu nuevo usuario y contraseña.

2. Al ingresar por primera vez, se te solicitará aceptar nuestros Términos y Condiciones. Leelos detenidamente y hacé clic en "Aceptar" para continuar.

Importante: no te permitirá crear envíos hasta que no aceptas los Términos y Condiciones, .

Autorización

Para utilizar nuestra API, vas a necesitar utilizar autorización mediante Bearer token.

1. [Requisito] Credenciales y alta de usuario: Vas a necesitar tus credenciales (usuario y contraseña) que te va a dar el equipo comercial cuando te dé de alta. Consultá este apartado https://iflow21.gitbook.io/ecommerce#como-empezar
2. Solicitar Bearer token: Una vez tengas tus credenciales para el ambiente, en el siguiente endpoint, vas a poder solicitar un Bearer token.

POST /login

Parámetros de solicitud

_username Obligatorio String

Nombre de usuario

_password Obligatorio String

Contraseña

Ejemplo

Solicitud

curl --location. 'https://mpe.iflow21.com/api/login' \
--header 'Content-Type: application/json' \
--data '{
    "_username": "tienda",
    "_password": "123456"
}'

Response

🟢 200

{
  "success": true,
  "message": "",
  "token": "eyJhbGciOiJSUzI1NiJ9.eyJyb2xlcyI6WyJST0xFX0NVU1RPTUVSIiwiUk9MRV9BUElfQ0xJRU5UIiwiUk9MRV9BUElfQ0xJRU5UX0NBTkNFTF9PUkRFUiIsIlJPTEVfQVBJX0NMSUVOVF9DQU5DRUxfU0hJUFBJTkciLCJST0xFX0FQSV9DTElFTlRfTUVSQ0hBTlRfT1JERVJfQUREIiwiUk9MRV9BUElfQ0xJRU5UX1NISVBQSU5HX1JFVFVSTiIsIlJPTEVfQVBJX0NMSUVOVF9TSElQUElOR19CQVRDSF9QUklOVElORyIsIlJPTEVfQVBJIl0sInVzZXJuYW1lIjoiY2xpZW50ZV90ZXN0IiwidGVybXNfYWNjZXB0ZWQiOnRydWUsInByZXBhZ28iOmZhbHNlLCJsb2dpc3RpY2FfaW52ZXJzYSI6dHJ1ZSwiZGVmYXVsdF9mb3JtYXQiOiJwZGYiLCJ1c2VyX3R5cGUiOiJDbGllbnQiLCJpYXQiOjE2MTk0NjY0NDgsImV4cCI6MTYxOTQ3MDA0OH0.tTEeWcAcAotkrpRHam54gqglb0q9LBurmiXm3XnRZLXtIlG2SqXprVrO-Vb_QQEdC_U8SANpcc51onaP7ttFWCQwxJL725WFObMJGpCR63SjrxJCGmzi3KeXDXPEJfjlAoHBDts5iiUDgvv2y55AfLfRorqnhThlcH8A21CrC8ulFYddNjElZB-RGyhFxbM-b0rFV6R2NArqvHaYU6BxNNBwzP2266kJb3IV_twkHxM91ScOJXBtYoJX3EtnCuJb2mEYwR1ne9W3HFNm4EBET4BqvB-GBuaP9p6EWM1pjvZWxhGy87wf-i9x8ktoZJ7pSjWApQNlrKe0w9Eu760eXDoY6XieNUY5imuJ8H3rvPpzgx3hv6X3xB1gOL_fgJ6sINXh3BF7Z35ovFQko4jEy69kuRLd01_qZqxMKT5MCizFGV1fUhhdkIgmFUjL6aeJSe7quraI9_vq8utnU4_MbSb6QZq_ZDCtskFRnCUKPHQWdjN7Ygr_KHdViKlwQMnjLoGBwgsmzYswzPRA_e2aiFyRP0YN03BZXGj5AvnXKFktiz6nH_ocewtjTHJmz2kJA2Ol0INObCOrLfw56A-F0Y5OI8Y-kOhyKnh-6IlibutHuS2PyMGVYo4Ivt1OlpQxaa3d3B_1XdKPjN9O3OWdhVbW_gARUhx0xynFrjQ1FU8"
}

🟡 200 (Credenciales inválidas)

{
    "success": false,
    "message": "Invalid credentials."
}

1. Conservar y actualizar Bearer token: El token generado por este servicio tiene una duración de 60 minutos antes de expirar por lo que solicitamos guardar, reutilizar y actualizar cuando se vaya a utilizar la API pasado el plazo de actualización.

2. Utilizar Bearer token: Todos los llamados que se hagan a las APIs de iFLOW deberán incluir en su encabezado de autorización tipo Bearer con el token obtenido en el punto anterior.

Ejemplo

Solicitud (Encabezado)

curl --location 'https://mpe.iflow21.com/api/order/create' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {{token}}' \

Cotizar y crear envíos

En esta sección, se detallan los diferentes endpoints y operaciones disponibles para cotizar y solicitar los distintos tipos de envíos:

Pedido de cotización

Utiliza este endpoint para enviar una solicitud de cotización y obtener información sobre los costos de envío disponibles para un determinado paquete y destino.

POST /rate

Parámetros de solicitud

zip_code Obligatorio String

Código postal del destino del envío. Debe tener un formato numérico de 4 dígitos.

Provincia del destino del envío.

packages Obligatorio Objeto

Contenedor con los detalles de el/los paquetes a enviar.

width Obligatorio Integer

Centímetros de ancho del paquete a enviar.

height Obligatorio Integer

Centímetros de alto del paquete a enviar.

length Obligatorio Integer

Centímetros de largo del paquete a enviar.

real_weight Obligatorio Integer

Peso del paquete en kilogramos.

gross_price Obligatorio String

Valor del paquete.

delivery_mode Obligatorio Integer

Modo de envío. En producción, este valor será definido por el equipo comercial iFlow ecommerce. Para pruebas (testing), se debe utilizar el valor 1.

Ejemplo

Solicitud 1 Paquete

curl --location 'https://mpe.iflow21.com/api/rate' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {{token}}' \
--data '{
    "zip_code": "1663",
    "province": "BUENOS AIRES",
    "packages": [
        {	
            "width": 5,
            "height": 5,
            "length": 5,
            "real_weight": 21,
            "gross_price": 100
        }
    ],
    "delivery_mode": 1
    
}'

Solicitud 2 Paquetes

curl --location 'https://mpe.iflow21.com/api/rate' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {{token}}' \
--data '{
    "delivery_mode": 1,
    "zip_code": "1900",
    "province": "Buenos Aires",
    "packages": [
        {
            "width": 15,
            "height": 25,
            "length": 20,
            "real_weight": 1,
            "gross_price": 100
        },
        {
            "width": 10,
            "height": 200,
            "length": 15,
            "real_weight": 8,
            "gross_price": 300
        }
    ]
}

Response

🟢 200

{
  "code": 200,
  "message": "Estimación realizada con éxito.",
  "count": 1,
  "results": {
    "shipping_cost": 150,
    "tax": 31.668,
    "insurance_cost": 0.8,
    "final_value": 182.468,
    "currency": "ARS",
    "min_delivery_date": "2024-04-28",
    "max_delivery_date": "2024-04-29"
  }
}

🟡 500 Datos inválidos

{
    "code": 500,
    "message": "Codigo postal no habilitado para el envío. Motivo: el CP no posee tiempos de demora.",
    "count": 1,
    "results": false
}

🟡 401 Unauthorized

{
    "code": 401,
    "message": "Invalid JWT Token"
}

Crear nueva orden

Utiliza este endpoint para crear una nueva orden de envío. Deberás proporcionar los detalles del remitente, destinatario, paquete y cualquier otra información relevante para la entrega.

Crea orden, se deben detallar los paquetes asignados a la misma. Por cada orden se retorna tracking_id (Identifica la orden), shipment_id (Identifica cada paquete), enlace a etiqueta por cada paquete.

POST /order/create

Parámetros de solicitud

order_id Obligatorio String (20)

Código de pedido generado por tu tienda.

delivery_mode Obligatorio Integer

Modo de envío (Ej. envío a domicilio, logística inversa): En producción, este valor será definido por el equipo comercial de iFlow ecommerce. Para envíos a domicilio, el modo de envío debe ser igual a 1, mientras que para logística inversa debe ser igual a 4. Para pruebas (testing), asegúrate de usar el valor correspondiente según el tipo de envío.

order_sender_public_description String (200)

Este parámetro se utiliza para personalizar la manera en que el nombre de tu tienda aparece en las notificaciones que enviamos a tus clientes. El valor que envíes en este campo, será utilizado como el nombre de tu tienda en todas las comunicaciones al cliente, incluyendo correos electrónicos, mensajes de WhatsApp y la visualización del seguimiento del envío (tracking).

Si el campo no se envía, se utilizará tu nombre de usuario registrado en nuestro sistema.

shipments Obligatorio Array

Es un contenedor donde se listan los envíos (cada paquete es un envío, y a cada envío iFLOW asocia una etiqueta con un número único).

id String (16)

En caso de imprimir previamente la etiqueta, pueden indicar qué código tendrá cada paquete. Este id estará generado por 3 letras que deberán solicitar a iFLOW (ej. ABC) y 13 números que deberán asignar incrementalmente (ej. 0000000000001, 0000000000002, etc.). quedando como resultado ej. ABC0000000000001, ABC0000000000002.

items_value Obligatorio Decimal(10,2)

Valor de todos los ítems en el envío, expresado en pesos ARS.

width Obligatorio Integer

Centímetros de ancho del paquete a enviar.

height Obligatorio Integer

Centímetros de alto del paquete a enviar.

length Obligatorio Integer

Centímetros de largo del paquete a enviar.

real_weight Obligatorio Integer

Peso del paquete en kilogramos.

items Obligatorio Array

Es un contenedor donde se listan los items dentro de cada paquete.

item Obligatorio String (200)

Descripción del ítem.

SKU Obligatorio String (40)

Código de producto.

quantity Obligatorio Integer (11)

Cantidad de unidades del ítem.

receiver Obligatorio Array

Es un contenedor donde se listan los detalles del destinatario.

first_name Obligatorio String (30)

Nombre del destinatario.

last_name Obligatorio String (30)

Apellido de destinatario.

receiver_name Obligatorio String (100)

Nombre de quien recibirá el envío.

receiver_phone Obligatorio String (60)

Teléfono de quien recibirá el envío.

email Obligatorio String (100)

Correo electrónico de destinatario

address Obligatorio Array

Es un contenedor donde se listan los elementos de la dirección del destinatario.

street_name Obligatorio String (60)

Nombre de calle del destinatario.

street_number Obligatorio Integer (20)

Número de puerta del destinatario.

between_1 Obligatorio String (60)

Calle lateral 1 o intersección del destinatario.

between_2 String (60)

Calle lateral 2 del destinatario.

floor String (10)

Piso.

apartment String (10)

Departamento.

other_info Obligatorio String (250)

Información adicional / otros detalles del destino.

zip_code Obligatorio String

Código postal del destino del envío. Debe tener un formato numérico de 4 dígitos.

city Obligatorio String (60)

Ciudad.

neighborhood_name Obligatorio String (40)

Localidad.

state Obligatorio String (20)

Provincia.

Ejemplo

Solicitud de Orden con 1 Envio

curl --location 'http://mpe.iflow21.com/api/order/create' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer eyJhbGciOiJSUzI1NiJ9.eyJyb2xlcyI6WyJST0xFX0NVU1RPTUVSIiwiUk9MRV9BUElfQ0xJRU5UIiwiUk9MRV9BUElfQ0xJRU5UX0NBTkNFTF9PUkRFUiIsIlJPTEVfQVBJX0NMSUVOVF9DQU5DRUxfU0hJUFBJTkciLCJST0xFX0FQSV9DTElFTlRfTUVSQ0hBTlRfT1JERVJfQUREIiwiUk9MRV9BUElfQ0xJRU5UX1NISVBQSU5HX1JFVFVSTiIsIlJPTEVfQVBJX0NMSUVOVF9TSElQUElOR19CQVRDSF9QUklOVElORyIsIlJPTEVfQVBJIl0sInVzZXJuYW1lIjoiY2xpZW50ZV90ZXN0IiwidGVybXNfYWNjZXB0ZWQiOnRydWUsInByZXBhZ28iOmZhbHNlLCJsb2dpc3RpY2FfaW52ZXJzYSI6dHJ1ZSwiZGVmYXVsdF9mb3JtYXQiOiJwZGYiLCJ1c2VyX3R5cGUiOiJDbGllbnQiLCJpYXQiOjE3MTc1NDkxNTYsImV4cCI6MTcxNzU1Mjc1Nn0.lt15GptNFfG8VZU4aW0qolf1fn_M1EBnqigIUdEdCpdocxXrBQVhTWDzvNlnkNvlMZE2DZtB63kTb0seJ84JOAVi8tV32SRJsnR_D26CADxrZO5F6YkXHYHuwGmcyz9po6MriI2szofyiHtklGQa9tuHY-nSadQFtcHtUKaN_M6jC5ZqM96nvE-KLjdZFYjY78KEpPgKg5Mx725jHKcHhEs894jv-N8XsobMA6KwXAXf6oiFNC8n996OcHXdq9_yj0Vc_TuK0Y2FIIE-EkshwUzn-RBBx3_RfWr5aSS_yeF8VEne4LUKH3A1wYd29UWkb9To2t5XlwKCXS-MXEOR7k1Cjg8gZRqvpErPRaIFNzGrmfOmt5lwFZRKgCdo6cTWokIEb4PUVz6llQeAgsQ-7FILGgSeH0MphQxiubfwz6v9j1aMUyLSD3Lfv-7Mdmr8d4tFB--ECjt0IC9SfXrWcHaPRIL3XA8snR2_IO05eCSEqIIqHfrzu9JoWc8X7TrjQuZiAwVT5OhqJgXVe4HdgQDhdzHDsgpjcuNOmGhDGcu-dQPHDqN4JbvUjniO4wt7hmfY0VOCwEXNxGNRm9yaZS77QuzbLAed-LaEQq3nuZKCFbPs0hsZXCQyl2HP8h5K4f5B0zOxBLQT7CuWyo7bE6F9Y0Us_Pt9JU5JDCpegBU' \
--header 'Cookie: SERVERID=api_iflow21_n2' \
--data-raw '{
  "order_id": "Nro de pedido",
  "delivery_mode": 1,
  "shipments": [
    {
      "items_value": 100.25,
      "width": 10,
      "height": 10,
      "length": 10,
      "weight": 2,
      "items": [
        {
          "item": "Artículo Descripción",
          "sku": "ABC123",
          "quantity": "1"
        }
      ]
    }
  ],
  "receiver": {
    "first_name": "Angelino",
    "last_name": "Cubrepileta",
    "receiver_name": "Angelino",
    "receiver_phone": "1112345678",
    "email": "[e-mail]",
    "document": "12345678",
    "address": {
      "street_name": "Av Rivadavia",
      "street_number": "13800",
      "between_1": "Calle A",
      "between_2": "Calle B",
      "floor": "5°A",
      "other_info": "Casa Amarilla",
      "zip_code": "1704",
      "city": "Ramos Mejía",
      "neighborhood_name": "Barrio",
      "state": "BUENOS AIRES"
    }
  }
}'

Solicitud de Orden con 2 Envios

curl --location 'http://mpe.iflow21.com/api/order/create' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer eyJhbGciOiJSUzI1NiJ9.eyJyb2xlcyI6WyJST0xFX0NVU1RPTUVSIiwiUk9MRV9BUElfQ0xJRU5UIiwiUk9MRV9BUElfQ0xJRU5UX0NBTkNFTF9PUkRFUiIsIlJPTEVfQVBJX0NMSUVOVF9DQU5DRUxfU0hJUFBJTkciLCJST0xFX0FQSV9DTElFTlRfTUVSQ0hBTlRfT1JERVJfQUREIiwiUk9MRV9BUElfQ0xJRU5UX1NISVBQSU5HX1JFVFVSTiIsIlJPTEVfQVBJX0NMSUVOVF9TSElQUElOR19CQVRDSF9QUklOVElORyIsIlJPTEVfQVBJIl0sInVzZXJuYW1lIjoiY2xpZW50ZV90ZXN0IiwidGVybXNfYWNjZXB0ZWQiOnRydWUsInByZXBhZ28iOmZhbHNlLCJsb2dpc3RpY2FfaW52ZXJzYSI6dHJ1ZSwiZGVmYXVsdF9mb3JtYXQiOiJwZGYiLCJ1c2VyX3R5cGUiOiJDbGllbnQiLCJpYXQiOjE3MTc1NDkxNTYsImV4cCI6MTcxNzU1Mjc1Nn0.lt15GptNFfG8VZU4aW0qolf1fn_M1EBnqigIUdEdCpdocxXrBQVhTWDzvNlnkNvlMZE2DZtB63kTb0seJ84JOAVi8tV32SRJsnR_D26CADxrZO5F6YkXHYHuwGmcyz9po6MriI2szofyiHtklGQa9tuHY-nSadQFtcHtUKaN_M6jC5ZqM96nvE-KLjdZFYjY78KEpPgKg5Mx725jHKcHhEs894jv-N8XsobMA6KwXAXf6oiFNC8n996OcHXdq9_yj0Vc_TuK0Y2FIIE-EkshwUzn-RBBx3_RfWr5aSS_yeF8VEne4LUKH3A1wYd29UWkb9To2t5XlwKCXS-MXEOR7k1Cjg8gZRqvpErPRaIFNzGrmfOmt5lwFZRKgCdo6cTWokIEb4PUVz6llQeAgsQ-7FILGgSeH0MphQxiubfwz6v9j1aMUyLSD3Lfv-7Mdmr8d4tFB--ECjt0IC9SfXrWcHaPRIL3XA8snR2_IO05eCSEqIIqHfrzu9JoWc8X7TrjQuZiAwVT5OhqJgXVe4HdgQDhdzHDsgpjcuNOmGhDGcu-dQPHDqN4JbvUjniO4wt7hmfY0VOCwEXNxGNRm9yaZS77QuzbLAed-LaEQq3nuZKCFbPs0hsZXCQyl2HP8h5K4f5B0zOxBLQT7CuWyo7bE6F9Y0Us_Pt9JU5JDCpegBU' \
--header 'Cookie: SERVERID=api_iflow21_n2' \
--data-raw '{
  "order_id": "Nro de pedido",
  "delivery_mode": 1,
  "shipments": [
    {
      "items_value": 100.25,
      "width": 10,
      "height": 10,
      "length": 10,
      "weight": 2,
      "items": [
        {
          "item": "Artículo Descripción",
          "sku": "ABC123",
          "quantity": "1"
        }
      ]
    },
    {
      "items_value": 200.55,
      "width": 20,
      "height": 20,
      "length": 10,
      "weight": 4,
      "items": [
        {
          "item": "Artículo 2 Descripción",
          "sku": "ABC123",
          "quantity": "1"
        }
      ]
    }
  ],
  "receiver": {
    "first_name": "Angelino",
    "last_name": "Cubrepileta",
    "receiver_name": "Angelino",
    "receiver_phone": "1112345678",
    "email": "[e-mail]",
    "document": "12345678",
    "address": {
      "street_name": "Av Rivadavia",
      "street_number": "13800",
      "between_1": "Calle A",
      "between_2": "Calle B",
      "floor": "5°A",
      "other_info": "Casa Amarilla",
      "zip_code": "1704",
      "city": "Ramos Mejía",
      "neighborhood_name": "Barrio",
      "state": "BUENOS AIRES"
    }
  }
}'

Response

🟢 200

{
  "code": 201,
  "success": true,
  "message": "Se ha creado con éxito la Orden #Nro de pedido",
  "results": {
    "tracking_id": "OR0000000123",
    "order_id": "Nro de pedido",
    "carrier_order_id": "-",
    "shippings": [
      {
        "order_id": "Nro de pedido",
        "shipment_id": "ABC0000002310984",
        "carrier_shipment_id": "-",
        "print_url": "http://api.iflow21.com/api/v1/public/shipping/print/22847825/ABC0000002310984.pdf"
      }
    ]
  }
}

🟡400 (Dimensiones Invalidas)

{
    "code": 400,
    "success": false,
    "message": "Parámetros incorrectos.",
    "errors": {
        "shipments[0].width": "Este valor debe ser mayor o igual a 1.",
        "shipments[0].height": "Este valor debe ser mayor o igual a 1.",
        "shipments[0].length": "Este valor debe ser mayor o igual a 1.",
        "shipments[0].weight": "Este valor debe ser mayor o igual a 1."
    }
}

🟡400 (CP Invalido)

{
    "code": 400,
    "success": false,
    "message": "Parámetros incorrectos.",
    "errors": {
        "receiver.address.zip_code": "El codigo postal (zip_code) ingresado no es válido."
    }
}

🟡400 (Provincia Invalida)

{
    "code": 400,
    "success": false,
    "message": "Parámetros incorrectos.",
    "errors": {
        "receiver.address.state": "La Provincia ingresada no es válida."
    }
}

🟡401 (Token Expirado)

{
    "code": 401,
    "message": "Expired JWT Token"
}

Crear una nueva orden con etiqueta propia

Para utilizar tus propias etiquetas, deberás seguir estos pasos e incluir en las mismas la siguiente información:

1. Crear una nueva orden e incluir en tu etiqueta los siguientes elementos obtenidos en el response:

   • shipment_id (Código de barras)

   • shipment_id (texto)

Cancelar una orden

En caso de ser necesario, puedes cancelar una orden de envío utilizando este endpoint. Ten en cuenta que las órdenes no pueden ser canceladas luego de que las hayamos colectado.

PUT /v1/client/order/{{tracking_id}}/cancel

Ejemplo

Solicitud

```powershell
curl --location --request PUT 'https://mpe.iflow21.com/api/v1/client/order/OR0000000123/cancel' \
--header 'Content-Type: application/json' \
--header 'Authorization: ••••••' \
--header 'Cookie: SERVERID=api_iflow21_n2' \
--data '{}'
```

Response

🟢 200

{
  "code": 200,
  "message": "La orden ha sido cancelada.",
  "count": 1,
  "results": {
    "id": 22592847,
    "order_id": "Nro de pedido",
    "date": "04/06/2024",
    "date_time": "04/06/2024 22:08:13",
    "order_date": "04/06/2024",
    "order_date_time": "04/06/2024 22:08:13",
    "pacted_date": null,
    "delivery_shift": null,
    "delivery_shift_description": null,
    "sender": {
      "id": 1037,
      "user_id": "T59b558dead916",
      "nickname": "usuariocliente",
      "first_name": "cliente",
      "last_name": "test",
      "email": "[e-mail]",
      "corporate_name": null
    },
    "receiver": "Angelino",
    "order_state": {
      "id": 1,
      "name": "Pedido Registrado",
      "descripcion": "Tu pedido está siendo preparado por el vendedor"
    },
    "order_state_history": [
      {
        "id": 4023378,
        "order_state": {
          "id": 1,
          "name": "Pedido Registrado",
          "descripcion": "Tu pedido está siendo preparado por el vendedor"
        },
        "createdAt": {
          "date": "2024-06-04 22:08:13.000000",
          "timezone_type": 3,
          "timezone": "America/Argentina/San_Luis"
        },
        "fromDate": {
          "date": "2024-06-04 22:08:13.000000",
          "timezone_type": 3,
          "timezone": "America/Argentina/San_Luis"
        },
        "toDate": null
      }
    ],
    "shippings": [
      {
        "id": 22847825,
        "order_id": "Nro de pedido",
        "shipment_id": "CLT0000000000123",
        "tracking_id": "OR0000000123",
        "state": "Cancelado",
        "state_class": "danger",
        "items": [
          {
            "id": 15103629,
            "item": "Artículo Descripción",
            "sku": "ABC123",
            "quantity": 1,
            "weight": null,
            "length": null,
            "height": null,
            "width": null,
            "value": null
          }
        ],
        "sender": {
          "id": 1037,
          "user_id": "T59b558dead916",
          "nickname": "usuariocliente",
          "first_name": "cliente",
          "last_name": "test",
          "email": "[e-mail]",
          "corporate_name": null
        },
        "receiver": {
          "id": 22481861,
          "user_id": null,
          "nickname": null,
          "first_name": "Angelino",
          "last_name": "Cubrepileta",
          "receiver_name": "Angelino",
          "receiver_phone": "1112345678",
          "email": "[e-mail]",
          "company": null,
          "agency": null,
          "address_street_name": "Av Rivadavia",
          "address_street_number": "13800",
          "address_other_info": "Casa Amarilla",
          "address_neighborhood_name": "Barrio",
          "address_zip_code": "1704",
          "address_city": "Ramos Mejía",
          "address_state": "BUENOS AIRES",
          "address_country": "Argentina",
          "address_floor": "5°A",
          "address_apartment": null,
          "address_between_1": "Calle A",
          "address_between_2": "Calle B",
          "address_latitude": "-34.63329900",
          "address_longitude": "-58.56669800"
        },
        "date": "04/06/2024",
        "order_date": "04/06/2024 22:08",
        "value": "100.20",
        "delivery_shift": null,
        "delivery_shift_description": null,
        "shipping_cost": "2608.98",
        "estimated_delivery_date": "14/06/2024",
        "estimated_delivery_date_min": null,
        "estimated_delivery_date_max": null,
        "channel": "iflow",
        "mode": null,
        "modes": [
          {
            "id": 1,
            "name": "Colecta",
            "description": "Retiros que se hacen desde la dirección de Origen del paquete, hasta una Planta."
          },
          {
            "id": 2,
            "name": "Reparto",
            "description": "Envíos que se hacen desde una Planta, hasta la dirección de Destino del paquete."
          }
        ],
        "created_by": "usuariocliente",
        "created_at": "04/06/2024 22:08:13",
        "updated_by": "usuariocliente",
        "updated_at": "05/06/2024 09:27:57",
        "registered": "04/06/2024 22:08:13",
        "processed": "04/06/2024 22:08:14",
        "planned": "",
        "pickedup": "",
        "notified": "",
        "discharged": "",
        "ready": "",
        "dispatched": "",
        "delivered": "",
        "not_delivered": "",
        "cancelled": true,
        "printable": false,
        "printed_by_client": false,
        "height": 10,
        "width": 10,
        "weight": 2,
        "length": 10,
        "volume": 1000,
        "sender_address": {
          "id": 149906,
          "sender": {
            "id": 1037,
            "user_id": "T59b558dead916",
            "nickname": "usuariocliente",
            "first_name": "cliente",
            "last_name": "test",
            "email": "[e-mail]",
            "corporate_name": null
          },
          "street_name": "frty",
          "street_number": "144",
          "floor": null,
          "apartment": null,
          "other_info": "sdreft",
          "neighborhood_name": "dre",
          "zip_code": "1663",
          "state": "BUENOS AIRES",
          "city": "San Miguel",
          "alias": "usuariocliente",
          "active": true
        },
        "delivery_mode": "Puerta a Puerta",
        "pickup_point_code": "",
        "carrier_external_name": "",
        "shipping_service": null,
        "type": null,
        "items_quantity": 1
      }
    ],
    "shippings_text": "CLT0000000000123<br/>",
    "tracking_id": "OR0000000123",
    "type": null,
    "cancelled": true,
    "printable": false,
    "payable": false,
    "can_generate_merchant_order": false,
    "is_payed": null,
    "rate_value": "2608.98",
    "init_point": null,
    "delivery_mode": "Puerta a Puerta",
    "pickup_point_code": "",
    "merchant_order": null,
    "order_classification": {
      "id": 1,
      "name": "Orden Normal",
      "code": "default"
    }
  }
}

Consultar estados de los envíos

En esta sección, detallamos cómo puedes utilizar nuestra API para consultar el estado de los envíos creados:

Este endpoint te permite consultar el estado actual de un envío utilizando su identificador único {{tracking_id}}. Podrás obtener información detallada sobre el progreso del envío, incluyendo su estado actual, fechas estimadas de entrega y cualquier evento relevante asociado con el envío.

GET /order/state/tracking_id}}

Ejemplo

Solicitud

curl --location 'https://mpe.iflow21.com/api/order/state/OR0000000123?=' \
--header 'Authorization: Bearer {{token}}'

Response

🟢 200

{
  "code": 200,
  "message": "OK",
  "count": 1,
  "results": {
    "tracking_id": "OR0000000123",
    "shippings": [
      {
        "shipment_id": "ABC0000000000123",
        "state": {
          "state_name": "Entregado",
          "state_id": 25,
          "details": "¡Entregamos tu pedido! ¡Que lo disfrutes!",
          "state_date": "15/01/2024 17:49",
          "reason": []
        },
        "states": [
          {
            "state_name": "Registrado",
            "state_id": 1,
            "details": "Tu pedido está siendo preparado por el vendedor",
            "state_date": "15/01/2024 17:36",
            "reason": []
          },
          {
            "state_name": "Retirado",
            "state_id": 8,
            "details": "Ya retiramos tu pedido y se encuentra camino a nuestro centro de distribución",
            "state_date": "15/01/2024 17:41",
            "reason": []
          },
          {
            "state_name": "Descargado",
            "state_id": 10,
            "details": "Tu pedido llegó a nuestro centro de distribución",
            "state_date": "15/01/2024 17:45",
            "reason": []
          },
          {
            "state_name": "Pedido en Distribución",
            "state_id": 35,
            "details": "Tu pedido se encuentra en distribución y hoy te estaremos visitando!",
            "state_date": "15/01/2024 17:47",
            "reason": []
          },
          {
            "state_name": "Entregado",
            "state_id": 25,
            "details": "¡Entregamos tu pedido! ¡Que lo disfrutes!",
            "state_date": "15/01/2024 17:49",
            "reason": []
          }
        ]
      }
    ]
  }
}

🟡401 (Token Expirado)

{
    "code": 401,
    "message": "Expired JWT Token"
}

🟡 403 (No Autorizado)

{
    "code": 403,
    "message": "Unauthorized access!",
    "count": 1,
    "results": false
}