Comando 43 — Crear un ticket desde un presupuestorehacer
La misma operación, nueva dirección: el id del presupuesto pasa del cuerpo a la ruta. La llamada en sí es sencilla — pero en V1 era la venta entera, y en V2 es solo el primer paso de una.
Permisos
Sección titulada «Permisos»La V2 comprueba un permiso de aplicación en cada llamada — la V1 no comprobaba ninguno — y una llamada a la que le falte responde 400 con errorCode 15, el mismo estado que un payload inválido (ver 4.4). Dáselos al usuario de API antes de portar el comando; los nombres son los del árbol de permisos de flowww.
| Llamada | Permiso |
|---|---|
GET /budget/{budgetGID} | Ventas - Presupuestos → Editar |
POST /invoice/{TicketGID}/payment/{paymethodID} | Ventas - Tickets → Añadir pago |
PATCH /invoice/{TicketGID} | Ventas - Tickets → Cerrar |
POST /budget/125/sell | Ventas - Presupuestos → Generar ticket |
Antes y después
Sección titulada «Antes y después»curl --location 'https://euapi.flowww.net/v1/fwa_external_get.asp?cmd=43&doctor=USER_LOGIN&pass=USER_PASS&country=ES&key=SYSTEM_KEY' \ --data-urlencode 'BudgetID=125'curl --location --request POST 'https://api.flowww.net/v2/budget/125/sell?clinicID=1' \ --header 'Authorization: Bearer <api_key>'
→ { "TicketGID": "329" }Todos los productos del presupuesto se traspasan a un ticket abierto nuevo. Todavía no es una venta: no se cobra nada, la caja no registra nada y el presupuesto no queda marcado como vendido.
A partir de ahí, continúa con los pasos 4 a 7 del comando 19: lee el total, añade los pagos y cierra el ticket. Portar este comando es portar también esa cola — es la parte que la V1 te hacía.
Limpiar tras un fallo
Sección titulada «Limpiar tras un fallo»La llamada crea un ticket abierto, así que le aplica todo lo de una venta: un ticket abierto impide cerrar la caja del día, y el presupuesto no queda vendido hasta que ese ticket se cierra.
Se abandona igual que una venta — quita sus pagos y líneas y borra el ticket vacío: ver Limpiar tras un fallo. El presupuesto se queda intacto y se puede volver a vender; lo que no debes hacer es llamar otra vez a este comando “para reintentar”, porque eso crea un segundo ticket del mismo presupuesto.
Qué cambia respecto a V1
Sección titulada «Qué cambia respecto a V1»| Tema | API V1 | API V2 |
|---|---|---|
| Clínica | Se tomaba del presupuesto. | El clinicID que envíes debe ser el del presupuesto; si no, la llamada falla. |
| El presupuesto | Se quedaba como estaba. | La llamada vuelve a guardar el presupuesto: su fecha pasa a ser hoy, y se borran la fecha de validez, las notas y el doctor. Lee antes el presupuesto con GET /budget/{budgetGID} si necesitas esos valores. |
| Pago y cierre | Una sola llamada: le pasabas la forma de pago y la V1 cobraba el ticket y lo cerraba. | La llamada solo crea el ticket. Leer el total, los pagos (POST /invoice/{TicketGID}/payment/{paymethodID}) y el cierre (PATCH /invoice/{TicketGID}) corren de tu cuenta — pasos 4 a 7 del comando 19. |
| Estado del presupuesto | — | El presupuesto pasa a Vendido solo cuando el ticket se cierra. Hasta entonces se puede volver a vender, y una segunda llamada crea un segundo ticket. |
| Venta abandonada a medias | No dejaba nada detrás. | El ticket abierto se queda, e impide cerrar la caja del día. Quita sus pagos y líneas antes de eliminarlo — ver Limpiar tras un fallo. |
| Reglas de la venta | Se saltaba casi todas. | Se aplican las de una venta normal: campos obligatorios del cliente, caja del día, trazabilidad de stock, descuentos de un solo uso ya caducados… Ver Ajustes que pueden bloquear la venta en el comando 19. |
Errores
Sección titulada «Errores»| Respuesta | Qué significa | Qué hacer |
|---|---|---|
| 400 “Could not create the ticket…” | La venta la ha rechazado una de las reglas de arriba. Esta respuesta no lleva errorCode. | Comprueba que el clinicID sea el del presupuesto, que el cliente tenga los campos obligatorios y que la caja del día esté abierta. |
409 “Invalid parameters…” (errorCode 16) | No se ha podido leer el presupuesto. | Revisa el budgetGID. |
400 (errorCode 15) | El usuario de API no tiene Ventas → Presupuestos → Generar ticket. | Concede el permiso. |