Intro

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

 

Fatturazione

Scrittura

Gli endpoint di scrittura 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.

Per inviare documenti riferirsi alla pagina: Scrittura Fatture

 

Lettura

Gli enpoint di scrittura consentono la lettura di documenti da TS digital.

Riferirsi alla pagina: Lettura fatture

 

Termininologia

HubId 

Il riferimento ad una fattura avviene tramite HubId 

L’hubId dovrà essere trattato come una stringa univoca da 1 a 36 caratteri.

Nuovi HubId vs Vecchi

I nuovi hubId saranno più corti rispetto ai vecchi, e saranno ugualmente univoci

La nuova struttura dell’hubId ci permetterà di risparmiare spazio grazie alla riduzione degli indici

Gli hubId già forniti NON verranno modificati.

 

Uffici

Nelle API di fatturazione si può far riferimento agli uffici.

Gli uffici sono sotto-insiemi di un'azienda. Per referenziare un ufficio bisogna aggiungere un suffisso all'ItemId dell'azienda.

Per referenziare l'uffico 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. Se necessario possiamo prevedere di fare un API per leggere le informazioni della conferma cancellazione (timestamp) 

 

Rimozione dello stato "RICEVUTO"

Era stata presa in considerazione l'ipotesi di rimuovere l'operazione di confirmDonwload prima dell'esecuzione di ACCETTA/RIFIUTA su fatture SDIPA passive. Per problemi di retrocompatibilità non è stato possibile procedere in tal senso, pertanto il comportamento è rimasto invariato ma non è consentito utilizzare questa funzionalità per nuove integrazioni ed è necessario attrezzarsi per aggiornarsi al più presto.

Banklink

todo