SDI: Send FatturaPA

italia_sdi_send_invoice · action · Italy (PEC/SDI) · Available · v0.3.0

Description

Transmit an electronic invoice to the Italian Exchange System (SDI) of the Revenue Agency.

⚙️ Configuration parameters

Fields shown in the editor when configuring the node. Generated directly from the NodeDefconfigFields.

Field	Type	Required	Default	Description
`invoiceXml` XML FatturaPA	`code`	yes	— <?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`	yes	— username accreditato	Account dichiarato all'Agenzia delle Entrate sul canale SDICoop SOAP. Richiede accreditamento (procedura su fatturapa.gov.it).
`sdiPassword` SDICoop password	`string (encrypted)`	yes	—	—
`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".

💡 Configuration example

JSON snippet of the node as it appears in the workflow. Values are derived fromdefaultValue and from required parameters.

{
  "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
  }
}

🔒 Security notes

CADES-BES digital signature mandatory — the private key is NEVER sent to FlowForge. Use HSM or local smartcard.

🔗 Related nodes in the same category

Ready to use SDI: Send FatturaPA?

Available now on all FlowForge plans. Try it free without a credit card.

Start free Browse all nodes