Intro

 

Prerequisiti

• L'azienda deve avere un'anagrafica presente su TS Digital;
• L'azienda deve avere il servizio di fatturazione attivo;
• Il file XML deve essere già generato.
  Le API effettuano dei controlli sulla struttura del file XML (come da specifiche tecniche dettate dall' AdE) e lo inviano allo SDI.

---

Header

Per l'utilizzo di qualsiasi API di TS Digital sarà necessario rispettare le Linee Guida Generali

---

Chiamate

Le API di Fatturazione si dividono in due tipologie:

Scrittura (b2bwrite)

Chiamate che consentono l'invio di documenti a TS Digital.
L'invio di ogni documento segue un processo ASincrono, quindi, viene caricato un documento e si riceve in risposta un hubId con il quale referenziarlo, il documento verrà processato successivamente in un secondo momento, il tempo di processamento differisce in base al traffico presente sui sistemi. Indicativamente può variare da pochi secondi a qualche ora.

Lettura (b2bread)

Chiamate che consentono la lettura dei documenti presenti in TS Digital. 
E' possibile recuperare i dettagli di una singola fattura, la lista delle fatture, il download del file XML, ecc.

---

Info utili

Servizio SDI

Il servizio SDI è il servizio che permette l'invio di fatture elettroniche al sistema di interscambio.
Fra le configurazioni presenti vi è quella di poter scegliere se firmare o meno il documento che viene inviato al sistema di interscambio (SDI).
Se si sceglie di NON firmare, potranno essere inviate solo fatture elettroniche SDIPR. per le SDIPA è obbligatoria la firma.

Servizio E-Ricevi

Il servizio E-Ricevi permette la ricezione delle fatture elettroniche dal servizio di interscambio (SDI) ma anche l'utilizzo dei seguenti flussi:

• SELFSEND
• STORE
• IMPEXP
• OCR

Se non si possiede il servizio sarà impossibile utilizzare i suddetti flussi. Mentre In caso di ricezione di una fattura passiva da SDI sarà possibile vederla ma non è possibile scaricarla o effettuarne l'anteprima.

A breve non sarà più possibile nemmeno vederla, verrà messa fra le fatture "parcheggiate" e sarà possibile accedervi solo dopo aver acquistato il pacchetto

---

HubId 

Ad ogni documento presente su TS Digital viene attribuito un codice univoco definito "HubId". 
Il riferimento ad una fattura avviene quindi tramite HubId.
Questo elemento verrà richiesto in alcune chiamate, specie in quelle di lettura.
L’hubId dovrà essere trattato come una stringa univoca da 1 a 36 caratteri. Esempio: 630f6f88ea51031614a62651

Gli hubId già forniti NON verranno modificati.

---

Uffici

Gli uffici sono sotto-insiemi di un'azienda. Per referenziare un ufficio bisogna aggiungere un suffisso all'ItemId dell'azienda.
Per referenziare l'ufficio 1 dell'azienda ABCDE ad esempio, occorre specificare ABCDE-001
Per referenziare tutti gli uffici di un azienda si può utilizzare il suffisso -ALL

---

Cancellazione Fatture

Tutte le fatture scartate da TS Digital (non dallo SDI) saranno eliminate fisicamente dal DB dopo 120 gg.
Se si prova a visualizzare quella fattura sarà restituito errore “documento non esistente” e status code 404.