Facturar albaranes forzando numeración

POST /api/common/documentos/facturaralbaranes/forzarnumeracion Facturación múltiple de albaranes con numeración forzada V4

Descripción

Factura varios albaranes en una sola operación, igual que POST /facturaralbaranes, pero forzando el número de factura indicado en el body mediante los campos ejercicioFactura y numeroFactura (ambos obligatorios).

Parámetros de consulta

Parámetro	Tipo	Requerido	Descripción
`tipoAlbaran`	enum	✅	Tipo de albarán a facturar
`tipoFecha`	enum	✅	Fecha a utilizar en la factura
`codigoEmpresa`	int	✅ (si es multiempresa)	Código de la empresa

Campos obligatorios *

Campo	Tipo	Requerido	Descripción
`albaranes`	array	✅	Lista de albaranes a facturar
`ejercicioFactura`	int	✅	Ejercicio de la factura a generar
`numeroFactura`	int	✅	Número de factura a asignar manualmente

Body

{
  "albaranes": [
    {
      "ejercicio": 0,
      "numero": 0,
      "serie": "string"
    }
  ],
  "ejercicioFactura": 2026,
  "numeroFactura": 9999,
  "serieFactura": "string",
  "fechaProceso": "2026-04-17T00:00:00.000Z",
  "fechaOperacion": "2026-04-17T00:00:00.000Z",
  "grupoIva": 0,
  "codigoIva": 0,
  "baseIva": 0,
  "cuotaIva": 0,
  "cuotaRecargo": 0,
  "totalIva": 0
}

Funcionamiento

Numeración forzada

ejercicioFactura y numeroFactura son obligatorios en este endpoint.
Sage asignará exactamente ese número a la factura generada, en lugar de usar el contador automático.

Agrupación de facturas

Si los albaranes pueden agruparse en una única factura, se generará una sola.
En caso contrario, se generarán varias facturas. Solo la primera recibirá el número forzado; las demás usarán la numeración automática.

Campos de IVA (solo compras)

Los siguientes campos solo son necesarios al facturar albaranes de compra:

grupoIva
codigoIva
baseIva
cuotaIva
cuotaRecargo
totalIva

Respuesta

{
  "success": true,
  "message": "Albaranes facturados correctamente",
  "result": { }
}