@wix/ditto-codegen-public 1.0.211 → 1.0.213
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.
- package/dist/out.js +23666 -23769
- package/package.json +2 -2
- package/dist/docs-output/api-docs/bookings-bookings-onBookingCanceled-doc.txt +0 -169
- package/dist/docs-output/api-docs/bookings-bookings-onBookingCreated-doc.txt +0 -154
- package/dist/docs-output/api-docs/crm-contacts-onContactCreated-doc.txt +0 -99
- package/dist/docs-output/api-docs/crm-contacts-onContactDeleted-doc.txt +0 -58
- package/dist/docs-output/api-docs/crm-contacts-onContactUpdated-doc.txt +0 -99
- package/dist/docs-output/api-docs/data-items-get-doc.txt +0 -105
- package/dist/docs-output/api-docs/data-items-insert-doc.txt +0 -247
- package/dist/docs-output/api-docs/data-items-onDataItemCreated-doc.txt +0 -61
- package/dist/docs-output/api-docs/data-items-onDataItemDeleted-doc.txt +0 -58
- package/dist/docs-output/api-docs/data-items-onDataItemUpdated-doc.txt +0 -61
- package/dist/docs-output/api-docs/data-items-query-doc.txt +0 -514
- package/dist/docs-output/api-docs/data-items-remove-doc.txt +0 -130
- package/dist/docs-output/api-docs/data-items-update-doc.txt +0 -436
- package/dist/docs-output/api-docs/ecom-cart-addToCart-doc.txt +0 -398
- package/dist/docs-output/api-docs/ecom-cart-createCart-doc.txt +0 -429
- package/dist/docs-output/api-docs/ecom-cart-createCheckout-doc.txt +0 -149
- package/dist/docs-output/api-docs/ecom-cart-deleteCart-doc.txt +0 -92
- package/dist/docs-output/api-docs/ecom-cart-getCart-doc.txt +0 -284
- package/dist/docs-output/api-docs/ecom-cart-onCartCreated-doc.txt +0 -97
- package/dist/docs-output/api-docs/ecom-cart-onCartUpdated-doc.txt +0 -97
- package/dist/docs-output/api-docs/ecom-cart-removeLineItemsFromCart-doc.txt +0 -292
- package/dist/docs-output/api-docs/ecom-cart-updateCart-doc.txt +0 -442
- package/dist/docs-output/api-docs/ecom-checkout-addToCheckout-doc.txt +0 -622
- package/dist/docs-output/api-docs/ecom-checkout-createCheckout-doc.txt +0 -878
- package/dist/docs-output/api-docs/ecom-checkout-getCheckout-doc.txt +0 -494
- package/dist/docs-output/api-docs/ecom-checkout-onCheckoutCompleted-doc.txt +0 -151
- package/dist/docs-output/api-docs/ecom-checkout-onCheckoutCreated-doc.txt +0 -150
- package/dist/docs-output/api-docs/ecom-checkout-onCheckoutUpdated-doc.txt +0 -150
- package/dist/docs-output/api-docs/ecom-checkout-removeLineItemsFromCheckout-doc.txt +0 -499
- package/dist/docs-output/api-docs/ecom-checkout-updateCheckout-doc.txt +0 -730
- package/dist/docs-output/api-docs/ecom-currentCart-getCurrentCart-doc.txt +0 -249
- package/dist/docs-output/api-docs/ecom-currentCart-updateCurrentCart-doc.txt +0 -413
- package/dist/docs-output/api-docs/ecom-orders-bulkUpdateOrders-doc.txt +0 -988
- package/dist/docs-output/api-docs/ecom-orders-cancelOrder-doc.txt +0 -608
- package/dist/docs-output/api-docs/ecom-orders-getOrder-doc.txt +0 -625
- package/dist/docs-output/api-docs/ecom-orders-onOrderCreated-doc.txt +0 -245
- package/dist/docs-output/api-docs/ecom-orders-onOrderUpdated-doc.txt +0 -244
- package/dist/docs-output/api-docs/ecom-orders-searchOrders-doc.txt +0 -670
- package/dist/docs-output/api-docs/ecom-orders-updateOrder-doc.txt +0 -818
- package/dist/docs-output/api-docs/search-wixSiteSearch-search-doc.txt +0 -162
- package/dist/docs-output/api-docs/stores-collections-addProductsToCollection-doc.txt +0 -86
- package/dist/docs-output/api-docs/stores-collections-createCollection-doc.txt +0 -108
- package/dist/docs-output/api-docs/stores-collections-getCollection-doc.txt +0 -102
- package/dist/docs-output/api-docs/stores-collections-queryCollections-doc.txt +0 -209
- package/dist/docs-output/api-docs/stores-collections-removeProductsFromCollection-doc.txt +0 -86
- package/dist/docs-output/api-docs/stores-collections-updateCollection-doc.txt +0 -110
- package/dist/docs-output/api-docs/stores-inventory-queryInventory-doc.txt +0 -98
- package/dist/docs-output/api-docs/stores-inventory-updateInventoryVariants-doc.txt +0 -249
- package/dist/docs-output/api-docs/stores-inventoryItemsV3-queryInventoryItems-doc.txt +0 -236
- package/dist/docs-output/api-docs/stores-inventoryItemsV3-updateInventoryItem-doc.txt +0 -139
- package/dist/docs-output/api-docs/stores-productsV3-createProduct-doc.txt +0 -1697
- package/dist/docs-output/api-docs/stores-productsV3-deleteProduct-doc.txt +0 -73
- package/dist/docs-output/api-docs/stores-productsV3-getProduct-doc.txt +0 -933
- package/dist/docs-output/api-docs/stores-productsV3-onProductCreated-doc.txt +0 -794
- package/dist/docs-output/api-docs/stores-productsV3-onProductDeleted-doc.txt +0 -794
- package/dist/docs-output/api-docs/stores-productsV3-onProductUpdated-doc.txt +0 -794
- package/dist/docs-output/api-docs/stores-productsV3-queryProducts-doc.txt +0 -1051
- package/dist/docs-output/api-docs/stores-productsV3-searchProducts-doc.txt +0 -1144
- package/dist/docs-output/api-docs/stores-productsV3-updateProduct-doc.txt +0 -1737
- package/dist/docs-output/api-docs/stores-readOnlyVariantsV3-queryVariants-doc.txt +0 -290
- package/dist/docs-output/api-docs/stores-readOnlyVariantsV3-searchVariants-doc.txt +0 -353
- package/dist/docs-output/service-plugins/ecom-additional-fees-doc.txt +0 -411
- package/dist/docs-output/service-plugins/ecom-catalog-doc.txt +0 -460
- package/dist/docs-output/service-plugins/ecom-custom-triggers-doc.txt +0 -149
- package/dist/docs-output/service-plugins/ecom-gift-vouchers-provider-doc.txt +0 -169
- package/dist/docs-output/service-plugins/ecom-payment-settings-doc.txt +0 -2368
- package/dist/docs-output/service-plugins/ecom-recommendations-provider-doc.txt +0 -147
- package/dist/docs-output/service-plugins/ecom-shipping-rates-doc.txt +0 -352
- package/dist/docs-output/service-plugins/ecom-tax-calculation-provider-doc.txt +0 -244
- package/dist/docs-output/service-plugins/ecom-validations-doc.txt +0 -579
|
@@ -1,460 +0,0 @@
|
|
|
1
|
-
|
|
2
|
-
<catalog_service_plugin>
|
|
3
|
-
<purpose>Base URI which Wix eCommerce will call to access Catalog service plugin endpoints. For example, to call the Get Catalog Items endpoint at `https://my-external-catalog.com/get-catalog-items`, the base URI you provide here is `https://my-external-catalog.com`.</purpose>
|
|
4
|
-
<use_cases>
|
|
5
|
-
- Handle catalogReferences: Catalog reference details for the items to retrieve, including quantity of each item.
|
|
6
|
-
- Handle currency: Currency to return item prices in, in [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) format. For example, `USD` or `EUR`.
|
|
7
|
-
|
|
8
|
-
By default, Wix sends the currency specified in the site's settings.
|
|
9
|
-
- Handle weightUnit: Weight measurement unit.
|
|
10
|
-
|
|
11
|
-
By default, Wix sends the weight unit specified in the site's settings.
|
|
12
|
-
</use_cases>
|
|
13
|
-
<required_handlers>
|
|
14
|
-
- getCatalogItems() - Handler to process: Currency to return item prices in, in [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) format. For example, `USD` or `EUR`.
|
|
15
|
-
|
|
16
|
-
By default, Wix sends the currency specified in the site's settings.
|
|
17
|
-
</required_handlers>
|
|
18
|
-
<import>import { catalog } from '@wix/ecom/service-plugins'</import>
|
|
19
|
-
<types>
|
|
20
|
-
|
|
21
|
-
**AdditionalFee**
|
|
22
|
-
Properties:
|
|
23
|
-
- code: string - Additional fee's unique code or ID.
|
|
24
|
-
|
|
25
|
-
minLength 1, maxLength 100
|
|
26
|
-
- name: string - Additional fee's name.
|
|
27
|
-
|
|
28
|
-
Max: 50 characters
|
|
29
|
-
|
|
30
|
-
minLength 1, maxLength 50
|
|
31
|
-
- price: string - Total additional fees. This `price` does not include any taxes that may apply to these additional fees.
|
|
32
|
-
|
|
33
|
-
decimalValue { gte:0, lte:1000000000000000, maxScale:2 }
|
|
34
|
-
- taxDetails: TaxDetails - Tax details.
|
|
35
|
-
|
|
36
|
-
> **Note:** Tax is not calculated in the returned `price` even when `taxDetails.taxable` is `true`.
|
|
37
|
-
|
|
38
|
-
**AllItemsDiscountConfig**
|
|
39
|
-
Properties:
|
|
40
|
-
- enabled: boolean - Whether the discount is enabled.
|
|
41
|
-
|
|
42
|
-
Default: `false`.
|
|
43
|
-
- name: string - Translatable name for "all items discount" in the catalog.
|
|
44
|
-
For example, for restaurant menus, this could be "All dishes".
|
|
45
|
-
|
|
46
|
-
minLength 1, maxLength 100
|
|
47
|
-
|
|
48
|
-
**CatalogReference**
|
|
49
|
-
Properties:
|
|
50
|
-
- appId: string - ID of the app providing the catalog.
|
|
51
|
-
|
|
52
|
-
You can get your app's ID from its page in the [app dashboard](https://dev.wix.com/dc3/my-apps/).
|
|
53
|
-
|
|
54
|
-
For items from Wix catalogs, the following values always apply:
|
|
55
|
-
+ Wix Stores: `"215238eb-22a5-4c36-9e7b-e7c08025e04e"`
|
|
56
|
-
+ Wix Bookings: `"13d21c63-b5ec-5912-8397-c3a5ddb27a97"`
|
|
57
|
-
+ Wix Restaurants: `"9a5d83fd-8570-482e-81ab-cfa88942ee60"`
|
|
58
|
-
|
|
59
|
-
minLength 1
|
|
60
|
-
- catalogItemId: string - ID of the item within the catalog it belongs to.
|
|
61
|
-
|
|
62
|
-
minLength 1, maxLength 36
|
|
63
|
-
- options: Record<string, any> - 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.
|
|
64
|
-
|
|
65
|
-
For products and variants from a Wix Stores catalog, learn more about eCommerce integration ([SDK](https://dev.wix.com/docs/sdk/backend-modules/stores/catalog-v3/e-commerce-integration) | [REST](https://dev.wix.com/docs/rest/business-solutions/stores/catalog/e-commerce-integration)).
|
|
66
|
-
|
|
67
|
-
**CatalogReferenceAndQuantity**
|
|
68
|
-
Properties:
|
|
69
|
-
- catalogReference: CatalogReference - Catalog and item reference info. Holds IDs for the item and the catalog it belongs to, as well as further optional details. This is identical in the request and response.
|
|
70
|
-
- quantity: number - Item quantity.
|
|
71
|
-
|
|
72
|
-
**CatalogSPIConfig**
|
|
73
|
-
Properties:
|
|
74
|
-
- allItemsDiscount: AllItemsDiscountConfig - Configuration details for discounts applied to all items in the catalog.
|
|
75
|
-
- deploymentUri: string - Base URI which Wix eCommerce will call to access Catalog service plugin endpoints. For example, to call the Get Catalog Items endpoint at `https://my-external-catalog.com/get-catalog-items`, the base URI you provide here is `https://my-external-catalog.com`.
|
|
76
|
-
- specificItemsDiscount: SpecificItemsDiscountConfig - Configuration details for discounts applied to specific items in the catalog.
|
|
77
|
-
|
|
78
|
-
**Color**
|
|
79
|
-
Properties:
|
|
80
|
-
- code: string - HEX or RGB color code for display.
|
|
81
|
-
- original: string - 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).
|
|
82
|
-
|
|
83
|
-
maxLength 500
|
|
84
|
-
- translated: string - Description line color name translated into the buyer's language.
|
|
85
|
-
|
|
86
|
-
Default: Same as `original`.
|
|
87
|
-
|
|
88
|
-
maxLength 500
|
|
89
|
-
|
|
90
|
-
**Context**
|
|
91
|
-
Properties:
|
|
92
|
-
- currency: string - [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) 3-letter currency code.
|
|
93
|
-
|
|
94
|
-
format CURRENCY
|
|
95
|
-
- identity: IdentificationData - An object that describes the identity that triggered this request.
|
|
96
|
-
- instanceId: string - The service provider app's instance ID.
|
|
97
|
-
|
|
98
|
-
format GUID
|
|
99
|
-
- languages: string[] - A string representing a language and region in the format of `"xx-XX"`. First 2 letters represent the language code according to ISO 639-1. This is followed by a dash "-", and then a by 2 capital letters representing the region according to ISO 3166-2. For example, `"en-US"`.
|
|
100
|
-
- requestId: string - A unique identifier of the request. You may print this ID to your logs to help with future debugging and easier correlation with Wix's logs.
|
|
101
|
-
|
|
102
|
-
**Description**
|
|
103
|
-
Properties:
|
|
104
|
-
- original: string - Subscription option description.
|
|
105
|
-
|
|
106
|
-
maxLength 500
|
|
107
|
-
- translated: string - Translated subscription option description.
|
|
108
|
-
|
|
109
|
-
maxLength 500
|
|
110
|
-
|
|
111
|
-
**DescriptionLine**
|
|
112
|
-
Properties:
|
|
113
|
-
- name: DescriptionLineName - Description line name.
|
|
114
|
-
One of (value):
|
|
115
|
-
- colorInfo: Color - Description line color value.
|
|
116
|
-
- plainText: PlainTextValue - Description line plain text value.
|
|
117
|
-
|
|
118
|
-
**DescriptionLineName**
|
|
119
|
-
Properties:
|
|
120
|
-
- original: string - 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).
|
|
121
|
-
|
|
122
|
-
maxLength 100
|
|
123
|
-
- translated: string - Description line name translated into the buyer's language.
|
|
124
|
-
|
|
125
|
-
Default: Same as `original`.
|
|
126
|
-
|
|
127
|
-
maxLength 200
|
|
128
|
-
|
|
129
|
-
**FreeTrialPeriod**
|
|
130
|
-
Properties:
|
|
131
|
-
- frequency: SubscriptionFrequency - Frequency of period. Values: DAY, WEEK, MONTH, YEAR
|
|
132
|
-
- interval: number - interval of period
|
|
133
|
-
|
|
134
|
-
min 1, max 999
|
|
135
|
-
|
|
136
|
-
**GetCatalogItemsEnvelope**
|
|
137
|
-
Properties:
|
|
138
|
-
- metadata: Context
|
|
139
|
-
- request: GetCatalogItemsRequest
|
|
140
|
-
|
|
141
|
-
**GetCatalogItemsRequest**
|
|
142
|
-
Properties:
|
|
143
|
-
- catalogReferences: CatalogReferenceAndQuantity[] - Catalog reference details for the items to retrieve, including quantity of each item.
|
|
144
|
-
|
|
145
|
-
minSize 1, maxSize 300
|
|
146
|
-
- currency: string - Currency to return item prices in, in [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) format. For example, `USD` or `EUR`.
|
|
147
|
-
|
|
148
|
-
By default, Wix sends the currency specified in the site's settings.
|
|
149
|
-
|
|
150
|
-
format CURRENCY
|
|
151
|
-
- weightUnit: WeightUnit - Weight measurement unit.
|
|
152
|
-
|
|
153
|
-
By default, Wix sends the weight unit specified in the site's settings.
|
|
154
|
-
|
|
155
|
-
**GetCatalogItemsResponse**
|
|
156
|
-
Properties:
|
|
157
|
-
- catalogItems: Item[] - Details for each item, including catalog reference details and item data. Any items that don't exist in the catalog are excluded.
|
|
158
|
-
If none of the requested items exist in the catalog, this array must be empty.
|
|
159
|
-
|
|
160
|
-
**IdentificationData**
|
|
161
|
-
Properties:
|
|
162
|
-
- identityType: IdentityType
|
|
163
|
-
One of (id):
|
|
164
|
-
- anonymousVisitorId: string - ID of a site visitor that has not logged in to the site.
|
|
165
|
-
- appId: string - ID of an app.
|
|
166
|
-
- memberId: string - ID of a site visitor that has logged in to the site.
|
|
167
|
-
- wixUserId: string - ID of a Wix user (site owner, contributor, etc.).
|
|
168
|
-
|
|
169
|
-
**IdentityType**
|
|
170
|
-
Enum values:
|
|
171
|
-
- ANONYMOUS_VISITOR
|
|
172
|
-
- APP
|
|
173
|
-
- MEMBER
|
|
174
|
-
- UNKNOWN
|
|
175
|
-
- WIX_USER
|
|
176
|
-
|
|
177
|
-
**Item**
|
|
178
|
-
Properties:
|
|
179
|
-
- catalogReference: CatalogReference - Catalog and item reference info. Holds IDs for the item and the catalog it belongs to, as well as further optional details. This is identical in the request and response.
|
|
180
|
-
- data: ItemData - Item data. Contains full details about the item.
|
|
181
|
-
|
|
182
|
-
**ItemData**
|
|
183
|
-
Properties:
|
|
184
|
-
- additionalFees: AdditionalFee[] - Additional Fees to be added to this item calculation.
|
|
185
|
-
|
|
186
|
-
maxSize 5
|
|
187
|
-
- consentRequiredPaymentPolicy: string - Item payment policy that requires customer consent to complete purchase. The payment policy will be displayed on the checkout page.
|
|
188
|
-
|
|
189
|
-
minLength 1, maxLength 2500
|
|
190
|
-
- depositAmount: string - Partial payment to be paid upfront during the checkout. Return when `paymentOption` is `DEPOSIT_ONLINE`.
|
|
191
|
-
|
|
192
|
-
Default: If `paymentOption` is `DEPOSIT_ONLINE` but `depositAmount` is not provided, the item is treated as if `paymentOption` is `FULL_PAYMENT_ONLINE`.
|
|
193
|
-
|
|
194
|
-
format DECIMAL_VALUE
|
|
195
|
-
- descriptionLines: DescriptionLine[] - Line item description lines. Used for displaying the item in a cart, checkout or order. For example, if you want `Size: Large` to appear under the item name, create a description line with `"name": {"original": "Size"}` and `"plainText": {"original": "Large"}`.
|
|
196
|
-
|
|
197
|
-
Default: No description line.
|
|
198
|
-
|
|
199
|
-
maxSize 20
|
|
200
|
-
- fixedQuantity: boolean - Whether the line item quantity is fixed and cannot be changed.
|
|
201
|
-
|
|
202
|
-
Default: `false`
|
|
203
|
-
- fullPrice: string - Item price **before** applying any catalog-defined discount.
|
|
204
|
-
|
|
205
|
-
Default: Value of `price` field, if no catalog-defined discount applies.
|
|
206
|
-
|
|
207
|
-
format DECIMAL_VALUE
|
|
208
|
-
- itemType: ItemType - __Required.__ Item type. Either one of the preset types or a custom type.
|
|
209
|
-
- media: string - Line item image details. Supports images from the [Wix Media Manager](https://support.wix.com/en/article/wix-media-accessing-the-media-manager) only.
|
|
210
|
-
|
|
211
|
-
To use an image from another source, first upload it to the Media Manager.
|
|
212
|
-
You can retrieve the ID, width and height of an image from the Wix Media Manager.
|
|
213
|
-
- membersOnly: boolean - Whether the item can only be purchased by site members.
|
|
214
|
-
|
|
215
|
-
Default: `false`
|
|
216
|
-
- modifierGroups: ModifierGroup[] - Modifier groups that were added to the item.
|
|
217
|
-
|
|
218
|
-
maxSize 25
|
|
219
|
-
- paymentOption: PaymentOptionType - Type of selected payment option for current item.
|
|
220
|
-
|
|
221
|
-
Default: `FULL_PAYMENT_ONLINE`
|
|
222
|
-
- physicalProperties: PhysicalProperties - Physical properties of the item. Only return for physical items. When applicable, contains information such as SKU and item weight.
|
|
223
|
-
- policies: Policy[] - Policies to be displayed to the customer on the checkout page.
|
|
224
|
-
|
|
225
|
-
maxSize 5
|
|
226
|
-
- price: string - __Required.__ Item price with discounts applied. If a catalog-defined discount applies, the discount is reflected in this price.
|
|
227
|
-
|
|
228
|
-
decimalValue { gte:0, lte:1000000000000000 }
|
|
229
|
-
- priceDescription: PriceDescription - Additional description for the price. Return when additional information about the price is needed.
|
|
230
|
-
|
|
231
|
-
For example, when `price` is `"0"` but additional details about the actual price are needed, such as `"Starts at $67"`.
|
|
232
|
-
- priceUndetermined: boolean - Whether the price is not yet defined, and will be updated after the order is created.
|
|
233
|
-
|
|
234
|
-
Default: `false`
|
|
235
|
-
- productName: ProductName - __Required.__ Item name.
|
|
236
|
-
- quantityAvailable: number - Quantity of the item available for purchase. Only return if the catalog manages inventory.
|
|
237
|
-
If not returned, a buyer can increase the quantity of this item to add to the cart or checkout without limit.
|
|
238
|
-
|
|
239
|
-
max 100000000
|
|
240
|
-
- rootCatalogItemId: string - Additional ID for the item in the catalog.
|
|
241
|
-
This field provides an additional identifier for the item if your flow requires another ID as well as `catalogReference.catalogItemId`.
|
|
242
|
-
Can be used for membership validation.
|
|
243
|
-
|
|
244
|
-
Default: Same as `catalogReference.catalogItemId`.
|
|
245
|
-
|
|
246
|
-
minLength 1, maxLength 36
|
|
247
|
-
- savePaymentMethod: boolean - Whether to save the payment method on the order.
|
|
248
|
-
|
|
249
|
-
Default: `false`
|
|
250
|
-
- serviceProperties: ServiceProperties - Service properties. When applicable, this contains information such as time and number of participants.
|
|
251
|
-
- subscriptionOptionInfo: SubscriptionOptionInfo - Subscription option info.
|
|
252
|
-
- taxableAddress: TaxableAddress - Address to use for tax calculation purposes.
|
|
253
|
-
- taxGroupId: string - The tax group ID associated with this item. Learn more about the [Tax Groups Service Plugin](https://dev.wix.com/docs/rest/business-solutions/e-commerce/service-plugins/tax-groups-integration-service-plugin/introduction).
|
|
254
|
-
|
|
255
|
-
format GUID
|
|
256
|
-
- url: string - URL for the item's page on the site.
|
|
257
|
-
|
|
258
|
-
This is used to link back to the relevant item page from the cart page. If not provided, the site URL is used.
|
|
259
|
-
|
|
260
|
-
**ItemModifier**
|
|
261
|
-
Properties:
|
|
262
|
-
- _id: string - Modifier ID.
|
|
263
|
-
|
|
264
|
-
minLength 1, maxLength 36
|
|
265
|
-
- details: TranslatableString - Additional details.
|
|
266
|
-
- label: TranslatableString - Primary display label for the modifier.
|
|
267
|
-
- price: string - The price of the modifier.
|
|
268
|
-
|
|
269
|
-
decimalValue { gte:0, lte:1000000000000000, maxScale:3 }
|
|
270
|
-
- quantity: number - The quantity of this modifier.
|
|
271
|
-
|
|
272
|
-
min 1, max 100000
|
|
273
|
-
|
|
274
|
-
**ItemType**
|
|
275
|
-
One of (itemTypeData):
|
|
276
|
-
- custom: string - Custom item type. When none of the preset types are suitable, specifies the custom type.
|
|
277
|
-
- preset: ItemTypeItemType - Preset item type.
|
|
278
|
-
|
|
279
|
-
**ItemTypeItemType**
|
|
280
|
-
Enum values:
|
|
281
|
-
- DIGITAL
|
|
282
|
-
- GIFT_CARD
|
|
283
|
-
- PHYSICAL
|
|
284
|
-
- SERVICE
|
|
285
|
-
- UNRECOGNISED
|
|
286
|
-
|
|
287
|
-
**ModifierGroup**
|
|
288
|
-
Properties:
|
|
289
|
-
- _id: string - Modifier group ID.
|
|
290
|
-
|
|
291
|
-
minLength 1, maxLength 36
|
|
292
|
-
- modifiers: ItemModifier[] - List of modifiers in this group.
|
|
293
|
-
|
|
294
|
-
minSize 1, maxSize 25
|
|
295
|
-
- name: TranslatableString - Modifier group name.
|
|
296
|
-
|
|
297
|
-
**PaymentOptionType**
|
|
298
|
-
Enum values:
|
|
299
|
-
- DEPOSIT_ONLINE: Partial payment to be paid upfront during checkout. The initial amount to be paid for each line item is specified in `depositAmount`.
|
|
300
|
-
- FULL_PAYMENT_OFFLINE: The entire payment for this item happens after checkout. For example, when using cash, check, or other offline payment methods.
|
|
301
|
-
- FULL_PAYMENT_ONLINE: The entire payment for this item happens as part of the checkout.
|
|
302
|
-
- 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.
|
|
303
|
-
- 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`.
|
|
304
|
-
- 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.
|
|
305
|
-
|
|
306
|
-
**PhysicalProperties**
|
|
307
|
-
Properties:
|
|
308
|
-
- shippable: boolean - Whether this line item is shippable.
|
|
309
|
-
- sku: string - Stock-keeping unit. Learn more about [SKUs](https://www.wix.com/encyclopedia/definition/stock-keeping-unit-sku).
|
|
310
|
-
|
|
311
|
-
maxLength 40
|
|
312
|
-
- weight: number - Line item weight. Measurement unit matches the weight unit specified in `weightUnit` in the request.
|
|
313
|
-
|
|
314
|
-
**PlainTextValue**
|
|
315
|
-
Properties:
|
|
316
|
-
- original: string - 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).
|
|
317
|
-
|
|
318
|
-
maxLength 600
|
|
319
|
-
- translated: string - Description line plain text value translated into the buyer's language.
|
|
320
|
-
|
|
321
|
-
Default: Same as `original`.
|
|
322
|
-
|
|
323
|
-
maxLength 600
|
|
324
|
-
|
|
325
|
-
**Policy**
|
|
326
|
-
Properties:
|
|
327
|
-
- content: string - Policy content - should be translated
|
|
328
|
-
|
|
329
|
-
minLength 1, maxLength 3000
|
|
330
|
-
- title: string - Policy title - should be translated
|
|
331
|
-
|
|
332
|
-
minLength 1, maxLength 29
|
|
333
|
-
|
|
334
|
-
**PriceDescription**
|
|
335
|
-
Properties:
|
|
336
|
-
- original: string - __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).
|
|
337
|
-
|
|
338
|
-
minLength 1, maxLength 100
|
|
339
|
-
- translated: string - Price description translated into the buyer's language.
|
|
340
|
-
|
|
341
|
-
Default: Same as `original`.
|
|
342
|
-
|
|
343
|
-
minLength 1, maxLength 100
|
|
344
|
-
|
|
345
|
-
**ProductName**
|
|
346
|
-
Properties:
|
|
347
|
-
- original: string - __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).
|
|
348
|
-
|
|
349
|
-
Min: 1 character.
|
|
350
|
-
Max: 200 characters.
|
|
351
|
-
|
|
352
|
-
minLength 1, maxLength 200
|
|
353
|
-
- translated: string - Item name translated into the buyer's language.
|
|
354
|
-
|
|
355
|
-
Min: 1 character.
|
|
356
|
-
Max: 400 characters.
|
|
357
|
-
Default: Same as `original`.
|
|
358
|
-
|
|
359
|
-
minLength 1, maxLength 400
|
|
360
|
-
|
|
361
|
-
**ServiceProperties**
|
|
362
|
-
Properties:
|
|
363
|
-
- numberOfParticipants: number - The number of people participating in the service. For example, the number of people attending a class or the number of people per hotel room.
|
|
364
|
-
|
|
365
|
-
min 1, max 10000
|
|
366
|
-
- scheduledDate: unknown - Date and time the service is to be provided, in [ISO-8601](https://en.wikipedia.org/wiki/ISO_8601#Combined_date_and_time_representations) format.
|
|
367
|
-
For example, the start time of a class.
|
|
368
|
-
|
|
369
|
-
**SpecificItemsDiscountConfig**
|
|
370
|
-
Properties:
|
|
371
|
-
- enabled: boolean - Whether the discount is enabled.
|
|
372
|
-
|
|
373
|
-
Default: `false`.
|
|
374
|
-
- name: string - Translatable name for "all items discount" in the catalog.
|
|
375
|
-
|
|
376
|
-
minLength 1, maxLength 100
|
|
377
|
-
|
|
378
|
-
**SubscriptionFrequency**
|
|
379
|
-
Enum values:
|
|
380
|
-
- DAY
|
|
381
|
-
- MONTH
|
|
382
|
-
- UNDEFINED
|
|
383
|
-
- WEEK
|
|
384
|
-
- YEAR
|
|
385
|
-
|
|
386
|
-
**SubscriptionOptionInfo**
|
|
387
|
-
Properties:
|
|
388
|
-
- description: Description - Subscription option description.
|
|
389
|
-
- subscriptionSettings: SubscriptionSettings - Subscription option settings.
|
|
390
|
-
- title: Title - Subscription option title.
|
|
391
|
-
|
|
392
|
-
**SubscriptionSettings**
|
|
393
|
-
Properties:
|
|
394
|
-
- autoRenewal: boolean - Whether subscription is renewed automatically at the end of each period.
|
|
395
|
-
- billingCycles: number - Number of billing cycles before subscription ends. Ignored if `autoRenewal` is `true`.
|
|
396
|
-
|
|
397
|
-
min 1
|
|
398
|
-
- enableCustomerCancellation: boolean - Whether to allow the customer to cancel the subscription..
|
|
399
|
-
- freeTrialPeriod: FreeTrialPeriod - Period until first cycle starts. If applied payNow will be 0
|
|
400
|
-
If None => no free trial
|
|
401
|
-
- frequency: SubscriptionFrequency - Frequency of recurring payment.
|
|
402
|
-
- interval: number - Interval of recurring payment.
|
|
403
|
-
|
|
404
|
-
Default: `1`.
|
|
405
|
-
If SubscriptionFrequency is Day the minimum interval is 7
|
|
406
|
-
|
|
407
|
-
min 1, max 3650
|
|
408
|
-
|
|
409
|
-
**TaxableAddress**
|
|
410
|
-
One of (taxableAddressData):
|
|
411
|
-
- addressType: TaxableAddressType - taxable address type. if this field is selected, the address is automatically resolved, and the tax is calculated accordingly.
|
|
412
|
-
|
|
413
|
-
**TaxableAddressType**
|
|
414
|
-
Enum values:
|
|
415
|
-
- BILLING
|
|
416
|
-
- BUSINESS
|
|
417
|
-
- SHIPPING
|
|
418
|
-
- UNKNOWN_TAXABLE_ADDRESS
|
|
419
|
-
|
|
420
|
-
**TaxDetails**
|
|
421
|
-
Properties:
|
|
422
|
-
- taxable: boolean - Whether additional fee is taxable.
|
|
423
|
-
- taxGroupId: string - Reserved for internal use.
|
|
424
|
-
|
|
425
|
-
format GUID
|
|
426
|
-
|
|
427
|
-
**Title**
|
|
428
|
-
Properties:
|
|
429
|
-
- original: string - Subscription option 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).
|
|
430
|
-
|
|
431
|
-
minLength 1, maxLength 150
|
|
432
|
-
- translated: string - Subscription option name translated into the buyer's language.
|
|
433
|
-
|
|
434
|
-
Default: Same as `original`.
|
|
435
|
-
|
|
436
|
-
minLength 1, maxLength 150
|
|
437
|
-
|
|
438
|
-
**TranslatableString**
|
|
439
|
-
Properties:
|
|
440
|
-
- original: string - __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).
|
|
441
|
-
|
|
442
|
-
Min: 1 character.
|
|
443
|
-
Max: 200 characters.
|
|
444
|
-
|
|
445
|
-
minLength 1, maxLength 200
|
|
446
|
-
- translated: string - String translated into the buyer's language.
|
|
447
|
-
|
|
448
|
-
Min: 1 character.
|
|
449
|
-
Max: 400 characters.
|
|
450
|
-
Default: Same as `original`.
|
|
451
|
-
|
|
452
|
-
minLength 1, maxLength 400
|
|
453
|
-
|
|
454
|
-
**WeightUnit**
|
|
455
|
-
Enum values:
|
|
456
|
-
- KG: Kilograms.
|
|
457
|
-
- LB: Pounds.
|
|
458
|
-
- UNSPECIFIED_WEIGHT_UNIT: Weight unit can't be classified due to an error.
|
|
459
|
-
</types>
|
|
460
|
-
</catalog_service_plugin>
|
|
@@ -1,149 +0,0 @@
|
|
|
1
|
-
|
|
2
|
-
<custom_triggers_service_plugin>
|
|
3
|
-
<purpose>Required. Base URI where the endpoints are called.
|
|
4
|
-
Wix appends the endpoint path to the base URI. For example, to call the Get Eligible Triggers endpoint at `https://my-discount-app.com/v1/getEligibleTriggers`, the base URI you provide here is `https://my-discount-app.com/`.</purpose>
|
|
5
|
-
<use_cases>
|
|
6
|
-
- Handle lineItems: List of line items in the cart/checkout.
|
|
7
|
-
- Handle purchaseFlowId: Persistent ID that correlates between the various eCommerce elements: cart, checkout, and order.
|
|
8
|
-
- Handle triggers: List of triggers to be checked for discount eligibility.
|
|
9
|
-
</use_cases>
|
|
10
|
-
<required_handlers>
|
|
11
|
-
- getEligibleTriggers() - Handler to process: Persistent ID that correlates between the various eCommerce elements: cart, checkout, and order.
|
|
12
|
-
- listTriggers() - Handler for ecom_custom-triggers - list triggers
|
|
13
|
-
</required_handlers>
|
|
14
|
-
<import>import { customTriggers } from '@wix/ecom/service-plugins'</import>
|
|
15
|
-
<types>
|
|
16
|
-
|
|
17
|
-
**CatalogReference**
|
|
18
|
-
Properties:
|
|
19
|
-
- appId: string - ID of the app providing the catalog.
|
|
20
|
-
|
|
21
|
-
You can get your app's ID from its page in the [app dashboard](https://dev.wix.com/dc3/my-apps/).
|
|
22
|
-
|
|
23
|
-
For items from Wix catalogs, the following values always apply:
|
|
24
|
-
+ Wix Stores: `"215238eb-22a5-4c36-9e7b-e7c08025e04e"`
|
|
25
|
-
+ Wix Bookings: `"13d21c63-b5ec-5912-8397-c3a5ddb27a97"`
|
|
26
|
-
+ Wix Restaurants: `"9a5d83fd-8570-482e-81ab-cfa88942ee60"`
|
|
27
|
-
|
|
28
|
-
minLength 1
|
|
29
|
-
- catalogItemId: string - ID of the item within the catalog it belongs to.
|
|
30
|
-
|
|
31
|
-
minLength 1, maxLength 36
|
|
32
|
-
- options: Record<string, any> - 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.
|
|
33
|
-
|
|
34
|
-
For products and variants from a Wix Stores catalog, learn more about eCommerce integration ([SDK](https://dev.wix.com/docs/sdk/backend-modules/stores/catalog-v3/e-commerce-integration) | [REST](https://dev.wix.com/docs/rest/business-solutions/stores/catalog/e-commerce-integration)).
|
|
35
|
-
|
|
36
|
-
**Context**
|
|
37
|
-
Properties:
|
|
38
|
-
- currency: string - [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) 3-letter currency code.
|
|
39
|
-
|
|
40
|
-
format CURRENCY
|
|
41
|
-
- identity: IdentificationData - An object that describes the identity that triggered this request.
|
|
42
|
-
- instanceId: string - The service provider app's instance ID.
|
|
43
|
-
|
|
44
|
-
format GUID
|
|
45
|
-
- languages: string[] - A string representing a language and region in the format of `"xx-XX"`. First 2 letters represent the language code according to ISO 639-1. This is followed by a dash "-", and then a by 2 capital letters representing the region according to ISO 3166-2. For example, `"en-US"`.
|
|
46
|
-
- requestId: string - A unique identifier of the request. You may print this ID to your logs to help with future debugging and easier correlation with Wix's logs.
|
|
47
|
-
|
|
48
|
-
**CustomTrigger**
|
|
49
|
-
Properties:
|
|
50
|
-
- _id: string - Custom trigger ID.
|
|
51
|
-
|
|
52
|
-
minLength 1, maxLength 100
|
|
53
|
-
|
|
54
|
-
**CustomTriggerConfig**
|
|
55
|
-
Properties:
|
|
56
|
-
- deploymentUri: string - Required. Base URI where the endpoints are called.
|
|
57
|
-
Wix appends the endpoint path to the base URI. For example, to call the Get Eligible Triggers endpoint at `https://my-discount-app.com/v1/getEligibleTriggers`, the base URI you provide here is `https://my-discount-app.com/`.
|
|
58
|
-
|
|
59
|
-
**EligibleTrigger**
|
|
60
|
-
Properties:
|
|
61
|
-
- customTriggerId: string - Custom trigger ID. Must be passed with relevant `identifier`.
|
|
62
|
-
|
|
63
|
-
minLength 1, maxLength 100
|
|
64
|
-
- identifier: string - Unique trigger identifier. The value must be the same as its equivalent in `triggers[i].identifier` in the request payload.
|
|
65
|
-
|
|
66
|
-
minLength 1, maxLength 100
|
|
67
|
-
|
|
68
|
-
**GetEligibleTriggersEnvelope**
|
|
69
|
-
Properties:
|
|
70
|
-
- metadata: Context
|
|
71
|
-
- request: GetEligibleTriggersRequest
|
|
72
|
-
|
|
73
|
-
**GetEligibleTriggersRequest**
|
|
74
|
-
Properties:
|
|
75
|
-
- lineItems: LineItem[] - List of line items in the cart/checkout.
|
|
76
|
-
|
|
77
|
-
maxSize 1000
|
|
78
|
-
- purchaseFlowId: string - Persistent ID that correlates between the various eCommerce elements: cart, checkout, and order.
|
|
79
|
-
|
|
80
|
-
format GUID
|
|
81
|
-
- triggers: TriggerToFilterBy[] - List of triggers to be checked for discount eligibility.
|
|
82
|
-
|
|
83
|
-
minSize 1, maxSize 100
|
|
84
|
-
|
|
85
|
-
**GetEligibleTriggersResponse**
|
|
86
|
-
Properties:
|
|
87
|
-
- eligibleTriggers: EligibleTrigger[] - List of eligible triggers. These are used by the Discount Rules API and Wix eCommerce to apply the relevant discount.
|
|
88
|
-
|
|
89
|
-
maxSize 100
|
|
90
|
-
|
|
91
|
-
**IdentificationData**
|
|
92
|
-
Properties:
|
|
93
|
-
- identityType: IdentityType
|
|
94
|
-
One of (id):
|
|
95
|
-
- anonymousVisitorId: string - ID of a site visitor that has not logged in to the site.
|
|
96
|
-
- appId: string - ID of an app.
|
|
97
|
-
- memberId: string - ID of a site visitor that has logged in to the site.
|
|
98
|
-
- wixUserId: string - ID of a Wix user (site owner, contributor, etc.).
|
|
99
|
-
|
|
100
|
-
**IdentityType**
|
|
101
|
-
Enum values:
|
|
102
|
-
- ANONYMOUS_VISITOR
|
|
103
|
-
- APP
|
|
104
|
-
- MEMBER
|
|
105
|
-
- UNKNOWN
|
|
106
|
-
- WIX_USER
|
|
107
|
-
|
|
108
|
-
**LineItem**
|
|
109
|
-
Properties:
|
|
110
|
-
- _id: string - Line item ID.
|
|
111
|
-
|
|
112
|
-
minLength 1, maxLength 100
|
|
113
|
-
- catalogReference: CatalogReference - Catalog and item reference. Holds IDs for the item and the catalog it came from, as well as further optional info.
|
|
114
|
-
This field may be empty in the case of a custom line item.
|
|
115
|
-
- price: string - Price of a single item.
|
|
116
|
-
|
|
117
|
-
decimalValue { gte:0 }
|
|
118
|
-
- quantity: number - Item quantity in this line item.
|
|
119
|
-
|
|
120
|
-
max 100000
|
|
121
|
-
|
|
122
|
-
**ListTriggersEnvelope**
|
|
123
|
-
Properties:
|
|
124
|
-
- metadata: Context
|
|
125
|
-
- request: ListTriggersRequest
|
|
126
|
-
|
|
127
|
-
**ListTriggersRequest**
|
|
128
|
-
|
|
129
|
-
**ListTriggersResponse**
|
|
130
|
-
Properties:
|
|
131
|
-
- customTriggers: ListTriggersResponseCustomTrigger[] - Custom triggers.
|
|
132
|
-
|
|
133
|
-
**ListTriggersResponseCustomTrigger**
|
|
134
|
-
Properties:
|
|
135
|
-
- _id: string - Custom trigger ID.
|
|
136
|
-
|
|
137
|
-
minLength 1, maxLength 100
|
|
138
|
-
- name: string - Custom trigger name to display in the dashboard.
|
|
139
|
-
|
|
140
|
-
minLength 1, maxLength 200
|
|
141
|
-
|
|
142
|
-
**TriggerToFilterBy**
|
|
143
|
-
Properties:
|
|
144
|
-
- customTrigger: CustomTrigger - Custom trigger info.
|
|
145
|
-
- identifier: string - Unique trigger identifier. The same value must be returned in `eligibleTriggers[i].identifier`.
|
|
146
|
-
|
|
147
|
-
minLength 1, maxLength 100
|
|
148
|
-
</types>
|
|
149
|
-
</custom_triggers_service_plugin>
|