bench get-app https://github.com/lucsartech/opendogana

[![Listed on Frappe Gems](https://frappegems.com/api/method/frappe_gems.seo.badge?app=lucsartech%2Fopendogana)](https://frappegems.com/gems/apps/lucsartech/opendogana)

OpenDogana

Italian Customs Hub for Frappe — open source middleware to track Italian customs operations (export, transit, import) and integrate them with business management systems.

---

What it does

OpenDogana sits between your business management system (ERPNext, SAP, custom ERPs) and the Italian and European customs systems (ADM AIDA, DDS2 EU, NCTS, Dogane 2.0). It centralizes:

• MRN tracking: query Movement Reference Number status from ADM and EU systems
• Customs documents: archive DAU, DAE, IVISTO and related documents with hash integrity
• Audit log: SOX-ready event-sourced trail of every state change
• Alerts: notify when exports are approaching the 90-day deadline without exit confirmation
• REST API: register MRNs and read status from any external system

It is not a customs declaration tool — declarations are still filed by your CAD or in-house customs team via standard channels (AES, NCTS, Dogane 2.0).

---

Why

Italian customs tracking is fragmented:

• ADM portal works for Italian-issued MRNs (manual lookup)
• DDS2 EU works for foreign MRNs (manual lookup, intermittent)
• NCTS has its own lifecycle for transit
• New H1/H7 import flows live in Dogane 2.0
• Closed-source SaaS solutions are expensive and don't integrate natively with ERPNext/Frappe ecosystems

This project consolidates them under a Frappe app, making them queryable programmatically and traceable for audit purposes.

---

Status

Early development. Phase 0 (bootstrap) complete. Phase 1 (ADM WS connector and minimal MRN tracking) in progress.

See PROJECT_BRIEF.md for the roadmap.

---

Quickstart

Will be filled in when Phase 1 ships an installable artifact.

For now, see PHASE0BOOTSTRAP.md if you want to set up a development environment.

---

Architecture

See PROJECT_BRIEF.md for the full architectural overview.

In short: a Frappe app with pluggable connectors (one per customs system), event-sourced audit log, and REST API for ERP integration.

---

Documentation

• PROJECT_BRIEF.md — vision, scope, architecture
• REFERENCES.md — normative and technical references
• CONTRIBUTING.md — how to contribute
• PHASE0BOOTSTRAP.md — first-time setup
• docs/adr/ — Architecture Decision Records (when present)

---

Contributing

Contributions are welcome! Please read CONTRIBUTING.md for the DCO sign-off requirement, branch naming, commit conventions, and code of conduct.

Quick start:

git clone https://github.com/lucsartech/opendogana.git
cd opendogana
# ... make changes ...
git commit -s -m "feat: your change"  # -s for DCO sign-off
git push origin feat/your-branch
# open PR against main

---

License

Licensed under the Apache License 2.0.

You can use, modify, and redistribute this software in commercial and non-commercial settings, including as part of proprietary applications.

---

Maintainer

Lucsartech Srl — independent IT consulting firm based in Fidenza, Italy, specializing in ERPNext/Frappe implementations for Italian SMEs.

For commercial support, integrations, or custom extensions, contact us at hello@lucsartech.it.

---

Acknowledgements

This project was sponsored as open source by McCormick Italy as customer zero, recognizing that fragmented customs tracking is a problem better solved as a shared community asset than as proprietary middleware.