1 Elegir la caja
GET /v2/pos
2 Crear la orden
POST /v2/orders/pos/{posUUID}
El total y la cédula van juntos en esta llamada (ambos son obligatorios). La factura puede enviarse ahora o después.
3 Activar la orden y pedir los montos
GET /v2/orders/{uuid}/payment-plan · POST …/payment-plan { userCode }
En producción el cliente escanea el QR de la caja desde su app. En staging eso se simula. Hay 5:00 para activar; si no, Cashea cancela la orden.
o, si el cliente no tiene señal
4 Cobrar la inicial y confirmarla
POST /v2/orders/{uuid}/down-payment
El cajero cobra el downPayment con un medio de pago normal (efectivo, tarjeta, pago móvil). Después el vPOS confirma a Cashea. Obligatorio: sin esta llamada la orden queda en PENDING.
5 Factura y cierre
PATCH /v2/orders/{uuid} { invoiceId } · GET /v2/orders/{uuid}/details
El número fiscal es obligatorio por ley. Si no se mandó al crear la orden, se envía aquí al imprimir la factura.
✕ Cancelar orden
DELETE /v2/orders/{uuid}
Disponible desde que existe la orden. En tu app debe dispararse solo si el cajero abandona el flujo o cambia el monto (el monto no se puede editar: se cancela y se crea otra).