Skip to content

Servir oferta

POST /api/common/documentos/serviroferta V5

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ámetroTipoRequeridoDescripción
codigoEmpresaint✅ (si es multiempresa)Código de la empresa
CampoTipoRequeridoDescripción
ejercicioOfertaint✅Ejercicio de la oferta
numeroOfertaint✅Número de la oferta
serieOfertastring❌Serie de la oferta
seriePedidostring❌Serie del pedido a crear. Si no se indica, se usa la de la oferta
lineasarray❌Líneas a servir. Si no se envía, se sirven todas las líneas pendientes
lineas[].idLineaguid❌Identificador de la línea (LineasPosicion). Obligatorio si el artículo se repite en la oferta
lineas[].codigoArticulostring❌Código del artículo de la línea
lineas[].unidadesdecimal❌Unidades a servir. Si no se indica, se sirve la línea entera
Terminal window
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 }
]
}'
{
"ejercicioOferta": 0,
"serieOferta": "string",
"numeroOferta": 0,
"seriePedido": "string",
"lineas": [
{
"idLinea": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"codigoArticulo": "string",
"unidades": 0
}
]
}

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

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."
}