Versiones y cambios para clientes
Compará versiones del SDK, revisá qué debe implementar el cliente y descargá templates históricos.
Usá esta página antes de actualizar el pin brightmarket-data-sync==X.Y.Z en un proyecto cliente.
El changelog está curado para priorizar el impacto del lado cliente: cambios de contrato, writers nuevos, payloads, template, CLI y documentación que conviene revisar.
Comparar versiones
Seleccioná una versión inicial y una final. El resultado muestra todas las versiones del rango y pone primero las acciones que debe revisar el cliente.
El rango muestra las versiones posteriores a la versión inicial e incluye la versión final seleccionada.
Resumen del rango
2.6.0 -> 2.7.01 version incluida en este diff.
Acciones acumuladas del cliente
- SDK 2.7.0: Actualizar el pin a `brightmarket-data-sync==2.7.0` después de que la API acepte `size`.
- SDK 2.7.0: Si el cliente arma el payload del SKU a mano, reemplazar `shoeSize` por `size`.
Cambios acumulados del SDK
- SDK 2.7.0: El sync de SKUs por `SKU_FIELD_MAP` publica el valor lógico `size` en el campo de API `size` (texto libre: número, texto o una combinación).
- SDK 2.7.0: La clave lógica `size` no cambia. Un valor vacío se envía como cadena vacía.
- SDK 2.7.0: Los payloads de passthrough deben enviar `size` en lugar de `shoeSize`.
SDK 2.7.0
v2.7.02026-10-06El talle del SKU se envía como un solo campo de texto libre `size`.
Qué tiene que hacer el cliente
- Actualizar el pin a `brightmarket-data-sync==2.7.0` después de que la API acepte `size`.
- Si el cliente arma el payload del SKU a mano, reemplazar `shoeSize` por `size`.
Cambios del SDK
- El sync de SKUs por `SKU_FIELD_MAP` publica el valor lógico `size` en el campo de API `size` (texto libre: número, texto o una combinación).
- La clave lógica `size` no cambia. Un valor vacío se envía como cadena vacía.
- Los payloads de passthrough deben enviar `size` en lugar de `shoeSize`.
Descargar templates por versión
Cada ZIP se genera desde el template cliente y queda pinneado a la versión del SDK indicada en su requirements.txt.
SDK 2.7.0actual
v2.7.0 · 2026-10-06
El talle del SKU se envía como un solo campo de texto libre `size`.
SDK 2.6.0
v2.6.0 · 2026-10-02
Agrega soporte de tipo de comprobante y moneda en tickets: documentType y currencyId ahora se leen del mapa de campos en lugar de estar hardcodeados.
SDK 2.5.2
v2.5.2 · 2026-09-15
Documenta promociones reutilizables: el POS reusa el mismo id, el cliente crea ventanas únicas y los tickets diarios resuelven la última ventana.
SDK 2.5.1
v2.5.1 · 2026-08-12
Soporte de múltiples IDs de promoción separados por coma en un mismo campo de línea de ticket.
SDK 2.5.0
v2.5.0 · 2026-08-10
Importación masiva de stock completo desde el CLI del SDK con `-stock_import`.
SDK 2.4.0
v2.4.0 · 2026-08-07
`sync_tickets` puede generar JSONL y subirlo con `-tickets -file` (o solo generar con `-generate-only`).
SDK 2.3.0
v2.3.0 · 2026-08-03
`sync_tickets` puede asociar promociones de línea vía `TICKET_FIELD_MAP.promo_id` y `resolve_promotion_external_id_for_date`.
SDK 2.2.0
v2.2.0 · 2026-08-01
Writer para Importar stock (CSV/ZIP): `upload_stock_movements_import` hacia `stockMovements/import/upload`.
SDK 2.1.0
v2.1.0 · 2026-07-31
Sync de stock absoluto en el SDK: adapter, field map, flag `-stock_adjustments` (todas las sucursales o una).
SDK 2.0.1
v2.0.1 · 2026-07-27
Opt-ins compatibles en el sync del SDK: validación de contacto store-only, channelId de tickets por sucursal, y creación de categorías de SKU.
SDK 2.0.0
v2.0.0 · 2026-07-13
2.0 estable: capa de sync en el SDK y field maps en constants.py; los clientes implementan lectura en adapter.py sin src/sync/ genérico.
SDK 1.3.6
v1.3.6 · 2026-07-08
Actualiza `create_category` para soportar jerarquía de categorías mediante `fatherExternalId`.
SDK 1.3.5
v1.3.5 · 2026-07-01
Agrega el writer `create_category` para crear categorías en Brightmarket.
SDK 1.3.4
v1.3.4 · 2026-06-21
Corrige la validación de sucursales y medios de pago, y hace idempotente la creación de sucursales.
SDK 1.3.3
v1.3.3 · 2026-06-19
Agrega scripts de autenticación pip para Windows y documentación ampliada de CodeArtifact en el template cliente.
SDK 1.3.2
v1.3.2 · 2026-06-16
Agrega helpers compartidos de validación y lookup para evitar llamadas HTTP propias en clientes.
SDK 1.3.1
v1.3.1 · 2026-06-16
Agrega validación de contacto opcional para clientes sobre la línea actual del SDK.
SDK 1.3.0
v1.3.0 · 2026-06-15
Mueve la CLI compartida al SDK para simplificar los proyectos cliente y agrega helpers de carga JSONL.
SDK 1.2.0
v1.2.0 · 2026-06-14
Agrega escritura de movimientos de puntos y actualización de puntos activos para clientes.
SDK 1.1.17
v1.1.17 · 2026-07-23
Backport: agrega helpers para resolver datos de sucursales y channelId por external ID.
SDK 1.1.16
v1.1.16 · 2026-07-08
Backport: actualiza `create_category` para soportar jerarquía mediante `fatherExternalId`.
SDK 1.1.15
v1.1.15 · 2026-07-01
Backport: agrega el writer `create_category` para crear categorías en Brightmarket.
SDK 1.1.14
v1.1.14 · 2026-06-16
Agrega sincronización opcional de validación de contacto para clientes sin guardar los valores de contacto.
SDK 1.1.13
v1.1.13 · 2026-06-06
Versión base del template cliente: adapter, sync modules, CLI, configuración y scripts de instalación.