Casi d'uso · 29.09.2026
Verificare un'azienda svizzera tramite il numero IDI (UID)
Onboarding clienti, controllo fornitori, fatturazione: ragione sociale, forma giuridica e indirizzo ufficiali di un'azienda svizzera con una sola richiesta.
Quando un nuovo cliente B2B si registra, tre domande tornano sempre: l'azienda esiste? Qual è la ragione sociale esatta? L'indirizzo è aggiornato? La risposta ufficiale è nel registro di commercio (Zefix). Lo sincronizziamo ogni notte: circa 800 000 aziende con numero IDI (UID), forma giuridica, sede e scopo.
Il caso d'uso
Prendiamo una fiduciaria che riceve ogni settimana decine di nuovi mandati. Senza API, un collaboratore copia ogni IDI in Zefix e ricopia i campi a mano. Con l'API, il software chiama la nostra API all'inserimento dell'IDI e precompila la scheda cliente.
Ricerca per IDI
L'IDI si scrive CHE-138.647.564; l'API lo attende senza trattini né punti:
curl -H "Authorization: Token VOSTRA_CHIAVE" \
"https://opendata.altius-group.ch/economics/swissenterprise/api/v1/companies/?uid=CHE138647564"
La risposta contiene legal_name, uid_formatted, full_address, canton_code e la forma giuridica in tedesco, francese e italiano. count uguale a 0 significa che nessuna azienda attiva porta questo IDI: è il segnale per un controllo manuale.
Ricerca per nome
Se l'utente digita un nome invece di un IDI, il parametro search ordina i risultati per pertinenza (nome esatto, poi inizio del nome, poi contenuto):
curl -H "Authorization: Token VOSTRA_CHIAVE" \
"https://opendata.altius-group.ch/economics/swissenterprise/api/v1/companies/?search=altius group"
Mantenere aggiornate le schede
Le aziende cambiano nome e sede. La nostra banca dati segue questi cambiamenti ogni notte e le aziende cancellate scompaiono. Un controllo mensile delle vostre schede tramite IDI basta per individuare un cambiamento.
Da sapere
- La ricerca per IDI è esatta e rapida: è l'identificativo migliore.
- I dati sono quelli pubblicati dall'Ufficio federale di giustizia; non sostituiscono un estratto autenticato del registro.
- Il piano gratuito (100 richieste al giorno) basta per testare; l'uso commerciale richiede un piano a pagamento.