☰ Menú · Registro de cambios
Más
Registro de cambios
Qué ha cambiado en la API, de lo más reciente a lo más antiguo.
22 de noviembre de 2026
cashierenPOST /v1/transactions,POST /v1/checks/calculateyPOST /v1/holds: un texto o{id, name}que dice quién cobró el ticket. Se guarda con el ticket y la reserva, se devuelve encashiery lo usan las señales de cajeros del dueño. Nunca cambia el cashback y queda fuera de la comprobación de idempotencia.
17 de noviembre de 2026
- Regla «en una visita el cliente acumula o gasta»: un ticket con canje no acumula cashback, y las respuestas de
POST /v1/checks/calculateyPOST /v1/transactionsllevanearn_blocked: "redeemed". Sin la regla ese campo no aparece.
16 de noviembre de 2026
- Locales: el dueño vincula a los locales los códigos de caja y de tienda. Envíe
store_idcon tickets, cálculos y reservas cuando falteregister_ido no esté vinculado a un local; las respuestas llevanlocationconmatched_by. Vea cómo enviar el local y la caja. - Reglas por local: porcentaje propio, acumulación desactivada, pago con cashback prohibido o limitado en el local. Un ticket o una reserva con cashback donde está prohibido se rechaza con
400 redeem_not_allowed_here, y el cálculo responderedeem_blocked_reason. Excepciones de productos y categorías por local:GET /v1/catalog/location-rules. - Categoría por nombre: los locales con el orden detallado de reglas aceptan en
line_items[].categorytanto el nombre de la categoría como su código. Un nombre nunca crea una categoría nueva; gana la regla más específica. - Productos en promoción:
line_items[].promo: true; el dueño decide si esas líneas acumulan y si se pueden pagar con cashback. - Tipos de descuento:
discount_typeen el ticket y en las líneas; el dueño define por tipo si acumula y si se puede pagar con cashback, si no400 discount_redeem_not_allowed. - Cashback como pago o como descuento: en modo descuento cada línea tiene
redeem_allocated; el modo está ensettings.redeem_accounting. - Sin conexión:
GET /v1/accountdevuelve ensettingslos campostimeout_seconds,offline_redeemyoffline_max_hours. Vea Cuando la caja está sin conexión. - Regalos:
POST /v1/checks/calculaterespondegifts.pendingygifts.unlocks,POST /v1/transactionsrespondegifts.unlocked; marque un regalo como entregado conPOST /v1/members/{member}/gifts/{gift_id}/give. Eventosgift.unlockedygift.given.
5 de noviembre de 2026
- Cada transacción y
POST /v1/checks/calculatellevanline_itemscon lo que acumuló cada línea:amount,cashback_earned,earn_percent,redeemable,quantity_refunded. - Devoluciones por líneas:
POST /v1/transactions/{external_id}/refundsaceptaline_itemscon código y cantidad; el cashback sigue lo que cada línea acumuló realmente. - Prefijo del número de tarjeta: el propietario lo define en las reglas para las cajas y las tarjetas nuevas empiezan por él;
settings.card_prefixenGET /v1/account. - Reglas por producto: el propietario anula la categoría en un producto, para siempre o entre fechas;
GET /v1/catalog/productslas devuelve enrules. - El cashback puede quedar en negativo: una devolución o anulación retira cashback que el cliente ya gastó,
cashback.balancepasa a negativo y el siguiente ticket cubre primero la deuda. - Panel: felicitaciones de cumpleaños en el idioma de la tarjeta, eventos y cumpleaños sin imagen (el texto va sobre el diseño de la tarjeta), niveles de sellos que cambian en el momento de reunir los sellos.
- Panel: automatizaciones (compró un producto, dejó de comprarlo, calendario a un segmento) con registro de envíos; cohortes de compradores con LTV; segmentos por productos comprados y por saldo de cashback.
- Devolución por líneas:
POST /v1/transactions/{external_id}/returnsrecibe losline_itemsdevueltos y mueve el cashback según lo que acumuló cada línea; el mismo motor que la devolución con líneas, como endpoint propio.
24 de octubre de 2026
- Pedidos para llevar:
type: pickupconlocation,pickup_at,guestyday_number. - Cada pedido tiene
paymentehistory.GET /v1/ordersacepta?type=y?location=. - Un plato con elección obligatoria añadido sin ella se rechaza con
needs_optionsantes de llegarte.
9 de octubre de 2026
- Un ticket anulado o devuelto por completo deja de contar como visita y como gasto, así que las devoluciones no suben el nivel de cashback del cliente.
- Las rutas desconocidas dentro de
/v1responden con un JSON404 endpoint_not_founden lugar de la página del sitio;GET /v1describe la API. - Los errores de validación dicen qué enviar, por ejemplo que
amountes un número entero en unidades menores.
7 de octubre de 2026
- Reglas del local para las cajas: canje mediante reservas, números de ticket por caja, un límite para los tickets enviados tarde, límites de cashback por ticket y por día, escaneo obligatorio de la tarjeta y ajustes manuales. Cada clave puede tener sus propios valores.
GET /v1/accountdevuelve las reglas ensettings. - Reservas:
POST /v1/holds, captura conhold_id, liberación y caducidad automática. POST /v1/checks/calculatemuestra qué haría un ticket sin escribir nada.- Devoluciones parciales:
POST /v1/transactions/{external_id}/refunds. - Catálogo: sube productos por SKU; el propietario decide por categoría si da cashback, si se puede pagar con cashback y su propio porcentaje.
- Los socios muestran los
levelsde cashback,next_level,heldyavailable. - Cada ticket, escaneo y cálculo incluye
displaycon texto listo para el cajero y para el ticket impreso. - Nuevos permisos
members:adjust,catalog:read,catalog:write; nuevos eventostransaction.refunded,balance.adjusted.
6 de octubre de 2026
- API v1 en
/api/v1, para todos los tipos de programa: cashback, sellos, descuentos por visitas y niveles VIP. - Socios: inscripción con tu propio número de tarjeta, búsqueda por tarjeta, código de barras, teléfono o id, historial y canje de recompensas.
- Formato del código de la tarjeta por programa: QR o Code 128 con el número de tarjeta, o QR con el número de serie.
- Transacciones con
line_items, anulaciones y canje de cashback con los topes del programa. - Quioscos y escáneres:
POST /v1/scans,POST /v1/visitsy el permisodevices:write. - API de la carta con tus SKU en
external_idy sincronización masiva de precios y productos agotados. - Pedidos de mesa desde la carta QR, con estados para el TPV.
- Webhooks con firmas y reintentos,
Idempotency-Key, paginación por cursor y permisos por clave. - La API de POS anterior en
/api/pos/v1sigue funcionando.