@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.
Files changed (72) hide show
  1. package/dist/out.js +23666 -23769
  2. package/package.json +2 -2
  3. package/dist/docs-output/api-docs/bookings-bookings-onBookingCanceled-doc.txt +0 -169
  4. package/dist/docs-output/api-docs/bookings-bookings-onBookingCreated-doc.txt +0 -154
  5. package/dist/docs-output/api-docs/crm-contacts-onContactCreated-doc.txt +0 -99
  6. package/dist/docs-output/api-docs/crm-contacts-onContactDeleted-doc.txt +0 -58
  7. package/dist/docs-output/api-docs/crm-contacts-onContactUpdated-doc.txt +0 -99
  8. package/dist/docs-output/api-docs/data-items-get-doc.txt +0 -105
  9. package/dist/docs-output/api-docs/data-items-insert-doc.txt +0 -247
  10. package/dist/docs-output/api-docs/data-items-onDataItemCreated-doc.txt +0 -61
  11. package/dist/docs-output/api-docs/data-items-onDataItemDeleted-doc.txt +0 -58
  12. package/dist/docs-output/api-docs/data-items-onDataItemUpdated-doc.txt +0 -61
  13. package/dist/docs-output/api-docs/data-items-query-doc.txt +0 -514
  14. package/dist/docs-output/api-docs/data-items-remove-doc.txt +0 -130
  15. package/dist/docs-output/api-docs/data-items-update-doc.txt +0 -436
  16. package/dist/docs-output/api-docs/ecom-cart-addToCart-doc.txt +0 -398
  17. package/dist/docs-output/api-docs/ecom-cart-createCart-doc.txt +0 -429
  18. package/dist/docs-output/api-docs/ecom-cart-createCheckout-doc.txt +0 -149
  19. package/dist/docs-output/api-docs/ecom-cart-deleteCart-doc.txt +0 -92
  20. package/dist/docs-output/api-docs/ecom-cart-getCart-doc.txt +0 -284
  21. package/dist/docs-output/api-docs/ecom-cart-onCartCreated-doc.txt +0 -97
  22. package/dist/docs-output/api-docs/ecom-cart-onCartUpdated-doc.txt +0 -97
  23. package/dist/docs-output/api-docs/ecom-cart-removeLineItemsFromCart-doc.txt +0 -292
  24. package/dist/docs-output/api-docs/ecom-cart-updateCart-doc.txt +0 -442
  25. package/dist/docs-output/api-docs/ecom-checkout-addToCheckout-doc.txt +0 -622
  26. package/dist/docs-output/api-docs/ecom-checkout-createCheckout-doc.txt +0 -878
  27. package/dist/docs-output/api-docs/ecom-checkout-getCheckout-doc.txt +0 -494
  28. package/dist/docs-output/api-docs/ecom-checkout-onCheckoutCompleted-doc.txt +0 -151
  29. package/dist/docs-output/api-docs/ecom-checkout-onCheckoutCreated-doc.txt +0 -150
  30. package/dist/docs-output/api-docs/ecom-checkout-onCheckoutUpdated-doc.txt +0 -150
  31. package/dist/docs-output/api-docs/ecom-checkout-removeLineItemsFromCheckout-doc.txt +0 -499
  32. package/dist/docs-output/api-docs/ecom-checkout-updateCheckout-doc.txt +0 -730
  33. package/dist/docs-output/api-docs/ecom-currentCart-getCurrentCart-doc.txt +0 -249
  34. package/dist/docs-output/api-docs/ecom-currentCart-updateCurrentCart-doc.txt +0 -413
  35. package/dist/docs-output/api-docs/ecom-orders-bulkUpdateOrders-doc.txt +0 -988
  36. package/dist/docs-output/api-docs/ecom-orders-cancelOrder-doc.txt +0 -608
  37. package/dist/docs-output/api-docs/ecom-orders-getOrder-doc.txt +0 -625
  38. package/dist/docs-output/api-docs/ecom-orders-onOrderCreated-doc.txt +0 -245
  39. package/dist/docs-output/api-docs/ecom-orders-onOrderUpdated-doc.txt +0 -244
  40. package/dist/docs-output/api-docs/ecom-orders-searchOrders-doc.txt +0 -670
  41. package/dist/docs-output/api-docs/ecom-orders-updateOrder-doc.txt +0 -818
  42. package/dist/docs-output/api-docs/search-wixSiteSearch-search-doc.txt +0 -162
  43. package/dist/docs-output/api-docs/stores-collections-addProductsToCollection-doc.txt +0 -86
  44. package/dist/docs-output/api-docs/stores-collections-createCollection-doc.txt +0 -108
  45. package/dist/docs-output/api-docs/stores-collections-getCollection-doc.txt +0 -102
  46. package/dist/docs-output/api-docs/stores-collections-queryCollections-doc.txt +0 -209
  47. package/dist/docs-output/api-docs/stores-collections-removeProductsFromCollection-doc.txt +0 -86
  48. package/dist/docs-output/api-docs/stores-collections-updateCollection-doc.txt +0 -110
  49. package/dist/docs-output/api-docs/stores-inventory-queryInventory-doc.txt +0 -98
  50. package/dist/docs-output/api-docs/stores-inventory-updateInventoryVariants-doc.txt +0 -249
  51. package/dist/docs-output/api-docs/stores-inventoryItemsV3-queryInventoryItems-doc.txt +0 -236
  52. package/dist/docs-output/api-docs/stores-inventoryItemsV3-updateInventoryItem-doc.txt +0 -139
  53. package/dist/docs-output/api-docs/stores-productsV3-createProduct-doc.txt +0 -1697
  54. package/dist/docs-output/api-docs/stores-productsV3-deleteProduct-doc.txt +0 -73
  55. package/dist/docs-output/api-docs/stores-productsV3-getProduct-doc.txt +0 -933
  56. package/dist/docs-output/api-docs/stores-productsV3-onProductCreated-doc.txt +0 -794
  57. package/dist/docs-output/api-docs/stores-productsV3-onProductDeleted-doc.txt +0 -794
  58. package/dist/docs-output/api-docs/stores-productsV3-onProductUpdated-doc.txt +0 -794
  59. package/dist/docs-output/api-docs/stores-productsV3-queryProducts-doc.txt +0 -1051
  60. package/dist/docs-output/api-docs/stores-productsV3-searchProducts-doc.txt +0 -1144
  61. package/dist/docs-output/api-docs/stores-productsV3-updateProduct-doc.txt +0 -1737
  62. package/dist/docs-output/api-docs/stores-readOnlyVariantsV3-queryVariants-doc.txt +0 -290
  63. package/dist/docs-output/api-docs/stores-readOnlyVariantsV3-searchVariants-doc.txt +0 -353
  64. package/dist/docs-output/service-plugins/ecom-additional-fees-doc.txt +0 -411
  65. package/dist/docs-output/service-plugins/ecom-catalog-doc.txt +0 -460
  66. package/dist/docs-output/service-plugins/ecom-custom-triggers-doc.txt +0 -149
  67. package/dist/docs-output/service-plugins/ecom-gift-vouchers-provider-doc.txt +0 -169
  68. package/dist/docs-output/service-plugins/ecom-payment-settings-doc.txt +0 -2368
  69. package/dist/docs-output/service-plugins/ecom-recommendations-provider-doc.txt +0 -147
  70. package/dist/docs-output/service-plugins/ecom-shipping-rates-doc.txt +0 -352
  71. package/dist/docs-output/service-plugins/ecom-tax-calculation-provider-doc.txt +0 -244
  72. 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>