Crear asiento contable de facturas recibidas

POST /api/common/contabilidad/asientosconbables/recibidas V4

Descripción

Genera asientos contables a partir de facturas recibidas (facturas de proveedor). Requiere datos del proveedor, fecha, cuentas contables, importe total y desglose de IVA por línea (base, cuota, tipo y código).

Parámetros de consulta

Parámetro	Tipo	Requerido	Descripción
`codigoEmpresa`	int	✅ (si es multiempresa)	Código de la empresa

Campos del cuerpo *

Campo	Tipo	Requerido	Descripción
`codigoProveedor`	string	✅	Código del proveedor
`fechaFactura`	string	✅	Fecha de la factura (`YYYY-MM-DD`)
`serieFactura`	string	❌	Serie de la factura
`importeFactura`	decimal	✅	Importe total de la factura (con IVA)
`comentario`	string	❌	Comentario del asiento
`libre`	string	❌	Campo libre (p. ej. número de factura del proveedor)
`url`	string	❌	URL del documento adjunto
`codigoCuenta`	string	❌	Cuenta contable del proveedor (p. ej. `410000010`)
`codigoCuentaGastos`	string	❌	Cuenta de gastos (p. ej. `629000000`)
`codigoCuentaIVARepercutido`	string	❌	Cuenta de IVA devengado (477) para autorrepercusión en facturas intracomunitarias o de inversión del sujeto pasivo. Si se omite, se usa `477000000000`
`codigoTransaccion`	string	❌	Código de transacción
`codigoProyecto`	string	❌	Código de proyecto
`codigoRetencion`	int	❌	Código de retención
`codigoCuentaRetencion`	string	❌	Cuenta contable de retención
`baseRetencion`	decimal	❌	Base de retención
`porRetencion`	decimal	❌	Porcentaje de retención
`importeRetencion`	decimal	❌	Importe de retención
`numeroFacturaForzado`	int	❌	Fuerza el número de factura contable indicado, en lugar de tomar el siguiente de la secuencia
`lineasIVA`	array	❌	Desglose de IVA por línea
`lineasCanales`	array	❌	Desglose por canales analíticos
`lineasSuplidos`	array	❌	Desglose de suplidos

Campos de `lineasIVA`

Campo	Tipo	Requerido	Descripción
`codigoCuentaIVA`	string	❌	Cuenta contable del IVA soportado (p. ej. `472000001`)
`codigoTransaccion`	string	❌	Código de transacción de la línea
`porcentajeIVA`	decimal	✅	Porcentaje de IVA (p. ej. `21`)
`codigoIVA`	int	❌	Código del tipo de IVA
`baseImponible`	decimal	✅	Base imponible
`cuotaIVA`	decimal	✅	Cuota de IVA

Campos de `lineasCanales`

Campo	Tipo	Requerido	Descripción
`importeDesglose`	decimal	✅	Importe del canal
`codigoTransaccion`	string	❌	Código de transacción
`codigoCuentaCanal`	string	❌	Cuenta contable del canal
`comentario`	string	❌	Comentario
`cuotaIva`	decimal	❌	Cuota de IVA del canal
`codigoCanal`	string	❌	Código de canal
`codigoDepartamento`	string	❌	Código de departamento
`codigoProyecto`	string	❌	Código de proyecto
`codigoSeccion`	string	❌	Código de sección
`idDelegacion`	string	❌	Identificador de delegación

Campos de `lineasSuplidos`

Campo	Tipo	Requerido	Descripción
`codigoTransaccion`	string	❌	Código de transacción
`codigoCuentaSuplido`	string	❌	Cuenta contable del suplido
`importeSuplido`	decimal	✅	Importe del suplido
`comentario`	string	❌	Comentario

Ejemplos

Factura de proveedor (caso básico con canales)

Útil cuando el importe de gastos se distribuye entre varios canales analíticos. No se usa codigoCuentaGastos; en su lugar se detallan los importes por canal en lineasCanales.

[
  {
    "codigoProveedor": "000010",
    "fechaFactura": "2026-05-21",
    "comentario": "Factura con canales",
    "libre": "FAC-027",
    "url": "http://www.google.es",
    "importeFactura": 1210,
    "codigoCuenta": "410000010",
    "codigoTransaccion": "1",
    "lineasIVA": [
      {
        "codigoTransaccion": "1",
        "porcentajeIVA": 21,
        "codigoIVA": 21,
        "baseImponible": 1000,
        "cuotaIVA": 210,
        "codigoCuentaIVA": "472000001"
      }
    ],
    "lineasCanales": [
      {
        "codigoCuentaCanal": "629000001",
        "codigoCanal": "CANAL1",
        "importeDesglose": 600,
        "comentario": "Canal Madrid"
      },
      {
        "codigoCuentaCanal": "629000002",
        "codigoCanal": "CANAL2",
        "importeDesglose": 400,
        "comentario": "Canal Barcelona"
      }
    ]
  }
]

Con suplidos

Los suplidos son importes adicionales que no forman parte de la base imponible del IVA (p. ej. portes pagados por cuenta del proveedor). Se añaden en lineasSuplidos y su importe se suma al total de la factura.

[
  {
    "codigoProveedor": "000010",
    "fechaFactura": "2026-05-21",
    "comentario": "Factura con suplido",
    "libre": "FAC-028",
    "url": "http://www.google.es",
    "importeFactura": 1310,
    "codigoCuenta": "410000010",
    "codigoCuentaGastos": "629000000",
    "codigoTransaccion": "1",
    "lineasIVA": [
      {
        "codigoTransaccion": "1",
        "porcentajeIVA": 21,
        "codigoIVA": 21,
        "baseImponible": 1000,
        "cuotaIVA": 210,
        "codigoCuentaIVA": "472000001"
      }
    ],
    "lineasSuplidos": [
      {
        "codigoCuentaSuplido": "629000099",
        "importeSuplido": 100,
        "comentario": "Portes"
      }
    ]
  }
]

Con dos líneas de IVA

Cuando la factura incluye artículos con distintos tipos impositivos, se añade una entrada en lineasIVA por cada tipo.

[
  {
    "codigoProveedor": "000010",
    "fechaFactura": "2026-05-21",
    "comentario": "Factura proveedor nuevo",
    "libre": "FAC-029",
    "url": "http://www.google.es",
    "importeFactura": 1760,
    "codigoCuenta": "410000010",
    "codigoCuentaGastos": "629000000",
    "codigoTransaccion": "1",
    "lineasIVA": [
      {
        "codigoTransaccion": "1",
        "porcentajeIVA": 21,
        "codigoIVA": 21,
        "baseImponible": 1000,
        "cuotaIVA": 210,
        "codigoCuentaIVA": "472000001"
      },
      {
        "codigoTransaccion": "1",
        "porcentajeIVA": 10,
        "codigoIVA": 10,
        "baseImponible": 500,
        "cuotaIVA": 50,
        "codigoCuentaIVA": "472000002"
      }
    ]
  }
]

Respuesta exitosa (200)

{
  "success": true,
  "message": "Todos los asientos procesados correctamente.",
  "result": [
    { "success": true, "message": "Asiento procesado correctamente." }
  ]
}

Respuesta con errores (400)

Si uno o más asientos fallan, se devuelve un 400 con el detalle por asiento:

{
  "success": false,
  "message": "Errores al procesar uno o más asientos.",
  "result": [
    { "success": true, "message": "Asiento procesado correctamente." },
    { "success": false, "message": "Descripción del error." }
  ]
}