# Paquetexpress credential requirements

Prior to shipping with Paquetexpress, you must configure credentials in the [Shipium Console](https://partner.shipium.com/login). You'll provide a username, type ID, bill client ID, and token. Test mode credentials are required.

Paquetexpress's service methods and their identifiers are listed on the [Supported Carriers](https://docs.shipium.com/docs/supported-carriers#paquetexpress) page.

# Additional requirements

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](https://docs.shipium.com/docs/multi-parcel-shipments), they should be included in `multiParcelShipmentParameters`.

## Required fields

| Request field | Details |
| --- | --- |
| `orderItemQuantities.productTaxCode` | **Type:** String<br>**Description:** The tax code that applies to the given product |
| `customsInfo.customsDescription` | **Type:** String<br>**Example:**`mercancia`<br>**Description:** 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 fields is included.

JSON

```json
{
    "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"
        }
    }
}
```