Forbind WordPress med soge.dk

Lynbro-pluginsene til WordPress henter danske køretøjsdata (DMR) og virksomhedsdata (CVR) fra soge.dk. De forbinder med en API-nøgle, som du opretter til dit website og indsætter i WordPress — soge.dk får aldrig adgang til dit website.

Hvilke plugins bruger det

  • Lynbro Soge Lookup — Blokke og shortcodes til opslag på nummerplade/stelnummer og CVR samt automatisk udfyldning af firmadata i WooCommerce og populære formular-plugins.
  • dk-accounting — CVR-felt i WooCommerce-kassen: kunden skriver et CVR-nummer, og firmanavn, adresse og momsnummer udfyldes.

Sådan kommer du i gang — fire trin

  1. Opret en gratis soge.dk-kontoTilmeld dig med din e-mail og bekræft koden, vi sender. Intet betalingskort; Free-abonnementet er gratis for altid.
  2. Opret en API-nøgle til dette websiteÅbn siden med API-nøgler. Kommer du fra pluginnet, er navnet udfyldt som "dit-website.dk — WordPress". Klik Opret nøgle og kopiér nøglen — den vises kun én gang. Brug én nøgle pr. website.
  3. Indsæt nøglen i WordPressGå i WordPress til Indstillinger → Soge Lookup (eller pluginnets fane Forbindelse), indsæt nøglen i feltet API-nøgle og gem. Nøglen gemmes krypteret på din server og sendes aldrig til de besøgendes browsere.
  4. Test forbindelsenKlik Gem og test. Pluginnet kalder GET /api/v1/me og viser kontoen, abonnementet, resterende kvote og de data, dit abonnement omfatter. Kaldet er gratis og bruger ikke af kvoten.

Hvad sendes til soge.dk

  • Kun det, der slås op: nummerpladen, stelnummeret eller CVR-nummeret, der skrives i blokken eller formularen.
  • Din API-nøgle i headeren X-API-KEY samt din servers IP-adresse og User-Agent (WordPress sender "WordPress/<version>; <dit website>").
  • Ingen personoplysninger om besøgende, cookies, WordPress-brugere, adgangskoder eller databaseadgang. soge.dk forbinder aldrig til dit website — alle kald går fra din server til soge.dk.

Sådan er nøglen knyttet til dit website

En nøgle virker fra et begrænset antal servere ad gangen (1 på Free, flere på betalte abonnementer). En servers plads frigives efter en times inaktivitet, så flytning til ny host eller en staging-kopi virker fortsat. Er grænsen nået, afvises kun den ekstra server (fejl device_limit) — selve nøglen spærres aldrig.

Hvad hvert abonnement omfatter

GratisStarterBusinessPro
API-kald / måned1.5006.00030.000100.000
CVR-opslag i kassen / måned1.00010.00050.000200.000
Kald / minut201806001.200
Servere pr. nøgle12410
Ejere (ownership)—JaJaJa
Regnskabstal (financials)—JaJaJa
Køretøjshistorik (km-stand, syn, forsikring…)—JaJaJa

Free stopper ved månedens kvote (fejl quota_exceeded, HTTP 402) og starter igen den 1. Betalte abonnementer virker videre ud over kvoten. Priser: se priser.

Ejere og regnskabstal

GET /api/v1/cvr/{cvr}/ownership (ejere, datterselskaber, relaterede virksomheder) og GET /api/v1/cvr/{cvr}/financials (omsætning, resultat, egenkapital og aktiver fra årsrapporterne, sammenligning over to år) er med i Starter, Business og Pro. En Free-nøgle får HTTP 403 med koden scope_missing — pluginnet udelader så blot de sektioner.

CVR-opslag i kassen (dk-accounting)

GET /api/v1/checkout/cvr/{cvr} returnerer firmanavn, adresse, postnummer, by, momsnummer (DK + CVR) og om virksomheden er aktiv — med samme feltnavne som cvrapi.dk (name, address, zipcode, city, vat). Det virker uden API-nøgle: pr. server 20/minut og 500/døgn, og pr. website 100/døgn (send dit websites adresse i headeren X-Lynbro-Site). Med en nøgle, også Free, har nøglen sin egen kvote til kasseopslag (1.000/måned på Free), som ikke bruger af dine API-kald.

curl -H "X-Lynbro-Site: https://your-shop.dk" https://soge.dk/api/v1/checkout/cvr/10007127

{"data": {"cvr": "10007127", "name": "…", "address": "…", "zipcode": "…", "city": "…",
          "vat": "DK10007127", "status": "NORMAL", "active": true, …},
 "meta": {"tier": "keyless", "remaining": 99}}

Fejlkoder

Alle fejl har samme form. Teksten følger headeren Accept-Language (da, en eller uk).

{"error": {"code": "scope_missing", "message": "…",
           "details": {"scope": "companies:ownership", "upgrade_url": "https://soge.dk/en/pricing"}}}
KodeHTTPBetydning
invalid_key401Nøglen mangler, er tastet forkert eller er tilbagekaldt. Kopiér den igen eller opret en ny.
scope_missing403Dit abonnement omfatter ikke disse data (details.scope). Opgradér, ellers springer pluginnet sektionen over.
device_limit403Nøglen bruges allerede på så mange servere, som dit abonnement tillader. Brug én nøgle pr. website.
quota_exceeded402Månedens kvote på Free er brugt (details.resets_at).
rate_limited429For mange kald pr. minut eller døgn. Vent Retry-After sekunder.
not_found404Intet køretøj eller ingen virksomhed med det nummer.
invalid_cvr422Et CVR-nummer skal være præcis 8 cifre.
upstream_unavailable503Et offentligt register svarede ikke. Prøv igen om lidt.

Tilbagekald eller udskift en nøgle

På siden med API-nøgler eller i dit kontrolpanel: Tilbagekald stopper nøglen med det samme. "Brug til dette website (ny værdi)" beholder nøglen men giver den en ny værdi — den gamle holder op med at virke straks, så indsæt den nye i WordPress. Afinstallerer du pluginnet, slettes nøglen i WordPress; tilbagekald den også her.

For udviklere

OpenAPI: https://soge.dk/api/openapi.json · reference: https://soge.dk/api-doc · alle kald server-til-server over HTTPS, basis-URL https://soge.dk/api/v1.

curl -H "X-API-KEY: $SOGE_KEY" https://soge.dk/api/v1/me

{"data": {"account_name": "…", "plan": "free", "plan_name": "Free",
          "quota": {"unit": "calls", "used": 12, "limit": 1500, "resets_at": "…", "hard_stop": true},
          "scopes": ["vehicles:read", "companies:read", "addresses:read", "checkout:cvr"],
          "origins": [], "key": {"id": 1, "name": "your-shop.dk — WordPress", "last4": "…"},
          "sandbox": false}}