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

DrEnvio actualmente soporta 17 transportistas, que puedes utilizar para obtener tarifas de envío para tus envíos.

Fedex
Sendex
DHL
UPS
Carssa
Ivoy
Scm
Quiken
Ampm
Estafeta
Paquetexpress
99minutos
Uber
Mensajeros Urbanos
JTExpress
Borzo

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

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 cada uno de los transportistas que desea calificar su envío. Las tarifas internacionales solo están disponibles con fedex, dhl, ups y estafeta.	Array de strings: AllCarriers	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 siempre debe ser `MX`, y el destino puede ser cualquier país.	`MX`	`CO` (o cualquier código de país)
`postalCode`	Código Postal para las direcciones de origen y destino.	`64000`	`64380` (o cualquier código postal válido)

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": {}
  }
]