Changelog

Aquí anunciamos cada cambio de la API y de los webhooks. Los cambios que rompan la compatibilidad (quitar o renombrar un campo, un código de error, un permiso o un tipo de evento) no ocurren sin una nueva versión y un aviso previo. Agregar campos, endpoints, filtros o tipos de evento no se considera un cambio que rompe: tu integración debe tolerar campos nuevos.

v1.0.0 — actualización — 2026-09-28

Editar productos y variantes: PATCH /products/{id} (nombre, descripciones, SKU, categoría, precios, clase fiscal, estado) y PATCH /products/{id}/variants/{variantId} (etiqueta, SKU, precios, estado). El cambio llega a las cajas sin stock: cada caja conserva el suyo. Solo funciona cuando todos los dispositivos del negocio tienen la versión de Posdata que lo soporta; si no, responde el nuevo código 409 DEVICES_OUTDATED con la lista de dispositivos y no modifica nada. El permiso products:write ahora incluye estas ediciones, y emiten product.updated. Detalle en Productos: se crean y se editan.
occurred_at en las ventas: cuándo se registró la venta en la caja (en ventas sincronizadas antes del 28-sep-2026, igual a la hora de llegada). Nuevos filtros occurred_since y occurred_until en GET /sales, y el reporte GET /reports/daily-sales ahora agrupa por occurred_at. created_at sigue siendo la hora de llegada a la nube. Mira Las ventas traen dos fechas.
Búsqueda literal: en q, los caracteres % y _ se buscan tal cual, no como comodines.
stock en productos: el campo ya está en el contrato, pero sigue siendo null por ahora. Lo activaremos cuando podamos garantizar que coincide con el de las cajas, y lo anunciaremos aquí. Mira Stock: todavía no publicamos un número.

v1.0.0 — 2026-09-28

Primera versión pública.

API REST en https://api.posdata.so/public/v1 (pruebas: https://apidev.posdata.so/public/v1), incluida en el plan Pro.
Autenticación con API keys de cuenta (pdk_live_/pdk_test_) y 12 permisos de mínimo privilegio.
Lectura de cuenta y frescura de datos (/me), productos y variantes, categorías, clientes, bodegas, movimientos de inventario, ventas, documentos electrónicos, cotizaciones, turnos de caja, ventas por día y registro de eventos.
Escritura: crear y editar categorías y clientes, crear productos sin variantes (con stock inicial opcional) y registrar movimientos de inventario de productos sin variantes. Todo POST exige Idempotency-Key. La edición de productos y variantes llegó con la actualización del mismo día (arriba).
Webhooks firmados con HMAC-SHA256 (api_version 2026-09-28) para 12 tipos de evento, con reintentos durante unas 28 horas y reconciliación con GET /events.
Límites: 300 peticiones por minuto por key, 600 por cuenta y 60 escrituras por minuto por key.

Limitaciones conocidas de esta versión: Lo que la API no hace en la versión 1.