# 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.

---

##### **<span style="background-color: #ffffff;">Header</span>**

<p class="callout warning"><span style="font-weight: 400;">Per l'utilizzo di qualsiasi API di TS Digital sarà necessario rispettare le [Linee Guida Generali](https://digital-docs.ts-paas.com/books/integrazione-e-utilizzo-api-tsdigital/page/linee-guida-generali-api-ts-digital)</span></p>

---

##### **Chiamate**

**<span style="background-color: #ffffff;">Le API di Fatturazione si dividono in due tipologie:</span>**

#### <span style="background-color: #ffffff;">[<span style="font-weight: 400;">Scrittura (b2bwrite)</span>](https://digital-docs.ts-paas.com/books/fatture-elettroniche/page/scrittura-fatture)</span>

<span style="font-weight: 400;">Chiamate che consentono l'invio di documenti a TS Digital.  
</span>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.

#### [<span style="font-weight: 400;">Lettura (b2bread)</span>](https://digital-docs.ts-paas.com/books/fatture-elettroniche/page/lettura-fatture)

<span style="font-weight: 400;">Chiamate che consentono la lettur</span><span style="font-weight: 400;">a 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.</span>

---

##### **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.<svg class="svg-icon" data-icon="link" role="presentation" viewbox="0 0 24 24" xmlns="http://www.w3.org/2000/svg"></svg>

<p class="callout warning">A breve non sarà più possibile nemmeno vederla, verrà messa fra le fatture "parcheggiate" e sarà possibile accedervi solo dopo aver acquistato il pacchetto</p>

---

**HubId**

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

<p class="callout success"><span style="font-weight: 400;">Gli hubId già forniti NON verranno modificati.</span></p>

---

**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**

<span style="font-weight: 400;">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. </span>