# Cambios y avances

## V 1.7.1 - 22/12/2021

### Cambios⚠️🔧⚙️

* Se agregó el controlador de productos con los siguientes métodos:\
  -List\
  -Find\
  -AddProduct\
  -UpdateProduct\
  -DeleteProduct

## V 1.5.6 - 07/09/2021

### Cambios⚠️🔧⚙️

* Se agregó compatibilidad con Tienda Nube

## V 1.5.5 - 20/07/2021

### Cambios⚠️🔧⚙️

* Se adicionó campo opcional a los Webhooks en caso de que requieran autenticación
* Nuevo topic de orders/billing, con este se notificarán actualizaciones de la información fiscal del comprador

## V 1.5.4.4 - 11/05/2021

### Cambios⚠️🔧⚙️

* Varias mejoras de performance y logging para productos
* Nuevas funcionalidades de Digital Redeems (enterprise)
* Se agregó soporte a guías de cross\_docking para Mercado Libre y Mercado Shops

## V 1.5.1 - 26/03/2021

### Cambios⚠️🔧⚙️

* Se agregó el parametro parentSku al path del endpoint [UpdateProduct](https://docs.ventiapp.com/desarrolladores/api/productos#update-product)

## V 1.5.0.2 - 10/03/2021

### Cambios⚠️🔧⚙️

* En todos los endpoint/webhooks que retornan ordenes se agregó el campo BillingInfo dentro del objeto Buyer. En caso de que la orden tenga información fiscal, retornará docType y docValue. Siendo estos valores tipo de documento y valor del documento. Ej. docType=RFC, docValue=XAXX010101000

## V 1.5.0 - 23/02/2021

### Cambios⚠️🔧⚙️

* Se agregó el nuevo endpoint [**AddDigitalRedeems**](https://docs.ventiapp.com/desarrolladores/api/ventas#add-digital-redeems)
* El endpoint de **UpdateStockPriceByChannel** ahora funciona con modo encolado, este mismo procede a encolar los cambios en nuestro nuevo pipepine de actualización de stock y precios.

## V 1.4.3 - 09/02/2021

### Cambios⚠️🔧⚙️

* En los endpoints de actualización de stock, los números que lleguen negativos serán traducidos a un 0 ya que los canales no soportan cantidades negativas

## V 1.4.2 - 09/02/2021

### Cambios⚠️🔧⚙️

* Se agregaron campos de **accountName** en el body de Ordenes para identificar la cuenta de cual proviene la orden
* Se implementó fix en el API de **Stock/GetPriceStockByChannel** en este endpoint no se estaba implementando de manera correcta el Throttling del API, en caso de tener problemas por favor verificar la sección de [Consideraciones](https://docs.ventiapp.com/desarrolladores/consideraciones#limitaciones)

## V 1.4.1 - 07/12/2020

### Cambios⚠️🔧⚙️

* Se agregaron campos de **Neighborhood** y **Municipality** a dirección de comprador en  el apartado buyer en Ordenes
* Nuevo endpoint para consultar estados de actualizaciones de Stock y Precio \
  [GetJobStatus](https://docs.ventiapp.com/desarrolladores/api/stock-y-precios#get-job-status)

## V 1.4.0 - 30/11/2020

### Cambios⚠️🔧⚙️

* Se habilitaron los endpoints para actualización de envíos de las órdenes.\
  [UpdateShippingLabel](https://docs.ventiapp.com/desarrolladores/api/ventas#update-shipping-label)\
  [UpdateShippingStatus](https://docs.ventiapp.com/desarrolladores/api/ventas#update-shipping-status)
* Los endpoints de actualización de Stock encolan los cambios en lugar de esperar a procesar, esto corre en un sistema interno de Ventiapp llamado AutoSync v2, próximamente generará un ID de Job para consultar los resultados

## V 1.3.5 - 24/11/2020

### Cambios⚠️🔧⚙️

* Se agregó campo **Discounts** en endpoints de ordenes, este representa descuentos directos sobre la compra (ej. cupones)

## V 1.3.4 - 11/11/2020

### Cambios⚠️🔧⚙️

* Unificación de estados de Venta, verificar [Estados posibles de ordenes](https://docs.ventiapp.com/desarrolladores/api/ventas#estados-posibles-de-ordenes)
* Fix de minor bugs

## V 1.3.0 - 01/09/2020

### Cambios⚠️🔧⚙️

* Se actualizó el endpoint de **AddProduct,** esté tiene un nuevo formato para poder subir **variaciones** y **atributos** adicionales

## V 1.2.9 - 24-08-2020

### Cambios⚠️🔧⚙️

* Se agrego el campo **shippingReceptor** dentro del payload **shipping** en los endpoint de **Orders**, este campo está mapeado al receptor del envío del pedido

## V 1.2.8 - 20-08-2020

### Cambios⚠️🔧⚙️

* Se realizaron correciones en los endpoint de **Orders**&#x20;
  * El campo Buyer->State estaba mapeado incorrectamente, anteriormente estaba el estado de la orden, en lugar de ser el estado de la dirección ej: "Jalisco"
  * Se agregó el campo orderStatus a la cabecera de la órden, esta indica el estado de la órden ej: "paid, cancelled, returned, etc"

## V 1.2.7 - 10-08-2020

### Cambios⚠️🔧⚙️

* Los endpoint de **Orders** ahora tienen campos sku (el de Ventiapp) y channelSku (el del canal de venta)

## V 1.2.6 - 10-06-2020

### Cambios⚠️🔧⚙️

* El endpoint **FindOrder** ahora busca tambien por VentaExternalNumber

## V 1.2.5 - 01-06-2020

### Cambios⚠️🔧⚙️

* Se corrigió bug que acoplaba mal los productos en las items en órdenes de Shopify en el endpoint **Orders**

## V 1.2.4 - 05-05-2020

### Cambios⚠️🔧⚙️

* Se mejoró lógica de creación de Webhooks

## V 1.2.3 - 25-04-2020

### Cambios⚠️🔧⚙️

* Se agregó el campo **shippingCost** en todos los endpoints y webhooks de **Ordenes**

## V 1.2.2 - 17-04-2020

### Cambios⚠️🔧⚙️

* Se agregaron campos nuevos en Get Price Stock By Channel, ahora vienen account\_id y account\_name en caso de ser Mercado Libre
* Se realizó un arreglo en SKU's que vienen ventas de Claroshop

## V 1.2.1 - 16-04-2020

### Cambios⚠️🔧⚙️

* Se realizó un arreglo en órdenes que venían de Amazon, a veces no figuraban correctamente en Get Orders

## V 1.2.0 - 07-04-2020

### Cambios⚠️🔧⚙️

* Se habilitó API de [**PrintLabels**](https://docs.ventiapp.com/desarrolladores/api/ventas#print-label-beta)**,** ahora podrás descargar las guías directamente desde el **API**

## V 1.1.1 - 31-03-2020

### Cambios⚠️🔧⚙️

* Se creó filtro nuevo para **GetOrders**, ahora podrás filtrar por canal

## V 1.1.0 - 23-03-2020

### Cambios⚠️🔧⚙️

* Se habilitó API de **Webhooks**
* Se creó nuevo endpoint para consultar el stock y precio por canal **GetPriceStockByChannel**

## V 1.0.8 - 29-11-2019

### Cambios⚠️🔧⚙️

* Se agregó campo **paymentMethods** a los endpoint de órdenes. Este lista los pagos en caso de que el canal de esa información
* Se optimizaron las consultas de las órdenes, ahora retorna más rápido los datos

## V 1.0.7 - 08-11-2019

### Cambios⚠️🔧⚙️

* Se agrega campo **availableDays** en UpdatePriceStockByChannel para indicar la disponibilidad en días del producto (Esto solamente aplica para Mercado Libre en cuanto liberen su API)
* Se reparó error en UpdatePriceStockByChannel que surgía cuando no se encontraba correctamente el SKU en las variaciones de los productos

## V 1.0.6 - 07-10-2019

### Cambios⚠️🔧⚙️

* Se agrego API AddProduct, es para agregar productos base a Ventiapp

## V 1.0.5 - 30-09-2019

### Cambios⚠️🔧⚙️

* Se agrego campo de ExternalNumber ya que en canales como Linio puede que tenga un ID adicional la Venta.

## V 1.0.4 - 12-09-2019

### Cambios⚠️🔧⚙️

* Se agregó campo OrderId en el endpoint de Ventas, este representa el ID interno dentro de Ventiapp
* Se agregó campo OrderId en el endpoint de Bills, este representa el ID interno dentro de Ventiapp, sirve para hacer match con la venta

## V 1.0.3 - 12-08-2019

### Cambios⚠️🔧⚙️

* Implementación de colas de update para Linio y Amazon en API (1.0.3)
* Se incrementó el buffer de entrada de body a 350kb. Apróximadamente son 5000 productos para actualización de stock

## V 1.0.2 - 22-07-2019

### Cambios⚠️🔧⚙️

* Se mejoró el proceso de actulización de stock y precio en **Update Price Stock By Channel**
* Fix para integración Claroshop para actualización de stock y precio, no estaba funcionando correctamente.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.ventiapp.mx/ventiapp/desarrolladores/cambios-y-avances.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
