Cotizar envio

Esta guía te permite consultar las tarifas de envío utilizando el API de DrEnvio. Incluye información sobre los distintos entornos disponibles, la lista de transportistas compatibles, los parámetros de solicitud, la estructura de la respuesta y más.

Entornos

La API de DrEnvio soporta dos entornos: Producción y Sandbox.

Entorno de Producción: El entorno de producción es donde se procesan los envíos reales. Para utilizar el API de producción, envía tus solicitudes a la siguiente URL:

    https://prod.api-drenvio.com/v2/shipments/rate

Entorno de Sandbox: El entorno de sandbox se utiliza con fines de prueba. Proporciona datos simulados para ayudarte a desarrollar y probar tu integración antes de pasar a producción. Para utilizar el API de sandbox, envía tus solicitudes a la siguiente URL:

    https://sandbox.api-drenvio.com/v2/shipments/rate

Transportistas Disponibles

Los transportistas disponibles para cotizar dependen de dos factores: el país de origen (MX o CO) y el tipo de envío (National o International). Asegúrate de incluir únicamente los transportistas válidos para tu combinación — los transportistas no válidos serán ignorados o retornarán un error.

Nota: En el entorno sandbox, las únicas paqueterías disponibles para cotizar son JTExpress y Quiken.

---

México (MX) — Envíos Nacionales

Usa estos transportistas cuando origin.country = "MX" y type = "National":

[
  "noventa9Minutos", "aExpress", "ampm", "carssa", "coordinadora",
  "dhl", "estafeta", "fedex", "ivoy", "mensajerosUrbanos",
  "paquetexpress", "quiken", "redpack", "scm", "sendex",
  "tracusa", "uber", "ups", "vencedor", "jtexpress",
  "entrega", "borzo", "tresguerras", "treggo", "pickit",
  "test", "imile", "afimex", "ptx"
]

---

México (MX) — Envíos Internacionales

Usa estos transportistas cuando origin.country = "MX" y type = "International":

["dhl", "fedex", "ups", "estafeta"]

---

Colombia (CO) — Envíos Nacionales

Usa estos transportistas cuando origin.country = "CO" y type = "National":

[
  "fedex", "interrapidisimo", "redServi", "serviEntrega",
  "mensajerosUrbanos", "noventa9Minutos", "dhl", "coordinadora",
  "moova", "deprisa", "picap", "tcc", "envia"
]

---

Colombia (CO) — Envíos Internacionales

Usa estos transportistas cuando origin.country = "CO" y type = "International":

["dhl", "fedex"]

---

Resumen de cobertura por transportista

Origen	Tipo de envío	Transportistas disponibles
MX	Nacional	noventa9Minutos, aExpress, ampm, carssa, coordinadora, dhl, estafeta, fedex, ivoy, mensajerosUrbanos, paquetexpress, quiken, redpack, scm, sendex, tracusa, uber, ups, vencedor, jtexpress, entrega, borzo, tresguerras, treggo, pickit, test, imile, afimex, ptx
MX	Internacional	dhl, fedex, ups, estafeta
CO	Nacional	fedex, interrapidisimo, redServi, serviEntrega, mensajerosUrbanos, noventa9Minutos, dhl, coordinadora, moova, deprisa, picap, tcc, envia
CO	Internacional	dhl, fedex

---

API request

Para obtener una cotización para un envío, envía una solicitud POST a la API con el siguiente body JSON:

{
  "type": "National",
  "origin": {
    "country": "MX",
    "postal_code": "64000"
  },
  "destination": {
    "country": "MX",
    "postal_code": "64380"
  },
  "packages": [
    {
      "weight": 1,
      "height": 10,
      "width": 10,
      "length": 10,
      "volumetric": 0.2,
      "type": "box",
      "main_weight": 1
    }
  ],
  "carriers": ["fedex", "estafeta", "ampm", "dhl"],
  "insurance": 0
}

Descripción de los campos

Campo	Descripción	Tipo	Requerido
type	Tipo de envío	Enum: National, International	true
origin	Información de origen para la dirección del envío	Object AddressObject	true
destination	Información de destino para la dirección del envío	Object AddressObject	true
packages	Arreglo de paquetes	Array PackageObject	true
insurance	El seguro del envío, si está asegurado, la respuesta contendrá el monto del seguro. MXN si es envío nacional, si no en USD.	number	true
carriers	Un array con los transportistas que deseas cotizar. Los válidos dependen del origin.country y el type del envío. Consulta la sección Transportistas Disponibles.	Array de strings	true

Dirección (Object)

Campo	Descripción	Tipo	Requerido
country	Código de país de 2 dígitos para cada dirección. El origen debe ser MX o CO, y el destino puede ser cualquier país.	string	true
postalCode	Código Postal para las direcciones de origen y destino.	string	true
city	Nombre de la ciudad de la dirección.	string	false
district	Distrito o colonia de la dirección.	string	false

Paquete (Object)

Campo	Descripción	Tipo	Requerido
weight	El peso del paquete en kilogramos (KG).	number	true
height	La altura del paquete en centímetros (CM).	number	true
width	El ancho del paquete en centímetros (CM).	number	true
length	La longitud del paquete en centímetros (CM).	number	true
volumetric	El peso volumétrico del envío, típicamente calculado en base a las dimensiones.	number	false
type	El tipo de paquete.	Enum: box, envelope, pallet	true
insurance	El seguro del envío, si está asegurado, la respuesta contendrá el monto del seguro. MXN si es envío nacional, si no en USD.	number	false

API response

[
  {
    "ObjectId": null,
    "ShippingId": "G1",
    "carrier": "fedex",
    "service_id": "fedex_mx_D-C03_ground",
    "service": "ground",
    "price": 120,
    "days": "3 a 5 días",
    "insurance": 0,
    "currency": "MXN",
    "metadata": {
      "extended_area": {
        "extended_area": false,
        "origin": false,
        "destination": false
      }
    }
  },
  {
    "ObjectId": null,
    "ShippingId": "G1",
    "carrier": "fedex",
    "service_id": "fedex_mx_P-C00_ground",
    "service": "ground",
    "price": 94.55,
    "days": "3 a 5 días",
    "insurance": 0,
    "currency": "MXN",
    "metadata": {
      "account_id": "648a19d789be2a38ae8eb0d2",
      "account_price": 1,
      "extended_area": {
        "extended_area": false,
        "origin": false,
        "destination": false
      }
    }
  },
  {
    "ObjectId": null,
    "ShippingId": "G1",
    "carrier": "fedex",
    "service_id": "fedex_mx_D-C03_express",
    "service": "express",
    "price": 145,
    "days": "1 a 2 días",
    "insurance": 0,
    "currency": "MXN",
    "metadata": {
      "extended_area": {
        "extended_area": false,
        "origin": false,
        "destination": false
      }
    }
  },
  {
    "ObjectId": null,
    "ShippingId": "G1",
    "carrier": "fedex",
    "service_id": "fedex_mx_P-C00_express",
    "service": "express",
    "price": 86.52,
    "days": "1 a 2 días",
    "insurance": 0,
    "currency": "MXN",
    "metadata": {
      "account_id": "648a19d789be2a38ae8eb0d2",
      "account_price": 1,
      "extended_area": {
        "extended_area": false,
        "origin": false,
        "destination": false
      }
    }
  },
  {
    "ObjectId": "T0",
    "ShippingId": "N6",
    "carrier": "estafeta",
    "service": "metropolitano",
    "currency": "MXN",
    "price": 68,
    "insurance": 0,
    "service_id": "estafeta_mx_D-C03_metropolitano",
    "days": "2 días",
    "metadata": {
      "extended_area": {
        "extended_area": false,
        "origin": false,
        "destination": false
      },
      "ocurre": false
    }
  },
  {
    "ObjectId": "78",
    "ShippingId": "N6",
    "carrier": "estafeta",
    "service": "ground",
    "currency": "MXN",
    "price": 120,
    "insurance": 0,
    "service_id": "estafeta_mx_D-C03_terrestre",
    "days": "5 días",
    "metadata": {
      "extended_area": {
        "extended_area": false,
        "origin": false,
        "destination": false
      },
      "ocurre": false
    }
  },
  {
    "ObjectId": "D8",
    "ShippingId": "N6",
    "carrier": "estafeta",
    "service": "2_days",
    "currency": "MXN",
    "price": 134,
    "insurance": 0,
    "service_id": "estafeta_mx_D-C03_2dias",
    "days": "2 días",
    "metadata": {
      "extended_area": {
        "extended_area": false,
        "origin": false,
        "destination": false
      },
      "ocurre": false
    }
  },
  {
    "ObjectId": "60",
    "ShippingId": "N6",
    "carrier": "estafeta",
    "service": "next_day",
    "currency": "MXN",
    "price": 135,
    "insurance": 0,
    "service_id": "estafeta_mx_D-C03_next_day",
    "days": "1 día",
    "metadata": {
      "extended_area": {
        "extended_area": false,
        "origin": false,
        "destination": false
      },
      "ocurre": false
    }
  },
  {
    "ShippingId": "E1",
    "ObjectId": "ECONOMY SELECT DOMESTIC",
    "carrier": "dhl",
    "service": "ground",
    "service_id": "dhl_mx_D-C01_ground",
    "insurance": 0,
    "currency": "MXN",
    "days": "1 a 2 días",
    "metadata": {
      "dhl": {
        "productCode": "G",
        "productName": "ECONOMY SELECT DOMESTIC"
      }
    },
    "price": 170
  },
  {
    "ShippingId": "E1",
    "ObjectId": "ECONOMY SELECT DOMESTIC",
    "carrier": "dhl",
    "service": "ground",
    "service_id": "dhl_mx_P-C00_ground",
    "insurance": 0,
    "currency": "MXN",
    "days": "1 a 2 días",
    "metadata": {
      "account_id": "648a1a9d89be2a38ae8eb21a",
      "account_price": 1,
      "dhl": {
        "productCode": "G",
        "productName": "ECONOMY SELECT DOMESTIC"
      }
    },
    "price": 138.14
  },
  {
    "ShippingId": "E1",
    "ObjectId": "EXPRESS DOMESTIC",
    "carrier": "dhl",
    "service": "express",
    "service_id": "dhl_mx_D-C01_express",
    "insurance": 0,
    "currency": "MXN",
    "days": "1 a 2 días",
    "metadata": {
      "dhl": {
        "productCode": "N",
        "productName": "EXPRESS DOMESTIC"
      }
    },
    "price": 175
  },
  {
    "ShippingId": "E1",
    "ObjectId": "EXPRESS DOMESTIC",
    "carrier": "dhl",
    "service": "express",
    "service_id": "dhl_mx_P-C00_express",
    "insurance": 0,
    "currency": "MXN",
    "days": "1 a 2 días",
    "metadata": {
      "account_id": "648a1a9d89be2a38ae8eb21a",
      "account_price": 1,
      "dhl": {
        "productCode": "N",
        "productName": "EXPRESS DOMESTIC"
      }
    },
    "price": 138.14
  },
  {
    "ObjectId": "next_day_guaranteed",
    "ShippingId": "N4",
    "carrier": "quiken",
    "service": "ground",
    "service_id": "quiken_mx_D-C01_ground",
    "price": 92,
    "currency": "MXN",
    "days": "Siguiente día",
    "extra": "Next Day Guaranteed",
    "metadata": {}
  },
  {
    "ObjectId": "local_express",
    "ShippingId": "N4",
    "carrier": "quiken",
    "service": "ground",
    "service_id": "quiken_mx_D-C01_ground36hrs",
    "price": 69,
    "currency": "MXN",
    "days": "36 horas",
    "extra": "Next Day - 36 hrs",
    "metadata": {}
  },
  {
    "ObjectId": null,
    "ShippingId": "E1",
    "carrier": "mensajerosUrbanos",
    "service": "ground",
    "service_id": "mensajerosUrbanos_mx_A-P01_ground",
    "insurance": 0,
    "price": 117.29,
    "currency": "MXN",
    "days": "2 horas",
    "metadata": {}
  }
]