Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
189 changes: 189 additions & 0 deletions l10n_it_edi_fatturhello/README.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,189 @@
================================================
ITA - Fattura elettronica - Supporto Fatturhello
================================================

..
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
!! This file is generated by oca-gen-addon-readme !!
!! changes will be overwritten. !!
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
!! source digest: sha256:7fadf76cbaf92d73b8702e81dc6ae477b235457178106669e643b427c182743f
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!

.. |badge1| image:: https://img.shields.io/badge/maturity-Beta-yellow.png
:target: https://odoo-community.org/page/development-status
:alt: Beta
.. |badge2| image:: https://img.shields.io/badge/licence-AGPL--3-blue.png
:target: http://www.gnu.org/licenses/agpl-3.0-standalone.html
:alt: License: AGPL-3
.. |badge3| image:: https://img.shields.io/badge/github-OCA%2Fl10n--italy-lightgray.png?logo=github
:target: https://github.com/OCA/l10n-italy/tree/18.0/l10n_it_edi_fatturhello
:alt: OCA/l10n-italy
.. |badge4| image:: https://img.shields.io/badge/weblate-Translate%20me-F47D42.png
:target: https://translation.odoo-community.org/projects/l10n-italy-18-0/l10n-italy-18-0-l10n_it_edi_fatturhello
:alt: Translate me on Weblate
.. |badge5| image:: https://img.shields.io/badge/runboat-Try%20me-875A7B.png
:target: https://runboat.odoo-community.org/builds?repo=OCA/l10n-italy&target_branch=18.0
:alt: Try me on Runboat

|badge1| |badge2| |badge3| |badge4| |badge5|

**Italiano**

Questo modulo consente di inviare e ricevere i file XML della fattura
elettronica tramite Fatturhello (https://fatturhello.it).

La ricezione avviene periodicamente, tramite il CRON "IT EDI: Ricezione
fatture dall'SdI". Ad ogni esecuzione tutte le fatture elettroniche
successive a quella configurata (a meno di duplicati) verranno
scaricate.

La documentazione delle API è
https://documenter.getpostman.com/view/3340600/RWTiyLCz.

**English**

This module allows you to send and receive electronic invoice/bill XML
files via Fatturhello (https://fatturhello.it).

The receipt happens periodically, with the native CRON "IT EDI: Receive
invoices from the SdI". During each execution all the E-Bills subsequent
the configured one (except for duplicates) will be downloaded.

The API documentation is
https://documenter.getpostman.com/view/3340600/RWTiyLCz.

**Table of contents**

.. contents::
:local:

Configuration
=============

**Italiano**

In Fatturazione > Configurazione > Impostazioni, abilitare "Usa
Fatturhello" ed effettuare il login.

Se alcune fatture di Fatturhello sono già presenti in Odoo, abilitare la
modalità debug e valorizzare "Identificativo dell'ultima fattura
scaricata" in Fatturazione > Configurazione > Impostazioni. Se
"Identificativo dell'ultima fattura scaricata" è vuoto, verranno
scaricate tutte le fatture elettroniche presenti in Fatturhello.

*Fatturhello*

Per inviare in automatico a SdI le fatture caricate da Odoo, abilitare
"Spedisci XML caricati".

**English**

In Invoicing > Configuration > Settings, enable "Use Fatturhello" and
login.

If some Fatturhello electronic bills are already present in Odoo, enable
Debug mode and fill "Last downloaded E-Bill identifier" in Invoicing >
Configuration > Settings. If "Last downloaded E-Bill identifier" is
empty, all the E-Bills in Fatturhello will be downloaded.

*Fatturhello*

In order to automatically send invoices uploaded from Odoo to the ES,
enable "Spedisci XML caricati".

Usage
=====

**Italiano**

Per ricevere le fatture elettroniche e aggiornare lo stato delle fatture
elettroniche inviate, attivare il CRON "IT EDI: Ricezione fatture
dall'SdI".

Se una fattura rimane nello stato "Inviata a Fatturhello", vuol dire che
Fatturhello non è configurato per inviarla automaticamente allo SdI. In
questo caso:

1. In Odoo: eliminare la fattura elettronica creata,
2. In Fatturhello: abilitare l'invio automatico a SdI,
3. In Odoo: ricreare la fattura elettronica e inviarla.

**English**

In order to receive the electronic bills and update the status of sent
electronic invoices, activate the "Import E-Bills from Fatturhello"
CRON.

If an invoice remains in the "Sent to Fatturhello" status, it means that
Fatturhello is not configured to automatically send it to the ES. In
this case:

1. In Odoo: Delete the created electronic invoice,
2. In Fatturhello: Enable automatic sending to ES,
3. In Odoo: Recreate the electronic invoice and send it.

Known issues / Roadmap
======================

- Parse more types of status notification

Bug Tracker
===========

Bugs are tracked on `GitHub Issues <https://github.com/OCA/l10n-italy/issues>`_.
In case of trouble, please check there if your issue has already been reported.
If you spotted it first, help us to smash it by providing a detailed and welcomed
`feedback <https://github.com/OCA/l10n-italy/issues/new?body=module:%20l10n_it_edi_fatturhello%0Aversion:%2018.0%0A%0A**Steps%20to%20reproduce**%0A-%20...%0A%0A**Current%20behavior**%0A%0A**Expected%20behavior**>`_.

Do not contact contributors directly about support or help with technical issues.

Credits
=======

Authors
-------

* PyTech

Contributors
------------

- `PyTech <https://www.pytech.it>`__:

- Simone Rubino <simone.rubino@pytech.it>

Other credits
-------------

The development of this module has been financially supported by:

- Northern Power Systems SRL (https://www.nps100.com)

Maintainers
-----------

This module is maintained by the OCA.

.. image:: https://odoo-community.org/logo.png
:alt: Odoo Community Association
:target: https://odoo-community.org

OCA, or the Odoo Community Association, is a nonprofit organization whose
mission is to support the collaborative development of Odoo features and
promote its widespread use.

.. |maintainer-HekkiMelody| image:: https://github.com/HekkiMelody.png?size=40px
:target: https://github.com/HekkiMelody
:alt: HekkiMelody
.. |maintainer-SirPyTech| image:: https://github.com/SirPyTech.png?size=40px
:target: https://github.com/SirPyTech
:alt: SirPyTech

Current `maintainers <https://odoo-community.org/page/maintainer-role>`__:

|maintainer-HekkiMelody| |maintainer-SirPyTech|

This module is part of the `OCA/l10n-italy <https://github.com/OCA/l10n-italy/tree/18.0/l10n_it_edi_fatturhello>`_ project on GitHub.

You are welcome to contribute. To learn how please visit https://odoo-community.org/page/Contribute.
4 changes: 4 additions & 0 deletions l10n_it_edi_fatturhello/__init__.py
Original file line number Diff line number Diff line change
@@ -0,0 +1,4 @@
# License AGPL-3.0 or later (https://www.gnu.org/licenses/agpl).

from . import models
from . import wizards
25 changes: 25 additions & 0 deletions l10n_it_edi_fatturhello/__manifest__.py
Original file line number Diff line number Diff line change
@@ -0,0 +1,25 @@
# Copyright 2025 Simone Rubino - PyTech
# License AGPL-3.0 or later (https://www.gnu.org/licenses/agpl).

{
"name": "ITA - Fattura elettronica - Supporto Fatturhello",
"version": "18.0.1.0.0",
"category": "Localization/Italy",
"summary": "Invio e ricezione fatture elettroniche tramite Fatturhello",
"author": "PyTech, Odoo Community Association (OCA)",
"maintainers": [
"HekkiMelody",
"SirPyTech",
],
"website": "https://github.com/OCA/l10n-italy",
"license": "AGPL-3",
"depends": [
"l10n_it_edi_sdi",
],
"data": [
"security/ir.model.access.csv",
"views/account_move_views.xml",
"views/res_config_settings_views.xml",
"wizards/login_views.xml",
],
}
3 changes: 3 additions & 0 deletions l10n_it_edi_fatturhello/data/neutralize.sql
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
-- Remove token for Fatturhello authentication
UPDATE res_company
SET fatturhello_login_authtoken = null;
Loading
Loading