@wix/ditto-codegen-public 1.0.161 → 1.0.163

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (66) hide show
  1. package/dist/docs-output/api-docs/bookings-bookings-onBookingCanceled-doc.txt +169 -0
  2. package/dist/docs-output/api-docs/bookings-bookings-onBookingCreated-doc.txt +154 -0
  3. package/dist/docs-output/api-docs/crm-contacts-onContactCreated-doc.txt +87 -171
  4. package/dist/docs-output/api-docs/crm-contacts-onContactDeleted-doc.txt +58 -0
  5. package/dist/docs-output/api-docs/crm-contacts-onContactUpdated-doc.txt +99 -0
  6. package/dist/docs-output/api-docs/data-items-get-doc.txt +95 -54
  7. package/dist/docs-output/api-docs/data-items-insert-doc.txt +235 -43
  8. package/dist/docs-output/api-docs/data-items-onDataItemCreated-doc.txt +61 -0
  9. package/dist/docs-output/api-docs/data-items-onDataItemDeleted-doc.txt +58 -0
  10. package/dist/docs-output/api-docs/data-items-onDataItemUpdated-doc.txt +61 -0
  11. package/dist/docs-output/api-docs/data-items-query-doc.txt +507 -302
  12. package/dist/docs-output/api-docs/data-items-remove-doc.txt +120 -40
  13. package/dist/docs-output/api-docs/data-items-update-doc.txt +425 -46
  14. package/dist/docs-output/api-docs/ecom-cart-addToCart-doc.txt +488 -0
  15. package/dist/docs-output/api-docs/ecom-cart-createCart-doc.txt +518 -0
  16. package/dist/docs-output/api-docs/ecom-cart-createCheckout-doc.txt +155 -0
  17. package/dist/docs-output/api-docs/ecom-cart-deleteCart-doc.txt +92 -0
  18. package/dist/docs-output/api-docs/ecom-cart-getCart-doc.txt +376 -0
  19. package/dist/docs-output/api-docs/ecom-cart-onCartCreated-doc.txt +89 -80
  20. package/dist/docs-output/api-docs/ecom-cart-onCartUpdated-doc.txt +91 -81
  21. package/dist/docs-output/api-docs/ecom-cart-removeLineItemsFromCart-doc.txt +321 -0
  22. package/dist/docs-output/api-docs/ecom-cart-updateCart-doc.txt +539 -0
  23. package/dist/docs-output/api-docs/ecom-checkout-addToCheckout-doc.txt +1005 -0
  24. package/dist/docs-output/api-docs/ecom-checkout-createCheckout-doc.txt +1641 -0
  25. package/dist/docs-output/api-docs/ecom-checkout-getCheckout-doc.txt +1027 -0
  26. package/dist/docs-output/api-docs/ecom-checkout-onCheckoutCompleted-doc.txt +151 -0
  27. package/dist/docs-output/api-docs/ecom-checkout-onCheckoutCreated-doc.txt +150 -0
  28. package/dist/docs-output/api-docs/ecom-checkout-onCheckoutUpdated-doc.txt +150 -0
  29. package/dist/docs-output/api-docs/ecom-checkout-removeLineItemsFromCheckout-doc.txt +879 -0
  30. package/dist/docs-output/api-docs/ecom-checkout-updateCheckout-doc.txt +1011 -0
  31. package/dist/docs-output/api-docs/ecom-currentCart-getCurrentCart-doc.txt +368 -322
  32. package/dist/docs-output/api-docs/ecom-currentCart-updateCurrentCart-doc.txt +506 -321
  33. package/dist/docs-output/api-docs/ecom-orders-bulkUpdateOrders-doc.txt +1040 -0
  34. package/dist/docs-output/api-docs/ecom-orders-cancelOrder-doc.txt +608 -0
  35. package/dist/docs-output/api-docs/ecom-orders-getOrder-doc.txt +926 -0
  36. package/dist/docs-output/api-docs/ecom-orders-onOrderCreated-doc.txt +245 -0
  37. package/dist/docs-output/api-docs/ecom-orders-onOrderUpdated-doc.txt +244 -0
  38. package/dist/docs-output/api-docs/ecom-orders-searchOrders-doc.txt +670 -0
  39. package/dist/docs-output/api-docs/ecom-orders-updateOrder-doc.txt +818 -0
  40. package/dist/docs-output/api-docs/search-wixSiteSearch-search-doc.txt +162 -0
  41. package/dist/docs-output/api-docs/stores-collections-addProductsToCollection-doc.txt +86 -0
  42. package/dist/docs-output/api-docs/stores-collections-createCollection-doc.txt +108 -0
  43. package/dist/docs-output/api-docs/stores-collections-getCollection-doc.txt +102 -0
  44. package/dist/docs-output/api-docs/stores-collections-queryCollections-doc.txt +209 -0
  45. package/dist/docs-output/api-docs/stores-collections-removeProductsFromCollection-doc.txt +86 -0
  46. package/dist/docs-output/api-docs/stores-collections-updateCollection-doc.txt +110 -0
  47. package/dist/docs-output/api-docs/stores-inventory-queryInventory-doc.txt +98 -0
  48. package/dist/docs-output/api-docs/stores-inventory-updateInventoryVariants-doc.txt +249 -0
  49. package/dist/docs-output/api-docs/stores-inventoryItemsV3-queryInventoryItems-doc.txt +236 -0
  50. package/dist/docs-output/api-docs/stores-inventoryItemsV3-updateInventoryItem-doc.txt +139 -0
  51. package/dist/docs-output/api-docs/stores-productsV3-createProduct-doc.txt +1697 -0
  52. package/dist/docs-output/api-docs/stores-productsV3-deleteProduct-doc.txt +73 -0
  53. package/dist/docs-output/api-docs/stores-productsV3-getProduct-doc.txt +933 -0
  54. package/dist/docs-output/api-docs/stores-productsV3-onProductCreated-doc.txt +794 -0
  55. package/dist/docs-output/api-docs/stores-productsV3-onProductDeleted-doc.txt +794 -0
  56. package/dist/docs-output/api-docs/stores-productsV3-onProductUpdated-doc.txt +794 -0
  57. package/dist/docs-output/api-docs/stores-productsV3-queryProducts-doc.txt +1051 -0
  58. package/dist/docs-output/api-docs/stores-productsV3-searchProducts-doc.txt +1144 -0
  59. package/dist/docs-output/api-docs/stores-productsV3-updateProduct-doc.txt +1730 -1600
  60. package/dist/docs-output/api-docs/stores-readOnlyVariantsV3-queryVariants-doc.txt +290 -0
  61. package/dist/docs-output/api-docs/stores-readOnlyVariantsV3-searchVariants-doc.txt +353 -0
  62. package/dist/out.js +929 -79
  63. package/package.json +2 -2
  64. package/dist/docs-output/api-docs/data-items-onDataItemCreated.txt +0 -103
  65. package/dist/docs-output/api-docs/stores-product-onProductCreated-doc.txt +0 -118
  66. package/dist/docs-output/api-docs/stores-productV3-onProductCreated-doc.txt +0 -184
@@ -0,0 +1,670 @@
1
+ <ecom_orders_searchOrders>
2
+ <description>
3
+ # Method name:
4
+
5
+ ecom.orders.searchOrders(search: CursorSearch)
6
+
7
+ # Method Link:
8
+
9
+ https://dev.wix.com/docs/sdk/backend-modules/ecom/orders/search-orders
10
+
11
+ # Method Description:
12
+
13
+ Retrieves a list of orders, given the provided paging, filtering, and sorting.
14
+
15
+
16
+ Search Orders runs with these defaults, which you can override:
17
+
18
+ - `createdDate` is sorted in `DESC` order
19
+ - `cursorPaging.limit` is `100`
20
+ - `filter: {"status": {"$ne": "INITIALIZED"}}` - other order statuses can be queried, but orders with `status: "INITIALIZED"` are never returned
21
+
22
+ For field support for filters and sorting, see [Orders: Supported Filters and Sorting](https://dev.wix.com/docs/rest/api-reference/wix-e-commerce/orders/supported-filters-and-sorting).
23
+
24
+ To learn about working with _Search_ endpoints, see
25
+ [API Query Language](https://dev.wix.com/docs/rest/articles/getting-started/api-query-language), and
26
+ [Sorting and Paging](https://dev.wix.com/docs/rest/articles/getting-started/sorting-and-paging).
27
+
28
+ | Property | Capabilities | Filters
29
+ |-------|------------|------|
30
+ | `channelInfo.type` | Search: ✗<br/> Sort: `ASC`, `DESC` | `$eq`, `$in`, `$ne`, `$nin` |
31
+ | `fulfillmentStatus` | Search: ✗<br/> Sort: `ASC`, `DESC` | `$eq`, `$in`, `$ne`, `$nin` |
32
+ | `paymentStatus` | Search: ✗<br/> Sort: `ASC`, `DESC` | `$eq`, `$in`, `$ne`, `$nin` |
33
+ | `shippingInfo.region.name` | Search: ✗<br/> Sort: `ASC`, `DESC` | `$eq`, `$in`, `$ne`, `$nin` |
34
+ | `shippingInfo.title` | Search: ✗<br/> Sort: `ASC`, `DESC` | `$eq`, `$in`, `$ne`, `$nin` |
35
+ | `status` | Search: ✗<br/> Sort: `ASC`, `DESC` | `$eq`, `$in`, `$ne`, `$nin` |
36
+ | `_createdDate` | Search: ✗<br/> Sort: `ASC`, `DESC` | `$eq`, `$ne`, `$exists`, `$in`, `$any`, `$lt`, `$lte`, `$gt`, `$gte` |
37
+ | `_updatedDate` | Search: ✗<br/> Sort: `ASC`, `DESC` | `$eq`, `$ne`, `$exists`, `$in`, `$any`, `$lt`, `$lte`, `$gt`, `$gte` |
38
+ | `balanceSummary.authorized.amount` | Search: ✗<br/> Sort: `ASC`, `DESC` | `$eq`, `$ne`, `$exists`, `$in`, `$any`, `$begins`, `$gt`, `$lt`, `$lte`, `$gte` |
39
+ | `balanceSummary.pending.amount` | Search: ✗<br/> Sort: `ASC`, `DESC` | `$eq`, `$ne`, `$exists`, `$in`, `$any`, `$begins`, `$gt`, `$lt`, `$lte`, `$gte` |
40
+ | `balanceSummary.pendingRefund.amount` | Search: ✗<br/> Sort: `ASC`, `DESC` | `$eq`, `$ne`, `$exists`, `$in`, `$any`, `$begins`, `$gt`, `$lt`, `$lte`, `$gte` |
41
+ | `billingInfo.contactDetails.firstName` | Search: ✗<br/> Sort: `ASC`, `DESC` | `$eq`, `$ne`, `$exists`, `$in`, `$any`, `$begins`, `$gt`, `$lt`, `$lte`, `$gte` |
42
+ | `billingInfo.contactDetails.lastName` | Search: ✗<br/> Sort: `ASC`, `DESC` | `$eq`, `$ne`, `$exists`, `$in`, `$any`, `$begins`, `$gt`, `$lt`, `$lte`, `$gte` |
43
+ | `businessLocation._id` | Search: ✗<br/> Sort: `ASC`, `DESC` | `$eq`, `$ne`, `$exists`, `$in`, `$any`, `$begins`, `$gt`, `$lt`, `$lte`, `$gte` |
44
+ | `businessLocation.name` | Search: ✗<br/> Sort: `ASC`, `DESC` | `$eq`, `$ne`, `$exists`, `$in`, `$any`, `$begins`, `$gt`, `$lt`, `$lte`, `$gte` |
45
+ | `buyerInfo.email` | Search: ✗<br/> Sort: `ASC`, `DESC` | `$eq`, `$ne`, `$exists`, `$in`, `$any`, `$begins`, `$gt`, `$lt`, `$lte`, `$gte` |
46
+ | `number` | Search: ✗<br/> Sort: `ASC`, `DESC` | `$eq`, `$ne`, `$exists`, `$in`, `$any`, `$lt`, `$lte`, `$gt`, `$gte` |
47
+ | `priceSummary.total.amount` | Search: ✗<br/> Sort: `ASC`, `DESC` | `$eq`, `$ne`, `$exists`, `$in`, `$any`, `$begins`, `$gt`, `$lt`, `$lte`, `$gte` |
48
+ | `purchasedDate` | Search: ✗<br/> Sort: `ASC`, `DESC` | `$eq`, `$ne`, `$exists`, `$in`, `$any`, `$lt`, `$lte`, `$gt`, `$gte` |
49
+ | `shippingInfo.logistics.deliveryTime` | Search: ✗<br/> Sort: `ASC`, `DESC` | `$eq`, `$ne`, `$exists`, `$in`, `$any`, `$begins`, `$gt`, `$lt`, `$lte`, `$gte` |
50
+ | `shippingInfo.logistics.deliveryTimeSlot.from` | Search: ✗<br/> Sort: `ASC`, `DESC` | `$eq`, `$ne`, `$exists`, `$in`, `$any`, `$lt`, `$lte`, `$gt`, `$gte` |
51
+ | `shippingInfo.logistics.deliveryTimeSlot.to` | Search: ✗<br/> Sort: `ASC`, `DESC` | `$eq`, `$ne`, `$exists`, `$in`, `$any`, `$lt`, `$lte`, `$gt`, `$gte` |
52
+ | `taxInfo.totalExempt.amount` | Search: ✗<br/> Sort: `ASC`, `DESC` | `$eq`, `$ne`, `$exists`, `$in`, `$any`, `$begins`, `$gt`, `$lt`, `$lte`, `$gte` |
53
+ | `taxInfo.totalTax.amount` | Search: ✗<br/> Sort: `ASC`, `DESC` | `$eq`, `$ne`, `$exists`, `$in`, `$any`, `$begins`, `$gt`, `$lt`, `$lte`, `$gte` |
54
+ | `archived` | Search: ✗<br/> Sort: ✗ | `$eq`, `$ne`, `$exists`, `$in`, `$any` |
55
+ | `seenByAHuman` | Search: ✗<br/> Sort: ✗ | `$eq`, `$ne`, `$exists`, `$in`, `$any` |
56
+ | `_id` | Search: ✗<br/> Sort: ✗ | `$eq`, `$in`, `$ne`, `$nin` |
57
+ | `buyerInfo.contactId` | Search: ✗<br/> Sort: ✗ | `$eq`, `$in`, `$ne`, `$nin` |
58
+ | `buyerInfo.memberId` | Search: ✗<br/> Sort: ✗ | `$eq`, `$in`, `$ne`, `$nin` |
59
+ | `channelInfo.externalOrderId` | Search: ✗<br/> Sort: ✗ | `$eq`, `$in`, `$ne`, `$nin` |
60
+ | `checkoutId` | Search: ✗<br/> Sort: ✗ | `$eq`, `$in`, `$ne`, `$nin` |
61
+ | `createdBy.userId` | Search: ✗<br/> Sort: ✗ | `$eq`, `$in`, `$ne`, `$nin` |
62
+ | `lineItems.subscriptionInfo._id` | Search: ✗<br/> Sort: ✗ | `$eq`, `$in`, `$ne`, `$nin` |
63
+ | `lineItems.catalogReference.appId` | Search: ✗<br/> Sort: ✗ | `$hasAll`, `$hasSome` |
64
+ | `lineItems.catalogReference.catalogItemId` | Search: ✗<br/> Sort: ✗ | `$hasAll`, `$hasSome` |
65
+ | `lineItems.locations._id` | Search: ✗<br/> Sort: ✗ | `$hasAll`, `$hasSome` |
66
+ | `fulfillmentStatusesAggregate.statuses` | Search: ✗<br/> Sort: `ASC`, `DESC` | `$hasAll`, `$hasSome` |
67
+ | `lineItems.productName.original` | Search: ✗<br/> Sort: `ASC`, `DESC` | `$hasAll`, `$hasSome` |
68
+
69
+
70
+ # Method Permissions:
71
+
72
+ - ECOM.READ_ORDERS
73
+
74
+ # Method Permissions Scopes IDs:
75
+
76
+ undefined
77
+
78
+
79
+
80
+ # Method Code Examples:
81
+
82
+ ## searchOrders
83
+
84
+ ```javascript
85
+ import { orders } from '@wix/ecom';
86
+
87
+ async function searchOrders(search) {
88
+ const response = await orders.searchOrders(search);
89
+ };
90
+ ```
91
+
92
+ ## searchOrders (with elevated permissions)
93
+
94
+ ```javascript
95
+ import { orders } from '@wix/ecom';
96
+ import { auth } from '@wix/essentials';
97
+
98
+ async function mySearchOrdersMethod(search) {
99
+ const elevatedSearchOrders = auth.elevate(orders.searchOrders);
100
+ const response = await elevatedSearchOrders(search);
101
+ }
102
+ ```
103
+
104
+
105
+
106
+ ## default
107
+
108
+ ```javascript
109
+ try {
110
+ const result = await orders.searchOrders({
111
+ filter: { "status": { "$ne": "INITIALIZED" } },
112
+ sort: [{ fieldName: "_createdDate", order: "DESC" }],
113
+ cursorPaging: { limit: 100 }
114
+ });
115
+ return result;
116
+ } catch (error) {
117
+ console.error(error);
118
+ throw error;
119
+ }
120
+ ```
121
+ </description>
122
+ <type_definition>
123
+ ```
124
+ Method: ecom.orders.searchOrders(search)
125
+ Description: Retrieves a list of orders, given the provided paging, filtering, and sorting. Search Orders runs with these defaults, which you can override: - `createdDate` is sorted in `DESC` order - `cursorPaging.limit` is `100` - `filter: {"status": {"$ne": "INITIALIZED"}}` - other order statuses can be queried, but orders with `status: "INITIALIZED"` are never returned For field support for filters and sorting, see [Orders: Supported Filters and Sorting](https://dev.wix.com/docs/rest/api-reference/wix-e-commerce/orders/supported-filters-and-sorting). To learn about working with _Search_ endpoints, see [API Query Language](https://dev.wix.com/docs/rest/articles/getting-started/api-query-language), and [Sorting and Paging](https://dev.wix.com/docs/rest/articles/getting-started/sorting-and-paging). | Property | Capabilities | Filters |-------|------------|------| | `channelInfo.type` | Search: ✗<br/> Sort: `ASC`, `DESC` | `$eq`, `$in`, `$ne`, `$nin` | | `fulfillmentStatus` | Search: ✗<br/> Sort: `ASC`, `DESC` | `$eq`, `$in`, `$ne`, `$nin` | | `paymentStatus` | Search: ✗<br/> Sort: `ASC`, `DESC` | `$eq`, `$in`, `$ne`, `$nin` | | `shippingInfo.region.name` | Search: ✗<br/> Sort: `ASC`, `DESC` | `$eq`, `$in`, `$ne`, `$nin` | | `shippingInfo.title` | Search: ✗<br/> Sort: `ASC`, `DESC` | `$eq`, `$in`, `$ne`, `$nin` | | `status` | Search: ✗<br/> Sort: `ASC`, `DESC` | `$eq`, `$in`, `$ne`, `$nin` | | `_createdDate` | Search: ✗<br/> Sort: `ASC`, `DESC` | `$eq`, `$ne`, `$exists`, `$in`, `$any`, `$lt`, `$lte`, `$gt`, `$gte` | | `_updatedDate` | Search: ✗<br/> Sort: `ASC`, `DESC` | `$eq`, `$ne`, `$exists`, `$in`, `$any`, `$lt`, `$lte`, `$gt`, `$gte` | | `balanceSummary.authorized.amount` | Search: ✗<br/> Sort: `ASC`, `DESC` | `$eq`, `$ne`, `$exists`, `$in`, `$any`, `$begins`, `$gt`, `$lt`, `$lte`, `$gte` | | `balanceSummary.pending.amount` | Search: ✗<br/> Sort: `ASC`, `DESC` | `$eq`, `$ne`, `$exists`, `$in`, `$any`, `$begins`, `$gt`, `$lt`, `$lte`, `$gte` | | `balanceSummary.pendingRefund.amount` | Search: ✗<br/> Sort: `ASC`, `DESC` | `$eq`, `$ne`, `$exists`, `$in`, `$any`, `$begins`, `$gt`, `$lt`, `$lte`, `$gte` | | `billingInfo.contactDetails.firstName` | Search: ✗<br/> Sort: `ASC`, `DESC` | `$eq`, `$ne`, `$exists`, `$in`, `$any`, `$begins`, `$gt`, `$lt`, `$lte`, `$gte` | | `billingInfo.contactDetails.lastName` | Search: ✗<br/> Sort: `ASC`, `DESC` | `$eq`, `$ne`, `$exists`, `$in`, `$any`, `$begins`, `$gt`, `$lt`, `$lte`, `$gte` | | `businessLocation._id` | Search: ✗<br/> Sort: `ASC`, `DESC` | `$eq`, `$ne`, `$exists`, `$in`, `$any`, `$begins`, `$gt`, `$lt`, `$lte`, `$gte` | | `businessLocation.name` | Search: ✗<br/> Sort: `ASC`, `DESC` | `$eq`, `$ne`, `$exists`, `$in`, `$any`, `$begins`, `$gt`, `$lt`, `$lte`, `$gte` | | `buyerInfo.email` | Search: ✗<br/> Sort: `ASC`, `DESC` | `$eq`, `$ne`, `$exists`, `$in`, `$any`, `$begins`, `$gt`, `$lt`, `$lte`, `$gte` | | `number` | Search: ✗<br/> Sort: `ASC`, `DESC` | `$eq`, `$ne`, `$exists`, `$in`, `$any`, `$lt`, `$lte`, `$gt`, `$gte` | | `priceSummary.total.amount` | Search: ✗<br/> Sort: `ASC`, `DESC` | `$eq`, `$ne`, `$exists`, `$in`, `$any`, `$begins`, `$gt`, `$lt`, `$lte`, `$gte` | | `purchasedDate` | Search: ✗<br/> Sort: `ASC`, `DESC` | `$eq`, `$ne`, `$exists`, `$in`, `$any`, `$lt`, `$lte`, `$gt`, `$gte` | | `shippingInfo.logistics.deliveryTime` | Search: ✗<br/> Sort: `ASC`, `DESC` | `$eq`, `$ne`, `$exists`, `$in`, `$any`, `$begins`, `$gt`, `$lt`, `$lte`, `$gte` | | `shippingInfo.logistics.deliveryTimeSlot.from` | Search: ✗<br/> Sort: `ASC`, `DESC` | `$eq`, `$ne`, `$exists`, `$in`, `$any`, `$lt`, `$lte`, `$gt`, `$gte` | | `shippingInfo.logistics.deliveryTimeSlot.to` | Search: ✗<br/> Sort: `ASC`, `DESC` | `$eq`, `$ne`, `$exists`, `$in`, `$any`, `$lt`, `$lte`, `$gt`, `$gte` | | `taxInfo.totalExempt.amount` | Search: ✗<br/> Sort: `ASC`, `DESC` | `$eq`, `$ne`, `$exists`, `$in`, `$any`, `$begins`, `$gt`, `$lt`, `$lte`, `$gte` | | `taxInfo.totalTax.amount` | Search: ✗<br/> Sort: `ASC`, `DESC` | `$eq`, `$ne`, `$exists`, `$in`, `$any`, `$begins`, `$gt`, `$lt`, `$lte`, `$gte` | | `archived` | Search: ✗<br/> Sort: ✗ | `$eq`, `$ne`, `$exists`, `$in`, `$any` | | `seenByAHuman` | Search: ✗<br/> Sort: ✗ | `$eq`, `$ne`, `$exists`, `$in`, `$any` | | `_id` | Search: ✗<br/> Sort: ✗ | `$eq`, `$in`, `$ne`, `$nin` | | `buyerInfo.contactId` | Search: ✗<br/> Sort: ✗ | `$eq`, `$in`, `$ne`, `$nin` | | `buyerInfo.memberId` | Search: ✗<br/> Sort: ✗ | `$eq`, `$in`, `$ne`, `$nin` | | `channelInfo.externalOrderId` | Search: ✗<br/> Sort: ✗ | `$eq`, `$in`, `$ne`, `$nin` | | `checkoutId` | Search: ✗<br/> Sort: ✗ | `$eq`, `$in`, `$ne`, `$nin` | | `createdBy.userId` | Search: ✗<br/> Sort: ✗ | `$eq`, `$in`, `$ne`, `$nin` | | `lineItems.subscriptionInfo._id` | Search: ✗<br/> Sort: ✗ | `$eq`, `$in`, `$ne`, `$nin` | | `lineItems.catalogReference.appId` | Search: ✗<br/> Sort: ✗ | `$hasAll`, `$hasSome` | | `lineItems.catalogReference.catalogItemId` | Search: ✗<br/> Sort: ✗ | `$hasAll`, `$hasSome` | | `lineItems.locations._id` | Search: ✗<br/> Sort: ✗ | `$hasAll`, `$hasSome` | | `fulfillmentStatusesAggregate.statuses` | Search: ✗<br/> Sort: `ASC`, `DESC` | `$hasAll`, `$hasSome` | | `lineItems.productName.original` | Search: ✗<br/> Sort: `ASC`, `DESC` | `$hasAll`, `$hasSome` |
126
+ Method parameters:
127
+ param name: search | type: CursorSearch | description: Search options. | required: true
128
+ - name: filter | type: Record<string, any> | description: Filter object. Learn more about [filtering](https://dev.wix.com/docs/rest/articles/getting-started/api-query-language#filters).
129
+ - name: sort | type: Array<Sorting> | description: List of sort objects. Learn more about [sorting](https://dev.wix.com/docs/rest/articles/getting-started/api-query-language#sorting).
130
+ - name: fieldName | type: string | description: Name of the field to sort by.
131
+ - name: order | type: SortOrder | description: Sort order.
132
+ enum: ASC, DESC
133
+ - ONE-OF:
134
+ - name: cursorPaging | type: CursorPaging | description: Cursor paging options. Learn more about [cursor paging](https://dev.wix.com/docs/rest/articles/getting-started/api-query-language#cursor-paging).
135
+ - name: cursor | type: string | description: Pointer to the next or previous page in the list of results. Pass the relevant cursor token from the `pagingMetadata` object in the previous call's response. Not relevant for the first request.
136
+ - name: limit | type: number | description: Maximum number of items to return in the results.
137
+ Return type: PROMISE<SearchOrdersResponse>
138
+ - name: metadata | type: CursorPagingMetadata | description: Details on the paged set of results returned.
139
+ - name: metadata.count | type: number | description: Number of items returned in current page.
140
+ - name: metadata.cursors | type: Cursors | description: Cursor strings that point to the next page, previous page, or both.
141
+ - name: metadata.cursors.next | type: string | description: Cursor string pointing to the next page in the list of results.
142
+ - name: metadata.cursors.prev | type: string | description: Cursor pointing to the previous page in the list of results.
143
+ - name: metadata.hasNext | type: boolean | description: Whether there are more pages to retrieve following the current page. + `true`: Another page of results can be retrieved. + `false`: This is the last page.
144
+ - name: orders | type: Array<Order> | description: List of orders.
145
+ - name: orders[]._createdDate | type: Date | description: Date and time the order was created.
146
+ - name: orders[]._id | type: string | description: Order GUID.
147
+ - name: orders[]._updatedDate | type: Date | description: Date and time the order was last updated in [ISO-8601](https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations) format.
148
+ - name: orders[].activities | type: Array<Activity> | description: Order activities.
149
+ - name: orders[].activities[]._createdDate | type: Date | description: Activity creation date and time.
150
+ - name: orders[].activities[]._id | type: string | description: Activity GUID.
151
+ - name: orders[].activities[].activityType | type: OrderActivityTypeEnumActivityType | description: Activity type.
152
+ enum:
153
+ AUTHORIZED_PAYMENT_CAPTURED: Previously authorized payment was captured.
154
+ AUTHORIZED_PAYMENT_CREATED: Payment was authorized but not yet captured.
155
+ AUTHORIZED_PAYMENT_VOIDED: Previously authorized payment was voided.
156
+ CHARGEBACK_CREATED: Chargeback was created for one of the order's payments.
157
+ CHARGEBACK_REVERSED: Chargeback was resolved in merchant's favor.
158
+ CUSTOM_ACTIVITY: Custom activity created by a third-party application.
159
+ DOWNLOAD_LINK_SENT: Download link was sent for digital items in the order.
160
+ DRAFT_ORDER_CHANGES_APPLIED: Changes were applied to a draft order.
161
+ EMAIL_EDITED: Order's contact email address was changed.
162
+ FULFILLER_EMAIL_SENT: Notification email was sent to the order fulfiller.
163
+ INVOICE_ADDED: Invoice document was added to the order.
164
+ INVOICE_REMOVED: Invoice was removed from the order.
165
+ INVOICE_SENT: Invoice was sent to the customer via email.
166
+ MERCHANT_COMMENT: Comment added to the order by a merchant.
167
+ NEW_EXCHANGE_ORDER_CREATED: New exchange order was created from this order.
168
+ ORDER_CANCELED: Order was canceled by merchant or customer.
169
+ ORDER_CREATED_FROM_EXCHANGE: Order was created as a result of an exchange.
170
+ ORDER_FULFILLED: Order items were marked as fulfilled (shipped or ready for pickup).
171
+ ORDER_NOT_FULFILLED: Order fulfillment status was changed to not fulfilled.
172
+ ORDER_PAID: Order payment was completed and confirmed.
173
+ ORDER_PARTIALLY_PAID: Partial payment was received for the order.
174
+ ORDER_PENDING: Order is awaiting approval or processing.
175
+ ORDER_PLACED: New order was created and placed.
176
+ ORDER_REFUNDED: Order was refunded, either partially or fully.
177
+ ORDER_REJECTED: Order was rejected by merchant.
178
+ PAYMENT_CANCELED: Payment was canceled before completion.
179
+ PAYMENT_DECLINED: Payment was declined by payment provider.
180
+ PAYMENT_PENDING: Payment is awaiting processing or confirmation.
181
+ PAYMENT_REFUNDED: Payment was successfully refunded.
182
+ PAYMENT_REFUND_FAILED: Attempt to refund payment failed.
183
+ PICKUP_READY_EMAIL_SENT: Email notification for pickup readiness was sent.
184
+ RECEIPT_CREATED: Receipt was generated for a payment.
185
+ RECEIPT_SENT: Receipt was sent to the customer.
186
+ REFUNDED_AS_STORE_CREDIT: Refund was issued as store credit.
187
+ REFUND_INITIATED: Refund process was initiated.
188
+ SAVED_PAYMENT_METHOD: Payment method was saved for future use.
189
+ SHIPPING_ADDRESS_EDITED: Order's shipping address was modified.
190
+ SHIPPING_CONFIRMATION_EMAIL_SENT: Email confirming shipment was sent to the customer.
191
+ TRACKING_LINK_ADDED: Tracking link for shipment was added to the order.
192
+ TRACKING_NUMBER_ADDED: Shipping tracking number was added to the order.
193
+ TRACKING_NUMBER_EDITED: Existing shipping tracking number was modified.
194
+ UNKNOWN_ACTIVITY_TYPE: Default value. This value is unused.
195
+ - name: orders[].activities[].authorEmail | type: string | description: Activity author's email.
196
+ - ONE-OF:
197
+ - name: orders[].activities[].authorizedPaymentCaptured | type: AuthorizedPaymentCaptured | description: Details of an authorized payment captured.
198
+ - name: orders[].activities[].authorizedPaymentCaptured.amount | type: Price | description: Payment amount
199
+ - name: orders[].activities[].authorizedPaymentCaptured.amount.amount | type: string | description: Amount.
200
+ - name: orders[].activities[].authorizedPaymentCaptured.amount.formattedAmount | type: string | description: Amount formatted with currency symbol.
201
+ - name: orders[].activities[].authorizedPaymentCaptured.brand | type: string | description: Card issuer's brand.
202
+ - name: orders[].activities[].authorizedPaymentCaptured.lastFourDigits | type: string | description: The last 4 digits of the card number.
203
+ - name: orders[].activities[].authorizedPaymentCaptured.paymentId | type: string | description: Payment GUID of payment associated with this activity
204
+ - name: orders[].activities[].authorizedPaymentCreated | type: AuthorizedPaymentCreated | description: Details of an authorized payment created.
205
+ - name: orders[].activities[].authorizedPaymentCreated.amount | type: Price | description: Payment amount
206
+ - name: orders[].activities[].authorizedPaymentCreated.brand | type: string | description: Card issuer's brand.
207
+ - name: orders[].activities[].authorizedPaymentCreated.lastFourDigits | type: string | description: The last 4 digits of the card number.
208
+ - name: orders[].activities[].authorizedPaymentCreated.paymentId | type: string | description: Payment GUID of payment associated with this activity
209
+ - name: orders[].activities[].authorizedPaymentVoided | type: AuthorizedPaymentVoided | description: Details of an authorized payment voided.
210
+ - name: orders[].activities[].authorizedPaymentVoided.amount | type: Price | description: Payment amount
211
+ - name: orders[].activities[].authorizedPaymentVoided.brand | type: string | description: Card issuer's brand.
212
+ - name: orders[].activities[].authorizedPaymentVoided.lastFourDigits | type: string | description: The last 4 digits of the card number.
213
+ - name: orders[].activities[].authorizedPaymentVoided.paymentId | type: string | description: Payment GUID of payment associated with this activity
214
+ - name: orders[].activities[].chargebackCreated | type: ChargebackCreated | description: Order received a chargeback for one of its' payments.
215
+ - name: orders[].activities[].chargebackCreated.amount | type: Price | description: Chargeback amount.
216
+ - name: orders[].activities[].chargebackCreated.chargebackId | type: string | description: Chargeback GUID.
217
+ - name: orders[].activities[].chargebackCreated.paymentDetails | type: RegularPayment | description: Payment details.
218
+ - name: orders[].activities[].chargebackCreated.paymentDetails.amount | type: Price | description: Payment amount
219
+ - ONE-OF:
220
+ - name: orders[].activities[].chargebackCreated.paymentDetails.creditCardDetails | type: CreditCardDetails | description: Whether regular card used
221
+ - name: orders[].activities[].chargebackCreated.paymentDetails.creditCardDetails.brand | type: string | description: Card issuer's brand.
222
+ - name: orders[].activities[].chargebackCreated.paymentDetails.creditCardDetails.lastFourDigits | type: string | description: The last 4 digits of the card number.
223
+ - name: orders[].activities[].chargebackCreated.paymentId | type: string | description: GUID of the payment that received a chargeback.
224
+ - name: orders[].activities[].chargebackReversed | type: ChargebackReversed | description: Chargeback reversed for one of the order's payments.
225
+ - name: orders[].activities[].chargebackReversed.amount | type: Price | description: Chargeback amount.
226
+ - name: orders[].activities[].chargebackReversed.chargebackId | type: string | description: Chargeback GUID.
227
+ - name: orders[].activities[].chargebackReversed.paymentDetails | type: RegularPayment | description: Payment details.
228
+ - name: orders[].activities[].chargebackReversed.paymentId | type: string | description: GUID of the payment involved with the chargeback.
229
+ - name: orders[].activities[].chargebackReversed.reversalAmount | type: Price | description: Chargeback reversal amount.
230
+ - name: orders[].activities[].customActivity | type: CustomActivity | description: Custom activity details (optional). `activity.type` must be `CUSTOM_ACTIVITY`.
231
+ - name: orders[].activities[].customActivity.additionalData | type: Record<string, string> | description: Additional data in key-value form. For example, `{ "Ticket number": "123456" }`.
232
+ - name: orders[].activities[].customActivity.appId | type: string | description: GUID of the app that created the custom activity.
233
+ - name: orders[].activities[].customActivity.type | type: string | description: Custom activity type. For example, `"Ticket number set"`.
234
+ - name: orders[].activities[].draftOrderChangesApplied | type: DraftOrderChangesApplied | description: Details of changes made by the Draft Orders API.
235
+ - name: orders[].activities[].draftOrderChangesApplied.changes | type: Array<OrderChange> | description: Changes applied to order.
236
+ - ONE-OF:
237
+ - name: orders[].activities[].draftOrderChangesApplied.changes[].additionalFeeAdded | type: ManagedAdditionalFee | description: none
238
+ - name: orders[].activities[].draftOrderChangesApplied.changes[].additionalFeeAdded._id | type: string | description: Additional fee id.
239
+ - name: orders[].activities[].draftOrderChangesApplied.changes[].additionalFeeAdded.affectedLineItems | type: Array<LineItemAmount> | description: Line items additional fee applies to.
240
+ - name: orders[].activities[].draftOrderChangesApplied.changes[].additionalFeeAdded.affectedLineItems[]._id | type: string | description: Order line item id
241
+ - name: orders[].activities[].draftOrderChangesApplied.changes[].additionalFeeAdded.affectedLineItems[].amount | type: Price | description: Amount associated with this item. (Discount amount for item / additional fee amount for item)
242
+ - name: orders[].activities[].draftOrderChangesApplied.changes[].additionalFeeAdded.affectedLineItems[].name | type: ProductName | description: Item name.
243
+ - name: orders[].activities[].draftOrderChangesApplied.changes[].additionalFeeAdded.affectedLineItems[].name.original | type: string | description: __Required.__ Item name in the site's default language as defined in the [request envelope](https://dev.wix.com/docs/build-apps/develop-your-app/frameworks/self-hosting/supported-extensions/backend-extensions/add-self-hosted-service-plugin-extensions#request-envelope). Min: 1 character. Max: 200 characters.
244
+ - name: orders[].activities[].draftOrderChangesApplied.changes[].additionalFeeAdded.affectedLineItems[].name.translated | type: string | description: Item name translated into the buyer's language. Min: 1 character. Max: 400 characters. Default: Same as `original`.
245
+ - name: orders[].activities[].draftOrderChangesApplied.changes[].additionalFeeAdded.name | type: TranslatedValue | description: Additional fee name.
246
+ - name: orders[].activities[].draftOrderChangesApplied.changes[].additionalFeeAdded.name.original | type: string | description: Value in site default language.
247
+ - name: orders[].activities[].draftOrderChangesApplied.changes[].additionalFeeAdded.name.translated | type: string | description: Translated value.
248
+ - name: orders[].activities[].draftOrderChangesApplied.changes[].additionalFeeAdded.totalAmount | type: Price | description: Additional fee amount.
249
+ - name: orders[].activities[].draftOrderChangesApplied.changes[].additionalFeeRemoved | type: ManagedAdditionalFee | description: none
250
+ - name: orders[].activities[].draftOrderChangesApplied.changes[].discountAdded | type: ManagedDiscount | description: none
251
+ - name: orders[].activities[].draftOrderChangesApplied.changes[].discountAdded._id | type: string | description: Discount id.
252
+ - name: orders[].activities[].draftOrderChangesApplied.changes[].discountAdded.affectedLineItems | type: Array<LineItemAmount> | description: Line items discount applies to.
253
+ - name: orders[].activities[].draftOrderChangesApplied.changes[].discountAdded.name | type: TranslatedValue | description: Discount name: coupon name / discount rule name / merchant discount description.
254
+ - name: orders[].activities[].draftOrderChangesApplied.changes[].discountAdded.totalAmount | type: Price | description: Discount amount.
255
+ - name: orders[].activities[].draftOrderChangesApplied.changes[].discountRemoved | type: ManagedDiscount | description: none
256
+ - name: orders[].activities[].draftOrderChangesApplied.changes[].lineItemAdded | type: ManagedLineItem | description: none
257
+ - name: orders[].activities[].draftOrderChangesApplied.changes[].lineItemAdded._id | type: string | description: Line item GUID.
258
+ - name: orders[].activities[].draftOrderChangesApplied.changes[].lineItemAdded.name | type: ProductName | description: Item name.
259
+ - name: orders[].activities[].draftOrderChangesApplied.changes[].lineItemAdded.quantity | type: number | description: Added or removed item quantity.
260
+ - name: orders[].activities[].draftOrderChangesApplied.changes[].lineItemChanged | type: LineItemChanges | description: none
261
+ - name: orders[].activities[].draftOrderChangesApplied.changes[].lineItemChanged._id | type: string | description: Line item GUID.
262
+ - name: orders[].activities[].draftOrderChangesApplied.changes[].lineItemChanged.name | type: ProductName | description: Item name after change.
263
+ - name: orders[].activities[].draftOrderChangesApplied.changes[].lineItemChanged.price | type: LineItemPriceChange | description: Item price change.
264
+ - name: orders[].activities[].draftOrderChangesApplied.changes[].lineItemChanged.price.newPrice | type: Price | description: Item price after update.
265
+ - name: orders[].activities[].draftOrderChangesApplied.changes[].lineItemChanged.price.originalPrice | type: Price | description: Item price before update.
266
+ - name: orders[].activities[].draftOrderChangesApplied.changes[].lineItemChanged.quantity | type: LineItemQuantityChange | description: Item quantity change.
267
+ - name: orders[].activities[].draftOrderChangesApplied.changes[].lineItemChanged.quantity.deltaType | type: LineItemQuantityChangeType | description: Type of quantity change: increase or decrease.
268
+ enum:
269
+ QUANTITY_DECREASED: Quantity decreased.
270
+ QUANTITY_INCREASED: Quantity increased.
271
+ - name: orders[].activities[].draftOrderChangesApplied.changes[].lineItemChanged.quantity.diff | type: number | description: Difference between original and new quantity. Absolute value.
272
+ - name: orders[].activities[].draftOrderChangesApplied.changes[].lineItemChanged.quantity.newQuantity | type: number | description: Item quantity after update.
273
+ - name: orders[].activities[].draftOrderChangesApplied.changes[].lineItemChanged.quantity.originalQuantity | type: number | description: Item quantity before update.
274
+ - name: orders[].activities[].draftOrderChangesApplied.changes[].lineItemRemoved | type: ManagedLineItem | description: none
275
+ - name: orders[].activities[].draftOrderChangesApplied.changes[].shippingInformationChanged | type: ShippingInformationChange | description: none
276
+ - name: orders[].activities[].draftOrderChangesApplied.changes[].shippingInformationChanged.newShippingInfo | type: ShippingInformation | description: Order’s Shipping Information. After update
277
+ - name: orders[].activities[].draftOrderChangesApplied.changes[].shippingInformationChanged.newShippingInfo.shippingTitle | type: string | description: Order’s shipping title.
278
+ - name: orders[].activities[].draftOrderChangesApplied.changes[].shippingInformationChanged.newShippingInfo.total | type: Price | description: Order’s shipping price.
279
+ - name: orders[].activities[].draftOrderChangesApplied.changes[].shippingInformationChanged.originalShippingInfo | type: ShippingInformation | description: Order’s Shipping Information. Before update
280
+ - name: orders[].activities[].draftOrderChangesApplied.changes[].totalPriceChanged | type: TotalPriceChange | description: none
281
+ - name: orders[].activities[].draftOrderChangesApplied.changes[].totalPriceChanged.newTotal | type: Price | description: Order’s total price after discounts and tax. After update
282
+ - name: orders[].activities[].draftOrderChangesApplied.changes[].totalPriceChanged.originalTotal | type: Price | description: Order’s total price after discounts and tax. Before update
283
+ - name: orders[].activities[].draftOrderChangesApplied.draftOrderId | type: string | description: Draft order id.
284
+ - name: orders[].activities[].draftOrderChangesApplied.reason | type: string | description: Reason for edit, given by user (optional).
285
+ - name: orders[].activities[].merchantComment | type: MerchantComment | description: Merchant comment details (optional). `activity.type` must be `MERCHANT_COMMENT`.
286
+ - name: orders[].activities[].merchantComment.message | type: string | description: Merchant comment message.
287
+ - name: orders[].activities[].orderRefunded | type: OrderRefunded | description: Additional info about order refunded activity (optional). `activity.type` must be `ORDER_REFUNDED`.
288
+ - name: orders[].activities[].orderRefunded.amount | type: Price | description: Refund amount.
289
+ - name: orders[].activities[].orderRefunded.manual | type: boolean | description: Whether order was refunded manually. For example, via payment provider or using cash.
290
+ - name: orders[].activities[].orderRefunded.reason | type: string | description: Reason for refund.
291
+ - name: orders[].activities[].paymentCanceled | type: PaymentCanceled | description: Details of a canceled payment.
292
+ - name: orders[].activities[].paymentCanceled.paymentId | type: string | description: Payment GUID of payment associated with this activity
293
+ - ONE-OF:
294
+ - name: orders[].activities[].paymentCanceled.regular | type: RegularPayment | description: Regular payment.
295
+ - name: orders[].activities[].paymentDeclined | type: PaymentDeclined | description: Details of a declined payment.
296
+ - name: orders[].activities[].paymentDeclined.paymentId | type: string | description: Payment GUID of payment associated with this activity
297
+ - ONE-OF:
298
+ - name: orders[].activities[].paymentDeclined.regular | type: RegularPayment | description: Regular payment.
299
+ - name: orders[].activities[].paymentPending | type: PaymentPending | description: Details of a pending payment.
300
+ - name: orders[].activities[].paymentPending.paymentId | type: string | description: Payment GUID of payment associated with this activity
301
+ - ONE-OF:
302
+ - name: orders[].activities[].paymentPending.regular | type: RegularPayment | description: Regular payment.
303
+ - name: orders[].activities[].paymentRefundFailed | type: PaymentRefundFailed | description: Details of a failed payment refund. > **Note:** A single `refundInitiated` activity can result in multiple `paymentRefunded` or `paymentRefundFailed` activities. > In these cases, the `refundId` will be identical across the activities.
304
+ - name: orders[].activities[].paymentRefundFailed.payment | type: RefundedPayment | description: Details about the failed payment refund.
305
+ - name: orders[].activities[].paymentRefundFailed.payment.externalRefund | type: boolean | description: Whether refund was made externally and manually on the payment provider's side.
306
+ - name: orders[].activities[].paymentRefundFailed.payment.paymentId | type: string | description: Payment GUID.
307
+ - ONE-OF:
308
+ - name: orders[].activities[].paymentRefundFailed.payment.giftCard | type: GiftCardPaymentRefund | description: Gift card payment refund.
309
+ - name: orders[].activities[].paymentRefundFailed.payment.giftCard.amount | type: Price | description: Refund amount
310
+ - name: orders[].activities[].paymentRefundFailed.payment.giftCard.giftCardPaymentId | type: string | description: Gift card payment GUID
311
+ - name: orders[].activities[].paymentRefundFailed.payment.membership | type: MembershipPaymentRefund | description: Membership payment refund.
312
+ - name: orders[].activities[].paymentRefundFailed.payment.membership.membershipId | type: string | description: Membership GUID
313
+ - name: orders[].activities[].paymentRefundFailed.payment.regular | type: RegularPaymentRefund | description: Regular payment refund.
314
+ - name: orders[].activities[].paymentRefundFailed.payment.regular.amount | type: Price | description: Refund amount
315
+ - name: orders[].activities[].paymentRefundFailed.payment.regular.brand | type: string | description: Card issuer's brand.
316
+ - name: orders[].activities[].paymentRefundFailed.payment.regular.lastFourDigits | type: string | description: The last 4 digits of the card number.
317
+ - name: orders[].activities[].paymentRefundFailed.refundId | type: string | description: Refund GUID.
318
+ - name: orders[].activities[].paymentRefunded | type: PaymentRefunded | description: Details of a refunded payment. > **Note:** A single `refundInitiated` activity can result in multiple `paymentRefunded` or `paymentRefundFailed` activities. > In these cases, the `refundId` will be identical across the activities.
319
+ - name: orders[].activities[].paymentRefunded.payment | type: RefundedPayment | description: Details about the refunded payment.
320
+ - name: orders[].activities[].paymentRefunded.refundId | type: string | description: Refund GUID.
321
+ - name: orders[].activities[].receiptCreated | type: ReceiptCreated | description: Receipt was added for associated payment.
322
+ - name: orders[].activities[].receiptCreated.paymentId | type: string | description: Payment GUID of payment associated with this activity
323
+ - ONE-OF:
324
+ - name: orders[].activities[].receiptCreated.externalReceipt | type: ExternalReceipt | description: Receipt created by an external system.
325
+ - name: orders[].activities[].receiptCreated.externalReceipt.displayNumber | type: string | description: Display number of receipt
326
+ - name: orders[].activities[].receiptCreated.externalReceipt.receiptId | type: string | description: Receipt GUID
327
+ - name: orders[].activities[].receiptCreated.wixReceipt | type: WixReceipt | description: Receipt created by Wix
328
+ - name: orders[].activities[].receiptCreated.wixReceipt.displayNumber | type: string | description: Display number of receipt
329
+ - name: orders[].activities[].receiptCreated.wixReceipt.receiptId | type: string | description: Receipt GUID
330
+ - name: orders[].activities[].receiptSent | type: ReceiptSent | description: Receipt sent to customer.
331
+ - name: orders[].activities[].receiptSent.paymentId | type: string | description: Payment GUID of payment associated with this activity
332
+ - ONE-OF:
333
+ - name: orders[].activities[].receiptSent.externalReceipt | type: ExternalReceipt | description: Receipt created by an external system.
334
+ - name: orders[].activities[].receiptSent.wixReceipt | type: WixReceipt | description: Receipt created by Wix
335
+ - name: orders[].activities[].refundInitiated | type: RefundInitiated | description: Details of an initiated refund process. > **Note:** A single `refundInitiated` activity can result in multiple `paymentRefunded` or `paymentRefundFailed` activities. > In these cases, the `refundId` will be identical across the activities.
336
+ - name: orders[].activities[].refundInitiated.amount | type: Price | description: Refund amount.
337
+ - name: orders[].activities[].refundInitiated.payments | type: Array<RefundedPayment> | description: Details about the payments being refunded.
338
+ - name: orders[].activities[].refundInitiated.reason | type: string | description: Reason for refund.
339
+ - name: orders[].activities[].refundInitiated.refundId | type: string | description: Refund GUID.
340
+ - name: orders[].activities[].refundedAsStoreCredit | type: RefundedAsStoreCredit | description: Details of refund to store credit.
341
+ - name: orders[].activities[].refundedAsStoreCredit.amount | type: Price | description: Refund amount
342
+ - name: orders[].activities[].refundedAsStoreCredit.reason | type: string | description: Reason for refund
343
+ - name: orders[].activities[].savedPaymentMethod | type: SavedPaymentMethod | description: Details of the payment method saved for order
344
+ - name: orders[].activities[].savedPaymentMethod.description | type: string | description: Payment method description
345
+ - name: orders[].activities[].savedPaymentMethod.name | type: string | description: Payment method name
346
+ - name: orders[].additionalFees | type: Array<AdditionalFee> | description: Additional fees applied to the order.
347
+ - name: orders[].additionalFees[]._id | type: string | description: Additional fee's id.
348
+ - name: orders[].additionalFees[].code | type: string | description: Additional fee's unique code for future processing.
349
+ - name: orders[].additionalFees[].lineItemIds | type: Array<string> | description: Optional - Line items associated with this additional fee. If no `lineItemIds` are provided, the fee will be associated with the whole cart/checkout/order.
350
+ - name: orders[].additionalFees[].name | type: string | description: Name of additional fee.
351
+ - name: orders[].additionalFees[].price | type: Price | description: Additional fee's price.
352
+ - name: orders[].additionalFees[].priceAfterTax | type: Price | description: Additional fee's price after tax.
353
+ - name: orders[].additionalFees[].priceBeforeTax | type: Price | description: Additional fee's price before tax.
354
+ - name: orders[].additionalFees[].providerAppId | type: string | description: SPI implementer's `appId`.
355
+ - name: orders[].additionalFees[].taxInfo | type: LineItemTaxInfo | description: Represents all the relevant tax details for additional fee.
356
+ - name: orders[].additionalFees[].taxInfo.taxAmount | type: Price | description: Calculated tax, based on `taxable_amount` and `tax_rate`.
357
+ - name: orders[].additionalFees[].taxInfo.taxBreakdown | type: Array<LineItemTaxBreakdown> | description: Tax information for a line item.
358
+ - name: orders[].additionalFees[].taxInfo.taxBreakdown[].jurisdiction | type: string | description: Jurisdiction that taxes were calculated for. For example, "New York", or "Quebec".
359
+ - name: orders[].additionalFees[].taxInfo.taxBreakdown[].jurisdictionType | type: JurisdictionType | description: Type of jurisdiction that taxes were calculated for.
360
+ enum: CITY, COUNTRY, COUNTY, SPECIAL, STATE, UNDEFINED
361
+ - name: orders[].additionalFees[].taxInfo.taxBreakdown[].nonTaxableAmount | type: Price | description: Non-taxable amount of the line item price.
362
+ - name: orders[].additionalFees[].taxInfo.taxBreakdown[].rate | type: string | description: Tax rate used for this jurisdiction, as a decimal. For example, 10% tax is 0.1000.
363
+ - name: orders[].additionalFees[].taxInfo.taxBreakdown[].taxAmount | type: Price | description: Amount of tax calculated for this line item.
364
+ - name: orders[].additionalFees[].taxInfo.taxBreakdown[].taxName | type: string | description: The name of the tax against which this tax amount was calculated. For example, "NY State Sales Tax", "Quebec GST", etc. This name should be explicit enough to allow the merchant to understand what tax was calculated.
365
+ - name: orders[].additionalFees[].taxInfo.taxBreakdown[].taxType | type: string | description: The type of tax that was calculated. Depends on the jurisdiction's tax laws. For example, "Sales Tax", "Income Tax", "Value Added Tax", etc.
366
+ - name: orders[].additionalFees[].taxInfo.taxBreakdown[].taxableAmount | type: Price | description: Taxable amount of the line item price.
367
+ - name: orders[].additionalFees[].taxInfo.taxGroupId | type: string | description: Tax group GUID.
368
+ - name: orders[].additionalFees[].taxInfo.taxIncludedInPrice | type: boolean | description: Indicates whether the price already includes tax.
369
+ - name: orders[].additionalFees[].taxInfo.taxRate | type: string | description: Tax rate %, as a decimal point.
370
+ - name: orders[].additionalFees[].taxInfo.taxableAmount | type: Price | description: Amount for which tax is calculated.
371
+ - name: orders[].appliedDiscounts | type: Array<AppliedDiscount> | description: Applied discounts.
372
+ - name: orders[].appliedDiscounts[]._id | type: string | description: Discount id.
373
+ - name: orders[].appliedDiscounts[].discountType | type: DiscountType | description: Discount type. * `"GLOBAL"` - discount applies to entire order. * `"SPECIFIC-ITEMS"` - discount applies to specific items. * `"SHIPPING"` - discount applies to shipping. For example, free shipping.
374
+ enum: GLOBAL, SHIPPING, SPECIFIC_ITEMS
375
+ - ONE-OF:
376
+ - name: orders[].appliedDiscounts[].coupon | type: Coupon | description: Applied coupon info.
377
+ - name: orders[].appliedDiscounts[].coupon._id | type: string | description: Coupon GUID.
378
+ - name: orders[].appliedDiscounts[].coupon.amount | type: Price | description: Coupon value.
379
+ - name: orders[].appliedDiscounts[].coupon.code | type: string | description: Coupon code.
380
+ - name: orders[].appliedDiscounts[].coupon.name | type: string | description: Coupon name.
381
+ - name: orders[].appliedDiscounts[].discountRule | type: DiscountRule | description: Automatic Discount
382
+ - name: orders[].appliedDiscounts[].discountRule._id | type: string | description: Discount rule GUID
383
+ - name: orders[].appliedDiscounts[].discountRule.amount | type: Price | description: Discount value.
384
+ - name: orders[].appliedDiscounts[].discountRule.name | type: DiscountRuleName | description: Discount rule name
385
+ - name: orders[].appliedDiscounts[].discountRule.name.original | type: string | description: Original discount rule name (in site's default language).
386
+ - name: orders[].appliedDiscounts[].discountRule.name.translated | type: string | description: Translated discount rule name according to buyer language. Defaults to `original` when not provided.
387
+ - name: orders[].appliedDiscounts[].merchantDiscount | type: MerchantDiscount | description: Merchant discount.
388
+ - name: orders[].appliedDiscounts[].merchantDiscount.amount | type: Price | description: Discount amount.
389
+ - ONE-OF:
390
+ - name: orders[].appliedDiscounts[].merchantDiscount.description | type: string | description: Discount description as free text (optional).
391
+ - name: orders[].appliedDiscounts[].merchantDiscount.discountReason | type: DiscountReason | description: Pre-defined discount reason (optional). * `"ITEMS_EXCHANGE"` - exchange balance acquired as a result of items exchange.
392
+ enum: BILLING_ADJUSTMENT, EXCHANGED_ITEMS, UNSPECIFIED
393
+ - name: orders[].archived | type: boolean | description: Whether order is archived.
394
+ - name: orders[].attributionSource | type: AttributionSource | description: Order attribution source.
395
+ enum: FACEBOOK_ADS, UNSPECIFIED
396
+ - name: orders[].balanceSummary | type: BalanceSummary | description: Balance summary.
397
+ - name: orders[].balanceSummary.authorized | type: Price | description: Sum of all authorized payments.
398
+ - name: orders[].balanceSummary.balance | type: Balance | description: Current amount left to pay.
399
+ - name: orders[].balanceSummary.balance.amount | type: string | description: Balance amount. A negative `amount` represents the amount to be refunded. This can happen due to overcharging or the order being modified after a payment has been made.
400
+ - name: orders[].balanceSummary.balance.formattedAmount | type: string | description: Amount formatted with currency symbol.
401
+ - name: orders[].balanceSummary.chargeback | type: Price | description: Sum of all transaction chargebacks.
402
+ - name: orders[].balanceSummary.chargebackReversal | type: Price | description: Sum of all chargeback reversals.
403
+ - name: orders[].balanceSummary.paid | type: Price | description: Sum of all approved and successful payments. The value includes payments that have subsequently been fully or partially refunded.
404
+ - name: orders[].balanceSummary.pending | type: Price | description: Sum of all pending transactions.
405
+ - name: orders[].balanceSummary.pendingRefund | type: Price | description: Sum of all pending refund transactions.
406
+ - name: orders[].balanceSummary.refunded | type: Price | description: Sum of all successfully refunded payments.
407
+ - name: orders[].billingInfo | type: AddressWithContact | description: Billing address and contact details.
408
+ - name: orders[].billingInfo.address | type: Address | description: Address.
409
+ - name: orders[].billingInfo.address.addressLine1 | type: string | description: Main address line (usually street name and number).
410
+ - name: orders[].billingInfo.address.addressLine2 | type: string | description: Free text providing more detailed address info. Usually contains apt, suite, floor.
411
+ - name: orders[].billingInfo.address.city | type: string | description: City name.
412
+ - name: orders[].billingInfo.address.country | type: string | description: Two-letter country code in [ISO-3166 alpha-2](https://www.iso.org/obp/ui/#search/code/) format.
413
+ - name: orders[].billingInfo.address.countryFullname | type: string | description: Country's full name.
414
+ - name: orders[].billingInfo.address.location | type: AddressLocation | description: Geocode object containing latitude and longitude coordinates.
415
+ - name: orders[].billingInfo.address.location.latitude | type: number | description: Address latitude.
416
+ - name: orders[].billingInfo.address.location.longitude | type: number | description: Address longitude.
417
+ - name: orders[].billingInfo.address.postalCode | type: string | description: Postal or zip code.
418
+ - name: orders[].billingInfo.address.streetAddress | type: StreetAddress | description: Street address.
419
+ - name: orders[].billingInfo.address.streetAddress.name | type: string | description: Street name.
420
+ - name: orders[].billingInfo.address.streetAddress.number | type: string | description: Street number.
421
+ - name: orders[].billingInfo.address.subdivision | type: string | description: Code for a subdivision (such as state, prefecture, or province) in [ISO 3166-2](https://www.iso.org/standard/72483.html) format.
422
+ - name: orders[].billingInfo.address.subdivisionFullname | type: string | description: Subdivision full-name.
423
+ - name: orders[].billingInfo.contactDetails | type: FullAddressContactDetails | description: Contact details.
424
+ - name: orders[].billingInfo.contactDetails.company | type: string | description: Company name.
425
+ - name: orders[].billingInfo.contactDetails.firstName | type: string | description: First name.
426
+ - name: orders[].billingInfo.contactDetails.lastName | type: string | description: Last name.
427
+ - name: orders[].billingInfo.contactDetails.phone | type: string | description: Phone number.
428
+ - name: orders[].billingInfo.contactDetails.vatId | type: VatId | description: Tax information (for Brazil only). If GUID is provided, `vatId.type` must also be set, `UNSPECIFIED` is not allowed.
429
+ - name: orders[].billingInfo.contactDetails.vatId._id | type: string | description: Customer's tax GUID.
430
+ - name: orders[].billingInfo.contactDetails.vatId.type | type: VatType | description: Tax type. Supported values: + `CPF`: for individual tax payers + `CNPJ`: for corporations
431
+ enum:
432
+ CNPJ: CNPJ - for corporations
433
+ CPF: CPF - for individual tax payers.
434
+ UNSPECIFIED
435
+ - name: orders[].businessLocation | type: Location | description: Order Location
436
+ - name: orders[].businessLocation._id | type: string | description: Location GUID. Learn more about the [Wix Locations API](https://dev.wix.com/docs/rest/business-management/locations/introduction).
437
+ - name: orders[].businessLocation.name | type: string | description: Location name.
438
+ - name: orders[].buyerInfo | type: BuyerInfo | description: Buyer information.
439
+ - name: orders[].buyerInfo.contactId | type: string | description: Contact GUID. Auto-created if one does not yet exist. For more information, see [Contacts API](https://www.wix.com/velo/reference/wix-crm-backend/contacts/introduction).
440
+ - name: orders[].buyerInfo.email | type: string | description: Buyer email address.
441
+ - ONE-OF:
442
+ - name: orders[].buyerInfo.memberId | type: string | description: Member GUID (if site visitor is a site member).
443
+ - name: orders[].buyerInfo.visitorId | type: string | description: Visitor GUID (if site visitor is not a member).
444
+ - name: orders[].buyerLanguage | type: string | description: Language for communication with the buyer. Defaults to the site language. For a site that supports multiple languages, this is the language the buyer selected.
445
+ - name: orders[].buyerNote | type: string | description: [Buyer note](https://support.wix.com/en/article/wix-stores-viewing-buyer-notes) left by the customer.
446
+ - name: orders[].channelInfo | type: ChannelInfo | description: Information about the sales channel that submitted this order.
447
+ - name: orders[].channelInfo.externalOrderId | type: string | description: Reference to an order GUID from an external system.
448
+ - name: orders[].channelInfo.externalOrderUrl | type: string | description: URL to the order in the external system.
449
+ - name: orders[].channelInfo.type | type: ChannelType | description: Sales channel that submitted the order.
450
+ enum:
451
+ AMAZON: [Amazon shop](https://support.wix.com/en/article/wix-stores-connecting-and-setting-up-an-amazon-shop).
452
+ BACKOFFICE_MERCHANT: Wix merchant backoffice.
453
+ CLASS_PASS: [ClassPass sales channel](https://support.wix.com/en/article/wix-bookings-letting-clients-book-your-services-with-classpass).
454
+ EBAY: [eBay shop](https://support.wix.com/en/article/wix-stores-connecting-and-setting-up-an-ebay-shop).
455
+ ETSY: [Etsy sales channel](https://support.wix.com/en/article/wix-stores-request-adding-etsy-as-a-sales-channel).
456
+ FACEBOOK: [Facebook shop](https://support.wix.com/en/article/wix-stores-changes-to-facebook-shops).
457
+ FAIRE_COM: [Faire marketplace integration](https://support.wix.com/en/article/wix-stores-creating-a-faire-store-using-the-faire-integration-app).
458
+ GLOBAL_E: Global-E sales channel.
459
+ OTHER_PLATFORM: Other sales platform.
460
+ PAYPAL_AGENTIC_CHECKOUT: PayPal Agentic Checkout sales channel.
461
+ POS: [Point of sale solutions](https://support.wix.com/en/wix-mobile-pos-2196395).
462
+ TIKTOK: [TikTok sales channel](https://support.wix.com/en/article/wix-stores-request-adding-tiktok-as-a-sales-channel).
463
+ UNSPECIFIED: Unspecified sales channel. This value is not supported.
464
+ WEB: A web client.
465
+ WISH: Wish sales channel.
466
+ WIX_APP_STORE: [Wix Owner app](https://support.wix.com/article/wix-owner-app-an-overview).
467
+ WIX_INVOICES: Wix Invoices app in [your dashboard](https://www.wix.com/my-account/site-selector/?buttonText=Select%20Site&title=Select%20a%20Site&autoSelectOnSingleSite=true&actionUrl=https:%2F%2Fwww.wix.com%2Fdashboard%2F%7B%7BmetaSiteId%7D%7D%2Finvoices/settings/general-settings)
468
+ - name: orders[].checkoutId | type: string | description: Checkout GUID.
469
+ - name: orders[].createdBy | type: CreatedBy | description: GUID of the order's initiator.
470
+ - ONE-OF:
471
+ - name: orders[].createdBy.appId | type: string | description: App GUID - when the order was created by an external application.
472
+ - name: orders[].createdBy.memberId | type: string | description: Member GUID - when the order was created by a **logged in** site visitor.
473
+ - name: orders[].createdBy.userId | type: string | description: User GUID - when the order was created by a Wix user on behalf of a buyer. For example, via POS (point of service).
474
+ - name: orders[].createdBy.visitorId | type: string | description: Visitor GUID - when the order was created by a site visitor that was **not** logged in.
475
+ - name: orders[].currency | type: string | description: Currency used for the pricing of this order in [ISO-4217](https://en.wikipedia.org/wiki/ISO_4217#List_of_ISO_4217_currency_codes) format.
476
+ - name: orders[].currencyConversionDetails | type: CurrencyConversionDetails | description: Currency conversion details. For use with multi-currency sites.
477
+ - name: orders[].currencyConversionDetails.conversionRate | type: string | description: The rate used for converting the original currency to the currency used for payment.
478
+ - name: orders[].currencyConversionDetails.originalCurrency | type: string | description: Currency used for the pricing of this order, in [ISO-4217](https://en.wikipedia.org/wiki/ISO_4217#List_of_ISO_4217_currency_codes) format. This currency is used to calculate the pricing before conversion to the buyer's payment currency.
479
+ - name: orders[].customFields | type: Array<CustomField> | description: Custom fields.
480
+ - name: orders[].customFields[].title | type: string | description: Custom field title.
481
+ - name: orders[].customFields[].translatedTitle | type: string | description: Translated custom field title.
482
+ - name: orders[].customFields[].value | type: any | description: Custom field value.
483
+ - name: orders[].extendedFields | type: ExtendedFields | description: Custom field data for the order object. [Extended fields](https://dev.wix.com/docs/rest/articles/getting-started/extended-fields) must be configured in the app dashboard before they can be accessed with API calls.
484
+ - name: orders[].extendedFields.namespaces | type: Record<string, undefined> | description: Extended field data. Each key corresponds to the namespace of the app that created the extended fields. The value of each key is structured according to the schema defined when the extended fields were configured. You can only access fields for which you have the appropriate permissions. Learn more about [extended fields](https://dev.wix.com/docs/rest/articles/getting-started/extended-fields).
485
+ - name: orders[].fulfillmentStatus | type: FulfillmentStatus | description: Order fulfillment status.
486
+ enum:
487
+ FULFILLED: All of the order items are fulfilled or the order was manually marked as fulfilled. Orders without shipping info are fulfilled automatically.
488
+ NOT_FULFILLED: None of the order items are fulfilled or the order was manually marked as unfulfilled.
489
+ PARTIALLY_FULFILLED: Some, but not all, of the order items are fulfilled.
490
+ - name: orders[].lineItems | type: Array<OrderLineItem> | description: Order line items.
491
+ - name: orders[].lineItems[]._id | type: string | description: Line item GUID.
492
+ - name: orders[].lineItems[].catalogReference | type: CatalogReference | description: Catalog and item reference. Holds GUIDs for the item and the catalog it came from, as well as further optional info. Optional for custom line items, which don't trigger the Catalog service plugin.
493
+ - name: orders[].lineItems[].catalogReference.appId | type: string | description: GUID of the app providing the catalog. You can get your app's GUID from its page in the [app dashboard](https://dev.wix.com/dc3/my-apps/). For items from Wix catalogs, the following values always apply: + Wix Stores: `"215238eb-22a5-4c36-9e7b-e7c08025e04e"` + Wix Bookings: `"13d21c63-b5ec-5912-8397-c3a5ddb27a97"` + Wix Restaurants: `"9a5d83fd-8570-482e-81ab-cfa88942ee60"`
494
+ - name: orders[].lineItems[].catalogReference.catalogItemId | type: string | description: GUID of the item within the catalog it belongs to.
495
+ - name: orders[].lineItems[].catalogReference.options | type: Record<string, any> | description: Additional item details in key:value pairs. Use this optional field to provide more specificity with item selection. The `options` field values differ depending on which catalog is providing the items. For products and variants from your Wix Stores catalog, learn more about [eCommerce integration](https://www.wix.com/velo/reference/wix-stores-backend/ecommerce-integration).
496
+ - name: orders[].lineItems[].depositAmount | type: Price | description: Item's price amount to be charged during checkout. Relevant for items with a `paymentOption` value of `"DEPOSIT_ONLINE"`.
497
+ - name: orders[].lineItems[].descriptionLines | type: Array<DescriptionLine> | description: Line item description lines. Used for display purposes for the cart, checkout and order.
498
+ - name: orders[].lineItems[].descriptionLines[].name | type: DescriptionLineName | description: Description line name.
499
+ - name: orders[].lineItems[].descriptionLines[].name.original | type: string | description: Description line name in the site's default language as defined in the [request envelope](https://dev.wix.com/docs/build-apps/develop-your-app/frameworks/self-hosting/supported-extensions/backend-extensions/add-self-hosted-service-plugin-extensions#request-envelope).
500
+ - name: orders[].lineItems[].descriptionLines[].name.translated | type: string | description: Description line name translated into the buyer's language. Default: Same as `original`.
501
+ - ONE-OF:
502
+ - name: orders[].lineItems[].descriptionLines[].colorInfo | type: Color | description: Description line color value.
503
+ - name: orders[].lineItems[].descriptionLines[].colorInfo.code | type: string | description: HEX or RGB color code for display.
504
+ - name: orders[].lineItems[].descriptionLines[].colorInfo.original | type: string | description: Description line color name in the site's default language as defined in the [request envelope](https://dev.wix.com/docs/build-apps/develop-your-app/frameworks/self-hosting/supported-extensions/backend-extensions/add-self-hosted-service-plugin-extensions#request-envelope).
505
+ - name: orders[].lineItems[].descriptionLines[].colorInfo.translated | type: string | description: Description line color name translated into the buyer's language. Default: Same as `original`.
506
+ - name: orders[].lineItems[].descriptionLines[].plainText | type: PlainTextValue | description: Description line plain text value.
507
+ - name: orders[].lineItems[].descriptionLines[].plainText.original | type: string | description: Description line plain text value in the site's default language as defined in the [request envelope](https://dev.wix.com/docs/build-apps/develop-your-app/frameworks/self-hosting/supported-extensions/backend-extensions/add-self-hosted-service-plugin-extensions#request-envelope).
508
+ - name: orders[].lineItems[].descriptionLines[].plainText.translated | type: string | description: Description line plain text value translated into the buyer's language. Default: Same as `original`.
509
+ - ONE-OF:
510
+ - name: orders[].lineItems[].digitalFile | type: DigitalFile | description: Digital file identifier, relevant only for items with type DIGITAL.
511
+ - name: orders[].lineItems[].digitalFile.expirationDate | type: Date | description: Link expiration time and date.
512
+ - name: orders[].lineItems[].digitalFile.fileId | type: string | description: GUID of the secure file in media.
513
+ - name: orders[].lineItems[].digitalFile.link | type: string | description: Link will exist after the digital links have been generated on the order.
514
+ - name: orders[].lineItems[].extendedFields | type: ExtendedFields | description: Custom extended fields for the line item object. [Extended fields](https://dev.wix.com/docs/rest/articles/getting-started/extended-fields) must be configured in the app dashboard before they can be accessed with API calls.
515
+ - name: orders[].lineItems[].fulfillerId | type: string | description: Fulfiller GUID. Field is empty when the line item is self-fulfilled. To get fulfillment information, pass the order GUID to [List Fulfillments For Single Order](https://www.wix.com/velo/reference/wix-ecom-backend/orderfulfillments/listfulfillmentsforsingleorder).
516
+ - name: orders[].lineItems[].image | type: string | description: Line item image.
517
+ - name: orders[].lineItems[].itemType | type: ItemType | description: Item type. Either a preset type or custom.
518
+ - ONE-OF:
519
+ - name: orders[].lineItems[].itemType.custom | type: string | description: Custom item type. When none of the preset types are suitable, specifies the custom type.
520
+ - name: orders[].lineItems[].itemType.preset | type: ItemTypePreset | description: Preset item type.
521
+ enum: DIGITAL, GIFT_CARD, PHYSICAL, SERVICE, UNRECOGNISED
522
+ - name: orders[].lineItems[].locations | type: Array<LocationAndQuantity> | description: Line item locations. The location's total quantity must not exceed the line item quantity.
523
+ - name: orders[].lineItems[].locations[]._id | type: string | description: Location id in the associated owner app.
524
+ - name: orders[].lineItems[].locations[].name | type: string | description: Location name.
525
+ - name: orders[].lineItems[].locations[].quantity | type: number | description: Quantity for specific location.
526
+ - name: orders[].lineItems[].modifierGroups | type: Array<ModifierGroup> | description: Modifier groups that were added to the item.
527
+ - name: orders[].lineItems[].modifierGroups[]._id | type: string | description: Modifier group GUID.
528
+ - name: orders[].lineItems[].modifierGroups[].modifiers | type: Array<ItemModifier> | description: List of modifiers in this group.
529
+ - name: orders[].lineItems[].modifierGroups[].modifiers[]._id | type: string | description: Modifier GUID.
530
+ - name: orders[].lineItems[].modifierGroups[].modifiers[].details | type: TranslatableString | description: Additional details.
531
+ - name: orders[].lineItems[].modifierGroups[].modifiers[].details.original | type: string | description: __Required.__ String in the site's default language as defined in the [request envelope](https://dev.wix.com/docs/build-apps/develop-your-app/frameworks/self-hosting/supported-extensions/backend-extensions/add-self-hosted-service-plugin-extensions#request-envelope). Min: 1 character. Max: 200 characters.
532
+ - name: orders[].lineItems[].modifierGroups[].modifiers[].details.translated | type: string | description: String translated into the buyer's language. Min: 1 character. Max: 400 characters. Default: Same as `original`.
533
+ - name: orders[].lineItems[].modifierGroups[].modifiers[].label | type: TranslatableString | description: Primary display label for the modifier.
534
+ - name: orders[].lineItems[].modifierGroups[].modifiers[].price | type: Price | description: The price of the modifier.
535
+ - name: orders[].lineItems[].modifierGroups[].modifiers[].quantity | type: number | description: The quantity of this modifier.
536
+ - name: orders[].lineItems[].modifierGroups[].name | type: TranslatableString | description: Modifier group name.
537
+ - name: orders[].lineItems[].paymentOption | type: PaymentOptionType | description: Type of selected payment option for current item. Default: `FULL_PAYMENT_ONLINE`
538
+ enum:
539
+ DEPOSIT_ONLINE: Partial payment to be paid upfront during checkout. The initial amount to be paid for each line item is specified in `depositAmount`.
540
+ FULL_PAYMENT_OFFLINE: The entire payment for this item happens after checkout. For example, when using cash, check, or other offline payment methods.
541
+ FULL_PAYMENT_ONLINE: The entire payment for this item happens as part of the checkout.
542
+ MEMBERSHIP: Payment for this item is done by charging a membership. Any remaining amount not covered by the membership, such as item modifiers, is paid online.
543
+ MEMBERSHIP_OFFLINE: Payment for this item can only be done by charging a membership and must be manually redeemed in the dashboard by the site admin. When selected, `price` is `0`.
544
+ MEMBERSHIP_ONLINE_WITH_OFFLINE_REMAINDER: Item price is charged to online membership. Any remaining amount not covered by the membership, such as item modifiers, is paid offline.
545
+ - name: orders[].lineItems[].physicalProperties | type: PhysicalProperties | description: Physical properties of the item. When relevant, contains information such as SKU and item weight.
546
+ - name: orders[].lineItems[].physicalProperties.shippable | type: boolean | description: Whether this line item is shippable.
547
+ - name: orders[].lineItems[].physicalProperties.sku | type: string | description: Stock-keeping unit. Learn more about [SKUs](https://www.wix.com/encyclopedia/definition/stock-keeping-unit-sku).
548
+ - name: orders[].lineItems[].physicalProperties.weight | type: number | description: Line item weight. Measurement unit matches the weight unit specified in `weightUnit` in the request.
549
+ - name: orders[].lineItems[].price | type: Price | description: Line item price after line item discounts for display purposes.
550
+ - name: orders[].lineItems[].priceBeforeDiscounts | type: Price | description: Line item price before line item discounts for display purposes. Defaults to `price` when not provided.
551
+ - name: orders[].lineItems[].priceDescription | type: PriceDescription | description: Additional description for the price. For example, when price is 0 but additional details about the actual price are needed - "Starts at $67".
552
+ - name: orders[].lineItems[].priceDescription.original | type: string | description: __Required.__ Price description in the site's default language as defined in the [request envelope](https://dev.wix.com/docs/build-apps/develop-your-app/frameworks/self-hosting/supported-extensions/backend-extensions/add-self-hosted-service-plugin-extensions#request-envelope).
553
+ - name: orders[].lineItems[].priceDescription.translated | type: string | description: Price description translated into the buyer's language. Default: Same as `original`.
554
+ - name: orders[].lineItems[].priceUndetermined | type: boolean | description: Whether the price is not yet defined, and will be updated after the order is created. Default: `false`
555
+ - name: orders[].lineItems[].productName | type: ProductName | description: Item name. + Stores - `product.name` + Bookings - `service.info.name` + Events - `ticket.name`
556
+ - name: orders[].lineItems[].quantity | type: number | description: Line item quantity.
557
+ - name: orders[].lineItems[].refundQuantity | type: number | description: Number of items that were refunded.
558
+ - name: orders[].lineItems[].restockQuantity | type: number | description: Number of items restocked.
559
+ - name: orders[].lineItems[].subscriptionInfo | type: SubscriptionInfo | description: Subscription info.
560
+ - name: orders[].lineItems[].subscriptionInfo._id | type: string | description: Subscription GUID.
561
+ - name: orders[].lineItems[].subscriptionInfo.chargesDescription | type: string | description: Description of the charges that will be applied for subscription.
562
+ - name: orders[].lineItems[].subscriptionInfo.cycleNumber | type: number | description: Subscription cycle. For example, if this order is for the 3rd cycle of a subscription, value will be `3`.
563
+ - name: orders[].lineItems[].subscriptionInfo.subscriptionSettings | type: SubscriptionSettings | description: Subscription detailed information.
564
+ - name: orders[].lineItems[].subscriptionInfo.subscriptionSettings.autoRenewal | type: boolean | description: Whether subscription is renewed automatically at the end of each period.
565
+ - name: orders[].lineItems[].subscriptionInfo.subscriptionSettings.billingCycles | type: number | description: Number of billing cycles before subscription ends. Ignored if `autoRenewal: true`.
566
+ - name: orders[].lineItems[].subscriptionInfo.subscriptionSettings.enableCustomerCancellation | type: boolean | description: Whether to allow the customer to cancel the subscription.
567
+ - name: orders[].lineItems[].subscriptionInfo.subscriptionSettings.freeTrialPeriod | type: FreeTrialPeriod | description: Period until first cycle starts. If None => no free trial
568
+ - name: orders[].lineItems[].subscriptionInfo.subscriptionSettings.freeTrialPeriod.frequency | type: SubscriptionFrequency | description: Frequency of period. Values: DAY, WEEK, MONTH, YEAR
569
+ enum: DAY, MONTH, UNDEFINED, WEEK, YEAR
570
+ - name: orders[].lineItems[].subscriptionInfo.subscriptionSettings.freeTrialPeriod.interval | type: number | description: interval of period
571
+ - name: orders[].lineItems[].subscriptionInfo.subscriptionSettings.frequency | type: SubscriptionFrequency | description: Frequency of recurring payment.
572
+ - name: orders[].lineItems[].subscriptionInfo.subscriptionSettings.interval | type: number | description: Interval of recurring payment.
573
+ - name: orders[].lineItems[].taxInfo | type: LineItemTaxInfo | description: Represents all the relevant tax details for a specific line item.
574
+ - name: orders[].lineItems[].taxableAddress | type: TaxableAddress | description: Address used for tax calculation.
575
+ - ONE-OF:
576
+ - name: orders[].lineItems[].taxableAddress.addressType | type: TaxableAddressType | description: taxable address type. if this field is selected, the address is automatically resolved, and the tax is calculated accordingly.
577
+ enum: BILLING, BUSINESS, SHIPPING, UNKNOWN_TAXABLE_ADDRESS
578
+ - name: orders[].lineItems[].totalDiscount | type: Price | description: Total discount for this line item's entire quantity.
579
+ - name: orders[].lineItems[].totalPriceAfterTax | type: Price | description: Total price after all discounts and tax.
580
+ - name: orders[].lineItems[].totalPriceBeforeTax | type: Price | description: Total price after discounts, and before tax.
581
+ - name: orders[].number | type: string | description: Order number displayed in the site owner's dashboard (auto-generated).
582
+ - name: orders[].payAfterFreeTrial | type: PriceSummary | description: Pay after free trial price summary. Price summary that should be paid for subscriptions after free trial period.
583
+ - name: orders[].payAfterFreeTrial.discount | type: Price | description: Total calculated discount value.
584
+ - name: orders[].payAfterFreeTrial.shipping | type: Price | description: Total shipping price, before discounts and before tax.
585
+ - name: orders[].payAfterFreeTrial.subtotal | type: Price | description: Subtotal of all the line items, before discounts and before tax.
586
+ - name: orders[].payAfterFreeTrial.tax | type: Price | description: Total tax on this order.
587
+ - name: orders[].payAfterFreeTrial.total | type: Price | description: Order’s total price after discounts and tax.
588
+ - name: orders[].payAfterFreeTrial.totalAdditionalFees | type: Price | description: Total price of additional fees before tax.
589
+ - name: orders[].paymentStatus | type: PaymentStatus | description: Order payment status.
590
+ enum:
591
+ CANCELED: One or more payments canceled.
592
+ DECLINED: One or more payments declined.
593
+ FULLY_REFUNDED: Order fully refunded. Refund amount equals total price. See `order.balanceSummary` for more details.
594
+ NOT_PAID: `NOT_PAID` can apply to an order made online, but not yet paid. In such cases `order.status` will be `INITIALIZED`. This status also applies when an offline order needs to be manually marked as paid. In such cases `order.status` will be `APPROVED`.
595
+ PAID: All required payments associated with this order are paid.
596
+ PARTIALLY_PAID: At least one payment received and approved, but it covers less than the order's total price. See `order.balanceSummary` for more details.
597
+ PARTIALLY_REFUNDED: Order partially refunded, but the refunded amount is less than the order's total price. See `order.balanceSummary` for more details.
598
+ PENDING: All payments pending. This can happen with two-step payments, when a payment requires manual review, or when a payment is in progress and will be concluded shortly. Learn more about [pending orders](https://support.wix.com/en/article/pending-orders).
599
+ PENDING_MERCHANT: Payment received, but not yet confirmed by the payment provider. In most cases, when a payment provider is holding payment it's because setup hasn't been successfully completed by the merchant/site owner. To solve this, the merchant/site owner should log in to the payment provider's dashboard and make sure their account is set up correctly, or contact their support for further assistance.
600
+ UNSPECIFIED
601
+ - name: orders[].priceSummary | type: PriceSummary | description: Order price summary.
602
+ - name: orders[].purchaseFlowId | type: string | description: Persistent GUID that correlates between the various eCommerce elements: cart, checkout, and order.
603
+ - name: orders[].purchasedDate | type: Date | description: Date and time the order was originally purchased in [ISO-8601](https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations) format. Used for migration from external systems.
604
+ - name: orders[].recipientInfo | type: AddressWithContact | description: Order recipient address and contact details. This field may differ from the address in `shippingInfo.logistics` when: + The chosen shipping option is pickup point or store pickup. + No shipping option is selected.
605
+ - name: orders[].seenByAHuman | type: boolean | description: Whether a human has seen the order. Set when an order is clicked on in the dashboard.
606
+ - name: orders[].shippingInfo | type: V1ShippingInformation | description: Shipping info and selected shipping option details.
607
+ - name: orders[].shippingInfo.carrierId | type: string | description: App Def Id of external provider which was a source of shipping info
608
+ - name: orders[].shippingInfo.code | type: string | description: Unique code (or GUID) of selected shipping option. For example, `"usps_std_overnight"`.
609
+ - name: orders[].shippingInfo.cost | type: ShippingPrice | description: Shipping costs.
610
+ - name: orders[].shippingInfo.cost.discount | type: Price | description: Shipping discount before tax.
611
+ - name: orders[].shippingInfo.cost.price | type: Price | description: Shipping price for display purposes.
612
+ - name: orders[].shippingInfo.cost.taxInfo | type: LineItemTaxInfo | description: Represents all the relevant tax details for a shipping.
613
+ - name: orders[].shippingInfo.cost.totalPriceAfterTax | type: Price | description: Shipping price after all discounts (if any exist), and after tax.
614
+ - name: orders[].shippingInfo.cost.totalPriceBeforeTax | type: Price | description: Total price of shipping after discounts (when relevant), and before tax.
615
+ - name: orders[].shippingInfo.logistics | type: DeliveryLogistics | description: Shipping logistics.
616
+ - name: orders[].shippingInfo.logistics.deliveryTime | type: string | description: Expected delivery time in free text. For example, `"3-5 business days"`.
617
+ - name: orders[].shippingInfo.logistics.deliveryTimeSlot | type: DeliveryTimeSlot | description: Expected delivery time.
618
+ - name: orders[].shippingInfo.logistics.deliveryTimeSlot.from | type: Date | description: Delivery slot starting time.
619
+ - name: orders[].shippingInfo.logistics.deliveryTimeSlot.to | type: Date | description: Delivery slot ending time.
620
+ - name: orders[].shippingInfo.logistics.instructions | type: string | description: Instructions for carrier. For example, `"Please knock on the door. If unanswered, please call contact number. Thanks."`.
621
+ - ONE-OF:
622
+ - name: orders[].shippingInfo.logistics.pickupDetails | type: PickupDetails | description: Pickup details.
623
+ - name: orders[].shippingInfo.logistics.pickupDetails.address | type: PickupAddress | description: Pickup address.
624
+ - name: orders[].shippingInfo.logistics.pickupDetails.address.addressLine1 | type: string | description: Main address line (usually street name and number).
625
+ - name: orders[].shippingInfo.logistics.pickupDetails.address.addressLine2 | type: string | description: Free text providing more detailed address info. Usually contains apt, suite, floor.
626
+ - name: orders[].shippingInfo.logistics.pickupDetails.address.city | type: string | description: City name.
627
+ - name: orders[].shippingInfo.logistics.pickupDetails.address.country | type: string | description: Two-letter country code in [ISO-3166 alpha-2](https://www.iso.org/obp/ui/#search/code/) format.
628
+ - name: orders[].shippingInfo.logistics.pickupDetails.address.countryFullname | type: string | description: Country's full name.
629
+ - name: orders[].shippingInfo.logistics.pickupDetails.address.postalCode | type: string | description: Postal or zip code.
630
+ - name: orders[].shippingInfo.logistics.pickupDetails.address.streetAddress | type: StreetAddress | description: Street address object, with number, name, and apartment number in separate fields.
631
+ - name: orders[].shippingInfo.logistics.pickupDetails.address.subdivision | type: string | description: Code for a subdivision (such as state, prefecture, or province) in [ISO 3166-2](https://www.iso.org/standard/72483.html) format.
632
+ - name: orders[].shippingInfo.logistics.pickupDetails.address.subdivisionFullname | type: string | description: Subdivision full-name.
633
+ - name: orders[].shippingInfo.logistics.pickupDetails.pickupMethod | type: PickupMethod | description: Pickup method
634
+ enum: PICKUP_POINT, STORE_PICKUP, UNKNOWN_METHOD
635
+ - name: orders[].shippingInfo.logistics.shippingDestination | type: AddressWithContact | description: Shipping address and contact details.
636
+ - name: orders[].shippingInfo.region | type: ShippingRegion | description: Shipping region.
637
+ - name: orders[].shippingInfo.region.name | type: string | description: Name of shipping region. For example, `"Metropolitan London"`, or `"Outer Melbourne suburbs"`.
638
+ - name: orders[].shippingInfo.title | type: string | description: Shipping option title. For example, `"USPS Standard Overnight Delivery"`, `"Standard"` or `"First-Class Package International"`.
639
+ - name: orders[].siteLanguage | type: string | description: Site language in which original values are shown.
640
+ - name: orders[].status | type: OrderStatus | description: Order status.
641
+ enum:
642
+ APPROVED: Order approved. This happens when either an online payment is received **or** when `order.priceSummary.total = 0` (a zero-total order). Offline orders (cash payment) are automatically approved.
643
+ CANCELED: Order canceled by the user.
644
+ INITIALIZED: Order created, but not yet approved or canceled.
645
+ PENDING: Order pending.
646
+ REJECTED: Order rejected. This happens when pending payments fail.
647
+ - name: orders[].tags | type: Tags | description: Order tags. [Tags](https://dev.wix.com/docs/rest/business-management/tags/introduction) are labels attached to entities, allowing for flexible categorization and data management.
648
+ - name: orders[].tags.privateTags | type: TagList | description: Tags that require an additional permission in order to access them, normally not given to site members or visitors.
649
+ - name: orders[].tags.privateTags.tagIds | type: Array<string> | description: List of tag GUIDs
650
+ - name: orders[].tags.tags | type: TagList | description: Tags that are exposed to anyone who has access to the labeled entity itself, including site members and visitors.
651
+ - name: orders[].taxIncludedInPrices | type: boolean | description: Whether tax is included in line item prices.
652
+ - name: orders[].taxInfo | type: OrderTaxInfo | description: Tax information.
653
+ - name: orders[].taxInfo.taxBreakdown | type: Array<OrderTaxBreakdown> | description: The summary of the tax breakdown for all the line items. It will hold for each tax name, the aggregated tax amount paid for it and the tax rate.
654
+ - name: orders[].taxInfo.taxBreakdown[].aggregatedTaxAmount | type: Price | description: The sum of all the tax from line items that calculated by the tax identifiers.
655
+ - name: orders[].taxInfo.taxBreakdown[].jurisdiction | type: string | description: The name of the jurisdiction in which this tax detail applies.
656
+ - name: orders[].taxInfo.taxBreakdown[].jurisdictionType | type: JurisdictionType | description: The type of the jurisdiction in which this tax detail applies (e.g. Country,State,County,City,Special).
657
+ - name: orders[].taxInfo.taxBreakdown[].rate | type: string | description: The rate at which this tax detail was calculated.
658
+ - name: orders[].taxInfo.taxBreakdown[].taxName | type: string | description: The name of the tax against which this tax amount was calculated.
659
+ - name: orders[].taxInfo.taxBreakdown[].taxType | type: string | description: The type of tax that was calculated. Depends on the company's nexus settings as well as the jurisdiction's tax laws.
660
+ - name: orders[].taxInfo.taxExempt | type: boolean | description: Whether the order is exempt from tax calculations. Default: `false`
661
+ - name: orders[].taxInfo.totalTax | type: Price | description: Calculated tax, added from line items.
662
+ - name: orders[].weightUnit | type: WeightUnit | description: Weight measurement unit - defaults to site's weight unit.
663
+ enum:
664
+ KG: Kilograms.
665
+ LB: Pounds.
666
+ UNSPECIFIED_WEIGHT_UNIT: Weight unit can't be classified due to an error.
667
+
668
+ ```
669
+ </type_definition>
670
+ </ecom_orders_searchOrders>