For ShipStation API accounts based in France, you have immediate access to Chronopost, Colis Privé, Colissimo, and Mondial Relay shipping labels with ShipStation API Carriers. There’s no need to create and connect individual carrier accounts. Activate ShipStation API Carriers by adding the billing method you wish to use to purchase your labels and add funds to your ShipStation API Balance.
-
Activate ShipStation API Carriers in your ShipStation API Account (steps included in the following section)
-
Add funds to your ShipStation API Balance
You can add funds using ShipStation API’s add_funds endpoint, which must first be enabled by the ShipStation API Support team. If you'd like to add funds via this endpoint, please submit a request to our support team.
To start using ShipStation API Carriers, you must activate it by adding the payment method you wish to use for your labels. Log in to ShipStation API and do the following:
You will now see your available carriers under Setup > Carriers, where you can also find their unique Carrier IDs. You can also make a List Carriers call to view all of your Carrier IDs and available services.
Be sure to also add funds to your ShipStation API Balance so you can start purchasing your labels!
Connecting Your Own Carrier Accounts
You can also connect your own carrier accounts through the My Carrier Accounts section of the Carriers settings page.
ShipStation API Carriers France supports the following standard features:
|
Feature |
Chronopost from ShipStation API |
Colis Privé Store from ShipStation API |
Colissimo from ShipStation API |
Mondial Relay Dual Carrier by ShipStation API |
|---|---|---|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Multi-package Shipping* |
|
|
|
|
|
|
|
|
|
Click to view the available services for ShipStation API Carriers.
Chronopost from ShipStation API Domestic Services
|
Service Name |
API Code |
Carrier Code |
Service Type |
|---|---|---|---|
|
Shop2shop |
|
<productCode> '5E' + <service> '6' + <as> 'A15' |
Shop2shop |
|
Chrono 13 Relais |
|
|
Shop2shop |
|
Chrono13 |
|
|
Shop2Home |
|
Chrono18 |
chrono_18 |
|
Shop2Home |
|
2SHOP Direct |
2shop_direct |
None |
Home2shop |
Chronopost from ShipStation API International Services
|
Service Name |
API Code |
Carrier Code |
Service Type |
|---|---|---|---|
|
Chrono Classic |
|
|
Shop2Home |
|
Chrono Express |
|
<productCode> '17' + <service> '0' + <as> '' |
Shop2Home |
|
Chrono Relais EU |
|
<productCode> '5X' + <service> '6' + <as> '' |
Shop2shop |
|
2SHOP EU |
|
|
Shop2shop |
Chronopost from ShipStation API Package Types
-
Votre emballage:
votre_emballage
Chronopost from ShipStation API Confirmation Types
-
Signature:
"confirmation": "signature"
The Chronopost from ShipStation API integration allows for the following additional features:
|
Feature |
Description |
|---|---|
|
Label Messages |
reference1 = reference2 = |
|
Customs Forms |
|
|
End of Day Forms / Manifests |
Supported, but not required. Available in PDF only. |
|
Tracking Details |
2 letters + 9 numbers + 2 letters (ex: XX123456789FR) or 15 characters for packages coming from abroad. |
|
Saturday Delivery |
Available in See the Advanced Options page in our ShipStation API developer docs for details. |
|
Re-route a Parcel |
The surcharge is 9€ to re-route a parcel. If the parcel is not yet in transit, we can change the delivery address. If the parcel is already in transit, we cannot change the delivery address. You can choose instead to not deliver the parcel and have it go to a Chronopost relay point. |
|
PUDO (Pickup/Dropoff) |
If requesting PUDO/servicePoint delivery on a shipment, and you need the PUDO instructions to be returned with the label, this will not be returned automatically. You must specify "label_layout": "letter" in the label request outside of the shipment object when you create a shipping label. Here's an example of a valid PUDO label request: {
"ship_to_service_point_id": "2997V",
"label_layout": "letter",
"shipment": {
"carrier_id": "{{MyCID_ChronoTEST}}",
"service_code": "chrono_shop2shop",
"ship_to": {
"name": "Auctane TestT",
"address_line1": "153, Ancienne ligne ferroviaire de Vervins à Liart",
"city_locality": "Harcigny",
"postal_code": "02140",
"country_code": "FR",
"phone": "0750863269",
"email": "ian.green@auctane.com"
},
"ship_from": {
"name": "Auctane TestF",
"phone": "0605020304",
"address_line1": "168, CHEMIN RURAL",
"city_locality": "LONGEVILLE-EN-BARROIS",
"postal_code": "55000",
"country_code": "FR",
"email": "ian.green@auctane.com"
},
"customs": {
"contents": "merchandise",
"non_delivery": "return_to_sender",
"customs_items": [
{
"description": "stuff",
"quantity": 1,
"value": {
"amount": 10,
"currency": "eur"
}
}
]
},
"confirmation": "signature",
"packages": [
{
"weight": {
"value": 800,
"unit": "gram"
},
}
]
}
}
|
-
The Chronopost from ShipStation API integration does not support third-party billing.
-
Customs info will print on the label, so the forms cannot be printed separately.
-
End of Day Forms / Manifests: PDF only, electronic EOD submission is unavailable at this time.
-
Pickup (Collection from Home) scheduling is not available via this integration. Please arrange a PICK UP solution with your Chronopost Account Manager.
-
Pickup (Collection from Home) cancellation is not available via this integration.
-
8.5x11 label size: Borders on the label may be cut off, but all essential data should be visible.
ShipStation API manages all loss or damage claims for shipments sent with Chronopost from ShipStation API.
File a Claim
To file a claim for a lost or damaged shipment you will need to contact the ShipStation APIsupport team with the following information:
-
Cost of goods invoice and/or a Denial of receipt
-
Photo(s) of the damage (for damaged parcels)
Claims Requirements
-
Domestic: Claims must be filed within 3 days after delivery
International: Claims must be filed within 21 days after delivery
Here are some common issues, potential causes, and troubleshooting tips.
|
Issue |
How to Troubleshoot or Resolve |
|---|---|
|
Error Message: Void warning: Cette etiquiette n’est pas encore annulable, veuillex reessayer dans un inst…. |
What it means: May occur if you try to void a label too soon after label creation. It can take Chronopost up to an hour to update and allow a label to be voided. What to do: Wait an hour and try to void the label again. |
Colis Privé Store Domestic Services:
|
Service Name |
API Code |
Service Type |
|---|---|---|
|
Home Delivery |
|
Shop2Home |
|
PUDO Delivery |
|
Shop2Shop |
Colis Privé Store Package Types
-
Package:
colis_prive_store_package_wallet
-
The ShipStation API integration with Colis Privé Store from ShipStation API does not support third-party billing.
-
Scheduled Pickups are not supported.
-
Pick-up Cancellation is not supported.
-
Colis Privé Store from ShipStation API does not support shipping Dangerous Goods.
-
Multi-package shipping is not supported.
-
Avoid Missing Manifest Penalties: Every shipment must include a printed label and correct documentation. Colis Privé applies surcharges for administrative discrepancies, including missing or unvalidated manifests. These fees occur when parcels are dropped off before the dispatch list is officially validated in the Colis Privé Store system.
-
Maximum Weight: Packages cannot exceed 20 kg (20000 grams).
-
Largest Dimension: The largest dimension (height, length, or width) cannot exceed 100 cm.
-
Maximum Length + Width + Height: The sum of length + width + height cannot exceed 150 cm.
Colissimo from ShipStation API Domestic Services
|
Service Name |
API Code |
Carrier Code |
Service Type |
|---|---|---|---|
|
Domicile (France) sans signature |
|
DOM |
Shop2Home |
|
Domicile (France) avec signature |
|
DOS |
Shop2Home |
|
Retour France |
|
CORE |
Shop2Home |
|
Point Retrait – en Bureau de Poste |
|
HD |
Shop2Shop |
Colissimo from ShipStation API International Services
|
Service Name |
API Code |
Carrier Code |
Service Type |
|---|---|---|---|
|
Domicile (Territoires Français) sans signature |
|
COM |
Shop2Home |
|
Domicile (Territoires Français) avec signature |
|
CDS |
Shop2Home |
|
Domicile (Europe) avec signature |
|
DOS |
Shop2Home |
|
Domicile (Europe) sans signature |
|
DOM |
Shop2Home |
|
Point Retrait – en Bureau de Poste |
|
HD |
Shop2Shop |
|
Retour International |
|
CORI |
Shop2Home |
Colissimo from ShipStation API Package Types
-
Votre emballage:
colissimo_walleted_votre_emballage
Colissimo from ShipStation API Confirmation Types
-
Signature on Delivery: Colissimo Enterprise supports signature on delivery through service selection “avec signature” (with signature).
The Colisimo from ShipStation API integration allows for the following additional features:
|
Feature |
Desription |
|---|---|
|
Insurance |
€150, €300, €500, €1,000, €2,000, and €5,000. Insurance must be in EUR currency only, and the The insurance value is validated against the allowed tiers and converted to cents before being sent to the Colissimo API. Insurance is available for all services with no service-specific restrictions. |
|
Signature on Delivery |
To ensure secure delivery, Colissimo Enterprise offers signature-on-delivery options through the selection of the "avec signature" (with signature) service. |
-
API Code:
colissimo_walleted -
The Colissimo from ShipStation API integration does not support third-party billing.
-
The Colissimo from ShipStation API integration does not support shipping dangerous goods.
-
Max Weight/Dimensions:
-
Pickup / Dropoff (PUDO) Allocation:
-
A 6-character maximum
service_point_idis required. -
A mobile number is strictly mandatory and must follow specific formats (e.g., starting with 0, 33, or +33 followed by 8 digits).
-
-
Time-frame to File Claims:
-
Lost Parcel: Claims must be filed within 70 calendar days from the date the label was purchased/shipment created. Colissimo typically considers a domestic parcel lost if there has been no tracking movement for 6 business days (international can be longer, up to 30 days depending on the destination).
-
Damaged Items: Claims for visible damage must be reported within a tight window: 3 calendar days from the date of delivery.
-
-
Required Documentation for Lost Claims: For Colissimo Enterprise lost parcel claims, the required documentation primarily includes proof of deposit, a commercial invoice to verify the value of the goods, and a signed statement of non-receipt from the recipient.
-
Required documentation for Damaged Claims: To file a damaged goods claim with Colissimo Entreprise, you must provide specific documentation, including photos of the damage (both item and packaging) and a proof of value such as a commercial invoice. Repair estimates may also be required in certain cases.
-
Non-machineable: Enable this option to identify parcels requiring manual handling; note that this feature is not available for PUDO services, and other standard options such as Saturday Delivery, COD, or Alcohol shipments are not supported.
-
Drop-off: Shippers must use the LaPoste Localiser un point de contact La Poste website to identify a suitable drop-off location.
-
Delivery Confirmation:
-
Proof of Age Required: Not Supported
-
Proof of Delivery: Not Supported
-
Mondial Relay Dual Carrier by ShipStaton is an integration that provides access to Mondial Relay delivery services in France through the ShipStation API. Mondial Relay specializes in out-of-home delivery through pickup points and parcel lockers.
|
Service Name |
API Code |
Delivery Type |
International |
|---|---|---|---|
|
Relay Point Delivery (24R) |
|
Service Point (PUDO) |
|
|
Home Delivery |
|
Home |
|
|
Relay Point Delivery (Domestic Only) |
|
Service Point (PUDO) |
|
|
Package Name |
API Code |
Coverage |
|---|---|---|
|
Package |
|
Domestic & International |
The following features are supported when using Mondial Relay Dual Carrier through the ShipStation API:
-
Shipping to service points (pickup locations)
-
Mondial Relay deliveries are typically made to Point Relais® pickup locations, though some services support home delivery from pickup points.
-
