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
IdTrasmittenteeProgressivoInviosolo 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
IdTrasmittenteeProgressivoInviosecondo le specifiche tecniche FatturaPA. Convalidate=true, una fattura con questi campi vuoti viene rifiutata con422 Unprocessable Entity. - Il nome file deve seguire la convenzione SDI: codice paese, identificativo fiscale, trattino basso, progressivo, estensione
.xmlo.xml.p7m, ad esempioIT01234567890_00001.xml. Un nome non conforme viene rifiutato con400 Bad Request. - Il prefisso
IT01180680397è riservato ai nomi assegnati da Invoicetronic: un nome che inizia così viene rifiutato con400 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 con409 Conflicti 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 inIdTrasmittente) 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.