btrz-api-client 8.30.0 → 8.32.0

package/src/endpoints/inventory/marital-status.js

@@ -1,8 +1,9 @@
 const {authorizationHeaders} = require("./../endpoints_helpers.js");
 
 /**
- * Query params for marital-status endpoints (btrz-api-inventory). Forwarded to API as-is.
- * @typedef {Object} InventoryMaritalStatusQuery
+ * Query params for GET /marital-status (btrz-api-inventory). See get-handler getSpec().
+ * @typedef {Object} MaritalStatusListQuery
+ * @property {string} [providerIds] - Provider IDs to get marital status for
  */
 
 /**
@@ -18,7 +19,7 @@ function maritalStatusFactory({client, internalAuthTokenProvider}) {
    * @param {Object} opts
    * @param {string} [opts.token] - API key
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol
-   * @param {InventoryMaritalStatusQuery} [opts.query] - Optional query params (forwarded to API)
+   * @param {MaritalStatusListQuery} [opts.query] - Query params (providerIds)
    * @param {Object} [opts.headers] - Optional headers
    * @returns {Promise<import("axios").AxiosResponse>}
    */
@@ -32,12 +33,11 @@ function maritalStatusFactory({client, internalAuthTokenProvider}) {
   }
 
   /**
-   * GET /marital-status/:id - get marital status by id.
+   * GET /marital-status/:id - get marital status by id. API does not accept query params.
    * @param {Object} opts
    * @param {string} [opts.token] - API key
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol
    * @param {string} opts.id - Marital status id
-   * @param {InventoryMaritalStatusQuery} [opts.query] - Optional query params (forwarded to API)
    * @param {Object} [opts.headers] - Optional headers
    * @returns {Promise<import("axios").AxiosResponse>}
    */
@@ -51,13 +51,12 @@ function maritalStatusFactory({client, internalAuthTokenProvider}) {
   }
 
   /**
-   * PUT /marital-status/:id - update marital status.
+   * PUT /marital-status/:id - update marital status. API does not accept query params.
    * @param {Object} opts
    * @param {string} [opts.token] - API key
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol
    * @param {string} opts.id - Marital status id
    * @param {Object} opts.data - Request body
-   * @param {InventoryMaritalStatusQuery} [opts.query] - Optional query params (forwarded to API)
    * @param {Object} [opts.headers] - Optional headers
    * @returns {Promise<import("axios").AxiosResponse>}
    */
@@ -72,12 +71,11 @@ function maritalStatusFactory({client, internalAuthTokenProvider}) {
   }
 
   /**
-   * DELETE /marital-status/:id - remove marital status.
+   * DELETE /marital-status/:id - remove marital status. API does not accept query params.
    * @param {Object} opts
    * @param {string} [opts.token] - API key
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol
    * @param {string} opts.id - Marital status id
-   * @param {InventoryMaritalStatusQuery} [opts.query] - Optional query params (forwarded to API)
    * @param {Object} [opts.headers] - Optional headers
    * @returns {Promise<import("axios").AxiosResponse>}
    */
@@ -91,12 +89,11 @@ function maritalStatusFactory({client, internalAuthTokenProvider}) {
   }
 
   /**
-   * POST /marital-status - create marital status.
+   * POST /marital-status - create marital status. API does not accept query params.
    * @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 {InventoryMaritalStatusQuery} [opts.query] - Optional query params (forwarded to API)
    * @param {Object} [opts.headers] - Optional headers
    * @returns {Promise<import("axios").AxiosResponse>}
    */

package/src/endpoints/inventory/marketplace-modifiers.js

@@ -3,8 +3,17 @@ const {
 } = require("../endpoints_helpers.js");
 
 /**
- * Query params for marketplace-modifiers endpoints (btrz-api-inventory). Forwarded to API as-is.
- * @typedef {Object} InventoryMarketplaceModifiersQuery
+ * Query params for GET /marketplace-modifiers (btrz-api-inventory). See get-handler getSpec().
+ * @typedef {Object} MarketplaceModifiersListQuery
+ * @property {string} [externalField1] - Filter by externalField1
+ * @property {string} [externalField2] - Filter by externalField2
+ * @property {string} [externalField3] - Filter by externalField3
+ * @property {string} [createdBy] - Comma-separated user IDs (created by)
+ * @property {string} [updatedBy] - Comma-separated user IDs (updated by)
+ * @property {string} [earliestPurchaseDate] - ISO 8601 datetime (purchase on or after)
+ * @property {string} [latestPurchaseDate] - ISO 8601 datetime (purchase on or before)
+ * @property {string} [earliestTravelDate] - ISO 8601 datetime (trip depart on or after)
+ * @property {string} [latestTravelDate] - ISO 8601 datetime (trip depart on or before)
  */
 
 /**
@@ -19,7 +28,7 @@ function marketplaceModifierFactory({client, internalAuthTokenProvider}) {
    * GET /marketplace-modifiers - list marketplace modifiers.
    * @param {Object} opts
    * @param {string} [opts.token] - API key
-   * @param {InventoryMarketplaceModifiersQuery} [opts.query] - Optional query params (forwarded to API)
+   * @param {MarketplaceModifiersListQuery} [opts.query] - Query params
    * @param {Object} [opts.headers] - Optional headers
    * @returns {Promise<import("axios").AxiosResponse>}
    */
@@ -35,7 +44,7 @@ function marketplaceModifierFactory({client, internalAuthTokenProvider}) {
   }
 
   /**
-   * GET /marketplace-modifiers/:marketplaceModifierId - get marketplace modifier by id.
+   * GET /marketplace-modifiers/:marketplaceModifierId - get marketplace modifier by id. API does not accept query params.
    * @param {Object} opts
    * @param {string} opts.marketplaceModifierId - Marketplace modifier id
    * @param {string} [opts.token] - API key
@@ -49,7 +58,7 @@ function marketplaceModifierFactory({client, internalAuthTokenProvider}) {
   }
 
   /**
-   * POST /marketplace-modifiers - create marketplace modifier.
+   * POST /marketplace-modifiers - create marketplace modifier. API does not accept query params.
    * @param {Object} opts
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol
    * @param {string} [opts.token] - API key
@@ -69,7 +78,7 @@ function marketplaceModifierFactory({client, internalAuthTokenProvider}) {
   }
 
   /**
-   * DELETE /marketplace-modifiers/:marketplaceModifierId - remove marketplace modifier.
+   * DELETE /marketplace-modifiers/:marketplaceModifierId - remove marketplace modifier. API does not accept query params.
    * @param {Object} opts
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol
    * @param {string} opts.marketplaceModifierId - Marketplace modifier id
@@ -86,7 +95,7 @@ function marketplaceModifierFactory({client, internalAuthTokenProvider}) {
   }
 
   /**
-   * PUT /marketplace-modifiers/:marketplaceModifierId - update marketplace modifier.
+   * PUT /marketplace-modifiers/:marketplaceModifierId - update marketplace modifier. API does not accept query params.
    * @param {Object} opts
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol
    * @param {string} [opts.token] - API key

package/src/endpoints/inventory/mit-terminal-settings.js

@@ -2,11 +2,6 @@ const {
   authorizationHeaders
 } = require("../endpoints_helpers.js");
 
-/**
- * @typedef {Object} MitTerminalSettingsQuery
- * @property {string} [providerId] - Provider account ID
- */
-
 /**
  * Factory for mit-terminals-settings API (btrz-api-inventory).
  * @param {Object} deps
@@ -16,11 +11,10 @@ const {
  */
 function mitTerminalFactory({client, internalAuthTokenProvider}) {
   /**
-   * GET /mit-terminals-settings - list MIT terminal settings.
+   * GET /mit-terminals-settings - list MIT terminal settings. API does not accept query params.
    * @param {Object} opts
    * @param {string} [opts.token] - API key
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol
-   * @param {MitTerminalSettingsQuery} [opts.query] - Query params
    * @param {Object} [opts.headers] - Optional headers
    * @returns {Promise<import("axios").AxiosResponse>}
    */
@@ -37,7 +31,7 @@ function mitTerminalFactory({client, internalAuthTokenProvider}) {
   }
 
   /**
-   * GET /mit-terminals-settings/:id - get MIT terminal setting by id.
+   * GET /mit-terminals-settings/:id - get MIT terminal setting by id. API does not accept query params.
    * @param {Object} opts
    * @param {string} [opts.token] - API key
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol
@@ -52,7 +46,7 @@ function mitTerminalFactory({client, internalAuthTokenProvider}) {
   }
 
   /**
-   * POST /mit-terminals-settings - create MIT terminal settings.
+   * POST /mit-terminals-settings - create MIT terminal settings. API does not accept query params.
    * @param {Object} opts
    * @param {string} [opts.token] - API key
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol
@@ -72,7 +66,7 @@ function mitTerminalFactory({client, internalAuthTokenProvider}) {
   }
 
   /**
-   * DELETE /mit-terminals-settings/:id - remove MIT terminal settings.
+   * DELETE /mit-terminals-settings/:id - remove MIT terminal settings. API does not accept query params.
    * @param {Object} opts
    * @param {string} [opts.token] - API key
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol
@@ -89,7 +83,7 @@ function mitTerminalFactory({client, internalAuthTokenProvider}) {
   }
 
   /**
-   * PUT /mit-terminals-settings/:id - update MIT terminal settings.
+   * PUT /mit-terminals-settings/:id - update MIT terminal settings. API does not accept query params.
    * @param {Object} opts
    * @param {string} [opts.token] - API key
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol

package/src/endpoints/inventory/mit-terminals.js

@@ -2,11 +2,6 @@ const {
   authorizationHeaders
 } = require("../endpoints_helpers.js");
 
-/**
- * @typedef {Object} MitTerminalsQuery
- * @property {string} [providerId] - Provider account ID
- */
-
 /**
  * Factory for mit-terminals API (btrz-api-inventory).
  * @param {Object} deps
@@ -16,11 +11,10 @@ const {
  */
 function mitTerminalFactory({client, internalAuthTokenProvider}) {
   /**
-   * GET /mit-terminals - list MIT terminals.
+   * GET /mit-terminals - list MIT terminals. API does not accept query params.
    * @param {Object} opts
    * @param {string} [opts.token] - API key
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol
-   * @param {MitTerminalsQuery} [opts.query] - Query params
    * @param {Object} [opts.headers] - Optional headers
    * @returns {Promise<import("axios").AxiosResponse>}
    */
@@ -36,7 +30,7 @@ function mitTerminalFactory({client, internalAuthTokenProvider}) {
   }
 
   /**
-   * GET /mit-terminals/:mitTerminalId - get MIT terminal by id.
+   * GET /mit-terminals/:mitTerminalId - get MIT terminal by id. API does not accept query params.
    * @param {Object} opts
    * @param {string} [opts.token] - API key
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol
@@ -51,7 +45,7 @@ function mitTerminalFactory({client, internalAuthTokenProvider}) {
   }
 
   /**
-   * POST /mit-terminals - create MIT terminal.
+   * POST /mit-terminals - create MIT terminal. API does not accept query params.
    * @param {Object} opts
    * @param {string} [opts.token] - API key
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol
@@ -71,7 +65,7 @@ function mitTerminalFactory({client, internalAuthTokenProvider}) {
   }
 
   /**
-   * DELETE /mit-terminals/:mitTerminalId - remove MIT terminal.
+   * DELETE /mit-terminals/:mitTerminalId - remove MIT terminal. API does not accept query params.
    * @param {Object} opts
    * @param {string} [opts.token] - API key
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol
@@ -88,7 +82,7 @@ function mitTerminalFactory({client, internalAuthTokenProvider}) {
   }
 
   /**
-   * PUT /mit-terminals/:mitTerminalId - update MIT terminal.
+   * PUT /mit-terminals/:mitTerminalId - update MIT terminal. API does not accept query params.
    * @param {Object} opts
    * @param {string} [opts.token] - API key
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol

package/src/endpoints/inventory/operating-companies.js

@@ -1,8 +1,11 @@
 const {authorizationHeaders} = require("./../endpoints_helpers.js");
 
 /**
- * @typedef {Object} OperatingCompaniesQuery
- * @property {string} [providerId] - Provider account ID
+ * Query params for GET /operating-companies (btrz-api-inventory). See get-operating-companies getSpec().
+ * @typedef {Object} OperatingCompaniesListQuery
+ * @property {string} [providerIds] - Provider IDs to get operating companies for
+ * @property {string} [enabled] - Filter by enabled [true, false]
+ * @property {number} [page] - Page number (1-based); null for unpaginated
  */
 
 /**
@@ -18,7 +21,7 @@ function operatingCompaniesFactory({client, internalAuthTokenProvider}) {
    * @param {Object} opts
    * @param {string} [opts.token] - API key
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol
-   * @param {OperatingCompaniesQuery} [opts.query] - Query params
+   * @param {OperatingCompaniesListQuery} [opts.query] - Query params (providerIds, enabled, page)
    * @param {Object} [opts.headers] - Optional headers
    * @returns {Promise<import("axios").AxiosResponse>}
    */
@@ -31,7 +34,7 @@ function operatingCompaniesFactory({client, internalAuthTokenProvider}) {
   }
 
   /**
-   * POST /operating-companies - create operating company.
+   * POST /operating-companies - create operating company. API does not accept query params.
    * @param {Object} opts
    * @param {string} [opts.token] - API key
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol
@@ -49,7 +52,7 @@ function operatingCompaniesFactory({client, internalAuthTokenProvider}) {
   }
 
   /**
-   * PUT /operating-companies/:operatingCompanyId - update operating company.
+   * PUT /operating-companies/:operatingCompanyId - update operating company. API does not accept query params.
    * @param {Object} opts
    * @param {string} [opts.token] - API key
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol
@@ -68,7 +71,7 @@ function operatingCompaniesFactory({client, internalAuthTokenProvider}) {
   }
 
   /**
-   * GET /operating-companies/:operatingCompanyId - get operating company by id.
+   * GET /operating-companies/:operatingCompanyId - get operating company by id. API does not accept query params.
    * @param {Object} opts
    * @param {string} [opts.token] - API key
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol
@@ -87,7 +90,7 @@ function operatingCompaniesFactory({client, internalAuthTokenProvider}) {
   /** @type {{ create: function, all: function, get: function, update: function }} */
   const sequences = {
     /**
-     * POST /operating-companies/:operatingCompanyId/sequences - create sequence.
+     * POST /operating-companies/:operatingCompanyId/sequences - create sequence. API does not accept query params.
      * @param {Object} opts
      * @param {string} [opts.token] - API key
      * @param {string} [opts.jwtToken] - JWT or internal auth symbol
@@ -105,7 +108,7 @@ function operatingCompaniesFactory({client, internalAuthTokenProvider}) {
       });
     },
     /**
-     * GET /operating-companies/:operatingCompanyId/sequences - list sequences.
+     * GET /operating-companies/:operatingCompanyId/sequences - list sequences. API does not accept query params.
      * @param {Object} opts
      * @param {string} [opts.token] - API key
      * @param {string} [opts.jwtToken] - JWT or internal auth symbol
@@ -121,7 +124,7 @@ function operatingCompaniesFactory({client, internalAuthTokenProvider}) {
       });
     },
     /**
-     * GET /operating-companies/:operatingCompanyId/sequences/:sequenceId - get sequence.
+     * GET /operating-companies/:operatingCompanyId/sequences/:sequenceId - get sequence. API does not accept query params.
      * @param {Object} opts
      * @param {string} [opts.token] - API key
      * @param {string} [opts.jwtToken] - JWT or internal auth symbol
@@ -138,7 +141,7 @@ function operatingCompaniesFactory({client, internalAuthTokenProvider}) {
       });
     },
     /**
-     * PUT /operating-companies/:operatingCompanyId/sequences/:sequenceId - update sequence.
+     * PUT /operating-companies/:operatingCompanyId/sequences/:sequenceId - update sequence. API does not accept query params.
      * @param {Object} opts
      * @param {string} [opts.token] - API key
      * @param {string} [opts.jwtToken] - JWT or internal auth symbol

package/src/endpoints/inventory/operation-messages.js

@@ -1,8 +1,17 @@
 const {authorizationHeaders} = require("./../endpoints_helpers.js");
 
 /**
- * Query params for operation-messages endpoints (btrz-api-inventory). Forwarded to API as-is.
- * @typedef {Object} InventoryOperationMessagesQuery
+ * Query params for GET /operation-messages (btrz-api-inventory). See get-operation-messages getSpec().
+ * @typedef {Object} OperationMessagesListQuery
+ * @property {string} [providerId] - Provider id to get operation messages for
+ * @property {number} [page] - Page number (default 1)
+ * @property {string} [name] - Full or partial name (non case sensitive)
+ * @property {string} [type] - Operation message type
+ * @property {string} [stationId] - Station id of the operation message
+ * @property {string} [avoidPagination] - Any value = true to avoid pagination
+ * @property {string} [active] - Filter active/inactive [true, false]
+ * @property {string} [effectiveDateTimeStartBefore] - ISO datetime (start before/at)
+ * @property {string} [effectiveDateTimeEndAfter] - ISO datetime (end after/at)
  */
 
 /**
@@ -17,7 +26,7 @@ function operationMessagesFactory({client, internalAuthTokenProvider}) {
    * GET /operation-messages - list operation messages.
    * @param {Object} opts
    * @param {string} [opts.token] - API key
-   * @param {InventoryOperationMessagesQuery} [opts.query] - Optional query params (forwarded to API)
+   * @param {OperationMessagesListQuery} [opts.query] - Query params
    * @param {Object} [opts.headers] - Optional headers
    * @returns {Promise<import("axios").AxiosResponse>}
    */
@@ -31,7 +40,7 @@ function operationMessagesFactory({client, internalAuthTokenProvider}) {
   }
 
   /**
-   * POST /operation-messages - create operation message.
+   * POST /operation-messages - create operation message. API does not accept query params.
    * @param {Object} opts
    * @param {string} [opts.token] - API key
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol
@@ -49,7 +58,7 @@ function operationMessagesFactory({client, internalAuthTokenProvider}) {
   }
 
   /**
-   * PUT /operation-messages/:operationMessageId - update operation message.
+   * PUT /operation-messages/:operationMessageId - update operation message. API does not accept query params.
    * @param {Object} opts
    * @param {string} [opts.token] - API key
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol
@@ -68,7 +77,7 @@ function operationMessagesFactory({client, internalAuthTokenProvider}) {
   }
 
   /**
-   * GET /operation-messages/:operationMessageId - get operation message by id.
+   * GET /operation-messages/:operationMessageId - get operation message by id. API does not accept query params.
    * @param {Object} opts
    * @param {string} [opts.token] - API key
    * @param {string} opts.operationMessageId - Operation message id
@@ -84,7 +93,7 @@ function operationMessagesFactory({client, internalAuthTokenProvider}) {
   }
 
   /**
-   * DELETE /operation-messages/:operationMessageId - remove operation message.
+   * DELETE /operation-messages/:operationMessageId - remove operation message. API does not accept query params.
    * @param {Object} opts
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol
    * @param {string} opts.operationMessageId - Operation message id

package/src/endpoints/inventory/operation-reasons.js

@@ -1,5 +1,11 @@
 const {authorizationHeaders} = require("../endpoints_helpers.js");
 
+/**
+ * Query params for GET /operation-reasons (btrz-api-inventory). See get-handler getSpec().
+ * @typedef {Object} OperationReasonsListQuery
+ * @property {number} [page] - The page number to retrieve
+ */
+
 /**
  * Factory for operation-reasons API (btrz-api-inventory).
  * @param {Object} deps
@@ -13,7 +19,7 @@ function operationReasonFactory({client, internalAuthTokenProvider}) {
    * @param {Object} opts
    * @param {string} [opts.token] - API key
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol
-   * @param {Object} [opts.query] - Query params
+   * @param {OperationReasonsListQuery} [opts.query] - Query params (page)
    * @param {Object} [opts.headers] - Optional headers
    * @returns {Promise<import("axios").AxiosResponse>}
    */
@@ -27,12 +33,11 @@ function operationReasonFactory({client, internalAuthTokenProvider}) {
   }
 
   /**
-   * GET /operation-reasons/:id - get operation reason by id.
+   * GET /operation-reasons/:id - get operation reason by id. API does not accept query params.
    * @param {Object} opts
    * @param {string} [opts.token] - API key
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol
    * @param {string} opts.id - Operation reason id
-   * @param {Object} [opts.query] - Query params
    * @param {Object} [opts.headers] - Optional headers
    * @returns {Promise<import("axios").AxiosResponse>}
    */
@@ -46,13 +51,12 @@ function operationReasonFactory({client, internalAuthTokenProvider}) {
   }
 
   /**
-   * PUT /operation-reasons/:id - update operation reason.
+   * PUT /operation-reasons/:id - update operation reason. API does not accept query params.
    * @param {Object} opts
    * @param {string} [opts.token] - API key
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol
    * @param {string} opts.id - Operation reason id
    * @param {Object} opts.operationReason - Operation reason payload
-   * @param {Object} [opts.query] - Query params
    * @param {Object} [opts.headers] - Optional headers
    * @returns {Promise<import("axios").AxiosResponse>}
    */
@@ -67,12 +71,11 @@ function operationReasonFactory({client, internalAuthTokenProvider}) {
   }
 
   /**
-   * DELETE /operation-reasons/:id - remove operation reason.
+   * DELETE /operation-reasons/:id - remove operation reason. API does not accept query params.
    * @param {Object} opts
    * @param {string} [opts.token] - API key
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol
    * @param {string} opts.id - Operation reason id
-   * @param {Object} [opts.query] - Query params
    * @param {Object} [opts.headers] - Optional headers
    * @returns {Promise<import("axios").AxiosResponse>}
    */
@@ -86,12 +89,11 @@ function operationReasonFactory({client, internalAuthTokenProvider}) {
   }
 
   /**
-   * POST /operation-reasons - create operation reason.
+   * POST /operation-reasons - create operation reason. API does not accept query params.
    * @param {Object} opts
    * @param {string} [opts.token] - API key
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol
    * @param {Object} opts.operationReason - Operation reason payload
-   * @param {Object} [opts.query] - Query params
    * @param {Object} [opts.headers] - Optional headers
    * @returns {Promise<import("axios").AxiosResponse>}
    */

package/src/endpoints/inventory/parcel-zones.js

@@ -1,8 +1,9 @@
 const {authorizationHeaders} = require("./../endpoints_helpers.js");
 
 /**
- * Query params for parcel-zones endpoints (btrz-api-inventory). Forwarded to API as-is.
- * @typedef {Object} InventoryParcelZonesQuery
+ * Query params for GET /parcel-zones (btrz-api-inventory). See get-parcel-zones getSpec().
+ * @typedef {Object} ParcelZonesListQuery
+ * @property {string} [providerIds] - Provider IDs to get parcel zones for
  */
 
 /**
@@ -17,7 +18,7 @@ function parcelZonesFactory({client, internalAuthTokenProvider}) {
    * GET /parcel-zones - list parcel zones.
    * @param {Object} opts
    * @param {string} [opts.token] - API key
-   * @param {InventoryParcelZonesQuery} [opts.query] - Optional query params (forwarded to API)
+   * @param {ParcelZonesListQuery} [opts.query] - Query params (providerIds)
    * @param {Object} [opts.headers] - Optional headers
    * @returns {Promise<import("axios").AxiosResponse>}
    */
@@ -29,7 +30,7 @@ function parcelZonesFactory({client, internalAuthTokenProvider}) {
   }
 
   /**
-   * POST /parcel-zones - create parcel zone.
+   * POST /parcel-zones - create parcel zone. API does not accept query params.
    * @param {Object} opts
    * @param {string} [opts.token] - API key
    * @param {Object} opts.parcelZone - Parcel zone payload
@@ -47,7 +48,7 @@ function parcelZonesFactory({client, internalAuthTokenProvider}) {
   }
 
   /**
-   * PUT /parcel-zone/:parcelZoneId - update parcel zone.
+   * PUT /parcel-zone/:parcelZoneId - update parcel zone. API does not accept query params.
    * @param {Object} opts
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol
    * @param {string} [opts.token] - API key

package/src/endpoints/inventory/pay-on-accounts.js

@@ -1,8 +1,14 @@
 const {authorizationHeaders} = require("../endpoints_helpers.js");
 
 /**
- * @typedef {Object} PayOnAccountsQuery
- * @property {string} [providerId] - Provider account ID
+ * Query params for GET /pay-on-accounts (btrz-api-inventory). See get-handler getSpec().
+ * @typedef {Object} PayOnAccountsListQuery
+ * @property {number} [page] - Page number
+ * @property {string} [format] - Format to retrieve the data
+ * @property {string} [disabled] - Filter by disabled [true, false]
+ * @property {string} [term] - Search term to filter PayOnAccounts
+ * @property {string} [fareIds] - Fare ids to filter
+ * @property {string} [providerId] - Provider id to filter
  */
 
 /**
@@ -18,7 +24,7 @@ function payOnAccountsFactory({client, internalAuthTokenProvider}) {
    * @param {Object} opts
    * @param {string} [opts.token] - API key
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol
-   * @param {PayOnAccountsQuery} [opts.query] - Query params
+   * @param {PayOnAccountsListQuery} [opts.query] - Query params
    * @param {string} [opts.responseType] - Response type (e.g. json)
    * @param {Object} [opts.headers] - Optional headers
    * @returns {Promise<import("axios").AxiosResponse>}

package/src/endpoints/inventory/payment-terminals.js

@@ -2,11 +2,6 @@ const {
   authorizationHeaders
 } = require("./../endpoints_helpers.js");
 
-/**
- * Query params for payment-terminals endpoints (btrz-api-inventory). Forwarded to API as-is.
- * @typedef {Object} InventoryPaymentTerminalsQuery
- */
-
 /**
  * Factory for payment-terminals API (btrz-api-inventory).
  * @param {Object} deps
@@ -16,10 +11,9 @@ const {
  */
 function paymentTerminalFactory({client, internalAuthTokenProvider}) {
   /**
-   * GET /payment-terminals - list payment terminals.
+   * GET /payment-terminals - list payment terminals. API does not accept query params.
    * @param {Object} opts
    * @param {string} [opts.token] - API key
-   * @param {InventoryPaymentTerminalsQuery} [opts.query] - Optional query params (forwarded to API)
    * @param {Object} [opts.headers] - Optional headers
    * @returns {Promise<import("axios").AxiosResponse>}
    */
@@ -35,7 +29,7 @@ function paymentTerminalFactory({client, internalAuthTokenProvider}) {
   }
 
   /**
-   * GET /payment-terminals/:paymentTerminalId - get payment terminal by id.
+   * GET /payment-terminals/:paymentTerminalId - get payment terminal by id. API does not accept query params.
    * @param {Object} opts
    * @param {string} opts.paymentTerminalId - Payment terminal id
    * @param {string} [opts.token] - API key
@@ -49,7 +43,7 @@ function paymentTerminalFactory({client, internalAuthTokenProvider}) {
   }
 
   /**
-   * POST /payment-terminals - create payment terminal.
+   * POST /payment-terminals - create payment terminal. API does not accept query params.
    * @param {Object} opts
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol
    * @param {string} [opts.token] - API key
@@ -69,7 +63,7 @@ function paymentTerminalFactory({client, internalAuthTokenProvider}) {
   }
 
   /**
-   * DELETE /payment-terminals/:paymentTerminalId - remove payment terminal.
+   * DELETE /payment-terminals/:paymentTerminalId - remove payment terminal. API does not accept query params.
    * @param {Object} opts
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol
    * @param {string} opts.paymentTerminalId - Payment terminal id
@@ -86,7 +80,7 @@ function paymentTerminalFactory({client, internalAuthTokenProvider}) {
   }
 
   /**
-   * PUT /payment-terminals/:paymentTerminalId - update payment terminal.
+   * PUT /payment-terminals/:paymentTerminalId - update payment terminal. API does not accept query params.
    * @param {Object} opts
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol
    * @param {string} [opts.token] - API key

package/src/endpoints/inventory/prisma-terminals.js

@@ -3,8 +3,12 @@ const {
 } = require("../endpoints_helpers.js");
 
 /**
- * @typedef {Object} InventoryPrismaTerminalsQuery
- * @property {string} [providerId] - Provider account ID
+ * Query params for GET /prisma-terminals (btrz-api-inventory). See get-handler getSpec().
+ * @typedef {Object} PrismaTerminalsListQuery
+ * @property {number} [page] - Page number
+ * @property {string} [providerId] - Account provider (operator) ID
+ * @property {string} [name] - Filter by terminal name (exact match)
+ * @property {string} [externalId] - Filter by terminal externalId (exact match)
  */
 
 /**
@@ -20,7 +24,7 @@ function prismaTerminalFactory({client, internalAuthTokenProvider}) {
    * @param {Object} opts
    * @param {string} [opts.token] - API key
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol
-   * @param {InventoryPrismaTerminalsQuery} [opts.query] - Query params
+   * @param {PrismaTerminalsListQuery} [opts.query] - Query params
    * @param {Object} [opts.headers] - Optional headers
    * @returns {Promise<import("axios").AxiosResponse>}
    */
@@ -52,7 +56,7 @@ function prismaTerminalFactory({client, internalAuthTokenProvider}) {
   }
 
   /**
-   * POST /prisma-terminals - create prisma terminal.
+   * POST /prisma-terminals - create prisma terminal. API does not accept query params.
    * @param {Object} opts
    * @param {string} [opts.token] - API key
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol
@@ -72,7 +76,7 @@ function prismaTerminalFactory({client, internalAuthTokenProvider}) {
   }
 
   /**
-   * DELETE /prisma-terminals/:prismaTerminalId - remove prisma terminal.
+   * DELETE /prisma-terminals/:prismaTerminalId - remove prisma terminal. API does not accept query params.
    * @param {Object} opts
    * @param {string} [opts.token] - API key
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol
@@ -89,7 +93,7 @@ function prismaTerminalFactory({client, internalAuthTokenProvider}) {
   }
 
   /**
-   * PUT /prisma-terminals/:prismaTerminalId - update prisma terminal.
+   * PUT /prisma-terminals/:prismaTerminalId - update prisma terminal. API does not accept query params.
    * @param {Object} opts
    * @param {string} [opts.token] - API key
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol