SDI: Send FatturaPA

italia_sdi_send_invoice · action · Italia (PEC/SDI) · Disponibile · v0.3.0

Descrizione

Trasmette una fattura elettronica al Sistema di Interscambio (SDI) dell'Agenzia delle Entrate.

⚙️ Parametri di configurazione

Campi mostrati nell’editor quando si configura il nodo. Generati direttamente dal NodeDefconfigFields.

Campo	Tipo	Required	Default	Descrizione
`invoiceXml` XML FatturaPA	`code`	si	— <?xml version="1.0" encoding="UTF-8"?> <p:FatturaElettronica ...>...</p:FatturaElettronica>	XML completo formato P_IT_PA (PA), P_IT_B2B (aziende), P_IT_B2C (consumatori). Tipicamente generato a monte dal nodo "Fatture in Cloud: Create Invoice" o da uno script personalizzato.
`sdiUsername` SDICoop username	`string`	si	— username accreditato	Account dichiarato all'Agenzia delle Entrate sul canale SDICoop SOAP. Richiede accreditamento (procedura su fatturapa.gov.it).
`sdiPassword` SDICoop password	`string (encrypted)`	si	—	—
`sdiUrl` Endpoint SDI	`enum` `https://servizi.fatturapa.it/Services/SdIRiceviFile/RiceviFilehttps://testservizi.fatturapa.it/Services/SdIRiceviFile/RiceviFile`	no	`https://testservizi.fatturapa.it/Services/SdIRiceviFile/RiceviFile`	URL SOAP del SDI. Default = TEST (testservizi.fatturapa.it). PARTI SEMPRE DAL TEST. Switcha al production solo dopo validazione end-to-end.
`skipSigning` Salta firma (XML già firmato a monte)	`boolean`	no	`false`	Se on, FlowForge NON firma l'XML (usa quello che gli passi as-is). Utile quando hai un software del commercialista che firma e tu inoltri solo. Se off, FlowForge firma con cert+key qui sotto.
`certPem` Certificato firma (PEM inline)	`string (encrypted)`	no	—	Certificato qualificato CADES-BES in formato PEM (-----BEGIN CERTIFICATE-----). Necessario se skipSigning=off. In alternativa imposta FLOWFORGE_SDI_CERT_PATH sul server e lascia vuoto qui.
`keyPem` Chiave privata firma (PEM inline)	`string (encrypted)`	no	—	Chiave privata del certificato in formato PEM (-----BEGIN PRIVATE KEY-----). NON condividere. In alternativa imposta FLOWFORGE_SDI_KEY_PATH sul server.
`certPath` Path certificato su disco (alternativa a PEM inline)	`file-picker`	no	—	Path file .pem del certificato dentro la sandbox del tenant. Usato solo se certPem (sopra) è vuoto. Per server-managed certs usa la env FLOWFORGE_SDI_CERT_PATH invece.
`keyPath` Path chiave privata su disco	`file-picker`	no	—	Path file .pem della chiave privata. Stessa logica di certPath.
`fileName` Nome file da inviare (opzionale)	`expression`	no	— IT12345678901_{{loop.index + 1}}.xml	Naming standard SDI: IT<P.IVA>_<progressivo>.xml (5 cifre). Tipicamente dinamico — usa espressioni come {{loop.index}} per il progressivo. Se vuoto, FlowForge genera "IT<timestamp>_FF.xml".

💡 Esempio configurazione

Snippet JSON del nodo come compare nel workflow. I valori sono derivati daidefaultValue e dai parametri required.

{
  "id": "node-italia_sdi_send_invoice-1",
  "defId": "italia_sdi_send_invoice",
  "label": "SDI: Send FatturaPA",
  "config": {
    "invoiceXml": "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<p:FatturaElettronica ...>...</p:FatturaElettronica>",
    "sdiUsername": "username accreditato",
    "sdiPassword": "<sdiPassword>",
    "sdiUrl": "https://testservizi.fatturapa.it/Services/SdIRiceviFile/RiceviFile",
    "skipSigning": false
  }
}

🔒 Note di sicurezza

Firma digitale CADES-BES obbligatoria — il privato chiave non viene MAI inviato a FlowForge. Usa HSM o smartcard locale.

🔗 Nodi correlati nella stessa categoria

Pronto a usare SDI: Send FatturaPA?

Disponibile da subito in tutti i piani FlowForge. Provalo gratis senza carta di credito.

Inizia gratis Sfoglia tutti i nodi