[{"data":1,"prerenderedAt":404},["ShallowReactive",2],{"seite-\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_de\u002Fratgeber\u002Fzefix-api.md","Zefix API, Firmendaten aus dem Handelsregister abfragen",{"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},"zefix-api-firmendaten-aus-dem-handelsregister-abfragen","Zefix API: Firmendaten aus dem Handelsregister abfragen",[15,16,17],"p",{},"Zefix ist der zentrale Firmenindex der Schweiz, betrieben vom Eidgenössischen Amt für das\nHandelsregister (EHRA) im Bundesamt für Justiz. Neben der Suche im Browser gibt es Zefix als\nREST-Schnittstelle, die «Zefix PublicREST API». Damit holt eine Anwendung Firmenname, Sitz,\nRechtsform, Status und Zweck direkt aus dem Handelsregister. Diese Anleitung zeigt Zugang,\nAbfragen und Antwort, und wann das UID-Register die einfachere Wahl ist.",[19,20],"produkt-ablauf",{":schritte":21,"titel":22},"[{\"ort\":\"Eigene Anwendung\",\"text\":\"UID oder Firmenname\",\"eigen\":true},{\"ort\":\"Zefix PublicREST\",\"text\":\"Anmeldung mit Benutzername und Passwort\"},{\"ort\":\"Handelsregister\",\"text\":\"Name, Sitz, Rechtsform, Status, Zweck\"},{\"ort\":\"Eigene Anwendung\",\"text\":\"Formular füllen oder Kunden prüfen\"}]","Ablauf einer Zefix-Abfrage: Die eigene Anwendung fragt mit Benutzername und Passwort bei Zefix PublicREST nach einer UID oder einem Namen und erhält die Firmendaten aus dem Handelsregister",[24,25,27],"h2",{"id":26},"was-die-zefix-api-liefert","Was die Zefix API liefert",[15,29,30,31,35,36,43,44,47],{},"Die Schnittstelle liegt unter ",[32,33,34],"code",{},"https:\u002F\u002Fwww.zefix.admin.ch\u002FZefixPublicREST",". Die Beschreibung\nder Endpunkte steht in der ",[37,38,42],"a",{"href":39,"rel":40},"https:\u002F\u002Fwww.zefix.admin.ch\u002FZefixPublicREST\u002Fswagger-ui\u002Findex.html",[41],"nofollow","Swagger-Oberfläche",",\nmaschinenlesbar als OpenAPI unter ",[32,45,46],{},"\u002Fv3\u002Fapi-docs",". Die wichtigsten Endpunkte:",[49,50,51,58,64,70],"ul",{},[52,53,54,57],"li",{},[32,55,56],{},"GET \u002Fapi\u002Fv1\u002Fcompany\u002Fuid\u002F{id}",": Firma über die UID",[52,59,60,63],{},[32,61,62],{},"POST \u002Fapi\u002Fv1\u002Fcompany\u002Fsearch",": Suche über Name, Rechtsform, Sitz oder Kanton",[52,65,66,69],{},[32,67,68],{},"GET \u002Fapi\u002Fv1\u002Fsogc\u002Fbydate\u002F{date}",": Publikationen im Schweizerischen Handelsamtsblatt (SHAB)\neines Tages",[52,71,72,75,76,79],{},[32,73,74],{},"GET \u002Fapi\u002Fv1\u002FlegalForm"," und ",[32,77,78],{},"GET \u002Fapi\u002Fv1\u002Fcommunity",": Listen der Rechtsformen und Gemeinden",[15,81,82],{},"Die Daten stehen unter der Bedingung «Open use», mit der Pflicht, die Quelle anzugeben.",[24,84,86],{"id":85},"schritt-1-zugang-beantragen","Schritt 1: Zugang beantragen",[15,88,89,90,94],{},"Die Abfragen sind kostenlos, brauchen aber ein Konto. Den Zugang vergibt das EHRA auf eine\nE-Mail an ",[37,91,93],{"href":92},"mailto:zefix@bj.admin.ch","zefix@bj.admin.ch","; als Benutzername dient eine E-Mail-Adresse. Angemeldet wird per\nHTTP Basic Auth, also mit Benutzername und Passwort bei jeder Anfrage. Bis die Zugangsdaten da\nsind, kann es einige Tage dauern, darum früh beantragen.",[24,96,98],{"id":97},"schritt-2-firma-per-uid-abfragen","Schritt 2: Firma per UID abfragen",[15,100,101],{},"Die UID steht im Pfad ohne Punkte und Bindestrich:",[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 \"benutzer@example.ch:passwort\" \\\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"," \"benutzer@example.ch:passwort\"",[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],{},"Die Antwort ist eine Liste, nicht ein einzelnes Objekt. Ist die UID nicht im Handelsregister,\nantwortet Zefix mit 404.",[24,141,143],{"id":142},"schritt-3-firma-per-name-suchen","Schritt 3: Firma per Name suchen",[15,145,146,147,150],{},"Die Suche erwartet den Anfang des Firmennamens, mindestens drei Zeichen, mit ",[32,148,149],{},"*"," als\nPlatzhalter:",[103,152,156],{"className":153,"code":154,"language":155,"meta":108,"style":108},"language-json shiki shiki-themes github-light github-dark","{\n  \"name\": \"Muster*\",\n  \"canton\": \"SG\",\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},"\"Muster*\"",[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},"\"SG\"",[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],{},"Sie verhält sich wie die genaue Suche auf der Zefix-Website. ",[32,212,213],{},"activeOnly"," blendet gelöschte\nFirmen aus. Die Treffer kommen in Kurzform; die vollen Daten holt danach eine Abfrage per UID.",[24,216,218],{"id":217},"was-in-der-antwort-steht","Was in der Antwort steht",[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"," (Sitzgemeinde) und ",[32,235,236],{},"canton",[52,238,239,242],{},[32,240,241],{},"legalForm"," mit dem Code nach eCH-0097",[52,244,245,171,248,251,252,255,256,259,260],{},[32,246,247],{},"status",[32,249,250],{},"ACTIVE"," aktiv, ",[32,253,254],{},"BEING_CANCELLED"," in Liquidation, ",[32,257,258],{},"CANCELLED"," gelöscht, dazu\n",[32,261,262],{},"deletionDate",[52,264,265,268],{},[32,266,267],{},"purpose",", der Zweck aus dem Handelsregister",[52,270,271,274],{},[32,272,273],{},"address"," mit Strasse, Hausnummer, Postleitzahl und Ort",[52,276,277,75,280,283],{},[32,278,279],{},"capitalNominal",[32,281,282],{},"capitalCurrency"," bei Kapitalgesellschaften",[52,285,286,289,290,293],{},[32,287,288],{},"sogcPub"," mit den SHAB-Publikationen und ",[32,291,292],{},"oldNames"," mit früheren Namen",[52,295,296,299],{},[32,297,298],{},"cantonalExcerptWeb",", der Link zum Auszug des kantonalen Handelsregisters",[24,301,303],{"id":302},"zefix-oder-uid-register","Zefix oder UID-Register?",[15,305,306],{},"Zefix kennt nur Firmen mit Handelsregistereintrag. Das UID-Register des Bundesamts für\nStatistik kennt jedes Unternehmen mit UID, auch Einzelunternehmen und Vereine ohne Eintrag,\nund zeigt den Eintrag im Mehrwertsteuerregister. Seine öffentliche Abfrage braucht kein Konto.",[15,308,309,310,314],{},"Für die Frage, ob eine UID im Checkout gültig und die Firma aktiv ist, reicht deshalb das\nUID-Register. Zefix lohnt sich, wenn Zweck, Kapital, frühere Namen oder Publikationen gebraucht\nwerden. Wie die Prüfung über das UID-Register geht, steht im Ratgeber\n",[37,311,313],{"href":312},"\u002Fratgeber\u002Fuid-nummer-pruefen\u002F","UID-Nummer prüfen",".",[24,316,318],{"id":317},"stolperfallen","Stolperfallen",[49,320,321,336,342,351,357],{},[52,322,323,327,328,331,332,335],{},[324,325,326],"strong",{},"Schreibweise der UID:"," Im Pfad ohne Trenner (",[32,329,330],{},"CHE107721785","), in der Anzeige mit\n(",[32,333,334],{},"CHE-107.721.785","). Vor der Abfrage normalisieren.",[52,337,338,341],{},[324,339,340],{},"Liste statt Objekt:"," Auch die Abfrage per UID liefert eine Liste.",[52,343,344,347,348,350],{},[324,345,346],{},"Liquidation:"," ",[32,349,254],{}," ist noch nicht gelöscht, aber auch kein normaler\nGeschäftspartner mehr. Die eigene Anwendung muss entscheiden, wie sie damit umgeht.",[52,352,353,356],{},[324,354,355],{},"Zugangsdaten:"," Benutzername und Passwort gehören auf den Server. Ein Aufruf aus dem\nBrowser würde sie jedem Besucher zeigen.",[52,358,359,362],{},[324,360,361],{},"Zwischenspeichern:"," Firmendaten ändern sich selten. Antworten eine Weile speichern statt\nbei jedem Seitenaufruf neu zu fragen.",[24,364,366],{"id":365},"fertig-im-shop","Fertig im Shop",[15,368,369,370,374],{},"Wer UIDs im WooCommerce-Checkout prüfen will, braucht dafür keinen eigenen Code: mein Plugin\n",[37,371,373],{"href":372},"\u002Fuid-check\u002F","UID-Check"," prüft Format, Prüfziffer und Status im UID-Register, ohne Konto und\nohne Schlüssel.",[15,376,377],{},[37,378,380],{"href":379},"\u002Fratgeber\u002F","Alle Ratgeber",[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},"Zefix API (ZefixPublicREST): Zugang beantragen, Firma per UID oder Name suchen, Felder der Antwort, Stolperfallen und der Unterschied zum UID-Register. Anleitung mit Beispielen.","md",{},true,"\u002Fratgeber\u002Fzefix-api",null,{"title":5,"description":395},"ratgeber\u002Fzefix-api","Wv95mn0TXsRlUuKm3tvf7Lxeb4cd_J3VN-TRX_VCJjc",1791126634328]