Skip to main content

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 XML (come da specifiche tenciche dettate dall' AdE e inviano il file al SIstema D'Interscambio (SDI).

    Le API di Fatturazione si dividono in due tipologie:

    Scrittura

    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 

    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

    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. 

     

    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.

    Back to top