fab Italy E-Invoicing

Italian e-invoicing and document exchange for ERPNext.

Scope

fab_italy_edi is the business-domain app for fab's Italian document exchange stack. It owns the ERPNext-facing workflows, canonical document model, and the operator UX around outbound, inbound, and receipt-driven lifecycle management.

Current responsibilities include:

• outbound SDI flows for invoices, credit notes, and autofatture
• inbound supplier-invoice ingestion into ERPNext payables workflows
• canonical document, receipt, and transmission lifecycle tracking
• provider-agnostic transport orchestration with OpenAPI as the first backend
• operator setup, review, retry, and reconciliation tools

Committed specifications live under docs/specs, including:

• Phase 1 Scope
• Domain Model
• Workflows

Branches

• develop: integration branch for testing against Frappe/ERPNext develop
• version-16: stable branch for Frappe/ERPNext 16

Installation

cd $PATH_TO_YOUR_BENCH
bench get-app https://github.com/fabricatorsltd/frappe-fab-italy-edi.git --branch version-16
bench get-app erpnext --branch version-16
bench get-app https://github.com/frappe/erpnext_italy.git --branch version-16
bench --site [site] install-app fab_italy_edi

fab_italy_edi requires both erpnext and erpnext_italy in the bench. fab_openapi is the reusable backend app for OpenAPI-based SDI transport and should also be installed when testing that provider path.

OpenAPI backend

The seeded OpenAPI SDI Proxy provider uses the OpenAPI account flow:

• Account Email: OpenAPI login email
• API Key: OpenAPI API key
• Access Token: optional manual bearer override

Use Sandbox for https://test.sdi.openapi.it and Production for https://sdi.openapi.it. When the provider stays on basic auth mode, fab requests bearer tokens from the OpenAPI OAuth endpoints automatically before polling or submission calls.

Contributing

Follow the official Frappe contribution guidelines:

• https://github.com/frappe/erpnext/wiki/Contribution-Guidelines

That includes upstream expectations for contribution proposals, coding standards, pull request checklists, and documentation updates.

Development

cd apps/fab_italy_edi
pre-commit install

Pre-commit is configured for Ruff, ESLint, Prettier, and PyUpgrade.

License

GNU Affero General Public License v3.0