Factuarea API
Factures

Llistar factures rectificatives

Retorna totes les factures rectificatives associades a la factura original. S'utilitza per reconstruir l'arbre original → rectificativa.

GET
/invoices/{invoice}/correctives

Authorization

AuthorizationBearer <token>

A: header

Paràmetres de ruta

invoice*string

Cos de la resposta

application/json

application/json

application/json

application/json

application/json

{
  "data": [
    {
      "id": "01931b3e-7c4a-7f2e-9a8b-3c5d6e7f8a60",
      "object": "invoice",
      "number": "RECT-2026-00007",
      "is_number_assigned": true,
      "type": "R1",
      "series": {
        "id": "01931b3e-7c4a-7f2e-9a8b-3c5d6e7f8b04",
        "code": "RECT-2026"
      },
      "client": {
        "id": "01931b3e-7c4a-7f2e-9a8b-3c5d6e7f8a01",
        "name": "Acme Soluciones SL"
      },
      "status": "issued",
      "issued_on": "2026-03-22",
      "due_on": "2026-04-21",
      "subtotal": -500,
      "taxes_total": -105,
      "total": -605,
      "currency": "EUR",
      "notes": "Rectificativa por descuento comercial sobre FAC-2026-00010.",
      "external_id": "ERP-RECT-2026-0007",
      "lines": [
        {
          "object": "invoice_line",
          "description": "Rectificació: descompte comercial 5 h consultoria",
          "product": {
            "id": "01931b3e-7c4a-7f2e-9a8b-3c5d6e7f8b03",
            "name": "Consultoría técnica (hora)"
          },
          "quantity": 5,
          "unit_price": -100,
          "tax_rate": 21,
          "discount_percent": 0,
          "subtotal": -500,
          "taxes": -105,
          "total": -605
        }
      ],
      "metadata": {
        "order_id": "PO-2026-0010"
      },
      "tags": [
        "rectificativa",
        "cliente-vip"
      ],
      "custom_fields": [
        {
          "field": "centro_coste",
          "value": "CC-2026-001"
        }
      ],
      "operation_regime": "general",
      "exclude_347": false,
      "verifactu_status": "accepted",
      "paid_amount": 0,
      "pending_amount": -605,
      "payments": {
        "detail": [],
        "total": 0,
        "pending": -605
      },
      "is_corrective": true,
      "corrective": {
        "original_id": "01931b3e-7c4a-7f2e-9a8b-3c5d6e7f8a10",
        "original_number": "FAC-2026-00010",
        "original_date": "2026-02-01",
        "correction_reason": "R1",
        "correction_type": "por_sustitucion",
        "correction_nature": "S",
        "base_rectificada": -500,
        "cuota_rectificada": -105,
        "correction_aeat_type": "R1"
      },
      "payment": null,
      "public_link": {
        "object": "public_link",
        "url": "https://app.factuarea.com/d/01931b3e-7c4a-7f2e-9a8b-3c5d6e7f8a60",
        "id": "01931b3e-7c4a-7f2e-9a8b-3c5d6e7f8a60",
        "enabled": true,
        "expires_at": "2026-09-22T23:59:59Z",
        "max_days": 120
      },
      "substituted_by": {
        "id": "01931b3e-7c4a-7f2e-9a8b-3c5d6e7f8a50",
        "number": "FAC-2026-00050"
      },
      "recurring": {
        "id": "01931b3e-7c4a-7f2e-9a8b-3c5d6e7f8a08"
      },
      "paid_at": null,
      "paid_on": null,
      "sent_at": "2026-03-22T09:10:00Z",
      "voided_at": null,
      "void_reason": null,
      "created_at": "2026-03-22T09:00:00Z",
      "updated_at": "2026-03-22T09:10:00Z"
    }
  ]
}

{
  "error": {
    "type": "authentication_error",
    "code": "missing_api_key",
    "message": "No se ha proporcionado una API key válida en el header Authorization.",
    "param": null,
    "doc_url": "https://docs.factuarea.com/guides/errors#missing_api_key",
    "request_id": "req_01HKQS5N8VR7QXJ9K3T6BWPMZA"
  }
}

{
  "error": {
    "type": "authorization_error",
    "code": "insufficient_scope",
    "message": "Esta API key no tiene el scope requerido para esta operación.",
    "param": null,
    "doc_url": "https://docs.factuarea.com/guides/errors#insufficient_scope",
    "request_id": "req_01HKQS5NBC3P8M1KX4V7SLNHQD"
  }
}

{
  "error": {
    "type": "rate_limit_error",
    "code": "rate_limit_exceeded",
    "message": "Has excedido el rate limit de 60 peticiones por minuto. Reintenta tras 30 segundos.",
    "param": null,
    "doc_url": "https://docs.factuarea.com/guides/errors#rate_limit_exceeded",
    "request_id": "req_01HKQS5NKW1C6W9T4G5H0JBZVL"
  }
}

{
  "error": {
    "type": "api_error",
    "code": "internal_error",
    "message": "Ha ocurrido un error inesperado. Si persiste, contacta con soporte adjuntando el request_id.",
    "param": null,
    "doc_url": "https://docs.factuarea.com/guides/errors#internal_error",
    "request_id": "req_01HKQS5NLX2D7X0U5H6J1KCAWM"
  }
}

Generar factura rectificativa

Genera una factura rectificativa que corregeix una factura emesa anteriorment. La rectificativa es retorna com una nova Invoice amb `type: "corrective"` que referencia l'original.

Crea una factura

Crea una nova factura de venda. La factura es crea en estat `draft` per defecte i s'envia a AEAT VeriFactu de manera asíncrona. Admet `Idempotency-Key` per a reintents segurs.