btrz-api-client 8.34.0 → 8.36.0

package/src/endpoints/inventory/countries.js

@@ -3,7 +3,14 @@ const {authorizationHeaders} = require("./../endpoints_helpers.js");
 /**
  * Query params for GET /countries (btrz-api-inventory). See get-countries getSpec().
  * @typedef {Object} CountriesListQuery
- * @property {string} [isoCode] - Country 2 or 3 letter ISO code
+ * @property {string} [isoCode] - Country 2- or 3-letter ISO code (must be 2 or 3 chars if provided)
+ */
+
+/**
+ * Query params for GET /countries/:countryId (btrz-api-inventory). See getCountryById getSpec().
+ * @typedef {Object} CountryGetQuery
+ * @property {string} [include] - Address level to include: "provinces" (default), "counties", "cities", "neighborhoods"
+ * @property {string} [parentKey] - Parent address level to filter by when include is not provinces
  */
 
 /**
@@ -15,30 +22,38 @@ const {authorizationHeaders} = require("./../endpoints_helpers.js");
  */
 function countriesFactory({client, internalAuthTokenProvider}) {
   /**
-   * GET /countries - list countries.
+   * GET /countries — List countries. Optional filter by isoCode (2 or 3 characters).
    * @param {Object} opts
    * @param {string} [opts.token] - API key
-   * @param {string} [opts.jwtToken] - JWT or internal auth symbol
+   * @param {string} [opts.jwtToken] - JWT or internal auth
    * @param {CountriesListQuery} [opts.query] - Query params (isoCode)
    * @param {Object} [opts.headers] - Optional headers
-   * @returns {Promise<import("axios").AxiosResponse>}
+   * @returns {Promise<import("axios").AxiosResponse<{ countries: Object[] }>>}
+   * @throws 400 Validation failure (e.g. invalid isoCode length)
+   * @throws 401 Unauthorized
+   * @throws 500 Internal server error
    */
-  function all({token, query = {}, headers}) {
+  function all({token, jwtToken, query = {}, headers}) {
     return client({
       url: "/countries",
       params: query,
-      headers: authorizationHeaders({token, internalAuthTokenProvider, headers})
+      headers: authorizationHeaders({token, jwtToken, internalAuthTokenProvider, headers})
     });
   }
 
   /**
-   * GET /countries/:id - get country by id. API does not accept query params.
+   * GET /countries/:id — Get country by id. Optional include (provinces/counties/cities/neighborhoods) and parentKey.
    * @param {Object} opts
    * @param {string} [opts.token] - API key
-   * @param {string} [opts.jwtToken] - JWT or internal auth symbol
-   * @param {string} opts.id - Country id
+   * @param {string} [opts.jwtToken] - JWT or internal auth
+   * @param {string} opts.id - Country id (24 hex)
+   * @param {CountryGetQuery} [opts.query] - Query params (include, parentKey)
    * @param {Object} [opts.headers] - Optional headers
-   * @returns {Promise<import("axios").AxiosResponse>}
+   * @returns {Promise<import("axios").AxiosResponse<{ country: Object }>>}
+   * @throws 400 INVALID_COUNTRY_ID
+   * @throws 401 Unauthorized
+   * @throws 404 COUNTRY_NOT_FOUND
+   * @throws 500 Internal server error
    */
   function get({token, jwtToken, id, query = {}, headers}) {
     return client({

package/src/endpoints/inventory/custom-content.js

@@ -18,13 +18,14 @@ const {
  */
 function customContentFactory({client, internalAuthTokenProvider}) {
   /**
-   * GET /custom-content - list custom content.
+   * GET /custom-content — List custom content (paginated). Query: enabled, pageId.
    * @param {Object} opts
    * @param {string} [opts.token] - API key
-   * @param {string} [opts.jwtToken] - JWT or internal auth symbol
    * @param {InventoryCustomContentQuery} [opts.query] - Query params (enabled, pageId)
    * @param {Object} [opts.headers] - Optional headers
-   * @returns {Promise<import("axios").AxiosResponse>}
+   * @returns {Promise<import("axios").AxiosResponse<{ customContent: Object[] }>>}
+   * @throws 401 Unauthorized
+   * @throws 500 Internal server error
    */
   function all({
     token,
@@ -38,28 +39,35 @@ function customContentFactory({client, internalAuthTokenProvider}) {
   }
 
   /**
-   * GET /custom-content/:customContentId - get custom content by id. API does not accept query params.
+   * GET /custom-content/:customContentId — Get custom content by id.
    * @param {Object} opts
    * @param {string} [opts.token] - API key
-   * @param {string} [opts.jwtToken] - JWT or internal auth symbol
-   * @param {string} opts.customContentId - Custom content id
+   * @param {string} [opts.jwtToken] - JWT or internal auth
+   * @param {string} opts.customContentId - Custom content id (24 hex)
    * @param {Object} [opts.headers] - Optional headers
-   * @returns {Promise<import("axios").AxiosResponse>}
+   * @returns {Promise<import("axios").AxiosResponse<{ customContent: Object }>>}
+   * @throws 400 INVALID_CUSTOMCONTENT_ID
+   * @throws 401 Unauthorized
+   * @throws 404 CUSTOMCONTENT_NOT_FOUND
+   * @throws 500 Internal server error
    */
-  function get({customContentId, token, headers}) {
+  function get({customContentId, token, jwtToken, headers}) {
     return client.get(`/custom-content/${customContentId}`, {
-      headers: authorizationHeaders({token, internalAuthTokenProvider, headers})
+      headers: authorizationHeaders({token, jwtToken, internalAuthTokenProvider, headers})
     });
   }
 
   /**
-   * POST /custom-content - create custom content. API does not accept query params.
+   * POST /custom-content — Create custom content. Body: { customContent }. Emits customContent.created.
    * @param {Object} opts
    * @param {string} [opts.token] - API key
-   * @param {string} [opts.jwtToken] - JWT or internal auth symbol
-   * @param {Object} opts.customContent - Custom content payload
+   * @param {string} [opts.jwtToken] - JWT or internal auth
+   * @param {Object} opts.customContent - CustomContentPost (name, pageId, lang required; at least one of title, text, imgUrl, mainUrl)
    * @param {Object} [opts.headers] - Optional headers
-   * @returns {Promise<import("axios").AxiosResponse>}
+   * @returns {Promise<import("axios").AxiosResponse<{ customContent: Object }>>}
+   * @throws 400 WRONG_DATA, INVALID_CUSTOMCONTENT
+   * @throws 401 Unauthorized
+   * @throws 500 Internal server error
    */
   function create({jwtToken, token, customContent, headers}) {
     return client({
@@ -73,13 +81,17 @@ function customContentFactory({client, internalAuthTokenProvider}) {
   }
 
   /**
-   * DELETE /custom-content/:customContentId - remove custom content. API does not accept query params.
+   * DELETE /custom-content/:customContentId — Delete custom content. Emits customContent.deleted.
    * @param {Object} opts
    * @param {string} [opts.token] - API key
-   * @param {string} [opts.jwtToken] - JWT or internal auth symbol
-   * @param {string} opts.customContentId - Custom content id
+   * @param {string} [opts.jwtToken] - JWT or internal auth
+   * @param {string} opts.customContentId - Custom content id (24 hex)
    * @param {Object} [opts.headers] - Optional headers
-   * @returns {Promise<import("axios").AxiosResponse>}
+   * @returns {Promise<import("axios").AxiosResponse<{ customContentId: string }>>}
+   * @throws 400 CUSTOMCONTENT_TERMINAL_ID, WRONG_DATA
+   * @throws 401 Unauthorized
+   * @throws 404 CUSTOMCONTENT_NOT_FOUND
+   * @throws 500 Internal server error
    */
   function remove({jwtToken, customContentId, token, headers}) {
     return client({
@@ -90,14 +102,18 @@ function customContentFactory({client, internalAuthTokenProvider}) {
   }
 
   /**
-   * PUT /custom-content/:customContentId - update custom content. API does not accept query params.
+   * PUT /custom-content/:customContentId — Update custom content. Body: { customContent }. Emits customContent.updated.
    * @param {Object} opts
    * @param {string} [opts.token] - API key
-   * @param {string} [opts.jwtToken] - JWT or internal auth symbol
-   * @param {string} opts.customContentId - Custom content id
-   * @param {Object} opts.customContent - Custom content payload
+   * @param {string} [opts.jwtToken] - JWT or internal auth
+   * @param {string} opts.customContentId - Custom content id (24 hex)
+   * @param {Object} opts.customContent - CustomContentPost (at least one of title, text, imgUrl for update)
    * @param {Object} [opts.headers] - Optional headers
-   * @returns {Promise<import("axios").AxiosResponse>}
+   * @returns {Promise<import("axios").AxiosResponse<{ customContent: Object }>>}
+   * @throws 400 WRONG_DATA, INVALID_CUSTOMCONTENT_UPDATE
+   * @throws 401 Unauthorized
+   * @throws 404 CUSTOMCONTENT_NOT_FOUND
+   * @throws 500 Internal server error
    */
   function update({jwtToken, token, customContentId, customContent, headers}) {
     return client({

package/src/endpoints/inventory/custom-fields.js

@@ -13,34 +13,36 @@ const {authorizationHeaders} = require("./../endpoints_helpers.js");
  * @param {Object} deps
  * @param {import("axios").AxiosInstance} deps.client
  * @param {{ getToken: function(): string }} [deps.internalAuthTokenProvider]
- * @returns {{ all: function, get: function, create: function, update: function, types: object }}
+ * @returns {{ all: function, get: function, create: function, update: function, types: { all: function } }}
  */
 function customFieldsFactory({client, internalAuthTokenProvider}) {
   /**
-   * GET /custom-fields - list custom fields.
+   * GET /custom-fields - list custom fields (btrz-api-inventory).
    * @param {Object} opts
    * @param {string} [opts.token] - API key
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol
    * @param {InventoryCustomFieldsQuery} [opts.query] - Query params (enabled, required, modelName)
    * @param {Object} [opts.headers] - Optional headers
-   * @returns {Promise<import("axios").AxiosResponse>}
+   * @returns {Promise<import("axios").AxiosResponse<{ customfields: Array }>>}
+   * @throws When response is 4xx/5xx (e.g. 400 INVALID_MODEL_NAME, 401 Unauthorized, 500)
    */
-  function all({token, query = {}, headers}) {
+  function all({token, jwtToken, query = {}, headers}) {
     return client({
       url: "/custom-fields",
       params: query,
-      headers: authorizationHeaders({token, internalAuthTokenProvider, headers})
+      headers: authorizationHeaders({token, jwtToken, internalAuthTokenProvider, headers})
     });
   }
 
   /**
-   * GET /custom-fields/:fieldId - get custom field by id. API does not accept query params.
+   * GET /custom-fields/:customfieldId - get custom field by id (btrz-api-inventory). No query params.
    * @param {Object} opts
    * @param {string} [opts.token] - API key
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol
-   * @param {string} opts.fieldId - Field id
+   * @param {string} opts.fieldId - Custom field id (24 hex chars; must start with accountId)
    * @param {Object} [opts.headers] - Optional headers
-   * @returns {Promise<import("axios").AxiosResponse>}
+   * @returns {Promise<import("axios").AxiosResponse<{ customfield: Object }>>}
+   * @throws When response is 4xx/5xx (400, 401, 404 CUSTOMFIELD_NOT_FOUND, 500)
    */
   function get({fieldId, token, jwtToken, query = {}, headers}) {
     return client({
@@ -51,13 +53,14 @@ function customFieldsFactory({client, internalAuthTokenProvider}) {
   }
 
   /**
-   * POST /custom-fields - create custom field. API does not accept query params.
+   * POST /custom-fields - create custom field (btrz-api-inventory). No query params.
    * @param {Object} opts
    * @param {string} [opts.token] - API key
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol
-   * @param {Object} opts.field - Field payload
+   * @param {Object} opts.field - Field payload (FieldPutData: text, type, required, disabled, options when type List)
    * @param {Object} [opts.headers] - Optional headers
-   * @returns {Promise<import("axios").AxiosResponse>}
+   * @returns {Promise<import("axios").AxiosResponse<{ customfield: Object }>>}
+   * @throws When response is 4xx/5xx (400, 401, 404 CUSTOMFIELD_NOT_FOUND/FIELD_NOT_FOUND, 500)
    */
   function create({token, jwtToken, field, headers}) {
     return client({
@@ -69,14 +72,15 @@ function customFieldsFactory({client, internalAuthTokenProvider}) {
   }
 
   /**
-   * PUT /custom-fields/:fieldId - update custom field. API does not accept query params.
+   * PUT /custom-fields/:fieldId - update custom field (btrz-api-inventory). No query params.
    * @param {Object} opts
    * @param {string} [opts.token] - API key
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol
-   * @param {string} opts.fieldId - Field id
-   * @param {Object} opts.field - Field payload
+   * @param {string} opts.fieldId - Field id (24 hex chars)
+   * @param {Object} opts.field - Field payload (FieldPutData)
    * @param {Object} [opts.headers] - Optional headers
-   * @returns {Promise<import("axios").AxiosResponse>}
+   * @returns {Promise<import("axios").AxiosResponse<{ customfield: Object }>>}
+   * @throws When response is 4xx/5xx (400, 401, 404 CUSTOMFIELD_NOT_FOUND/FIELD_NOT_FOUND/WRONG_DATA_OPTIONS, 500)
    */
   function update({token, jwtToken, fieldId, field, headers}) {
     return client({
@@ -90,16 +94,18 @@ function customFieldsFactory({client, internalAuthTokenProvider}) {
   /** @type {{ all: function }} */
   const types = {
     /**
-     * GET /custom-fields/types - list custom field types. API does not accept query params.
+     * GET /custom-fields/types - list custom field types (btrz-api-inventory). No query params.
      * @param {Object} opts
      * @param {string} [opts.token] - API key
+     * @param {string} [opts.jwtToken] - JWT or internal auth symbol
      * @param {Object} [opts.headers] - Optional headers
-     * @returns {Promise<import("axios").AxiosResponse>}
+     * @returns {Promise<import("axios").AxiosResponse<{ types: Array }>>}
+     * @throws When response is 4xx/5xx (e.g. 401 Unauthorized, 500)
      */
-    all({token, headers}) {
+    all({token, jwtToken, headers}) {
       return client({
         url: "/custom-fields/types",
-        headers: authorizationHeaders({token, internalAuthTokenProvider, headers})
+        headers: authorizationHeaders({token, jwtToken, internalAuthTokenProvider, headers})
       });
     }
   };

package/src/endpoints/inventory/document-types.js

@@ -1,7 +1,7 @@
 const {authorizationHeaders} = require("./../endpoints_helpers.js");
 
 /**
- * Query params for GET /document-types (btrz-api-inventory). See get-document-types getSpec().
+ * Query params for GET /document-types (btrz-api-inventory).
  * @typedef {Object} DocumentTypesListQuery
  * @property {string} [providerIds] - Comma-separated provider IDs to get document types for
  */
@@ -15,99 +15,100 @@ const {authorizationHeaders} = require("./../endpoints_helpers.js");
  */
 function documentTypesFactory({client, internalAuthTokenProvider}) {
   /**
-   * GET /document-types - list document types.
+   * GET /document-types - list document types (paginated).
    * @param {Object} opts
    * @param {string} [opts.token] - API key
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol
-   * @param {DocumentTypesListQuery} [opts.query] - Query params (providerIds); opts.providerId merged into query if set
-   * @param {string} [opts.providerId] - Provider id (added to query if set)
+   * @param {DocumentTypesListQuery} [opts.query] - Query params (providerIds)
    * @param {Object} [opts.headers] - Optional headers
-   * @returns {Promise<import("axios").AxiosResponse>}
+   * @returns {Promise<import("axios").AxiosResponse<{ documenttypes: Array, next?: string, previous?: string, count: number }>>}
+   * @throws When response is 4xx/5xx (401 Unauthorized, 500)
    */
-  function all({token, jwtToken, query = {}, headers, providerId}) {
-    const query_ = providerId ? {...query, providerId} : query;
+  function all({token, jwtToken, query = {}, headers}) {
     return client({
       url: "/document-types",
       method: "get",
       headers: authorizationHeaders({token, jwtToken, internalAuthTokenProvider, headers}),
-      params: query_
+      params: query
     });
   }
 
   /**
-   * GET /document-types/:id - get document type by id. API does not accept query params.
+   * GET /document-types/:documenttypeId - get document type by id.
    * @param {Object} opts
    * @param {string} [opts.token] - API key
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol
-   * @param {string} opts.id - Document type id
-   * @param {string} [opts.providerId] - Provider id (added to query if set)
+   * @param {string} opts.id - Document type id (24 hex characters)
    * @param {Object} [opts.headers] - Optional headers
-   * @returns {Promise<import("axios").AxiosResponse>}
+   * @returns {Promise<import("axios").AxiosResponse<{ documenttype: Object }>>}
+   * @throws When response is 4xx/5xx (400, 401, 404 DOCUMENTTYPE_NOT_FOUND, 500)
    */
-  function get({token, jwtToken, id, query = {}, headers, providerId}) {
-    const query_ = providerId ? {...query, providerId} : query;
+  function get({token, jwtToken, id, headers}) {
     return client({
       url: `/document-types/${id}`,
       method: "get",
-      headers: authorizationHeaders({token, jwtToken, internalAuthTokenProvider, headers}),
-      params: query_
+      headers: authorizationHeaders({token, jwtToken, internalAuthTokenProvider, headers})
     });
   }
 
   /**
-   * PUT /document-types/:id - update document type. API does not accept query params.
+   * PUT /document-types/:documenttypeId - update document type.
    * @param {Object} opts
    * @param {string} [opts.token] - API key
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol
    * @param {string} opts.id - Document type id
-   * @param {Object} opts.data - Document type payload
+   * @param {Object} [opts.documenttype] - Document type payload (DocumentTypePutData)
+   * @param {Object} [opts.data] - Alias for documenttype (deprecated, use documenttype)
    * @param {Object} [opts.headers] - Optional headers
-   * @returns {Promise<import("axios").AxiosResponse>}
+   * @returns {Promise<import("axios").AxiosResponse<{ documenttype: Object }>>}
+   * @throws When response is 4xx/5xx (400, 401, 404, 409 CANNOT_UPDATE_LEXICON_ENTRIES, 500)
    */
-  function update({token, jwtToken, id, data, query = {}, headers}) {
+  function update({token, jwtToken, id, documenttype, data, headers}) {
+    const payload = documenttype || data;
     return client({
       url: `/document-types/${id}`,
       method: "put",
       headers: authorizationHeaders({token, jwtToken, internalAuthTokenProvider, headers}),
-      params: query,
-      data
+      data: {documenttype: payload}
     });
   }
 
   /**
-   * DELETE /document-types/:id - remove document type. API does not accept query params.
+   * DELETE /document-types/:documenttypeId - remove document type.
    * @param {Object} opts
    * @param {string} [opts.token] - API key
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol
    * @param {string} opts.id - Document type id
    * @param {Object} [opts.headers] - Optional headers
-   * @returns {Promise<import("axios").AxiosResponse>}
+   * @returns {Promise<import("axios").AxiosResponse<{ documenttypeId: string }>>}
+   * @throws When response is 4xx/5xx (400, 401, 404 DOCUMENTTYPE_NOT_FOUND, 500)
    */
-  function remove({token, jwtToken, id, query = {}, headers}) {
+  function remove({token, jwtToken, id, headers}) {
     return client({
       url: `/document-types/${id}`,
       method: "delete",
-      headers: authorizationHeaders({token, jwtToken, internalAuthTokenProvider, headers}),
-      params: query
+      headers: authorizationHeaders({token, jwtToken, internalAuthTokenProvider, headers})
     });
   }
 
   /**
-   * POST /document-types - create document type. API does not accept query params.
+   * POST /document-types - create document type.
    * @param {Object} opts
    * @param {string} [opts.token] - API key
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol
-   * @param {Object} opts.data - Document type payload
+   * @param {Object} [opts.documenttype] - Document type payload (DocumentTypePostData)
+   * @param {Object} [opts.data] - Alias for documenttype (deprecated, use documenttype)
    * @param {Object} [opts.headers] - Optional headers
-   * @returns {Promise<import("axios").AxiosResponse>}
+   * @returns {Promise<import("axios").AxiosResponse<{ documenttype: Object }>>}
+   * @throws When response is 4xx/5xx (400, 401, 409 CANNOT_CREATE_LEXICON_ENTRIES, 500)
    */
-  function create({token, jwtToken, data, query = {}, headers}) {
+  function create({token, jwtToken, documenttype, data, headers}) {
+    const payload = documenttype || data;
     return client({
       url: "/document-types",
       method: "post",
       headers: authorizationHeaders({token, jwtToken, internalAuthTokenProvider, headers}),
-      params: query,
-      data
+      data: {documenttype: payload}
     });
   }
 

package/src/endpoints/inventory/external-wallets.js

@@ -3,22 +3,24 @@ const {
 } = require("../endpoints_helpers.js");
 
 /**
- * Factory for external-wallets API (btrz-api-inventory).
+ * Factory for external-wallets API (btrz-api-inventory). SaldoMax external wallets only.
  * @param {Object} deps
  * @param {import("axios").AxiosInstance} deps.client
  * @param {{ getToken: function(): string }} [deps.internalAuthTokenProvider]
- * @returns {{ saldoMax: object }}
+ * @returns {{ saldoMax: { all: function, get: function, create: function, update: function, movements: { create: function } } }}
  */
 function externalWalletsFactory({client, internalAuthTokenProvider}) {
   /** @type {{ all: function, create: function, get: function, update: function, movements: object }} */
   const saldoMax = {
     /**
-     * GET /external-wallets/saldo-max - list saldo max wallets. API does not accept query params.
+     * GET /external-wallets/saldo-max - list SaldoMax external wallets (paginated).
      * @param {Object} opts
      * @param {string} [opts.token] - API key
      * @param {string} [opts.jwtToken] - JWT or internal auth symbol
+     * @param {Object} [opts.query] - Pagination query params
      * @param {Object} [opts.headers] - Optional headers
-     * @returns {Promise<import("axios").AxiosResponse>}
+     * @returns {Promise<import("axios").AxiosResponse<{ externalWallets: Array, next?: string, previous?: string, count: number }>>}
+     * @throws When response is 4xx/5xx (401, 500)
      */
     all: ({token, jwtToken, query = {}, headers}) => {
       return client.get("/external-wallets/saldo-max", {
@@ -27,13 +29,14 @@ function externalWalletsFactory({client, internalAuthTokenProvider}) {
       });
     },
     /**
-     * POST /external-wallets/saldo-max - create saldo max wallet. API does not accept query params.
+     * POST /external-wallets/saldo-max - create SaldoMax external wallet.
      * @param {Object} opts
      * @param {string} [opts.token] - API key
      * @param {string} [opts.jwtToken] - JWT or internal auth symbol
-     * @param {Object} opts.externalWallet - External wallet payload
+     * @param {Object} opts.externalWallet - External wallet payload (ExternalWalletData: firstName, lastName, email, tel, dob, nip)
      * @param {Object} [opts.headers] - Optional headers
-     * @returns {Promise<import("axios").AxiosResponse>}
+     * @returns {Promise<import("axios").AxiosResponse<{ externalWallet: Object }>>}
+     * @throws When response is 4xx/5xx (400, 401, 409 DUPLICATE_EXTERNAL_WALLET_EMAIL/TEL, 500)
      */
     create: ({token, jwtToken, externalWallet, headers}) => {
       return client({
@@ -44,13 +47,14 @@ function externalWalletsFactory({client, internalAuthTokenProvider}) {
       });
     },
     /**
-     * GET /external-wallets/saldo-max/:walletId - get saldo max wallet. API does not accept query params.
+     * GET /external-wallets/saldo-max/:walletId - get SaldoMax external wallet by id.
      * @param {Object} opts
      * @param {string} [opts.token] - API key
      * @param {string} [opts.jwtToken] - JWT or internal auth symbol
-     * @param {string} opts.walletId - Wallet id
+     * @param {string} opts.walletId - Wallet id (24 hex characters)
      * @param {Object} [opts.headers] - Optional headers
-     * @returns {Promise<import("axios").AxiosResponse>}
+     * @returns {Promise<import("axios").AxiosResponse<{ externalWallet: Object }>>}
+     * @throws When response is 4xx/5xx (400, 401, 404 EXTERNAL_WALLET_NOT_FOUND, 500)
      */
     get: ({token, jwtToken, walletId, headers}) => {
       return client.get(`/external-wallets/saldo-max/${walletId}`, {
@@ -58,13 +62,14 @@ function externalWalletsFactory({client, internalAuthTokenProvider}) {
       });
     },
     /**
-     * PUT /external-wallets/saldo-max/:externalWallet._id - update saldo max wallet. API does not accept query params.
+     * PUT /external-wallets/saldo-max/:walletId - update SaldoMax external wallet.
      * @param {Object} opts
      * @param {string} [opts.token] - API key
      * @param {string} [opts.jwtToken] - JWT or internal auth symbol
      * @param {Object} opts.externalWallet - External wallet payload (must include _id)
      * @param {Object} [opts.headers] - Optional headers
-     * @returns {Promise<import("axios").AxiosResponse>}
+     * @returns {Promise<import("axios").AxiosResponse<{ externalWallet: Object }>>}
+     * @throws When response is 4xx/5xx (400, 401, 404 EXTERNAL_WALLET_NOT_FOUND, 500)
      */
     update: ({token, jwtToken, externalWallet, headers}) => {
       const externalWalletFieldsToUpdate = {
@@ -85,22 +90,22 @@ function externalWalletsFactory({client, internalAuthTokenProvider}) {
     /** @type {{ create: function }} */
     movements: {
       /**
-       * PUT /external-wallets/saldo-max/:walletId/movements - create movement. API does not accept query params.
+       * PUT /external-wallets/saldo-max/:walletId/movements - add movement to wallet.
        * @param {Object} opts
        * @param {string} [opts.token] - API key
        * @param {string} [opts.jwtToken] - JWT or internal auth symbol
        * @param {string} opts.walletId - Wallet id
-       * @param {Object} opts.movement - Movement payload
-       * @returns {Promise<import("axios").AxiosResponse>}
+       * @param {Object} opts.movement - Movement payload (amount, type: payment|refund|manual, reason, nip)
+       * @param {Object} [opts.headers] - Optional headers
+       * @returns {Promise<import("axios").AxiosResponse<{ externalWallet: Object }>>}
+       * @throws When response is 4xx/5xx (400, 401, 403 INVALID_NIP/WALLET_BLOCKED/WALLET_NOT_ACTIVE, 404, 500)
        */
-      create: ({token, jwtToken, walletId, movement}) => {
+      create: ({token, jwtToken, walletId, movement, headers}) => {
         return client({
           url: `/external-wallets/saldo-max/${walletId}/movements`,
           method: "put",
-          headers: authorizationHeaders({token, jwtToken, internalAuthTokenProvider}),
-          data: {
-            movement
-          }
+          headers: authorizationHeaders({token, jwtToken, internalAuthTokenProvider, headers}),
+          data: {movement}
         });
       }
     }

package/src/endpoints/inventory/fees.js

@@ -3,10 +3,11 @@ const {authorizationHeaders} = require("./../endpoints_helpers.js");
 /**
  * Query params for GET /fees (btrz-api-inventory). See fees get-handler getSpec().
  * @typedef {Object} InventoryFeesQuery
- * @property {string} [providerIds] - Provider IDs to get fees for
- * @property {string} [rules] - Rules where the fees apply
- * @property {string} [productId] - Product ID for the fee
- * @property {string} [internalId] - Fee internal id
+ * @property {string} [providerIds] - Comma-separated provider (account) IDs to get fees for
+ * @property {string} [rules] - Comma-separated rules where the fees apply (e.g. cancel, ticket, transaction)
+ * @property {string} [productId] - Product ID to filter fees by
+ * @property {string} [internalId] - Fee internal id to filter by
+ * @property {string} [page] - Page number for pagination (1-based). Response includes next, previous, count
  */
 
 /**
@@ -18,28 +19,31 @@ const {authorizationHeaders} = require("./../endpoints_helpers.js");
  */
 function feesFactory({client, internalAuthTokenProvider}) {
   /**
-   * GET /fees - list fees.
+   * GET /fees - list fees (paginated).
    * @param {Object} opts
    * @param {string} [opts.token] - API key
-   * @param {InventoryFeesQuery} [opts.query] - Optional query params (forwarded to API)
+   * @param {string} [opts.jwtToken] - JWT or internal auth symbol
+   * @param {InventoryFeesQuery} [opts.query] - Query params (providerIds, rules, productId, internalId)
    * @param {Object} [opts.headers] - Optional headers
-   * @returns {Promise<import("axios").AxiosResponse>}
+   * @returns {Promise<import("axios").AxiosResponse<{ fees: Array, next: string, previous: string, count: number }>>}
+   * @throws When response is 4xx/5xx (401, 500)
    */
-  function all({token, query = {}, headers}) {
+  function all({token, jwtToken, query = {}, headers}) {
     return client.get("/fees", {
       params: query,
-      headers: authorizationHeaders({token, internalAuthTokenProvider, headers})
+      headers: authorizationHeaders({token, jwtToken, internalAuthTokenProvider, headers})
     });
   }
 
   /**
-   * GET /fees/:feeId - get fee by id. API does not accept query params.
+   * GET /fees/:feeId - get fee by id.
    * @param {Object} opts
    * @param {string} [opts.token] - API key
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol
-   * @param {string} opts.feeId - Fee id
+   * @param {string} opts.feeId - Fee id (24 hex characters)
    * @param {Object} [opts.headers] - Optional headers
-   * @returns {Promise<import("axios").AxiosResponse>}
+   * @returns {Promise<import("axios").AxiosResponse<{ fee: Object }>>}
+   * @throws When response is 4xx/5xx (400, 401, 404 FEE_NOT_FOUND, 500)
    */
   function get({token, jwtToken, feeId, headers}) {
     return client.get(`/fees/${feeId}`, {
@@ -48,13 +52,14 @@ function feesFactory({client, internalAuthTokenProvider}) {
   }
 
   /**
-   * POST /fees - create fee. API does not accept query params.
+   * POST /fees - create fee.
    * @param {Object} opts
    * @param {string} [opts.token] - API key
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol
-   * @param {Object} opts.fee - Fee payload
+   * @param {Object} opts.fee - Fee payload (FeePostData: name, internalId, valueType, value, rules, products, lexiconKeys, etc.)
    * @param {Object} [opts.headers] - Optional headers
-   * @returns {Promise<import("axios").AxiosResponse>}
+   * @returns {Promise<import("axios").AxiosResponse<{ fee: Object }>>}
+   * @throws When response is 4xx/5xx (400, 401, 409 CANNOT_CREATE_LEXICON_ENTRIES, 500)
    */
   function create({token, jwtToken, fee, headers}) {
     return client({
@@ -66,14 +71,15 @@ function feesFactory({client, internalAuthTokenProvider}) {
   }
 
   /**
-   * PUT /fees/:feeId - update fee. API does not accept query params.
+   * PUT /fees/:feeId - update fee.
    * @param {Object} opts
    * @param {string} [opts.token] - API key
    * @param {string} [opts.jwtToken] - JWT or internal auth symbol
    * @param {string} opts.feeId - Fee id
-   * @param {Object} opts.fee - Fee payload
+   * @param {Object} opts.fee - Fee payload (partial FeePostData)
    * @param {Object} [opts.headers] - Optional headers
-   * @returns {Promise<import("axios").AxiosResponse>}
+   * @returns {Promise<import("axios").AxiosResponse<{ fee: Object }>>}
+   * @throws When response is 4xx/5xx (400, 401, 404 FEE_NOT_FOUND, 409 CANNOT_UPDATE_LEXICON_ENTRIES, 500)
    */
   function update({token, jwtToken, feeId, fee, headers}) {
     return client({