How to connect Geodis V2 to ShippyPro
In this article, you will learn how to connect Geodis V2 to ShippyPro and configure your domestic shipments within France.
Summary:
- Before you start
- Carrier's Configuration
- Additional features
- Troubleshooting & Errors
1. Before you start
Geodis V2 is the new REST integration for Geodis, covering domestic shipments within France.
To set up Geodis V2, you need to have an active Geodis account with API access. If you don't have API credentials yet, please contact your Geodis point of contact to request access.
Geodis issues two API keys per account, each used for a different purpose:
- WebService API Key: used to create shipments, close them out and cancel them
- Zoom API Key: used for tracking
2. Carrier's configuration
Follow these steps to connect Geodis V2 to your ShippyPro account:
- Log in to your ShippyPro account
- Navigate to Connections > Carriers
- Scroll down and click on the Geodis V2 logo
- A connection modal will appear. Fill in the required fields:
- WebService API Key: Enter your Geodis WebService API key
- Zoom API Key (Tracking): Enter your Geodis Zoom API key
- Login ID: Enter your Geodis login identifier (the same for both keys)
- Depot Code: Enter your Geodis depot/branch code
- Client Code: Enter your Geodis client code
- Service Type: Select MES - Messagerie France
- Label Type: Select PDF A6, Zebra 203 DPI, or Zebra 300 DPI
- Click Save to establish the connection
Optional Configuration:
- Test Mode: Enable this option if you want to use the test environment. Labels generated in test mode are simulated and are not valid for real shipments.
Congrats, now you're connected! It's time to start shipping with Geodis V2.
3. Additional features
Destinations
National: France only
International: Not available
Features
- Label Type: PDF (A6), ZPL (203 DPI, 300 DPI)
- Track & Trace: Available
- Paperless: Not Available
- PickUp/DropOff (PUDO): Not Available
- Cash On Delivery: Available
- Live Rates: Not Available
- Return Labels: Not Available
- Return Labels (in the box): Not Available
- Book/Schedule Pickup: Not Available
- Address Check: Not Available
- Proof Of Delivery (POD): Not Available
- Non-Delivery Options: Not Available
- Insurance: Available (declared value)
- Multiparcel: Available
- Delete Shipment (Void): Available
- Closeout: Available
- CN22: Not Available
- CN23: Not Available
- Credentials Validation: Partial (only the Zoom API Key is verified when you save the connection)
Service Types
- MES - Messagerie France: Domestic parcel and freight delivery within France
Multiparcel Shipments
Geodis V2 supports sending multiple parcels in a single shipment.
Cash on Delivery (COD)
Geodis V2 supports Cash on Delivery. The COD amount and currency will be applied automatically when present on the order.
Insurance
Geodis V2 supports insurance based on the declared value of your goods.
On-Demand Delivery
Shipments created with Geodis V2 use on-demand delivery by default.
Closeout
Geodis V2 supports closeout, allowing you to close your shipments directly from ShippyPro.
Label Formats
Geodis V2 supports the following label formats:
- PDF A6: Standard PDF label format
- Zebra 203 DPI: Thermal label format for 203 DPI printers
- Zebra 300 DPI: Thermal label format for 300 DPI printers
Make sure your label printer is compatible with your selected format.
Tracking
All Geodis V2 shipments can be tracked using the tracking number provided after shipment creation. Tracking information is available within ShippyPro.
4. Troubleshooting & Errors
Common Issues:
❓ Can I use Geodis V2 for international shipments?
A: No, Geodis V2 currently supports domestic shipments within France only. For international shipments, you'll need to use a different carrier.
❓ Geodis gave me two API keys. Which one goes where?
A: Enter the WebService API Key in the "WebService API Key" field — it is used to create, close out and cancel shipments. Enter the Zoom API Key in the "Zoom API Key (Tracking)" field — it is used for tracking.
❓ I can save the connection, but my shipments are failing. What should I check?
A: When you save the connection, ShippyPro verifies only the Zoom API Key (used for tracking). The WebService API Key is checked for the first time when you create a shipment. If the connection saves correctly but label creation fails, make sure that:
- The WebService API Key field contains the WebService key, not the Zoom key
- The Login ID, Depot Code and Client Code are correct
If you continue to experience issues, contact Geodis support for verification of your API access.
❓ My shipments are created correctly, but tracking is not updating. What should I check?
A: Make sure the Zoom API Key (Tracking) field contains the Zoom key provided by Geodis. If you left this field empty, ShippyPro uses the WebService API Key for tracking as well, which only works if Geodis issued you a single key.
❓ Why is my shipment failing with an address error?
A: Geodis limits name, company, address and city fields to 35 characters each. Make sure your values stay within this limit, as longer values may be rejected by the carrier.