Generación de guías Nacionales / Internacionales

URL API de Producción (Para Fedex y Redpack)

URL utilizada para la generación de envíos con Redpack y en el caso de Fedex, sólo cuando el ShippingId es G1.

https://api-clientes.vercel.app/v2/shipments/generate

URL API de Producción (resto de paqueterías)

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

Petición / Request

La mayoría de los proveedores aceptan hasta 50 caracteres en cada campo. Sin embargo, es importante tener en cuenta que cuando el ShippingId es N6, solo se permitirán 25 caracteres. Por favor, considere esta información al realizar un envío.

La referencia nunca debe estar vacía, si no se requiere este campo colocar NA o N/A pero nunca dejar vacío. Los proveedores cuyo service_id contengan el código A-P10 requieren al menos 3 caracteres en la referencia.

FieldDescriptionTypeRequired
originOrigin Address of shipmentObject AddressObjecttrue
destinationDestination address of the shipmentObject AddressObjecttrue
shipmentsshipment detailsObject ShipmentObjecttrue
packagespackagesArray PackagesObjecttrue
service_idId of the service selectedstringtrue
insuranceThe insurance of shipmentnumbertrue
carriersSelected carrier (Provided in the rate)Arraytrue

Address (Object)

El campo last_name solo se utiliza para envíos de 99Minutos que contengan el ShippingId en N11 y para todas las paqueterías que tengan el código A-P10 en el service_id.

Si se deja el campo como opcional, para los envíos con el código A-P10 se rellenará automáticamente con el campo company. Para todos los envíos que no cumplan con las condiciones mencionadas, el campo debe ser ignorado.

FieldDescriptionTypeRequired
nameName of the person making/receiving the shipment.stringtrue
last_nameLastName of the person making/receiving the shipment.stringfalse
companyCompany of the person making/receiving the shipment, if not provided will be NA.stringtrue
emailEmail of the person making/receiving the shipment.stringtrue
phonePhone number of the person making/receiving the shipment.stringtrue
streetStreet of the person making/receiving the shipment.stringtrue
numberNumber of building of the address.stringtrue
int_numberInterior Number of building of the address.stringfalse
districtDistrict of the address.stringtrue
cityCity of the address.stringtrue
countryAlways MX until next major update.stringtrue
referenceA reference to help find the address. if not provided will be NA.stringtrue
state2 digit state code of the address, those can be found here.stringtrue
postalCode5 digit postal code of the address.stringtrue

Packages (Object)

FieldDescriptionTypeRequired
widthWidth of the package in CM.numbertrue
heightHeight of the package in CM.numbertrue
lengthLength of the package in CM.numbertrue
weightWeight of the package in KG.numbertrue
typeThe type of the packageEnum: box envelope pallettrue
nameContent of the packagestringtrue
contentContent of the packagestringtrue
declared_valueDeclared Value of the packagenumbertrue
contentQuantityAmount of packagesnumbertrue

Shipment (Object)

El campo satContent es un código identificador del tipo de producto requerido en México por el SAT, se obtiene con el servicio de Consulta de código de productos del SAT.

Si no se utiliza el servicio mencionado, se puede colocar el código de paquete genérico en sun lugar (ejemplo: satContent: '31181701')

FieldDescriptionTypeRequired
carrierProvided in the ratestringtrue
ObjectIdProvided in the ratestringtrue
ShippingIdProvided in the ratestringtrue
serviceProvided in the ratestringtrue
priceProvided in the ratenumbertrue
contentExplanationAn explanation of the content of the shipment, must include fabrication materialsstringtrue
contentQuantityHow many items are in the boxnumbertrue
satContentProduct type identification code that you are sendingstringtrue

Petición / Request


{
  "origin": {
    "city": "Monterrey",
    "company": "SACR0 DESIGN",
    "country": "MX",
    "district": "MIRAVALLE",
    "email": "sample_sample@localhost",
    "int_number": "2",
    "name": "SAMPLE FULL NAME",
    "number": "282",
    "phone": "8683457800",
    "postal_code": "66250",
    "reference": "SAMPLE DISTRICT",
    "state": "NL",
    "street": "ANTONIO VIVALDI"
  },
  "destination": {
    "city": "Monterrey",
    "company": "PARROQUIA DE NUESTRA SEÑORA DE LA PIEDAD",
    "country": "MX",
    "district": "Piedad Narvarte",
    "email": "sample_sample@localhost",
    "name": "SAMPLE FULL NAME",
    "number": "320",
    "phone": "8683457800",
    "postal_code": "66260",
    "reference": "SAMPLE DISTRICT",
    "state": "NL",
    "street": "Obrero Mundial "
  },
  "shipment": {
    "carrier": "jtexpress",
    "contentExplanation": "EXAMPEL CONTENT",
    "contentQuantity": 1,
    "ObjectId": "code",
    "price": 133.4,
    "service": "ground",
    "ShippingId": "N4",
    "satContent": "31181701"
  },
  "insurance": 0,
  "packages": [
    {
      "content": "ORNAMENTOS O DECORACIONES",
      "contentQuantity": 1,
      "declared_value": 0,
      "height": 10,
      "weight": 1,
      "width": 10,
      "length": 10,
      "type": "box",
      "name": "Paquete enviado de pruebas",
      "volumetric": 0.2,
      "main_weight": 1
    }
  ],
  "service_id": "jtexpress_mx_D-C01_ground",
  "carriers": [
    "jtexpress"
  ]
}
              

Respuesta


{
  "shipment_status": "Activa",
  "pickups_status": "En espera",
  "_id": "649f036f8b74c6f35e052902",
  "user": "auth0|5f60f5e21e076c00797eee99",
  "origin": {
      "_id": "649f036e8b74c6f35e0528ff",
      "name": "SAMPLE FULL NAME",
      "company": "SACR0 DESIGN",
      "email": "sample_sample@localhost",
      "phone": "8683457800",
      "street": "ANTONIO VIVALDI",
      "number": "282",
      "int_number": "2",
      "district": "MIRAVALLE",
      "city": "Monterrey",
      "state": "NL",
      "country": "MX",
      "postal_code": "66250",
      "reference": "SAMPLE DISTRICT",
      "title": "SAMPLE FULL NAMEdireccion",
      "user": "auth0|5f60f5e21e076c00797eee99"
  },
  "destination": {
      "_id": "649f036e8b74c6f35e052900",
      "name": "SAMPLE FULL NAME",
      "company": "PARROQUIA DE NUESTRA SEÑORA DE LA PIEDAD",
      "email": "sample_sample@localhost",
      "phone": "8683457800",
      "street": "Obrero Mundial ",
      "number": "320",
      "int_number": "0",
      "district": "Piedad Narvarte",
      "city": "Monterrey",
      "state": "NL",
      "country": "MX",
      "postal_code": "66260",
      "reference": "SAMPLE DISTRICT",
      "title": "SAMPLE FULL NAMEdireccion",
      "user": "auth0|5f60f5e21e076c00797eee99"
  },
  "packages": [
      {
          "_id": "649f036e8b74c6f35e052901",
          "weight": 1,
          "height": 10,
          "width": 10,
          "length": 10,
          "declared_value": 0,
          "volumetric": 0.2,
          "type": "box",
          "content": "ORNAMENTOS O DECORACIONES",
          "name": "ORNAMENTOS O DECORACIONES",
          "main_weight": 1,
          "user": "auth0|5f60f5e21e076c00797eee99"
      }
  ],
  "label": "https://storage.googleapis.com/download/storage/v1/b/drenvio-8741f.appspot.com/o/jtexpress%2FUAT301007251337?
  generation=1688142703394521&alt=media",
  "shipping_id": "N4",
  "carrier": "jtexpress",
  "service": "ground",
  "service_id": "jtexpress_mx_D-C01_ground",
  "price": 133.4,
  "insurance": 0,
  "tracking": "UAT301007251337",
  "metadata": {
      "format": "PDF_4_6",
      "extended_area": false,
      "jtexpress": {
          "txlogisticId": "1688142698350"
      }
  },
  "created_at": "2023-06-30T16:31:43.681Z"
}