M9 · Scelta intermediari e accreditamento SdICoop #78

Open
opened 2026-11-10 22:35:54 +01:00 by Alby96 · 2 comments
Owner

M9 — Fatturazione elettronica · Specifica: docs/SPEC.md §11.9

Cosa serve dal titolare

  • Quali intermediari usare come Intermediario A e Intermediario B (documentazione API e credenziali di prova)
  • Se procedere con l'accreditamento SdICoop presso l'Agenzia delle Entrate (certificati, ambiente di test)
  • Una casella PEC di prova per il canale PEC

Nel frattempo

I connettori vengono sviluppati e testati con server finti; questa issue non blocca il resto della milestone.


Valgono sempre CLAUDE.md (emendamenti E1–E6), i vincoli di SPEC §1, le regole di codice di §19 e la Definition of Done di §20: stessa unità di lavoro per codice, test, wiki, docs/*.md e CHANGELOG.md.

**M9 — Fatturazione elettronica** · Specifica: `docs/SPEC.md` §11.9 ### Cosa serve dal titolare - [ ] Quali intermediari usare come *Intermediario A* e *Intermediario B* (documentazione API e credenziali di prova) - [ ] Se procedere con l'accreditamento SdICoop presso l'Agenzia delle Entrate (certificati, ambiente di test) - [ ] Una casella PEC di prova per il canale PEC ### Nel frattempo I connettori vengono sviluppati e testati con server finti; questa issue non blocca il resto della milestone. --- Valgono sempre `CLAUDE.md` (emendamenti E1–E6), i vincoli di SPEC §1, le regole di codice di §19 e la Definition of Done di §20: stessa unità di lavoro per codice, test, wiki, `docs/*.md` e `CHANGELOG.md`.
Alby96 added this to the M9 — Fatturazione elettronica · v0.9.0 milestone 2026-11-10 22:35:54 +01:00
Alby96 added this to the Khaemhat 1.0 — Sviluppo project 2026-11-10 22:35:59 +01:00
Alby96 moved this to Da fare in Khaemhat 1.0 — Sviluppo on 2026-11-13 10:10:50 +01:00
Author
Owner

Stato dopo la 0.9.0 (PR #128, ADR 0039 e 0040).

Il codice è pronto e provato con server finti; per usarlo in produzione serve il titolare:

  • Intermediari A e B: oggi sono contratti REST generici (A con chiave API e Bearer, B con utente e password e Basic), descritti nell'ADR 0040. Scelto il fornitore, basta riscrivere le richieste della classe derivata (IntermediaryATransport / IntermediaryBTransport) sulla sua API; servizi, instradamento e interfaccia non cambiano. Servono: nome del servizio, documentazione dell'API e credenziali di prova.
  • SdICoop: servono l'accreditamento dell'azienda presso l'Agenzia delle Entrate, il certificato client (.p12) e la pubblicazione di POST /sdicoop/{azienda} dietro un reverse proxy che verifichi il certificato dello SDI (mTLS) e aggiunga l'intestazione X-Khaemhat-SdiCoop-Key con la chiave di ricezione del canale.
  • La PEC funziona già senza accreditamento: è il canale da usare finché questa issue resta aperta.
Stato dopo la 0.9.0 (PR #128, ADR 0039 e 0040). Il codice è pronto e provato con server finti; per usarlo in produzione serve il titolare: - **Intermediari A e B**: oggi sono contratti REST generici (A con chiave API e `Bearer`, B con utente e password e `Basic`), descritti nell'ADR 0040. Scelto il fornitore, basta riscrivere le richieste della classe derivata (`IntermediaryATransport` / `IntermediaryBTransport`) sulla sua API; servizi, instradamento e interfaccia non cambiano. Servono: nome del servizio, documentazione dell'API e credenziali di prova. - **SdICoop**: servono l'accreditamento dell'azienda presso l'Agenzia delle Entrate, il certificato client (`.p12`) e la pubblicazione di `POST /sdicoop/{azienda}` dietro un reverse proxy che verifichi il certificato dello SDI (mTLS) e aggiunga l'intestazione `X-Khaemhat-SdiCoop-Key` con la chiave di ricezione del canale. - La **PEC** funziona già senza accreditamento: è il canale da usare finché questa issue resta aperta.
Alby96 modified the milestone from M9 — Fatturazione elettronica · v0.9.0 to M13 — Consolidamento e rilascio · v0.13.0 2026-11-15 12:07:58 +01:00
Author
Owner

Decisione del titolare del 2026-11-16 (ADR 0044): intermediari reali, accreditamento SdICoop e PEC di prova sono lasciati da parte per ora. Lo sviluppo prosegue con i canali simulati dell'ADR 0040. L'issue resta aperta nel backlog, senza milestone e senza Status/In attesa utente. Si riprende quando il titolare sceglie un canale reale. Le credenziali non vanno mai scritte qui, perché il repository è pubblico.

Decisione del titolare del 2026-11-16 (ADR 0044): intermediari reali, accreditamento SdICoop e PEC di prova sono lasciati da parte per ora. Lo sviluppo prosegue con i canali simulati dell'ADR 0040. L'issue resta aperta nel backlog, senza milestone e senza `Status/In attesa utente`. Si riprende quando il titolare sceglie un canale reale. Le credenziali non vanno mai scritte qui, perché il repository è pubblico.
Alby96 removed the
Status
In attesa utente
label 2026-11-16 17:19:54 +01:00
Alby96 removed this from the M13 — Consolidamento e rilascio · v0.13.0 milestone 2026-11-16 17:19:56 +01:00
Alby96 moved this to Backlog in Khaemhat 1.0 — Sviluppo on 2026-11-16 17:20:01 +01:00
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: BalboSoft/Khaemhat#78