[{"data":1,"prerenderedAt":404},["ShallowReactive",2],{"seite-\u002Fit\u002Fratgeber\u002Fzefix-api\u002F":3},{"id":4,"title":5,"body":6,"description":395,"extension":396,"meta":397,"navigation":398,"path":399,"robots":400,"seo":401,"stem":402,"__hash__":403},"seiten_it\u002Fratgeber\u002Fzefix-api.md","API Zefix, interrogare i dati del registro di commercio",{"type":7,"value":8,"toc":385},"minimark",[9,14,18,23,28,48,80,83,87,95,99,102,137,140,144,151,208,215,219,300,304,307,315,319,363,367,375,381],[10,11,13],"h1",{"id":12},"api-zefix-interrogare-i-dati-del-registro-di-commercio","API Zefix: interrogare i dati del registro di commercio",[15,16,17],"p",{},"Zefix è l’indice centrale delle ditte della Svizzera, gestito dall’Ufficio federale del registro\ndi commercio (UFRC) presso l’Ufficio federale di giustizia. Oltre alla ricerca nel browser, Zefix\nesiste come interfaccia REST, la «Zefix PublicREST API». Con essa un’applicazione ottiene\ndirettamente dal registro di commercio ditta, sede, forma giuridica, stato e scopo. Questa guida\nmostra accesso, interrogazioni e risposta, e quando il registro IDI è la scelta più semplice.",[19,20],"produkt-ablauf",{":schritte":21,"titel":22},"[{\"ort\":\"La vostra applicazione\",\"text\":\"IDI o nome della ditta\",\"eigen\":true},{\"ort\":\"Zefix PublicREST\",\"text\":\"Accesso con nome utente e password\"},{\"ort\":\"Registro di commercio\",\"text\":\"Nome, sede, forma giuridica, stato, scopo\"},{\"ort\":\"La vostra applicazione\",\"text\":\"Compilare il modulo o verificare il cliente\"}]","Svolgimento di un’interrogazione Zefix: la vostra applicazione chiede a Zefix PublicREST con nome utente e password un IDI o un nome e riceve i dati dal registro di commercio",[24,25,27],"h2",{"id":26},"cosa-fornisce-lapi-zefix","Cosa fornisce l’API Zefix",[15,29,30,31,35,36,43,44,47],{},"L’interfaccia si trova sotto ",[32,33,34],"code",{},"https:\u002F\u002Fwww.zefix.admin.ch\u002FZefixPublicREST",". La descrizione degli\nendpoint è nell’",[37,38,42],"a",{"href":39,"rel":40},"https:\u002F\u002Fwww.zefix.admin.ch\u002FZefixPublicREST\u002Fswagger-ui\u002Findex.html",[41],"nofollow","interfaccia Swagger",",\nleggibile da macchina come OpenAPI sotto ",[32,45,46],{},"\u002Fv3\u002Fapi-docs",". Gli endpoint principali:",[49,50,51,58,64,70],"ul",{},[52,53,54,57],"li",{},[32,55,56],{},"GET \u002Fapi\u002Fv1\u002Fcompany\u002Fuid\u002F{id}",": impresa per IDI",[52,59,60,63],{},[32,61,62],{},"POST \u002Fapi\u002Fv1\u002Fcompany\u002Fsearch",": ricerca per nome, forma giuridica, sede o cantone",[52,65,66,69],{},[32,67,68],{},"GET \u002Fapi\u002Fv1\u002Fsogc\u002Fbydate\u002F{date}",": pubblicazioni di un giorno nel Foglio ufficiale svizzero di\ncommercio (FUSC)",[52,71,72,75,76,79],{},[32,73,74],{},"GET \u002Fapi\u002Fv1\u002FlegalForm"," e ",[32,77,78],{},"GET \u002Fapi\u002Fv1\u002Fcommunity",": elenchi delle forme giuridiche e dei comuni",[15,81,82],{},"I dati sono soggetti alla condizione «Open use», con l’obbligo di indicare la fonte.",[24,84,86],{"id":85},"passo-1-richiedere-laccesso","Passo 1: richiedere l’accesso",[15,88,89,90,94],{},"Le interrogazioni sono gratuite ma richiedono un account. L’UFRC concede l’accesso su richiesta\nper e-mail a ",[37,91,93],{"href":92},"mailto:zefix@bj.admin.ch","zefix@bj.admin.ch","; come nome utente serve un indirizzo e-mail. L’autenticazione\navviene con HTTP Basic Auth, cioè con nome utente e password a ogni richiesta. Ottenere le\ncredenziali può richiedere alcuni giorni, quindi conviene chiederle per tempo.",[24,96,98],{"id":97},"passo-2-cercare-unimpresa-per-idi","Passo 2: cercare un’impresa per IDI",[15,100,101],{},"L’IDI va nel percorso senza punti né trattino:",[103,104,109],"pre",{"className":105,"code":106,"language":107,"meta":108,"style":108},"language-bash shiki shiki-themes github-light github-dark","curl -u \"utente@example.ch:password\" \\\n  https:\u002F\u002Fwww.zefix.admin.ch\u002FZefixPublicREST\u002Fapi\u002Fv1\u002Fcompany\u002Fuid\u002FCHE107721785\n","bash","",[32,110,111,131],{"__ignoreMap":108},[112,113,116,120,124,128],"span",{"class":114,"line":115},"line",1,[112,117,119],{"class":118},"sScJk","curl",[112,121,123],{"class":122},"sj4cs"," -u",[112,125,127],{"class":126},"sZZnC"," \"utente@example.ch:password\"",[112,129,130],{"class":122}," \\\n",[112,132,134],{"class":114,"line":133},2,[112,135,136],{"class":126},"  https:\u002F\u002Fwww.zefix.admin.ch\u002FZefixPublicREST\u002Fapi\u002Fv1\u002Fcompany\u002Fuid\u002FCHE107721785\n",[15,138,139],{},"La risposta è un elenco, non un singolo oggetto. Se l’IDI non è nel registro di commercio, Zefix\nrisponde 404.",[24,141,143],{"id":142},"passo-3-cercare-unimpresa-per-nome","Passo 3: cercare un’impresa per nome",[15,145,146,147,150],{},"La ricerca si aspetta l’inizio del nome della ditta, almeno tre caratteri, con ",[32,148,149],{},"*"," come\ncarattere jolly:",[103,152,156],{"className":153,"code":154,"language":155,"meta":108,"style":108},"language-json shiki shiki-themes github-light github-dark","{\n  \"name\": \"Esempio*\",\n  \"canton\": \"TI\",\n  \"activeOnly\": true\n}\n","json",[32,157,158,164,178,191,202],{"__ignoreMap":108},[112,159,160],{"class":114,"line":115},[112,161,163],{"class":162},"sVt8B","{\n",[112,165,166,169,172,175],{"class":114,"line":133},[112,167,168],{"class":122},"  \"name\"",[112,170,171],{"class":162},": ",[112,173,174],{"class":126},"\"Esempio*\"",[112,176,177],{"class":162},",\n",[112,179,181,184,186,189],{"class":114,"line":180},3,[112,182,183],{"class":122},"  \"canton\"",[112,185,171],{"class":162},[112,187,188],{"class":126},"\"TI\"",[112,190,177],{"class":162},[112,192,194,197,199],{"class":114,"line":193},4,[112,195,196],{"class":122},"  \"activeOnly\"",[112,198,171],{"class":162},[112,200,201],{"class":122},"true\n",[112,203,205],{"class":114,"line":204},5,[112,206,207],{"class":162},"}\n",[15,209,210,211,214],{},"Si comporta come la ricerca esatta sul sito di Zefix. ",[32,212,213],{},"activeOnly"," nasconde le imprese\ncancellate. I risultati arrivano in forma breve; i dati completi si ottengono poi con\nun’interrogazione per IDI.",[24,216,218],{"id":217},"cosa-contiene-la-risposta","Cosa contiene la risposta",[49,220,221,237,243,263,269,275,284,294],{},[52,222,223,226,227,226,230,233,234],{},[32,224,225],{},"name",", ",[32,228,229],{},"uid",[32,231,232],{},"legalSeat"," (comune di sede) e ",[32,235,236],{},"canton",[52,238,239,242],{},[32,240,241],{},"legalForm"," con il codice secondo eCH-0097",[52,244,245,171,248,251,252,255,256,259,260],{},[32,246,247],{},"status",[32,249,250],{},"ACTIVE"," attiva, ",[32,253,254],{},"BEING_CANCELLED"," in liquidazione, ",[32,257,258],{},"CANCELLED"," cancellata, con\n",[32,261,262],{},"deletionDate",[52,264,265,268],{},[32,266,267],{},"purpose",", lo scopo iscritto nel registro di commercio",[52,270,271,274],{},[32,272,273],{},"address"," con via, numero civico, codice postale e località",[52,276,277,75,280,283],{},[32,278,279],{},"capitalNominal",[32,281,282],{},"capitalCurrency"," per le società di capitali",[52,285,286,289,290,293],{},[32,287,288],{},"sogcPub"," con le pubblicazioni FUSC e ",[32,291,292],{},"oldNames"," con i nomi precedenti",[52,295,296,299],{},[32,297,298],{},"cantonalExcerptWeb",", il link all’estratto del registro di commercio cantonale",[24,301,303],{"id":302},"zefix-o-registro-idi","Zefix o registro IDI?",[15,305,306],{},"Zefix conosce solo le imprese iscritte nel registro di commercio. Il registro IDI dell’Ufficio\nfederale di statistica conosce ogni impresa con un IDI, anche ditte individuali e associazioni\nnon iscritte, e mostra l’iscrizione nel registro IVA. La sua interrogazione pubblica non richiede\nun account.",[15,308,309,310,314],{},"Per sapere se un IDI inserito nel checkout è valido e l’impresa attiva basta quindi il registro\nIDI. Zefix conviene quando servono scopo, capitale, nomi precedenti o pubblicazioni. Come\nfunziona la verifica tramite il registro IDI è spiegato nella guida\n",[37,311,313],{"href":312},"\u002Fit\u002Fratgeber\u002Fuid-nummer-pruefen\u002F","verificare il numero IDI",".",[24,316,318],{"id":317},"insidie","Insidie",[49,320,321,336,342,351,357],{},[52,322,323,327,328,331,332,335],{},[324,325,326],"strong",{},"Grafia dell’IDI:"," nel percorso senza separatori (",[32,329,330],{},"CHE107721785","), nella visualizzazione con\n(",[32,333,334],{},"CHE-107.721.785","). Normalizzare prima dell’interrogazione.",[52,337,338,341],{},[324,339,340],{},"Elenco invece di oggetto:"," anche l’interrogazione per IDI restituisce un elenco.",[52,343,344,347,348,350],{},[324,345,346],{},"Liquidazione:"," ",[32,349,254],{}," non è ancora cancellata, ma non è più un normale partner\ncommerciale. La vostra applicazione deve decidere come trattarla.",[52,352,353,356],{},[324,354,355],{},"Credenziali:"," nome utente e password restano sul server. Una chiamata dal browser le\nmostrerebbe a ogni visitatore.",[52,358,359,362],{},[324,360,361],{},"Memorizzazione temporanea:"," i dati delle imprese cambiano di rado. Conservare le risposte per\nun po’ invece di interrogare a ogni pagina.",[24,364,366],{"id":365},"pronto-per-il-negozio","Pronto per il negozio",[15,368,369,370,374],{},"Per verificare gli IDI nel checkout WooCommerce non serve codice proprio: il mio plugin\n",[37,371,373],{"href":372},"\u002Fit\u002Fuid-check\u002F","Controllo IDI"," verifica formato, cifra di controllo e stato nel registro IDI,\nsenza account e senza chiave.",[15,376,377],{},[37,378,380],{"href":379},"\u002Fit\u002Fratgeber\u002F","Tutte le guide",[382,383,384],"style",{},"html pre.shiki code .sScJk, html code.shiki .sScJk{--shiki-default:#6F42C1;--shiki-dark:#B392F0}html pre.shiki code .sj4cs, html code.shiki .sj4cs{--shiki-default:#005CC5;--shiki-dark:#79B8FF}html pre.shiki code .sZZnC, html code.shiki .sZZnC{--shiki-default:#032F62;--shiki-dark:#9ECBFF}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .sVt8B, html code.shiki .sVt8B{--shiki-default:#24292E;--shiki-dark:#E1E4E8}",{"title":108,"searchDepth":133,"depth":133,"links":386},[387,388,389,390,391,392,393,394],{"id":26,"depth":133,"text":27},{"id":85,"depth":133,"text":86},{"id":97,"depth":133,"text":98},{"id":142,"depth":133,"text":143},{"id":217,"depth":133,"text":218},{"id":302,"depth":133,"text":303},{"id":317,"depth":133,"text":318},{"id":365,"depth":133,"text":366},"API Zefix (ZefixPublicREST): richiedere l’accesso, cercare un’impresa per IDI o per nome, campi della risposta, insidie e differenza con il registro IDI. Guida con esempi.","md",{},true,"\u002Fratgeber\u002Fzefix-api",null,{"title":5,"description":395},"ratgeber\u002Fzefix-api","2P6FEkULnxquMj0bkyxkZba6mXY6ubdWVIYCHLCb1J8",1791126634715]