GLS Germany offers domestic and international shipping services for shipments throughout Germany and Europe.
This guide provides developers with the details needed to build GLS Germany ShipIt shipping capabilities into your ShipStation V2 API workflows.
| Property | Type | Required? | Description |
|---|---|---|---|
nickname | string | required | This is a nickname for you to identify the carrier account in ShipStation V2 API. |
client_id | string | required | Your GLS Developer Portal Client-ID. Customers need to register in the GLS Developer Portal, create their own app and enable the Authentication API and the ShipIT Farm API. |
client_secret | string | required | Your GLS Developer Portal Client-Secret. |
contact_id | string | required | Your GLS Contact-ID (shipper identifier as given by GLS). |
portal_username | string | Optional | PortalUser from GLS customer. Without this information, shipment tracking will not work. |
portal_password | string | Optional | Portal password from GLS customer. Without this information, shipment tracking will not work. |
customer_id | string | Optional | Your GLS customer number required to activate the webhook. Without this information, shipment tracking will not work. |
webhook_contact_id | string | Optional | Your GLS contact number required to activate the webhook. Without this information, shipment tracking will not work. |
You can connect a GLS Germany ShipIt account via the ShipStation dashboard.
For instructions on connecting GLS Germany ShipIt via the ShipStation dashboard, go to our GLS Germany ShipIt help article.
GLS Germany ShipIt does not send estimated rates to ShipStation V2 API, and so does not support rate shopping. Your GLS Germany ShipIt account contact can provide you with the details about your contracted rates.
Available GLS Germany ShipIt services are provided below. Please note that carriers may update their available services at any time. To ensure you are always using valid services, you can use the list carrier services endpoint at any time.
| Service | API Code |
|---|---|
| AddonLiabilityService | gls_shipit_addon_liability |
| BusinessParcel | gls_shipit_business_parcel |
| DepositService | gls_shipit_deposit_service |
| DocumentReturnService | gls_shipit_document_return |
| Express8:00Service | gls_shipit_express_0800 |
| Express9:00Service | gls_shipit_express_0900 |
| Express10:00Service | gls_shipit_express_1000 |
| Express12:00Service | gls_shipit_express_1200 |
| ExpressParcel | gls_shipit_express_parcel |
| FlexDeliveryService | gls_shipit_flex_delivery |
| Guaranteed24Service | gls_shipit_guaranteed_24 |
| LetterboxService | gls_shipit_letterbox_service |
| LimitedQuantities | gls_shipit_limited_quantities |
| ShopDeliveryService | gls_shipit_shop_delivery |
| ShopReturnService | gls_shipit_shop_return |
| Service | API Code |
|---|---|
| EuroBusinessParcel | gls_shipit_euro_business_parcel |
| EuroExpressParcel | gls_shipit_euro_express_parcel |
| EuroFlexDeliveryService | gls_shipit_euro_flex_delivery |
| EuroShopDeliveryService | gls_shipit_euro_shop_delivery |
| EuroShopReturnService | gls_shipit_euro_shop_return |
| GlobalParcel | gls_shipit_global_parcel |
GLS Germany ShipIt supports the following return services:
| Service | API Code |
|---|---|
| DocumentReturnService | gls_shipit_document_return |
| ShopReturnService | gls_shipit_shop_return |
| EuroShopReturnService | gls_shipit_euro_shop_return |
Review the Return Labels page for details on creating return labels with ShipStation V2 API.
The following carrier package types are available for GLS Germany ShipIt services:
| Name | Carrier Code | API Code |
|---|---|---|
| GLS ShipIt default package | gls_shipit | gls_shipit_default |
GLS Germany ShipIt does not support adding carrier insurance to their shipments.
Review the Parcel Insurance page for details on adding shipment insurance with ShipStation V2 API.
- Label sizes: 4" x 6"
- Label formats: PDF, ZPL
GLS Germany ShipIt supports adding custom label messages. The ShipmentReference is printed on the label.
GLS Germany ShipIt supports creating multi-package shipments.
GLS Germany ShipIt does not support label branding.
GLS Germany ShipIt supports voiding labels with ShipStation V2 API.
Cancelling a shipment is possible as long as the parcel has not yet been handed over to the GLS driver (i.e., as long as there is no physical scan). The exceptions are the Pick&Ship and Pick&Return services, for which the customer must actively request cancellation at the relevant GLS depot.
GLS Germany ShipIt does not support paperless labels.
For international shipments, customs information is printed on the shipping label.
| Confirmation Type | API Code | Description |
|---|---|---|
| No confirmation required | none | No signature required. |
| Signature required | delivery | Signature required upon delivery. |
See our Delivery Confirmation page for more details about using the confirmation property.
GLS Germany ShipIt supports the following advanced options:
| Option | Type | Description |
|---|---|---|
| Bill duties and taxes to payor of shipping charges (DDP) | boolean | Bill duties and taxes to the payor of shipping charges. |
| Saturday Delivery | boolean | Request Saturday delivery for the shipment. |
To ensure you always have the most up-to-date information about a carrier's advanced options, use the list carrier options call.
GLS Germany ShipIt does not require manifesting your shipments.
GLS Germany ShipIt supports scheduled pickups using ShipStation V2 API.
NOTE:
A customer must contact the GLS depot directly in order to cancel a pickup.
GLS Germany ShipIt does not support shipping to service points.
ShipStation V2 API's integration with GLS Germany ShipIt supports receiving tracking updates. Review our Track a Package guides for details on tracking with the ShipStation V2 API.
See the Disconnect section in our Delete a Carrier page for the process of deleting or disconnecting a carrier from ShipStation V2 API.
NOTE:
If you disconnect a carrier account and reconnect it, the account will have a new
carrier_idin ShipStation V2 API.