POST

Bulk Create Fulfillments


Creates multiple fulfillments for one or more orders.

Authentication

You can only call this method when authenticated as a Wix app or Wix user identity.

Permissions
Manage eCommerce - all permissions
Manage Stores - all permissions
Manage Orders
Manage Restaurants - all permissions
Learn more about app permissions.
Endpoint
POST
https://www.wixapis.com/ecom/v1/fulfillments/orders/bulk/create-fulfillments

Body Params
ordersWithFulfillmentsArray <BulkCreateOrderWithFulfillments>RequiredminItems 1maxItems 100

List of order IDs and their associated fulfillments.

Response Object
resultsArray <BulkOrderFulfillmentsResult>

Items updated by bulk action.


bulkActionMetadataBulkActionMetadata

Bulk action metadata.

Bulk Create Fulfillments

Creates a different fulfillment for two separate orders

Request
cURL
curl -X POST \ 'https://www.wixapis.com/ecom/v1/fulfillments/orders/bulk/create-fulfillments' \ -H 'Content-Type: application/json' \ -H 'Authorization: <AUTH>' \ --data-binary '{ "ordersWithFulfillments": [ { "orderId": "eb4b91d3-51f3-494d-94df-479ff2c6eb08", "fulfillments": [ { "lineItems": [ { "id": "00000000-0000-0000-0000-000000000001", "quantity": 1 } ], "trackingInfo": { "trackingNumber": "12345", "shippingProvider": "fedex" } } ] }, { "orderId": "719f96d3-80c7-45c2-b4c1-f15eb610f8a8", "fulfillments": [ { "lineItems": [ { "id": "00000000-0000-0000-0000-000000000001", "quantity": 1 } ], "trackingInfo": { "trackingNumber": "67890", "shippingProvider": "usps" } } ] } ] }'
Response
JSON
{ "results": [ { "itemMetadata": { "id": "eb4b91d3-51f3-494d-94df-479ff2c6eb08", "originalIndex": 0, "success": true }, "ordersWithFulfillments": { "orderId": "eb4b91d3-51f3-494d-94df-479ff2c6eb08", "fulfillments": [ { "id": "1d93cd8e-0de5-469b-b802-88bcd76cb222", "createdDate": "2023-02-27T11:42:48.021Z", "lineItems": [ { "id": "00000000-0000-0000-0000-000000000001", "quantity": 1 } ], "trackingInfo": { "trackingNumber": "12345", "shippingProvider": "fedex", "trackingLink": "https://www.fedex.com/apps/fedextrack/?action=track&trackingnumber=12345" } } ] } }, { "itemMetadata": { "id": "719f96d3-80c7-45c2-b4c1-f15eb610f8a8", "originalIndex": 1, "success": true }, "ordersWithFulfillments": { "orderId": "719f96d3-80c7-45c2-b4c1-f15eb610f8a8", "fulfillments": [ { "id": "09876985-7d10-4098-8b93-acb6023ac1f8", "createdDate": "2023-02-27T11:42:48.021Z", "lineItems": [ { "id": "00000000-0000-0000-0000-000000000001", "quantity": 1 } ], "trackingInfo": { "trackingNumber": "67890", "shippingProvider": "usps", "trackingLink": "https://tools.usps.com/go/TrackConfirmAction.action?tLabels=67890" } } ] } } ], "bulkActionMetadata": { "totalSuccesses": 2, "totalFailures": 0, "undetailedFailures": 0 } }
Errors

This method doesn’t return any custom errors, but may return standard errors. Learn more about standard Wix errors.

Event TriggersThis method triggers the following events:
Did this help?