Wanneer je een transactie doorstuurt naar de provider via een Salesdock-integratie, kan de order op de status Actie vereist belanden met een validatiefout die aangeeft dat een gekozen waarde ongeldig is. In dit artikel lees je wat die melding betekent en hoe je 'm oplost.

Hoe herken je deze melding?

De transactie springt van status Geaccepteerd naar Actie vereist, en in het logboek van de order zie je een melding in deze vorm:

Error bij versturen sale Code: 400 Reason: Flow validatie error. questionData.[veld] : 'Het geselecteerde [veld] is ongeldig.'

In plaats van Flow validatie error. kan er ook Validatie fout. staan. Het deel achter questionData. is de technische naam van het veld dat wordt afgekeurd. Voorbeelden die je kunt tegenkomen:

  • g_connection_type — het gasaansluiting-type (‘Het geselecteerde g connection type is ongeldig.’)
  • e_connection_type — het elektra-aansluiting-type
  • juridische-vorm — de juridische vorm bij een zakelijke order

Herkenpunt: de exacte tekst verschilt per veld, maar het patroon is steeds ‘Het geselecteerde … is ongeldig’. Staat er in plaats daarvan ‘… is verplicht’, dan gaat het om een leeg (niet ingevuld) veld — dat is een andere situatie, zie het artikel onderaan.

Wat betekent deze melding?

Het veld is wél ingevuld, maar met een waarde die de ontvangende kant (de provider) niet accepteert. Elk keuzeveld en elk aansluit-type heeft aan de kant van de provider een vaste lijst met toegestane opties. Zit de meegestuurde waarde niet in die lijst, dan wordt de order geweigerd met ‘is ongeldig’.

Dit ontstaat vrijwel altijd doordat de toegestane opties aan de verzendende kant niet gelijk zijn aan die aan de ontvangende kant — bijvoorbeeld een aansluit-type of keuzewaarde die in de ene flow bestaat, maar niet (of onder een andere naam) in de flow van de provider.

Zo los je het op

  1. Kijk in de foutmelding welk veld het betreft (het deel achter questionData., bijvoorbeeld g_connection_type), en welke waarde daarvoor op de order staat.
  2. Controleer aan de kant van de provider (de ontvangende flow of het product) welke opties voor dat veld zijn toegestaan. Bij aansluit-typen zijn dat de aansluit-type-instellingen op de flow; bij keuzevragen de ingestelde opties of gegevensbron.
  3. Zorg dat de meegestuurde waarde exact overeenkomt met een toegestane optie aan de ontvangende kant — of pas de waarde op de order aan naar een optie die de provider wél kent.
  4. Verstuur de order opnieuw.

Let op: wordt dit veld centraal via de integratie beheerd en kun je de opties zelf niet aanpassen? Neem dan contact op met support en stuur de order plus de exacte foutmelding mee, dan kijken we met je mee.

Controleren of het gelukt is

Is de waarde aan beide kanten gelijk, dan verlaat de order na opnieuw versturen de status Actie vereist en krijgt hij een Uitgaand ID. Dat is het teken dat de provider de order heeft geaccepteerd.

Zie je een Uitgaand ID op de order verschijnen? Dan is de order succesvol doorgestuurd.

Gerelateerd

Krijg je in plaats van ‘is ongeldig’ juist de melding dat een veld verplicht is (het veld is dan niet ingevuld in plaats van verkeerd ingevuld)? Bekijk dan Salesdock integratie foutmelding ‘Het questionData. veld is verplicht’ bij het versturen naar de provider.

Begrippenlijst

questionData.[veld] — de technische naam van het productvraag- of flowveld dat wordt afgekeurd.

Aansluit-type (connection type) — het type gas- of elektra-aansluiting; per flow is ingesteld welke waarden zijn toegestaan.

Uitgaand ID — het referentienummer dat de order krijgt zodra de provider hem heeft ontvangen; zichtbaar bewijs dat het versturen is gelukt.