Flexport

Step 1: Obtain Flexport Credentials

Contact Flexport support to obtain:
- API Key for authentication
- Flexport logisticsSku for each product in your catalog
- List of supported services and shipping methods

Step 2: Create Flexport Integration

1. Navigate to Settings > Integrations in Fulfil
2. Click Setup new integration
3. Select Flexport as the provider
4. Enter your API Key
5. In the mapping grid, choose the Fulfil warehouse for each Flexport storage warehouse and fulfillment center. Each reserve storage warehouse maps to one Fulfil warehouse. Network fulfillment centers map to one Fulfil warehouse per country, or to one per center
6. Click Save to activate the integration

Fulfil doesn't create warehouses for you. Create each one first with its type set to 3PL and 3PL set to Flexport.

Step 3: Configure Product Mapping

Products you create in Flexport with Send to 3PL get their logisticsSku saved in Fulfil automatically. For products that already exist in Flexport:
1. Obtain logisticsSku for each product from Flexport
2. In Fulfil, navigate to each product variant
3. Add the logisticsSku as the product identifier for Flexport

Step 4: Enable 3PL Schedules

Configure automated synchronization between Fulfil and Flexport:

1. Scroll to 3PL Schedules section in warehouse settings
2. Click + to add schedules for each action:

For Fulfillment:
- Send customer shipments: Sends assigned shipments to Flexport
- Get customer shipment advices: Retrieves tracking numbers and marks shipments as done

For Receiving:
- Send supplier shipments: Exports draft supplier shipments to Flexport
- Get inventory receipts: Marks supplier shipments as received once Flexport marks the inbound Completed

For Returns and Inventory:
- Send customer return shipments: Sends return shipments to Flexport as RMAs
- Get customer return shipment advices: Imports restocked and damaged quantities
- Get cycle counts: Fetches current inventory from Flexport and creates a cycle count

Shipped and return-received events also arrive by webhook, which Fulfil registers with Flexport when you activate the integration. The schedules act as a fallback.

1. Select an interval for each schedule or enter custom timing
2. Click Save

Bundle Item Fulfillment

When fulfilling product bundles, Fulfil automatically sends only the input components to Flexport. Flexport assembles and ships the complete bundle to the customer.

Partial Shipment Support

When Flexport ships an order partially, Fulfil automatically handles the split:
- Creates separate shipments for shipped vs. pending items
- Updates tracking for shipped items
- Keeps original shipment open for remaining items

Partial Receipt Handling

Fulfil receives a supplier shipment once Flexport marks the inbound Completed. For partial receipts:
- Fulfil creates a new shipment for received items and marks it done
- Original shipment remains open until all items are received
- Full receipts mark the entire shipment as done immediately

One Integration, Several Warehouses

One Flexport integration can serve several Fulfil warehouses on the same Flexport account. During setup, a grid lists your Flexport storage warehouses and fulfillment centers, and you choose the Fulfil warehouse for each:
- Each reserve storage warehouse maps to one Fulfil warehouse
- Network fulfillment centers map to one Fulfil warehouse per country, or to one per center

When centers map one per center and Flexport ships an order from a different center, Fulfil moves the shipment to that center's warehouse. A shipment from a center that isn't mapped is flagged with an error.

Customer Returns

Return shipments go to Flexport as return orders (RMAs). Return receipts and inspections arrive by webhook as they happen. Units Flexport restocks go back into sellable inventory, and units it discards are recorded as damaged.

Order Cancellation and Rejections

Cancelling a customer shipment or its order in Fulfil sends a cancellation request to Flexport for the whole shipment. Cancellation isn't guaranteed once Flexport has started fulfilling the order. When Flexport rejects an order with an error that won't clear on retry, such as a bad address, Fulfil marks the shipment rejected and shows Flexport's error message on it.

Merchant of Record Data

Fulfil transmits merchant of record data to Flexport on outbound shipments. This is required for shipments where Flexport acts as the customs broker and needs to identify the entity responsible for the goods.

Inventory Sync

For reserve storage, Flexport notifies Fulfil when available stock changes and Fulfil imports the adjustment. For both reserve storage and the network, the Get cycle counts schedule pulls current inventory from Flexport and creates a cycle count. Units Flexport reports as unavailable are left out of the count.