Vai al contenuto

Nome file e dati di trasmissione

Ogni fattura inviata allo SDI ha un nome file, che segue la convenzione SDI, e un blocco DatiTrasmissione nell'header, che contiene fra l'altro l'IdTrasmittente e il ProgressivoInvio. Invoicetronic può gestirli per te oppure lasciarli a te: dipende da come invii la fattura.

Due modalità

Nome file assegnato da Invoicetronic Nome file indicato da te
Quando POST /send/xml, POST /send/json, POST /send senza file_name POST /send/file (vale il nome del file caricato), POST /send con file_name
IdTrasmittente Se vuoto, lo compiliamo noi (IT01180680397) Lo compili tu
ProgressivoInvio Se vuoto, lo compiliamo noi Lo compili tu
XML trasmesso Ricostruito a partire dai dati della fattura Trasmesso così com'è
File già firmati (.p7m) Non ammessi Ammessi: il nome file è obbligatorio

Se non hai esigenze particolari, la strada più semplice è la prima: lascia vuoti IdTrasmittente e ProgressivoInvio, non indicare il nome file, e pensiamo a tutto noi.

Nome file assegnato da Invoicetronic

Quando non indichi un nome file, Invoicetronic agisce da trasmittente:

  • genera un nome file univoco, con il prefisso riservato IT01180680397;
  • compila IdTrasmittente e ProgressivoInvio solo se sono vuoti: i valori già presenti nell'XML non vengono mai sovrascritti;
  • ricostruisce l'XML a partire dai dati della fattura, per inserire i campi compilati.

Puoi lasciare i due campi vuoti oppure ometterli: la convalida (validate=true) avviene dopo la compilazione, quindi non segnala errori. Se invece li valorizzi tu, restano i tuoi valori: in questo caso conviene indicare anche il nome file, in modo che sia coerente con loro.

Il nome assegnato è restituito nel campo file_name della risposta.

Nome file indicato da te

Indichi tu il nome file quando carichi un file con POST /send/file, quando usi file_name con POST /send, e sempre quando il file è già firmato (.p7m). In questo caso il file viene trasmesso così com'è e i dati di trasmissione sono a tuo carico:

  • Compila IdTrasmittente e ProgressivoInvio secondo le specifiche tecniche FatturaPA. Con validate=true, una fattura con questi campi vuoti viene rifiutata con 422 Unprocessable Entity.
  • Il nome file deve seguire la convenzione SDI: codice paese, identificativo fiscale, trattino basso, progressivo, estensione .xml o .xml.p7m, ad esempio IT01234567890_00001.xml. Un nome non conforme viene rifiutato con 400 Bad Request.
  • Il prefisso IT01180680397 è riservato ai nomi assegnati da Invoicetronic: un nome che inizia così viene rifiutato con 400 Bad Request.
  • Il nome deve essere univoco per lo SDI, non solo su Invoicetronic: lo SDI scarta con il codice 00002 (nome file duplicato) un nome che ha già ricevuto, da qualsiasi canale. Invoicetronic rifiuta subito con 409 Conflict i nomi già usati sulla piattaforma, ma non può conoscere quelli trasmessi tramite altri provider. Per evitare collisioni, usa come prefisso il tuo identificativo fiscale (quello indicato in IdTrasmittente) e un progressivo che non si ripete, anche rispetto agli invii fatti in passato con altri canali.

In Sandbox il controllo è solo quello di Invoicetronic, e l'archivio è separato da quello live: lo stesso nome può essere usato in entrambi gli ambienti.

Se chiedi a Invoicetronic di firmare la fattura, al nome file viene aggiunta l'estensione .p7m.

Soggetto emittente e terzo intermediario

I dati del soggetto emittente e dell'eventuale terzo intermediario (blocchi 1.5 e 1.6 dell'header) descrivono il rapporto fra te e il cedente, e restano a tuo carico. Invoicetronic non va indicato in questi blocchi, né perché trasmette la fattura né perché la firma. Se stai migrando da un altro provider e i tuoi XML riportano i suoi dati come terzo intermediario, toglili.

Per come compilare questi blocchi nel tuo caso, ad esempio se emetti fatture per conto dei tuoi clienti, rivolgiti al tuo consulente fiscale.