refacil-commerce-mcp 1.0.8 → 1.0.10

package/README.md

@@ -4,7 +4,7 @@ Servidor MCP (Model Context Protocol) generado automáticamente para la API refa
 
 ## 🚀 Características
 
-- **33 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
@@ -858,67 +858,19 @@ The response will include the results of the query in case of success.
 | 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.
+### `query`
 
-**Parámetros:**
+**Important:** This request will be processed within a timeout of **30,000 milliseconds (30 seconds)**.
 
-| 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 |
+### Test Data
 
-### `query`
+Use the following example values to test this endpoint in the QA environment:
 
-**Important:** This request will be processed within a timeout of **30,000 milliseconds (30 seconds)**.
+| Field | Example Value |
+|-------|---------------|
+| productId | 1587 |
+| queryType | "BILLData" |
+| data.reference | "63440172" |
 
 **Parámetros:**
 
@@ -1026,6 +978,20 @@ 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 |
@@ -1095,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 |
@@ -1197,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 |
@@ -1331,6 +1339,18 @@ The following payload is required for performing a custom query:
 
 **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 |
+|-------|---------------|
+| productId | 1014006 |
+| documentType | 1 |
+| document | "1032363500" |
+| queryType | "SOATFullData" |
+| license | "XAZ975" |
+
 **Parámetros:**
 
 | Name | Type | Description |
@@ -1423,6 +1443,16 @@ The following payload is required for performing a custom query:
     
 - `license`: (string, required) The license plate of the vehicle.
 
+### Test Data
+
+Use the following example values to test this endpoint in the QA environment:
+
+| Field | Example Value |
+|-------|---------------|
+| productId | 1014006 |
+| queryType | "SOATPolicy" |
+| license | "XAZ975" |
+
 **Parámetros:**
 
 | Name | Type | Description |
@@ -1911,6 +1941,87 @@ 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. **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.
 
+### Test Data
+
+Use the following example values to test this endpoint in the QA environment:
+
+| Field | Example Value |
+|-------|---------------|
+| productId | 1014006 |
+| amount | 1413550 |
+| data.license | "ABC123" |
+| data.productId | 1014006 |
+| data.cellphone | "3001234567" |
+| data.document | "1111111" |
+| data.terminal.id | "123456" |
+| data.amount.TariffCode | "920" |
+| data.amount.InsurancePremium | 907900 |
+| data.amount.InsuranceTax | 453950 |
+| data.amount.InsuranceFine | 1700 |
+| data.amount.Total | 1363550 |
+| data.amount.TotalWithDiscountAmount | 1363550 |
+| data.amount.DiscountAmount | 0 |
+| data.amount.ElectricDiscount | 0 |
+| data.amount.PercentageElectricDiscount | 0 |
+| data.amount.InsurancePremiumFormatted | "$907.900" |
+| data.amount.InsuranceTaxFormatted | "$453.950" |
+| data.amount.InsuranceFineFormatted | "$1.700" |
+| data.amount.TotalFormatted | "$1.363.550" |
+| data.amount.DiscountAmountFormatted | "$0" |
+| data.amount.TotalWithDiscountAmountFormatted | "$1.363.550" |
+| data.amount.createdAt | "2020-02-20T10:23:24.000Z" |
+| data.amount.dateStart | "2020-02-20" |
+| data.amount.dateEnd | "2021-02-19" |
+| data.amount.amount | 1413550 |
+| data.amount.amountDiscount | 0 |
+| data.amount.amountOthers | 50000 |
+| data.amount.amountTotal | 1413550 |
+| data.amount.hash | "ba931ea8d2b57c9248ec4285c45efdddfdfff4d8" |
+| data.amount.runt | 1700 |
+| data.amount.codeFasecolda | 0 |
+| data.amount.typeCost | 0 |
+| data.amount.Law2161Discount | 0 |
+| data.amount.discount | 0 |
+| data.vehDetail.vehicleLineId | 5560 |
+| data.vehDetail.vehicleClassId | 8 |
+| data.vehDetail.vehicleClassMinistryId | 28 |
+| data.vehDetail.serviceTypeId | 2 |
+| data.vehDetail.vehicleBodyTypeId | 8 |
+| data.vehDetail.vehicleDescription | "NISSAN URVAN - 2012" |
+| data.vehDetail.vehDescription | "NISSAN URVAN - 2012" |
+| data.vehDetail.queryId | "" |
+| data.vehDetail.noSerie | "" |
+| data.vehDetail.noMotor | "Z0796987CM" |
+| data.vehDetail.noChasis | "JN1MG4E25Z0796987" |
+| data.vehDetail.cc | 2953 |
+| data.vehDetail.type | "CERRADA" |
+| data.vehDetail.gas | "" |
+| data.vehDetail.year | 2012 |
+| data.vehDetail.passengers | 16 |
+| data.vehDetail.brand | "NISSAN" |
+| data.vehDetail.brandId | 64 |
+| data.vehDetail.vin | "JN1MG4E25Z0796987" |
+| data.vehDetail.lineCode | "" |
+| data.vehDetail.service | "" |
+| data.vehDetail.zone | "" |
+| data.vehDetail.weight | 0 |
+| data.vehDetail.cityId | 5266 |
+| data.userDetail.name | "Nombre" |
+| data.userDetail.lastName | "Apellido" |
+| data.userDetail.docNumber | "1111111" |
+| data.userDetail.cellphone | "3001234567" |
+| data.userDetail.email | "contacto@gmail.com" |
+| data.userDetail.phone | "" |
+| data.userDetail.docType | 1 |
+| data.userDetail.address | "Calle 1 # 1 - 01" |
+| data.userDetail.cityCode | 76834 |
+| data.userDetail.stateCode | 76 |
+| data.userDetail.addressType | 1 |
+| data.userDetail.typePerson | "F" |
+| data.userDetail.gender | "M" |
+| data.userDetail.RegimenTypeId | "2" |
+| data.userDetail.RutId | 5 |
+
 **Parámetros:**
 
 | Name | Type | Description |
@@ -1927,6 +2038,40 @@ Allows performing a sale on the platform. Send the request body with the necessa
 
 **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 payment amount (required)
+    
+- `data`: Object containing additional transaction data (required)
+    
+    - `cellphone`: String containing the customer's cellphone number (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)
+        
+
+---
+
+### Test Data
+
+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 |
@@ -1945,6 +2090,28 @@ Allows performing a sale on the platform. Send the request body with the necessa
 
 **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 transaction data (required)
+    
+    - `cellphone`: String containing the customer's cellphone number (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 |
@@ -2044,6 +2211,16 @@ Allows performing a bill payment operation on the platform. Send the request bod
 
 **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 | 50 |
+| amount | 1000 |
+| data.cellphone | "3015874044" |
+
 **Parámetros:**
 
 | Name | Type | Description |
@@ -2145,6 +2322,17 @@ Allows performing a sale on the platform. Send the request body with the necessa
 
 **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 |
@@ -2240,6 +2428,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 |
@@ -2334,6 +2532,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 |
@@ -2428,6 +2636,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 | 1014004 |
+| data.cellphone | "3104784242" |
+| data.email | "fake@refacil.com" |
+
 **Parámetros:**
 
 | Name | Type | Description |
@@ -2435,7 +2653,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 |
 
-### `query_25`
+### `query_24`
 
 ---
 
@@ -2492,6 +2710,19 @@ If the request fails with the errorCode `product.errors.disabled` or a similar c
 
 **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 |
@@ -2601,6 +2832,19 @@ 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 | 231 |
+| amount | 10000 |
+| data.plan | "AP" |
+| data.reference | "1234567" |
+| data.cellphone | "3203550000" |
+| data.hashEchoData | "eyJub21icmVfY2xpZW50ZSI6IkVMU1kgU0VyVklDRSIsImRpcmVjY2lvbiI6IlVSQiBWSUxMQSBWSUNUT1JJQSBDQVNBIDEwMyAtIFNBTiBNQVJUSU4iLCJkbmlfY2xpZW50ZSI6IjM5MDIyMDMxIiwiY29udHJhdG8iOiIxMjM0NTY3IiwidmFsb3JfdmVudGEiOiIxMDAwMCIsInBsYW4iOiIiLCJ0eXBlIjoiIn0=" |
+
 **Parámetros:**
 
 | Name | Type | Description |
@@ -2611,7 +2855,7 @@ The timeout value specified below is directly established by the provider and mu
 | sellType | string | Campo del body: sellType |
 | hash | string | Campo del body: hash |
 
-### `query_27`
+### `query_26`
 
 ---
 
@@ -2680,6 +2924,21 @@ If the request fails with the errorCode `product.errors.disabled` or a similar c
 
 **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 |
@@ -2689,7 +2948,7 @@ If the request fails with the errorCode `product.errors.disabled` or a similar c
 | data | object | Campo del body: data |
 | ownAgreementId | null | Campo del body: ownAgreementId |
 
-### `sell_28`
+### `sell_27`
 
 ---
 
@@ -2802,6 +3061,22 @@ 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 |
@@ -2812,7 +3087,7 @@ The timeout value specified below is directly established by the provider and mu
 | sellType | string | Campo del body: sellType |
 | hash | string | Campo del body: hash |
 
-### `query_29`
+### `query_28`
 
 Here you will find all the endpoints related to Transfiya correspondent selling.
 
@@ -3060,6 +3335,23 @@ 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
@@ -3227,6 +3519,23 @@ 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