Cosa sono le interfacce? E perché il vostro sistema ERP ha bisogno di un’interfaccia?

Le API (Application Programming Interfaces), o interfacce, fungono da adattatori tra un sistema ERP e i programmi applicativi.

I moderni sistemi ERP integrano già molti processi aziendali, ma mai tutti quelli desiderati, oppure la qualità dei singoli processi è insoddisfacente. Per colmare tali lacune di processo con il sistema ERP, vengono utilizzati diversi software di supporto. Questi, a loro volta, vengono popolati con i dati dal sistema ERP. Le interfacce garantiscono lo scambio automatico dei dati e integrano i software di supporto nel sistema ERP. Nel lavoro quotidiano, i diversi sistemi sono quasi impercettibili.

Schnittstellen von Trade Monkey verschaffen Überblick

Le interfacce richiedono i seguenti elementi:

  • Connessione (Internet)
  • Formato di trasferimento (ad esempio, XML o JSON)
  • Servizio di trasmissione

Questi tre elementi possono essere configurati in modo diverso per soddisfare i requisiti individuali in termini di sicurezza, prestazioni e compatibilità dei dati.

Tipi di interfacce

Esistono approcci molto diversi per costruire un’interfaccia, quindi non esiste un’unica soluzione “giusta”. L’interfaccia deve adattarsi alle condizioni quadro dell’azienda e coprire il processo in modo impeccabile – secondo il motto “Tanto buono quanto necessario e non tanto buono quanto possibile”. Inoltre, deve essere chiarita la direzione della comunicazione: i dati vengono solo prelevati dal sistema ERP o vengono anche riscritti nel sistema ERP?

Se i dati vengono solo recuperati, è sufficiente un trasferimento tramite SFTP (Secure File Transfer Protocol). Qui, il formato di trasferimento e il servizio di trasmissione devono ancora essere definiti.

Per la comunicazione in entrambe le direzioni, una REST API (Representational State Transfer API) è più adatta. Qui, gli elementi sono ampiamente definiti; i contenuti e i processi all’interno dell’interfaccia devono ancora essere coordinati.

Valore aggiunto nel processo

Il senso di un’interfaccia è dato quando i dati già acquisiti non devono essere trasferiti manualmente di nuovo e quando il completamento del processo è visibile – ad esempio, sotto forma di un messaggio di conferma, di un’indicazione di stato o di un’e-mail. Un’interfaccia dovrebbe, per quanto possibile, non influenzare il sistema ERP. I campi necessari solo nel software di supporto dovrebbero essere gestiti solo lì e non gravare sul sistema ERP. Qualsiasi adattamento nel sistema ERP può avere conseguenze di vasta portata che inizialmente rimangono inosservate. Ad esempio, i problemi potrebbero sorgere solo in occasione di un cambio di release o di un aggiornamento.

Processi di esempio

Scoprite di più su due processi specifici che noi di Trade Monkey abbiamo implementato in diverse versioni:

Software « Swiss e-dec » per l’esportazione

Una e-dec (dichiarazione elettronica) della «Decisione di tassazione all’esportazione» è composta dall’intestazione del modulo e dalle posizioni delle merci. Nell’intestazione sono generalmente richiesti dati come l’indirizzo del destinatario e il numero di dichiarazione. Ulteriori informazioni come l’esportatore, il tipo di tassazione, ecc., sono memorizzate nell’interfaccia e non devono essere trasmesse.

La posizione della merce contiene campi come: numero di tariffa doganale, valore statistico della merce, massa netta, massa lorda, collo con dettagli e documenti con dettagli (ad esempio, una fattura proforma). A seconda del prodotto, potrebbero essere necessari ulteriori dati. Anche in questo caso, i numeri di tariffa doganale con i parametri corretti sono memorizzati nell’interfaccia.

Per poter utilizzare l’interfaccia, è necessario un file in formato XML o JSON. Questo file, una volta creato, deve essere salvato automaticamente in una cartella definita, da dove verrà trasferito al server di Trade Monkey tramite SFTP utilizzando un servizio preinstallato. In risposta, il mittente registrato riceverà un’e-mail con l’e-dec o un messaggio di errore. In quest’ultimo caso, l’e-dec può essere corretta direttamente in «Swiss e-dec» e inviata nuovamente alla dogana.

Trade Monkey è lieta di fornirvi dei modelli Excel per creare un file XML da essi. Ciò rende superflue le modifiche al vostro sistema ERP.

Software « Swiss Sanctions » per il controllo delle liste di sanzioni

Per il processo di controllo delle liste di sanzioni, l’interfaccia REST API è la scelta giusta. I nomi dal sistema ERP vengono continuamente controllati e i risultati vengono restituiti sotto forma di messaggi di stato o risultati di ricerca. Il feedback di stato può essere utilizzato nel sistema ERP per ulteriori azioni, ad esempio per bloccare transazioni come l’inserimento di ordini, la creazione di offerte, ecc. A tal fine, « Swiss Sanctions » presenta i seguenti stati:
– Whitelist = Il nome è stato controllato e non è stato trovato alcun riscontro.
– Blacklist = Il nome si trova su una lista di sanzioni ed è bloccato in modo permanente.
– In Checking = Il nome è in fase di verifica e non può essere utilizzato per ulteriori azioni fino alla valutazione definitiva.

Limiti delle interfacce

Le interfacce hanno l’obiettivo di ridurre il lavoro e di generare risparmi sui costi di transazione (costi variabili) dopo un costo iniziale (costi fissi). Affinché i costi iniziali siano ammortizzati in un tempo ragionevole, è indispensabile un certo volume di transazioni. Le interfacce sono adatte per processi standardizzati e ripetitivi, ma non per sequenze complesse o in evoluzione.

Saremo lieti di aiutarvi per qualsiasi domanda sulle interfacce.

I nostri ultimi articoli

Vuoi saperne di più? Ti forniamo le notizie più importanti sul commercio estero.

Per tenerti aggiornato, ti informiamo regolarmente nella nostra newsletter sui cambiamenti rilevanti nelle procedure doganali. Inoltre, ti teniamo informato sui nostri interessanti e istruttivi seminari e workshop.

Trade Monkey Home (#9)

© 2025 Trade Monkey GmbH. Alle Rechte vorbehalten

© 2025 Trade Monkey GmbH. Tutti i diritti riservati

Trade Monkey
Panoramica privacy

This website uses cookies so that we can provide you with the best user experience possible. Cookie information is stored in your browser and performs functions such as recognising you when you return to our website and helping our team to understand which sections of the website you find most interesting and useful.