Comando 41 — Actualizar presupuestosmultipaso
Las mismas piezas que el comando 40, aplicadas a un BudgetGID que ya existe. Vale el mapeo de campos del comando 40.
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 |
|---|---|
PUT /budget/{budgetGID} | Ventas - Presupuestos → Guardar |
POST /budget/{budgetGID}/detail/product/{productID} | Ventas - Presupuestos → Añadir producto |
PUT /budget/{budgetGID}/detail/{budgetID} | Ventas - Presupuestos → Editar precio |
PUT /budget/{budgetGID}/detail/{budgetID}/comment | Ventas - Presupuestos → Editar comentarios de un presupuesto |
DELETE /budget/{budgetGID}/detail/{budgetID} | Ventas - Presupuestos → Borrar producto |
DELETE /budget/{budgetGID} | Ventas - Presupuestos → Borrar |
GET /budget/{budgetGID} | Ventas - Presupuestos → Editar |
El flujo
Sección titulada «El flujo»Actualizar tampoco es una sola llamada. El orden es siempre el mismo: léelo, cámbialo y guarda la cabecera entera.
- 1
GET /budget/{budgetGID}
Léelo antes de tocar nada: la cabecera vuelve entera — y entera hay que reenviarla — y cada línea deDetails[]trae suBudgetID
Sin equivalente en V1 - 2
POST /budget/{budgetGID}/detail/product/{productID}
Las líneas, una llamada cada una: añade aquí, cambia el precio conPUT …/detail/{budgetID}y quita conDELETE …/detail/{budgetID}
Products[]deBudgetdata - 3
PUT /budget/{budgetGID}
La cabecera, siempre entera y sinBudgetGStatus: fecha, validez, notas, comercial y doctor
El resto deBudgetdata - 4
PUT /budget/{budgetGID}
El estado viaja solo,{"BudgetGStatus": n}, nunca junto con la cabecera
Comando41b, sin documentar
Cada cambio, llamada a llamada:
Qué llamar para cada cambio
Sección titulada «Qué llamar para cada cambio»| Lo que quieres cambiar | Llamada de V2 |
|---|---|
| Fecha, validez, notas, comercial, doctor | PUT /budget/{budgetGID} con la cabecera entera (sin BudgetGStatus) |
| Solo el estado | PUT /budget/{budgetGID} con {"BudgetGStatus": n} |
| Añadir una línea | POST /budget/{budgetGID}/detail/product/{productID} |
| Cambiar el precio de una línea | PUT /budget/{budgetGID}/detail/{budgetID} con {"BudgetPrice": …} (IVA incluido) |
| Cambiar las unidades de una línea | Borra la línea y vuélvela a añadir con las unidades nuevas. |
| Cambiar el comentario de una línea | PUT /budget/{budgetGID}/detail/{budgetID}/comment |
| Quitar una línea | DELETE /budget/{budgetGID}/detail/{budgetID} |
| Borrar el presupuesto entero | DELETE /budget/{budgetGID} |
Limpiar tras un fallo
Sección titulada «Limpiar tras un fallo»Actualizar no deja nada huérfano — el presupuesto ya estaba — pero tampoco es atómico: cada llamada se guarda por su cuenta, así que una ejecución que muera a medias deja el presupuesto a medio cambiar, con las líneas que sí tocaste y una cabecera que conserva sus valores viejos.
No hay nada que borrar: vuelve a leerlo con GET /budget/{budgetGID}, compáralo con lo que querías dejar y termina las llamadas que falten. Una línea que añadiste y ya no quieres se quita con DELETE /budget/{budgetGID}/detail/{budgetID}.
Reintentar la actualización entera desde el principio es seguro para la cabecera — se reemplaza completa — pero no para las líneas: volver a añadirlas las duplica. Compara antes de reintentar.
Qué cambia respecto a V1
Sección titulada «Qué cambia respecto a V1»| Tema | API V1 | API V2 |
|---|---|---|
| Id del presupuesto | Uno nuevo en cada actualización. | El mismo. |
| Presupuestos vendidos o aceptados | El viejo no se podía borrar, así que quedaba un duplicado. | La cabecera y las líneas se pueden seguir editando, salvo que el presupuesto tenga anticipos. Consulta el estado (GET /budget/{budgetGID}) antes de editar un presupuesto que el cliente ya haya aceptado. |
| Presupuestos caducados | — | Guardar un presupuesto caducado lo devuelve a Pendiente. |
| Solo el estado | Comando 41b no documentado, sin comprobaciones. | PUT con BudgetGStatus. Se rechaza si el presupuesto está vendido o tiene anticipos. |
Errores
Sección titulada «Errores»| Llamada | Respuesta | Qué significa |
|---|---|---|
PUT /budget/{id} | 404 168 | Falta BudgetGDate, el presupuesto está vendido, o no se encuentra. |
PUT /budget/{id} | 404 493 | El presupuesto tiene anticipos y ya no se puede cambiar. |
DELETE …/detail/{budgetID} | 404 | Línea no encontrada, presupuesto de otra clínica (envía su clinicID), presupuesto con anticipos, o una línea de tratamiento que no se puede quitar. |
DELETE /budget/{id} | 400 513 / 493 | El presupuesto está aceptado o vendido / tiene anticipos. |
Borrar un presupuesto que ya se usó en un ticket lo oculta en vez de borrarlo.