Shippit Connector Features Mapping
Essential knowledgeCore knowledge to understand Fluent Commerce
Intended Audience:
Business User
Author:
Movyn John
Changed on:
24 Mar 2026
Overview
The following mappings capture the features supported by the Shippit Connector.Key points
- All the features described below should be driven by the retailer's requirements
- The table provides the reference mapping for integration purposes to enable certain features of the connector
Fluent Commerce – Shippit Mapping
This Fluent Commerce Mapping column references the GraphQL schema documented here.The following data mappings document the Shippit & Fluent Commerce integration and itʼs data handling with relation to an Order and the Orderʼs Items.
| Feature | Fluent Commerce Mapping | Expected Values | Notes |
| Delivery Date | order.attribute.shippitDeliveryDate | Date in dd/mm/yyyy format | Scheduled delivery date |
| Delivery Window | order.attribute.shippitDeliveryWindow | Time in HH:mm format | Delivery time window within the scheduled delivery date |
| Authority To Leave | order.attribute.shippitAuthorityToLeave | yes or no (case insensitive) | Authority To Leave (ATL) flag if selected by the customer when placing the order. If this attribute is not set, |
| Delivery Instructions | order.fulfilmentChoice.deliveryInstruction | Free text | Delivery instructions to be provided to the carrier |
| Dangerous Goods Code | order.orderItem.attribute.shippitDangerousGoodsCode | Free text | |
| Dangerous Goods Text | order.orderItem.attribute.shippitDangerousGoodsText | Free text | |
| Origin Country Code | order.orderItem.attribute.shippitOriginCountryCode | ISO Country Code | |
| Tariff Code | order.orderItem.attribute.shippitTariffCode | Free text |
Shippit Label Information Mapping
The logic to determine the recipient information on the carrier label is as follows:| Field | Fluent Commerce Mapping |
| Recipient Name | Primary: `order.fulfilmentChoice.deliveryAddress.name` Fallback: `order.fulfilmentChoice.deliveryFirstName + order.fulfilmentChoice.deliveryLastName`OR` |
| Recipient Company Name | Primary:`order.fulfilmentChoice.deliveryAddress.companyNameFallback: NA |
| Recipient Contact Number | Primary:`order.fulfilmentChoice.deliveryContact`Fallback: `order.customer.primaryPhone` |
| Recipient / Tracking Email Address | Primary: `order.fulfilmentChoice.deliveryEmail`Fallback: `order.customer.primaryEmail` |
| Delivery Address | Primary:`order.fulfilmentChoice.deliveryAddress.streetFallback: NA |
Shippit On-Demand Information Mapping in Order Attributes
| Field | Fluent Commerce Mapping | Description | Required |
| shippitCourierType | STRING | Specifies the courier type. Set to on_demand for On-Demand orders. | Yes (if not using fulfilmentChoice.deliveryType mapping) |
| shippitPickupAt | STRING | Earliest pickup time for the courier | No |
| shippitPickupDeadlineAt | STRING | Latest pickup time for the courier | No |
| shippitDropoffAt | STRING | Earliest dropoff time to the customer | No |
| shippitDropoffDeadlineAt | STRING | Latest dropoff time to the customer | No |
| Method | Field | Example Value | Description |
| Method A (Recommended) | fulfilmentChoice.deliveryType | ON_DEMAND | Uses the Shipping Method Mapping configured in Shippit Connect settings |
| Method B | shippitCourierType attribute | on_demand | Explicitly sets the courier type via a custom order attribute. Overrides the fulfilmentChoice.deliveryType mapping if both are present. |