Fulfillments
List Fulfillments
Returns paginated sales order fulfillments for the V2 fulfillments list page. Supports GroupedFilterSupport filter_groups tree for advanced filtering.
Export Fulfillments
Exports sales order fulfillments as XLSX or CSV.
Get Fulfillment Detail
Returns full fulfillment detail including all related data: lines with products, sales order with addresses, warehouse, shipping methods, shipping provider orders (Shipstation, Shipfusion, etc.).
Get Fulfillment Line Items
Returns lightweight line items for a fulfillment's expandable row. Each item includes id, quantity, unit_cost, sku, product_name, and product_id. `unit_cost` is the per-unit cost of goods sold (FIFO-derived, prorated to the fulfilled quantity) — NOT the sale price; it is 0 when the line has no financial cost record.
Get Activity Log
Returns paginated activity log for a fulfillment, including activities on the fulfillment itself and all its child records (lines, etc.).
Get Inventory Movements
Returns paginated inventory movements linked to the fulfillment or any of its fulfillment lines.
Clear Channel Submission
Clears the submitted_to_sales_channel_at timestamp so the fulfillment will be resubmitted on the next sync. Works regardless of sales order status.
Submit to Sales Channel
Submits (or resubmits) fulfillment tracking info to the sales channel (e.g. Shopify) synchronously. Only sends tracking to the sales channel — NOT to the shipping provider.
Resync to Provider
Re-syncs the fulfillment to the shipping provider by sending the current line state. Only available for update-capable providers (Shipfusion, ShipHero, etc.) with submitted fulfillments.
Resync from Provider
Fetches the latest data FROM the shipping provider (tracking, status, etc.) and updates the local fulfillment record. Supported providers: Shipstation, Starshipit, Shipfusion, ShipHero, Trackstar, Veracore.
Cancel Provider Order
Cancels the provider-side fulfillment order. Supported providers: Amazon MCF (FBA), Shipfusion, ShipHero, Trackstar, Veracore.
Edit Shipping Details
Edit an existing fulfillment's shipping details — tracking number and shipping cost. A narrow, guard-free update: unlike the fulfill flow it does NOT require an open sales order or fulfillment lines, so a tracking number can be corrected after the order has shipped/closed. Never changes the warehouse (Stage 0 lock untouched).
Void Shipment
Voids a shipment (SalesOrderFulfillment) — a SOFT, reversible cancel that does NOT hard-delete the record (SKU-8019 'A1'). Voiding: reverses the shipment's inventory movements, reverts Fulfilled→Allocated allocations, restores the parent FulfillmentOrder budget and reopens the SAME FO to Open/Unsubmitted so it can be re-fulfilled, cancels the carrier order, and flips the SOF to status=canceled with voided_at/voided_by_user_id/void_reason set. The SOF + its lines are RETAINED for history; voided shipments are excluded from the active fulfillment tab (voided_at IS NULL filter).
Bulk Void Shipments
Bulk-voids shipments (SKU-8019). The DELETE verb is retained for backwards compatibility, but it now performs a soft VOID (not a hard delete): each shipment's inventory is reversed, its parent FulfillmentOrder is reopened, the carrier order is cancelled, and the SOF row is kept for history (status=canceled + void audit columns).