Ir al contenido

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.

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
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 /budgetVentas - Presupuestos → Crear
GET /tariff/{productGID}/productTarifas - Productos → Productos - Listar
DELETE /budget/{budgetGID}Ventas - Presupuestos → Borrar
POST /budget/{id}/cloneClientes - Odontograma → Clonar presupuesto
GET /budgetVentas - Presupuestos → Listar
  • 1POST /budget?clinicID={n}
    {"BudgetGClientID": id} → 201 {"BudgetGID": 109}
    ClientID y ClinicID de Budgetdata
  • 2POST /budget/{budgetGID}/detail/product/{productID}
    Una vez por línea, con {"BudgetUnits": n, "BudgetProductComments": "…"} → 200 con el cuerpo vacío
    Products[] de Budgetdata
  • 3GET /budget/{budgetGID}
    Lee los ids de línea (Details[].BudgetID) y los precios que ha aplicado la tarifa
    Sin equivalente en V1
  • 4PUT /budget/{budgetGID}/detail/{budgetID}
    Solo para un precio distinto al de tarifa: {"BudgetPrice": p}, IVA incluido
    ProductPrice
  • 5PUT /budget/{budgetGID}
    Completa la cabecera, siempre entera: fecha, validez, doctor, notas
    ValidityDate, DoctorID, Comments, Status

El mismo presupuesto, llamada a llamada:

API V1 — una 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.

API V2 — 1. Crea la cabecera
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}
2. Añade una línea por producto
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.
3. Lee el presupuesto para obtener los ids de línea y los precios aplicados
curl --location 'https://api.flowww.net/v2/budget/109?clinicID=1' \
--header 'Authorization: Bearer <api_key>'

Cada línea de Details[] lleva su BudgetID.

4. Solo si necesitas un precio distinto al de tarifa: fíjalo (IVA incluido)
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}'
5. Completa la cabecera — siempre entera
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.

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.

Abandonar un presupuesto
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.

V1 (Budgetdata)API V2Notas
ClientIDBudgetGClientID (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.
ValidityDateBudgetGValidity (PUT /budget/{id})Cambia el formato: yyyy-mm-dd → dd/MM/yyyy.
DoctorIDBudgetGDoctorIDLa V2 tiene además BudgetGUserID para el comercial (el usuario de API por defecto).
StatusBudgetGStatusLos 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 rutaLos 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[].ProductUnitsBudgetUnitsMayor que 0.
Products[].ProductPriceBudgetPrice (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[].CommentsBudgetProductComments—
—BudgetProductUserID, BudgetGDate, BudgetGTitleNuevos.
TemaAPI V1API V2
AtomicidadTodo 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.
PreciosEl 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 manualesSiempre 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 cabeceraSe 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 clienteNo 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 internosPermitidos.No se permiten en una línea de presupuesto.
PasoRespuestaQué significaQué hacer
1400 166Falta el id de cliente.Envía BudgetGClientID.
2400 169Producto 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.
2400 520Las unidades deben ser mayores que 0.Corrige las unidades.
2400 493El presupuesto tiene anticipos y ya no se puede cambiar.—
4200También cuando el precio no ha cambiado (ver arriba).Compruébalo con el paso 3.
5404 168No se pudo guardar la cabecera: falta BudgetGDate, el presupuesto está vendido, o no se encuentra.Manda la cabecera entera.
5404 493El presupuesto tiene anticipos y ya no se puede cambiar.—
cualquiera409 16No 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.