Models AEAT (303, 390, 347, 349, 111, 130…) en Odoo Community: què porta de sèrie i què aporta OCA

El punt de partida: Community et dóna la comptabilitat, no les declaracions

Si instal·les la localització espanyola a Odoo, el mòdul l10n_es ("Spain - Accounting (PGCE 2008)") t'aporta el pla comptable, els impostos i les posicions fiscals. Això és la base comptable, no les declaracions a Hisenda. La pregunta que es fa tothom qui gestiona una pime o una assessoria amb Odoo Community és: puc treure el model 303, el 347 o el 390 tal qual, llestos per presentar? I la resposta honesta és: no amb el core de Community a seques.

Hi ha dos camins per aconseguir les declaracions AEAT a Odoo, i convé tenir-los clars des del principi perquè impliquen cost i arquitectura diferents: la via Enterprise (mòduls oficials d'Odoo S.A.) i la via Community (mòduls de la comunitat OCA). Verifiquem-ne cadascun.

Via Enterprise: els models natius viuen a l10n_es_reports (i són de pagament)

A Odoo Enterprise, les declaracions AEAT apareixen com a informes fiscals dinàmics. La documentació oficial d'Odoo 19 ho descriu així: per accedir als models vas a Comptabilitat ‣ Informes ‣ Informe d'impostos i tries entre Mod 111, 115, 130, 303, 347, 349 i 390 en la seva versió espanyola (ES).

Aquests informes els aporta el mòdul l10n_es_reports (més les seves actualitzacions anuals l10n_es_reports_2024 i l10n_es_reports_2025). I aquí està la clau del Community vs Enterprise: la mateixa guia de desenvolupament d'Odoo diu que els informes de comptabilitat s'implementen en un mòdul l10n_XX_reports que ha d'anar al "repositori enterprise" i que depèn d'account_reports.

Accounting reports should be added via a separate module l10n_XX_reports that should go to the enterprise repository. (Documentació de desenvolupament d'Odoo, howto de localització comptable)

account_reports (el motor d'informes comptables dinàmics) és un mòdul Enterprise. Per tant, l10n_es_reports —i amb ell els models 303/347/349/390 "natius" d'Odoo— només està disponible amb llicència Enterprise. En Community aquest mòdul no és instal·lable perquè li falta la seva dependència. No és un bug ni una limitació configurable: és la línia de separació entre les dues edicions.

Via Community: OCA/l10n-spain i la família l10n_es_aeat

L'alternativa real i madura per a Community és el projecte l10n-spain de l'OCA (Odoo Community Association) a GitHub. Allà viu una família de mòduls, tots amb llicència AGPL-3, que implementen les declaracions AEAT sense dependre d'Enterprise. La peça central és el mòdul base l10n_es_aeat.

El mòdul base: l10n_es_aeat

l10n_es_aeat es descriu com a "Modulo base para declaraciones de la AEAT" (mòdul base per a declaracions de l'AEAT). No genera cap model per si sol: aporta la infraestructura comuna (model de dades i vistes de declaració, seqüències per tipus de model, motor d'exportació a format BOE, gestió de certificats, mapatge d'impostos). Cada model concret és un mòdul a part que es recolza en aquesta base.

Els mòduls per model (branca 19.0)

Verificat contra la branca 19.0 del repositori OCA/l10n-spain, aquests són els mòduls AEAT disponibles, amb el seu nom tècnic exacte:

• ▸l10n_es_aeat_mod111 — "AEAT modelo 111" (retencions IRPF de rendiments del treball i activitats professionals)
• ▸l10n_es_aeat_mod115 — "AEAT modelo 115" (retencions per arrendament d'immobles)
• ▸l10n_es_aeat_mod123 — "AEAT modelo 123" (retencions sobre rendiments del capital mobiliari)
• ▸l10n_es_aeat_mod130 — "AEAT modelo 130" (pagament fraccionat IRPF d'autònoms en estimació directa)
• ▸l10n_es_aeat_mod190 — "AEAT modelo 190" (resum anual de retencions del 111)
• ▸l10n_es_aeat_mod216 — "AEAT modelo 216" (rendes de no residents)
• ▸l10n_es_aeat_mod296 — "AEAT modelo 296" (resum anual retencions no residents)
• ▸l10n_es_aeat_mod303 — "AEAT modelo 303" (autoliquidació trimestral d'IVA)
• ▸l10n_es_aeat_mod347 — "AEAT modelo 347" (operacions amb tercers >3.005,06 €)
• ▸l10n_es_aeat_mod349 — "AEAT modelo 349" (operacions intracomunitàries)
• ▸l10n_es_aeat_mod390 — "AEAT modelo 390" (resum anual d'IVA)
• ▸l10n_es_aeat_partner_check — "AEAT - Comprobación de Calidad de datos identificativos"
• ▸l10n_es_aeat_sii_oca — "Suministro Inmediato de Información en el IVA" (SII)

Detalls verificats als manifests de la branca 19.0 que convé conèixer pel seu valor pràctic: l10n_es_aeat_mod303 depèn de l10n_es i l10n_es_aeat; l10n_es_aeat_mod390 depèn directament de l10n_es_aeat_mod303 (el resum anual es recolza en els 303 de l'exercici); l10n_es_aeat_mod347 arrossega a més account_tax_balance, base_vat i portal; i l10n_es_aeat_mod130 (autònoms) depèn de l10n_es_aeat. Tots són AGPL-3 i mantinguts per la comunitat (autors com Tecnativa, Guadaltech, AvanzOSC, ForgeFlow i la mateixa OCA).

Compte amb les branques: no tot està portat a cada versió

El projecte OCA s'organitza per branques que corresponen a cada versió d'Odoo (16.0, 17.0, 18.0, 19.0…). Un mateix mòdul pot existir en una branca i encara no estar portat a una altra. Per exemple, a la branca 17.0 figuren mòduls addicionals que amplien la cobertura:

• ▸l10n_es_aeat_mod303_oss — "AEAT modelo 303 - OSS" (finestreta única / One-Stop Shop)
• ▸l10n_es_aeat_mod390_oss — "AEAT modelo 390 - OSS"
• ▸l10n_es_aeat_mod369 — "AEAT modelo 369" (règim OSS/IOSS de comerç electrònic)
• ▸l10n_es_aeat_mod592 — "AEAT modelo 592" (impost sobre envasos de plàstic no reutilitzables)
• ▸l10n_es_aeat_sii_oss / l10n_es_aeat_sii_match / l10n_es_aeat_sii_invoice_summary — complements de SII

La regla honesta abans de comprometre una implantació: no donis per fet que el model que necessites està a la teva versió d'Odoo. Entra a github.com/OCA/l10n-spain, selecciona la branca de la teva versió i comprova que existeix la carpeta del mòdul i que el seu README no el marca com a beta o sense mantenidor. Els models d'IVA i retencions més comuns (303, 390, 347, 349, 111, 115, 130) estan coberts a les branques modernes; els més especialitzats o els OSS poden anar per darrere.

SII, Veri*Factu i TicketBAI: capítol a part

A més dels models periòdics, hi ha obligacions de subministrament d'informació en temps gairebé real. Aquí conviuen de nou les dues vies. Per al SII (Subministrament Immediat d'Informació de l'IVA), Community compta amb l10n_es_aeat_sii_oca d'OCA, mentre que Enterprise ho resol amb el seu propi mòdul l10n_es_edi_sii. Per a la facturació electrònica/verificable, la documentació d'Odoo esmenta Veri*Factu i TicketBAI (aquest darrer, e-invoicing de les Diputacions Forals del País Basc) com a mòduls d'instal·lació manual dins de la localització.

El missatge pràctic: si la teva obligació inclou SII o Veri*Factu, avalua-ho per separat del bloc de "models" clàssics, perquè el repartiment Community/Enterprise i la maduresa de cada peça no és el mateix.

Com decidir: checklist honest

1. 1.Llista les teves obligacions reals: 303 i 390? 347/349? retencions 111/115/130/190? SII? Cadascuna és un mòdul diferent.
2. 2.Mira la teva versió d'Odoo i vés a la branca corresponent a OCA/l10n-spain. Confirma que existeix la carpeta del mòdul per model i el seu estat.
3. 3.Si vas amb Community, compta amb instal·lar l10n_es_aeat (base) + un mòdul per cada model que necessitis. Són AGPL-3, gratuïts, però requereixen instal·lació, actualització i proves.
4. 4.Si vas amb Enterprise, els models natius (l10n_es_reports + actualitzacions anuals) te'ls dóna la subscripció, integrats a Informes d'impostos, però és una llicència de pagament.
5. 5.No barregis a cegues: els mòduls OCA (l10n_es_aeat_*) i els natius Enterprise (l10n_es_reports) resolen el mateix per camins diferents; convé triar-ne un i ser coherent.
6. 6.Valida sempre el fitxer de sortida contra el portal de l'AEAT abans de donar per bo qualsevol model, sigui Community o Enterprise. L'exportació a BOE és una ajuda, no una garantia que les teves dades quadrin.

Vols ajuda per muntar (i validar) els teus models AEAT a Odoo?

A skanndar treballem Odoo amb criteri: sense fum sobre el que porta de sèrie i el que no. Si estàs en Community i vols presentar els teus models amb els mòduls d'OCA ben instal·lats i provats, o estàs decidint entre Community + OCA i Enterprise per al teu cas concret, et podem fer una auditoria curta i honesta de la teva configuració fiscal a Odoo Espanya i acompanyar-te en el suport. Escriu-nos i ho veiem amb les teves obligacions reals sobre la taula.