[{"data":1,"prerenderedAt":405},["ShallowReactive",2],{"seite-\u002Ffr\u002Fratgeber\u002Fzefix-api\u002F":3},{"id":4,"title":5,"body":6,"description":396,"extension":397,"meta":398,"navigation":399,"path":400,"robots":401,"seo":402,"stem":403,"__hash__":404},"seiten_fr\u002Fratgeber\u002Fzefix-api.md","API Zefix, interroger les données du registre du commerce",{"type":7,"value":8,"toc":386},"minimark",[9,14,18,23,28,48,80,83,87,95,99,102,137,140,144,151,208,215,219,301,305,308,316,320,364,368,376,382],[10,11,13],"h1",{"id":12},"api-zefix-interroger-les-données-du-registre-du-commerce","API Zefix : interroger les données du registre du commerce",[15,16,17],"p",{},"Zefix est l’index central des raisons de commerce de la Suisse, exploité par l’Office fédéral du\nregistre du commerce (OFRC) au sein de l’Office fédéral de la justice. Outre la recherche dans le\nnavigateur, Zefix existe comme interface REST, la « Zefix PublicREST API ». Une application y\nobtient directement du registre du commerce la raison sociale, le siège, la forme juridique, le\nstatut et le but. Ce guide montre l’accès, les requêtes et la réponse, et quand le registre IDE\nest le choix le plus simple.",[19,20],"produkt-ablauf",{":schritte":21,"titel":22},"[{\"ort\":\"Votre application\",\"text\":\"IDE ou raison sociale\",\"eigen\":true},{\"ort\":\"Zefix PublicREST\",\"text\":\"Connexion avec nom d’utilisateur et mot de passe\"},{\"ort\":\"Registre du commerce\",\"text\":\"Nom, siège, forme juridique, statut, but\"},{\"ort\":\"Votre application\",\"text\":\"Remplir le formulaire ou vérifier le client\"}]","Déroulement d’une requête Zefix : votre application interroge Zefix PublicREST avec nom d’utilisateur et mot de passe sur un IDE ou un nom et reçoit les données du registre du commerce",[24,25,27],"h2",{"id":26},"ce-que-fournit-lapi-zefix","Ce que fournit l’API Zefix",[15,29,30,31,35,36,43,44,47],{},"L’interface se trouve sous ",[32,33,34],"code",{},"https:\u002F\u002Fwww.zefix.admin.ch\u002FZefixPublicREST",". La description des\nendpoints est dans l’",[37,38,42],"a",{"href":39,"rel":40},"https:\u002F\u002Fwww.zefix.admin.ch\u002FZefixPublicREST\u002Fswagger-ui\u002Findex.html",[41],"nofollow","interface Swagger",",\nlisible par machine en OpenAPI sous ",[32,45,46],{},"\u002Fv3\u002Fapi-docs",". Les endpoints principaux :",[49,50,51,58,64,70],"ul",{},[52,53,54,57],"li",{},[32,55,56],{},"GET \u002Fapi\u002Fv1\u002Fcompany\u002Fuid\u002F{id}"," : entreprise par IDE",[52,59,60,63],{},[32,61,62],{},"POST \u002Fapi\u002Fv1\u002Fcompany\u002Fsearch"," : recherche par nom, forme juridique, siège ou canton",[52,65,66,69],{},[32,67,68],{},"GET \u002Fapi\u002Fv1\u002Fsogc\u002Fbydate\u002F{date}"," : publications d’un jour dans la Feuille officielle suisse du\ncommerce (FOSC)",[52,71,72,75,76,79],{},[32,73,74],{},"GET \u002Fapi\u002Fv1\u002FlegalForm"," et ",[32,77,78],{},"GET \u002Fapi\u002Fv1\u002Fcommunity"," : listes des formes juridiques et des\ncommunes",[15,81,82],{},"Les données sont soumises à la condition « Open use », avec l’obligation d’indiquer la source.",[24,84,86],{"id":85},"étape-1-demander-un-accès","Étape 1 : demander un accès",[15,88,89,90,94],{},"Les requêtes sont gratuites mais demandent un compte. L’OFRC attribue l’accès sur demande par\ne-mail à ",[37,91,93],{"href":92},"mailto:zefix@bj.admin.ch","zefix@bj.admin.ch"," ; le nom d’utilisateur est une adresse e-mail. L’authentification se\nfait par HTTP Basic Auth, donc avec nom d’utilisateur et mot de passe à chaque requête. Obtenir\nles identifiants peut prendre quelques jours, mieux vaut donc les demander tôt.",[24,96,98],{"id":97},"étape-2-chercher-une-entreprise-par-ide","Étape 2 : chercher une entreprise par IDE",[15,100,101],{},"L’IDE figure dans le chemin sans points ni tiret :",[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 \"utilisateur@example.ch:motdepasse\" \\\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"," \"utilisateur@example.ch:motdepasse\"",[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 réponse est une liste, pas un objet unique. Si l’IDE n’est pas au registre du commerce, Zefix\nrépond 404.",[24,141,143],{"id":142},"étape-3-chercher-une-entreprise-par-nom","Étape 3 : chercher une entreprise par nom",[15,145,146,147,150],{},"La recherche attend le début de la raison sociale, au moins trois caractères, avec ",[32,148,149],{},"*"," comme\njoker :",[103,152,156],{"className":153,"code":154,"language":155,"meta":108,"style":108},"language-json shiki shiki-themes github-light github-dark","{\n  \"name\": \"Exemple*\",\n  \"canton\": \"VD\",\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},"\"Exemple*\"",[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},"\"VD\"",[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],{},"Elle se comporte comme la recherche exacte sur le site de Zefix. ",[32,212,213],{},"activeOnly"," masque les\nentreprises radiées. Les résultats arrivent sous forme courte ; les données complètes viennent\nensuite d’une requête par IDE.",[24,216,218],{"id":217},"ce-que-contient-la-réponse","Ce que contient la réponse",[49,220,221,237,243,264,270,276,285,295],{},[52,222,223,226,227,226,230,233,234],{},[32,224,225],{},"name",", ",[32,228,229],{},"uid",[32,231,232],{},"legalSeat"," (commune du siège) et ",[32,235,236],{},"canton",[52,238,239,242],{},[32,240,241],{},"legalForm"," avec le code selon eCH-0097",[52,244,245,248,249,252,253,256,257,260,261],{},[32,246,247],{},"status"," : ",[32,250,251],{},"ACTIVE"," active, ",[32,254,255],{},"BEING_CANCELLED"," en liquidation, ",[32,258,259],{},"CANCELLED"," radiée, avec\n",[32,262,263],{},"deletionDate",[52,265,266,269],{},[32,267,268],{},"purpose",", le but inscrit au registre du commerce",[52,271,272,275],{},[32,273,274],{},"address"," avec rue, numéro, code postal et localité",[52,277,278,75,281,284],{},[32,279,280],{},"capitalNominal",[32,282,283],{},"capitalCurrency"," pour les sociétés de capitaux",[52,286,287,290,291,294],{},[32,288,289],{},"sogcPub"," avec les publications FOSC et ",[32,292,293],{},"oldNames"," avec les anciennes raisons sociales",[52,296,297,300],{},[32,298,299],{},"cantonalExcerptWeb",", le lien vers l’extrait du registre du commerce cantonal",[24,302,304],{"id":303},"zefix-ou-registre-ide","Zefix ou registre IDE ?",[15,306,307],{},"Zefix ne connaît que les entreprises inscrites au registre du commerce. Le registre IDE de\nl’Office fédéral de la statistique connaît chaque entreprise ayant un IDE, y compris les\nentreprises individuelles et associations non inscrites, et montre l’inscription au registre TVA.\nSon interrogation publique ne demande pas de compte.",[15,309,310,311,315],{},"Pour savoir si un IDE saisi dans le checkout est valable et l’entreprise active, le registre IDE\nsuffit donc. Zefix vaut la peine quand le but, le capital, les anciennes raisons sociales ou les\npublications sont nécessaires. Le contrôle via le registre IDE est expliqué dans le guide\n",[37,312,314],{"href":313},"\u002Ffr\u002Fratgeber\u002Fuid-nummer-pruefen\u002F","vérifier un numéro IDE",".",[24,317,319],{"id":318},"pièges","Pièges",[49,321,322,337,343,352,358],{},[52,323,324,328,329,332,333,336],{},[325,326,327],"strong",{},"Écriture de l’IDE :"," dans le chemin sans séparateurs (",[32,330,331],{},"CHE107721785","), à l’affichage avec\n(",[32,334,335],{},"CHE-107.721.785","). Normaliser avant la requête.",[52,338,339,342],{},[325,340,341],{},"Liste au lieu d’objet :"," même la requête par IDE renvoie une liste.",[52,344,345,348,349,351],{},[325,346,347],{},"Liquidation :"," ",[32,350,255],{}," n’est pas encore radiée, mais n’est plus un partenaire\ncommercial ordinaire. Votre application doit décider comment la traiter.",[52,353,354,357],{},[325,355,356],{},"Identifiants :"," nom d’utilisateur et mot de passe restent sur le serveur. Un appel depuis le\nnavigateur les montrerait à chaque visiteur.",[52,359,360,363],{},[325,361,362],{},"Mise en cache :"," les données d’entreprise changent rarement. Garder les réponses un moment\nplutôt que d’interroger à chaque affichage de page.",[24,365,367],{"id":366},"prêt-pour-la-boutique","Prêt pour la boutique",[15,369,370,371,375],{},"Pour vérifier les IDE dans le checkout WooCommerce, pas besoin de code maison : mon plugin\n",[37,372,374],{"href":373},"\u002Ffr\u002Fuid-check\u002F","Contrôle IDE"," vérifie format, chiffre de contrôle et statut dans le registre\nIDE, sans compte ni clé.",[15,377,378],{},[37,379,381],{"href":380},"\u002Ffr\u002Fratgeber\u002F","Tous les guides",[383,384,385],"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":387},[388,389,390,391,392,393,394,395],{"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":303,"depth":133,"text":304},{"id":318,"depth":133,"text":319},{"id":366,"depth":133,"text":367},"API Zefix (ZefixPublicREST) : demander un accès, chercher une entreprise par IDE ou par nom, champs de la réponse, pièges et différence avec le registre IDE. Guide avec exemples.","md",{},true,"\u002Fratgeber\u002Fzefix-api",null,{"title":5,"description":396},"ratgeber\u002Fzefix-api","Q_HniqBLungYM1aUkBVjzGtoyg4yp5e8l7VBpYw3AUs",1791118316244]