Servir oferta
Descripción
Section titled “Descripción”Crea un pedido de cliente a partir de una oferta. Si no se envían líneas, se sirven todas las líneas pendientes de la oferta. Si se indican unidades menores a las de la línea, el pedido se lleva esas unidades y la línea de la oferta queda pendiente. Si no se indica la serie del pedido, se usa la de la oferta.
Parámetros de consulta
Section titled “Parámetros de consulta”| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
codigoEmpresa | int | ✅ (si es multiempresa) | Código de la empresa |
Campos obligatorios *
Section titled “Campos obligatorios *”| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
ejercicioOferta | int | ✅ | Ejercicio de la oferta |
numeroOferta | int | ✅ | Número de la oferta |
serieOferta | string | ❌ | Serie de la oferta |
seriePedido | string | ❌ | Serie del pedido a crear. Si no se indica, se usa la de la oferta |
lineas | array | ❌ | Líneas a servir. Si no se envía, se sirven todas las líneas pendientes |
lineas[].idLinea | guid | ❌ | Identificador de la línea (LineasPosicion). Obligatorio si el artículo se repite en la oferta |
lineas[].codigoArticulo | string | ❌ | Código del artículo de la línea |
lineas[].unidades | decimal | ❌ | Unidades a servir. Si no se indica, se sirve la línea entera |
Ejemplo
Section titled “Ejemplo”curl -X POST "https://api.tandem.com/api/common/documentos/serviroferta" \ -H "Authorization: Bearer tu_access_token" \ -H "Content-Type: application/json" \ -d '{ "ejercicioOferta": 2026, "serieOferta": "ZZ", "numeroOferta": 12, "lineas": [ { "codigoArticulo": "ART001", "unidades": 5 } ] }'Cuerpo de la petición
Section titled “Cuerpo de la petición”{ "ejercicioOferta": 0, "serieOferta": "string", "numeroOferta": 0, "seriePedido": "string", "lineas": [ { "idLinea": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "codigoArticulo": "string", "unidades": 0 } ]}Respuesta (200)
Section titled “Respuesta (200)”Si después de servir no quedan líneas pendientes, el mensaje es Oferta servida y pedido generado correctamente. y la oferta queda servida. Si quedan líneas pendientes, el mensaje es Oferta servida parcialmente y pedido generado correctamente. y la oferta sigue pendiente, así que se puede volver a servir más adelante.
Cuando el pedido no recoge la oferta entera (porque se sirven solo algunas líneas o unidades parciales), sus importes se recalculan en Sage. Si ese recálculo falla, el pedido se crea igualmente y se añade al mensaje un Aviso: con el motivo.
{ "success": true, "message": "Oferta servida parcialmente y pedido generado correctamente.", "result": { "exito": true, "mensaje": "Oferta servida parcialmente y pedido generado correctamente.", "ejercicioPedido": 2026, "seriePedido": "ZZ", "numeroPedido": 45 }}Respuesta con error (400)
Section titled “Respuesta con error (400)”Si no se indica el ejercicio o el número de la oferta:
{ "success": false, "message": "Debe indicar el ejercicio y el número de la oferta."}Si la oferta ya está servida por completo:
{ "success": false, "message": "La oferta ya ha sido servida."}