SDI: Send FatturaPA

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

Descrizione

Trasmette una fattura elettronica FatturaPA (XML standard SDI v1.2.2) al Sistema di Interscambio Agenzia delle Entrate. Channel via PEC accreditato o SDIcoop/ADEL (canale diretto SOAP autenticato). Validazione XSD pre-invio contro lo schema UFFICIALE FatturaPA v1.2.2 dell'Agenzia delle Entrate (validateXsd, default ON, offline via libxml2): una fattura non conforme viene RIFIUTATA subito con gli errori XSD, prima di firmare e di consumare una chiamata al SdI (che la scarterebbe con notifica di scarto). Firma XAdES-BES enveloped opzionale (SHA-256 + RSA, cert+key PEM). Output: { sdiId, status (sent/accepted/rejected), notificationFile, deliveryTimestamp }. Use case: invio automatico fatture B2B/B2G post-emissione Fatture in Cloud, invio massivo fine ciclo fatturazione, integrazione con ERP legacy via canale FlowForge.

⚙️ 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.
`validateXsd` Valida XSD pre-invio (schema ufficiale FatturaPA v1.2.2)	`boolean`	no	`true`	On (default) = valida la fattura contro lo schema XSD ufficiale dell'Agenzia PRIMA di inviarla: se non conforme, il nodo fallisce subito con gli errori, evitando lo scarto del SdI. Off = invia senza validare (solo se sai che l'XML è già conforme).
`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",
    "validateXsd": true,
    "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