Subsanación con registro previo rechazado

Encabezados HTTP

Accept: application/json
X-Qbikode-ClientApiKey: API-KEY de la empresa

curl -H 'Accept: application/json' \
     -H 'X-Qbikode-ClientApiKey: API-KEY de la empresa' \
     …

Cuerpo JSON de la petición

Para subsanar un registro que ha sido rechazado anteriormente por Veri*Factu, y que por tanto no está registrado en la AEAT, debemos enviar el campo correction_key con el valor S y el campo previous_rejection_key con el valor X. El resto de campos del registro se pueden mantener idénticos al original.

Un fallo técnico en el envío no es un rechazo. En ese caso no se subsana: se reenvía el mismo registro sin modificarlo.

Con previous_rejection_key = X se declara que la factura no está registrada en la AEAT. Si en KubiFACTU existe un alta de la misma factura (mismo número y mismo ejercicio o fecha de expedición, en la misma empresa cliente) que ya está registrada en la AEAT o que sigue pendiente de envío, la API rechaza la petición con HTTP 422. Si la factura ya está registrada y necesitas corregirla, utiliza una subsanación ordinaria con previous_rejection_key = N. Si el alta sigue pendiente, espera a conocer su resultado. Más información.

{
  "sif_id": "9db0bca1-187e-4cf4-b87c-96f2044008d7",
  "invoice_type_key": "F1",
  "correction_key": "S",
  "previous_rejection_key": "X",
  "sender_data": {
    "company_name": "Empresa emisora de ejemplo",
    "tax_id_number": "J27290840"
  },
  "recipients": [
    {
      "company_name": "Empresa receptora de ejemplo",
      "tax_id_number": "B99014037"
    }
  ],
  "full_invoice_number": "2026-000018",
  "fiscal_year": 2026,
  "issue_date": "2026-01-03",
  "operation_description": "Factura ordinaria por entrega de mercancías.",
  "total_quota": 21.00,
  "total_amount": 121.00,
  "tax_breakdown": [
    {
      "tax_type_key": "01",
      "vat_tax_regime_key": "01",
      "operation_type_key": "S1",
      "tax_base": 100.00,
      "tax_rate": 21.00,
      "tax_quota": 21.00
    }
  ]
}

Respuesta de error si la AEAT ya tiene la factura

Si el alta original de la factura ya está registrada en la AEAT, la API responde con HTTP 422 e indica el ID en KubiFACTU del registro existente. En el endpoint de lotes, la clave del error es invoices.<n>.previous_rejection_key.

{
  "data": {
    "error": {
      "message": "The given data was invalid.",
      "errors": {
        "previous_rejection_key": [
          "AEAT already holds this invoice, so previous_rejection_key cannot be X. To correct the registered record, send the correction with previous_rejection_key N. Existing invoice ID: [9db6bb78-6799-4abb-b9a0-22d127c543ed]."
        ]
      },
      "details": {
        "request_id": "9ded9e2c-d59e-4432-a926-652cbcfac365"
      }
    }
  }
}

​Encabezados HTTP

​Cuerpo JSON de la petición

​Respuesta de error si la AEAT ya tiene la factura

Encabezados HTTP

Cuerpo JSON de la petición

Respuesta de error si la AEAT ya tiene la factura