@wix/auto_sdk_bookings_bookings 1.0.41 → 1.0.42
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/build/cjs/index.d.ts +42 -45
- package/build/cjs/index.js.map +1 -1
- package/build/cjs/index.typings.d.ts +81 -57
- package/build/cjs/index.typings.js.map +1 -1
- package/build/cjs/meta.d.ts +23 -8
- package/build/cjs/meta.js.map +1 -1
- package/build/es/index.d.mts +42 -45
- package/build/es/index.mjs.map +1 -1
- package/build/es/index.typings.d.mts +81 -57
- package/build/es/index.typings.mjs.map +1 -1
- package/build/es/meta.d.mts +23 -8
- package/build/es/meta.mjs.map +1 -1
- package/build/internal/cjs/index.d.ts +42 -45
- package/build/internal/cjs/index.js.map +1 -1
- package/build/internal/cjs/index.typings.d.ts +81 -57
- package/build/internal/cjs/index.typings.js.map +1 -1
- package/build/internal/cjs/meta.d.ts +23 -8
- package/build/internal/cjs/meta.js.map +1 -1
- package/build/internal/es/index.d.mts +42 -45
- package/build/internal/es/index.mjs.map +1 -1
- package/build/internal/es/index.typings.d.mts +81 -57
- package/build/internal/es/index.typings.mjs.map +1 -1
- package/build/internal/es/meta.d.mts +23 -8
- package/build/internal/es/meta.mjs.map +1 -1
- package/package.json +2 -2
package/build/cjs/index.d.ts
CHANGED
|
@@ -531,17 +531,17 @@ interface CreateMultiServiceBookingSignature {
|
|
|
531
531
|
*
|
|
532
532
|
* ## When to call this method
|
|
533
533
|
*
|
|
534
|
-
* Create sequential appointments where customers book related services. For adding existing single-service bookings to an existing multi-service booking, call Add Bookings to Multi Service Booking ([SDK](https://dev.wix.com/docs/sdk/backend-modules/bookings/bookings-writer-v2/add-bookings-to-multi-service-booking) | [REST](https://dev.wix.com/docs/rest/business-solutions/bookings/bookings/bookings-writer-v2/add-bookings-to-multi-service-booking)) instead.
|
|
534
|
+
* Create sequential appointments where customers book related services together. For adding existing single-service bookings to an existing multi-service booking, call Add Bookings to Multi Service Booking ([SDK](https://dev.wix.com/docs/sdk/backend-modules/bookings/bookings-writer-v2/add-bookings-to-multi-service-booking) | [REST](https://dev.wix.com/docs/rest/business-solutions/bookings/bookings/bookings-writer-v2/add-bookings-to-multi-service-booking)) instead.
|
|
535
535
|
*
|
|
536
536
|
* ## Requirements and behavior
|
|
537
537
|
*
|
|
538
|
-
*
|
|
538
|
+
* __Package constraints__: Multi-service bookings support 2-8 appointment-based single-service bookings only (course and class bookings aren't supported). All single-service bookings must be at the same location with sequential scheduling and no gaps between appointments.
|
|
539
539
|
*
|
|
540
|
-
*
|
|
540
|
+
* __Timing specification__: You must provide complete `slot` details (`scheduleId`, `startDate`, `endDate`) for each single-service booking. Wix Bookings validates sequential timing but doesn't auto-calculate it.
|
|
541
541
|
*
|
|
542
|
-
*
|
|
542
|
+
* __Package pricing__: The total price equals the sum of individual services. Wix Bookings automatically syncs the payment status from the corresponding Wix eCommerce order ([SDK](https://dev.wix.com/docs/sdk/backend-modules/ecommerce/orders/introduction) | [REST](https://dev.wix.com/docs/rest/business-solutions/e-commerce/orders/introduction)) if the customer paid via an eCommerce checkout ([SDK](https://dev.wix.com/docs/sdk/backend-modules/ecommerce/checkout/introduction) | [REST](https://dev.wix.com/docs/rest/business-solutions/e-commerce/checkout/introduction)).
|
|
543
543
|
*
|
|
544
|
-
*
|
|
544
|
+
* __Package notifications__: Customers receive 1 unified notification for the entire multi-service booking. Wix Bookings doesn't send notifications for the package's individual single-service bookings.
|
|
545
545
|
*
|
|
546
546
|
* ## Related methods
|
|
547
547
|
*
|
|
@@ -569,7 +569,7 @@ interface RescheduleMultiServiceBookingSignature {
|
|
|
569
569
|
*
|
|
570
570
|
* This method reschedules single-service bookings within the multi-service booking while maintaining sequential order. You must specify exact new timing for each service to ensure they remain back-to-back with no gaps or overlaps.
|
|
571
571
|
*
|
|
572
|
-
* This method fails if it can't reschedule at least 1 single-service booking. You must provide the current revision number for each booking you're rescheduling to prevent conflicting changes.
|
|
572
|
+
* This method fails if it can't reschedule at least 1 single-service booking. You must provide the current revision number for each single-service booking you're rescheduling to prevent conflicting changes.
|
|
573
573
|
*
|
|
574
574
|
* See Reschedule Booking ([SDK](https://dev.wix.com/docs/sdk/backend-modules/bookings/bookings-writer-v2/reschedule-booking) | [REST](https://dev.wix.com/docs/rest/business-solutions/bookings/bookings/bookings-writer-v2/reschedule-booking)) for single-service booking rescheduling details.
|
|
575
575
|
* @param - ID of the multi-service booking to reschedule.
|
|
@@ -591,14 +591,11 @@ interface GetMultiServiceBookingAvailabilitySignature {
|
|
|
591
591
|
* - The relevant services' booking policies ([SDK](https://dev.wix.com/docs/sdk/backend-modules/bookings/booking-policies/introduction) | [REST](https://dev.wix.com/docs/rest/business-solutions/bookings/policies/booking-policies/introduction)).
|
|
592
592
|
* - The availability of all required resources ([SDK](https://dev.wix.com/docs/sdk/backend-modules/bookings/resources/introduction) | [REST](https://dev.wix.com/docs/rest/business-solutions/bookings/resources/introduction)).
|
|
593
593
|
*
|
|
594
|
-
*
|
|
595
|
-
*
|
|
596
|
-
* Check if an existing multi-service booking is still valid after business configuration changes. For example, staff changes, policy updates, or capacity modifications.
|
|
597
|
-
*
|
|
598
|
-
* ## When to call List Multi Service Availability Time Slots instead
|
|
594
|
+
* Call this method to check if an existing multi-service booking is still valid after business configuration changes.
|
|
595
|
+
* For example, staff changes, policy updates, or capacity modifications.
|
|
599
596
|
*
|
|
600
597
|
* For checking availability before creating new multi-service bookings, call List Multi Service Availability Time Slots
|
|
601
|
-
* ([SDK](https://dev.wix.com/docs/sdk/backend-modules/bookings/
|
|
598
|
+
* ([SDK](https://dev.wix.com/docs/sdk/backend-modules/bookings/time-slots/multi-service-availability-time-slots/list-multi-service-availability-time-slots) | [REST](https://dev.wix.com/docs/rest/business-solutions/bookings/time-slots/time-slots-v2/list-multi-service-availability-time-slots)) instead.
|
|
602
599
|
* @param - ID of the multi-service booking to retrieve.
|
|
603
600
|
*/
|
|
604
601
|
(multiServiceBookingId: string): Promise<NonNullablePaths<GetMultiServiceBookingAvailabilityResponse, `bookable` | `multiServiceBookingInfo`> & {
|
|
@@ -608,7 +605,7 @@ interface GetMultiServiceBookingAvailabilitySignature {
|
|
|
608
605
|
declare function cancelMultiServiceBooking$1(httpClient: HttpClient): CancelMultiServiceBookingSignature;
|
|
609
606
|
interface CancelMultiServiceBookingSignature {
|
|
610
607
|
/**
|
|
611
|
-
* Cancels a multi-service booking and all its single-service bookings.
|
|
608
|
+
* Cancels a multi-service booking and all its associated single-service bookings.
|
|
612
609
|
*
|
|
613
610
|
*
|
|
614
611
|
* Cancels the entire multi-service booking, updating the status of all single-service bookings to `CANCELED`.
|
|
@@ -633,8 +630,8 @@ interface MarkMultiServiceBookingAsPendingSignature {
|
|
|
633
630
|
*
|
|
634
631
|
* ## Status requirements
|
|
635
632
|
*
|
|
636
|
-
* -
|
|
637
|
-
* -
|
|
633
|
+
* - __Original status__: All single-service bookings must have `CREATED` status.
|
|
634
|
+
* - __Target status__: All bookings move to `PENDING` together (all-or-nothing operation).
|
|
638
635
|
*
|
|
639
636
|
* ## Checkout restrictions
|
|
640
637
|
*
|
|
@@ -643,9 +640,9 @@ interface MarkMultiServiceBookingAsPendingSignature {
|
|
|
643
640
|
*
|
|
644
641
|
* ## Additional updates
|
|
645
642
|
*
|
|
646
|
-
* -
|
|
647
|
-
* -
|
|
648
|
-
* -
|
|
643
|
+
* - __Payment status__: Updates if you specify a new `markAsPendingBookingsInfo.paymentStatus`.
|
|
644
|
+
* - __Customer notifications__: Send messages using `participantNotification`.
|
|
645
|
+
* - __Revision control__: Requires current revision numbers for all single-service bookings.
|
|
649
646
|
*
|
|
650
647
|
* See Mark Booking as Pending ([SDK](https://dev.wix.com/docs/sdk/backend-modules/bookings/bookings-writer-v2/mark-booking-as-pending) | [REST](https://dev.wix.com/docs/rest/business-solutions/bookings/bookings/bookings-writer-v2/mark-booking-as-pending)) for more details about marking single-service bookings as pending.
|
|
651
648
|
* @param - ID of the multi-service booking to mark as `PENDING`.
|
|
@@ -666,8 +663,8 @@ interface ConfirmMultiServiceBookingSignature {
|
|
|
666
663
|
*
|
|
667
664
|
* ## Status requirements
|
|
668
665
|
*
|
|
669
|
-
* -
|
|
670
|
-
* -
|
|
666
|
+
* - __Original status__: All single-service bookings must have `PENDING`, `CREATED`, or `WAITING_LIST` status.
|
|
667
|
+
* - __Target status__: All bookings move to `CONFIRMED` together (all-or-nothing operation).
|
|
671
668
|
*
|
|
672
669
|
* ## Checkout restrictions
|
|
673
670
|
*
|
|
@@ -676,9 +673,9 @@ interface ConfirmMultiServiceBookingSignature {
|
|
|
676
673
|
*
|
|
677
674
|
* ## Additional updates
|
|
678
675
|
*
|
|
679
|
-
* -
|
|
680
|
-
* -
|
|
681
|
-
* -
|
|
676
|
+
* - __Payment status__: Updates if you specify a new `confirmBookingsInfo.paymentStatus`.
|
|
677
|
+
* - __Customer notifications__: Send messages using `participantNotification`.
|
|
678
|
+
* - __Revision control__: Requires current revision numbers for all single-service bookings.
|
|
682
679
|
*
|
|
683
680
|
* See Confirm Booking ([SDK](https://dev.wix.com/docs/sdk/backend-modules/bookings/bookings-writer-v2/confirm-booking) | [REST](https://dev.wix.com/docs/rest/business-solutions/bookings/bookings/bookings-writer-v2/confirm-booking)) for more details about confirming single-service bookings.
|
|
684
681
|
* @param - ID of the multi-service booking to confirm its related bookings.
|
|
@@ -699,8 +696,8 @@ interface DeclineMultiServiceBookingSignature {
|
|
|
699
696
|
*
|
|
700
697
|
* ## Status requirements
|
|
701
698
|
*
|
|
702
|
-
* -
|
|
703
|
-
* -
|
|
699
|
+
* - __Original status__: All single-service bookings must have `PENDING`, `CREATED`, or `WAITING_LIST` status.
|
|
700
|
+
* - __Target status__: All bookings move to `DECLINED` together (all-or-nothing operation).
|
|
704
701
|
*
|
|
705
702
|
* ## Checkout restrictions
|
|
706
703
|
*
|
|
@@ -709,9 +706,9 @@ interface DeclineMultiServiceBookingSignature {
|
|
|
709
706
|
*
|
|
710
707
|
* ## Additional updates
|
|
711
708
|
*
|
|
712
|
-
* -
|
|
713
|
-
* -
|
|
714
|
-
* -
|
|
709
|
+
* - __Payment status__: Updates if you specify a new `declineBookingsInfo.paymentStatus`.
|
|
710
|
+
* - __Customer notifications__: Send messages using `participantNotification`.
|
|
711
|
+
* - __Revision control__: Requires current revision numbers for all single-service bookings.
|
|
715
712
|
*
|
|
716
713
|
* Refer to Decline Booking ([SDK](https://dev.wix.com/docs/sdk/backend-modules/bookings/bookings-writer-v2/decline-booking) | [REST](https://dev.wix.com/docs/rest/business-solutions/bookings/bookings/bookings-writer-v2/decline-booking)) for more details about declining single-service bookings.
|
|
717
714
|
* @param - ID of the multi-service booking to decline.
|
|
@@ -732,13 +729,13 @@ interface BulkGetMultiServiceBookingAllowedActionsSignature {
|
|
|
732
729
|
* - `cancel`: Whether the customer can cancel the multi-service booking.
|
|
733
730
|
* - `reschedule`: Whether the customer can adjust the multi-service booking's timing.
|
|
734
731
|
*
|
|
735
|
-
*
|
|
732
|
+
* Bear the following considerations in mind when calling this method:
|
|
736
733
|
*
|
|
737
|
-
*
|
|
734
|
+
* __Real-time validation__: Wix Bookings calculates allowed actions based on current multi-service booking status, booking policies ([SDK](https://dev.wix.com/docs/sdk/backend-modules/bookings/booking-policies/introduction) | [REST](https://dev.wix.com/docs/rest/business-solutions/bookings/policies/booking-policies/introduction)), and available resources ([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)) at the time of the call.
|
|
738
735
|
*
|
|
739
|
-
*
|
|
736
|
+
* __Permission context__: Depending on the permissions of the calling [identity](https://dev.wix.com/build-apps/develop-your-app/about-identities), you may see different allowed actions for the same multi-service booking. For example, if the identity has permissions to read only part of the multi-service booking, the response indicates which single-service bookings the identity can read.
|
|
740
737
|
*
|
|
741
|
-
*
|
|
738
|
+
* __Status dependencies__: Allowed actions change as bookings progress through their lifecycle (`CREATED` → `PENDING` → `CONFIRMED`/`DECLINED` → `CANCELED`).
|
|
742
739
|
* Bookings can skip `PENDING` and move directly from `CREATED` to `CONFIRMED`/`DECLINED` based on service configuration.
|
|
743
740
|
* @param - IDs of the multi-service bookings to retrieve allowed actions for.
|
|
744
741
|
*/
|
|
@@ -750,12 +747,12 @@ interface GetMultiServiceBookingSignature {
|
|
|
750
747
|
* Retrieves a multi-service booking and all its associated single-service bookings.
|
|
751
748
|
*
|
|
752
749
|
*
|
|
753
|
-
* Returns the complete multi-service booking information including its ID,
|
|
750
|
+
* Returns the complete multi-service booking information including its ID, associated single-service bookings, and the total number of scheduled single-service bookings.
|
|
754
751
|
*
|
|
755
|
-
* If you call
|
|
752
|
+
* If you call on behalf of an [identity](https://dev.wix.com/docs/build-apps/develop-your-app/access/about-identities) with permissions to read only part of the multi-service booking, only the permitted single-service bookings are retrieved.
|
|
756
753
|
* The returned total number includes single-service bookings for which you don't have permissions.
|
|
757
754
|
*
|
|
758
|
-
* See Query Extended Bookings ([SDK](https://dev.wix.com/docs/sdk/backend-modules/bookings/bookings
|
|
755
|
+
* See Query Extended Bookings ([SDK](https://dev.wix.com/docs/sdk/backend-modules/bookings/extended-bookings/query-extended-bookings) | [REST](https://dev.wix.com/docs/rest/business-solutions/bookings/bookings/bookings-reader-v2/query-extended-bookings)) for details about retrieving individual single-service bookings and additional metadata.
|
|
759
756
|
* @param - ID of the multi-service booking.
|
|
760
757
|
* @returns Retrieved multi-service booking.
|
|
761
758
|
*/
|
|
@@ -780,10 +777,10 @@ interface AddBookingsToMultiServiceBookingSignature {
|
|
|
780
777
|
*
|
|
781
778
|
* ## Requirements and limitations
|
|
782
779
|
*
|
|
783
|
-
* -
|
|
784
|
-
* -
|
|
785
|
-
* -
|
|
786
|
-
* -
|
|
780
|
+
* - __Maximum capacity__: The total number of single-service bookings can't exceed 8.
|
|
781
|
+
* - __Booking eligibility__: You can add only independent single-service bookings that aren't part of another multi-service booking.
|
|
782
|
+
* - __Status compatibility__: Added bookings must have compatible status with the target multi-service booking.
|
|
783
|
+
* - __Revision control__: You must provide current revision numbers for all single-service bookings to add.
|
|
787
784
|
* @param - ID of the multi-service booking.
|
|
788
785
|
*/
|
|
789
786
|
(multiServiceBookingId: string, options?: NonNullablePaths<AddBookingsToMultiServiceBookingOptions, `bookings` | `bookings.${number}.bookingId` | `bookings.${number}.revision`>): Promise<NonNullablePaths<AddBookingsToMultiServiceBookingResponse, `bookings` | {
|
|
@@ -800,21 +797,21 @@ interface RemoveBookingsFromMultiServiceBookingSignature {
|
|
|
800
797
|
*
|
|
801
798
|
* ## Removal options
|
|
802
799
|
*
|
|
803
|
-
*
|
|
800
|
+
* __Remove all permitted bookings__: If you specify an empty `bookings` array, all single-service bookings for which the call's [identity](https://dev.wix.com/docs/build-apps/develop-your-app/access/about-identities) has read permissions are removed from the multi-service booking.
|
|
804
801
|
*
|
|
805
|
-
*
|
|
802
|
+
* __Selective removal__: Specify single-service booking IDs and revisions to remove only specific single-service bookings from the package.
|
|
806
803
|
*
|
|
807
|
-
*
|
|
804
|
+
* __Sequential scheduling__: To maintain sequential scheduling, remove only first or last single-service bookings. For middle bookings, first reschedule all relevant single-service bookings to eliminate gaps. To do so, call Reschedule Multi Service Booking ([SDK](https://dev.wix.com/docs/sdk/backend-modules/bookings/bookings-writer-v2/reschedule-multi-service-booking) | [REST](https://dev.wix.com/docs/rest/business-solutions/bookings/bookings/multi-service-bookings/reschedule-multi-service-booking)) before removing the unwanted bookings.
|
|
808
805
|
*
|
|
809
806
|
* ## Removal behavior
|
|
810
807
|
*
|
|
811
|
-
*
|
|
808
|
+
* __Independent bookings__: Removed single-service bookings become independent bookings.
|
|
812
809
|
* You can manage them using single-service booking methods.
|
|
813
810
|
*
|
|
814
|
-
*
|
|
811
|
+
* __Automatic cleanup__: Multi-service bookings must contain at least 2 services.
|
|
815
812
|
* If removal results in only 1 remaining single-service booking for the multi-service booking, the entire multi-service booking is deleted and the remaining single-service booking becomes a standalone booking.
|
|
816
813
|
*
|
|
817
|
-
*
|
|
814
|
+
* __Revision control__: Specify current revision numbers to prevent conflicting modifications during the removal process.
|
|
818
815
|
* @param - ID of the multi-service booking.
|
|
819
816
|
*/
|
|
820
817
|
(multiServiceBookingId: string, options?: RemoveBookingsFromMultiServiceBookingOptions): Promise<NonNullablePaths<RemoveBookingsFromMultiServiceBookingResponse, `bookings` | {
|