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.3.0 -> 2.4.01 version incluida en este diff.
Acciones acumuladas del cliente
- SDK 2.4.0: Actualizar el pin a `brightmarket-data-sync==2.4.0`.
- SDK 2.4.0: Para cargas históricas grandes: `python -m src.main -tickets -file -from YYYYMMDD -to YYYYMMDD`.
- SDK 2.4.0: Para generar sin subir: agregar `-generate-only` (archivo en `temp/tickets-….jsonl`).
Cambios acumulados del SDK
- SDK 2.4.0: Nuevos writers `write_tickets_jsonl` y `create_tickets` (escribir JSONL y opcionalmente `upload_tickets_jsonl`).
- SDK 2.4.0: `sync_tickets` acepta `use_file`, `generate_only` y `output_dir`; el CLI pasa `-file` / `-generate-only`.
- SDK 2.4.0: Por defecto `-tickets` sigue enviando un `POST tickets/external` por ticket.
SDK 2.4.0
v2.4.02026-08-07`sync_tickets` puede generar JSONL y subirlo con `-tickets -file` (o solo generar con `-generate-only`).
Qué tiene que hacer el cliente
- Actualizar el pin a `brightmarket-data-sync==2.4.0`.
- Para cargas históricas grandes: `python -m src.main -tickets -file -from YYYYMMDD -to YYYYMMDD`.
- Para generar sin subir: agregar `-generate-only` (archivo en `temp/tickets-….jsonl`).
Cambios del SDK
- Nuevos writers `write_tickets_jsonl` y `create_tickets` (escribir JSONL y opcionalmente `upload_tickets_jsonl`).
- `sync_tickets` acepta `use_file`, `generate_only` y `output_dir`; el CLI pasa `-file` / `-generate-only`.
- Por defecto `-tickets` sigue enviando un `POST tickets/external` por ticket.
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.4.0actual
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.