☰ 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

  • cashier en POST /v1/transactions, POST /v1/checks/calculate y POST /v1/holds: un texto o {id, name} que dice quién cobró el ticket. Se guarda con el ticket y la reserva, se devuelve en cashier y 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/calculate y POST /v1/transactions llevan earn_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_id con tickets, cálculos y reservas cuando falte register_id o no esté vinculado a un local; las respuestas llevan location con matched_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 responde redeem_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[].category tanto 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_type en el ticket y en las líneas; el dueño define por tipo si acumula y si se puede pagar con cashback, si no 400 discount_redeem_not_allowed.
  • Cashback como pago o como descuento: en modo descuento cada línea tiene redeem_allocated; el modo está en settings.redeem_accounting.
  • Sin conexión: GET /v1/account devuelve en settings los campos timeout_seconds, offline_redeem y offline_max_hours. Vea Cuando la caja está sin conexión.
  • Regalos: POST /v1/checks/calculate responde gifts.pending y gifts.unlocks, POST /v1/transactions responde gifts.unlocked; marque un regalo como entregado con POST /v1/members/{member}/gifts/{gift_id}/give. Eventos gift.unlocked y gift.given.

5 de noviembre de 2026

  • Cada transacción y POST /v1/checks/calculate llevan line_items con lo que acumuló cada línea: amount, cashback_earned, earn_percent, redeemable, quantity_refunded.
  • Devoluciones por líneas: POST /v1/transactions/{external_id}/refunds acepta line_items con 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_prefix en GET /v1/account.
  • Reglas por producto: el propietario anula la categoría en un producto, para siempre o entre fechas; GET /v1/catalog/products las devuelve en rules.
  • El cashback puede quedar en negativo: una devolución o anulación retira cashback que el cliente ya gastó, cashback.balance pasa 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}/returns recibe los line_items devueltos 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: pickup con location, pickup_at, guest y day_number.
  • Cada pedido tiene payment e history. GET /v1/orders acepta ?type= y ?location=.
  • Un plato con elección obligatoria añadido sin ella se rechaza con needs_options antes 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 /v1 responden con un JSON 404 endpoint_not_found en lugar de la página del sitio; GET /v1 describe la API.
  • Los errores de validación dicen qué enviar, por ejemplo que amount es 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/account devuelve las reglas en settings.
  • Reservas: POST /v1/holds, captura con hold_id, liberación y caducidad automática.
  • POST /v1/checks/calculate muestra 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 levels de cashback, next_level, held y available.
  • Cada ticket, escaneo y cálculo incluye display con texto listo para el cajero y para el ticket impreso.
  • Nuevos permisos members:adjust, catalog:read, catalog:write; nuevos eventos transaction.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/visits y el permiso devices:write.
  • API de la carta con tus SKU en external_id y 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/v1 sigue funcionando.
Dudas sobre una integración: api@loyaltyfy.io. Respondemos en un día hábil.