Cómo funciona una integración con Cheaf
Esta sección es para equipos técnicos de cadenas y comercios que quieren conectar sus sistemas con Cheaf: el punto de venta (POS), el maestro de artículos o el inventario de la tienda.
Conceptos#
| Término | Qué es |
|---|---|
| Bolsa | La unidad de venta de Cheaf: varios productos excedentes de la tienda en una bolsa física, con un precio único. Tiene su propio código de barras. |
| Pedido | La compra que hace un usuario en la app de Cheaf. Tiene su propio código de barras, distinto del de la bolsa. |
| Armado de bolsas | El personal de la tienda escanea los excedentes en la app de partners de Cheaf, Cheaf los agrupa en bolsas y la tienda las publica a la venta. |
| Pase por caja | El cliente llega a la tienda con su pedido. La caja confirma contra Cheaf que el pedido existe y coincide con lo que compró, y emite el documento fiscal. |
Las dos fases de una integración#
Una integración completa tiene dos fases independientes, que corren en sentidos opuestos:
| Fase | Quién llama a quién | Para qué |
|---|---|---|
| 1 · Publicación de bolsas | Cheaf → los sistemas del comercio | Saber si la tienda puede operar, obtener los datos de cada producto escaneado y avisar qué bolsas se publicaron, para ajustar el inventario. |
| 2 · Pase por caja | El POS del comercio → Cheaf | Confirmar el pedido que se entrega y, en casos borde, revertir esa confirmación. |
sequenceDiagram
autonumber
actor Tienda as Personal de tienda
participant App as App de partners (Cheaf)
participant Comercio as Sistemas del comercio
actor Cliente as Cliente
participant POS as POS del comercio
participant API as Cheaf
rect rgb(249,255,213)
Note over Tienda,Comercio: Fase 1 · Publicación de bolsas
Tienda->>App: Inicia el armado
App->>Comercio: ¿La tienda puede operar?
loop Por cada producto escaneado
App->>Comercio: Datos del producto
Comercio-->>App: Nombre, precio, categoría, stock
end
App->>App: Cheaf compone las bolsas
App->>Comercio: ¿La tienda sigue pudiendo operar?
App->>Comercio: Aviso: contenido de las bolsas publicadas
Comercio-->>App: Recibido
end
rect rgb(241,255,227)
Note over Cliente,API: Fase 2 · Pase por caja
Cliente->>POS: Muestra su pedido y entrega las bolsas
POS->>API: Confirmar pedido
alt Coincide con la compra
API-->>POS: Confirmado, con los datos para facturar
else No coincide
API-->>POS: Rechazado, con el motivo
end
end
Principios#
- Cheaf es la fuente de verdad del pedido. El POS no decide si un pedido es válido: le pregunta a Cheaf.
- Una confirmación por pedido. Un pedido confirmado no se vuelve a confirmar sin revertir antes la confirmación.
- Nada se publica a ciegas. Justo antes de publicar, Cheaf vuelve a consultar si la tienda puede operar y avisa a los sistemas del comercio; si algo falla, las bolsas no se publican.
¿Quieres integrar tu sistema?#
Las integraciones se acuerdan una a una con cada comercio. Revisa Cómo integrar tu sistema con Cheaf para conocer el proceso.