Factuarea APIDevelopers

Factures simplificades o completes

F1, F2 i F3 — quan és legal una factura simplificada, el topall de 3.000 € que sí que s'aplica de debò, com emetre'n una per l'API, la factura simplificada qualificada que identifica el seu destinatari i la substitució en una sola crida que converteix un lot de tiquets en una factura completa.

La llei espanyola distingeix la factura completa (F1), que identifica el destinatari i li permet deduir l'IVA, de la factura simplificada (F2), el tiquet que el comerç lliura al taulell. Quan un client necessita després un document deduïble per un lot de tiquets, la llei preveu un tercer tipus: la factura substitutiva (F3), que agrega diverses simplificades. I una factura simplificada que ja identifica el seu destinatari és una factura simplificada qualificada: permet al destinatari deduir l'IVA, i l'AEAT la registra com una F1 (més avall).

Quan aplica

La factura simplificada està disponible en operacions de tipus minorista per sota d'un import legal. Mai no ho està en els casos de baix, i la comprovació d'admissibilitat els avalua en aquest ordre exacte — guanya el primer que casa:

Condició que la bloquejareason_code
Operació intracomunitàriaintra_community
Inversió del subjecte passiureverse_charge
Destinatari fora d'Espanya (exportació)export_operation
El client necessita una factura deduïbleclient_deduction_required
Total per damunt del topall legal absolutover_absolute_limit

El topall que el programari sí que aplica és de 3.000 € amb l'IVA inclòs — el màxim que pot assolir qualsevol factura simplificada segons el RD 1619/2012 art. 4, sigui quin sigui el sector. Superar-lo respon 422 amb el codi de motiu over_absolute_limit (BR-INV-009).

El llindar general de 400 € del mateix article no s'aplica. Factuarea no demana a l'empresa que declari el seu sector econòmic, així que no pot saber si li correspon el límit elevat. Mantenir-se per sota de 400 € quan el teu sector no dona dret a la xifra més alta és responsabilitat fiscal de l'emissor, no pas una cosa que l'API t'hagi d'impedir.

El catàleg d'impostos no canvia entre els dos tipus. A una F1 i a una F2 els apliquen els mateixos tipus d'IVA; el que difereix és el contingut obligatori del document, el topall d'import i la identificació del destinatari (BR-TAX-011).

Què envia l'API

Pregunta abans de decidir

POST /v1/companies/{company}/invoices/simplified-eligibility, scope invoices:read. Pensat per a fluxos de caixa i de punt de venda que han de triar el tipus de document abans de crear res.

curl -X POST https://api.factuarea.com/v1/companies/{company}/invoices/simplified-eligibility \
  -H "Authorization: Bearer fact_live_3pXnR2VbY7TcA9eFmN5z8KqW" \
  -H "Content-Type: application/json" \
  -d '{"total": 3400, "client_country": "ES"}'
{
  "data": {
    "can_be_simplified": false,
    "must_be_complete": true,
    "reason_code": "over_absolute_limit",
    "reason_message": "El importe 3.400,00 EUR supera el límite de 3.000,00 EUR para una factura simplificada.",
    "sector_limit": 3000
  }
}

total és obligatori i és l'import amb l'IVA inclòs. client_id, client_country, is_intra_community, is_reverse_charge i client_requires_deductible són entrades opcionals a les condicions de bloqueig de dalt.

Emetre una factura simplificada per la v1

POST /v1/companies/{company}/invoices accepta type amb els valors F1 (el valor per defecte) o F2. Amb type: "F2":

  • client_id és opcional. Sense ell la factura és un tiquet anònim; amb un, és una factura simplificada qualificada. El client ha de pertànyer a la teva empresa.
  • L'empresa ha de tenir habilitades les factures simplificades; si no, la resposta és 422 simplified_invoices_disabled. La comprovació fa servir l'empresa de l'API key, no un usuari.
  • La factura ha de ser admissible: topall absolut de 3.000 € IVA inclòs, i cap operació intracomunitària, amb inversió del subjecte passiu ni d'exportació. Si no ho és, 422 business_rule_violation amb subcode: simplified_invoice_not_allowed i el motiu al missatge.
  • series_id és opcional. Una factura simplificada només es numera en una sèrie de factures simplificades (invoice_kind: simplified): sense series_id va a la teva sèrie de simplificades per defecte (S), que es crea sola la primera vegada; amb el series_id d'un altre propòsit la resposta és 422 series_invoice_kind_mismatch. GET /v1/companies/{company}/series/default?document_type=invoice&invoice_kind=simplified retorna la sèrie que has d'usar. La rectificativa d'una simplificada va a la seva pròpia sèrie (simplified_corrective, RS).

Amb type: "F1" o sense type, client_id continua sent obligatori i el client ha de tenir NIF complet.

El flux habitual d'un punt de venda —una F2 ja cobrada, amb els preus que va veure el client, l'alta VERI*FACTU i el seu QR a la mateixa resposta— és a Facturació des de terminals desatesos.

Una línia de suplert no s'admet dins d'una factura simplificada: la resposta és 422 suplido_not_allowed_in_simplified_invoice, tant si crees la F2 com si la rectifiques. Consulta Suplerts.

La factura simplificada qualificada

Una factura simplificada que porta el NIF del destinatari és una factura simplificada qualificada (RD 1619/2012, art. 7.2 i 7.3): continua sent una factura simplificada, però el destinatari pot deduir l'IVA. L'AEAT rebutja una F2 que tingui destinatari (error 1190), així que Factuarea la registra així:

FacturaTipoFacturaMarca
Simplificada, sense NIFF2—
Simplificada amb el NIF del destinatariF1FacturaSimplificadaArt7273=S
Rectificativa d'una simplificada sense NIFR5—
Rectificativa d'una qualificadaR1 a R4, segons el motiuFacturaSimplificadaArt7273=S

A Factuarea la factura continua sent simplificada en el seu tipus, el seu PDF i la seva numeració: només canvia el registre que s'envia a l'AEAT. Per qualificar una factura, envia type: "F2" amb un client_id que tingui NIF.

Substituir factures simplificades, en una sola crida

POST /v1/companies/{company}/invoices/substitute-simplified, scope invoices:write. Passes el destinatari i la llista de factures simplificades que vols agregar; reps una F3 completa, ja emesa, amb número definitiu de sèrie:

curl -X POST https://api.factuarea.com/v1/companies/{company}/invoices/substitute-simplified \
  -H "Authorization: Bearer fact_live_3pXnR2VbY7TcA9eFmN5z8KqW" \
  -H "Content-Type: application/json" \
  -d '{
        "client_id": "0197a2a8-4cf0-7a31-9a5e-3f2b8c1d6e42",
        "simplified_invoice_ids": [
          "0197b1c2-3d4e-7f50-8a61-b2c3d4e5f601",
          "0197b1c2-3d4e-7f50-8a61-b2c3d4e5f602"
        ],
        "notes": "Consumos de junio"
      }'

Cada factura simplificada de la llista es valida (BR-INV-015): la llista no pot estar buida ni tenir duplicats, cada factura ha de pertànyer a la teva empresa, cadascuna ha de ser realment una F2, cap no pot estar anul·lada ni cancel·lada, i cap no pot tenir ja una substitutiva. Quan falla, el 422 anomena el número de la factura que ho provoca.

La F3 neix emesa, i les seves línies són agregats: una línia per factura substituïda, descrita com la substitució d'aquest número de factura, amb quantitat un i el total brut original com a preu unitari, i sense impost propi — l'IVA ja es va repercutir a la factura simplificada.

La substitució no anul·la els originals. Cada F2 conserva el seu estat fiscal i simplement deixa constància que ha estat substituïda; l'objecte factura ho exposa com a substituted_by. Una F3 sí que es pot rectificar, com qualsevol factura completa —els codis R1–R4 valen igual per a una F1 que per a una F3, vegeu Factures rectificatives—. El que una F3 no pot ser és substituïda: només una F2 pot ser objecte d'una substitució, i només una F3 pot portar factures substituïdes (BR-INV-016).

Què surt al PDF

La diferència visible és el bloc de destinatari. Una factura completa imprimeix el nom, el NIF i l'adreça del destinatari, congelats en el moment d'emetre; una de simplificada pot legítimament no tenir-ne cap, i imprimeix al seu lloc el marcador de consumidor final; una de qualificada imprimeix el seu destinatari (BR-INV-024). La data de l'operació s'imprimeix al costat de la d'emissió quan difereix, i una factura simplificada també es pot imprimir com a tiquet tèrmic (ticket_80 o ticket_58, consulta Facturació des de terminals desatesos).

La F3 s'imprimeix com una factura completa ordinària — un bloc de destinatari complet i una línia per cada tiquet substituït, anomenant cada número de factura substituïda.

Què arriba a l'AEAT

El tipus de factura viatja com el TipoFactura de l'AEAT al registre VeriFactu i és visible a l'objecte registre com a invoice_type: F1, F2, F3, o R5 per a una rectificativa d'una simplificada. Una factura simplificada qualificada es declara com a F1 amb FacturaSimplificadaArt7273, i la seva rectificativa com a R1 a R4 amb la mateixa marca. El registre assenyala a més si substitueix factures simplificades (BR-VFC-014).

El tipus també té conseqüències a les declaracions periòdiques (BR-TXR-004):

  • Una F3 sense NIF de destinatari aixeca un avís no bloquejant a la declaració trimestral d'IVA: és inusual, però legítim si el tiquet original tampoc no en tenia.
  • Una F2 amb client registrat però sense NIF aixeca també un avís.
  • Una F2 sense cap NIF queda exclosa de la declaració anual d'operacions amb terceres persones (Modelo 347) per norma de l'AEAT, i l'exclusió s'informa com a avís.

Cap d'ells no bloqueja la generació. L'informe es produeix i els avisos es retornen al seu costat, com a llista buida quan no n'hi ha cap. Bloquejar seria un fals positiu freqüent.

Traçabilitat

Derivat de les regles de domini del backend de Factuarea:

  • BR-INV-009 — el topall aplicat de 3.000 €, el llindar no aplicat de 400 € i les operacions que descarten la factura simplificada.
  • BR-INV-015 — substitució de factures simplificades per una F3, les seves validacions i les seves línies agregades.
  • BR-INV-016 — només una F3 porta factures substituïdes, i mai una llista buida.
  • BR-INV-024 — el snapshot immutable del destinatari, i la seva absència en un tiquet de consumidor final.
  • BR-TAX-011 — el catàleg d'impostos és idèntic per als dos tipus; el límit pertany a la facturació, no al catàleg.
  • BR-VFC-014 — els tipus de factura de l'AEAT i com es resol el tipus.
  • BR-TXR-004 — avisos no bloquejants de qualitat fiscal per a F2 i F3 sense NIF.

Els codis de motiu del 422 citats a Quan aplica vénen del servei de domini d'admissibilitat que materialitza BR-INV-009.

En aquesta pàgina

Et donem un cop de mà?Contactar amb suport