Comando 40 — Crear presupuestosmultipaso
La V1 tomaba el presupuesto entero como una cadena JSON Budgetdata dentro de un campo urlencoded, lo comprobaba todo y lo guardaba de una vez. La V2 lo parte en una cabecera y sus líneas, cada una guardada por su cuenta, y tarifica las líneas con la tarifa y los descuentos de la clínica.
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 |
|---|---|
POST /budget/{budgetGID}/detail/product/{productID} | Ventas - Presupuestos → Añadir producto |
GET /budget/{budgetGID} | Ventas - Presupuestos → Editar |
PUT /budget/{budgetGID}/detail/{budgetID} | Ventas - Presupuestos → Editar precio |
PUT /budget/{budgetGID} | Ventas - Presupuestos → Guardar |
POST /budget | Ventas - Presupuestos → Crear |
GET /tariff/{productGID}/product | Tarifas - Productos → Productos - Listar |
DELETE /budget/{budgetGID} | Ventas - Presupuestos → Borrar |
POST /budget/{id}/clone | Clientes - Odontograma → Clonar presupuesto |
GET /budget | Ventas - Presupuestos → Listar |
El flujo
Sección titulada «El flujo»- 1
POST /budget?clinicID={n}
{"BudgetGClientID": id}→201 {"BudgetGID": 109}
ClientIDyClinicIDdeBudgetdata - 2
POST /budget/{budgetGID}/detail/product/{productID}
Una vez por línea, con{"BudgetUnits": n, "BudgetProductComments": "…"}→200con el cuerpo vacío
Products[]deBudgetdata - 3
GET /budget/{budgetGID}
Lee los ids de línea (Details[].BudgetID) y los precios que ha aplicado la tarifa
Sin equivalente en V1 - 4
PUT /budget/{budgetGID}/detail/{budgetID}
Solo para un precio distinto al de tarifa:{"BudgetPrice": p}, IVA incluido
ProductPrice - 5
PUT /budget/{budgetGID}
Completa la cabecera, siempre entera: fecha, validez, doctor, notas
ValidityDate,DoctorID,Comments,Status
El mismo presupuesto, llamada a llamada:
curl --location 'https://euapi.flowww.net/v1/fwa_external_get.asp?cmd=40&doctor=USER_LOGIN&pass=USER_PASS&country=ES&key=SYSTEM_KEY' \ --data-urlencode 'Budgetdata={"ClientID": 93271, "ClinicID": 1, "ValidityDate": "2026-06-23", "DoctorID": 238, "Status": 0, "Comments": "Tratamiento anual", "Products": [{"ProductID": 2983, "VoucherID": 0, "PackID": 0, "SubscriptionID": 0, "ProductUnits": 1, "ProductPrice": 1000, "Comments": ""}]}'Fíjate en ValidityDate, en yyyy-mm-dd.
curl --location 'https://api.flowww.net/v2/budget?clinicID=1' \ --header 'Authorization: Bearer <api_key>' \ --header 'Content-Type: application/json' \ --data '{"BudgetGClientID": 93271}'
→ 201 {"BudgetGID": 109}curl --location 'https://api.flowww.net/v2/budget/109/detail/product/2983?clinicID=1' \ --header 'Authorization: Bearer <api_key>' \ --header 'Content-Type: application/json' \ --data '{"BudgetUnits": 1, "BudgetProductComments": ""}'
→ 200 con el cuerpo vacío: el id de la línea no se devuelve.curl --location 'https://api.flowww.net/v2/budget/109?clinicID=1' \ --header 'Authorization: Bearer <api_key>'Cada línea de Details[] lleva su BudgetID.
curl --location --request PUT 'https://api.flowww.net/v2/budget/109/detail/{BudgetID}?clinicID=1' \ --header 'Authorization: Bearer <api_key>' \ --header 'Content-Type: application/json' \ --data '{"BudgetPrice": 1210.00}'curl --location --request PUT 'https://api.flowww.net/v2/budget/109?clinicID=1' \ --header 'Authorization: Bearer <api_key>' \ --header 'Content-Type: application/json' \ --data '{ "BudgetGDate": "23/03/2026", "BudgetGValidity": "23/06/2026", "BudgetGDoctorID": 238, "BudgetGNotes": "Tratamiento anual" }'Envía el mismo clinicID en todas las llamadas: las líneas solo se pueden añadir desde la clínica a la que pertenece el presupuesto.
Limpiar tras un fallo
Sección titulada «Limpiar tras un fallo»Un presupuesto también se monta en varias llamadas, y uno que se queda a medias permanece en la ficha del cliente como presupuesto pendiente — con las líneas que le hubieran dado tiempo a entrar.
DELETE /budget/{budgetGID} lo elimina entero, con sus líneas. Su id lo tienes del paso 1, así que no hay que buscarlo.
curl --location --request DELETE 'https://api.flowww.net/v2/budget/109?clinicID=1' --header 'Authorization: Bearer <api_key>'No es la forma de deshacer un presupuesto vendido: una vez convertido en ticket, mira el comando 43 y la limpieza del comando 19.
Mapeo de campos
Sección titulada «Mapeo de campos»V1 (Budgetdata) | API V2 | Notas |
|---|---|---|
ClientID | BudgetGClientID (POST /budget) | El único campo obligatorio para crear el presupuesto. La V2 no comprueba que el cliente exista: usa el id vigente (los clientes fusionados no se traducen). |
ClinicID | ?clinicID= | El presupuesto se crea en esa clínica. La V1 podía recurrir a la clínica por defecto para ventas online o a la del cliente. |
ValidityDate | BudgetGValidity (PUT /budget/{id}) | Cambia el formato: yyyy-mm-dd → dd/MM/yyyy. |
DoctorID | BudgetGDoctorID | La V2 tiene además BudgetGUserID para el comercial (el usuario de API por defecto). |
Status | BudgetGStatus | Los mismos valores 0–3, más 4 Descartado y 5 Caducado. Envía el estado como número. Ver los avisos de abajo. |
Comments (cabecera) | BudgetGNotes | — |
Products[].ProductID / VoucherID / PackID / SubscriptionID | {productID} en la ruta | Los cuatro ids mutuamente excluyentes se funden en uno: el id del producto de la línea, sea del tipo que sea, de la tarifa de la clínica desde la que llamas. La V1 lo traducía a la tarifa de la clínica; la V2 no. Locálizalo con GET /tariff/{productGID}/product. |
Products[].ProductUnits | BudgetUnits | Mayor que 0. |
Products[].ProductPrice | BudgetPrice (PUT …/detail/{budgetID}) | Con IVA en V2; la V1 tomaba el precio sin IVA. Multiplica por (1 + IVA) al portar. Solo hace falta cuando el precio difiere del de tarifa. |
Products[].Comments | BudgetProductComments | — |
| — | BudgetProductUserID, BudgetGDate, BudgetGTitle | Nuevos. |
Qué cambia respecto a V1
Sección titulada «Qué cambia respecto a V1»| Tema | API V1 | API V2 |
|---|---|---|
| Atomicidad | Todo o nada: al menos una línea, y cada línea con precio y unidades, o no se guardaba nada. | Cada llamada se guarda por su cuenta. Un fallo en el paso 2 deja un presupuesto con menos líneas — o con ninguna. |
| Precios | El precio que enviabas, tal cual, sin descuentos automáticos. | El precio de tarifa, con los descuentos automáticos y las promociones avanzadas de la clínica aplicados. Fija un precio a mano solo cuando lo necesites (paso 4). |
| Precios manuales | Siempre permitidos. | Solo si la clínica permite editar a mano los precios del presupuesto. Si no lo permite, el paso 4 responde 200 pero el precio no cambia. Comprueba la línea con el paso 3. |
| La cabecera | Se enviaba una vez, con el presupuesto. | PUT /budget/{id} reemplaza la cabecera entera: el campo que omitas se borra (validez, notas, doctor) y BudgetGDate es obligatorio. Mándala siempre completa. |
| Correo al cliente | No se enviaba nunca. | Guardar la cabecera puede enviarle el presupuesto por correo al cliente si la clínica tiene activado enviar el presupuesto al actualizarlo. |
| Productos internos | Permitidos. | No se permiten en una línea de presupuesto. |
Errores
Sección titulada «Errores»| Paso | Respuesta | Qué significa | Qué hacer |
|---|---|---|---|
1 | 400 166 | Falta el id de cliente. | Envía BudgetGClientID. |
2 | 400 169 | Producto que no está en la tarifa de la clínica, deshabilitado, de un tipo no permitido en presupuesto, presupuesto de otra clínica, o una suscripción con unidades distintas de 1. | Revisa el producto y el clinicID. |
2 | 400 520 | Las unidades deben ser mayores que 0. | Corrige las unidades. |
2 | 400 493 | El presupuesto tiene anticipos y ya no se puede cambiar. | — |
4 | 200 | También cuando el precio no ha cambiado (ver arriba). | Compruébalo con el paso 3. |
5 | 404 168 | No se pudo guardar la cabecera: falta BudgetGDate, el presupuesto está vendido, o no se encuentra. | Manda la cabecera entera. |
5 | 404 493 | El presupuesto tiene anticipos y ya no se puede cambiar. | — |
| cualquiera | 409 16 | No se pudo procesar la petición. | Revisa los ids. |
Si el flujo falla a medias, borra el presupuesto incompleto con DELETE /budget/{budgetGID} (falla con 513 si está aceptado o vendido y con 493 si tiene anticipos), o complétalo al reintentar — no crees uno nuevo.
La V2 añade herramientas por línea que la V1 nunca tuvo: descuentos (POST …/detail/{budgetID}/discount), promociones y códigos promocionales, clonado (POST /budget/{id}/clone), impresión y exportación.