Hvordan ved vi, at leveringsadressen findes, før ordren gemmes?

Hvorfor tjekke igen på serveren

Adressefeltet i checkout giver kunden forslag fra DAR, og når kunden vælger et, får du adressens id’er med i formularen. Men der er flere veje uden om forslagene: browserens autoudfyld, en indsat adresse, en kunde, der skriver videre efter valget, en ordre fra en app eller et andet system. Og et id, der kommer fra browseren, er bare tekst, indtil din server har set det i registret.

Tjekket bruger ét eller to kald pr. ordre. Det er billigt nok til at køre på hver ordre, men lad være med at kalde ved hvert tastetryk — det er feltets opgave.

Kunden valgte et forslag: slå id’et op

Send kun de to id’er fra feltet med formularen — adgangsadresse_id og adresse_id — og lad serveren hente resten. /v1/adresser med adgangsadresseid giver alle boliger på adressen i ét kald: hver med sin egen UUID, etage, dør, BFE-nummer og kommunekode. Findes id’et ikke, er listen tom.

{
1  "antal": 12,
  "side": 1,
  "per_side": 1000,
  "srid": 4326,
  "adresser": [
    {
      "betegnelse": "Jagtvej 37, 2200 København N",
2      "adresse_id": "dff92675-2e1d-4f83-8f43-c7a05508da7d",
3      "etage": null,
      "doer": null,
      "…": "…"
    },
    {
      "betegnelse": "Jagtvej 37, 1. th, 2200 København N",
2      "adresse_id": "0a3f509e-f830-32b8-e044-0003ba298018",
      "adgangsadresse_id": "0a3f507a-9cb8-32b8-e044-0003ba298018",
      "etage": "1",
      "doer": "th",
      "postnr": "2200",
4      "kommunekode": "0101",
4      "bfe_nummer": 9866621,
      "koordinat": { "lon": 12.5456551, "lat": 55.6917347 }
    }
  ]
}

curl -G "https://api.grundfast.dk/v1/adresser" \
  --data-urlencode "adgangsadresseid=0a3f507a-9cb8-32b8-e044-0003ba298018" \
  --data-urlencode "per_side=1000" \
  -H "Authorization: Bearer $GRUNDFAST_API_KEY"

Adresseindekset bag listen opdateres dagligt fra DAR. En adresse, der er oprettet i dag, kan derfor mangle et døgn. Før du afviser et tomt svar, så slå id’et op med /v1/adresse/:uuid, som spørger DAR direkte: 404 betyder, at der ikke findes en gældende adresse med det id. Det svar har ikke BFE-nummeret, så hent det ved næste tjek.

curl "https://api.grundfast.dk/v1/adresse/0a3f509e-f830-32b8-e044-0003ba298018" \
  -H "Authorization: Bearer $GRUNDFAST_API_KEY"

Adressen er skrevet i hånden: vask den

Uden id har du kun teksten. Send den til /v1/datavask/adgangsadresser, som finder de adresser i DAR, der ligner mest, og giver det bedste match en kategori: A er sikkert, B er sandsynligt, C er usikkert, og antal: 0 betyder, at intet ligner. Hvordan formularen reagerer på hver af dem — godkend, spørg “mente du …?” eller afvis — står på Adressevalidering. Her er det, serveren gør bagefter.

Datavasken arbejder på vej, husnummer og postnummer. Har kunden skrevet etage og dør, så tjek dem bagefter mod den adgangsadresse, vasken fandt:

const svar = await gf.datavask('Jagtvej 37, 2200 Kbh N');
if (svar.antal > 0 && svar.kategori === 'A') {
  const { adresser } = await gf.adresser({
    adgangsadresseid: svar.resultater[0]!.adgangsadresse_id,
    etage: '1',
    doer: 'th',
  });
  // Én bolig = etage og dør findes. Tom liste = spørg kunden.
}

Det, der skal gemmes på ordren

Gem felterne fra serverens svar, ikke fra formularen. Så kan du senere slå adressen op igen på id og sammenligne uden stavefejl. Gem både postnr og kommunekode som tekst med foranstillet nul.

Når kunden siger, at adressen er rigtig

Et nybyggeri kan være beboet, før adressen står i DAR, og en kunde kan have ret, selv om registret ikke har adressen endnu. Afvis derfor ikke hårdt. Lad kunden bekræfte sin egen tekst, gem ordren med status overstyret og uden id’er, og send den til manuel kontrol. Erstat aldrig kundens tekst med et B- eller C-forslag, som kunden ikke selv har valgt. Kør datavasken igen nogle dage senere: dukker adressen op som et A, kan du sætte id’erne på bagefter.

Når opslaget fejler

• Stop ikke ordren. Svarer API’et ikke inden for et par sekunder, eller med 5xx, så gem ordren med status ikke tjekket og kør tjekket igen senere. Svar med 5xx og 504 lægges tilbage i kvoten.
• Tjek formatet først. Et id, der ikke er en UUID, giver 400 — og et 400 tæller som et kald. En simpel kontrol af formatet koster ingenting.
• 503 fra /v1/adresser betyder, at boligindekset ikke er indlæst. Fald tilbage til /v1/adresse/:uuid for den bolig, kunden valgte.
• Hold nøglen på serveren. Tjekket kører med en hemmelig nøgle i din backend, aldrig i browseren. Se Godkendelse.