@wix/ditto-codegen-public 1.0.162 → 1.0.164

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 +24996 -553
  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,151 @@
1
+ <ecom_checkout_onCheckoutCompleted>
2
+ <description>
3
+ # This is a Webhook method
4
+
5
+ # Method name:
6
+
7
+ ecom.checkout.onCheckoutCompleted(handler: OnCheckoutCompletedHandler)
8
+
9
+ # Method Link:
10
+
11
+ https://dev.wix.com/docs/sdk/backend-modules/ecom/checkout/on-checkout-completed
12
+
13
+ # Method Description:
14
+
15
+ Triggered when an order created from this checkout is successfully paid for or when a checkout is marked as completed.
16
+
17
+
18
+ </description>
19
+ <usage>
20
+ import { checkout } from "@wix/ecom";
21
+
22
+ checkout.onCheckoutCompleted((event) => {
23
+ // handle your event here
24
+ });
25
+
26
+ </usage>
27
+ <type_definition>
28
+ ```
29
+ Method: ecom.checkout.onCheckoutCompleted(handler)
30
+ Description: Triggered when an order created from this checkout is successfully paid for or when a checkout is marked as completed.
31
+ Method parameters:
32
+ param name: handler | type: OnCheckoutCompletedHandler | description: none
33
+ - name: event | type: CheckoutCompletedEnvelope | description: none
34
+ - name: data | type: CheckoutMarkedAsCompleted | description: none
35
+ - name: checkout | type: Checkout | description: none
36
+ - name: additionalFees | type: Array<AdditionalFee> | description: Additional Fees.
37
+ - name: code | type: string | description: Additional fee's unique code (or GUID) for future processing.
38
+ - name: 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.
39
+ - name: name | type: string | description: Translated additional fee's name.
40
+ - name: price | type: MultiCurrencyPrice | description: Additional fee's price.
41
+ - name: amount | type: string | description: Amount.
42
+ - name: priceAfterTax | type: MultiCurrencyPrice | description: Additional fee's price after tax.
43
+ - name: priceBeforeTax | type: MultiCurrencyPrice | description: Additional fee's price before tax.
44
+ - name: providerAppId | type: string | description: Provider's app id.
45
+ - name: source | type: AdditionalFeeSource | description: the source the additional fee was added from
46
+ enum:
47
+ ITEM: The additional fee was added on the item either via the catalog or on custom line item
48
+ MANUAL: The additional fee was added manually on the request
49
+ SERVICE_PLUGIN: The additional fee was added by an additional fee service plugin
50
+ SHIPPING: The additional fee was added by the shipping provider
51
+ UNKNOWN_ADDITIONAL_FEE_SOURCE
52
+ - name: taxDetails | type: ItemTaxFullDetails | description: Tax details.
53
+ - name: taxRate | type: string | description: Tax rate %, as a decimal point between 0 and 1.
54
+ - name: taxableAmount | type: MultiCurrencyPrice | description: Amount for which tax is calculated.
55
+ - name: totalTax | type: MultiCurrencyPrice | description: Calculated tax, based on `taxable_amount` and `tax_rate`.
56
+ - name: translatedName | type: string | description: The translated name of the additional fee. The translation language is determined by the `languages` field 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).
57
+ - name: billingInfo | type: AddressWithContact | description: Billing information.
58
+ - name: address | type: ApiAddress | description: Address.
59
+ - name: addressLine1 | type: string | description: Main address line (usually street name and number).
60
+ - name: addressLine2 | type: string | description: Free text providing more detailed address info. Usually contains apt, suite, floor.
61
+ - name: city | type: string | description: City name.
62
+ - name: country | type: string | description: Two-letter country code in [ISO-3166 alpha-2](https://www.iso.org/obp/ui/#search/code/) format.
63
+ - name: location | type: AddressLocation | description: Geocode object containing latitude and longitude coordinates.
64
+ - name: latitude | type: number | description: Address latitude.
65
+ - name: longitude | type: number | description: Address longitude.
66
+ - name: postalCode | type: string | description: Postal or zip code.
67
+ - name: streetAddress | type: StreetAddress | description: Street address.
68
+ - name: name | type: string | description: Street name.
69
+ - name: number | type: string | description: Street number.
70
+ - name: 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.
71
+ - name: contactDetails | type: FullAddressContactDetails | description: Contact details.
72
+ - name: company | type: string | description: Company name.
73
+ - name: firstName | type: string | description: First name.
74
+ - name: lastName | type: string | description: Last name.
75
+ - name: phone | type: string | description: Phone number.
76
+ - name: vatId | type: CommonVatId | description: Tax information (for Brazil only). If GUID is provided, `vatId.type` must also be set, `UNSPECIFIED` is not allowed.
77
+ - name: _id | type: string | description: Customer's tax GUID.
78
+ - name: type | type: CommonVatType | description: Tax type. Supported values: + `CPF`: for individual tax payers + `CNPJ`: for corporations
79
+ enum:
80
+ CNPJ: CNPJ - for corporations
81
+ CPF: CPF - for individual tax payers.
82
+ UNSPECIFIED
83
+ - name: businessLocationId | type: string | description: The business location GUID associated with the checkout. To learn more, see the Locations API.
84
+ - name: buyerInfo | type: BuyerInfo | description: Buyer information.
85
+ - name: email | type: string | description: Buyer email address.
86
+ - ONE-OF:
87
+ - name: memberId | type: string | description: Member GUID (if site visitor is a site member).
88
+ - name: visitorId | type: string | description: Visitor GUID (if site visitor is **not** a member).
89
+ - name: buyerNote | type: string | description: [Buyer note](https://support.wix.com/en/article/collecting-and-viewing-buyer-notes) left by the customer.
90
+ - name: cartId | type: string | description: Cart GUID that this checkout was created from. Empty if this checkout wasn't created from a cart.
91
+ - name: customContentReference | type: CustomContentReference | description: Reference GUIDs for the app and component providing custom checkout page content. To access and manage custom checkout page content, your app must have the permission scope named "Manage eCommerce - Admin Permissions". Learn more about [permission scopes](https://dev.wix.com/docs/build-apps/develop-your-app/access/authorization/about-permissions).
92
+ - name: appId | type: string | description: GUID of the app providing the content. You can get your app's GUID from its page in the [app dashboard](https://dev.wix.com/dc3/my-apps/).
93
+ - name: componentId | type: string | description: GUID of the component within the app it belongs to. You can get your component's GUID from its page in the [app dashboard](https://dev.wix.com/dc3/my-apps/).
94
+ - name: customFields | type: Array<CustomField> | description: Custom fields.
95
+ - name: title | type: string | description: Custom field title.
96
+ - name: translatedTitle | type: string | description: Translated custom field title.
97
+ - name: value | type: any | description: Custom field value.
98
+ - name: customSettings | type: CustomSettings | description: Additional settings for customization of the checkout process. > **Notes:** > * Custom settings can only be set when creating a checkout. > * To access and manage custom checkout page content, your app must have the permission scope named "Manage eCommerce - Admin Permissions". Learn more about [permission scopes](https://dev.wix.com/docs/build-apps/develop-your-app/access/authorization/about-permissions).
99
+ - name: disabledManualPayment | type: boolean | description: Whether to disable manual payment option for this checkout. Default: `false`
100
+ - name: disabledPolicyAgreementCheckbox | type: boolean | description: Whether to disable policy agreement checkout in the checkout page Default: `false`
101
+ - name: lockCouponCode | type: boolean | description: Whether to restrict the option to add or remove a coupon code on the checkout page. Default: `false`
102
+ - name: lockGiftCard | type: boolean | description: Whether to restrict the option to add or remove a gift card on the checkout page. Default: `false`
103
+ - name: extendedFields | type: ExtendedFields | description: Custom field data for the checkout 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.
104
+ - name: 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).
105
+ - name: externalReference | type: ExternalReference | description: References to an external app and resource associated with this checkout. Used for integration and tracking across different platforms.
106
+ - name: appId | type: string | description: GUID of the app associated with the purchase flow. For example, the Wix Pay Links app GUID.
107
+ - name: resourceId | type: string | description: Reference to an external resource GUID. Used to link the purchase flow to a specific entity in an external system. For example, a Wix Pay Link GUID.
108
+ - name: membershipOptions | type: MembershipOptions | description: Memberships to apply when creating the order.
109
+ - name: selectedMemberships | type: SelectedMemberships | description: Selected membership to apply to this checkout.
110
+ - name: memberships | type: Array<SelectedMembership> | description: Selected memberships.
111
+ - name: _id | type: string | description: Membership GUID.
112
+ - name: appId | type: string | description: GUID of the app providing this payment option.
113
+ - name: lineItemIds | type: Array<string> | description: IDs of the line items this membership applies to.
114
+ - name: shippingInfo | type: ShippingInfo | description: Shipping information.
115
+ - name: selectedCarrierServiceOption | type: SelectedCarrierServiceOption | description: Selected option out of the options allowed for the `region`.
116
+ - name: carrierId | type: string | description: This carrier's unique GUID
117
+ - name: code | type: string | description: Unique identifier of selected option. For example, "usps_std_overnight".
118
+ - name: deliveryAllocations | type: Array<DeliveryAllocation> | description: Delivery solution allocations to different delivery carriers and delivery regions
119
+ - name: applicableLineItems | type: ApplicableLineItems | description: Populated if the delivery solution is a partially supplied by this carrier.
120
+ - name: lineItemIds | type: Array<string> | description: Line items that the delivery solution is for.
121
+ - name: deliveryCarrier | type: Carrier | description: The delivery option's carrier details, could be multiple if the delivery option is a combination of multiple carriers
122
+ - name: appId | type: string | description: The carrier app id
123
+ - name: code | type: string | description: Unique code that acts as an GUID for a shipping rate. For example, `"usps_std_overnight"`.
124
+ - name: deliveryRegion | type: Region | description: The delivery region that are relevant for this delivery solution.
125
+ - name: _id | type: string | description: The delivery region id.
126
+ - name: name | type: string | description: The delivery region name.
127
+ - name: partial | type: boolean | description: If the delivery solution is a partial and doesn't apply to all items.
128
+ - name: shippingDestination | type: AddressWithContact | description: Shipping address and contact details.
129
+ - name: taxExemptGroupId | type: string | description: Tax exempt group GUID to use for tax exemptions.
130
+ - name: metadata | type: EventMetadata | description: none
131
+ - name: _id | type: string | description: Event GUID. With this GUID you can easily spot duplicated events and ignore them.
132
+ - name: entityEventSequence | type: string | description: A sequence number that indicates the order of updates to an entity. For example, if an entity was updated at 16:00 and then again at 16:01, the second update will always have a higher sequence number. You can use this number to make sure you're handling updates in the right order. Just save the latest sequence number on your end and compare it to the one in each new message. If the new message has an older (lower) number, you can safely ignore it.
133
+ - name: entityFqdn | type: string | description: Fully Qualified Domain Name of an entity. This is a unique identifier assigned to the API main business entities. For example, `wix.stores.catalog.product`, `wix.bookings.session`, `wix.payments.transaction`.
134
+ - name: entityId | type: string | description: GUID of the entity associated with the event.
135
+ - name: eventTime | type: Date | description: Event timestamp in [ISO-8601](https://en.wikipedia.org/wiki/ISO_8601) format and UTC time. For example, `2020-04-26T13:57:50.699Z`.
136
+ - name: eventType | type: string | description: Event type.
137
+ - name: identity | type: IdentificationData | description: The identification type and identity data.
138
+ - ONE-OF:
139
+ - name: anonymousVisitorId | type: string | description: GUID of a site visitor that has not logged in to the site.
140
+ - name: appId | type: string | description: GUID of an app.
141
+ - name: memberId | type: string | description: GUID of a site visitor that has logged in to the site.
142
+ - name: wixUserId | type: string | description: GUID of a Wix user (site owner, contributor, etc.).
143
+ - name: instanceId | type: string | description: App instance GUID.
144
+ - name: originatedFrom | type: string | description: If present, indicates the action that triggered the event.
145
+ - name: slug | type: string | description: Event action name, placed at the top level to make it easier for users to dispatch messages. For example: `created`/`updated`/`deleted`/`started`/`completed`/`email_opened`.
146
+ - name: triggeredByAnonymizeRequest | type: boolean | description: Whether the event was triggered as a result of a privacy regulation application (for example, GDPR).
147
+ Return type: PRIMITIVE<void>
148
+
149
+ ```
150
+ </type_definition>
151
+ </ecom_checkout_onCheckoutCompleted>
@@ -0,0 +1,150 @@
1
+ <ecom_checkout_onCheckoutCreated>
2
+ <description>
3
+ # This is a Webhook method
4
+
5
+ # Method name:
6
+
7
+ ecom.checkout.onCheckoutCreated(handler: OnCheckoutCreatedHandler)
8
+
9
+ # Method Link:
10
+
11
+ https://dev.wix.com/docs/sdk/backend-modules/ecom/checkout/on-checkout-created
12
+
13
+ # Method Description:
14
+
15
+ Triggered when a checkout is created.
16
+
17
+
18
+ </description>
19
+ <usage>
20
+ import { checkout } from "@wix/ecom";
21
+
22
+ checkout.onCheckoutCreated((event) => {
23
+ // handle your event here
24
+ });
25
+
26
+ </usage>
27
+ <type_definition>
28
+ ```
29
+ Method: ecom.checkout.onCheckoutCreated(handler)
30
+ Description: Triggered when a checkout is created.
31
+ Method parameters:
32
+ param name: handler | type: OnCheckoutCreatedHandler | description: none
33
+ - name: event | type: CheckoutCreatedEnvelope | description: none
34
+ - name: entity | type: Checkout | description: none
35
+ - name: additionalFees | type: Array<AdditionalFee> | description: Additional Fees.
36
+ - name: code | type: string | description: Additional fee's unique code (or GUID) for future processing.
37
+ - name: 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.
38
+ - name: name | type: string | description: Translated additional fee's name.
39
+ - name: price | type: MultiCurrencyPrice | description: Additional fee's price.
40
+ - name: amount | type: string | description: Amount.
41
+ - name: priceAfterTax | type: MultiCurrencyPrice | description: Additional fee's price after tax.
42
+ - name: priceBeforeTax | type: MultiCurrencyPrice | description: Additional fee's price before tax.
43
+ - name: providerAppId | type: string | description: Provider's app id.
44
+ - name: source | type: AdditionalFeeSource | description: the source the additional fee was added from
45
+ enum:
46
+ ITEM: The additional fee was added on the item either via the catalog or on custom line item
47
+ MANUAL: The additional fee was added manually on the request
48
+ SERVICE_PLUGIN: The additional fee was added by an additional fee service plugin
49
+ SHIPPING: The additional fee was added by the shipping provider
50
+ UNKNOWN_ADDITIONAL_FEE_SOURCE
51
+ - name: taxDetails | type: ItemTaxFullDetails | description: Tax details.
52
+ - name: taxRate | type: string | description: Tax rate %, as a decimal point between 0 and 1.
53
+ - name: taxableAmount | type: MultiCurrencyPrice | description: Amount for which tax is calculated.
54
+ - name: totalTax | type: MultiCurrencyPrice | description: Calculated tax, based on `taxable_amount` and `tax_rate`.
55
+ - name: translatedName | type: string | description: The translated name of the additional fee. The translation language is determined by the `languages` field 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).
56
+ - name: billingInfo | type: AddressWithContact | description: Billing information.
57
+ - name: address | type: ApiAddress | description: Address.
58
+ - name: addressLine1 | type: string | description: Main address line (usually street name and number).
59
+ - name: addressLine2 | type: string | description: Free text providing more detailed address info. Usually contains apt, suite, floor.
60
+ - name: city | type: string | description: City name.
61
+ - name: country | type: string | description: Two-letter country code in [ISO-3166 alpha-2](https://www.iso.org/obp/ui/#search/code/) format.
62
+ - name: location | type: AddressLocation | description: Geocode object containing latitude and longitude coordinates.
63
+ - name: latitude | type: number | description: Address latitude.
64
+ - name: longitude | type: number | description: Address longitude.
65
+ - name: postalCode | type: string | description: Postal or zip code.
66
+ - name: streetAddress | type: StreetAddress | description: Street address.
67
+ - name: name | type: string | description: Street name.
68
+ - name: number | type: string | description: Street number.
69
+ - name: 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.
70
+ - name: contactDetails | type: FullAddressContactDetails | description: Contact details.
71
+ - name: company | type: string | description: Company name.
72
+ - name: firstName | type: string | description: First name.
73
+ - name: lastName | type: string | description: Last name.
74
+ - name: phone | type: string | description: Phone number.
75
+ - name: vatId | type: CommonVatId | description: Tax information (for Brazil only). If GUID is provided, `vatId.type` must also be set, `UNSPECIFIED` is not allowed.
76
+ - name: _id | type: string | description: Customer's tax GUID.
77
+ - name: type | type: CommonVatType | description: Tax type. Supported values: + `CPF`: for individual tax payers + `CNPJ`: for corporations
78
+ enum:
79
+ CNPJ: CNPJ - for corporations
80
+ CPF: CPF - for individual tax payers.
81
+ UNSPECIFIED
82
+ - name: businessLocationId | type: string | description: The business location GUID associated with the checkout. To learn more, see the Locations API.
83
+ - name: buyerInfo | type: BuyerInfo | description: Buyer information.
84
+ - name: email | type: string | description: Buyer email address.
85
+ - ONE-OF:
86
+ - name: memberId | type: string | description: Member GUID (if site visitor is a site member).
87
+ - name: visitorId | type: string | description: Visitor GUID (if site visitor is **not** a member).
88
+ - name: buyerNote | type: string | description: [Buyer note](https://support.wix.com/en/article/collecting-and-viewing-buyer-notes) left by the customer.
89
+ - name: cartId | type: string | description: Cart GUID that this checkout was created from. Empty if this checkout wasn't created from a cart.
90
+ - name: customContentReference | type: CustomContentReference | description: Reference GUIDs for the app and component providing custom checkout page content. To access and manage custom checkout page content, your app must have the permission scope named "Manage eCommerce - Admin Permissions". Learn more about [permission scopes](https://dev.wix.com/docs/build-apps/develop-your-app/access/authorization/about-permissions).
91
+ - name: appId | type: string | description: GUID of the app providing the content. You can get your app's GUID from its page in the [app dashboard](https://dev.wix.com/dc3/my-apps/).
92
+ - name: componentId | type: string | description: GUID of the component within the app it belongs to. You can get your component's GUID from its page in the [app dashboard](https://dev.wix.com/dc3/my-apps/).
93
+ - name: customFields | type: Array<CustomField> | description: Custom fields.
94
+ - name: title | type: string | description: Custom field title.
95
+ - name: translatedTitle | type: string | description: Translated custom field title.
96
+ - name: value | type: any | description: Custom field value.
97
+ - name: customSettings | type: CustomSettings | description: Additional settings for customization of the checkout process. > **Notes:** > * Custom settings can only be set when creating a checkout. > * To access and manage custom checkout page content, your app must have the permission scope named "Manage eCommerce - Admin Permissions". Learn more about [permission scopes](https://dev.wix.com/docs/build-apps/develop-your-app/access/authorization/about-permissions).
98
+ - name: disabledManualPayment | type: boolean | description: Whether to disable manual payment option for this checkout. Default: `false`
99
+ - name: disabledPolicyAgreementCheckbox | type: boolean | description: Whether to disable policy agreement checkout in the checkout page Default: `false`
100
+ - name: lockCouponCode | type: boolean | description: Whether to restrict the option to add or remove a coupon code on the checkout page. Default: `false`
101
+ - name: lockGiftCard | type: boolean | description: Whether to restrict the option to add or remove a gift card on the checkout page. Default: `false`
102
+ - name: extendedFields | type: ExtendedFields | description: Custom field data for the checkout 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.
103
+ - name: 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).
104
+ - name: externalReference | type: ExternalReference | description: References to an external app and resource associated with this checkout. Used for integration and tracking across different platforms.
105
+ - name: appId | type: string | description: GUID of the app associated with the purchase flow. For example, the Wix Pay Links app GUID.
106
+ - name: resourceId | type: string | description: Reference to an external resource GUID. Used to link the purchase flow to a specific entity in an external system. For example, a Wix Pay Link GUID.
107
+ - name: membershipOptions | type: MembershipOptions | description: Memberships to apply when creating the order.
108
+ - name: selectedMemberships | type: SelectedMemberships | description: Selected membership to apply to this checkout.
109
+ - name: memberships | type: Array<SelectedMembership> | description: Selected memberships.
110
+ - name: _id | type: string | description: Membership GUID.
111
+ - name: appId | type: string | description: GUID of the app providing this payment option.
112
+ - name: lineItemIds | type: Array<string> | description: IDs of the line items this membership applies to.
113
+ - name: shippingInfo | type: ShippingInfo | description: Shipping information.
114
+ - name: selectedCarrierServiceOption | type: SelectedCarrierServiceOption | description: Selected option out of the options allowed for the `region`.
115
+ - name: carrierId | type: string | description: This carrier's unique GUID
116
+ - name: code | type: string | description: Unique identifier of selected option. For example, "usps_std_overnight".
117
+ - name: deliveryAllocations | type: Array<DeliveryAllocation> | description: Delivery solution allocations to different delivery carriers and delivery regions
118
+ - name: applicableLineItems | type: ApplicableLineItems | description: Populated if the delivery solution is a partially supplied by this carrier.
119
+ - name: lineItemIds | type: Array<string> | description: Line items that the delivery solution is for.
120
+ - name: deliveryCarrier | type: Carrier | description: The delivery option's carrier details, could be multiple if the delivery option is a combination of multiple carriers
121
+ - name: appId | type: string | description: The carrier app id
122
+ - name: code | type: string | description: Unique code that acts as an GUID for a shipping rate. For example, `"usps_std_overnight"`.
123
+ - name: deliveryRegion | type: Region | description: The delivery region that are relevant for this delivery solution.
124
+ - name: _id | type: string | description: The delivery region id.
125
+ - name: name | type: string | description: The delivery region name.
126
+ - name: partial | type: boolean | description: If the delivery solution is a partial and doesn't apply to all items.
127
+ - name: shippingDestination | type: AddressWithContact | description: Shipping address and contact details.
128
+ - name: taxExemptGroupId | type: string | description: Tax exempt group GUID to use for tax exemptions.
129
+ - name: metadata | type: EventMetadata | description: none
130
+ - name: _id | type: string | description: Event GUID. With this GUID you can easily spot duplicated events and ignore them.
131
+ - name: entityEventSequence | type: string | description: A sequence number that indicates the order of updates to an entity. For example, if an entity was updated at 16:00 and then again at 16:01, the second update will always have a higher sequence number. You can use this number to make sure you're handling updates in the right order. Just save the latest sequence number on your end and compare it to the one in each new message. If the new message has an older (lower) number, you can safely ignore it.
132
+ - name: entityFqdn | type: string | description: Fully Qualified Domain Name of an entity. This is a unique identifier assigned to the API main business entities. For example, `wix.stores.catalog.product`, `wix.bookings.session`, `wix.payments.transaction`.
133
+ - name: entityId | type: string | description: GUID of the entity associated with the event.
134
+ - name: eventTime | type: Date | description: Event timestamp in [ISO-8601](https://en.wikipedia.org/wiki/ISO_8601) format and UTC time. For example, `2020-04-26T13:57:50.699Z`.
135
+ - name: eventType | type: string | description: Event type.
136
+ - name: identity | type: IdentificationData | description: The identification type and identity data.
137
+ - ONE-OF:
138
+ - name: anonymousVisitorId | type: string | description: GUID of a site visitor that has not logged in to the site.
139
+ - name: appId | type: string | description: GUID of an app.
140
+ - name: memberId | type: string | description: GUID of a site visitor that has logged in to the site.
141
+ - name: wixUserId | type: string | description: GUID of a Wix user (site owner, contributor, etc.).
142
+ - name: instanceId | type: string | description: App instance GUID.
143
+ - name: originatedFrom | type: string | description: If present, indicates the action that triggered the event.
144
+ - name: slug | type: string | description: Event action name, placed at the top level to make it easier for users to dispatch messages. For example: `created`/`updated`/`deleted`/`started`/`completed`/`email_opened`.
145
+ - name: triggeredByAnonymizeRequest | type: boolean | description: Whether the event was triggered as a result of a privacy regulation application (for example, GDPR).
146
+ Return type: PRIMITIVE<void>
147
+
148
+ ```
149
+ </type_definition>
150
+ </ecom_checkout_onCheckoutCreated>
@@ -0,0 +1,150 @@
1
+ <ecom_checkout_onCheckoutUpdated>
2
+ <description>
3
+ # This is a Webhook method
4
+
5
+ # Method name:
6
+
7
+ ecom.checkout.onCheckoutUpdated(handler: OnCheckoutUpdatedHandler)
8
+
9
+ # Method Link:
10
+
11
+ https://dev.wix.com/docs/sdk/backend-modules/ecom/checkout/on-checkout-updated
12
+
13
+ # Method Description:
14
+
15
+ Triggered when a checkout is updated.
16
+
17
+
18
+ </description>
19
+ <usage>
20
+ import { checkout } from "@wix/ecom";
21
+
22
+ checkout.onCheckoutUpdated((event) => {
23
+ // handle your event here
24
+ });
25
+
26
+ </usage>
27
+ <type_definition>
28
+ ```
29
+ Method: ecom.checkout.onCheckoutUpdated(handler)
30
+ Description: Triggered when a checkout is updated.
31
+ Method parameters:
32
+ param name: handler | type: OnCheckoutUpdatedHandler | description: none
33
+ - name: event | type: CheckoutUpdatedEnvelope | description: none
34
+ - name: entity | type: Checkout | description: none
35
+ - name: additionalFees | type: Array<AdditionalFee> | description: Additional Fees.
36
+ - name: code | type: string | description: Additional fee's unique code (or GUID) for future processing.
37
+ - name: 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.
38
+ - name: name | type: string | description: Translated additional fee's name.
39
+ - name: price | type: MultiCurrencyPrice | description: Additional fee's price.
40
+ - name: amount | type: string | description: Amount.
41
+ - name: priceAfterTax | type: MultiCurrencyPrice | description: Additional fee's price after tax.
42
+ - name: priceBeforeTax | type: MultiCurrencyPrice | description: Additional fee's price before tax.
43
+ - name: providerAppId | type: string | description: Provider's app id.
44
+ - name: source | type: AdditionalFeeSource | description: the source the additional fee was added from
45
+ enum:
46
+ ITEM: The additional fee was added on the item either via the catalog or on custom line item
47
+ MANUAL: The additional fee was added manually on the request
48
+ SERVICE_PLUGIN: The additional fee was added by an additional fee service plugin
49
+ SHIPPING: The additional fee was added by the shipping provider
50
+ UNKNOWN_ADDITIONAL_FEE_SOURCE
51
+ - name: taxDetails | type: ItemTaxFullDetails | description: Tax details.
52
+ - name: taxRate | type: string | description: Tax rate %, as a decimal point between 0 and 1.
53
+ - name: taxableAmount | type: MultiCurrencyPrice | description: Amount for which tax is calculated.
54
+ - name: totalTax | type: MultiCurrencyPrice | description: Calculated tax, based on `taxable_amount` and `tax_rate`.
55
+ - name: translatedName | type: string | description: The translated name of the additional fee. The translation language is determined by the `languages` field 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).
56
+ - name: billingInfo | type: AddressWithContact | description: Billing information.
57
+ - name: address | type: ApiAddress | description: Address.
58
+ - name: addressLine1 | type: string | description: Main address line (usually street name and number).
59
+ - name: addressLine2 | type: string | description: Free text providing more detailed address info. Usually contains apt, suite, floor.
60
+ - name: city | type: string | description: City name.
61
+ - name: country | type: string | description: Two-letter country code in [ISO-3166 alpha-2](https://www.iso.org/obp/ui/#search/code/) format.
62
+ - name: location | type: AddressLocation | description: Geocode object containing latitude and longitude coordinates.
63
+ - name: latitude | type: number | description: Address latitude.
64
+ - name: longitude | type: number | description: Address longitude.
65
+ - name: postalCode | type: string | description: Postal or zip code.
66
+ - name: streetAddress | type: StreetAddress | description: Street address.
67
+ - name: name | type: string | description: Street name.
68
+ - name: number | type: string | description: Street number.
69
+ - name: 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.
70
+ - name: contactDetails | type: FullAddressContactDetails | description: Contact details.
71
+ - name: company | type: string | description: Company name.
72
+ - name: firstName | type: string | description: First name.
73
+ - name: lastName | type: string | description: Last name.
74
+ - name: phone | type: string | description: Phone number.
75
+ - name: vatId | type: CommonVatId | description: Tax information (for Brazil only). If GUID is provided, `vatId.type` must also be set, `UNSPECIFIED` is not allowed.
76
+ - name: _id | type: string | description: Customer's tax GUID.
77
+ - name: type | type: CommonVatType | description: Tax type. Supported values: + `CPF`: for individual tax payers + `CNPJ`: for corporations
78
+ enum:
79
+ CNPJ: CNPJ - for corporations
80
+ CPF: CPF - for individual tax payers.
81
+ UNSPECIFIED
82
+ - name: businessLocationId | type: string | description: The business location GUID associated with the checkout. To learn more, see the Locations API.
83
+ - name: buyerInfo | type: BuyerInfo | description: Buyer information.
84
+ - name: email | type: string | description: Buyer email address.
85
+ - ONE-OF:
86
+ - name: memberId | type: string | description: Member GUID (if site visitor is a site member).
87
+ - name: visitorId | type: string | description: Visitor GUID (if site visitor is **not** a member).
88
+ - name: buyerNote | type: string | description: [Buyer note](https://support.wix.com/en/article/collecting-and-viewing-buyer-notes) left by the customer.
89
+ - name: cartId | type: string | description: Cart GUID that this checkout was created from. Empty if this checkout wasn't created from a cart.
90
+ - name: customContentReference | type: CustomContentReference | description: Reference GUIDs for the app and component providing custom checkout page content. To access and manage custom checkout page content, your app must have the permission scope named "Manage eCommerce - Admin Permissions". Learn more about [permission scopes](https://dev.wix.com/docs/build-apps/develop-your-app/access/authorization/about-permissions).
91
+ - name: appId | type: string | description: GUID of the app providing the content. You can get your app's GUID from its page in the [app dashboard](https://dev.wix.com/dc3/my-apps/).
92
+ - name: componentId | type: string | description: GUID of the component within the app it belongs to. You can get your component's GUID from its page in the [app dashboard](https://dev.wix.com/dc3/my-apps/).
93
+ - name: customFields | type: Array<CustomField> | description: Custom fields.
94
+ - name: title | type: string | description: Custom field title.
95
+ - name: translatedTitle | type: string | description: Translated custom field title.
96
+ - name: value | type: any | description: Custom field value.
97
+ - name: customSettings | type: CustomSettings | description: Additional settings for customization of the checkout process. > **Notes:** > * Custom settings can only be set when creating a checkout. > * To access and manage custom checkout page content, your app must have the permission scope named "Manage eCommerce - Admin Permissions". Learn more about [permission scopes](https://dev.wix.com/docs/build-apps/develop-your-app/access/authorization/about-permissions).
98
+ - name: disabledManualPayment | type: boolean | description: Whether to disable manual payment option for this checkout. Default: `false`
99
+ - name: disabledPolicyAgreementCheckbox | type: boolean | description: Whether to disable policy agreement checkout in the checkout page Default: `false`
100
+ - name: lockCouponCode | type: boolean | description: Whether to restrict the option to add or remove a coupon code on the checkout page. Default: `false`
101
+ - name: lockGiftCard | type: boolean | description: Whether to restrict the option to add or remove a gift card on the checkout page. Default: `false`
102
+ - name: extendedFields | type: ExtendedFields | description: Custom field data for the checkout 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.
103
+ - name: 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).
104
+ - name: externalReference | type: ExternalReference | description: References to an external app and resource associated with this checkout. Used for integration and tracking across different platforms.
105
+ - name: appId | type: string | description: GUID of the app associated with the purchase flow. For example, the Wix Pay Links app GUID.
106
+ - name: resourceId | type: string | description: Reference to an external resource GUID. Used to link the purchase flow to a specific entity in an external system. For example, a Wix Pay Link GUID.
107
+ - name: membershipOptions | type: MembershipOptions | description: Memberships to apply when creating the order.
108
+ - name: selectedMemberships | type: SelectedMemberships | description: Selected membership to apply to this checkout.
109
+ - name: memberships | type: Array<SelectedMembership> | description: Selected memberships.
110
+ - name: _id | type: string | description: Membership GUID.
111
+ - name: appId | type: string | description: GUID of the app providing this payment option.
112
+ - name: lineItemIds | type: Array<string> | description: IDs of the line items this membership applies to.
113
+ - name: shippingInfo | type: ShippingInfo | description: Shipping information.
114
+ - name: selectedCarrierServiceOption | type: SelectedCarrierServiceOption | description: Selected option out of the options allowed for the `region`.
115
+ - name: carrierId | type: string | description: This carrier's unique GUID
116
+ - name: code | type: string | description: Unique identifier of selected option. For example, "usps_std_overnight".
117
+ - name: deliveryAllocations | type: Array<DeliveryAllocation> | description: Delivery solution allocations to different delivery carriers and delivery regions
118
+ - name: applicableLineItems | type: ApplicableLineItems | description: Populated if the delivery solution is a partially supplied by this carrier.
119
+ - name: lineItemIds | type: Array<string> | description: Line items that the delivery solution is for.
120
+ - name: deliveryCarrier | type: Carrier | description: The delivery option's carrier details, could be multiple if the delivery option is a combination of multiple carriers
121
+ - name: appId | type: string | description: The carrier app id
122
+ - name: code | type: string | description: Unique code that acts as an GUID for a shipping rate. For example, `"usps_std_overnight"`.
123
+ - name: deliveryRegion | type: Region | description: The delivery region that are relevant for this delivery solution.
124
+ - name: _id | type: string | description: The delivery region id.
125
+ - name: name | type: string | description: The delivery region name.
126
+ - name: partial | type: boolean | description: If the delivery solution is a partial and doesn't apply to all items.
127
+ - name: shippingDestination | type: AddressWithContact | description: Shipping address and contact details.
128
+ - name: taxExemptGroupId | type: string | description: Tax exempt group GUID to use for tax exemptions.
129
+ - name: metadata | type: EventMetadata | description: none
130
+ - name: _id | type: string | description: Event GUID. With this GUID you can easily spot duplicated events and ignore them.
131
+ - name: entityEventSequence | type: string | description: A sequence number that indicates the order of updates to an entity. For example, if an entity was updated at 16:00 and then again at 16:01, the second update will always have a higher sequence number. You can use this number to make sure you're handling updates in the right order. Just save the latest sequence number on your end and compare it to the one in each new message. If the new message has an older (lower) number, you can safely ignore it.
132
+ - name: entityFqdn | type: string | description: Fully Qualified Domain Name of an entity. This is a unique identifier assigned to the API main business entities. For example, `wix.stores.catalog.product`, `wix.bookings.session`, `wix.payments.transaction`.
133
+ - name: entityId | type: string | description: GUID of the entity associated with the event.
134
+ - name: eventTime | type: Date | description: Event timestamp in [ISO-8601](https://en.wikipedia.org/wiki/ISO_8601) format and UTC time. For example, `2020-04-26T13:57:50.699Z`.
135
+ - name: eventType | type: string | description: Event type.
136
+ - name: identity | type: IdentificationData | description: The identification type and identity data.
137
+ - ONE-OF:
138
+ - name: anonymousVisitorId | type: string | description: GUID of a site visitor that has not logged in to the site.
139
+ - name: appId | type: string | description: GUID of an app.
140
+ - name: memberId | type: string | description: GUID of a site visitor that has logged in to the site.
141
+ - name: wixUserId | type: string | description: GUID of a Wix user (site owner, contributor, etc.).
142
+ - name: instanceId | type: string | description: App instance GUID.
143
+ - name: originatedFrom | type: string | description: If present, indicates the action that triggered the event.
144
+ - name: slug | type: string | description: Event action name, placed at the top level to make it easier for users to dispatch messages. For example: `created`/`updated`/`deleted`/`started`/`completed`/`email_opened`.
145
+ - name: triggeredByAnonymizeRequest | type: boolean | description: Whether the event was triggered as a result of a privacy regulation application (for example, GDPR).
146
+ Return type: PRIMITIVE<void>
147
+
148
+ ```
149
+ </type_definition>
150
+ </ecom_checkout_onCheckoutUpdated>