Changelog
Todos los cambios notables de la API de SellerHub se documentan en este archivo.
El formato está basado en Keep a Changelog, y este proyecto adhiere a Semantic Versioning.
Versión actual: 1.2.0
[1.2.0] - 2026-05-25
Agregado
- Endpoint
GET /{clientId}/products/stockpara consultar el stock publicado de una tienda (estado de publicación, fecha y hora de publicación, horario de atención y lista de productos con stock). - Endpoint
GET /{clientId}/products/stock/{product_id}para obtener el detalle de un producto publicado por su identificador. - Documentación en
README.mdde las secciones Mi stock publicado y Detalle de producto publicado. - Especificación OpenAPI de ambos endpoints de consulta de stock publicado.
- Esquemas de seguridad en OpenAPI/Swagger para rutas
/{clientId}/:X-API-KEY(token de uso) yX-Signature(firma HMAC-SHA256 del body HTTP).
Modificado
- Documentación de Recepcionar una orden de compra: valores de
purchase_type(Retiro,Delivery,Custom Delivery) documentados junto aorder_statusantes del ejemplo de payload. - Swagger UI actualizado para reflejar la autenticación con API token y firma HMAC (
X-API-KEY+X-Signature); ver Configuración de firma HMAC en el README. - Logo de Swagger UI reemplazado por el de GoodMeal.
- Corrección de estilos en documentación Markdown (
README.md).
[1.1.0] - 2025-11-05
Agregado
- Endpoint
POST /{clientId}/accounts/paramspara configurar parámetros de cuenta (base_url_notification_tripybase_url_notification_purchase). - Soporte para autenticación por
TOKENen la configuración de URLs de notificación. - Campo
invoice_urleditable en órdenes con estadoPENDING.
Modificado
- El campo
available_quantityen la actualización de orden ahora es obligatorio cuando el stock difiere de la cantidad solicitada.
Corregido
- Error 500 intermitente al cotizar delivery con coordenadas de latitud/longitud en formato de cadena.
[1.0.0] - 2025-08-15
Agregado
- Endpoint
POST /{clientId}/productspara carga y edición masiva de productos. - Endpoint
PUT /{clientId}/products/stockpara actualización de stock por SKU. - Endpoint
PUT /{clientId}/orderspara actualización de órdenes (estado, delivery, productos). - Flujo de cotización de delivery mediante webhook configurable.
- Flujo de recepción de órdenes de compra mediante webhook configurable.
- Soporte para categorías: Picoteo, Congelados, Desayuno, Cocina, Bebidas, Limpieza, Cuidado personal.
- Soporte para unidades de medida:
gr,kg,lb,lt,ml,oz,un. - Autenticación mediante header
X-API-TOKEN. - Códigos de respuesta estándar HTTP:
200,4XX,5XX.