digital_femsa 1.0.0 → 1.1.0

data/docs/TaxesApi.md

@@ -15,7 +15,7 @@ All URIs are relative to *https://api.digitalfemsa.io*
 
 Create Tax
 
-Create new taxes for an existing orden
+Creates a new tax line for an existing order. The tax line is added to the order identified by `id`. The response returns the created tax line.
 
 ### Examples
 
@@ -30,7 +30,7 @@ end
 
 api_instance = DigitalFemsa::TaxesApi.new
 id = '6307a60c41de27127515a575' # String | Identifier of the resource
-order_tax_request = DigitalFemsa::OrderTaxRequest.new({amount: 100, description: 'testing'}) # OrderTaxRequest | requested field for a taxes
+order_tax_request = DigitalFemsa::OrderTaxRequest.new({amount: 100, description: 'testing'}) # OrderTaxRequest | Request body for creating a tax line.
 opts = {
   accept_language: 'es', # String | Use for knowing which language to use
   x_child_company_id: '6441b6376b60c3a638da80af' # String | In the case of a holding company, the company id of the child company to which will process the request.
@@ -68,7 +68,7 @@ end
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
 | **id** | **String** | Identifier of the resource |  |
-| **order_tax_request** | [**OrderTaxRequest**](OrderTaxRequest.md) | requested field for a taxes |  |
+| **order_tax_request** | [**OrderTaxRequest**](OrderTaxRequest.md) | Request body for creating a tax line. |  |
 | **accept_language** | **String** | Use for knowing which language to use | [optional][default to 'es'] |
 | **x_child_company_id** | **String** | In the case of a holding company, the company id of the child company to which will process the request. | [optional] |
 
@@ -92,7 +92,7 @@ end
 
 Delete Tax
 
-Delete taxes for an existing orden
+Deletes an existing tax line from an order. The tax line identified by `tax_id` belongs to the order identified by `id`. The response includes the deleted resource with `deleted: true`.
 
 ### Examples
 
@@ -169,7 +169,7 @@ end
 
 Update Tax
 
-Update taxes for an existing orden
+Updates an existing tax line for an order. The tax line identified by `tax_id` belongs to the order identified by `id`. Only the fields provided in the request body are updated.
 
 ### Examples
 
@@ -185,7 +185,7 @@ end
 api_instance = DigitalFemsa::TaxesApi.new
 id = '6307a60c41de27127515a575' # String | Identifier of the resource
 tax_id = 'tax_lin_2tQ974hSHcsdeSZHG' # String | identifier
-update_order_tax_request = DigitalFemsa::UpdateOrderTaxRequest.new # UpdateOrderTaxRequest | requested field for taxes
+update_order_tax_request = DigitalFemsa::UpdateOrderTaxRequest.new # UpdateOrderTaxRequest | Request body for updating a tax line.
 opts = {
   accept_language: 'es', # String | Use for knowing which language to use
   x_child_company_id: '6441b6376b60c3a638da80af' # String | In the case of a holding company, the company id of the child company to which will process the request.
@@ -224,7 +224,7 @@ end
 | ---- | ---- | ----------- | ----- |
 | **id** | **String** | Identifier of the resource |  |
 | **tax_id** | **String** | identifier |  |
-| **update_order_tax_request** | [**UpdateOrderTaxRequest**](UpdateOrderTaxRequest.md) | requested field for taxes |  |
+| **update_order_tax_request** | [**UpdateOrderTaxRequest**](UpdateOrderTaxRequest.md) | Request body for updating a tax line. |  |
 | **accept_language** | **String** | Use for knowing which language to use | [optional][default to 'es'] |
 | **x_child_company_id** | **String** | In the case of a holding company, the company id of the child company to which will process the request. | [optional] |
 

data/docs/TransactionResponse.md

@@ -4,17 +4,20 @@
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
+| **id** | **String** | Unique identifier of the transaction. |  |
+| **object** | **String** | Object name, which is transaction. |  |
 | **amount** | **Integer** | The amount of the transaction. |  |
-| **charge** | **String** | Randomly assigned unique order identifier associated with the charge. |  |
-| **created_at** | **Integer** | Date and time of creation of the transaction in Unix format. |  |
-| **currency** | **String** | The currency of the transaction. It uses the 3-letter code of the [International Standard ISO 4217.](https://es.wikipedia.org/wiki/ISO_4217) |  |
 | **fee** | **Integer** | The amount to be deducted for taxes and commissions. |  |
-| **id** | **String** | Unique identifier of the transaction. |  |
-| **livemode** | **Boolean** | Indicates whether the transaction was created in live mode or test mode. |  |
 | **net** | **Integer** | The net amount after deducting commissions and taxes. |  |
-| **object** | **String** | Object name, which is transaction. |  |
+| **currency** | **String** | The currency of the transaction. It uses the 3-letter code of ISO 4217. |  |
 | **status** | **String** | Code indicating transaction status. |  |
-| **type** | **String** | Transaction Type |  |
+| **type** | **String** | Transaction type. |  |
+| **created_at** | **Integer** | Date and time of creation of the transaction in Unix format. |  |
+| **livemode** | **Boolean** | Indicates whether the transaction was created in live mode or test mode. |  |
+| **charge** | **String** | Charge ID associated with the transaction (present only if the transaction belongs to a charge). | [optional] |
+| **transfer** | **String** | Transfer ID associated with the transaction (present only if the transaction belongs to a transfer). | [optional] |
+| **transferred_at** | **Integer** | Date and time when the transaction was transferred, in Unix format. | [optional] |
+| **formula** | **String** | Transaction fee formula identifier (if available). | [optional] |
 
 ## Example
 
@@ -22,17 +25,20 @@
 require 'digital_femsa'
 
 instance = DigitalFemsa::TransactionResponse.new(
+  id: 5ee7ec5b8dea41085erb7f9e,
+  object: transaction,
   amount: 1000,
-  charge: 5ee7ec58885a45585e6d9f8m,
-  created_at: 1553273553,
-  currency: MXN,
   fee: 560,
-  id: 5ee7ec5b8dea41085erb7f9e,
-  livemode: true,
   net: 440,
-  object: transaction,
+  currency: MXN,
   status: pending,
-  type: capture
+  type: capture,
+  created_at: 1553273553,
+  livemode: true,
+  charge: 5ee7ec58885a45585e6d9f8m,
+  transfer: trf_2tPAmKCEJqh8RE6nY,
+  transferred_at: 1553273999,
+  formula: null
 )
 ```
 

data/docs/TransactionsApi.md

@@ -5,7 +5,7 @@ All URIs are relative to *https://api.digitalfemsa.io*
 | Method | HTTP request | Description |
 | ------ | ------------ | ----------- |
 | [**get_transaction**](TransactionsApi.md#get_transaction) | **GET** /transactions/{id} | Get transaction |
-| [**get_transactions**](TransactionsApi.md#get_transactions) | **GET** /transactions | Get List transactions |
+| [**get_transactions**](TransactionsApi.md#get_transactions) | **GET** /transactions | List transactions |
 
 
 ## get_transaction
@@ -14,7 +14,7 @@ All URIs are relative to *https://api.digitalfemsa.io*
 
 Get transaction
 
-Get the details of a transaction
+Retrieves the details of a transaction by its ID.
 
 ### Examples
 
@@ -87,9 +87,9 @@ end
 
 > <GetTransactionsResponse> get_transactions(opts)
 
-Get List transactions
+List transactions
 
-Get transaction details in the form of a list
+Returns a paginated list of transactions (ledger movements).  A transaction is a movement that represents the financial impact of payment operations, including amounts, fees, and net values. Transactions can be linked to a charge and may be linked to a transfer (payout) when they are included in a payout.  If you need payout-level information (destination, statement reference/description, payout status), use GET /transfers. 
 
 ### Examples
 
@@ -116,7 +116,7 @@ opts = {
 }
 
 begin
-  # Get List transactions
+  # List transactions
   result = api_instance.get_transactions(opts)
   p result
 rescue DigitalFemsa::ApiError => e
@@ -132,7 +132,7 @@ This returns an Array which contains the response data, status code and headers.
 
 ```ruby
 begin
-  # Get List transactions
+  # List transactions
   data, status_code, headers = api_instance.get_transactions_with_http_info(opts)
   p status_code # => 2xx
   p headers # => { ... }

data/docs/TransfersApi.md

@@ -4,17 +4,17 @@ All URIs are relative to *https://api.digitalfemsa.io*
 
 | Method | HTTP request | Description |
 | ------ | ------------ | ----------- |
-| [**get_transfer**](TransfersApi.md#get_transfer) | **GET** /transfers/{id} | Get Transfer |
-| [**get_transfers**](TransfersApi.md#get_transfers) | **GET** /transfers | Get a list of transfers |
+| [**get_transfer**](TransfersApi.md#get_transfer) | **GET** /transfers/{id} | Get transfer |
+| [**get_transfers**](TransfersApi.md#get_transfers) | **GET** /transfers | List transfers |
 
 
 ## get_transfer
 
 > <TransferResponse> get_transfer(id, opts)
 
-Get Transfer
+Get transfer
 
-Get the details of a Transfer
+Retrieves the details of a transfer by its ID.
 
 ### Examples
 
@@ -35,7 +35,7 @@ opts = {
 }
 
 begin
-  # Get Transfer
+  # Get transfer
   result = api_instance.get_transfer(id, opts)
   p result
 rescue DigitalFemsa::ApiError => e
@@ -51,7 +51,7 @@ This returns an Array which contains the response data, status code and headers.
 
 ```ruby
 begin
-  # Get Transfer
+  # Get transfer
   data, status_code, headers = api_instance.get_transfer_with_http_info(id, opts)
   p status_code # => 2xx
   p headers # => { ... }
@@ -87,9 +87,9 @@ end
 
 > <GetTransfersResponse> get_transfers(opts)
 
-Get a list of transfers
+List transfers
 
-Get transfers details in the form of a list
+Returns a paginated list of transfers (payouts/dispersions).  A transfer represents a payout of funds to the merchant (where the money is sent and the payout status). Transfers typically aggregate multiple transactions.  If you need movement-level details (amount/fee/net per operation) or to reconcile charges, use GET /transactions. 
 
 ### Examples
 
@@ -113,7 +113,7 @@ opts = {
 }
 
 begin
-  # Get a list of transfers
+  # List transfers
   result = api_instance.get_transfers(opts)
   p result
 rescue DigitalFemsa::ApiError => e
@@ -129,7 +129,7 @@ This returns an Array which contains the response data, status code and headers.
 
 ```ruby
 begin
-  # Get a list of transfers
+  # List transfers
   data, status_code, headers = api_instance.get_transfers_with_http_info(opts)
   p status_code # => 2xx
   p headers # => { ... }

data/docs/UpdateCustomer.md

@@ -4,18 +4,16 @@
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **antifraud_info** | [**UpdateCustomerAntifraudInfo**](UpdateCustomerAntifraudInfo.md) |  | [optional] |
-| **default_payment_source_id** | **String** | It is a parameter that allows to identify in the response, the Femsa ID of a payment method (payment_id) | [optional] |
-| **email** | **String** | An email address is a series of customizable characters followed by a universal Internet symbol, the at symbol (@), the name of a host server, and a web domain ending (.mx, .com, .org, . net, etc). | [optional] |
-| **name** | **String** | Client's name | [optional] |
-| **phone** | **String** | Is the customer's phone number | [optional] |
-| **default_shipping_contact_id** | **String** | It is a parameter that allows to identify in the response, the Femsa ID of the shipping address (shipping_contact) | [optional] |
-| **corporate** | **Boolean** | It is a value that allows identifying if the email is corporate or not. | [optional][default to false] |
-| **custom_reference** | **String** | It is an undefined value. | [optional] |
-| **fiscal_entities** | [**Array<CustomerFiscalEntitiesRequest>**](CustomerFiscalEntitiesRequest.md) |  | [optional] |
-| **metadata** | **Hash<String, Object>** |  | [optional] |
-| **payment_sources** | [**Array<CustomerPaymentMethodsRequest>**](CustomerPaymentMethodsRequest.md) | Contains details of the payment methods that the customer has active or has used in Femsa | [optional] |
-| **shipping_contacts** | [**Array<CustomerShippingContacts>**](CustomerShippingContacts.md) | Contains the detail of the shipping addresses that the client has active or has used in Femsa | [optional] |
+| **name** | **String** | Customer's name. | [optional] |
+| **email** | **String** | Customer email address. | [optional] |
+| **phone** | **String** | Customer phone number. | [optional] |
+| **corporate** | **Boolean** | True if the customer represents a company. | [optional] |
+| **custom_reference** | **String** | Merchant-defined reference used to identify the customer in your system. | [optional] |
+| **metadata** | **Hash<String, Object>** | Arbitrary metadata associated with the customer. | [optional] |
+| **payment_sources** | [**Array<CustomerPaymentMethodsRequest>**](CustomerPaymentMethodsRequest.md) | Customer payment sources to create/attach (offline recurrent references). | [optional] |
+| **default_payment_source_id** | **String** | Sets the default payment source for the customer (must be an existing payment source on the customer). | [optional] |
+| **default_fiscal_entity_id** | **String** | Sets the default fiscal entity for the customer (must be an existing fiscal entity on the customer). | [optional] |
+| **default_shipping_contact_id** | **String** | Sets the default shipping contact for the customer (must be an existing shipping contact on the customer). | [optional] |
 
 ## Example
 
@@ -23,18 +21,16 @@
 require 'digital_femsa'
 
 instance = DigitalFemsa::UpdateCustomer.new(
-  antifraud_info: null,
-  default_payment_source_id: src_1a2b3c4d5e6f7g8h,
+  name: Miguel,
   email: miguel@gmail.com,
-  name: miguel,
-  phone: +5215555555555,
-  default_shipping_contact_id: ship_cont_1a2b3c4d5e6f7g8h,
-  corporate: false,
-  custom_reference: null,
-  fiscal_entities: null,
+  phone: 5215555555555,
+  corporate: null,
+  custom_reference: customer_123,
   metadata: null,
   payment_sources: null,
-  shipping_contacts: null
+  default_payment_source_id: null,
+  default_fiscal_entity_id: null,
+  default_shipping_contact_id: null
 )
 ```
 

data/docs/UpdateCustomerFiscalEntitiesResponse.md

@@ -6,10 +6,10 @@
 | ---- | ---- | ----------- | ----- |
 | **address** | [**CustomerAddress**](CustomerAddress.md) |  |  |
 | **tax_id** | **String** |  | [optional] |
+| **name** | **String** |  | [optional] |
 | **email** | **String** |  | [optional] |
 | **phone** | **String** |  | [optional] |
 | **metadata** | **Hash<String, Object>** |  | [optional] |
-| **company_name** | **String** |  | [optional] |
 | **id** | **String** |  |  |
 | **object** | **String** |  |  |
 | **created_at** | **Integer** |  |  |
@@ -24,10 +24,10 @@ require 'digital_femsa'
 instance = DigitalFemsa::UpdateCustomerFiscalEntitiesResponse.new(
   address: null,
   tax_id: null,
+  name: Femsa,
   email: null,
   phone: null,
   metadata: null,
-  company_name: Femsa,
   id: fis_ent_2tKZsTYcsryyu7Ah8,
   object: fiscal_entities,
   created_at: 1675715413,

data/docs/UpdateOrderTaxRequest.md

@@ -5,7 +5,7 @@
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
 | **amount** | **Integer** | The amount to be collected for tax in cents | [optional] |
-| **description** | **String** | description or tax's name | [optional] |
+| **description** | **String** | Description or tax name | [optional] |
 | **metadata** | **Hash<String, Object>** |  | [optional] |
 
 ## Example
@@ -15,7 +15,7 @@ require 'digital_femsa'
 
 instance = DigitalFemsa::UpdateOrderTaxRequest.new(
   amount: 100,
-  description: testing,
+  description: VAT,
   metadata: null
 )
 ```

data/docs/UpdateProduct.md

@@ -4,15 +4,14 @@
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **antifraud_info** | **Hash<String, Object>** |  | [optional] |
-| **description** | **String** |  | [optional] |
-| **sku** | **String** |  | [optional] |
 | **name** | **String** |  | [optional] |
 | **unit_price** | **Integer** |  | [optional] |
 | **quantity** | **Integer** |  | [optional] |
-| **tags** | **Array<String>** |  | [optional] |
+| **sku** | **String** |  | [optional] |
 | **brand** | **String** |  | [optional] |
-| **metadata** | **Hash<String, String>** |  | [optional] |
+| **description** | **String** |  | [optional] |
+| **tags** | **Array<String>** |  | [optional] |
+| **metadata** | **Hash<String, Object>** |  | [optional] |
 
 ## Example
 
@@ -20,14 +19,13 @@
 require 'digital_femsa'
 
 instance = DigitalFemsa::UpdateProduct.new(
-  antifraud_info: null,
-  description: null,
-  sku: null,
   name: Box of Cohiba S1s,
   unit_price: 20000,
   quantity: 1,
-  tags: null,
+  sku: null,
   brand: null,
+  description: null,
+  tags: null,
   metadata: null
 )
 ```

data/docs/WebhookKeysApi.md

@@ -5,10 +5,10 @@ All URIs are relative to *https://api.digitalfemsa.io*
 | Method | HTTP request | Description |
 | ------ | ------------ | ----------- |
 | [**create_webhook_key**](WebhookKeysApi.md#create_webhook_key) | **POST** /webhook_keys | Create Webhook Key |
-| [**delete_webhook_key**](WebhookKeysApi.md#delete_webhook_key) | **DELETE** /webhook_keys/{id} | Delete Webhook key |
-| [**get_webhook_key**](WebhookKeysApi.md#get_webhook_key) | **GET** /webhook_keys/{id} | Get Webhook Key |
+| [**delete_webhook_key**](WebhookKeysApi.md#delete_webhook_key) | **DELETE** /webhook_keys/{id} | Delete webhook key |
+| [**get_webhook_key**](WebhookKeysApi.md#get_webhook_key) | **GET** /webhook_keys/{id} | Get webhook key |
 | [**get_webhook_keys**](WebhookKeysApi.md#get_webhook_keys) | **GET** /webhook_keys | Get List of Webhook Keys |
-| [**update_webhook_key**](WebhookKeysApi.md#update_webhook_key) | **PUT** /webhook_keys/{id} | Update Webhook Key |
+| [**update_webhook_key**](WebhookKeysApi.md#update_webhook_key) | **PUT** /webhook_keys/{id} | Update webhook key |
 
 
 ## create_webhook_key
@@ -17,7 +17,7 @@ All URIs are relative to *https://api.digitalfemsa.io*
 
 Create Webhook Key
 
-Create a webhook key
+Creates a new webhook signing key for the current company.
 
 ### Examples
 
@@ -88,7 +88,9 @@ end
 
 > <WebhookKeyDeleteResponse> delete_webhook_key(id, opts)
 
-Delete Webhook key
+Delete webhook key
+
+Deletes a webhook signing key.
 
 ### Examples
 
@@ -108,7 +110,7 @@ opts = {
 }
 
 begin
-  # Delete Webhook key
+  # Delete webhook key
   result = api_instance.delete_webhook_key(id, opts)
   p result
 rescue DigitalFemsa::ApiError => e
@@ -124,7 +126,7 @@ This returns an Array which contains the response data, status code and headers.
 
 ```ruby
 begin
-  # Delete Webhook key
+  # Delete webhook key
   data, status_code, headers = api_instance.delete_webhook_key_with_http_info(id, opts)
   p status_code # => 2xx
   p headers # => { ... }
@@ -159,7 +161,9 @@ end
 
 > <WebhookKeyResponse> get_webhook_key(id, opts)
 
-Get Webhook Key
+Get webhook key
+
+Retrieves the details of a webhook signing key by its ID.
 
 ### Examples
 
@@ -180,7 +184,7 @@ opts = {
 }
 
 begin
-  # Get Webhook Key
+  # Get webhook key
   result = api_instance.get_webhook_key(id, opts)
   p result
 rescue DigitalFemsa::ApiError => e
@@ -196,7 +200,7 @@ This returns an Array which contains the response data, status code and headers.
 
 ```ruby
 begin
-  # Get Webhook Key
+  # Get webhook key
   data, status_code, headers = api_instance.get_webhook_key_with_http_info(id, opts)
   p status_code # => 2xx
   p headers # => { ... }
@@ -313,9 +317,9 @@ end
 
 > <WebhookKeyResponse> update_webhook_key(id, opts)
 
-Update Webhook Key
+Update webhook key
 
-updates an existing webhook key
+Activates or deactivates an existing webhook signing key.
 
 ### Examples
 
@@ -336,7 +340,7 @@ opts = {
 }
 
 begin
-  # Update Webhook Key
+  # Update webhook key
   result = api_instance.update_webhook_key(id, opts)
   p result
 rescue DigitalFemsa::ApiError => e
@@ -352,7 +356,7 @@ This returns an Array which contains the response data, status code and headers.
 
 ```ruby
 begin
-  # Update Webhook Key
+  # Update webhook key
   data, status_code, headers = api_instance.update_webhook_key_with_http_info(id, opts)
   p status_code # => 2xx
   p headers # => { ... }

data/docs/WebhooksApi.md

@@ -5,11 +5,11 @@ All URIs are relative to *https://api.digitalfemsa.io*
 | Method | HTTP request | Description |
 | ------ | ------------ | ----------- |
 | [**create_webhook**](WebhooksApi.md#create_webhook) | **POST** /webhooks | Create Webhook |
-| [**delete_webhook**](WebhooksApi.md#delete_webhook) | **DELETE** /webhooks/{id} | Delete Webhook |
-| [**get_webhook**](WebhooksApi.md#get_webhook) | **GET** /webhooks/{id} | Get Webhook |
+| [**delete_webhook**](WebhooksApi.md#delete_webhook) | **DELETE** /webhooks/{id} | Delete webhook |
+| [**get_webhook**](WebhooksApi.md#get_webhook) | **GET** /webhooks/{id} | Get webhook |
 | [**get_webhooks**](WebhooksApi.md#get_webhooks) | **GET** /webhooks | Get List of Webhooks |
-| [**test_webhook**](WebhooksApi.md#test_webhook) | **POST** /webhooks/{id}/test | Test Webhook |
-| [**update_webhook**](WebhooksApi.md#update_webhook) | **PUT** /webhooks/{id} | Update Webhook |
+| [**test_webhook**](WebhooksApi.md#test_webhook) | **POST** /webhooks/{id}/test | Test webhook |
+| [**update_webhook**](WebhooksApi.md#update_webhook) | **PUT** /webhooks/{id} | Update webhook |
 
 
 ## create_webhook
@@ -32,7 +32,7 @@ DigitalFemsa.configure do |config|
 end
 
 api_instance = DigitalFemsa::WebhooksApi.new
-webhook_request = DigitalFemsa::WebhookRequest.new({url: 'https://webhook.site/89277eaa-a8e4-4306-8dc5-f55c80703dc8', synchronous: false}) # WebhookRequest | requested field for webhook
+webhook_request = DigitalFemsa::WebhookRequest.new({url: 'https://webhook.site/89277eaa-a8e4-4306-8dc5-f55c80703dc8', synchronous: false}) # WebhookRequest | Webhook creation/update request payload.
 opts = {
   accept_language: 'es' # String | Use for knowing which language to use
 }
@@ -68,7 +68,7 @@ end
 
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
-| **webhook_request** | [**WebhookRequest**](WebhookRequest.md) | requested field for webhook |  |
+| **webhook_request** | [**WebhookRequest**](WebhookRequest.md) | Webhook creation/update request payload. |  |
 | **accept_language** | **String** | Use for knowing which language to use | [optional][default to 'es'] |
 
 ### Return type
@@ -89,7 +89,9 @@ end
 
 > <WebhookResponse> delete_webhook(id, opts)
 
-Delete Webhook
+Delete webhook
+
+Deletes a webhook.
 
 ### Examples
 
@@ -109,7 +111,7 @@ opts = {
 }
 
 begin
-  # Delete Webhook
+  # Delete webhook
   result = api_instance.delete_webhook(id, opts)
   p result
 rescue DigitalFemsa::ApiError => e
@@ -125,7 +127,7 @@ This returns an Array which contains the response data, status code and headers.
 
 ```ruby
 begin
-  # Delete Webhook
+  # Delete webhook
   data, status_code, headers = api_instance.delete_webhook_with_http_info(id, opts)
   p status_code # => 2xx
   p headers # => { ... }
@@ -160,7 +162,9 @@ end
 
 > <WebhookResponse> get_webhook(id, opts)
 
-Get Webhook
+Get webhook
+
+Retrieves the details of a webhook by its ID.
 
 ### Examples
 
@@ -181,7 +185,7 @@ opts = {
 }
 
 begin
-  # Get Webhook
+  # Get webhook
   result = api_instance.get_webhook(id, opts)
   p result
 rescue DigitalFemsa::ApiError => e
@@ -197,7 +201,7 @@ This returns an Array which contains the response data, status code and headers.
 
 ```ruby
 begin
-  # Get Webhook
+  # Get webhook
   data, status_code, headers = api_instance.get_webhook_with_http_info(id, opts)
   p status_code # => 2xx
   p headers # => { ... }
@@ -254,6 +258,7 @@ opts = {
   x_child_company_id: '6441b6376b60c3a638da80af', # String | In the case of a holding company, the company id of the child company to which will process the request.
   limit: 56, # Integer | The numbers of items to return, the maximum value is 250
   search: 'search_example', # String | General order search, e.g. by mail, reference etc.
+  url: 'https://api.digitalfemsa.io/webhook', # String | url for webhook filter
   _next: '_next_example', # String | next page
   previous: 'previous_example' # String | previous page
 }
@@ -293,6 +298,7 @@ end
 | **x_child_company_id** | **String** | In the case of a holding company, the company id of the child company to which will process the request. | [optional] |
 | **limit** | **Integer** | The numbers of items to return, the maximum value is 250 | [optional][default to 20] |
 | **search** | **String** | General order search, e.g. by mail, reference etc. | [optional] |
+| **url** | **String** | url for webhook filter | [optional] |
 | **_next** | **String** | next page | [optional] |
 | **previous** | **String** | previous page | [optional] |
 
@@ -314,9 +320,9 @@ end
 
 > <WebhookResponse> test_webhook(id, opts)
 
-Test Webhook
+Test webhook
 
-Send a webhook.ping event
+Sends a test event to the specified webhook to verify it can receive events.
 
 ### Examples
 
@@ -336,7 +342,7 @@ opts = {
 }
 
 begin
-  # Test Webhook
+  # Test webhook
   result = api_instance.test_webhook(id, opts)
   p result
 rescue DigitalFemsa::ApiError => e
@@ -352,7 +358,7 @@ This returns an Array which contains the response data, status code and headers.
 
 ```ruby
 begin
-  # Test Webhook
+  # Test webhook
   data, status_code, headers = api_instance.test_webhook_with_http_info(id, opts)
   p status_code # => 2xx
   p headers # => { ... }
@@ -387,9 +393,9 @@ end
 
 > <WebhookResponse> update_webhook(id, webhook_update_request, opts)
 
-Update Webhook
+Update webhook
 
-updates an existing webhook
+Updates an existing webhook.
 
 ### Examples
 
@@ -404,14 +410,14 @@ end
 
 api_instance = DigitalFemsa::WebhooksApi.new
 id = '6307a60c41de27127515a575' # String | Identifier of the resource
-webhook_update_request = DigitalFemsa::WebhookUpdateRequest.new({url: 'https://webhook.site/89277eaa-a8e4-4306-8dc5-f55c80703dc8'}) # WebhookUpdateRequest | requested fields in order to update a webhook
+webhook_update_request = DigitalFemsa::WebhookUpdateRequest.new({url: 'https://webhook.site/89277eaa-a8e4-4306-8dc5-f55c80703dc8'}) # WebhookUpdateRequest | Webhook update request payload.
 opts = {
   accept_language: 'es', # String | Use for knowing which language to use
   x_child_company_id: '6441b6376b60c3a638da80af' # String | In the case of a holding company, the company id of the child company to which will process the request.
 }
 
 begin
-  # Update Webhook
+  # Update webhook
   result = api_instance.update_webhook(id, webhook_update_request, opts)
   p result
 rescue DigitalFemsa::ApiError => e
@@ -427,7 +433,7 @@ This returns an Array which contains the response data, status code and headers.
 
 ```ruby
 begin
-  # Update Webhook
+  # Update webhook
   data, status_code, headers = api_instance.update_webhook_with_http_info(id, webhook_update_request, opts)
   p status_code # => 2xx
   p headers # => { ... }
@@ -442,7 +448,7 @@ end
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
 | **id** | **String** | Identifier of the resource |  |
-| **webhook_update_request** | [**WebhookUpdateRequest**](WebhookUpdateRequest.md) | requested fields in order to update a webhook |  |
+| **webhook_update_request** | [**WebhookUpdateRequest**](WebhookUpdateRequest.md) | Webhook update request payload. |  |
 | **accept_language** | **String** | Use for knowing which language to use | [optional][default to &#39;es&#39;] |
 | **x_child_company_id** | **String** | In the case of a holding company, the company id of the child company to which will process the request. | [optional] |