POST

Create Fulfillment


Deprecated

This method has been replaced with Create Fulfillment, and will be removed on September 4, 2024.

Deprecation Notice:

This endpoint has been replaced with eCommerce Create Fulfillment and will be removed on September 4, 2024.

Creates a fulfillment (a subset of an order, with line items that are being shipped together) based on the body parameters passed with the request. If the site owner has requested it, calling this request will trigger an email to the customer (based on the Wix store settings).

Authentication

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

Permissions
Manage Stores - all permissions
Manage Orders
Manage Restaurants - all permissions
Learn more about app permissions.
Endpoint
POST
https://www.wixapis.com/stores/v2/orders/{orderId}/fulfillments

Path Params
orderIdstringRequired

Order ID (to which the fulfillment will be related).

Body Params
fulfillmentFulfillmentRequired

Fulfillment info.

Response Object
idstringformat GUID

Fulfillment ID.


orderOrder

Updated order data.

Create Fulfillment Example 1
Request
cURL
curl 'https://www.wixapis.com/stores/v2/orders/fedb19f5-bd4c-4bfc-b2d1-212538319611/fulfillments' \ --data-binary '{ "fulfillment": { "lineItems": [ { "index": 1, "quantity": 1 } ], "trackingInfo": { "shippingProvider": "fedex", "trackingNumber": "1234", "trackingLink": "https://www.fedex.com/apps/fedextrack/?action=track&trackingnumber=1234" } } }' \ -H 'Content-Type: application/json' \ -H 'Authorization: <AUTH>'
Response
JSON
{ "id":"0175f0e8-f877-40a9-b980-0d336c64c726", "order":{ "id":"fedb19f5-bd4c-4bfc-b2d1-212538319611", "number":10096, "dateCreated":"2020-03-18T16:47:59.222Z", "buyerInfo":{ "id":"e9a69747-6816-42fb-87bf-4cd60a408b4e", "type":"CONTACT", "identityType":"CONTACT", "firstName":"John", "lastName":"Smith", "phone":"+972 555234555", "email":"Ivanushka@example.com" }, "currency":"USD", "weightUnit":"LB", "totals":{ "subtotal":"10", "shipping":"3", "tax":"3", "discount":"1", "total":"15", "weight":"30", "quantity":2 }, "billingInfo":{ "paymentMethod":"PayPal", "externalTransactionId":"tx_1806", "paymentProviderTransactionId":"tx_1806", "address":{ "fullName":{ "firstName":"John", "lastName":"Smith" }, "country":"US", "city":"New York", "zipCode":"92544", "phone":"+972 555234555", "email":"Ivanushka@example.com" }, "paidDate":"2020-03-18T16:47:59.244Z" }, "shippingInfo":{ "deliveryOption":"Express", "estimatedDeliveryTime":"Today", "shipmentDetails":{ "address":{ "fullName":{ "firstName":"John", "lastName":"Smith" }, "country":"US", "city":"New York", "zipCode":"92544", "phone":"+972 555234555", "email":"Ivanushka@example.com" }, "trackingInfo":{ "trackingNumber":"1234", "shippingProvider":"FEDEX", "trackingLink":"https://www.fedex.com/apps/fedextrack/?action=track&trackingnumber=1234" }, "discount":"0", "tax":"1", "priceData":{ "taxIncludedInPrice":false, "price":"3" } } }, "read":false, "archived":false, "paymentStatus":"PAID", "fulfillmentStatus":"PARTIALLY_FULFILLED", "lineItems":[ { "index":1, "quantity":2, "price":"5", "name":"my product", "productId":"a1f9d337-f831-4529-31e6-67db8fd4e1aa", "totalPrice":"10", "lineItemType":"PHYSICAL", "options":[
Errors

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

Did this help?