npm - refacil-commerce-mcp - Versions diffs - 1.0.7 → 1.0.9 - Mend

refacil-commerce-mcp 1.0.7 → 1.0.9

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (9) hide show

package/README.md +819 -2572
package/dist/core/resources.js +73 -332
package/dist/core/resources.js.map +1 -1
package/dist/core/tools.d.ts +6 -44
package/dist/core/tools.js +394 -3080
package/dist/core/tools.js.map +1 -1
package/dist/index.js +10 -3
package/dist/index.js.map +1 -1
package/package.json +1 -1

package/README.md CHANGED Viewed

@@ -4,7 +4,7 @@ Servidor MCP (Model Context Protocol) generado automáticamente para la API refa
 ## 🚀 Características
-- **70 herramientas** generadas automáticamente desde la colección Postman
+- **32 herramientas** generadas automáticamente desde la colección Postman
 - **Autenticación flexible**: Username/SecretKey con renovación automática de tokens
 - **Servidor HTTP** con Fastify
 - **Protocolo MCP** estándar para integración con IDEs
@@ -192,93 +192,6 @@ kubectl get pods -l app=refacil-commerce-mcp
 ## 🛠️ Herramientas Disponibles
-### `admin_update_balance`
----
-### Description
-It allows you to transfer funds from the main users money bag to the bag of the user who is being added. The token of the user who will be the beneficiary and the amount must be added.
----
-### Request Body
-- userToken (string, required): The user token for which the balance will be updated
-- amount (number, required): Amount to be updated
----
-### Response
-- `message`: String containing a message about the operation result (required)
-- `messageCode`: String code indicating the operation result (required)
-- `data`: Object containing additional response data.
-**Parámetros:**
-| Name | Type | Description |
-| --- | --- | --- |
-| userToken | string | Campo del body: userToken |
-| amount | number | Campo del body: amount |
-### `admin_locations_states`
----
-### Description
-Get all states, then you can search cities by state id in the /locations/cities/{stateId} service
----
-### Request Body
-This endpoint does not require a request body.
----
-### Response
-- `message`: String containing a message about the operation result (required)
-- `messageCode`: String code indicating the operation result (required)
-- `data`: Object containing additional response data (required)
-    - `items`: Array of objects containing the states
-### `admin_locations_cities`
----
-### Description
-Get all cities by state id
----
-### Parameters Path
-- stateId (number, required): State Id
----
-### Response
-- `message`: String containing a message about the operation result (required)
-- `messageCode`: String code indicating the operation result (required)
-- `data`: Object containing additional response data (required)
-    - `items`: Array of objects containing the cities by state id
 ### `auth_login_api`
 ---
@@ -289,1630 +202,152 @@ Get all cities by state id
 ### Description
-Allows API users to log in using their credentials. This operation authenticates the API user using the information provided in the request body. If the credentials are valid, an access token is issued, which must be included in subsequent requests to access protected resources on the platform. Make sure to include the token in the authorization header using the "Bearer" prefix in future requests. The response will include the token type ("Bearer") and the access token.
----
-### Request Body
-- `username` (string) `required`\- Username for authentication.
-- `secretKey` (string) `required`\- Secret key for authentication
-- `saveSession` (boolean) - Flag that, if sent as `false`, allows the generated token to have an expiration of 12 hours.
----
-### Response
-- `messageCode` (string) - Code for the message.
-- `message` (string) - The message from the response.
-- `data`
-    - `tokenType` (string) - Type of the token (e.g., "Bearer").
-    - `token` (string) - The access code. It will not expire, unless the `saveSession` field is sent with the value `false`.
-**Parámetros:**
-| Name | Type | Description |
-| --- | --- | --- |
-| username | string | Campo del body: username |
-| secretKey | string | Campo del body: secretKey |
-### `commerce_register`
----
-### Register Commerce
----
-#### Description
-Registers a new commerce in the system using the information provided in the request body. This method returns a response that includes the unique identifier of the user associated with the commerce.
----
-#### Request Body
-- `name` (string) `required`: Owner's name of the commerce.
-- `lastname` (string) `required`: Owner's last name of the commerce
-- `docType` (string)`required`: Document type of the commerce owner.
-- `docNumber` (string)`required`: Document number of the commerce owner.
-- expeditionDate (string): Expedition date of the document of the commerce owner. The date must have the following structure YYYY-MM-DD
-- `username` (string)`required`: Username of the commerce owner.
-- `cellphone` (string)`required`: Commerce owner's mobile phone number. Please enter a valid mobile phone number for Colombia. It must contain 10 digits and start with the prefix '3'.
-- `email` (string)`required`: Commerce owner's email.
-- `commerceType` (number): Identifier of the commerce type. To get valid values, consult the /base-info/commerce-types service. Make sure to provide a valid number for this field. This field is optional, and if not provided, it will default to "1," which corresponds to the "Store" commerce type.
-- `commerceName` (string)`required`: The name of the commerce.
-- latitude (number): Latitude of the commerce location.
-- longitude (number): Longitude of the commerce location.
-- `address` (string)`required`: Commerce address. Since the field is of type string, the address can be provided in any standard format.
-- `cityName` (string)`required`: City name where the commerce is located. It is recommended to enter only valid city names. If no matches are found, 'Bogota' will be used as the default city.
----
-#### Response Body
-- `message` (string): A message related to the response.
-- `messageCode` (string): A code associated with the message.
-- `data` (object): An object containing the following fields:
-    - `tokenType` (string): The type of token.
-    - `token` (string): The token for authentication. It will not expire.
-    - `userId` (number): The unique identifier of the user associated with the commerce.
-    - `message` (string): A message related to the response.
-**Parámetros:**
-| Name | Type | Description |
-| --- | --- | --- |
-| name | string | Campo del body: name |
-| lastname | string | Campo del body: lastname |
-| docType | string | Campo del body: docType |
-| docNumber | string | Campo del body: docNumber |
-| username | string | Campo del body: username |
-| cellphone | string | Campo del body: cellphone |
-| email | string | Campo del body: email |
-| commerceType | number | Campo del body: commerceType |
-| commerceName | string | Campo del body: commerceName |
-| address | string | Campo del body: address |
-| cityName | string | Campo del body: cityName |
-| balance | string | Campo del body: balance |
+Allows API users to log in using their credentials. This operation authenticates the user with the information provided in the request body. If the credentials are valid, an access token is issued, which must be included in subsequent requests to access protected resources on the platform. The token must be sent in the `Authorization` header using the `Bearer` prefix. The response includes the token type (`Bearer`) and the access token.
-### `commerce_get_info`
+### Rate limiting
----
+To prevent abuse and repeated attempts in a short period, this endpoint applies rate limiting:
-### Description
+- **Per IP**: maximum **5 requests per minute** from the same IP address.
+- **Per user**: maximum **5 requests every 5 minutes** for the same user.
+- **Combined user + IP**: maximum **5 requests per minute** for the same user–IP combination.
-Retrieve detailed information about a commerce using its identification. This operation requires sending an object in the request body with the "userId" property specifying the user ID. The response will include information about balances, additional data, and more. Balances include: "tmpBalance" (Earnings Bag), "posBalance" (Multiproduct Bag), and "debt" (Debt Bag).
+If these limits are exceeded, the API will temporarily reject additional calls, effectively asking the client to **wait a moment before trying again**.
 ---
 ### Request Body
-- userId (number, required): The user ID for which detailed information is to be retrieved.
----
-### Response
-- `message`: String containing a message about the operation result (required)
+- `username` (string) `required` - Username for authentication.
-- `messageCode`: String code indicating the operation result (required)
+- `secretKey` (string) `required` - Secret key for authentication
-- `data`: Object containing additional response data (required)
+- `saveSession` (boolean) - Flag that, if sent as `false`, allows the generated token to have an expiration of 12 hours.
-    - `additionalData`: Object containing user-related data (required)
-        - `username`: String representing the username (required)
-        - `token`: String representing the token. It will not expire. (required)
-    - `balances`: Object containing balance-related data (required)
-        - `tmpBalance`: Number representing the temporary balance (required)
-        - `posBalance`: Number representing the balance after the operation (required)
-            debt: Number representing the debt amount (required)
-**Parámetros:**
-| Name | Type | Description |
-| --- | --- | --- |
-| userId | number | Campo del body: userId |
-### `commerce_users`
----
-### Description
-Retrieve a list of users associated with a commerce using the token provided in the request header. This method supports pagination and search by name or user id.
----
-### Request Body
-This endpoint does not require a request body.
 ---
 ### Response
-- `message`: String containing a message about the operation result (required)
-- `messageCode`: String code indicating the operation result (required)
-- `data`: Object containing additional response data (required)
-    - `items`: Array of objects containing the users associated with the commerce
-### `commerce_updatebalance`
----
-### Update Commerce Balance
----
-#### Description
-**UpdateBalance:**
-This service allows loading balance to the different merchants created, by deducting from the Parent Merchant’s balance pool. The transactions generated will be reflected in the reports assigned to the merchant within the portal provided by Super Pagos.
-The required sending parameters are the token and ID, which were returned when the merchant was created.
----
-#### Request Body Schema
-- `token` (string)`required`: Owner's balance of the commerce.
-- `balance` (number)`required`: Owner's balance of the commerce.
----
-#### Response Body Schema
-- `message` (string): A message related to the response.
-- `messageCode` (string): A code associated with the message.
-**Parámetros:**
-| Name | Type | Description |
-| --- | --- | --- |
-| token | string | Campo del body: token |
-| balance | number | Campo del body: balance |
-### `base_info_commerce_types`
----
-### Retrieve Commerce Types
----
-#### Description
-Retrieve the available commerce types in the application. This operation provides detailed information about the different types of commercial establishments that can operate on the platform.
----
-#### Request Body
-This endpoint does not require a request body.
----
-#### Response Body
-- `message` (string): A message indicating the status of the response.
-- `messageCode` (string): A code associated with the message.
-- `data` (array): An array containing the commerce types information.
-    - `id` (number): The unique identifier for the commerce type.
-    - `name` (string): The name of the commerce type.
-### `report_details`
----
-### Retrieve Commerce Report Details
----
-#### Description
-Get details to build a report. This service is responsible for returning the necessary details to generate a report. To provide more context about the service, it will return an array of objects. Each object in this array will contain attributes that are essential for the construction of a report. These attributes may include, but are not limited to, type of report, the bag to consult, options to load in a select and other relevant data that are needed for a complete and detailed report. The use of this method will facilitate the generation of reports by providing all the necessary data in a structured and easy-to-use way.
----
-#### Request Body
-- No request body is required for this GET request.
+- `messageCode` (string) - Code for the message.
+- `message` (string) - The message from the response.
+- `data`
+    - `tokenType` (string) - Type of the token (e.g., "Bearer").
+    - `token` (string) - The access code. It will not expire, unless the `saveSession` field is sent with the value `false`.
----
-#### Response Body
-- `description` (string, optional): Description of the commerce report.
-- `form` (object):
-    - `fields` (array):
-        - `name` (string): Name of the field.
-        - `type` (string): Type of the field.
-        - `options` (array):
-            - `label` (string): Label for the option.
-            - `value` (null): Value of the option.
-        - `label` (string): Label for the field.
-        - `placeholder` (string): Placeholder for the field.
-        - `required` (boolean): Indicates if the field is required.
-    - `bag` (string): Bag information.
-    - `typeReport` (string): Type of the report.
-- `endpoint` (string): The endpoint for the commerce report generate.
-### `report_generate`
----
-### Sales report
----
-#### Description
-This service is responsible for generating different types of reports depending on the filters that are sent.
-#### Request Body
-- `filters` (object, `required`): Filters for the report
-    - `dateStart` (string, `required`)
-    - `dateEnd` (string, `required`)
-    - `carrierId` (null, optional)
-    - `number` (string, optional)
-    - `status` (string, optional)
-    - `bag` (string, optional)
-- `typeReport` (string, required): Type of the report
----
-#### Response
-- `messageCode` (string)
-- `message` (string)
-- `data` (object)
-    - `title` (string)
-    - `header` (array of strings)
-    - `data` (array of arrays)
-**Parámetros:**
-| Name | Type | Description |
-| --- | --- | --- |
-| filters | object | Campo del body: filters |
-| typeReport | string | Campo del body: typeReport |
-### `generate_purchase_report`
----
-# Purchase report
----
-### Description
-This service is responsible for generating different types of reports depending on the filters that are sent.
----
-## Request Body
-- `filters` (object, `required`): Filters for the report
-    - `dateStart` (string, `required`): Start date for the report.
-    - `dateEnd` (string, `required`): End date for the report.
-    - `carrierId` (string, optional): ID of the carrier.
-    - `number` (string, optional): Commerce number.
-    - `status` (string, optional): Status of the commerce.
-    - `bag` (string, optional): Bag information.
-- `typeReport` (string, `required`): Type of the report.
----
-## Response
-- `messageCode` (string): Code for the message.
-- `message` (string): Details of the message.
-- `data` (object)
-    - `title` (string): Title of the report.
-    - `header` (array of strings): Headers for the report data.
-    - `total` (number): Total count of the report data.
-    - `data` (array of arrays): Report data.
-**Parámetros:**
-| Name | Type | Description |
-| --- | --- | --- |
-| filters | object | Campo del body: filters |
-| typeReport | string | Campo del body: typeReport |
-### `generate_statement_report`
----
-### Statement report
----
-#### Description
-This endpoint allows you to generate a report with the specified filters and report type.
----
-#### Request Body
-- Type: JSON
----
-#### Response
-- Type: JSON
-| Property | Type | Description |
-| --- | --- | --- |
-| messageCode | string | A code associated with the response message. |
-| message | string | A human-readable message providing information about the response. |
-| data | object | An object containing report title, header, and totals. |
-| title | string | The title of the report. |
-| header | array | An array containing report headers. |
-| totals | object | An object containing various total amounts for the report. |
-| data | array | An array containing report data. |
-**Note**: The actual data in the response may vary based on the report generated.
-**Parámetros:**
-| Name | Type | Description |
-| --- | --- | --- |
-| filters | object | Campo del body: filters |
-| typeReport | string | Campo del body: typeReport |
-### `generate_payment_report`
----
-### Payment report
----
-#### Description
-This service is responsible for generating different types of reports depending on the filters that are sent.
----
-#### Request Body
-- Type: JSON
-#### Response
-- Type: JSON
-**Parámetros:**
-| Name | Type | Description |
-| --- | --- | --- |
-| filters | object | Campo del body: filters |
-| typeReport | string | Campo del body: typeReport |
-### `generate_transfer_report`
----
-# Transfer report
----
-## Description
-This endpoint allows you to generate a report based on the specified filters.
----
-## Request Body
-- `filters` (object, required): An object containing the filters for the report.
-    - `dateStart` (string, required): The start date for the report.
-    - `dateEnd` (string, required): The end date for the report.
-    - `carrierId` (null): The ID of the carrier for the report.
-    - `number` (string): The report number.
-    - `status` (string): The status for the report.
-    - `bag` (string): The bag for the report.
-- `typeReport` (string, required): The type of report to be generated.
----
-## Response
-- `messageCode` (string): The code for the message.
-- `message` (string): The message related to the response.
-- `data` (object): An object containing the report data.
-    - `title` (string): The title of the report.
-    - `header` (array): An array containing the headers for the report data.
-    - `data` (array): An array containing the report data.
-**Parámetros:**
-| Name | Type | Description |
-| --- | --- | --- |
-| filters | object | Campo del body: filters |
-| typeReport | string | Campo del body: typeReport |
-### `generate_reverse_report`
----
-# Reverse report
----
-## Description
-This endpoint allows you to generate a report based on the specified filters.
----
-## Request Body
-- `filters` (object, required): An object containing the filters for the report.
-    - `dateStart` (string, required): The start date for the report.
-    - `dateEnd` (string, required): The end date for the report.
-    - `carrierId` (null): The ID of the carrier for the report.
-    - `number` (string): The report number.
-    - `status` (string): The status for the report.
-    - `bag` (string): The bag for the report.
-- `typeReport` (string, required): The type of report to be generated.
----
-## Response
-- `messageCode` (string): The code for the message.
-- `message` (string): The message related to the response.
-- `data` (object): An object containing the report data.
-    - `title` (string): The title of the report.
-    - `header` (array): An array containing the headers for the report data.
-    - `data` (array): An array containing the report data.
-**Parámetros:**
-| Name | Type | Description |
-| --- | --- | --- |
-| filters | object | Campo del body: filters |
-| typeReport | string | Campo del body: typeReport |
-### `generate_consumption_report`
----
-# Consumption report
----
-## Description
-This endpoint allows you to generate a report based on the specified filters.
----
-## Request Body
-- `filters` (object, required): An object containing the filters for the report.
-    - `dateStart` (string, required): The start date for the report.
-    - `dateEnd` (string, required): The end date for the report.
-    - `carrierId` (null): The ID of the carrier for the report.
-    - `number` (string): The report number.
-    - `status` (string): The status for the report.
-    - `bag` (string): The bag for the report.
-- `typeReport` (string, required): The type of report to be generated.
----
-## Response
-- `messageCode` (string): The code for the message.
-- `message` (string): The message related to the response.
-- `data` (object): An object containing the report data.
-    - `title` (string): The title of the report.
-    - `header` (array): An array containing the headers for the report data.
-    - `data` (array): An array containing the report data.
-**Parámetros:**
-| Name | Type | Description |
-| --- | --- | --- |
-| filters | object | Campo del body: filters |
-| typeReport | string | Campo del body: typeReport |
-### `payment_generate_resource`
----
-### Description
-Generates a payment resource in the system using the information provided in the request body. This method returns a response that includes details about the generated resource, such as the URL, reference, resource identifier, and expiration time.
----
-### Request Body
-- `productId` (number, `required`): Identifier of the product for which the resource will be generated.
-- `amount` (number, `required`): Amount of the resource to be generated.
-- `moduleId` (number, `required`): Identifier of the module to which the generated resource will be associated.
-- `form` (object): Optional form associated with the resource.
-    - `cellphone` (string): The cellphone number.
-- `customerReference` (string, `required`): A reference to the customer.
----
-### Response Body
-- `message` (string): A message related to the response.
-- `messageCode` (string): A code related to the message.
-- `data` (object): An object containing the response data.
-    - `message` (string): A message related to the response data.
-    - `date` (number): The date related to the response data.
-    - `payload` (object): An object containing the payload data.
-        - `url` (string): The URL of the generated resource.
-        - `reference` (string): The reference of the generated resource.
-        - `resourceId` (string): The identifier of the generated resource.
-        - `expiresIn` (string): The expiration time of the generated resource.
-        - `type` (string): The type of the generated resource.
-        - `data` (string): Additional data related to the generated resource.
-        - `status` (number): The status of the generated resource.
-**Parámetros:**
-| Name | Type | Description |
-| --- | --- | --- |
-| productId | number | Campo del body: productId |
-| amount | number | Campo del body: amount |
-| moduleId | number | Campo del body: moduleId |
-| form | object | Campo del body: form |
-| customerReference | string | Campo del body: customerReference |
-### `generate_resource_nequi`
----
-### Description
-Generates a payment resource in the system using the information provided in the request body. This method returns a response that includes details about the generated resource, such as the URL, reference, resource identifier, and expiration time.
----
-### Request Body
-- `productId` (number, `required`): Identifier of the product for which the resource will be generated.
-- `amount` (number, `required`): Amount of the resource to be generated.
-- `moduleId` (number, `required`): Identifier of the module to which the generated resource will be associated.
-- `form` (object): Optional form associated with the resource.
-    - `cellphone` (string): The cellphone number.
-- `customerReference` (string, `required`): A reference to the customer.
----
-### Response Body
-- `message` (string): A message related to the response.
-- `messageCode` (string): A code associated with the message.
-- `data` (object): An object containing data related to the response.
-    - `message` (string): A message related to the data.
-    - `date` (number): The date associated with the data.
-    - `payload` (object): An object containing the payload data.
-        - `url` (string): The URL of the generated resource.
-        - `reference` (string): The reference of the generated resource.
-        - `resourceId` (string): The identifier of the generated resource.
-        - `expiresIn` (string): The expiration time of the resource.
-        - `type` (string): The type of the resource.
-        - `data` (string): Additional data related to the resource.
-        - `status` (number): The status of the resource.
-**Parámetros:**
-| Name | Type | Description |
-| --- | --- | --- |
-| productId | number | Campo del body: productId |
-| amount | number | Campo del body: amount |
-| moduleId | number | Campo del body: moduleId |
-| form | object | Campo del body: form |
-| customerReference | string | Campo del body: customerReference |
-### `generate_resource_daviplata`
----
-### Description
-Generates a payment resource in the system using the information provided in the request body. This method returns a response that includes details about the generated resource, such as the URL, reference, resource identifier, and expiration time.
----
-### Request Body
-- `productId` (number, `required`): Identifier of the product for which the resource will be generated.
-- `amount` (number, `required`): Amount of the resource to be generated.
-- `moduleId` (number, `required`): Identifier of the module to which the generated resource will be associated.
-- `form` (object):
-    - `typePerson` (string): Type of person.
-    - `documentType` (string): Type of document.
-    - `documentNumber` (string): Document number.
-    - `name` (string): Name of the customer.
-    - `email` (string): Email of the customer.
-    - `cellphone` (string): Cellphone number of the customer.
-- `customerReference` (string, `required`): Reference related to the customer.
----
-### Response Body
-- `message` (string): A message related to the response.
-- `messageCode` (string): A code related to the message.
-- `data` (object):
-    - `message` (string): A message related to the data.
-    - `date` (number): Date related to the data.
-    - `payload` (object):
-        - `url` (string): The URL of the generated resource.
-        - `reference` (string): Reference of the resource.
-        - `resourceId` (string): Identifier of the resource.
-        - `expiresIn` (string): Expiration time of the resource.
-        - `type` (string): Type of the resource.
-        - `data` (string): Additional data related to the resource.
-        - `status` (number): Status of the resource.
-**Parámetros:**
-| Name | Type | Description |
-| --- | --- | --- |
-| productId | number | Campo del body: productId |
-| amount | number | Campo del body: amount |
-| moduleId | number | Campo del body: moduleId |
-| form | object | Campo del body: form |
-| customerReference | string | Campo del body: customerReference |
-### `generate_resource_bancolombia`
-### Generate Payment Resource
----
-#### Description
-Creates a payment resource in the system using the provided information.
----
-#### Request Body
-- `productId` (number, `required`): Identifier of the product for which the resource will be generated.
-- `amount` (number, `required`): Amount of the resource to be generated.
-- `moduleId` (number, `required`): Identifier of the module to which the generated resource will be associated.
-- `form` (object): Optional form associated with the resource.
-- `customerReference` (string): Customer reference information.
----
-#### Response Body
-- `message` (string): A message related to the response.
-- `messageCode` (string): A code related to the message.
-- `data` (object): The response data.
-    - `message` (string): A message related to the data.
-    - `date` (number): The date related to the data.
-    - `payload` (object): The payload data.
-        - `url` (string): The URL of the generated resource.
-        - `reference` (string): The reference of the resource.
-        - `resourceId` (string): The identifier of the resource.
-        - `expiresIn` (string): The expiration time of the resource.
-        - `type` (string): The type of the resource.
-        - `data` (string): Additional data related to the resource.
-        - `status` (number): The status of the resource.
-**Parámetros:**
-| Name | Type | Description |
-| --- | --- | --- |
-| productId | number | Campo del body: productId |
-| amount | number | Campo del body: amount |
-| moduleId | number | Campo del body: moduleId |
-| form | object | Campo del body: form |
-| customerReference | string | Campo del body: customerReference |
-### `generate_resource_nequi_22`
----
-### Description
-Generates a payment resource in the system using the information provided in the request body. This method returns a response that includes details about the generated resource, such as the URL, reference, resource identifier, and expiration time.
----
-### Request Body
-- `productId` (number, `required`): Identifier of the product for which the resource will be generated.
-- `amount` (number, `required`): Amount of the resource to be generated.
-- `moduleId` (number, `required`): Identifier of the module to which the generated resource will be associated.
-- `form` (object): Optional form associated with the resource.
-    - `cellphone` (string): The cellphone number.
-- `customerReference` (string, `required`): A reference to the customer.
----
-### Response Body
-- `message` (string): A message related to the response.
-- `messageCode` (string): A code associated with the message.
-- `data` (object): An object containing data related to the response.
-    - `message` (string): A message related to the data.
-    - `date` (number): The date associated with the data.
-    - `payload` (object): An object containing the payload data.
-        - `url` (string): The URL of the generated resource.
-        - `reference` (string): The reference of the generated resource.
-        - `resourceId` (string): The identifier of the generated resource.
-        - `expiresIn` (string): The expiration time of the resource.
-        - `type` (string): The type of the resource.
-        - `data` (string): Additional data related to the resource.
-        - `status` (number): The status of the resource.
-**Parámetros:**
-| Name | Type | Description |
-| --- | --- | --- |
-| productId | number | Campo del body: productId |
-| amount | number | Campo del body: amount |
-| moduleId | number | Campo del body: moduleId |
-| form | object | Campo del body: form |
-| customerReference | string | Campo del body: customerReference |
-### `generate_resource_daviplata_23`
----
-### Description
-Generates a payment resource in the system using the information provided in the request body. This method returns a response that includes details about the generated resource, such as the URL, reference, resource identifier, and expiration time.
----
-### Request Body
-- `productId` (number, `required`): Identifier of the product for which the resource will be generated.
-- `amount` (number, `required`): Amount of the resource to be generated.
-- `moduleId` (number, `required`): Identifier of the module to which the generated resource will be associated.
-- `form` (object):
-    - `typePerson` (string): Type of person.
-    - `documentType` (string): Type of document.
-    - `documentNumber` (string): Document number.
-    - `name` (string): Name of the customer.
-    - `email` (string): Email of the customer.
-    - `cellphone` (string): Cellphone number of the customer.
-- `customerReference` (string, `required`): Reference related to the customer.
----
-### Response Body
-- `message` (string): A message related to the response.
-- `messageCode` (string): A code related to the message.
-- `data` (object):
-    - `message` (string): A message related to the data.
-    - `date` (number): Date related to the data.
-    - `payload` (object):
-        - `url` (string): The URL of the generated resource.
-        - `reference` (string): Reference of the resource.
-        - `resourceId` (string): Identifier of the resource.
-        - `expiresIn` (string): Expiration time of the resource.
-        - `type` (string): Type of the resource.
-        - `data` (string): Additional data related to the resource.
-        - `status` (number): Status of the resource.
-**Parámetros:**
-| Name | Type | Description |
-| --- | --- | --- |
-| productId | number | Campo del body: productId |
-| amount | number | Campo del body: amount |
-| moduleId | number | Campo del body: moduleId |
-| form | object | Campo del body: form |
-| customerReference | string | Campo del body: customerReference |
-### `generate_resource_pse`
----
-### Generate Payment Resource
----
-#### Description
-This endpoint allows you to generate a payment resource in the system.
----
-#### Request Body
-- `productId` (number, `required`): Identifier of the product for which the resource will be generated.
-- `amount` (number, `required`): Amount of the resource to be generated.
-- `moduleId` (number, `required`): Identifier of the module to which the generated resource will be associated.
-- `form` (object): Optional form associated with the resource.
-    - `bankId` (string): The ID of the bank.
-    - `typePerson` (string): The type of person.
-    - `documentType` (string): The type of document.
-    - `documentNumber` (string): The document number.
-    - `name` (string): The name of the customer.
-    - `email` (string): The email of the customer.
-    - `cellphone` (string): The cellphone number of the customer.
-- `customerReference` (string, `required`): The reference for the customer.
----
-#### Response
-- `message` (string): A message related to the response.
-- `messageCode` (string): A code related to the message.
-- `data` (object):
-    - `message` (string): A message related to the data.
-    - `date` (number): The date of the response.
-    - `payload` (object):
-        - `url` (string): The URL of the generated resource.
-        - `reference` (string): The reference of the generated resource.
-        - `resourceId` (string): The identifier of the generated resource.
-        - `expiresIn` (string): The expiration time of the resource.
-        - `type` (string): The type of the resource.
-        - `data` (string): Additional data related to the resource.
-        - `status` (number): The status of the resource.
-**Parámetros:**
-| Name | Type | Description |
-| --- | --- | --- |
-| productId | number | Campo del body: productId |
-| amount | number | Campo del body: amount |
-| moduleId | number | Campo del body: moduleId |
-| form | object | Campo del body: form |
-| customerReference | string | Campo del body: customerReference |
-### `generate_res_ban_dir_al_banco`
----
-### Description
-Generates a payment resource in the system using the information provided in the request body. This method returns a response that includes details about the generated resource, such as the URL, reference, resource identifier, and expiration time.
----
-### Request Body
-- `productId` (number, `required`): Identifier of the product for which the resource will be generated.
-- `amount` (number, `required`): Amount of the resource to be generated.
-- `moduleId` (number, `required`): Identifier of the module to which the generated resource will be associated.
-- `customerReference` (string, `required`): A reference related to the customer.
----
-### Response Body
-- `message` (string): A message related to the response.
-- `messageCode` (string): A code related to the message.
-- `data` (object)
-    - `message` (string): A message related to the data.
-    - `date` (number): The date related to the data.
-    - `payload` (object)
-        - `url` (string): The URL of the generated resource.
-        - `reference` (string): The reference of the generated resource.
-        - `resourceId` (string): The identifier of the generated resource.
-        - `expiresIn` (string): The expiration time of the generated resource.
-        - `type` (string): The type of the generated resource.
-        - `data` (string): Additional data related to the generated resource.
-        - `status` (number): The status of the generated resource.
-**Parámetros:**
-| Name | Type | Description |
-| --- | --- | --- |
-| productId | number | Campo del body: productId |
-| amount | number | Campo del body: amount |
-| moduleId | number | Campo del body: moduleId |
-| customerReference | string | Campo del body: customerReference |
-### `generate_res_ban_esc_qr`
----
-### Generate Payment Resource
----
-#### Description
-Generates a payment resource in the system using the information provided in the request body.
----
-#### Request Body
-- `productId` (number, `required`): Identifier of the product for which the resource will be generated.
-- `amount` (number, `required`): Amount of the resource to be generated.
-- `moduleId` (number, `required`): Identifier of the module to which the generated resource will be associated.
-- `customerReference` (string, `required`): Reference to the customer.
----
-#### Response
-The response is a JSON object with the following properties:
-- `message` (string): A message, if any.
-- `messageCode` (string): A code associated with the message.
-- `data` (object): The data object containing the following properties:
-    - `message` (string): A message, if any.
-    - `date` (number): The date associated with the response.
-    - `payload` (object): The payload object containing the following properties:
-        - `url` (string): The URL of the generated resource.
-        - `reference` (string): The reference of the resource.
-        - `resourceId` (string): The identifier of the resource.
-        - `expiresIn` (string): The expiration time of the resource.
-        - `type` (string): The type of resource.
-        - `data` (string): Additional data associated with the resource.
-        - `status` (number): The status of the resource.
-**Parámetros:**
-| Name | Type | Description |
-| --- | --- | --- |
-| productId | number | Campo del body: productId |
-| amount | number | Campo del body: amount |
-| moduleId | number | Campo del body: moduleId |
-| customerReference | string | Campo del body: customerReference |
-### `generate_resource_tarjeta_de_recaudo`
----
-### Description
-Generates a payment resource in the system using the information provided in the request body. This method returns a response that includes details about the generated resource, such as the URL, reference, resource identifier, and expiration time.
----
-### Request Body
-- `productId` (number, `required`): Identifier of the product for which the resource will be generated.
-- `moduleId` (number, `required`): Identifier of the module to which the generated resource will be associated.
-- `customerReference` (string): The reference of the customer.
----
-### Response
-- `message` (string): A message from the response.
-- `messageCode` (string): A code associated with the message.
-- `data` (object)
-    - `message` (string): A message within the data object.
-    - `date` (number): The date associated with the response.
-    - `payload` (object)
-        - `url` (string): The URL of the generated resource.
-        - `reference` (string): The reference of the resource.
-        - `resourceId` (string): The identifier of the resource.
-        - `expiresIn` (string): The expiration time of the resource.
-        - `type` (string): The type of the resource.
-        - `data` (string): Additional data associated with the resource.
-        - `status` (number): The status of the resource.
-**Parámetros:**
-| Name | Type | Description |
-| --- | --- | --- |
-| productId | number | Campo del body: productId |
-| moduleId | number | Campo del body: moduleId |
-| customerReference | string | Campo del body: customerReference |
-### `payment_get_resource`
----
-### Retrieve Payment Resource
----
-#### Description
-Retrieve a payment resource in the system using the provided customer reference as a parameter. This method returns a response that includes details about the retrieved resource.
----
-#### Request Body Schema
-- There is no request body for this GET request.
----
-#### Response Body Schema
-- `message` (string): A message related to the response.
-- `messageCode` (string): A code associated with the message.
-- `data` (object)
-    - `payload` (object)
-        - `url` (string): The URL associated with the resource.
-        - `reference` (string): The reference of the resource.
-        - `resourceId` (string): The ID of the resource.
-        - `expiresIn` (string): The expiration time of the resource.
-        - `type` (string): The type of the resource.
-        - `data` (string): Additional data related to the resource.
-        - `status` (number): The status of the resource.
-This method returns a response that includes details about the retrieved resource.
-### `payment_pse_banks`
----
-### PSE Banks
----
-#### Description
-This service allows you to obtain the banks available to make PSE payments.
----
-#### Request Body Schema
-- There is no request body for this GET request.
----
-#### Response Body Schema
-- `message` (string): A message related to the response.
-- `messageCode` (string): A code associated with the message.
-- `data` (object)
-    - `banks`: An array of object with the banks information (id, name and image)
-### `product_list`
----
-### Retrieve Product List
-Retrieve a list of active products in the system. This service provides detailed information about the available products for querying. You can filter the results using the optional "type" parameter.
----
-#### Query Parameters
-- `type` (optional): Type of products to list. If provided and set to "bills," it will list products related to invoices; otherwise, it will list all products except those related to invoices and packages.
-**Example**:
-```
-type: bills
- ```
----
-#### Response
-The response of this request is a JSON schema representing the list of products. An example response schema is as follows:
-``` json
-{
-    "message": "",
-    "messageCode": "",
-    "data": [
-        {
-            "id": 0,
-            "categoryId": 0,
-            "name": "",
-            "needValidation": true,
-            "moduleId": 0,
-            "maxFixedTip": 0,
-            "description": "",
-            "amount": 0,
-            "sort": 0,
-            "meta": {},
-            "image": "",
-            "status": ""
-        }
-    ]
-}
- ```
-Type of products to list. If provided and set to "bills," it will list products related to invoices; otherwise, it will list all products except those related to invoices and packages.
-_Example_ : bills
-### `product_packages`
----
-### Retrieve Available Packages
----
-#### Description
-This endpoint retrieves a list of available packages in the system. The response is in JSON format and provides detailed information about the packages, which may contain multiple products.
-**Note:** It is necessary to use this service to keep the packages updated for any changes that occur.
----
-#### Response
-The response for this request can be documented as a JSON schema:
-``` json
-{
-  "type": "object",
-  "properties": {
-    "message": {
-      "type": "string"
-    },
-    "messageCode": {
-      "type": "string"
-    },
-    "data": {
-      "type": "array",
-      "items": {
-        "type": "object",
-        "properties": {
-          "id": {
-            "type": "integer"
-          },
-          "name": {
-            "type": "string"
-          },
-          "description": {
-            "type": "string"
-          },
-          "categories": {
-            "type": "array",
-            "items": {
-              "type": "object",
-              "properties": {
-                "id": {
-                  "type": "integer"
-                },
-                "name": {
-                  "type": "string"
-                },
-                "description": {
-                  "type": "string"
-                },
-                "products": {
-                  "type": "array",
-                  "items": {
-                    "type": "object",
-                    "properties": {
-                      "id": {
-                        "type": "integer"
-                      },
-                      "categoryId": {
-                        "type": "integer"
-                      },
-                      "name": {
-                        "type": "string"
-                      },
-                      "needValidation": {
-                        "type": "boolean"
-                      },
-                      "moduleId": {
-                        "type": "integer"
-                      },
-                      "maxFixedTip": {
-                        "type": "integer"
-                      },
-                      "description": {
-                        "type": "string"
-                      },
-                      "amount": {
-                        "type": "integer"
-                      },
-                      "sort": {
-                        "type": "integer"
-                      },
-                      "meta": {
-                        "type": "object"
-                      },
-                      "image": {
-                        "type": "string"
-                      },
-                      "status": {
-                        "type": "string"
-                      }
-                    },
-                    "required": [
-                      "id",
-                      "categoryId",
-                      "name",
-                      "needValidation",
-                      "moduleId",
-                      "maxFixedTip",
-                      "description",
-                      "amount",
-                      "sort",
-                      "meta",
-                      "image",
-                      "status"
-                    ]
-                  }
-                },
-                "internalName": {
-                  "type": "string"
-                }
-              },
-              "required": [
-                "id",
-                "name",
-                "description",
-                "products",
-                "internalName"
-              ]
-            }
-          },
-          "internalName": {
-            "type": "string"
-          }
-        },
-        "required": [
-          "id",
-          "name",
-          "description",
-          "categories",
-          "internalName"
-        ]
-      }
-    }
-  },
-  "required": [
-    "message",
-    "messageCode",
-    "data"
-  ]
-}
- ```
+---
+### Error Codes
+> Only the first validation error is returned per request. Validation errors (400) come from the API layer; business errors (400) are returned by the authentication service.
+| HTTP | `errorCode` | Message | Condition |
+| --- | --- | --- | --- |
+| 400 | `validators.username.required` | `El campo username es obligatorio.` | `username` is absent |
+| 400 | `validators.username.isString` | `El campo username debe ser de tipo string` | `username` is not a string |
+| 400 | `validators.username.isNotEmpty` | `El campo username no puede estar vacío.` | `username` is empty or whitespace-only |
+| 400 | `validators.secretKey.required` | `El campo secretKey es obligatorio.` | `secretKey` is absent |
+| 400 | `validators.secretKey.isString` | `El campo secretKey debe ser de tipo string` | `secretKey` is not a string |
+| 400 | `validators.secretKey.isNotEmpty` | `El campo secretKey no puede estar vacío.` | `secretKey` is empty or whitespace-only |
+| 400 | — | `The saveSession field must be of type boolean.` | `saveSession` is present but not a boolean |
+| 400 | `auth.invalid` | `Credenciales inválidas` | User does not exist or incorrect password |
+| 400 | `user.blocked` | `Estás bloqueado` | User is blocked — do not retry; contact support (body may include `notify: true`) |
+| 400 | `auth.invalid.TimeOuthLoginFaild` | `No se ha superado el tiempo de bloqueo por intentos` | Account temporarily locked after failed login attempts. Body includes `code: 5002` and optionally `diferentTimes` (minutes remaining before unlock) |
+**Parámetros:**
+| Name | Type | Description |
+| --- | --- | --- |
+| username | string | Campo del body: username |
+| secretKey | string | Campo del body: secretKey |
+### `product_list`
+---
+# Retrieve Product List
+---
+### Description
+Returns the catalog of products enabled for query and sale. Internally queries the products engine and filters internal categories (`bills`, `packages`). All products returned are available for use in subsequent query and sell operations.
+---
+### Response
+- `messageCode` (string) - Response status code.
+- `message` (string) - Response message.
+- `data` (array)
+    - `id` (number) - Product or agreement identifier.
+    - `categoryId` (number) - Category the product belongs to.
+    - `name` (string) - Commercial name.
+    - `needValidation` (boolean) - Indicates if the product requires activation steps.
+    - `moduleId` (number) - Associated module in core.
+    - `maxFixedTip` (number) - Maximum fixed tip allowed.
+    - `description` (string) - Description visible to the commerce.
+    - `amount` (number) - Fixed amount, if applicable.
+    - `sort` (number) - Suggested sort order in catalogs.
+    - `meta` (object) - Additional metadata from the products engine.
+    - `image` (string) - URL of the product image.
+    - `status` (string) - Product status (`enabled` / `disabled`).
+---
+### Error Codes
+| HTTP | `errorCode` | Message | Condition |
+|------|-------------|---------|----------|
+| 500 | `server.error` | `Mensaje del error interno` or `Critical internal server error occurred!` | Database or service failure when retrieving products — retry; if it persists, notify support |
+| 404 | — | `Not Found` | Blocked route — verify the URL |
+| 401 | `error.auth.failed` | `Error en la autenticación` | Invalid or expired authentication token. Re-authenticate and retry the request. |
+### `product_packages`
+---
+# Retrieve Available Packages
+---
+### Description
+Returns the list of configured packages (e.g., combos grouping several products). Useful for frontends that need to render hierarchies of categories → subcategories → products. Use this service to keep package data up to date.
+---
+### Response
+- `messageCode` (string) - Response status code.
+- `message` (string) - Response message.
+- `data` (array)
+    - `id` (number) - Package or root category identifier.
+    - `name` (string) - Commercial name of the package.
+    - `description` (string) - Functional description.
+    - `internalName` (string) - Internal name used for filtering.
+    - `categories` (array) - List of subcategories.
+        - `id` (number) - Subcategory identifier.
+        - `name` (string) - Subcategory name.
+        - `description` (string) - Subcategory description.
+        - `internalName` (string) - Internal name of the subcategory.
+        - `products` (array) - Associated products (same structure as `/product/list`).
+---
+### Error Codes
+| HTTP | `errorCode` | Message | Condition |
+|------|-------------|---------|----------|
+| 500 | `server.error` | `Mensaje del error interno` or `Critical internal server error occurred!` | Failure retrieving categories or products — retry; if it persists, notify support |
+| 404 | — | `Not Found` | Blocked route — verify the URL |
+| 401 | `error.auth.failed` | `Error en la autenticación` | Invalid or expired authentication token. Re-authenticate and retry the request. |
 ### `product_commissions`
@@ -1962,6 +397,16 @@ The response for this request is a JSON object with the following schema:
  ```
+---
+### Error Codes
+| HTTP | `errorCode` | Message | Condition |
+|------|-------------|---------|----------|
+| 401 | `error.auth.failed` | `Error en la autenticación` | Invalid or expired authentication token. Re-authenticate and retry the request. |
+| 404 | — | `Not Found` | Blocked route — verify the URL |
+| 500 | `server.error` | `Mensaje del error interno` or `Critical internal server error occurred!` | Database or service failure when retrieving commissions — retry; if it persists, notify support |
 ### `product_categories`
 ---
@@ -2108,6 +553,16 @@ The response for this request can be documented as a JSON schema:
  ```
+---
+### Error Codes
+| HTTP | `errorCode` | Message | Condition |
+|------|-------------|---------|----------|
+| 401 | `error.auth.failed` | `Error en la autenticación` | Invalid or expired authentication token. Re-authenticate and retry the request. |
+| 404 | — | `Not Found` | Blocked route — verify the URL |
+| 500 | `server.error` | `Mensaje del error interno` or `Critical internal server error occurred!` | Database or service failure when retrieving categories — retry; if it persists, notify support |
 ### `product_search`
 ---
@@ -2153,6 +608,18 @@ The response will be a JSON object with the following properties:
     - `form:` Array of objects that shows me the necessary references to consult the invoice. In case it arrives empty you must send a reference of preference.
+---
+### Error Codes
+| HTTP | `errorCode` | Message | Condition |
+|------|-------------|---------|----------|
+| 400 | `validators.query.required` | `El campo query es obligatorio.` | `query` field is absent from the request body |
+| 400 | `validators.query.isString` | `El campo query debe ser de tipo string` | `query` is not a string |
+| 401 | `error.auth.failed` | `Error en la autenticación` | Invalid or expired authentication token. Re-authenticate and retry the request. |
+| 404 | — | `Not Found` | Blocked route — verify the URL |
+| 500 | `server.error` | `Mensaje del error interno` or `Critical internal server error occurred!` | Database or service failure when searching products — retry; if it persists, notify support |
 **Parámetros:**
 | Name | Type | Description |
@@ -2163,52 +630,62 @@ The response will be a JSON object with the following properties:
 ---
+# Query Product
+---
 ### Description
-This HTTP POST request is used to perform a custom query on the platform. The request body should be sent with the necessary parameters for the query in the format specified by the QueryBody object. The response will include the results of the query in case of success.
+Performs the pre-sale query to obtain invoice data, reference, hash, and amount. Communicates with the Movement service. The returned `hash` and `hashEchoData` values must be forwarded in the subsequent sell request when paying bills. If the response contains only one of the two hash fields, the API automatically mirrors it to the other.
-It is important that when the request fails with the errorCode "product.errors.disabled" or similar indicating that the product is inactive, the agreements are consulted again using the search.
+It is important that when the request fails with the errorCode `product.errors.disabled` or similar indicating that the product is inactive, the agreements are consulted again using the search service.
 ---
-### Request Body Schema
+### Request Body
-- productId (number) `required`: Identifier of the product to perform the query.
-- queryType (string) `required`: Type of query to be performed.
-- ownAgreementId (null): Identifier of the own agreement, if applicable.
-- data (object) `required`: Additional data for the query.
-    - reference (string) `required`: Reference for the query.
+- `productId` (number) `required` - Identifier of the product to query.
+- `queryType` (string) `required` - Type of query expected by Movement (e.g., `BILLData`). Min length: 1.
+- `ownAgreementId` (number) - Identifier of the own agreement, if applicable.
+- `data` (object) - Specific provider data (reference, cellphone, etc.). Technically optional, but required by most products at the business level.
+    - `reference` (string) - Invoice or reference number to query. Used for bill products.
+    - `cellphone` (string) - Destination phone number. Used for top-ups and packages.
+   - `plate` (string) - Vehicle plate. Used for SOAT products.
 ---
-### Response Body Schema
+### Response
-- message (string): Response message.
-- messageCode (string): Code related to the response message.
-- data (object): Response data object.
-    - payload (object): Payload data.
-        - amount (number): Amount related to the product.
-        - productId (number): ID of the product.
-        - productName (string): Name of the product.
-        - reference (string): Reference related to the query.
-        - hashEchoData (string): Hash echo data.
-        - hash (string): Hash value.
-        - amountEditable (boolean): Indicates if the amount is editable.
+- `messageCode` (string) - Response status code.
+- `message` (string) - Response message.
+- `data` (object)
+    - `amount` (number) - Calculated amount for the sale.
+    - `productId` (number) - Identifier of the queried product.
+    - `productName` (string) - Product name.
+    - `reference` (string) - Reference to be forwarded in the sell request.
+    - `hash` (string) - Hash generated by Movement. Mirror of `hashEchoData` if absent.
+    - `hashEchoData` (string) - Mirror hash field. Mirror of `hash` if absent.
+    - `amountEditable` (boolean) - Indicates if the amount can be modified at sell time.
+---
+### Error Codes
+| HTTP | `errorCode` | Message | Condition |
+|------|-------------|---------|----------|
+| 400 | `validators.productId.number` | `El campo productId debe ser de tipo Numerico` | `productId` is absent or not numeric |
+| 400 | `validators.queryType.required` | `El campo queryType es obligatorio.` | `queryType` is absent |
+| 400 | `validators.queryType.isString` | `El campo queryType debe ser de tipo string` | `queryType` is not a string |
+| 400 | `validators.queryType.isNotEmpty` | `El campo queryType no puede estar vacío.` | `queryType` is empty or whitespace-only |
+| 400 | — | `data must be an object` | `data` is present but not an object |
+| 400 | — | `ownAgreementId must be a number` | `ownAgreementId` is present but not a number |
+| 404 | `products.errors.notFound` / `product.not.found` | `Producto no encontrado` | Product does not exist or is unavailable |
+| 404 | `products.errors.disabled` | `Producto deshabilitado` | Product is disabled — re-fetch agreements using the search service |
+| 404 | `products.errors.providers.notFound` | `El producto no tiene un proveedor.` | No provider associated with the product |
+| 400 | `products.errors.metadata.invalid` | `Los metadatos del convenio no tienen un formato válido` | Agreement metadata is invalid |
+| 400 | `overdue.reference` | `Esta referencia ya se encuentra vencida.` | Reference is overdue — do not retry with same reference |
+| 400 | `closed.reference` | `Esta referencia ya se encuentra cerrada.` | Reference is closed |
+| 401 | `error.auth.failed` | `Error en la autenticación` | Invalid or expired authentication token. Re-authenticate and retry the request. |
 **Parámetros:**
@@ -2354,282 +831,46 @@ The response will include the results of the query in case of success.
         - productId (number): The ID of the product related to the query result.
-        - productName (string): The name of the product related to the query result.
-        - reference (string): The reference related to the query result.
-        - hashEchoData (string): The echoed hash data.
-        - hash (string): The hash data.
-        - amountEditable (boolean): Indicates whether the amount is editable or not.
-- code (string): The code from the response.
-- errorCode (string): The error code from the response.
-- statusCode (number): The status code from the response.
-- timestamp (number): The timestamp of the response.
-**Parámetros:**
-| Name | Type | Description |
-| --- | --- | --- |
-| productId | number | Campo del body: productId |
-| queryType | string | Campo del body: queryType |
-| ownAgreementId | null | Campo del body: ownAgreementId |
-| data | object | Campo del body: data |
-### `query_convenio_vendo`
----
-### Description
-This HTTP POST request is used to perform a custom query on the platform. The request body should be sent with the necessary parameters for the query in the format specified by the QueryBody object. The response will include the results of the query in case of success.
----
-### Request Body Schema
-- productId (number) `required`: Identifier of the product to perform the query.
-- queryType (string) `required`: Type of query to be performed.
-- ownAgreementId (null): Identifier of the own agreement, if applicable.
-- data (object) `required`: Additional data for the query.
-    - reference (string) `required`: Reference for the query.
----
-### Response Body Schema
-- message (string): Response message.
-- messageCode (string): Code related to the response message.
-- data (object): Response data object.
-    - payload (object): Payload data.
-        - amount (number): Amount related to the product.
-        - productId (number): ID of the product.
-        - productName (string): Name of the product.
-        - reference (string): Reference related to the query.
-        - hashEchoData (string): Hash echo data.
-        - hash (string): Hash value.
-        - amountEditable (boolean): Indicates if the amount is editable.
-**Parámetros:**
-| Name | Type | Description |
-| --- | --- | --- |
-| productId | number | Campo del body: productId |
-| queryType | string | Campo del body: queryType |
-| ownAgreementId | number | Campo del body: ownAgreementId |
-| data | object | Campo del body: data |
-### `product_act_val_pro_state`
----
-### Description
-Allows users to verify the activation status of a special product. The user making the request can determine the stage of their special product activation request. Below is a list of status codes along with their corresponding messages, indicating whether the request is pending review, approved, rejected, confirmed, managed by the affiliations area, or if the linking process for the product has already started. This information is useful for keeping the user informed about the progress of their request and for them to take necessary actions based on the current process status.
-The following is a list of product status codes and their messages.
-```
-  | id | name       | message                                                                                               |
-  |----|------------|-------------------------------------------------------------------------------------------------------|
-  | P  | PENDING    | Your application is pending review                                                                    |
-  | A  | APPROVED   | Your application has been approved, we are waiting for the supplier to review your documents          |
-  | R  | REJECTED   | Your application has been rejected, please contact your advisor.                                      |
-  | M  | MANAGEMENT | Your  application is being handled by the linking area.                                               |
-  | C  | CONFIRM    | Your application is confirmed, you can now sell your product.                                         |
-  | S  | STARTED    | You have already tried to complete the linking process for this product, continue filling in the data |
- ```
----
-## Request Schema
-- `productId`: Number representing the product identifier (required)
-- `categoryId`: Number representing the category identifier (required)
----
-## Response Schema
-- `message`: String containing a message about the operation result (required)
-- `messageCode`: String code indicating the operation result (required)
-- `data`: Object containing additional response data (required)
-    - `status`: String representing the status
-    - `state`: Boolean indicating the state
-    - `message`: String containing an additional message
-    - `stateCode`: String representing a state code
-**Parámetros:**
-| Name | Type | Description |
-| --- | --- | --- |
-| body | string | Body del request |
-### `product_act_get_pro_requirements`
----
-## Description
-Allows retrieving all the necessary and mandatory requirements to complete the activation process of a special product. The requirements are divided into categories, each with a specific description. Each category contains a list of detailed requirements, such as personal data, merchant information, and additional documents. Requirements may include document uploads, information validation, or contract signing. These requirements are essential for the user to access the special product, and this method provides the necessary information for the user to successfully complete the activation process.
-In the response for each requirement, you'll find the 'type' attribute. This attribute determines the type of data required to construct the form that the user must complete. Some common data types include:
-```
-  | type                  | description                                                                                         |
-  |-----------------------|-----------------------------------------------------------------------------------------------------|
-  | text                  | For entering text information, such as names, surnames, etc.                                        |
-  | file                  | Allows uploading files, such as images or documents.                                                |
-  | select                | Presents options for the user to choose from.                                                       |
-  | downloadAndUpload     | Provides a link to download one file and then upload another related file.                          |
-  | securityQuestions     | Provides security questions for authentication.                                                     |
-  | checkboxLink          | For accepting terms and conditions through a verification link.                                     |
-  | loanApplicationPolicy | Information and acceptance of the loan application policy.                                          |
-  | location              | Allows the user to enter or select their location.                                                  |
-  | metamap               | Redirects the user to the Metamap process for identity validation.                                  |
-  | bankAccount           | Provides the basic structure to build the form for a banking process.                               |
-  |                       | It includes selecting the bank entity, entering the account number, and selecting the account type. |
- ```
----
-## Request Schema
-- `productId`: Number representing the product identifier (required)
-- `categoryId`: Number representing the category identifier (required)
----
-## Response Schema
-- `message`: String containing a message about the operation result (required)
-- `messageCode`: String code indicating the operation result (required)
-- `data`: Object containing additional response data (required)
-    - `id`: Number representing the identifier
-    - `name`: String representing the name
-    - `description`: String containing the description
-    - `requirements`: Array of requirement objects
-        - `id`: Number representing the requirement identifier
-        - `name`: String representing the requirement name
-        - `description`: String containing the requirement description
-        - `form`: Object containing form data
-**Parámetros:**
-| Name | Type | Description |
-| --- | --- | --- |
-| body | string | Body del request |
-### `product_activation_update`
----
-## Description
-Allows updating the information of the requirements completed by the user for the activation process of a special product. Users can modify the information provided in each of the requirements to ensure it is up-to-date and accurate. Updating the information of the requirements is essential to progress in the activation process of the special product. Once the information is updated, it is evaluated again to determine if all necessary requirements are met to continue or complete the activation process.
----
-## Request Schema
-- `requirements`: Object containing requirement data (required)
-    - Each key is a string representing a requirement ID
-    - Each value is an object with arbitrary properties
----
-## Response Schema
-- `message`: String containing a message about the operation result (required)
+        - productName (string): The name of the product related to the query result.
+        - reference (string): The reference related to the query result.
+        - hashEchoData (string): The echoed hash data.
+        - hash (string): The hash data.
+        - amountEditable (boolean): Indicates whether the amount is editable or not.
+- code (string): The code from the response.
-- `messageCode`: String code indicating the operation result (required)
+- errorCode (string): The error code from the response.
-- `data`: Object containing additional response data (required)
+- statusCode (number): The status code from the response.
-    - `errors`: Array of error objects
-        - `id`: Number representing the error identifier
-        - `message`: String containing the error message
+- timestamp (number): The timestamp of the response.
 **Parámetros:**
 | Name | Type | Description |
 | --- | --- | --- |
-| requirements | object | Campo del body: requirements |
-### `product_activation_upload_file`
----
-### Description
-Allows users to upload files necessary to meet the requirements of the activation process for a special product. The uploaded files can be documents in PDF format, images in JPG, JPEG, or PNG formats, or Word documents in DOC or DOCX format. Before uploading a file, validations are performed to ensure that it meets the established type and size requirements. Once uploaded, the file can be subsequently validated as part of the special product activation process. If the file meets the requirements, it will contribute to the progress of the process; otherwise, it will be indicated as invalid, and a new upload will be requested.
+| productId | number | Campo del body: productId |
+| queryType | string | Campo del body: queryType |
+| ownAgreementId | null | Campo del body: ownAgreementId |
+| data | object | Campo del body: data |
----
+### `query`
-### Response schema
+**Important:** This request will be processed within a timeout of **30,000 milliseconds (30 seconds)**.
-- `message`: String containing a message about the operation result (required)
-- `messageCode`: String code indicating the operation result (required)
-- `data`: Object containing additional response data (required)
-    - `errors`: Array of error objects
-        - `id`: Number representing the error identifier
-        - `message`: String containing the error message
+### Test Data
-### `query`
+Use the following example values to test this endpoint in the QA environment:
-POST /product/query
+| Field | Example Value |
+|-------|---------------|
+| productId | 1587 |
+| queryType | "BILLData" |
+| data.reference | "63440172" |
 **Parámetros:**
@@ -2737,13 +978,28 @@ Allows performing a sale on the platform. Send the request body with the necessa
                 - `message`: String representing the message (required)
+### Test Data
+Use the following example values to test this endpoint in the QA environment:
+| Field | Example Value |
+|-------|---------------|
+| amount | 9999 |
+| productId | 1587 |
+| sellType | "Bill" |
+| data.agreement | 2010910 |
+| data.reference | "63440172" |
+| data.cellphone | "3203550000" |
+| data.hashEchoData | "eyJhZ3JlZW1lbnRJZCI6MzM3NDMsInJlZmVyZW5jZTEiOiI2MzQ0MDE3MiIsInJlZmVyZW5jZTIiOm51bGwsImFtb3VudCI6OTk5OSwiYWdyZWVtZW50TWVzc2FnZSI6IiIsImFncmVlbWVudENvZGUiOiIwMCIsInJlcXVpcmVzQW1vdW50IjoiMCIsImFkaXRpb25hbFZhbHVlNTRFY28iOiIwMTIzNDU2Nzg5MCIsImFkaXRpb25hbFZhbHVlNjJFY28iOiIxNTE2NTc4OTU1NjM0MjgxNjM4NzM5OTAyMjk1IiwiYWNjb3VudERhdGFBY3JlZGl0ZWQiOiI0NzU3NjY3MjA1ODE2Mzg3Mzk5MDIyOTUyMjc2IiwiYWRkaXRpb25hbENvbXBhbnlDb2RlIjoiMTUxNjU3ODk1NTYzNDI4MjgwNjI4MzcwMTIxMiIsImRhdGUiOiIyMDI2LTAzLTEwIiwidHJhY2UiOjUxMjF9" |
 **Parámetros:**
 | Name | Type | Description |
 | --- | --- | --- |
+| amount | number | Campo del body: amount |
 | productId | number | Campo del body: productId |
-| queryType | string | Campo del body: queryType |
-| ownAgreementId | null | Campo del body: ownAgreementId |
+| hash | string | Campo del body: hash |
+| sellType | string | Campo del body: sellType |
 | data | object | Campo del body: data |
 ### `query_axa`
@@ -2805,6 +1061,19 @@ The following payload is required for performing a custom query:
 - `license`: (string, optional) The license plate of the vehicle.
+### Test Data
+Use the following example values to test this endpoint in the QA environment:
+| Field | Example Value |
+|-------|---------------|
+| queryType | "SOATData" |
+| productId | 91 |
+| docType | "NIT" |
+| document | "819000939" |
+| cellphone | "3200000000" |
+| license | "NAC854" |
 **Parámetros:**
 | Name | Type | Description |
@@ -2907,6 +1176,35 @@ The following payload is required for performing a custom sell:
 After the sale has been successfully completed, the response will follow a structure similar to the following. In this response, important information is provided, such as the balance of the main wallet and the balance of the profit wallet. Additionally, within the 'billData' object, you will find the fundamental information necessary to generate the sales receipt that will be delivered to the end customer. It is important to note that this step is mandatory, as it is a direct requirement from AXA Colpatria.
+### Test Data
+Use the following example values to test this endpoint in the QA environment:
+| Field | Example Value |
+|-------|---------------|
+| productId | 91 |
+| amount | 557400 |
+| data.amount.amount | 556400 |
+| data.amount.runt | 2100 |
+| data.amount.prima | 364700 |
+| data.amount.contributions | 189600 |
+| data.amount.valueDiscountLaw | 0 |
+| data.amount.valueDiscountTotal | 0 |
+| data.amount.valuePayDiscount | 556400 |
+| data.amount.amountAdministrative | 566 |
+| data.amount.amountTotal | 557400 |
+| data.amount.dateStart | "2024-06-04" |
+| data.amount.dateEnd | "2025-06-03" |
+| data.amount.discount | 0 |
+| data.license | "EJV885" |
+| data.hashEchoData | "eyJpZFRyYW5zYWNjaW9uIjoiMmE2MDhjY2YtZjdiOS00ZGM1LTg2OTQtYTAyY2E0ODNkOWE4IiwiaWRDb3JyZWxhY2lvbiI6MTcxNzUzNDY0MTc1MH0=" |
+| data.cifrateAmount.hash | "eyJhbW91bnQiOjU1NzQwMH0=" |
+| data.cifrateAmount.hashEchoData | "ef3e40f13fa0430eb1dfa9a8e499e3a4ea81c42159b5ee3eccac88d8ef47198e32d28339fcf656704009a0b05802363b3016d921bcfd6aa8920558535aa75218" |
+| data.userDetail.cellphone | "3200000000" |
+| data.userDetail.email | "test@email.com" |
+| data.userDetail.document | "860002964" |
+| data.userDetail.docType | "NIT" |
 **Parámetros:**
 | Name | Type | Description |
@@ -3039,6 +1337,8 @@ The following payload is required for performing a custom query:
 - `license`: (string, required) The license plate of the vehicle.
+**Important:** This request will be processed within a timeout of **30,000 milliseconds (30 seconds)**.
 **Parámetros:**
 | Name | Type | Description |
@@ -3510,7 +1810,21 @@ The following payload is required for performing a custom sell:
         - `vehicleLineId`: (number, required) Vehicle line ID.
-        - `vehicleClassId`: (number, required) Vehicle class ID.
+        - `vehicleClassId`: (number, required) Vehicle class ID. Defined by the SAME provider (SOAT – RUNT classification). Valid values:
+            | Value | Description |
+            | --- | --- |
+            | 1 | MOTOS |
+            | 2 | CAMPEROS O CAMIONETAS |
+            | 3 | CARGA O MIXTO |
+            | 4 | OFICIALES, ESPECIALES, BOMBEROS, DIPLOMÁTICOS |
+            | 5 | AUTOMÓVILES FAMILIARES |
+            | 6 | VEHÍCULO PARA 6 O MÁS PASAJEROS |
+            | 7 | AUTOS DE NEGOCIOS, TAXIS, ALQUILER, ENSEÑANZA |
+            | 8 | BUSES O BUSETAS |
+            | 9 | INTERMUNICIPAL |
+            | 12 | MOTOCARRO |
+            | 13 | CICLOMOTOR |
         - `vehicleClassMinistryId`: (number, required) Vehicle class ID (Ministry).
@@ -3591,362 +1905,127 @@ The following payload is required for performing a custom sell:
         - `typePerson`: (string) Type of person (e.g., 'F' for natural person, 'J' for legal person).
         - `gender`: (string) User's gender.
-        - `RegimenTypeId`: (string, required) User's regime type ID.
-        - `RutId`: (number, required) User's RUT ID.
-- `amount`: (number, required) Total amount of the sale.
-- `moveTmpBalance`: (boolean) Indicates whether to move temporary balance.
-`Note`: If the VIN data is not available, the API will use the chassis number as a replacement.
-After the sale has been successfully completed, the response will follow a structure similar to the following. **This response will be returned within a timeout of 120,000 milliseconds (2 minutes).** In this response, important information is provided, such as the balance of the main wallet and the balance of the profit wallet. Additionally, within the 'billData' object, you will find the fundamental information necessary to generate the sales receipt that will be delivered to the end customer.
-**Parámetros:**
-| Name | Type | Description |
-| --- | --- | --- |
-| productId | number | Campo del body: productId |
-| data | object | Campo del body: data |
-| amount | number | Campo del body: amount |
-### `sell_luck_and_chance_rushbet`
-Allows performing a sale on the platform. Send the request body with the necessary parameters for the sale in the format specified by the SellBody object. This operation will return a response that includes information about the sale in case of success.
-**Note**: To make this request in the case of selling invoices, we need the hash and hashEchoData provided by the query response for the reference.
-**Parámetros:**
-| Name | Type | Description |
-| --- | --- | --- |
-| productId | number | Campo del body: productId |
-| amount | number | Campo del body: amount |
-| data | object | Campo del body: data |
-### `sell_packages_movistar`
-Allows performing a sale on the platform. Send the request body with the necessary parameters for the sale in the format specified by the SellBody object. This operation will return a response that includes information about the sale in case of success.
-**Note**: To make this request in the case of selling invoices, we need the hash and hashEchoData provided by the query response for the reference.
-**Parámetros:**
-| Name | Type | Description |
-| --- | --- | --- |
-| productId | number | Campo del body: productId |
-| data | object | Campo del body: data |
-### `sell`
----
-## Description
-Allows performing a sale on the platform. Send the request body with the necessary parameters for the sale in the format specified by the SellBody object. This operation will return a response that includes information about the sale in case of success.
-**Note**: To make this request in the case of selling invoices, we need the hash and hashEchoData provided by the query response for the reference.
----
-## Request Schema
-- `productId`: Number representing the product identifier (required)
-- `amount`: Number representing the amount of the payment (required)
-- `data`: Object containing additional data (required)
-    - `cellphone`: String containing the cellphone number (required)
-- `_preventDuplicate`: Boolean to disable duplicate transaction prevention, i.e. if the value is `true`, duplicate transactions will not be validated, allowing to send bulk reloads. (optional)
----
-## Response Schema
-- `statusCode`: Number representing the HTTP status code (required)
-- `message`: String containing a message about the operation result (required)
-- `date`: Number representing the timestamp of the operation (required)
-- `payload`: Object containing the main response data (required)
-    - `posBalance`: String representing the balance after the operation (required)
-    - `tmpBalance`: String representing the temporary balance (required)
-    - `debt`: Number representing the debt amount (required)
-    - `billData`: Object containing bill-related data (required)
-        - `fields`: Array of field objects (required)
-            - `label`: String representing the field label (required)
-            - `value`: String or Number representing the field value (required)
-            - `type`: String representing the field type (optional)
-            - `labelLink`: String representing the label link (optional)
-        - `costs`: Array of cost objects (required)
-            - `label`: String representing the cost label (required)
-            - `value`: Number representing the cost value (required)
-            - `type`: String representing the cost type (optional)
-            - `labelLink`: String representing the label link (optional)
-        - `messages`: Array of message objects (required)
-            - `value`: String representing the message value (required)
-        - `share`: Object containing share information (required)
-            - `cellphone`: String representing the cellphone number (required)
-            - `message`: String representing the message (required)
-    - `sale`: Object containing sale information (required)
-        - `id`: Number representing the sale ID (required)
-        - `userId`: Number representing the user ID (required)
-        - `amount`: Number representing the sale amount (required)
-        - `serviceNumber`: String representing the service number (required)
-        - `status`: Number representing the sale status (required)
-        - `productId`: Number representing the product ID (required)
-        - `createdAt`: String representing the creation timestamp (required)
-        - `transactionId`: String representing the transaction ID (required)
-        - `extra`: String representing additional information (optional)
-**Parámetros:**
-| Name | Type | Description |
-| --- | --- | --- |
-| productId | number | Campo del body: productId |
-| amount | number | Campo del body: amount |
-| data | object | Campo del body: data |
-| _preventDuplicate | boolean | Campo del body: _preventDuplicate |
-### `product_directtv_prepago`
----
-## Description
-Allows performing a bill payment operation on the platform. Send the request body with the necessary parameters for the payment in the format specified by the PaymentBody object. The response will include the results of the operation in case of success.
----
-## Request Schema
-- `productId`: Number representing the product identifier (required)
-- `amount`: Number representing the amount of the payment (required)
-- `data`: Object containing additional data (required)
-    - `cellphone`: String containing the cellphone number (required)
----
-## Response Schema
-- `message`: String containing a message about the operation result (required)
-- `messageCode`: String code indicating the operation result (required)
-- `data`: Object containing additional response data (required)
-    - `date`: Number representing the timestamp of the operation (required)
-    - `sellId`: Number representing the identifier of the sell operation (required)
-    - `payload`: Object containing the main response data (required)
-        - `preBalance`: Number representing the balance before the operation (required)
-        - `posBalance`: Number representing the balance after the operation (required)
-        - `tmpBalance`: Number representing the temporary balance (required)
-        - `debt`: Number representing the debt amount (required)
-        - `billData`: Object containing bill-related data (required)
-            - `fields`: Array of field objects (required)
-                - `name`: String representing the field name (required)
-                - `type`: String representing the field type (required)
-                - `options`: Array of option objects (required)
-                    - `label`: String representing the option label (required)
-                    - `value`: String representing the option value (required)
-                - `label`: String representing the field label (required)
-                - `placeholder`: String representing the field placeholder (required)
-                - `required`: Boolean indicating if the field is required (required)
-            - `costs`: Array of cost objects (required)
-                - `label`: String representing the cost label (required)
-                - `value`: Number representing the cost value (required)
-            - `messages`: Array of message objects (required)
-                - `value`: String representing the message value (required)
-            - `stringInformation`: Array of string information objects (required)
-                - `value`: String representing the string information value (required)
-            - `footerInformation`: Array of footer information objects (required)
-            - `share`: Object containing share information (required)
-                - `cellphone`: String representing the cellphone number (required)
-                - `message`: String representing the message (required)
+        - `RegimenTypeId`: (string, required) User's regime type ID.
+        - `RutId`: (number, required) User's RUT ID.
+- `amount`: (number, required) Total amount of the sale.
+- `moveTmpBalance`: (boolean) Indicates whether to move temporary balance.
+`Note`: If the VIN data is not available, the API will use the chassis number as a replacement.
+After the sale has been successfully completed, the response will follow a structure similar to the following. **This response will be returned within a timeout of 120,000 milliseconds (2 minutes).** In this response, important information is provided, such as the balance of the main wallet and the balance of the profit wallet. Additionally, within the 'billData' object, you will find the fundamental information necessary to generate the sales receipt that will be delivered to the end customer.
 **Parámetros:**
 | Name | Type | Description |
 | --- | --- | --- |
-| data | object | Campo del body: data |
 | productId | number | Campo del body: productId |
+| data | object | Campo del body: data |
 | amount | number | Campo del body: amount |
-### `sell_netflix`
----
-## Description
+### `sell_luck_and_chance_rushbet`
 Allows performing a sale on the platform. Send the request body with the necessary parameters for the sale in the format specified by the SellBody object. This operation will return a response that includes information about the sale in case of success.
 **Note**: To make this request in the case of selling invoices, we need the hash and hashEchoData provided by the query response for the reference.
+**Important:** This response will be returned within a timeout of **60,000 milliseconds (60 seconds)**.
 ---
 ## Request Schema
 - `productId`: Number representing the product identifier (required)
-- `amount`: Number representing the amount for the transaction (required)
+- `amount`: Number representing the payment amount (required)
-- `data`: Object containing additional data (required)
+- `data`: Object containing additional transaction data (required)
-    - `cellphone`: String containing the cellphone number (required)
+    - `cellphone`: String containing the customer's cellphone number (required)
-    - `email`: String containing the email address (required)
+    - `document`: String containing the customer's identification document number (required)
+    - `name`: String containing the customer's first name (required)
+    - `lastname`: String containing the customer's last name (required)
 ---
-## Response Schema
+### Test Data
-- `message`: String containing a message about the operation result (required)
-- `messageCode`: String code indicating the operation result (required)
+Use the following example values to test this endpoint in the QA environment:
+| Field | Example Value |
+|-------|---------------|
+| productId | 603 |
+| amount | 100 |
+| data.cellphone | "3200000000" |
+| data.document | "1023900000" |
+| data.name | "Pachito" |
+| data.lastname | "Hernesto" |
+**Parámetros:**
+| Name | Type | Description |
+| --- | --- | --- |
+| productId | number | Campo del body: productId |
+| amount | number | Campo del body: amount |
+| data | object | Campo del body: data |
+| sellType | string | Campo del body: sellType |
+| hash | string | Campo del body: hash |
+### `sell_packages_claro`
+Allows performing a sale on the platform. Send the request body with the necessary parameters for the sale in the format specified by the SellBody object. This operation will return a response that includes information about the sale in case of success.
+**Note**: To make this request in the case of selling invoices, we need the hash and hashEchoData provided by the query response for the reference.
+**Important:** This response will be returned within a timeout of **60,000 milliseconds (60 seconds)**.
+---
+## Request Schema
+- `productId`: Number representing the product identifier (required)
-- `data`: Object containing additional response data (required)
+- `data`: Object containing additional transaction data (required)
-    - `date`: Number representing the timestamp of the operation (required)
-    - `sellId`: Number representing the identifier of the sell operation (required)
-    - `payload`: Object containing the main response data (required)
+    - `cellphone`: String containing the customer's cellphone number (required)
-        - `preBalance`: Number representing the balance before the operation (required)
-        - `posBalance`: Number representing the balance after the operation (required)
-        - `tmpBalance`: Number representing the temporary balance (required)
-        - `debt`: Number representing the debt amount (required)
-        - `billData`: Object containing bill-related data (required)
-            - `fields`: Array of field objects (required)
-                - `name`: String representing the field name (required)
-                - `type`: String representing the field type (required)
-                - `options`: Array of option objects (required)
-                    - `label`: String representing the option label (required)
-                    - `value`: String representing the option value (required)
-                - `label`: String representing the field label (required)
-                - `placeholder`: String representing the field placeholder (required)
-                - `required`: Boolean indicating if the field is required (required)
-            - `costs`: Array of cost objects (required)
-                - `label`: String representing the cost label (required)
-                - `value`: Number representing the cost value (required)
-            - `messages`: Array of message objects (required)
-                - `value`: String representing the message value (required)
-            - `stringInformation`: Array of string information objects (required)
-                - `value`: String representing the string information value (required)
-            - `footerInformation`: Array of footer information objects (required)
-            - `share`: Object containing share information (required)
-                - `cellphone`: String representing the cellphone number (required)
-                - `message`: String representing the message (required)
+---
+### Test Data
+Use the following example values to test this endpoint in the QA environment:
+| Field | Example Value |
+|-------|---|
+| productId | 200048 |
+| data.cellphone | "3215302000" |
 **Parámetros:**
 | Name | Type | Description |
 | --- | --- | --- |
 | productId | number | Campo del body: productId |
-| amount | number | Campo del body: amount |
 | data | object | Campo del body: data |
+| amount | number | Campo del body: amount |
+| sellType | string | Campo del body: sellType |
+| hash | string | Campo del body: hash |
-### `sell_netflix_error`
+### `product_directtv_prepago`
 ---
 ## Description
-Allows performing a sale on the platform. Send the request body with the necessary parameters for the sale in the format specified by the SellBody object. This operation will return a response that includes information about the sale in case of success.
-**Note**: To make this request in the case of selling invoices, we need the hash and hashEchoData provided by the query response for the reference.
+Allows performing a bill payment operation on the platform. Send the request body with the necessary parameters for the payment in the format specified by the PaymentBody object. The response will include the results of the operation in case of success.
 ---
@@ -3954,26 +2033,12 @@ Allows performing a sale on the platform. Send the request body with the necessa
 - `productId`: Number representing the product identifier (required)
-- `moveTmpBalance`: Boolean flag to move temporary balance (required)
-- `hash`: String containing the hash value for the operation (nullable)
-- `sellType`: String indicating the type of the sell operation (nullable)
 - `amount`: Number representing the amount of the payment (required)
 - `data`: Object containing additional data (required)
     - `cellphone`: String containing the cellphone number (required)
-    - `email`: String containing the email address (required)
-    - `document`: String containing the document number (required)
-    - `reference`: String containing the reference number for the payment (nullable)
-    - `hashEchoData`: String containing the hash echo data for the operation (nullable)
 ---
@@ -4041,108 +2106,35 @@ Allows performing a sale on the platform. Send the request body with the necessa
                 - `message`: String representing the message (required)
-**Parámetros:**
-| Name | Type | Description |
-| --- | --- | --- |
-| productId | number | Campo del body: productId |
-| hash | null | Campo del body: hash |
-| sellType | null | Campo del body: sellType |
-| amount | number | Campo del body: amount |
-| data | object | Campo del body: data |
-### `sell_xbox_gamepass_core_3_meses`
----
-## Description
-Allows performing a sale on the platform. Send the request body with the necessary parameters for the sale in the format specified by the SellBody object. This operation will return a response that includes information about the sale in case of success.
-**Note**: To make this request in the case of selling invoices, we need the hash and hashEchoData provided by the query response for the reference.
----
-## Request Schema
-- `productId`: Number representing the product identifier (required)
-- `amount`: Number representing the amount of the payment (required)
-- `moveTmpBalance`: Boolean flag to move temporary balance (required)
-- `data`: Object containing additional data (required)
-    - `cellphone`: String containing the cellphone number (required)
-    - `email`: String containing the email address (required)
+**Important:** This response will be returned within a timeout of **60,000 milliseconds (60 seconds)**.
----
+### Test Data
-## Response Schema
+Use the following example values to test this endpoint in the QA environment:
-- `messageCode`: String code indicating the operation result (required)
-- `message`: String containing a message about the operation result (required)
-- `data`: Object containing additional response data (required)
-    - `statusCode`: Number representing the status code (required)
-    - `message`: String containing a message about the transaction (required)
-    - `date`: Number representing the timestamp of the operation (required)
-    - `payload`: Object containing the main response data (required)
-        - `posBalance`: Number representing the balance after the operation (required)
-        - `tmpBalance`: Number representing the temporary balance (required)
-        - `billData`: Object containing bill-related data (required)
-            - `fields`: Array of field objects (required)
-                - `label`: String representing the field label (required)
-                - `value`: String or Number representing the field value (required)
-            - `costs`: Array of cost objects (required)
-                - `label`: String representing the cost label (required)
-                - `value`: Number representing the cost value (required)
-            - `messages`: Array of message objects (required)
-                - `value`: String representing the message value (required)
-            - `share`: Object containing share information (required)
-                - `cellphone`: String representing the cellphone number (required)
-                - `message`: String representing the message (required)
-        - `preBalance`: Number representing the balance before the operation (required)
-        - `debt`: Number representing the debt amount (required)
+| Field | Example Value |
+|-------|---------------|
+| productId | 50 |
+| amount | 1000 |
+| data.cellphone | "3015874044" |
 **Parámetros:**
 | Name | Type | Description |
 | --- | --- | --- |
+| data | object | Campo del body: data |
 | productId | number | Campo del body: productId |
 | amount | number | Campo del body: amount |
-| data | object | Campo del body: data |
-### `product_directtv_go_1014005`
+### `sell_netflix`
 ---
 ## Description
-Allows performing a bill payment operation on the platform. Send the request body with the necessary parameters for the payment in the format specified by the PaymentBody object. The response will include the results of the operation in case of success.
+Allows performing a sale on the platform. Send the request body with the necessary parameters for the sale in the format specified by the SellBody object. This operation will return a response that includes information about the sale in case of success.
+**Note**: To make this request in the case of selling invoices, we need the hash and hashEchoData provided by the query response for the reference.
 ---
@@ -4150,6 +2142,8 @@ Allows performing a bill payment operation on the platform. Send the request bod
 - `productId`: Number representing the product identifier (required)
+- `amount`: Number representing the amount for the transaction (required)
 - `data`: Object containing additional data (required)
     - `cellphone`: String containing the cellphone number (required)
@@ -4223,14 +2217,28 @@ Allows performing a bill payment operation on the platform. Send the request bod
                 - `message`: String representing the message (required)
+**Important:** This response will be returned within a timeout of **60,000 milliseconds (60 seconds)**.
+### Test Data
+Use the following example values to test this endpoint in the QA environment:
+| Field | Example Value |
+|-------|---------------|
+| productId | 202 |
+| amount | 50 |
+| data.cellphone | "3015874029" |
+| data.email | "correo@refacil.com" |
 **Parámetros:**
 | Name | Type | Description |
 | --- | --- | --- |
-| data | object | Campo del body: data |
 | productId | number | Campo del body: productId |
+| amount | number | Campo del body: amount |
+| data | object | Campo del body: data |
-### `product_directtv_go_100777`
+### `product_directtv_go_1014005`
 ---
@@ -4317,6 +2325,16 @@ Allows performing a bill payment operation on the platform. Send the request bod
                 - `message`: String representing the message (required)
+### Test Data
+Use the following example values to test this endpoint in the QA environment:
+| Field | Example Value |
+|-------|---------------|
+| productId | 1014005 |
+| data.cellphone | "3104784242" |
+| data.email | "fake@refacil.com" |
 **Parámetros:**
 | Name | Type | Description |
@@ -4324,7 +2342,7 @@ Allows performing a bill payment operation on the platform. Send the request bod
 | data | object | Campo del body: data |
 | productId | number | Campo del body: productId |
-### `product_directtv_go_1014004`
+### `product_directtv_go_100777`
 ---
@@ -4411,6 +2429,16 @@ Allows performing a bill payment operation on the platform. Send the request bod
                 - `message`: String representing the message (required)
+### Test Data
+Use the following example values to test this endpoint in the QA environment:
+| Field | Example Value |
+|-------|---------------|
+| productId | 100777 |
+| data.cellphone | "3104784242" |
+| data.email | "fake@refacil.com" |
 **Parámetros:**
 | Name | Type | Description |
@@ -4418,43 +2446,25 @@ Allows performing a bill payment operation on the platform. Send the request bod
 | data | object | Campo del body: data |
 | productId | number | Campo del body: productId |
-### `sell_essa`
+### `product_directtv_go_1014004`
 ---
 ## Description
-Allows performing a sale on the platform. Send the request body with the necessary parameters for the sale in the format specified by the SellBody object. This operation will return a response that includes information about the sale in case of success.
-**Note**: To make this request in the case of selling invoices, we need the hash and hashEchoData provided by the query response for the reference.
-### Timeout Configuration
-The timeout value specified below is directly established by the provider and must be taken into account in integrations.
-| Parameter | Value |
-| --- | --- |
-| **Maximum Timeout** | 150 seconds |
+Allows performing a bill payment operation on the platform. Send the request body with the necessary parameters for the payment in the format specified by the PaymentBody object. The response will include the results of the operation in case of success.
 ---
-## Request Schema
-- `productId`: Number representing the product identifier (required)
-- `amount`: Number representing the amount of the payment. Minimun value: 10,000 (required)
-- `sellType`: String indicating the type of the sell operation (required)
-- `hash`: String containing the hash value for the operation (required)
+## Request Schema
+- `productId`: Number representing the product identifier (required)
 - `data`: Object containing additional data (required)
-    - `reference`: String containing the reference number for the payment (required)
-    - `cellphone`: String containing the cellphone number associated with the payment (required)
+    - `cellphone`: String containing the cellphone number (required)
-    - `hashEchoData`: String containing the hash echo data for the operation (required)
+    - `email`: String containing the email address (required)
 ---
@@ -4523,35 +2533,134 @@ The timeout value specified below is directly established by the provider and mu
                 - `message`: String representing the message (required)
+### Test Data
+Use the following example values to test this endpoint in the QA environment:
+| Field | Example Value |
+|-------|---------------|
+| productId | 1014004 |
+| data.cellphone | "3104784242" |
+| data.email | "fake@refacil.com" |
 **Parámetros:**
 | Name | Type | Description |
 | --- | --- | --- |
-| productId | number | Campo del body: productId |
-| amount | number | Campo del body: amount |
 | data | object | Campo del body: data |
+| productId | number | Campo del body: productId |
-### `sell_energia_emsa`
+### `query_24`
 ---
-## Description
+# Query Product
-Allows performing a bill payment operation on the platform. Send the request body with the necessary parameters for the payment in the format specified by the PaymentBody object. The response will include the results of the operation in case of success.
+---
+### Description
+Performs the pre-sale query for **PIN flows**, obtaining data such as reference, hash, and amount associated with the PIN purchase. The returned `hashEchoData` value must be forwarded in the subsequent sell request when completing the PIN transaction. If the response contains only one of the two hash fields, the API automatically mirrors it to the other.
+If the request fails with the errorCode `product.errors.disabled` or a similar code indicating that the product is inactive, the agreements must be consulted again using the search service.
 ---
-## Request Schema
+### Request Body
-- `productId`: Number representing the product identifier (required)
+- **`productId`** (number) **required** – Identifier of the product to query.
-- `amount`: Number representing the amount of the payment (required)
+- **`queryType`** (string) **required** – Type of query associated with the PIN flow.
+    Example: `ConfirmData`. Min length: 1.
-- `data`: Object containing additional data (required)
+- **`data`** (object) **required** – Specific provider data for the PIN flow.
-    - `cellphone`: String containing the cellphone number (required)
+    - **`reference`** (string) **required** – Reference associated with the PIN transaction.
-    - `reference`: String containing the reference number for the payment (required)
+    - **`cellphone`** (string) **required** – Cellphone number associated with the PIN transaction.
+    - **`amount`** (number) **required** – Amount of the PIN purchase.
+    - **`carrierId`** (number) **required** – Identifier of the carrier/operator.
+        This field **must have the same value as** **`productId`**.
+---
+### Error Codes
+| HTTP | `errorCode` | Message | Condition |
+| --- | --- | --- | --- |
+| 400 | `validators.productId.number` | `El campo productId debe ser de tipo Numerico` | `productId` is absent or not numeric |
+| 400 | `validators.queryType.required` | `El campo queryType es obligatorio.` | `queryType` is absent |
+| 400 | `validators.queryType.isString` | `El campo queryType debe ser de tipo string` | `queryType` is not a string |
+| 400 | `validators.queryType.isNotEmpty` | `El campo queryType no puede estar vacío.` | `queryType` is empty or whitespace-only |
+| 400 | — | `data must be an object` | `data` is present but not an object |
+| 400 | — | `ownAgreementId must be a number` | `ownAgreementId` is present but not a number |
+| 404 | `products.errors.notFound` / `product.not.found` | `Producto no encontrado` | Product does not exist or is unavailable |
+| 404 | `products.errors.disabled` | `Producto deshabilitado` | Product is disabled — re-fetch agreements using the search service |
+| 404 | `products.errors.providers.notFound` | `El producto no tiene un proveedor.` | No provider associated with the product |
+| 400 | `products.errors.metadata.invalid` | `Los metadatos del convenio no tienen un formato válido` | Agreement metadata is invalid |
+| 400 | `overdue.reference` | `Esta referencia ya se encuentra vencida.` | Reference is overdue — do not retry with same reference |
+| 400 | `closed.reference` | `Esta referencia ya se encuentra cerrada.` | Reference is closed |
+| 401 | `error.auth.failed` | `Error en la autenticación` | Invalid or expired authentication token. Re-authenticate and retry the request. |
+**Important:** This request will be processed within a timeout of **30,000 milliseconds (30 seconds)**.
+### Test Data
+Use the following example values to test this endpoint in the QA environment:
+| Field | Example Value |
+|-------|---------------|
+| queryType | "ConfirmData" |
+| productId | 231 |
+| data.carrierId | 231 |
+| data.cellphone | "3203550000" |
+| data.amount | 10000 |
+| data.reference | "1234567" |
+**Parámetros:**
+| Name | Type | Description |
+| --- | --- | --- |
+| queryType | string | Campo del body: queryType |
+| productId | number | Campo del body: productId |
+| data | object | Campo del body: data |
+| ownAgreementId | null | Campo del body: ownAgreementId |
+### `sell`
+---
+## Description
+Allows performing a sale on the platform. Send the request body with the necessary parameters for the sale in the format specified by the SellBody object. This operation will return a response that includes information about the sale in case of success.
+**Note**: To make this request in the case of selling invoices, we need the hash and hashEchoData provided by the query response for the reference.
+### Timeout Configuration
+The timeout value specified below is directly established by the provider and must be taken into account in integrations.
+| Parameter | Value |
+| --- | --- |
+| **Maximum Timeout** | 150 seconds |
+---
+### Request Schema
+- **`productId`**: Number representing the product identifier (**required**).
+- **`amount`**: Number representing the amount of the payment. **Minimum value: 10,000** (**required**).
+- **`data`**: Object containing additional data (**required**):
+  - **`plan`**: String that identifies the type of plan for the payment (**required**).
+    The value must indicate whether the plan includes public lighting or not:
+    - `AP`: Plan **with** public lighting (_Alumbrado público_).
+    - `SP`: Plan **without** public lighting (_Sin alumbrado público_).
+  - **`reference`**: String containing the reference number for the payment (**required**).
+  - **`cellphone`**: String containing the cellphone number associated with the payment (**required**).
+  - **`hashEchoData`**: String containing the hash echo data for the operation (**required**).
 ---
@@ -4620,6 +2729,19 @@ Allows performing a bill payment operation on the platform. Send the request bod
                 - `message`: String representing the message (required)
+### Test Data
+Use the following example values to test this endpoint in the QA environment:
+| Field | Example Value |
+|-------|---------------|
+| productId | 231 |
+| amount | 10000 |
+| data.plan | "AP" |
+| data.reference | "1234567" |
+| data.cellphone | "3203550000" |
+| data.hashEchoData | "eyJub21icmVfY2xpZW50ZSI6IkVMU1kgU0VyVklDRSIsImRpcmVjY2lvbiI6IlVSQiBWSUxMQSBWSUNUT1JJQSBDQVNBIDEwMyAtIFNBTiBNQVJUSU4iLCJkbmlfY2xpZW50ZSI6IjM5MDIyMDMxIiwiY29udHJhdG8iOiIxMjM0NTY3IiwidmFsb3JfdmVudGEiOiIxMDAwMCIsInBsYW4iOiIiLCJ0eXBlIjoiIn0=" |
 **Parámetros:**
 | Name | Type | Description |
@@ -4627,44 +2749,148 @@ Allows performing a bill payment operation on the platform. Send the request bod
 | productId | number | Campo del body: productId |
 | amount | number | Campo del body: amount |
 | data | object | Campo del body: data |
+| sellType | string | Campo del body: sellType |
+| hash | string | Campo del body: hash |
-### `product_energia_prepago_epm`
+### `query_26`
 ---
-## Description
-Allows performing a custom query on the platform. Send the request body with the necessary parameters for the query in the format specified by the QueryBody object. The response will include the results of the query in case of success.
+# Query Product
-### Timeout Configuration
+---
-The timeout value specified below is directly established by the provider and must be taken into account in integrations.
+### Description
-| Parameter | Value |
-|-----------|-------|
-| **Maximum Timeout** | 150 seconds |
+Performs the pre-sale query for **PIN flows**, obtaining data such as reference, hash, and amount associated with the PIN purchase. The returned `hashEchoData` value must be forwarded in the subsequent sell request when completing the PIN transaction. If the response contains only one of the two hash fields, the API automatically mirrors it to the other.
+If the request fails with the errorCode `product.errors.disabled` or a similar code indicating that the product is inactive, the agreements must be consulted again using the search service.
 ---
-## Request Schema
+### Request Body
-- `queryType`: String representing the type of query (required)
+- **`productId`** (number) **required** – Identifier of the product to query.
-- `productId`: Number representing the product identifier (required)
-- `amount`: Number representing the amount for the query (required)
+- **`queryType`** (string) **required** – Type of query associated with the PIN flow.
+    Example: `ConfirmData`. Min length: 1.
-- `data`: Object containing additional data (required)
+- **`data`** (object) **required** – Specific provider data for the PIN flow.
-    - `carrierId`: Number representing the carrier identifier (required)
+    - **`reference`** (string) **required** – Reference associated with the PIN transaction.
-    - `cellphone`: String containing the cellphone number (required)
+    - **`cellphone`** (string) **required** – Cellphone number associated with the PIN transaction.
-    - `reference`: String containing the reference number for the query (required)
+    - **`amount`** (number) **required** – Amount of the PIN purchase.
-    - `method`: String representing the method of the query (required)
+    - **`carrierId`** (number) **required** – Identifier of the carrier/operator.
+        This field **must have the same value as** **`productId`**.
+    - **`plan`** (string) **required** – Identifies the type of plan associated with the transaction.
+        Allowed values:
+        - `AP`: Plan with public lighting (_Alumbrado público_).
+        - `SP`: Plan without public lighting (_Sin alumbrado público_).
+    - **`type`** (string) **required** – Identifies the type of payment.
+        Allowed values:
+        - `PT`: Total payment (_Pago Total_).
+        - `PM`: Minimum payment (_Pago Mínimo_).
+---
+### Error Codes
+| HTTP | `errorCode` | Message | Condition |
+| --- | --- | --- | --- |
+| 400 | `validators.productId.number` | `El campo productId debe ser de tipo Numerico` | `productId` is absent or not numeric |
+| 400 | `validators.queryType.required` | `El campo queryType es obligatorio.` | `queryType` is absent |
+| 400 | `validators.queryType.isString` | `El campo queryType debe ser de tipo string` | `queryType` is not a string |
+| 400 | `validators.queryType.isNotEmpty` | `El campo queryType no puede estar vacío.` | `queryType` is empty or whitespace-only |
+| 400 | — | `data must be an object` | `data` is present but not an object |
+| 400 | — | `ownAgreementId must be a number` | `ownAgreementId` is present but not a number |
+| 404 | `products.errors.notFound` / `product.not.found` | `Producto no encontrado` | Product does not exist or is unavailable |
+| 404 | `products.errors.disabled` | `Producto deshabilitado` | Product is disabled — re-fetch agreements using the search service |
+| 404 | `products.errors.providers.notFound` | `El producto no tiene un proveedor.` | No provider associated with the product |
+| 400 | `products.errors.metadata.invalid` | `Los metadatos del convenio no tienen un formato válido` | Agreement metadata is invalid |
+| 400 | `overdue.reference` | `Esta referencia ya se encuentra vencida.` | Reference is overdue — do not retry with same reference |
+| 400 | `closed.reference` | `Esta referencia ya se encuentra cerrada.` | Reference is closed |
+| 401 | `error.auth.failed` | `Error en la autenticación` | Invalid or expired authentication token. Re-authenticate and retry the request. |
+**Important:** This request will be processed within a timeout of **30,000 milliseconds (30 seconds)**.
+### Test Data
+Use the following example values to test this endpoint in the QA environment:
+| Field | Example Value |
+|-------|---------------|
+| queryType | "ConfirmData" |
+| productId | 230 |
+| data.carrierId | 230 |
+| data.cellphone | "3203550000" |
+| data.amount | 10000 |
+| data.reference | "1234567" |
+| data.plan | "AP" |
+| data.type | "PT" |
+**Parámetros:**
+| Name | Type | Description |
+| --- | --- | --- |
+| queryType | string | Campo del body: queryType |
+| productId | number | Campo del body: productId |
+| data | object | Campo del body: data |
+| ownAgreementId | null | Campo del body: ownAgreementId |
+### `sell_27`
+---
+## Description
+Allows performing a sale on the platform. Send the request body with the necessary parameters for the sale in the format specified by the SellBody object. This operation will return a response that includes information about the sale in case of success.
+**Note**: To make this request in the case of selling invoices, we need the hash and hashEchoData provided by the query response for the reference.
+### Timeout Configuration
+The timeout value specified below is directly established by the provider and must be taken into account in integrations.
+| Parameter | Value |
+| --- | --- |
+| **Maximum Timeout** | 150 seconds |
+---
+### Request Schema
+- **`productId`** (number) **required** – Identifier of the product.
+- **`amount`** (number) **required** – Amount of the payment.
+  **Minimum value: 10,000**.
+- **`hash`** (string) **required** – Hash value for the operation.
+- **`data`** (object) **required** – Additional data for the payment.
+  - **`reference`** (string) **required** – Reference number for the payment.
+  - **`cellphone`** (string) **required** – Cellphone number associated with the payment.
+  - **`hashEchoData`** (string) **required** – Hash echo data for the operation.
+  - **`plan`** (string) **required** – Identifies the type of plan associated with the transaction.
+    Allowed values:
+    - `AP`: Plan with public lighting (_Alumbrado público_).
+    - `SP`: Plan without public lighting (_Sin alumbrado público_).
+  - **`type`** (string) **required** – Identifies the type of payment.
+    Allowed values:
+    - `PT`: Total payment (_Pago Total_).
+    - `PM`: Minimum payment (_Pago Mínimo_).
+  - **`valorAseo`** (number) **required** – Cleaning/garbage charge amount associated with the transaction.
+    This value **must be taken from the response of the previous `query` operation**.
+  - **`valorEnergia`** (number) **required** – Energy charge amount associated with the transaction.
+    This value **must be taken from the response of the previous `query` operation**.
 ---
@@ -4732,16 +2958,33 @@ The timeout value specified below is directly established by the provider and mu
                 - `message`: String representing the message (required)
+### Test Data
+Use the following example values to test this endpoint in the QA environment:
+| Field | Example Value |
+|-------|---------------|
+| productId | 230 |
+| amount | 10000 |
+| data.cellphone | "3203550000" |
+| data.plan | "AP" |
+| data.reference | "1234567" |
+| data.type | "PT" |
+| data.valorAseo | 5000 |
+| data.valorEnergia | 5000 |
+| data.hashEchoData | "eyJub21icmVfY2xpZW50ZSI6IkVMU1kgU0VyVklDRSIsImRpcmVjY2lvbiI6IlVSQiBWSUxMQSBWSUNUT1JJQSBDQVNBIDEwMyAtIFNBTiBNQVJUSU4iLCJkbmlfY2xpZW50ZSI6IjM5MDIyMDMxIiwiY29udHJhdG8iOiIxMjM0NTY3IiwidmFsb3JfdmVudGEiOiIxMDAwMCIsInZhbG9yX2FzZW8iOjUwMDAsInZhbG9yX2VuZXJnaWEiOjUwMDAsImNlbHVsYXIiOiIzMjAzNTUwMDAwIiwiaWRDb25maXJtYWNpb24iOiJzZGpha3NkamRqYS1kYXMwZGRhbnNkMDItZnNhZGthc2RrNTYiLCJwbGFuIjoiQVAiLCJ0eXBlIjoiUFQifQ==" |
 **Parámetros:**
 | Name | Type | Description |
 | --- | --- | --- |
-| queryType | string | Campo del body: queryType |
 | productId | number | Campo del body: productId |
 | amount | number | Campo del body: amount |
 | data | object | Campo del body: data |
+| sellType | string | Campo del body: sellType |
+| hash | string | Campo del body: hash |
-### `query_63`
+### `query_28`
 Here you will find all the endpoints related to Transfiya correspondent selling.
@@ -4989,6 +3232,34 @@ curl --location --globoff 'https://acme.refacil.local/transfiYaNotifications' \
 **Step 9: Transaction marked as failed:** If the transaction status changes to "REJECTED," the transaction is officially marked as failed within the system.
+---
+## Request Schema
+- `productId`: Number representing the product identifier (required)
+- `amount`: Number representing the transaction amount in cents (required)
+- `webhookUrl`: String containing the URL to receive transaction status notifications (required)
+- `data`: Object containing additional transaction data (required)
+    - `cellphone`: String containing the customer's cellphone number (required)
+    - `bankName`: String containing the target bank name (required)
+---
+### Test Phone Numbers
+Use the following phone numbers to simulate successful or failed withdrawal transactions in the testing environment:
+| Phone Number | Expected Result |
+|--------------|----------------|
+| 3051000090   | Successful      |
+| 3051000080   | Failed          |
 **Parámetros:**
 | Name | Type | Description |
@@ -5145,6 +3416,34 @@ Automatically rejected: 3002491283
 - **No commission processing**: Since the transaction failed, no commissions are processed for this transaction.
+---
+## Request Schema
+- `productId`: Number representing the product identifier (required)
+- `amount`: Number representing the deposit amount in cents (required)
+- `webhookUrl`: String containing the URL to receive transaction status notifications (required)
+- `data`: Object containing additional transaction data (required)
+    - `cellphone`: String containing the customer's cellphone number (required)
+    - `bankName`: String containing the target bank name for the deposit (required)
+---
+### Test Phone Numbers
+Use the following phone numbers to simulate successful or failed deposit transactions in the testing environment:
+| Phone Number | Expected Result |
+|--------------|----------------|
+| 3051000002   | Successful      |
+| 3002491283   | Failed          |
 **Parámetros:**
 | Name | Type | Description |
@@ -5160,6 +3459,48 @@ Here you will find all the endpoints related to multi-product sales.
 **Note:** If you need information about parameterized commissions, you should consult your sales agent.
+---
+### Sell — Error Codes
+The following error codes apply to all sell operations regardless of product type.
+---
+#### POST /sells/sell
+| HTTP | `errorCode` | Message | Condition |
+|------|-------------|---------|----------|
+| 400 | `validators.productId.required` | `El campo productId es obligatorio.` | `productId` is absent |
+| 400 | `validators.productId.number` | `El campo productId debe ser de tipo Numerico` | `productId` is not a number |
+| 400 | — | `data must be an object` | `data` is absent or not an object |
+| 400 | `validators.moveTmpBalance.isBoolean` | `El campo moveTmpBalance debe ser de tipo boolean.` | `moveTmpBalance` is present but not a boolean |
+| 400 | `validators.sellType.isString` / `validators.sellType.isNotEmpty` | `El campo sellType debe ser de tipo string` / `El campo sellType no puede estar vacío.` | `sellType` is present but invalid |
+| 400 | `validators.hash.isString` / `validators.hash.isNotEmpty` | `El campo hash debe ser de tipo string` / `El campo hash no puede estar vacío.` | `hash` is present but invalid |
+| 400 | `validators.webhookUrl.isString` / `validators.webhookUrl.isNotEmpty` | `El campo webhookUrl debe ser de tipo string` / `El campo webhookUrl no puede estar vacío.` | `webhookUrl` is present but invalid |
+| 400 | `validators.terminalId.isNumber` | `El ID de terminal debe ser un valor numérico.` | `terminalId` is present but not numeric |
+| 400 | `validators.commerceId.isNumber` | `El ID de comercio debe ser un valor numérico.` | `commerceId` is present but not numeric |
+| 400 | `validators._password.isString` | `El campo _password debe ser de tipo string` | `_password` is present but not a string |
+| 400 | — | `expiresIn must be a number` | `expiresIn` is present but not a number |
+| 404 | `product.not.found` / `products.errors.notFound` | `Producto no encontrado` | Product does not exist |
+| 404 | `products.errors.disabled` | `Producto deshabilitado` | Product is disabled |
+| 404 | `products.errors.providers.notFound` | `El producto no tiene un proveedor.` | No provider associated with the product |
+| 400 | `products.errors.userBalance` | `El usuario no cuenta con saldo para la transacción` | Insufficient balance |
+| 400 | `products.errors.transactionDuplicate` | `Transacción duplicada` | Duplicate transaction detected — do not retry |
+| 400 | `server.error.core` | `Solicitud duplicada. Por favor, inténtelo de nuevo.` | Request already in progress — retry after a few seconds |
+| 400 | `products.errors.blacklisted` | `Al parecer estás siendo victima de hurto, hemos bloqueado tu cuenta por seguridad` | Reference number is on a security blacklist — do not retry |
+| 400 | `AMOUNT_OUT_OF_RANGE` | `El monto debe ser mayor o igual a {min}` / `menor o igual a {max}` | Amount is outside the allowed range for the product |
+| 401 | `error.auth.failed` | `Error en la autenticación` | Invalid or expired authentication token. Re-authenticate and retry the request. |
+---
+#### GET /sells/sale/:saleId
+| HTTP | `errorCode` | Message | Condition |
+|------|-------------|---------|----------|
+| 404 | `server.notFound` | `Nada encontrado` | Sale not found or does not belong to the authenticated user |
+| 401 | `error.auth.failed` | `Error en la autenticación` | Invalid or expired authentication token. Re-authenticate and retry the request. |
  ---
 ## Description
@@ -5207,111 +3548,6 @@ This method allows you to obtain the details of a sale by providing the unique i
 | hash | string | Campo del body: hash |
 | data | object | Campo del body: data |
-### `bank_get_transfiya_banks`
----
-### Description
-Return the banks that support Transfiya for the specified transfer type.
-Below is a list of authorized banks:
-| BANK | LOGO |
-| --- | --- |
-| BANCOLOMBIA | <img src="https://assets.refacil.co/banks/bancolombia.png" alt=""> |
-| BANCO AGRARIO | <img src="https://assets.refacil.co/banks/bancoagrario.png" alt=""> |
-| BANCO AV VILLAS | <img src="https://assets.refacil.co/banks/bancoavvillas.png" alt=""> |
-| BANCO CAJA SOCIAL | <img src="https://assets.refacil.co/banks/bancocajasocial.png" alt=""> |
-| BANCO COOPERATIVO COOPCENTRAL | <img src="https://assets.refacil.co/banks/bancocooperativocoopcentral.png" alt=""> |
-| BANCO DAVIVIENDA | <img src="https://assets.refacil.co/banks/bancodavivienda.png" alt=""> |
-| BANCO DE BOGOTA | <img src="https://assets.refacil.co/banks/bancodebogota.png" alt=""> |
-| BANCO DE OCCIDENTE | <img src="https://assets.refacil.co/banks/bancodeoccidente.png" alt=""> |
-| BANCO ITAU | <img src="https://assets.refacil.co/banks/itau.png" alt=""> |
-| BANCO SERFINANZA | <img src="https://assets.refacil.co/banks/bancoserfinanza.png" alt=""> |
-| CONFIAR COOPERATIVA FINANCIERA | <img src="https://assets.refacil.co/banks/confiarcooperativafinanciera.png" alt=""> |
-| DALE | <img src="https://assets.refacil.co/banks/dale.png" alt=""> |
-| DAVIPLATA | <img src="https://assets.refacil.co/banks/daviplata.png" alt=""> |
-| MOVII S.A. | <img src="https://assets.refacil.co/banks/movii.png" alt=""> |
-| NEQUI | <img src="https://assets.refacil.co/banks/nequi.png" alt=""> |
-| SCOTIABANK COLPATRIA | <img src="https://assets.refacil.co/banks/scotiabankcolpatria.png" alt=""> |
-| BANCAMIA SA | <img src="https://assets.refacil.co/banks/bancamia.png" alt=""> |
----
-### Response schema
-- `messageCode`: String code indicating the operation result (required)
-- `message`: String containing a message about the operation result (required)
-- data: Object containing additional response data (required)
-    - `banks`: Array of bank objects (required)
-        - `label`: String representing the bank label (required)
-        - `value`: Number representing the bank value (required)
-        - `image`: String representing the bank image filename (required)
-### `requirement_terms_and_conditions`
----
-### Description
-Get privacy policy, terms and conditions and data treatment policy, then confirm them in the /requirement/confirm-terms-and-conditions service.
----
-### Request Body
-This endpoint does not require a request body.
----
-### Response
-- `message`: String containing a message about the operation result (required)
-- `messageCode`: String code indicating the operation result (required)
-- `data`: Object containing additional response data (required)
-### `requirement_con_ter_and_conditions`
----
-### Description
-It allows you to transfer funds from the main users money bag to the bag of the user who is being added. The token of the user who will be the beneficiary and the amount must be added.
----
-### Request Body
-- userToken (string, required): The user token for which the balance will be updated
-- amount (number, required): Amount to be updated
----
-### Response
-- `message`: String containing a message about the operation result (required)
-- `messageCode`: String code indicating the operation result (required)
-- `data`: Object containing additional response data.
-**Parámetros:**
-| Name | Type | Description |
-| --- | --- | --- |
-| checkDataTreatment | boolean | Campo del body: checkDataTreatment |
 ### `collection_submit_transaction`
 ---
@@ -5341,6 +3577,17 @@ This endpoint is in charge of reporting the collections
 - `code`: Respond correctly in case of success
+---
+### Error Codes
+| HTTP | `errorCode` | Message | Condition |
+|------|-------------|---------|----------|
+| 400 | — | `{field} must be a number` | A required numeric field (`id_cliente`, `id_transaccion`, `convenio`, `Valor`) is absent or not numeric |
+| 400 | — | `{field} must be a string` | A required string field (`Fecha`, `Hora`) is absent or not a string |
+| 401 | `error.auth.failed` | `Error en la autenticación` | Invalid or expired authentication token. Re-authenticate and retry the request. |
+| 500 | `server.error` | `Mensaje del error interno` or `Critical internal server error occurred!` | Internal failure when registering the transaction — retry; if it persists, notify support |
 **Parámetros:**
 | Name | Type | Description |