Recibir pedido

POST /api/common/documentos/recibirpedido/{ejercicioPedido}/{numeroPedido} Genera un albarán a partir de un pedido V4

Descripción

Endpoint para recibir pedidos de compra, generando automáticamente un albarán.

El comportamiento depende de si se envía o no contenido en el body:

• Sin body → Se recibe el pedido completo
• Con body → Se realiza una recepción parcial por líneas

---

Parámetros de ruta

Parámetro	Tipo	Requerido	Descripción
ejercicioPedido	int	✅	Ejercicio del pedido
numeroPedido	int	✅	Número del pedido

---

Parámetros de consulta

Parámetro	Tipo	Requerido	Descripción
seriePedido	string	❌	Serie del pedido
serieAlbaran	string	❌	Serie que se asignará al albarán generado
codigoEmpresa	int	✅ (si es multiempresa)	Código de la empresa

---

Body (opcional)

[
  {
    "codigoArticulo": "string",
    "idLinea": "guid-opcional",
    "fechaAlbaran": "2026-03-18T08:05:50.198Z",
    "unidadesRecibir": 0
  }
]

🧾 Funcionamiento

🔹 Recepción completa

Para recibir un pedido completo:

• No envíes body
• Indica únicamente:
  • ejercicioPedido
  • numeroPedido
  • seriePedido (opcional)
  • serieAlbaran (opcional)
  • codigoEmpresa (si aplica)

👉 Se generará un albarán con todas las líneas recibidas

---

🔹 Recepción parcial por líneas

Para recibir líneas concretas:

• Envía un array en el body con las líneas a recibir
• Debes indicar:
  • codigoArticulo
  • fechaAlbaran
  • unidadesRecibir

---

🔹 Identificación de líneas (caso especial)

Si existen varias líneas con el mismo codigoArticulo:

• Será obligatorio indicar idLinea
• Este identificador corresponde al campo LineasPosicion en base de datos

---

🔹 Recepción parcial de unidades

• Puedes recibir menos unidades de las pendientes
• La línea no se marcará como completa hasta recibir el total esperado
• Simplemente se reducirán las unidades pendientes

---

🔹 Recepción de más unidades de las esperadas

• Está permitido recibir más unidades de las previstas
• La API devolverá un aviso
• El albarán reflejará las unidades reales recibidas

---

⚠️ Importante

• El campo unidadesRecibir es obligatorio cuando se envían líneas
• Si no se indica, la API devolverá un error
• Para recibir el pedido completo, el body debe ir vacío