mts-booking-library 1.3.25 → 2.0.0

package/lib/booking/booking.d.ts

@@ -1,8 +1,9 @@
 import { MTSConfig, MTSEnvs } from "../config";
 import { ErrorResponse } from "../types/ErrorResponse";
-import { processedStepsToStatus } from "../types/common/Cart";
-import { GetPaymentInformationFromGatewayResponse, GetSellerGatewaysResponse, PaymentMethods, IssueTicketsResponse } from "../types/common/Payment";
-import { Buyer, GetBuyerPassengersDetailsResponse, GetBuyerRequest } from "../types/common/Person";
+import { Cart, processedStepsToStatus } from "../types/common/Cart";
+import { GetExtrasForBookingResponse, GetExtrasResponse } from "../types/common/Extra";
+import { GetPaymentInformationFromGatewayResponse, GetSellerGatewaysResponse, PaymentMethods, IssueCartResponse } from "../types/common/Payment";
+import { PersonDetails, GetBuyerPassengersDetailsResponse, GetPersonRequest } from "../types/common/Person";
 import { AddReductionRequest } from "../types/common/Reduction";
 export declare abstract class Booking {
     private sellerId?;
@@ -20,8 +21,6 @@ export declare abstract class Booking {
      * - The third tells whether the section is required. <br/>
      */
     bookingStepsToStatus: processedStepsToStatus;
-    /** @deprecated Please use {@link cartGuid} instead */
-    cartId: number | undefined;
     cartGuid: string | undefined;
     bookingDueDate: Date | undefined;
     /**
@@ -42,6 +41,7 @@ export declare abstract class Booking {
     renewAccessToken(access_token: string): void;
     callGetApi(url: string): Promise<ErrorResponse | any>;
     callPostApi(url: string, body: any): Promise<any>;
+    callPutApi(url: string, body: any): Promise<any>;
     callDeleteApi(url: string): Promise<ErrorResponse | any>;
     getBookingStepsToStatus(): processedStepsToStatus;
     changeCurrency(currency: Booking.Currencies): void;
@@ -55,8 +55,13 @@ export declare abstract class Booking {
     abstract deleteCart(): Promise<ErrorResponse | any>;
     abstract resetBooking(): void;
     abstract getBuyerPassengersDetails(): Promise<ErrorResponse | GetBuyerPassengersDetailsResponse>;
-    abstract getBuyer(request: GetBuyerRequest): Promise<ErrorResponse | Buyer>;
     abstract updateBuyerPassengersDetails(request: any): Promise<ErrorResponse | boolean>;
+    /**
+     * @description This method shall be called when the user wants to retrieve information about an esisting buyer.
+     * @param {GetPersonRequest} request The object containing the parameters to search the buyer.
+     * @returns An object of type {@link PersonDetails} containing the buyer information, or an {@link ErrorResponse} object in case of error.
+     */
+    getPerson(request: GetPersonRequest): Promise<ErrorResponse | PersonDetails>;
     abstract addReduction(request: AddReductionRequest): Promise<ErrorResponse | boolean>;
     abstract removeReduction(tripId: number): Promise<ErrorResponse | boolean>;
     abstract useWallet(): Promise<ErrorResponse | boolean>;
@@ -79,9 +84,31 @@ export declare abstract class Booking {
      * @description This method shall be used to issue the tickets. It must be called after the payment was successful.
      * @param {PaymentMethods} paymentMethod The payment method used to pay the cart. If the chosen method is {@link PaymentMethods.ZERO_COST},
      * first the {@link Booking.addReduction} API is called with a 100% discount, then tickets are issued with the {@link PaymentMethods.CASH} method.
-     * @returns An {@link IssueTicketsResponse} object.
+     * @returns An {@link IssueCartResponse} object.
+     */
+    issueCart(paymentMethod: PaymentMethods): Promise<ErrorResponse | IssueCartResponse>;
+    getExtras({ extraId, tariffPlanId }?: {
+        /** The extra object identifier. By default, all the extras of the seller are returned. */
+        extraId?: number;
+        /** If present, the extras that are part of that tariff plan are returned. */
+        tariffPlanId?: number;
+    }): Promise<ErrorResponse | GetExtrasResponse>;
+    /**
+     * Fetches extras tariffs for the given cart
+     * @param cartGuid The guid of the cart
+     * @param tripId The ID of the trip for which the extras are requested. Please note that this
+     * parameter is required when adding extras to a MLP or services cart.
+     */
+    getExtrasForBooking(cartGuid: string, tripId?: number): Promise<ErrorResponse | GetExtrasForBookingResponse>;
+    /**
+     * Updates the extras associated with a cart, removing all previous ones.
+     * @param cartGuid The guid of the cart
+     * @param tariffIdToQuantity A map of tariff ids to the quantity of tickets to add for that tariff
      */
-    issueTickets(paymentMethod: PaymentMethods): Promise<ErrorResponse | IssueTicketsResponse>;
+    updateExtrasForCart(cartGuid: string, tariffIdToQuantity: Record<number, number>): Promise<ErrorResponse | {}>;
+    abstract getCart(): Cart | undefined;
+    abstract fetchAndSetCart(cartGuid: string): Promise<void>;
+    abstract fetchCart(cartGuid: string): Promise<Cart>;
 }
 export declare namespace Booking {
     enum Currencies {
@@ -122,8 +149,8 @@ export declare namespace Booking {
         /** The language in which the app is running. Can be "it", "en", "fr", "de" */
         language: Booking.Languages;
         /**
-         * If true, the app will try to restore the state of the booking, reading the cartId from the mts-storage.
-         * After reading the cartId, the BE will be called to retrieve the status of the cart.
+         * If true, the app will try to restore the state of the booking, reading the cartGuid from the mts-storage.
+         * After reading the cartGuid, the BE will be called to retrieve the status of the cart.
          * E.g. set this to `true` if you want your booking to be preserved after a page refresh.
          */
         restoreState: boolean;

package/lib/booking/booking.js

@@ -20,8 +20,8 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     });
 };
 var __generator = (this && this.__generator) || function (thisArg, body) {
-    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g;
-    return g = { next: verb(0), "throw": verb(1), "return": verb(2) }, typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
+    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype);
+    return g.next = verb(0), g["throw"] = verb(1), g["return"] = verb(2), typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
     function verb(n) { return function (v) { return step([n, v]); }; }
     function step(op) {
         if (f) throw new TypeError("Generator is already executing.");
@@ -125,6 +125,13 @@ var Booking = /** @class */ (function () {
             (0, config_1.getConfig)().DB_TYPE && { databaseType: (0, config_1.getConfig)().DB_TYPE }));
         return (0, apiCall_1.makePost)(url, completeBody);
     };
+    Booking.prototype.callPutApi = function (url, body) {
+        var _a, _b, _c, _d;
+        // Add sellerId, resellerId and language to the query string
+        var completeBody = __assign(__assign(__assign({}, body), { sellerId: (_b = (_a = this.sellerId) === null || _a === void 0 ? void 0 : _a.toString()) !== null && _b !== void 0 ? _b : 0, resellerId: (_d = (_c = this.resellerId) === null || _c === void 0 ? void 0 : _c.toString()) !== null && _d !== void 0 ? _d : 0, language: this.language }), ((0, config_1.getConfig)().ENV === config_1.MTSEnvs.DEV &&
+            (0, config_1.getConfig)().DB_TYPE && { databaseType: (0, config_1.getConfig)().DB_TYPE }));
+        return (0, apiCall_1.makePut)(url, completeBody);
+    };
     Booking.prototype.callDeleteApi = function (url) {
         var _a, _b, _c, _d;
         // Add sellerId, resellerId and language to the query string.
@@ -150,6 +157,7 @@ var Booking = /** @class */ (function () {
             this.language = Booking.Languages.EN;
         }
     };
+    // TODO: Add a test for this API once Extras are available on LinkAvel
     /**
      * This API allows to mark a non-required booking step as completed. It is useful for example for the seats selection step.
      * @param bookingStep The booking step to mark as completed
@@ -173,10 +181,10 @@ var Booking = /** @class */ (function () {
                     throw Error("The step ".concat(bookingStep, " cannot be marked as completed because it is required"));
                 }
                 // Booking step is already completed, no need to call the API
-                if (currentStepStatus[0])
+                if (currentStepStatus[1])
                     return [2 /*return*/, true];
                 url = "".concat(this.config.API_ENDPOINT, "/v3_booking/carts/bookingSteps");
-                return [2 /*return*/, this.callPostApi(url, { bookingStep: bookingStep }).then(function (response) {
+                return [2 /*return*/, this.callPostApi(url, { bookingStep: bookingStep, cartGuid: this.cartGuid }).then(function (response) {
                         if ((0, ErrorResponse_1.objectIsMTSErrorResponse)(response)) {
                             return response;
                         }
@@ -187,6 +195,41 @@ var Booking = /** @class */ (function () {
             });
         });
     };
+    /**
+     * @description This method shall be called when the user wants to retrieve information about an esisting buyer.
+     * @param {GetPersonRequest} request The object containing the parameters to search the buyer.
+     * @returns An object of type {@link PersonDetails} containing the buyer information, or an {@link ErrorResponse} object in case of error.
+     */
+    Booking.prototype.getPerson = function (request) {
+        return __awaiter(this, void 0, void 0, function () {
+            var buyerPassengersDetails, searchParams, url;
+            var _a;
+            return __generator(this, function (_b) {
+                // First check that it is possible to call this API
+                if ((0, utils_1.isNullOrWhiteSpace)(this.cartGuid)) {
+                    throw Error("Cart is not initialized yet");
+                }
+                buyerPassengersDetails = this.bookingStepsToStatus.get(Booking.BookingSteps.BUYER_PASSENGERS);
+                if (!buyerPassengersDetails || !buyerPassengersDetails[0]) {
+                    throw Error("The status of the cart does not allow to call this API");
+                }
+                if (!request.personId && !request.personCode && !request.phoneNumber) {
+                    throw Error("At least one of the parameters personId, personCode or phoneNumber must be set");
+                }
+                searchParams = new URLSearchParams(__assign(__assign(__assign(__assign({}, (request.personId && { personId: (_a = request.personId) === null || _a === void 0 ? void 0 : _a.toString() })), (request.personCode && { personCode: request.personCode })), (request.phoneNumber && { phoneNumber: request.phoneNumber })), { includeSSN: "true" }));
+                url = "".concat(this.config.API_ENDPOINT, "/v3_customers/persons?").concat(searchParams);
+                return [2 /*return*/, this.callGetApi(url).then(function (response) {
+                        // Check for errors
+                        if ((0, ErrorResponse_1.objectIsMTSErrorResponse)(response)) {
+                            return response;
+                        }
+                        // Return the person details
+                        var person = __assign(__assign({}, response.persons[0]), { socialSecurityNumber: response.persons[0].personDetails.socialSecurityNumber });
+                        return person;
+                    })];
+            });
+        });
+    };
     //#endregion
     //#region Payment APIs
     /**
@@ -233,9 +276,9 @@ var Booking = /** @class */ (function () {
                         }
                         _c.label = 5;
                     case 5:
-                        url = "".concat(this.config.API_ENDPOINT, "/v3_resources/sellers/").concat(this.sellerId, "/gateways?");
+                        url = "".concat(this.config.API_ENDPOINT, "/v3_resources/sellers/gateways?");
                         // We use directly makeGet because we don't want to add sellerId to the query string (it is already present in the url)
-                        return [2 /*return*/, (0, apiCall_1.makeGet)(url).then(function (response) {
+                        return [2 /*return*/, this.callGetApi(url).then(function (response) {
                                 return (0, ErrorResponse_1.objectIsMTSErrorResponse)(response)
                                     ? response
                                     : response;
@@ -273,14 +316,13 @@ var Booking = /** @class */ (function () {
             });
         });
     };
-    // TODO: Rename this as issueCart
     /**
      * @description This method shall be used to issue the tickets. It must be called after the payment was successful.
      * @param {PaymentMethods} paymentMethod The payment method used to pay the cart. If the chosen method is {@link PaymentMethods.ZERO_COST},
      * first the {@link Booking.addReduction} API is called with a 100% discount, then tickets are issued with the {@link PaymentMethods.CASH} method.
-     * @returns An {@link IssueTicketsResponse} object.
+     * @returns An {@link IssueCartResponse} object.
      */
-    Booking.prototype.issueTickets = function (paymentMethod) {
+    Booking.prototype.issueCart = function (paymentMethod) {
         return __awaiter(this, void 0, void 0, function () {
             var paymentMethodToSet, issueStep, _i, _a, step, url, body;
             var _b;
@@ -350,6 +392,65 @@ var Booking = /** @class */ (function () {
             });
         });
     };
+    //#endregion
+    // #region Extras
+    Booking.prototype.getExtras = function () {
+        return __awaiter(this, arguments, void 0, function (_a) {
+            var searchParams, url;
+            var _b = _a === void 0 ? {} : _a, extraId = _b.extraId, tariffPlanId = _b.tariffPlanId;
+            return __generator(this, function (_c) {
+                searchParams = new URLSearchParams(__assign(__assign({}, (extraId && { extraId: extraId.toString() })), (tariffPlanId && { tariffPlanId: tariffPlanId.toString() })));
+                url = "".concat(this.config.API_ENDPOINT, "/v3_resources/extras?").concat(searchParams);
+                return [2 /*return*/, this.callGetApi(url)];
+            });
+        });
+    };
+    /**
+     * Fetches extras tariffs for the given cart
+     * @param cartGuid The guid of the cart
+     * @param tripId The ID of the trip for which the extras are requested. Please note that this
+     * parameter is required when adding extras to a MLP or services cart.
+     */
+    Booking.prototype.getExtrasForBooking = function (cartGuid, tripId) {
+        return __awaiter(this, void 0, void 0, function () {
+            var searchParams, url;
+            return __generator(this, function (_a) {
+                searchParams = new URLSearchParams(__assign({ cartGuid: cartGuid }, (tripId && { tripId: tripId.toString() })));
+                url = "".concat(this.config.API_ENDPOINT, "/v3_booking/extras?").concat(searchParams);
+                return [2 /*return*/, this.callGetApi(url)];
+            });
+        });
+    };
+    /**
+     * Updates the extras associated with a cart, removing all previous ones.
+     * @param cartGuid The guid of the cart
+     * @param tariffIdToQuantity A map of tariff ids to the quantity of tickets to add for that tariff
+     */
+    Booking.prototype.updateExtrasForCart = function (cartGuid, tariffIdToQuantity) {
+        return __awaiter(this, void 0, void 0, function () {
+            var body, url, res;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        body = {
+                            cartGuid: cartGuid,
+                            tariffIdToQuantity: tariffIdToQuantity
+                        };
+                        url = "".concat(this.config.API_ENDPOINT, "/v3_booking/extras");
+                        return [4 /*yield*/, this.callPutApi(url, body)];
+                    case 1:
+                        res = _a.sent();
+                        if ((0, ErrorResponse_1.objectIsMTSErrorResponse)(res)) {
+                            return [2 /*return*/, res];
+                        }
+                        return [4 /*yield*/, this.fetchAndSetCart(cartGuid)];
+                    case 2:
+                        _a.sent();
+                        return [2 /*return*/, res];
+                }
+            });
+        });
+    };
     return Booking;
 }());
 exports.Booking = Booking;

package/lib/booking/journeyBooking.d.ts

@@ -1,5 +1,5 @@
 import { ErrorResponse } from "../types/ErrorResponse";
-import { Buyer, EditPassengersDetailsRequest, GetBuyerPassengersDetailsResponse, GetBuyerRequest } from "../types/common/Person";
+import { EditPassengersDetailsRequest, GetBuyerPassengersDetailsResponse } from "../types/common/Person";
 import { AddReductionRequest } from "../types/common/Reduction";
 import { BusMatrix } from "../types/journeys/BusMatrix";
 import { CreateJourneyCartRequest, JourneyCart } from "../types/journeys/JourneyCart";
@@ -14,54 +14,47 @@ export declare class JourneyBooking extends Booking {
     constructor({ env, subKey, debug, language, sessionId, restoreState, accessToken, sellerId, resellerId, dbType }: Omit<Booking.BookingConfig, "bookingType">);
     getCart(): JourneyCart | undefined;
     getStorage(): import("zustand").UseBoundStore<Omit<import("zustand").StoreApi<{
-        cartId: number | undefined;
         cartGuid: string | undefined;
     } & {
-        updateCartId: (cartId: number | undefined, cartGuid: string | undefined) => void;
+        updateCartGuid: (cartGuid: string | undefined) => void;
         resetState: () => void;
     }>, "persist"> & {
         persist: {
             setOptions: (options: Partial<import("zustand/middleware").PersistOptions<{
-                cartId: number | undefined;
                 cartGuid: string | undefined;
             } & {
-                updateCartId: (cartId: number | undefined, cartGuid: string | undefined) => void;
+                updateCartGuid: (cartGuid: string | undefined) => void;
                 resetState: () => void;
             }, {
-                cartId: number | undefined;
                 cartGuid: string | undefined;
             } & {
-                updateCartId: (cartId: number | undefined, cartGuid: string | undefined) => void;
+                updateCartGuid: (cartGuid: string | undefined) => void;
                 resetState: () => void;
             }>>) => void;
             clearStorage: () => void;
             rehydrate: () => Promise<void> | void;
             hasHydrated: () => boolean;
             onHydrate: (fn: (state: {
-                cartId: number | undefined;
                 cartGuid: string | undefined;
             } & {
-                updateCartId: (cartId: number | undefined, cartGuid: string | undefined) => void;
+                updateCartGuid: (cartGuid: string | undefined) => void;
                 resetState: () => void;
             }) => void) => () => void;
             onFinishHydration: (fn: (state: {
-                cartId: number | undefined;
                 cartGuid: string | undefined;
             } & {
-                updateCartId: (cartId: number | undefined, cartGuid: string | undefined) => void;
+                updateCartGuid: (cartGuid: string | undefined) => void;
                 resetState: () => void;
             }) => void) => () => void;
             getOptions: () => Partial<import("zustand/middleware").PersistOptions<{
-                cartId: number | undefined;
                 cartGuid: string | undefined;
             } & {
-                updateCartId: (cartId: number | undefined, cartGuid: string | undefined) => void;
+                updateCartGuid: (cartGuid: string | undefined) => void;
                 resetState: () => void;
             }, {
-                cartId: number | undefined;
                 cartGuid: string | undefined;
             } & {
-                updateCartId: (cartId: number | undefined, cartGuid: string | undefined) => void;
+                updateCartGuid: (cartGuid: string | undefined) => void;
                 resetState: () => void;
             }>>;
         };
@@ -101,12 +94,6 @@ export declare class JourneyBooking extends Booking {
      * as well as a list of the available tariffs for each trip.
      */
     getBuyerPassengersDetails(): Promise<ErrorResponse | GetBuyerPassengersDetailsResponse>;
-    /**
-     * @description This method shall be called when the user wants to retrieve information about an esisting buyer.
-     * @param {GetBuyerRequest} request The object containing the parameters to search the buyer.
-     * @returns An object of type {@link Buyer} containing the buyer information, or an {@link ErrorResponse} object in case of error.
-     */
-    getBuyer(request: GetBuyerRequest): Promise<ErrorResponse | Buyer>;
     /**
      * @description This methosd shall be called when the user wants to update the buyer and the passengers information.
      * @param {EditPassengersDetailsRequest} passengersDetails The object containing the buyer and the passengers information.

package/lib/booking/journeyBooking.js

@@ -35,8 +35,8 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     });
 };
 var __generator = (this && this.__generator) || function (thisArg, body) {
-    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g;
-    return g = { next: verb(0), "throw": verb(1), "return": verb(2) }, typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
+    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype);
+    return g.next = verb(0), g["throw"] = verb(1), g["return"] = verb(2), typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
     function verb(n) { return function (v) { return step([n, v]); }; }
     function step(op) {
         if (f) throw new TypeError("Generator is already executing.");
@@ -99,11 +99,8 @@ var JourneyBooking = /** @class */ (function (_super) {
             resellerId: resellerId,
             dbType: dbType
         }) || this;
-        // Set cartId & cartGuid
-        var _b = _this.getStorage().getState(), cartId = _b.cartId, cartGuid = _b.cartGuid;
-        if (cartId && restoreState) {
-            _this.cartId = cartId;
-        }
+        // Set cartGuid
+        var cartGuid = _this.getStorage().getState().cartGuid;
         if (cartGuid && restoreState) {
             _this.cartGuid = cartGuid;
         }
@@ -120,16 +117,15 @@ var JourneyBooking = /** @class */ (function (_super) {
     };
     JourneyBooking.prototype.resetBooking = function () {
         this.cart = undefined;
-        this.cartId = undefined;
         this.cartGuid = undefined;
         this.bookingStepsToStatus = new Map();
         this.bookingDueDate = undefined;
         try {
-            this.getStorage().getState().updateCartId(undefined, undefined);
+            this.getStorage().getState().updateCartGuid(undefined);
         }
         catch (e) {
             if (this.config.ENV !== config_1.MTSEnvs.TEST) {
-                throw new Error("Error while deleting cartId from storage.");
+                throw new Error("Error while deleting cartGuid from storage.");
             }
             console.log(e);
         }
@@ -145,7 +141,6 @@ var JourneyBooking = /** @class */ (function (_super) {
                                 cartDueDate.setSeconds(cartDueDate.getSeconds() + cart.bookingDueDateRemainingSeconds);
                                 if (cartDueDate > new Date() && !cart.hasIssuedTickets) {
                                     _this.cart = cart;
-                                    _this.cartId = cart.id;
                                     _this.cartGuid = cart.guid;
                                     _this.bookingDueDate = cartDueDate; // See Booking class
                                     // Update the sellerId. This is particularly important in Linkavel
@@ -259,7 +254,7 @@ var JourneyBooking = /** @class */ (function (_super) {
                 if (request.departureStopName === undefined || request.destinationStopName === undefined) {
                     throw Error("Fields departureStopName and destinationStopName are required");
                 }
-                searchParams = new URLSearchParams(__assign(__assign({ departureStopName: request.departureStopName, destinationStopName: request.destinationStopName, passengersNumber: request.passengersNumber.toString(), date: request.date, roundTripDate: request.roundTripDate ? request.roundTripDate : "null", currency: request.currency }, (this.cartId && { cartId: this.cartId.toString() })), (this.cartGuid && { cartGuid: this.cartGuid })));
+                searchParams = new URLSearchParams(__assign({ departureStopName: request.departureStopName, destinationStopName: request.destinationStopName, passengersNumber: request.passengersNumber.toString(), date: request.date, roundTripDate: request.roundTripDate ? request.roundTripDate : "null", currency: request.currency }, (this.cartGuid && { cartGuid: this.cartGuid })));
                 url = "".concat(this.config.API_ENDPOINT, "/v3_booking/journeys?").concat(searchParams);
                 return [2 /*return*/, this.callGetApi(url).then(function (response) {
                         return (0, ErrorResponse_1.objectIsMTSErrorResponse)(response)
@@ -279,15 +274,14 @@ var JourneyBooking = /** @class */ (function (_super) {
                 return [2 /*return*/, this.callPostApi(url, request).then(function (response) {
                         // Check for errors
                         if ((0, ErrorResponse_1.objectIsMTSErrorResponse)(response)) {
-                            // If there was an error, reset cartId and remove it from the mts-storage
+                            // If there was an error, reset cartGuid and remove it from the mts-storage
                             _this.resetBooking();
                             return response;
                         }
                         _this.cart = response.cart;
-                        _this.cartId = response.cart.id;
                         _this.cartGuid = response.cart.guid;
-                        // Save the cartId in the storage
-                        _this.getStorage().getState().updateCartId(response.cart.id, response.cart.guid);
+                        // Save the cartGuid in the storage
+                        _this.getStorage().getState().updateCartGuid(response.cart.guid);
                         // Fill the booking process status
                         _this.bookingStepsToStatus = (0, processBookingSteps_1.processBookingSteps)(response.cart.stepsToStatus);
                         var cartDueDate = new Date();
@@ -355,40 +349,6 @@ var JourneyBooking = /** @class */ (function (_super) {
             });
         });
     };
-    // TODO: rename this as getPerson and use personDetails as return type
-    /**
-     * @description This method shall be called when the user wants to retrieve information about an esisting buyer.
-     * @param {GetBuyerRequest} request The object containing the parameters to search the buyer.
-     * @returns An object of type {@link Buyer} containing the buyer information, or an {@link ErrorResponse} object in case of error.
-     */
-    JourneyBooking.prototype.getBuyer = function (request) {
-        return __awaiter(this, void 0, void 0, function () {
-            var buyerPassengersDetails, searchParams, url;
-            var _a;
-            return __generator(this, function (_b) {
-                // First check that it is possible to call this API
-                if (!this.cart) {
-                    throw Error("Cart is not initialized yet");
-                }
-                buyerPassengersDetails = this.bookingStepsToStatus.get(booking_1.Booking.BookingSteps.BUYER_PASSENGERS);
-                if (!buyerPassengersDetails || !buyerPassengersDetails[0]) {
-                    throw Error("The status of the cart does not allow to call this API");
-                }
-                if (!request.personId && !request.personCode && !request.phoneNumber) {
-                    throw Error("At least one of the parameters personId, personCode or phoneNumber must be set");
-                }
-                searchParams = new URLSearchParams(__assign(__assign(__assign({}, (request.personId && { personId: (_a = request.personId) === null || _a === void 0 ? void 0 : _a.toString() })), (request.personCode && { personCode: request.personCode })), (request.phoneNumber && { phoneNumber: request.phoneNumber })));
-                url = "".concat(this.config.API_ENDPOINT, "/v3_customers/persons?").concat(searchParams);
-                return [2 /*return*/, this.callGetApi(url).then(function (response) {
-                        // Check for errors
-                        if ((0, ErrorResponse_1.objectIsMTSErrorResponse)(response)) {
-                            return response;
-                        }
-                        return response.persons[0];
-                    })];
-            });
-        });
-    };
     /**
      * @description This methosd shall be called when the user wants to update the buyer and the passengers information.
      * @param {EditPassengersDetailsRequest} passengersDetails The object containing the buyer and the passengers information.
@@ -448,10 +408,11 @@ var JourneyBooking = /** @class */ (function (_super) {
                     throw Error("The status of the cart does not allow to call this API");
                 }
                 searchParams = new URLSearchParams({
+                    tripId: tripId.toString(),
                     departureStopId: departureStopId.toString(),
                     destinationStopId: destinationStopId.toString()
                 });
-                url = "".concat(this.config.API_ENDPOINT, "/v3_booking/journeys/trips/").concat(tripId, "/seats?").concat(searchParams);
+                url = "".concat(this.config.API_ENDPOINT, "/v3_booking/journeys/trips/seats?").concat(searchParams);
                 return [2 /*return*/, this.callGetApi(url).then(function (response) {
                         return (0, ErrorResponse_1.objectIsMTSErrorResponse)(response)
                             ? response
@@ -593,7 +554,7 @@ var JourneyBooking = /** @class */ (function (_super) {
                         _c.label = 5;
                     case 5:
                         url = "".concat(this.config.API_ENDPOINT, "/v3_booking/carts/payment/reduction");
-                        return [2 /*return*/, this.callPostApi(url, __assign(__assign({}, request), { cartId: this.cartId, cartGuid: this.cartGuid })).then(function (response) {
+                        return [2 /*return*/, this.callPostApi(url, __assign(__assign({}, request), { cartGuid: this.cartGuid })).then(function (response) {
                                 var _a, _b;
                                 if ((0, ErrorResponse_1.objectIsMTSErrorResponse)(response)) {
                                     return response;
@@ -628,7 +589,10 @@ var JourneyBooking = /** @class */ (function (_super) {
                 if (!discountsStep || !discountsStep[0]) {
                     throw Error("The status of the cart does not allow to call this API");
                 }
-                queryParams = new URLSearchParams({ tripId: tripId.toString(), cartId: this.cartId.toString(), cartGuid: this.cartGuid });
+                queryParams = new URLSearchParams({
+                    tripId: tripId.toString(),
+                    cartGuid: this.cartGuid
+                });
                 url = "".concat(this.config.API_ENDPOINT, "/v3_booking/carts/payment/reduction?").concat(queryParams);
                 return [2 /*return*/, this.callDeleteApi(url).then(function (response) {
                         var _a, _b, _c;
@@ -697,7 +661,7 @@ var JourneyBooking = /** @class */ (function (_super) {
                         _c.label = 5;
                     case 5:
                         url = "".concat(this.config.API_ENDPOINT, "/v3_booking/carts/payment/wallet");
-                        return [2 /*return*/, this.callPostApi(url, { cartId: this.cartId, cartGuid: this.cartGuid }).then(function (response) {
+                        return [2 /*return*/, this.callPostApi(url, { cartGuid: this.cartGuid }).then(function (response) {
                                 var _a, _b;
                                 if ((0, ErrorResponse_1.objectIsMTSErrorResponse)(response)) {
                                     return response;
@@ -727,7 +691,7 @@ var JourneyBooking = /** @class */ (function (_super) {
                 if ((0, utils_1.isNullOrWhiteSpace)(this.cartGuid)) {
                     throw Error("Cart is not initialized yet");
                 }
-                queryParams = new URLSearchParams({ cartId: this.cartId.toString(), cartGuid: this.cartGuid });
+                queryParams = new URLSearchParams({ cartGuid: this.cartGuid });
                 url = "".concat(this.config.API_ENDPOINT, "/v3_booking/carts/payment/wallet?").concat(queryParams);
                 return [2 /*return*/, this.callDeleteApi(url).then(function (response) {
                         var _a, _b, _c;
@@ -839,11 +803,10 @@ exports.JourneyBooking = JourneyBooking;
                 case 3: return [2 /*return*/, booking];
                 case 4:
                     error_1 = _c.sent();
-                    // Check if the error is due to an expired cart. In this case, delete the cartId from the mts-storage
+                    // Check if the error is due to an expired cart. In this case, delete the cartGuid from the mts-storage
                     // This error can occur when the user refreshes the page and the cart has expired
                     if ((0, ErrorResponse_1.objectIsMTSErrorResponse)(error_1) && error_1.mtsCode === 40053) {
-                        booking.getStorage().getState().updateCartId(undefined, undefined);
-                        booking.cartId = undefined;
+                        booking.getStorage().getState().updateCartGuid(undefined);
                         booking.cartGuid = undefined;
                         return [2 /*return*/, booking];
                     }

package/lib/booking/serviceBooking.d.ts

@@ -1,5 +1,5 @@
 import { ErrorResponse } from "../types/ErrorResponse";
-import { Buyer, GetBuyerPassengersDetailsResponse, GetBuyerRequest } from "../types/common/Person";
+import { PersonDetails, GetBuyerPassengersDetailsResponse } from "../types/common/Person";
 import { AddReductionRequest } from "../types/common/Reduction";
 import { Service, ServiceTripsResponse } from "../types/services/Service";
 import { CreateServiceCartRequest, ServiceCart } from "../types/services/ServiceCart";
@@ -11,54 +11,47 @@ export declare class ServiceBooking extends Booking {
      */
     constructor({ env, subKey, debug, language, sessionId, restoreState, accessToken, sellerId, resellerId, dbType }: Omit<Booking.BookingConfig, "bookingType">);
     getStorage(): import("zustand").UseBoundStore<Omit<import("zustand").StoreApi<{
-        cartId: number | undefined;
         cartGuid: string | undefined;
     } & {
-        updateCartId: (cartId: number | undefined, cartGuid: string | undefined) => void;
+        updateCartGuid: (cartGuid: string | undefined) => void;
         resetState: () => void;
     }>, "persist"> & {
         persist: {
             setOptions: (options: Partial<import("zustand/middleware").PersistOptions<{
-                cartId: number | undefined;
                 cartGuid: string | undefined;
             } & {
-                updateCartId: (cartId: number | undefined, cartGuid: string | undefined) => void;
+                updateCartGuid: (cartGuid: string | undefined) => void;
                 resetState: () => void;
             }, {
-                cartId: number | undefined;
                 cartGuid: string | undefined;
             } & {
-                updateCartId: (cartId: number | undefined, cartGuid: string | undefined) => void;
+                updateCartGuid: (cartGuid: string | undefined) => void;
                 resetState: () => void;
             }>>) => void;
             clearStorage: () => void;
             rehydrate: () => Promise<void> | void;
             hasHydrated: () => boolean;
             onHydrate: (fn: (state: {
-                cartId: number | undefined;
                 cartGuid: string | undefined;
             } & {
-                updateCartId: (cartId: number | undefined, cartGuid: string | undefined) => void;
+                updateCartGuid: (cartGuid: string | undefined) => void;
                 resetState: () => void;
             }) => void) => () => void;
             onFinishHydration: (fn: (state: {
-                cartId: number | undefined;
                 cartGuid: string | undefined;
             } & {
-                updateCartId: (cartId: number | undefined, cartGuid: string | undefined) => void;
+                updateCartGuid: (cartGuid: string | undefined) => void;
                 resetState: () => void;
             }) => void) => () => void;
             getOptions: () => Partial<import("zustand/middleware").PersistOptions<{
-                cartId: number | undefined;
                 cartGuid: string | undefined;
             } & {
-                updateCartId: (cartId: number | undefined, cartGuid: string | undefined) => void;
+                updateCartGuid: (cartGuid: string | undefined) => void;
                 resetState: () => void;
             }, {
-                cartId: number | undefined;
                 cartGuid: string | undefined;
             } & {
-                updateCartId: (cartId: number | undefined, cartGuid: string | undefined) => void;
+                updateCartGuid: (cartGuid: string | undefined) => void;
                 resetState: () => void;
             }>>;
         };
@@ -103,19 +96,13 @@ export declare class ServiceBooking extends Booking {
      * as well as a list of the available tariffs for each trip.
      */
     getBuyerPassengersDetails(): Promise<ErrorResponse | GetBuyerPassengersDetailsResponse>;
-    /**
-     * @description This method shall be called when the user wants to retrieve information about an esisting buyer.
-     * @param {GetBuyerRequest} request The object containing the parameters to search the buyer.
-     * @returns An object of type {@link Buyer} containing the buyer information, or an {@link ErrorResponse} object in case of error.
-     */
-    getBuyer(request: GetBuyerRequest): Promise<ErrorResponse | Buyer>;
     /**
      * @description This method shall be called when the user wants to update the buyer information.
      * @param buyerDetails The object containing the buyer information.
      * It should be null if the buyer data cannot be specified (see {@link GetBuyerPassengersDetailsResponse.buyerDataStatus}).
      * @returns An {@link ErrorResponse} object in case of error, true otherwise.
      */
-    updateBuyerPassengersDetails(buyerDetails: Buyer | null): Promise<ErrorResponse | boolean>;
+    updateBuyerPassengersDetails(buyerDetails: PersonDetails | null): Promise<ErrorResponse | boolean>;
     /**
      * @description This method allows to add a reduction to the whole cart or to a single trip in the cart.
      * @param {AddReductionRequest} request The information about the reduction to add