Ir al contenido

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.

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.

LlamadaPermiso
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/sellVentas - Presupuestos → Generar ticket
API V1
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'
API V2
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.

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.

TemaAPI V1API V2
ClínicaSe tomaba del presupuesto.El clinicID que envíes debe ser el del presupuesto; si no, la llamada falla.
El presupuestoSe 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 cierreUna 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 mediasNo 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 ventaSe 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.
RespuestaQué significaQué 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.