Werken met custnum / e-mailadres als unieke klanteigenschap
Bij elke order die via de API naar Softwear wordt gestuurd, moet de klant herkenbaar zijn. Er moet een uniek kenmerk zijn wat alle klanten behalve 1 uitsluit.
Dit kan zijn:
- e-mailadres
- klantnummer
E-mailadres als basis
Dit is standaard. Hier hoeft niks voor gedaan te worden.
Wat uiteraard wel belangrijk is, is dat elk e-mailadres maar 1 x in de database staat, anders weet de API nog niet waar de order bij gezet moet worden en kan de verkeerde gekozen worden.
Order insturen bij bestaande klant
Bij het versturen van een order moeten in ieder geval de volgende onderdelen benoemd worden:
- token, om te bepalen welke klantinstallatie de API gaat verwerken
- e-mailadres
- artikelgegevens
Als het e-mailadres herkend wordt, zal de order gekoppeld worden aan de klant die al bekend was.
Worden er meer gegevens meegestuurd, zoals postcode en adres, dan zullen die de aanwezige waardes in de database overschrijven. Dit is niet aan te raden.
Order insturen bij nieuwe klant
- token, om te bepalen welke klantinstallatie de API gaat verwerken
- e-mailadres
- naw-gegevens
- artikelgegevens
Door met het e-mailadres ook andere naw-gegevens mee te sturen, wordt de klant aangemaakt en direct gevuld met data. De order wordt ook op naam van de nieuwe klant gezet.
Er kan ook eerst een setclient gemaakt worden waarin de naw-gegevens staan. De sendorder die dan volgt, hoeft dan alleen nog het e-mailadres te bevatten, naast het token en de artikelgegevens van de order.
Klantnummer als basis
Dit wordt veel gebruikt bij groothandels.
Het is dan verplicht een klantnummer mee te geven.
- Het custnum is standaard niet verplicht: wordt er gewerkt met het custnum als basis, dan moet dit in de webshopconfiguratie wel aangegeven worden (neem contact op met de servicedesk van Softwear)
- als het custnum niet verplicht is, is het ook niet verplicht een nieuwe klant in te schieten als setclient.
Order insturen bij bestaande klant
Bij het versturen van een order moeten in ieder geval de volgende onderdelen benoemd worden:
- token, om te bepalen welke klantinstallatie de API gaat verwerken
- klantnummer (custnum=xx)
- artikelgegevens
Als het klantnummer herkend wordt, zal de order gekoppeld worden aan de klant met dat nummer.
Worden er meer gegevens meegestuurd, zoals postcode en adres, dan zullen die genegeerd worden. Pas bij een setclient worden de gegevens overschreven.
Order insturen bij nieuwe klant
Stuur voor de order, eerst een setclient, met daarin de naw-gegevens en dergelijke van de nieuwe klant.
Als respons geeft de server een klantnummer terug (custnum)
Gebruik dit nummer voor de order.
De order bestaat in ieder geval uit:
- token, om te bepalen welke klantinstallatie de API gaat verwerken
- klantnummer (custnum=xx)
- artikelgegevens
Voorkeur?
- Als e-mailadressen er dubbel instaan of als de naw-gegevens niet zomaar gewijzigd moeten worden is het gebruik van de custnum's aan te raden.
- Bij de sendorder hoeft dan alleen het custnum worden ingevoerd, samen met het token en de bestelling. De klantgegevens wijzigen dan niet, pas bij een setclient met gewijzigde info.
- B2C-webshop: als de naw-gegevens in de Remarks worden gezet zodat de consumentengegevens niet tussen de debiteurengegevens komen te staan, adviseren we het gebruik van de custnum
Geldt bovenstaande niet, dan mag ook gewerkt worden met het e-mailadres.
Configuratie webshop
Als er gekozen wordt voor het gebruik van klantnummers als unieke eigenschap van de klant, dan moet in de webshopconfiguratie de waarde "custnumkeyinapi" staan. Daarmee wordt het invoeren van een klantnummer verplicht en wordt het e-mailadres verder genegeerd.
Dit kan alleen gedaan worden door iemand van de servicedesk of de webshopconsultant. Stuur een bericht naar help@softwear.nl om deze aanpassing aan te vragen.