btrz-api-client 8.33.0 → 8.35.0

package/lib/endpoints/invoices/invoices.js

@@ -30,13 +30,15 @@ function invoicesFactory(_ref) {
       internalAuthTokenProvider = _ref.internalAuthTokenProvider;
 
   /**
-   * GET /invoices - list invoices.
+   * GET /invoices — List invoices by transaction (paginated).
    * @param {Object} opts
-   * @param {string} [opts.token] - API key
-   * @param {string} [opts.jwtToken] - JWT or internal auth symbol
-   * @param {InvoicesListQuery} [opts.query] - Query params (transactionId required)
+   * @param {string} [opts.token] - API key (X-API-KEY)
+   * @param {string} [opts.jwtToken] - JWT or internal auth (Authorization: Bearer)
+   * @param {InvoicesListQuery} [opts.query] - Query; transactionId (required) = 24-char hex ObjectId
    * @param {Object} [opts.headers] - Optional headers
-   * @returns {Promise<import("axios").AxiosResponse>}
+   * @returns {Promise<import("axios").AxiosResponse<{ invoices: Object[], total: number, page?: number, ... }>>}
+   * @throws 401 Unauthorized
+   * @throws 500 Internal server error
    */
   function all(_ref2) {
     var token = _ref2.token,
@@ -54,13 +56,17 @@ function invoicesFactory(_ref) {
   }
 
   /**
-   * GET /invoices/:id - get invoice by id. API does not accept query params.
+   * GET /invoices/:id — Get a single invoice by ID.
    * @param {Object} opts
-   * @param {string} [opts.token] - API key
-   * @param {string} [opts.jwtToken] - JWT or internal auth symbol
-   * @param {string} opts.id - Invoice id
+   * @param {string} [opts.token] - API key (X-API-KEY)
+   * @param {string} [opts.jwtToken] - JWT or internal auth (Authorization: Bearer)
+   * @param {string} opts.id - Invoice ID (24-character hex ObjectId)
    * @param {Object} [opts.headers] - Optional headers
-   * @returns {Promise<import("axios").AxiosResponse>}
+   * @returns {Promise<import("axios").AxiosResponse<{ invoice: Object }>>}
+   * @throws 400 WRONG_DATA, INVALID_INVOICE_ID
+   * @throws 401 Unauthorized
+   * @throws 404 INVOICE_NOT_FOUND
+   * @throws 500 Internal server error
    */
   function get(_ref3) {
     var token = _ref3.token,
@@ -79,13 +85,16 @@ function invoicesFactory(_ref) {
   }
 
   /**
-   * GET /failures - list invoice failures.
+   * GET /failures — List invoice failures (paginated). Optional transactionId filter.
    * @param {Object} opts
-   * @param {string} [opts.token] - API key
-   * @param {string} [opts.jwtToken] - JWT or internal auth symbol
-   * @param {InvoicesFailuresQuery} [opts.query] - Query params (transactionId optional)
+   * @param {string} [opts.token] - API key (X-API-KEY)
+   * @param {string} [opts.jwtToken] - JWT or internal auth (Authorization: Bearer)
+   * @param {InvoicesFailuresQuery} [opts.query] - Query; transactionId optional (24-char hex; if present must be valid)
    * @param {Object} [opts.headers] - Optional headers
-   * @returns {Promise<import("axios").AxiosResponse>}
+   * @returns {Promise<import("axios").AxiosResponse<{ invoicesFailures: Object[], total: number, ... }>>}
+   * @throws 400 WRONG_DATA, INVALID_TRANSACTION_ID (if transactionId provided and invalid)
+   * @throws 401 Unauthorized
+   * @throws 500 Internal server error
    */
   function getInvoicesFailures(_ref4) {
     var token = _ref4.token,
@@ -103,13 +112,19 @@ function invoicesFactory(_ref) {
   }
 
   /**
-   * POST /retry - retry invoicing. API does not accept query params.
+   * POST /retry — Retry invoicing from an invoice failure using saved data. Body: transactionId (required).
+   * On success may emit webhooks invoices.created or invoices.updated.
    * @param {Object} opts
-   * @param {string} [opts.token] - API key
-   * @param {string} [opts.jwtToken] - JWT or internal auth symbol
-   * @param {Object} opts.data - Request body
+   * @param {string} [opts.token] - API key (X-API-KEY)
+   * @param {string} [opts.jwtToken] - JWT or internal auth (Authorization: Bearer)
+   * @param {Object} opts.data - Body: { transactionId } (transactionId = 24-char hex ObjectId)
    * @param {Object} [opts.headers] - Optional headers
-   * @returns {Promise<import("axios").AxiosResponse>}
+   * @returns {Promise<import("axios").AxiosResponse<{ invoice: Object }>>}
+   * @throws 400 WRONG_DATA, INVOICE_NOT_CREATED, INVOICE_PROVIDER_TYPE_NOT_SUPPORTED, INVOICE_PROVIDER_NOT_FOUND, TRANSACTION_ALREADY_INVOICED
+   * @throws 401 Unauthorized
+   * @throws 404 TRANSACTION_NOT_FOUND, INVOICE_FAILURE_NOT_FOUND
+   * @throws 409 INFILE_SIGN_FAILED, INFILE_CERTIFICATION_FAILED
+   * @throws 500 Internal server error
    */
   function retryInvoicing(_ref5) {
     var token = _ref5.token,
@@ -129,13 +144,19 @@ function invoicesFactory(_ref) {
   }
 
   /**
-   * PUT /retry - override buyer and retry invoicing. API does not accept query params.
+   * PUT /retry — Override buyer and retry invoicing from an invoice failure. Body: retryData with transactionId and overrideBuyer.
+   * On success may emit webhooks invoices.created or invoices.updated.
    * @param {Object} opts
-   * @param {string} [opts.token] - API key
-   * @param {string} [opts.jwtToken] - JWT or internal auth symbol
-   * @param {Object} opts.data - Request body
+   * @param {string} [opts.token] - API key (X-API-KEY)
+   * @param {string} [opts.jwtToken] - JWT or internal auth (Authorization: Bearer)
+   * @param {Object} opts.data - Body: { transactionId, overrideBuyer } (RetryPutData); overrideBuyer required when no certified invoice exists
    * @param {Object} [opts.headers] - Optional headers
-   * @returns {Promise<import("axios").AxiosResponse>}
+   * @returns {Promise<import("axios").AxiosResponse<{ invoice: Object }>>}
+   * @throws 400 WRONG_DATA, INVOICE_NOT_CREATED, INVOICE_PROVIDER_TYPE_NOT_SUPPORTED, INVOICE_PROVIDER_NOT_FOUND, TRANSACTION_ALREADY_INVOICED, OVERRIDE_BUYER_IS_MANDATORY
+   * @throws 401 Unauthorized
+   * @throws 404 TRANSACTION_NOT_FOUND, INVOICE_FAILURE_NOT_FOUND
+   * @throws 409 INFILE_SIGN_FAILED, INFILE_CERTIFICATION_FAILED
+   * @throws 500 Internal server error
    */
   function overrideBuyerRetryInvoicing(_ref6) {
     var token = _ref6.token,

package/lib/endpoints/invoices/pdfs.js

@@ -6,8 +6,8 @@ var _require = require("./../endpoints_helpers.js"),
 
 /**
  * Query params for GET /pdfs (btrz-api-invoices). See pdfs get-handler getSpec().
- * @typedef {Object} PdfsListQuery
- * @property {string} transactionId - Transaction id of the invoice (required)
+ * @typedef {Object} PdfsQuery
+ * @property {string} transactionId - Transaction ID of the invoice (required, 24-char hex ObjectId)
  */
 
 /**
@@ -24,14 +24,21 @@ function pdfsFactory(_ref) {
       internalAuthTokenProvider = _ref.internalAuthTokenProvider;
 
   /**
-   * GET /pdfs - list invoice PDFs.
+   * GET /pdfs — Returns the invoice PDF for the invoice associated with the given transaction.
+   * Response is binary (application/pdf) with Content-Disposition attachment; filename=invoice-{invoiceId}.pdf.
+   * Use responseType "blob" or "arraybuffer" to receive binary data.
+   *
    * @param {Object} opts
-   * @param {string} [opts.token] - API key
-   * @param {string} [opts.jwtToken] - JWT or internal auth symbol
-   * @param {PdfsListQuery} [opts.query] - Query params (transactionId required)
-   * @param {string} [opts.responseType] - Response type (e.g. "json", "blob")
+   * @param {string} [opts.token] - API key (X-API-KEY)
+   * @param {string} [opts.jwtToken] - JWT or internal auth (Authorization: Bearer)
+   * @param {PdfsQuery} [opts.query] - Query; transactionId (required)
+   * @param {string} [opts.responseType] - Response type: "blob" or "arraybuffer" for binary PDF; "json" default
    * @param {Object} [opts.headers] - Optional headers
-   * @returns {Promise<import("axios").AxiosResponse>}
+   * @returns {Promise<import("axios").AxiosResponse<ArrayBuffer|Blob|*>>} PDF binary when responseType is blob/arraybuffer
+   * @throws 400 WRONG_DATA — transactionId is required
+   * @throws 401 Unauthorized
+   * @throws 404 INVOICE_NOT_FOUND — Invoice not found for the transactionId
+   * @throws 500 Internal server error (e.g. unsupported invoice provider type)
    */
   function all(_ref2) {
     var token = _ref2.token,

package/lib/endpoints/invoices/providers.js

@@ -28,13 +28,15 @@ function providersFactory(_ref) {
       internalAuthTokenProvider = _ref.internalAuthTokenProvider;
 
   /**
-   * GET /providers - list invoice providers.
+   * GET /providers — List invoice providers (paginated). Optional filters: enabled, invoiceProviderType, channel, country, operatingCompany.
    * @param {Object} opts
-   * @param {string} [opts.token] - API key
-   * @param {string} [opts.jwtToken] - JWT or internal auth symbol
+   * @param {string} [opts.token] - API key (X-API-KEY)
+   * @param {string} [opts.jwtToken] - JWT or internal auth (Authorization: Bearer)
    * @param {ProvidersListQuery} [opts.query] - Query params (all optional)
    * @param {Object} [opts.headers] - Optional headers
-   * @returns {Promise<import("axios").AxiosResponse>}
+   * @returns {Promise<import("axios").AxiosResponse<{ providers: Object[], total?: number, ... }>>}
+   * @throws 401 Unauthorized
+   * @throws 500 Internal server error
    */
   function all(_ref2) {
     var token = _ref2.token,
@@ -52,13 +54,17 @@ function providersFactory(_ref) {
   }
 
   /**
-   * GET /providers/:id - get invoice provider by id. API does not accept query params.
+   * GET /providers/:id — Get a single invoice provider by ID.
    * @param {Object} opts
-   * @param {string} [opts.token] - API key
-   * @param {string} [opts.jwtToken] - JWT or internal auth symbol
-   * @param {string} opts.id - Provider id
+   * @param {string} [opts.token] - API key (X-API-KEY)
+   * @param {string} [opts.jwtToken] - JWT or internal auth (Authorization: Bearer)
+   * @param {string} opts.id - Provider ID (24-character hex ObjectId)
    * @param {Object} [opts.headers] - Optional headers
-   * @returns {Promise<import("axios").AxiosResponse>}
+   * @returns {Promise<import("axios").AxiosResponse<{ provider: Object }>>}
+   * @throws 400 WRONG_DATA, INVALID_PROVIDER_ID
+   * @throws 401 Unauthorized
+   * @throws 404 PROVIDER_NOT_FOUND
+   * @throws 500 Internal server error
    */
   function get(_ref3) {
     var token = _ref3.token,
@@ -77,14 +83,18 @@ function providersFactory(_ref) {
   }
 
   /**
-   * PUT /providers/:id - update invoice provider. API does not accept query params.
+   * PUT /providers/:id — Update invoice provider. Body may be provider or body.provider. Emits webhook invoice_providers.updated on success.
    * @param {Object} opts
-   * @param {string} [opts.token] - API key
-   * @param {string} [opts.jwtToken] - JWT or internal auth symbol
-   * @param {string} opts.id - Provider id
-   * @param {Object} opts.data - Request body
+   * @param {string} [opts.token] - API key (X-API-KEY)
+   * @param {string} [opts.jwtToken] - JWT or internal auth (Authorization: Bearer)
+   * @param {string} opts.id - Provider ID (24-character hex ObjectId)
+   * @param {Object} opts.data - Request body (ProviderPutData)
    * @param {Object} [opts.headers] - Optional headers
-   * @returns {Promise<import("axios").AxiosResponse>}
+   * @returns {Promise<import("axios").AxiosResponse<{ provider: Object }>>}
+   * @throws 400 INVALID_PHRASES, OPERATING_COMPANY_NOT_FOUND, CANNOT_CHANGE_PROVIDER, INVALID_IVA_AFFILIATION, CANT_REMOVE_*, INVALID_PARAM_VALUE, CANT_DELETE_DOCUMENT_TYPE_*
+   * @throws 401 Unauthorized
+   * @throws 404 PROVIDER_NOT_FOUND
+   * @throws 500 Internal server error
    */
   function update(_ref4) {
     var token = _ref4.token,
@@ -105,13 +115,17 @@ function providersFactory(_ref) {
   }
 
   /**
-   * DELETE /providers/:id - remove invoice provider. API does not accept query params.
+   * DELETE /providers/:id — Remove invoice provider. Emits webhook invoice_providers.deleted on success.
    * @param {Object} opts
-   * @param {string} [opts.token] - API key
-   * @param {string} [opts.jwtToken] - JWT or internal auth symbol
-   * @param {string} opts.id - Provider id
+   * @param {string} [opts.token] - API key (X-API-KEY)
+   * @param {string} [opts.jwtToken] - JWT or internal auth (Authorization: Bearer)
+   * @param {string} opts.id - Provider ID (24-character hex ObjectId)
    * @param {Object} [opts.headers] - Optional headers
-   * @returns {Promise<import("axios").AxiosResponse>}
+   * @returns {Promise<import("axios").AxiosResponse<{ providerId: string }>>}
+   * @throws 400 WRONG_DATA, INVALID_PROVIDER_ID
+   * @throws 401 Unauthorized
+   * @throws 404 PROVIDER_NOT_FOUND
+   * @throws 500 Internal server error
    */
   function remove(_ref5) {
     var token = _ref5.token,
@@ -130,13 +144,16 @@ function providersFactory(_ref) {
   }
 
   /**
-   * POST /providers - create invoice provider. API does not accept query params.
+   * POST /providers — Create invoice provider. Body may be provider or body.provider (ProviderPostData). Emits webhook invoice_providers.created on success.
    * @param {Object} opts
-   * @param {string} [opts.token] - API key
-   * @param {string} [opts.jwtToken] - JWT or internal auth symbol
-   * @param {Object} opts.data - Request body
+   * @param {string} [opts.token] - API key (X-API-KEY)
+   * @param {string} [opts.jwtToken] - JWT or internal auth (Authorization: Bearer)
+   * @param {Object} opts.data - Request body (ProviderPostData: invoiceProviderType, currencies, params required)
    * @param {Object} [opts.headers] - Optional headers
-   * @returns {Promise<import("axios").AxiosResponse>}
+   * @returns {Promise<import("axios").AxiosResponse<{ provider: Object }>>}
+   * @throws 400 WRONG_DATA, INVALID_PHRASES, REQUIRED_PARAM_MISSING, INVALID_PARAM_VALUE, OPERATING_COMPANY_NOT_FOUND, INVALID_IVA_AFFILIATION
+   * @throws 401 Unauthorized
+   * @throws 500 Internal server error
    */
   function create(_ref6) {
     var token = _ref6.token,

package/lib/endpoints/invoices/tax-ids.js

@@ -9,8 +9,8 @@ var _require = require("./../endpoints_helpers.js"),
  * @typedef {Object} TaxIdsListQuery
  * @property {string} taxNumber - Tax number to look up (required)
  * @property {string} country - ISO code of the country of the tax information (required)
- * @property {string} [invoiceProviderId] - Invoice provider id (24 hex chars)
- * @property {string} [documentType] - Tax identification type to check against validation service
+ * @property {string} [invoiceProviderId] - Invoice provider id (24-char hex ObjectId); optional, for external validation
+ * @property {string} [documentType] - Tax identification type for validation (e.g. NIT, DPI for infile)
  */
 
 /**
@@ -27,13 +27,17 @@ function taxIdsFactory(_ref) {
       internalAuthTokenProvider = _ref.internalAuthTokenProvider;
 
   /**
-   * GET /tax-ids - list tax IDs.
+   * GET /tax-ids — List tax ID information (paginated). Merges internal tax IDs with external provider validation when invoiceProviderId is provided.
    * @param {Object} opts
-   * @param {string} [opts.token] - API key
-   * @param {string} [opts.jwtToken] - JWT or internal auth symbol
-   * @param {TaxIdsListQuery} opts.query - taxNumber, country; optional invoiceProviderId, documentType
+   * @param {string} [opts.token] - API key (X-API-KEY)
+   * @param {string} [opts.jwtToken] - JWT or internal auth (Authorization: Bearer)
+   * @param {TaxIdsListQuery} [opts.query] - taxNumber and country (required); optional invoiceProviderId, documentType
    * @param {Object} [opts.headers] - Optional headers
-   * @returns {Promise<import("axios").AxiosResponse>} 400 WRONG_DATA, INVALID_PROVIDER_ID; 404 TAXID_NOT_FOUND
+   * @returns {Promise<import("axios").AxiosResponse<{ taxIds: Object[], total?: number, ... }>>}
+   * @throws 400 WRONG_DATA, INVALID_PROVIDER_ID, INVALID_TAX_NUMBER, INVALID_PROVIDER_CREDENTIALS
+   * @throws 401 Unauthorized
+   * @throws 404 TAXID_NOT_FOUND, PROVIDER_NOT_FOUND
+   * @throws 500 Internal server error
    */
   function all(_ref2) {
     var token = _ref2.token,

package/lib/endpoints/notifications/customers.js

@@ -70,7 +70,7 @@ function customersFactory(_ref) {
    * @param {Object} opts
    * @param {string} [opts.token] - API key
    * @param {CustomersActivationPostQuery} [opts.query] - Query params (providerId required)
-   * @param {Object} [opts.data] - Request body (CustomerForActivation)
+   * @param {Object} opts.data - Body: CustomerForActivation (firstName, lastName, email; optional activateCustomerEmailLoginToken)
    * @param {Object} [opts.headers] - Optional headers
    * @returns {Promise<import("axios").AxiosResponse>}
    */

package/lib/endpoints/notifications/external-customers.js

@@ -0,0 +1,54 @@
+"use strict";
+
+var _require = require("../endpoints_helpers.js"),
+    authorizationHeaders = _require.authorizationHeaders;
+
+/**
+ * Request body for POST /external-customers/ado/registration (btrz-api-notifications).
+ * @typedef {Object} SaldoMaxRegistrationRequest
+ * @property {string} email - User email to register in Saldo Max (verification code is sent to this email).
+ */
+
+/**
+ * Factory for external-customers API (btrz-api-notifications). Saldo Max (ADO) verification-code registration.
+ * @param {Object} deps
+ * @param {import("axios").AxiosInstance} deps.client
+ * @param {{ getToken: function(): string }} [deps.internalAuthTokenProvider]
+ * @returns {{ requestSaldoMaxVerificationCode: function }}
+ */
+
+
+function externalCustomersFactory(_ref) {
+  var client = _ref.client,
+      internalAuthTokenProvider = _ref.internalAuthTokenProvider;
+
+  /**
+   * POST /external-customers/ado/registration – Request a Saldo Max (ADO) verification code for the given email.
+   * Requires BETTEREZ_APP JWT. Forwards to Saldo Max; sends verification code to the email.
+   * @param {Object} opts
+   * @param {string} [opts.token] - API key
+   * @param {string} [opts.jwtToken] - JWT (BETTEREZ_APP audience)
+   * @param {SaldoMaxRegistrationRequest} opts.data - Body: { email } (or { body: { email } })
+   * @param {Object} [opts.headers] - Optional headers
+   * @returns {Promise<import("axios").AxiosResponse<{ code: string, message: string }>>}
+   */
+  function requestSaldoMaxVerificationCode(_ref2) {
+    var data = _ref2.data,
+        token = _ref2.token,
+        jwtToken = _ref2.jwtToken,
+        headers = _ref2.headers;
+
+    return client({
+      url: "/external-customers/ado/registration",
+      method: "post",
+      headers: authorizationHeaders({ token: token, jwtToken: jwtToken, internalAuthTokenProvider: internalAuthTokenProvider, headers: headers }),
+      data: data
+    });
+  }
+
+  return {
+    requestSaldoMaxVerificationCode: requestSaldoMaxVerificationCode
+  };
+}
+
+module.exports = externalCustomersFactory;

package/lib/endpoints/notifications/pdfs.js

@@ -82,9 +82,6 @@ function pdfFactory(_ref) {
     if (query.type === "transaction") {
       url = "/pdf-transactions/" + itemId;
     }
-    if (query.type === "transaction") {
-      url = "/pdf-transactions/" + itemId;
-    }
     if (query.type === "ssr") {
       url = "/pdf-ssrs/" + itemId;
     }

package/lib/endpoints/operations/accounting_items.js

@@ -30,12 +30,14 @@ function accountingItemsFactory(_ref) {
    * GET /accounting-items - list accounting items.
    * @param {Object} opts
    * @param {string} [opts.token] - API key
+   * @param {string} [opts.jwtToken] - JWT or internal auth symbol
    * @param {AccountingItemsListQuery} [opts.query] - Query params (all optional)
    * @param {Object} [opts.headers] - Optional headers
    * @returns {Promise<import("axios").AxiosResponse>}
    */
   function all(_ref2) {
     var token = _ref2.token,
+        jwtToken = _ref2.jwtToken,
         _ref2$query = _ref2.query,
         query = _ref2$query === undefined ? {} : _ref2$query,
         headers = _ref2.headers;
@@ -44,6 +46,7 @@ function accountingItemsFactory(_ref) {
       params: query,
       headers: authorizationHeaders({
         token: token,
+        jwtToken: jwtToken,
         internalAuthTokenProvider: internalAuthTokenProvider,
         headers: headers
       })
@@ -54,18 +57,21 @@ function accountingItemsFactory(_ref) {
    * GET /accounting-items/:accountingItemId - get accounting item by id. API does not accept query params.
    * @param {Object} opts
    * @param {string} [opts.token] - API key
-   * @param {string} opts.accountingItemId - Accounting item id
+   * @param {string} [opts.jwtToken] - JWT or internal auth symbol
+   * @param {string} opts.accountingItemId - Accounting item id (ObjectId format)
    * @param {Object} [opts.headers] - Optional headers
    * @returns {Promise<import("axios").AxiosResponse>}
    */
   function get(_ref3) {
     var accountingItemId = _ref3.accountingItemId,
         token = _ref3.token,
+        jwtToken = _ref3.jwtToken,
         headers = _ref3.headers;
 
     return client.get("/accounting-items/" + accountingItemId, {
       headers: authorizationHeaders({
         token: token,
+        jwtToken: jwtToken,
         internalAuthTokenProvider: internalAuthTokenProvider,
         headers: headers
       })

package/lib/endpoints/operations/flexpasses.js

@@ -17,14 +17,16 @@ function flexpassesFactory(_ref) {
       internalAuthTokenProvider = _ref.internalAuthTokenProvider;
 
   /**
-   * DELETE /flexpasses/:flexpassId/scannings/:tripId - delete scan by trip id. API does not accept query params.
+   * DELETE /flexpasses/:flexpassId/scannings/:tripId - deletes one flexpass scanning for the given trip ID.
+   * Removes the scan matching tripId from the flexpass's scans; if multiple scans exist for the same tripId, only one is removed.
+   * Requires operations API base URL (e.g. .../operations). No query parameters.
    * @param {Object} opts
-   * @param {string} [opts.token] - API key
-   * @param {string} [opts.jwtToken] - JWT or internal auth symbol
-   * @param {string} opts.flexpassId - Flexpass id
-   * @param {string} opts.tripId - Trip id
-   * @param {Object} [opts.headers] - Optional headers
-   * @returns {Promise<import("axios").AxiosResponse>}
+   * @param {string} [opts.token] - API key (X-API-KEY)
+   * @param {string} [opts.jwtToken] - JWT or internal auth (Authorization Bearer)
+   * @param {string} opts.flexpassId - Flexpass document ID (Mongo ObjectId string)
+   * @param {string} opts.tripId - Trip identifier of the scan to remove (e.g. routeId_scheduleName_date)
+   * @param {Object} [opts.headers] - Optional request headers
+   * @returns {Promise<import("axios").AxiosResponse<{ flexpassDeleted?: string }>>}
    */
   function deleteScanBytripId(_ref2) {
     var jwtToken = _ref2.jwtToken,

package/lib/endpoints/operations/gift-certificates.js

@@ -0,0 +1,53 @@
+"use strict";
+
+var _require = require("../endpoints_helpers.js"),
+    authorizationHeaders = _require.authorizationHeaders;
+
+/**
+ * Factory for gift-certificates API (btrz-api-operations).
+ * @param {Object} deps
+ * @param {import("axios").AxiosInstance} deps.client
+ * @param {{ getToken: function(): string }} [deps.internalAuthTokenProvider]
+ * @returns {Object} gift-certificates API methods
+ */
+
+
+function giftCertificatesFactory(_ref) {
+  var client = _ref.client,
+      internalAuthTokenProvider = _ref.internalAuthTokenProvider;
+
+  /**
+   * GET /gift-certificates - list paid gift certificates for a customer. Paginated; requires customer JWT when used with JwtAuth.
+   * @param {Object} opts
+   * @param {string} [opts.token] - API key (X-API-KEY)
+   * @param {string} [opts.jwtToken] - JWT or internal auth (Authorization Bearer); when using customer JWT, must match customer param
+   * @param {string} opts.customer - Customer number to filter by (required)
+   * @param {number} [opts.page] - 1-based page number; page size is 20
+   * @param {Object} [opts.headers] - Optional request headers
+   * @returns {Promise<import("axios").AxiosResponse<{ giftCertificates: Array<object>, count: number, next?: string, previous?: string }>>}
+   */
+  function list(_ref2) {
+    var jwtToken = _ref2.jwtToken,
+        token = _ref2.token,
+        customer = _ref2.customer,
+        page = _ref2.page,
+        headers = _ref2.headers;
+
+    var params = { customer: customer };
+    if (page != null) {
+      params.page = page;
+    }
+    return client({
+      url: "/gift-certificates",
+      method: "get",
+      params: params,
+      headers: authorizationHeaders({ token: token, jwtToken: jwtToken, internalAuthTokenProvider: internalAuthTokenProvider, headers: headers })
+    });
+  }
+
+  return {
+    list: list
+  };
+}
+
+module.exports = giftCertificatesFactory;

package/lib/endpoints/operations/loans.js

@@ -28,15 +28,17 @@ function loansFactory(_ref) {
       internalAuthTokenProvider = _ref.internalAuthTokenProvider;
 
   /**
-   * GET /loans - list loans.
+   * GET /loans - list loans for the account or provider. Paginated (20 per page). Requires operations API base URL.
    * @param {Object} opts
-   * @param {string} [opts.token] - API key
-   * @param {LoansListQuery} [opts.query] - Query params (all optional)
-   * @param {Object} [opts.headers] - Optional headers
-   * @returns {Promise<import("axios").AxiosResponse>}
+   * @param {string} [opts.token] - API key (X-API-KEY)
+   * @param {string} [opts.jwtToken] - JWT or internal auth (Authorization Bearer)
+   * @param {LoansListQuery} [opts.query] - Query params (all optional): page, shiftId, type, trxId, status, providerId
+   * @param {Object} [opts.headers] - Optional request headers
+   * @returns {Promise<import("axios").AxiosResponse<{ loans: Array<object>, count: number, next?: string, previous?: string }>>}
    */
   function all(_ref2) {
     var token = _ref2.token,
+        jwtToken = _ref2.jwtToken,
         _ref2$query = _ref2.query,
         query = _ref2$query === undefined ? {} : _ref2$query,
         headers = _ref2.headers;
@@ -45,6 +47,7 @@ function loansFactory(_ref) {
       params: query,
       headers: authorizationHeaders({
         token: token,
+        jwtToken: jwtToken,
         internalAuthTokenProvider: internalAuthTokenProvider,
         headers: headers
       })
@@ -52,21 +55,24 @@ function loansFactory(_ref) {
   }
 
   /**
-   * GET /loans/:loanId - get loan by id. API does not accept query params.
+   * GET /loans/:loanId - get a single loan by ID. Requires operations API base URL.
    * @param {Object} opts
-   * @param {string} [opts.token] - API key
-   * @param {string} opts.loanId - Loan id
-   * @param {Object} [opts.headers] - Optional headers
-   * @returns {Promise<import("axios").AxiosResponse>}
+   * @param {string} [opts.token] - API key (X-API-KEY)
+   * @param {string} [opts.jwtToken] - JWT or internal auth (Authorization Bearer)
+   * @param {string} opts.loanId - Loan document ID (24 hex characters)
+   * @param {Object} [opts.headers] - Optional request headers
+   * @returns {Promise<import("axios").AxiosResponse<{ loan: object }>>}
    */
   function get(_ref3) {
     var loanId = _ref3.loanId,
         token = _ref3.token,
+        jwtToken = _ref3.jwtToken,
         headers = _ref3.headers;
 
     return client.get("/loans/" + loanId, {
       headers: authorizationHeaders({
         token: token,
+        jwtToken: jwtToken,
         internalAuthTokenProvider: internalAuthTokenProvider,
         headers: headers
       })

package/lib/endpoints/operations/movements.js

@@ -3,6 +3,16 @@
 var _require = require("./../endpoints_helpers.js"),
     authorizationHeaders = _require.authorizationHeaders;
 
+/**
+ * Request body for POST /movements (btrz-api-operations). See MovementPostData in movements models.
+ * @typedef {Object} MovementPostData
+ * @property {Array<{ _id: string, section?: string, sectionName?: string, seat?: string, row?: string, seatId?: string }>} tickets - Tickets to move (same transaction if more than one). Each must have _id; optional seat fields for destination seatmap.
+ * @property {{ routeId: string, scheduleId: string, date: string }} newManifest - Destination manifest: routeId (ObjectId), scheduleId (UUID), date (YYYY-MM-DD).
+ * @property {string} channel - Channel of the movement (e.g. backoffice). Must be a valid backoffice channel.
+ * @property {boolean} [allowsDifferentTrx] - If true, allows moving tickets from different transactions.
+ * @property {boolean} [newdesign] - If true, uses new seatmap design for accommodation.
+ */
+
 /**
  * Factory for movements API (btrz-api-operations).
  * @param {Object} deps
@@ -17,13 +27,14 @@ function movementsFactory(_ref) {
       internalAuthTokenProvider = _ref.internalAuthTokenProvider;
 
   /**
-   * POST /movements - create movement. API does not accept query params.
+   * POST /movements - create a movement (move tickets to another manifest). No query params.
    * @param {Object} opts
-   * @param {string} [opts.token] - API key
-   * @param {string} [opts.jwtToken] - JWT or internal auth symbol
-   * @param {Object} opts.movement - Movement payload
-   * @param {Object} [opts.headers] - Optional headers
-   * @returns {Promise<import("axios").AxiosResponse>}
+   * @param {string} [opts.token] - API key (X-API-KEY)
+   * @param {string} [opts.jwtToken] - JWT or internal auth (Authorization Bearer)
+   * @param {MovementPostData} opts.movement - Request body: tickets, newManifest, channel; optional allowsDifferentTrx, newdesign
+   * @param {Object} [opts.query] - Optional query params (API accepts none)
+   * @param {Object} [opts.headers] - Optional request headers
+   * @returns {Promise<import("axios").AxiosResponse<{}>>}
    */
   function create(_ref2) {
     var token = _ref2.token,