Paquetexpress

Ensure you have provided required credentials to ship with Paquetexpress.

Paquetexpress credential requirements

Prior to shipping with Paquetexpress, you must configure credentials in the Shipium Console. You'll provide a username, type ID, bill client ID, and token. Test Mode credentials are required.

The following additional required fields for any label request should be nested in the shipmentParameters property for each product shipping via Paquetexpress. For multi-parcel shipments, they should be included in multiParcelShipmentParameters.

Reference fieldRequired/OptionalField propertiesDescription
orderItemQuantities .productTaxCodeRequiredStringThe tax code that applies to the given product
customsInfo .customsDescriptionRequiredString
Ex.: mercancia
The detailed description of the items being shipped; the default value is mercancia. Although there is a default value, as this is a strict requirement, providing the most accurate product description possible is recommended.

A sample JSON request for the API call with the required field is included.

{
    "currencyCode": "usd",
    "generateLabel": true,
    "labelParameters": {
        "currencyCode": "usd",
        "customLabelEntries": {},
        "includeLabelImagesInResponse": true,
        "labelFormats": [
            "zpl"
        ],
        "manifest": false
    },
    "carrierServiceMethodAllowList": [
        "paquetexpress-estandar-terrestre-service-method"
    ],
    "shipmentParameters": {
        "fulfillmentContext": "mx-test-tag",
        "shippedDateTime": "2024-01-03T21:00:00-21:00",
        "orderedDateTime": "2023-12-20T21:00:00-21:00",
        "referenceIdentifier": "1234567890",
        "purchaseOrderIdentifier": "1234567890",
        "testMode": true,
        "shipFromAddress": {
            "name": "Jane Jetson",
            "company": "THD",
            "addressLineComponents": {
                "district": "ALVARO OBREGON",
                "streetName": "AV CENTENARIO",
                "primaryAddressNumber": "929",
                "secondaryAddressNumber": "CASA 13",
                "neighborhood": "cOlonIa PUERTA GRANDE"
            },
            "city": "Alvaro Obregon",
            "region": "DFS",
            "postalCode": "01630",
            "countryCode": "MX",
            "phoneNumber": "123-456-7890",
            "emailAddress": "test1@gmail.com",
            "residential": true
        },
        "destinationAddress": {
            "name": "Test User",
            "phoneNumber": "9999999999",
            "emailAddress": "test@email.com",
            "street1": "4881 Col San Pedro Barrientos",
            "city": "Tlalnepantla",
            "state": "MEX",
            "countryCode": "MX",
            "postalCode": "54010",
            "addressType": "residential"
        },
        "orderItemQuantities": [
            {
                "productDetails": [],
                "productId": "12345678",
                "productTaxCode": "miCodigoParaTaxes",
                "quantity": 1,
                "hazmatInfo": {}
            }
        ],
        "customsInfo":  {
                "customsDescription": "mercancia",
       ...
     },
        "packagingType": {
            "packagingMaterial": "box",
            "packagingSizeName": "test-package",
            "packagingWeight": {
                "weight": 10,
                "weightUnit": "kg"
            },
            "linearDimensions": {
                "height": 30,
                "length": 30,
                "linearUnit": "cm",
                "width": 30
            }
        },
        "totalWeight": {
            "weight": 10,
            "weightUnit": "kg"
        }
    }
}

Resources

Your Shipium team member is available to help along the way. However, you might find these resources helpful: