Ir al contenido

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.

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
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}/commentVentas - 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

Actualizar tampoco es una sola llamada. El orden es siempre el mismo: léelo, cámbialo y guarda la cabecera entera.

  • 1GET /budget/{budgetGID}
    Léelo antes de tocar nada: la cabecera vuelve entera — y entera hay que reenviarla — y cada línea de Details[] trae su BudgetID
    Sin equivalente en V1
  • 2POST /budget/{budgetGID}/detail/product/{productID}
    Las líneas, una llamada cada una: añade aquí, cambia el precio con PUT …/detail/{budgetID} y quita con DELETE …/detail/{budgetID}
    Products[] de Budgetdata
  • 3PUT /budget/{budgetGID}
    La cabecera, siempre entera y sin BudgetGStatus: fecha, validez, notas, comercial y doctor
    El resto de Budgetdata
  • 4PUT /budget/{budgetGID}
    El estado viaja solo, {"BudgetGStatus": n}, nunca junto con la cabecera
    Comando 41b, sin documentar

Cada cambio, llamada a llamada:

Lo que quieres cambiarLlamada de V2
Fecha, validez, notas, comercial, doctorPUT /budget/{budgetGID} con la cabecera entera (sin BudgetGStatus)
Solo el estadoPUT /budget/{budgetGID} con {"BudgetGStatus": n}
Añadir una líneaPOST /budget/{budgetGID}/detail/product/{productID}
Cambiar el precio de una líneaPUT /budget/{budgetGID}/detail/{budgetID} con {"BudgetPrice": …} (IVA incluido)
Cambiar las unidades de una líneaBorra la línea y vuélvela a añadir con las unidades nuevas.
Cambiar el comentario de una líneaPUT /budget/{budgetGID}/detail/{budgetID}/comment
Quitar una líneaDELETE /budget/{budgetGID}/detail/{budgetID}
Borrar el presupuesto enteroDELETE /budget/{budgetGID}

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.

TemaAPI V1API V2
Id del presupuestoUno nuevo en cada actualización.El mismo.
Presupuestos vendidos o aceptadosEl 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 estadoComando 41b no documentado, sin comprobaciones.PUT con BudgetGStatus. Se rechaza si el presupuesto está vendido o tiene anticipos.
LlamadaRespuestaQué significa
PUT /budget/{id}404 168Falta BudgetGDate, el presupuesto está vendido, o no se encuentra.
PUT /budget/{id}404 493El presupuesto tiene anticipos y ya no se puede cambiar.
DELETE …/detail/{budgetID}404Lí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 / 493El presupuesto está aceptado o vendido / tiene anticipos.

Borrar un presupuesto que ya se usó en un ticket lo oculta en vez de borrarlo.