# OpenBorder credential requirements

Prior to shipping with OpenBorder, you must configure credentials in the [Shipium Console](https://partner.shipium.com/login). You'll provide a token ID and brand code for both production and test mode.

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

# Additional requirements

OpenBorder requires that you include either the product SKU number or the order number from OpenBorder in your API call. For single-parcel shipments, one of the following additional fields should be nested in the `shipmentParameters` property. For [multi-parcel shipments](https://docs.shipium.com/docs/multi-parcel-shipments), the field should be included in `multiParcelShipmentParameters`.

| Request field | Details |
| --- | --- |
| `orderItemQuantities.productId` | **Type:** String<br>**Example:**`123454321`<br>**Condition:** Required if not providing the `partnerOrderId`<br>**Description:** If you opt to provide the SKU number from your OpenBorder order, you will include it as the product ID value. |
| `orderItemQuantities.partnerOrderId` | **Type:** String<br>**Example:**`myCustomPartnerOrderId123`<br>**Condition:** Required if not providing the `productId`<br>**Description:** If you choose to provide the order number from your OpenBorder order, you will include it as the partner order ID value. |

A snippet of the JSON request for the API call with each field is included. Both examples are for a single-parcel shipment. The request field for a multi-parcel shipment would be included in `multiParcelShipmentParameters`.

This request snippet includes the product ID field.

JSON

```json
{
"shipmentParameters": {

"orderItemQuantities": [
    {
      "productId": "123454321",
... 
    }
]
}
}
```

This request snippet includes the partner order ID field.

JSON

```json
{
"shipmentParameters": {

"orderItemQuantities": [
    {
      "partnerOrderId": "myCustomPartnerOrderId123",
...
    }
]
}
}
```

# Resources

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

- [Terms and Definitions](https://docs.shipium.com/docs/common-terms)
- [Troubleshooting Guide](https://docs.shipium.com/docs/troubleshooting-guide)
- [Contact Shipium Support](https://docs.shipium.com/docs/contacting-shipium-support)