Intro

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

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 tenciche dettate dall' AdE) e lo inviano allo SDI.

Le API di Fatturazione si dividono in due tipologie:

Scrittura b2b-write

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

Chiamate che consentono la lettura di documenti da TS Digital.

Info utili

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:

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