@wix/auto_sdk_bookings_bookings 1.0.82 → 1.0.83

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.
@@ -5,14 +5,13 @@ import '@wix/sdk-types';
5
5
  interface Booking extends BookingParticipantsInfoOneOf {
6
6
  /**
7
7
  * Total number of participants.
8
- * When creating a booking, use this field only if the relevant service has fixed pricing and doesn't offer variants and options ([SDK](https://dev.wix.com/docs/sdk/backend-modules/bookings/service-options-and-variants/introduction) | [REST](https://dev.wix.com/docs/rest/business-solutions/bookings/services/service-options-and-variants/introduction)).
8
+ * When creating a booking, use this field only if the relevant service has fixed pricing and doesn't offer [variants and options](https://dev.wix.com/docs/rest/business-solutions/bookings/services/service-options-and-variants/introduction).
9
9
  * @min 1
10
10
  */
11
11
  totalParticipants?: number;
12
12
  /**
13
13
  * Information about the booked service choices and participant count for each choice.
14
- * When creating a booking, use this field only if the booking includes multiple service variants
15
- * ([SDK](https://dev.wix.com/docs/sdk/backend-modules/bookings/service-options-and-variants/introduction) | [REST](https://dev.wix.com/docs/rest/business-solutions/bookings/services/service-options-and-variants/introduction)).
14
+ * When creating a booking, use this field only if the booking includes multiple [service variants](https://dev.wix.com/docs/rest/business-solutions/bookings/services/service-options-and-variants/introduction).
16
15
  *
17
16
  * For example, use this for a spa package booking that includes different service levels:
18
17
  * - 2 participants chose "Standard Package".
@@ -43,8 +42,7 @@ interface Booking extends BookingParticipantsInfoOneOf {
43
42
  */
44
43
  bookedEntity?: BookedEntity;
45
44
  /**
46
- * Contact details of the site visitor or member
47
- * ([SDK](https://dev.wix.com/docs/sdk/backend-modules/members/members/introduction) | [REST](https://dev.wix.com/docs/rest/crm/members-contacts/members/members/introduction))
45
+ * Contact details of the site visitor or [member](https://dev.wix.com/docs/api-reference/crm/members-contacts/members/members/introduction))
48
46
  * making the booking.
49
47
  */
50
48
  contactDetails?: ContactDetails;
@@ -70,8 +68,7 @@ interface Booking extends BookingParticipantsInfoOneOf {
70
68
  status?: BookingStatusWithLiterals;
71
69
  /**
72
70
  * The payment status of the booking. This field automatically syncs with the
73
- * `paymentStatus` of the corresponding eCommerce order
74
- * ([SDK](https://dev.wix.com/docs/sdk/backend-modules/ecom/orders/setup)| [REST](https://dev.wix.com/docs/rest/business-solutions/e-commerce/orders/introduction))
71
+ * `paymentStatus` of the corresponding [eCommerce order](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/orders/introduction)
75
72
  * when customers use Wix eCommerce checkout.
76
73
  *
77
74
  * ### Integration patterns
@@ -79,17 +76,17 @@ interface Booking extends BookingParticipantsInfoOneOf {
79
76
  * __When using Wix eCommerce checkout__: Wix Bookings automatically syncs the payment status based on the eCommerce order's payment status.
80
77
  * Do not manually update this field.
81
78
  *
82
- * __When using custom payment flows__: You can manually update the payment status with Confirm Booking or Decline Booking ([SDK](https://dev.wix.com/docs/sdk/backend-modules/bookings/bookings/confirm-or-decline-booking) | [REST](https://dev.wix.com/docs/rest/business-solutions/bookings/bookings/bookings-writer-v2/confirm-or-decline-booking)) to reflect the customer's payment state.
79
+ * __When using custom payment flows__: You can manually update the payment status with [Confirm Booking or Decline Booking](https://dev.wix.com/docs/api-reference/business-solutions/bookings/bookings/bookings-writer-v2/confirm-or-decline-booking) to reflect the customer's payment state.
83
80
  *
84
- * __For membership/pricing plan payments__: Wix Bookings automatically manages the payment status when customers pay with an active pricing plan ([SDK](https://dev.wix.com/docs/sdk/backend-modules/pricing-plans/plans/introduction) | [REST](https://dev.wix.com/docs/rest/business-solutions/pricing-plans/pricing-plans/introduction)) subscription.
81
+ * __For membership/pricing plan payments__: Wix Bookings automatically manages the payment status when customers pay with an active [pricing plan](https://dev.wix.com/docs/api-reference/business-solutions/pricing-plans/pricing-plans/introduction) subscription.
85
82
  *
86
83
  * All payment statuses are supported for every booking `status`.
87
84
  */
88
85
  paymentStatus?: PaymentStatusWithLiterals;
89
86
  /**
90
- * Payment option selected by the customer. If the customer hasn't completed their checkout, they may still change the payment method. Must be one of the payment options offered by the service ([SDK](https://dev.wix.com/docs/sdk/backend-modules/bookings/services/setup) | [REST](https://dev.wix.com/docs/rest/business-solutions/bookings/services/services-v2/introduction)), unless `skipSelectedPaymentOptionValidation` is `true`.
87
+ * Payment option selected by the customer. If the customer hasn't completed their checkout, they may still change the payment method. Must be one of the payment options offered by the [service](https://dev.wix.com/docs/api-reference/business-solutions/bookings/services/services-v2/introduction), unless `skipSelectedPaymentOptionValidation` is `true`.
91
88
  *
92
- * When undefined during an eCommerce checkout ([SDK](https://dev.wix.com/docs/sdk/backend-modules/ecom/checkout/setup) | [REST](https://dev.wix.com/docs/rest/business-solutions/e-commerce/checkout/introduction)), Wix Bookings uses the service's default payment option
89
+ * When undefined during an [eCommerce checkout](https://dev.wix.com/docs/api-reference/business-solutions/e-commerce/checkout/introduction), Wix Bookings uses the service's default payment option
93
90
  */
94
91
  selectedPaymentOption?: SelectedPaymentOptionWithLiterals;
95
92
  /**
@@ -139,15 +136,13 @@ interface Booking extends BookingParticipantsInfoOneOf {
139
136
  */
140
137
  doubleBooked?: boolean | null;
141
138
  /**
142
- * ID of the form submission
143
- * ([SDK](https://dev.wix.com/docs/sdk/backend-modules/forms/submissions/introduction) | [REST](https://dev.wix.com/docs/rest/crm/forms/form-submissions/introduction))
139
+ * ID of the [form submission](https://dev.wix.com/docs/rest/crm/forms/form-submissions/introduction)
144
140
  * associated with this booking.
145
141
  * @format GUID
146
142
  */
147
143
  formSubmissionId?: string | null;
148
144
  /**
149
- * ID of the form
150
- * ([SDK](https://dev.wix.com/docs/sdk/backend-modules/forms/introduction) | [REST](https://dev.wix.com/docs/rest/crm/forms/form-schemas/form-object))
145
+ * ID of the [form](https://dev.wix.com/docs/rest/crm/forms/form-schemas/form-object)
151
146
  * associated with this booking. The value depends on how the
152
147
  * booking was created:
153
148
  * - For bookings created with Create Booking or Bulk Create Booking, `formId`
@@ -164,14 +159,13 @@ interface Booking extends BookingParticipantsInfoOneOf {
164
159
  interface BookingParticipantsInfoOneOf {
165
160
  /**
166
161
  * Total number of participants.
167
- * When creating a booking, use this field only if the relevant service has fixed pricing and doesn't offer variants and options ([SDK](https://dev.wix.com/docs/sdk/backend-modules/bookings/service-options-and-variants/introduction) | [REST](https://dev.wix.com/docs/rest/business-solutions/bookings/services/service-options-and-variants/introduction)).
162
+ * When creating a booking, use this field only if the relevant service has fixed pricing and doesn't offer [variants and options](https://dev.wix.com/docs/rest/business-solutions/bookings/services/service-options-and-variants/introduction).
168
163
  * @min 1
169
164
  */
170
165
  totalParticipants?: number;
171
166
  /**
172
167
  * Information about the booked service choices and participant count for each choice.
173
- * When creating a booking, use this field only if the booking includes multiple service variants
174
- * ([SDK](https://dev.wix.com/docs/sdk/backend-modules/bookings/service-options-and-variants/introduction) | [REST](https://dev.wix.com/docs/rest/business-solutions/bookings/services/service-options-and-variants/introduction)).
168
+ * When creating a booking, use this field only if the booking includes multiple [service variants](https://dev.wix.com/docs/rest/business-solutions/bookings/services/service-options-and-variants/introduction).
175
169
  *
176
170
  * For example, use this for a spa package booking that includes different service levels:
177
171
  * - 2 participants chose "Standard Package".
@@ -197,8 +191,7 @@ declare enum MultiServiceBookingType {
197
191
  type MultiServiceBookingTypeWithLiterals = MultiServiceBookingType | 'SEQUENTIAL_BOOKINGS' | 'SEPARATE_BOOKINGS' | 'PARALLEL_BOOKINGS';
198
192
  interface BookedEntity extends BookedEntityItemOneOf {
199
193
  /**
200
- * Booked slot
201
- * ([SDK](https://dev.wix.com/docs/sdk/backend-modules/bookings/availability-calendar/query-availability) | [REST](https://dev.wix.com/docs/rest/business-solutions/bookings/bookings-and-time-slots/time-slots/availability-calendar/query-availability)).
194
+ * [Booked slot](https://dev.wix.com/docs/rest/business-solutions/bookings/bookings-and-time-slots/time-slots/availability-calendar/query-availability).
202
195
  *
203
196
  * Specify `slot` when creating bookings for:
204
197
  * - __Appointment-based services__: Individual sessions with service providers (consultations, treatments).
@@ -210,8 +203,7 @@ interface BookedEntity extends BookedEntityItemOneOf {
210
203
  */
211
204
  slot?: BookedSlot;
212
205
  /**
213
- * Booked schedule
214
- * ([SDK](https://dev.wix.com/docs/sdk/backend-modules/calendar/schedules/introduction) | [REST](https://dev.wix.com/docs/rest/business-management/calendar/schedules-v3/introduction)).
206
+ * [Booked schedule](https://dev.wix.com/docs/rest/business-management/calendar/schedules-v3/introduction).
215
207
  *
216
208
  * Specify `schedule` when creating bookings for:
217
209
  * - __Course services__: Multi-session offerings spanning weeks or months (educational courses, training programs).
@@ -237,8 +229,7 @@ interface BookedEntity extends BookedEntityItemOneOf {
237
229
  /** @oneof */
238
230
  interface BookedEntityItemOneOf {
239
231
  /**
240
- * Booked slot
241
- * ([SDK](https://dev.wix.com/docs/sdk/backend-modules/bookings/availability-calendar/query-availability) | [REST](https://dev.wix.com/docs/rest/business-solutions/bookings/bookings-and-time-slots/time-slots/availability-calendar/query-availability)).
232
+ * [Booked slot](https://dev.wix.com/docs/rest/business-solutions/bookings/bookings-and-time-slots/time-slots/availability-calendar/query-availability).
242
233
  *
243
234
  * Specify `slot` when creating bookings for:
244
235
  * - __Appointment-based services__: Individual sessions with service providers (consultations, treatments).
@@ -250,8 +241,7 @@ interface BookedEntityItemOneOf {
250
241
  */
251
242
  slot?: BookedSlot;
252
243
  /**
253
- * Booked schedule
254
- * ([SDK](https://dev.wix.com/docs/sdk/backend-modules/calendar/schedules/introduction) | [REST](https://dev.wix.com/docs/rest/business-management/calendar/schedules-v3/introduction)).
244
+ * [Booked schedule](https://dev.wix.com/docs/rest/business-management/calendar/schedules-v3/introduction).
255
245
  *
256
246
  * Specify `schedule` when creating bookings for:
257
247
  * - __Course services__: Multi-session offerings spanning weeks or months (educational courses, training programs).
@@ -267,8 +257,7 @@ interface BookedSlot {
267
257
  /** Schedule ID. */
268
258
  scheduleId?: string;
269
259
  /**
270
- * ID of the corresponding event
271
- * ([SDK](https://dev.wix.com/docs/sdk/backend-modules/calendar/events/introduction) | [REST](https://dev.wix.com/docs/rest/business-management/calendar/events-v3/introduction)).
260
+ * ID of the corresponding [event](https://dev.wix.com/docs/rest/business-management/calendar/events-v3/introduction).
272
261
  * Available for both appointment and class bookings, not available for course bookings.
273
262
  * For appointment-based services, Wix Bookings automatically populates `eventId` when the booking `status` changes to `CONFIRMED`.
274
263
  * For class bookings, Wix Bookings automatically populates `eventId` upon booking creation.
@@ -286,9 +275,8 @@ interface BookedSlot {
286
275
  */
287
276
  timezone?: string | null;
288
277
  /**
289
- * Primary resource
290
- * ([SDK](https://dev.wix.com/docs/sdk/backend-modules/bookings/resources/introduction) | [REST](https://dev.wix.com/docs/rest/business-solutions/bookings/resources/resources-v2/introduction)) for the booking.
291
- * For example, the staff member ([SDK](https://dev.wix.com/docs/sdk/backend-modules/bookings/staff-members/introduction) | [REST](https://dev.wix.com/docs/rest/business-solutions/bookings/staff-members/introduction)) providing the service.
278
+ * [Primary resource](https://dev.wix.com/docs/rest/business-solutions/bookings/resources/resources-v2/introduction) for the booking.
279
+ * For example, the [staff member](https://dev.wix.com/docs/rest/business-solutions/bookings/staff-members/introduction) providing the service.
292
280
  */
293
281
  resource?: BookedResource;
294
282
  /** Location where the session takes place. */
@@ -370,7 +358,7 @@ declare enum SelectionMethod {
370
358
  /** @enumType */
371
359
  type SelectionMethodWithLiterals = SelectionMethod | 'UNKNOWN_SELECTION_METHOD' | 'SPECIFIC_RESOURCE' | 'ANY_RESOURCE' | 'NO_SELECTION';
372
360
  interface BookedSchedule {
373
- /** Schedule ID ([SDK](https://dev.wix.com/docs/sdk/backend-modules/calendar/schedules/introduction) | [REST](https://dev.wix.com/docs/rest/business-management/calendar/schedules-v3/introduction)). */
361
+ /** [Schedule ID](https://dev.wix.com/docs/rest/business-management/calendar/schedules-v3/introduction). */
374
362
  scheduleId?: string;
375
363
  /**
376
364
  * Booked service ID.
@@ -378,7 +366,7 @@ interface BookedSchedule {
378
366
  */
379
367
  serviceId?: string | null;
380
368
  /**
381
- * Location ([SDK](https://dev.wix.com/docs/sdk/backend-modules/business-tools/locations/introduction) | [REST](https://dev.wix.com/docs/rest/business-management/locations/introduction)) where the schedule's sessions take place.
369
+ * [Location](https://dev.wix.com/docs/rest/business-management/locations/introduction) where the schedule's sessions take place.
382
370
  * @readonly
383
371
  */
384
372
  location?: Location;
@@ -522,26 +510,18 @@ type ValueTypeWithLiterals = ValueType | 'SHORT_TEXT' | 'LONG_TEXT' | 'CHECK_BOX
522
510
  declare enum BookingStatus {
523
511
  /** The booking was created, but the customer hasn't completed the related eCommerce order yet. */
524
512
  CREATED = "CREATED",
525
- /**
526
- * The merchant has confirmed the booking and it appears in the business calendar. Merchants can set up their services
527
- * ([SDK](https://dev.wix.com/docs/sdk/backend-modules/bookings/services/setup) | [REST](https://dev.wix.com/docs/rest/business-solutions/bookings/services/services-v2/introduction)) to automatically confirm all `PENDING` bookings.
528
- */
513
+ /** The merchant has confirmed the booking and it appears in the business calendar. Merchants can set up their [services](https://dev.wix.com/docs/rest/business-solutions/bookings/services/services-v2/introduction) to automatically confirm all `PENDING` bookings. */
529
514
  CONFIRMED = "CONFIRMED",
530
515
  /**
531
- * The customer has canceled the booking. Depending on the relevant service's policy snapshot
532
- * ([SDK](https://dev.wix.com/docs/sdk/backend-modules/bookings/booking-policy-snapshots/introduction) | [REST](https://dev.wix.com/docs/rest/business-solutions/bookings/policies/booking-policy-snapshots/introduction))
533
- * they may have to pay a cancellation fee ([SDK](https://dev.wix.com/docs/sdk/backend-modules/bookings/booking-fees/introduction) | [REST](https://dev.wix.com/docs/rest/business-solutions/bookings/pricing/booking-fees/introduction)).
516
+ * The customer has canceled the booking. Depending on the relevant service's [policy snapshot](https://dev.wix.com/docs/rest/business-solutions/bookings/policies/booking-policy-snapshots/introduction)
517
+ * they may have to pay a [cancellation fee](https://dev.wix.com/docs/rest/business-solutions/bookings/pricing/booking-fees/introduction).
534
518
  */
535
519
  CANCELED = "CANCELED",
536
520
  /** The merchant must manually confirm the booking before it appears in the business calendar. */
537
521
  PENDING = "PENDING",
538
522
  /** The merchant has declined the booking before the customer was charged. */
539
523
  DECLINED = "DECLINED",
540
- /**
541
- * The booking is on a waitlist.
542
- * Currently, you can't call Register to Waitlist ([REST](https://dev.wix.com/docs/rest/business-solutions/bookings/bookings/waitlist/register-to-waitlist)) for course or appointment bookings, even though this is supported in live sites.
543
- * You can call Register to Waitlist only for class session bookings.
544
- */
524
+ /** Currently, you can't call [Register to Waitlist](https://dev.wix.com/docs/rest/business-solutions/bookings/bookings/waitlist/register-to-waitlist) for course or appointment bookings, even though this is supported in live sites. */
545
525
  WAITING_LIST = "WAITING_LIST"
546
526
  }
547
527
  /** @enumType */
@@ -708,8 +688,7 @@ interface FlowControlSettings {
708
688
  skipAvailabilityValidation?: boolean;
709
689
  /**
710
690
  * Whether the booking's `status` is automatically updated to `CONFIRMED` when
711
- * the customer completes the eCommerce checkout
712
- * ([SDK](https://dev.wix.com/docs/sdk/backend-modules/ecom/checkout/setup) | [REST](https://dev.wix.com/docs/rest/business-solutions/e-commerce/checkout/introduction)),
691
+ * the customer completes the [eCommerce checkout](https://dev.wix.com/docs/rest/business-solutions/e-commerce/checkout/introduction),
713
692
  * regardless of whether the relevant service requires manual business confirmation.
714
693
  */
715
694
  skipBusinessConfirmation?: boolean;
@@ -746,7 +725,7 @@ interface ParticipantChoices {
746
725
  }
747
726
  interface ServiceChoices {
748
727
  /**
749
- * Number of participants for this variant ([SDK](https://dev.wix.com/docs/sdk/backend-modules/bookings/service-options-and-variants/introduction) | [REST](https://dev.wix.com/docs/rest/business-solutions/bookings/services/service-options-and-variants/introduction)).
728
+ * Number of participants for this [variant](https://dev.wix.com/docs/rest/business-solutions/bookings/services/service-options-and-variants/introduction).
750
729
  * @min 1
751
730
  */
752
731
  numberOfParticipants?: number | null;
@@ -1616,8 +1595,7 @@ interface ConfirmOrDeclineBookingRequest {
1616
1595
  bookingId: string;
1617
1596
  /**
1618
1597
  * Current payment status of the booking when using a custom checkout page and
1619
- * not the *eCommerce checkout*
1620
- * ([SDK](https://dev.wix.com/docs/sdk/backend-modules/ecom/checkout/setup) | [REST](https://dev.wix.com/docs/rest/business-solutions/e-commerce/checkout/introduction)).
1598
+ * not the [eCommerce checkout](https://dev.wix.com/docs/rest/business-solutions/e-commerce/checkout/introduction).
1621
1599
  *
1622
1600
  * The booking is declined if there is a double booking conflict and you provide
1623
1601
  * one of these payment statuses: `UNDEFINED`, `NOT_PAID`, `REFUNDED`, or `EXEMPT`.
@@ -1646,8 +1624,7 @@ interface BulkConfirmOrDeclineBookingRequestBookingDetails {
1646
1624
  bookingId?: string;
1647
1625
  /**
1648
1626
  * Current payment status of the booking when using a custom checkout page and
1649
- * not the *eCommerce checkout*
1650
- * ([SDK](https://dev.wix.com/docs/sdk/backend-modules/ecom/checkout/setup) | [REST](https://dev.wix.com/docs/rest/business-solutions/e-commerce/checkout/introduction)).
1627
+ * not the [eCommerce checkout](https://dev.wix.com/docs/rest/business-solutions/e-commerce/checkout/introduction).
1651
1628
  *
1652
1629
  * The booking is declined if there is a double booking conflict and you provide
1653
1630
  * one of these payment statuses: `UNDEFINED`, `NOT_PAID`, `REFUNDED`, or `EXEMPT`.
@@ -2868,12 +2845,12 @@ interface RescheduleMultiServiceBookingRequest {
2868
2845
  }
2869
2846
  interface RescheduleBookingInfo extends RescheduleBookingInfoParticipantsInfoOneOf {
2870
2847
  /**
2871
- * Total number of participants. Available only for services with variants ([SDK](https://dev.wix.com/docs/sdk/backend-modules/bookings/service-options-and-variants/introduction) | [REST](https://dev.wix.com/docs/rest/business-solutions/bookings/services/service-options-and-variants/introduction)).
2848
+ * Total number of participants. Available only for services with [variants](https://dev.wix.com/docs/rest/business-solutions/bookings/services/service-options-and-variants/introduction).
2872
2849
  * Specify when all participants book the same variant.
2873
2850
  */
2874
2851
  totalParticipants?: number;
2875
2852
  /**
2876
- * Information about the service choices to book. Available only for services with variants ([SDK](https://dev.wix.com/docs/sdk/backend-modules/bookings/service-options-and-variants/introduction) | [REST](https://dev.wix.com/docs/rest/business-solutions/bookings/services/service-options-and-variants/introduction)).
2853
+ * Information about the service choices to book. Available only for services with [variants](https://dev.wix.com/docs/rest/business-solutions/bookings/services/service-options-and-variants/introduction).
2877
2854
  * Specify when not all participants book the same variant.
2878
2855
  */
2879
2856
  participantsChoices?: ParticipantChoices;
@@ -2893,12 +2870,12 @@ interface RescheduleBookingInfo extends RescheduleBookingInfoParticipantsInfoOne
2893
2870
  /** @oneof */
2894
2871
  interface RescheduleBookingInfoParticipantsInfoOneOf {
2895
2872
  /**
2896
- * Total number of participants. Available only for services with variants ([SDK](https://dev.wix.com/docs/sdk/backend-modules/bookings/service-options-and-variants/introduction) | [REST](https://dev.wix.com/docs/rest/business-solutions/bookings/services/service-options-and-variants/introduction)).
2873
+ * Total number of participants. Available only for services with [variants](https://dev.wix.com/docs/rest/business-solutions/bookings/services/service-options-and-variants/introduction).
2897
2874
  * Specify when all participants book the same variant.
2898
2875
  */
2899
2876
  totalParticipants?: number;
2900
2877
  /**
2901
- * Information about the service choices to book. Available only for services with variants ([SDK](https://dev.wix.com/docs/sdk/backend-modules/bookings/service-options-and-variants/introduction) | [REST](https://dev.wix.com/docs/rest/business-solutions/bookings/services/service-options-and-variants/introduction)).
2878
+ * Information about the service choices to book. Available only for services with [variants](https://dev.wix.com/docs/rest/business-solutions/bookings/services/service-options-and-variants/introduction).
2902
2879
  * Specify when not all participants book the same variant.
2903
2880
  */
2904
2881
  participantsChoices?: ParticipantChoices;