ConfigureWise — AVZ - E-CON SERVICES

Username

Password

Model

e-Con API

Sessie-gebaseerde SOAP API. Base URL: https://acc.configurator.avzgroup.nl/econ-acc-api/EConWebService.asmx

Workflow

Connect → GetValues ↔ SetValues → Disconnect

Operations

Connect

Start een sessie. Retourneert een connectionId voor alle vervolgcalls.

Parameter	Type	Beschrijving
Environment	string	Omgeving identifier
Model	string	Model naam
Version	string	Model versie

GetValues

Haalt huidige waarden op. Response bevat HTML-encoded JSON — eerst decoden, dan parsen.

Parameter	Type	Beschrijving
Id	string	connectionId
Names	array	Property namen

SetValues

Wijzigt property waarden. Voeg altijd generate: true toe als laatste item.

Parameter	Type	Beschrijving
Id	string	connectionId
Names	array	Property namen of fullId's + `generate`
Values	array	Waarden (zelfde volgorde als Names)

Disconnect

Sluit de sessie. Altijd aanroepen, ook bij errors.

JSON Response Structuur

GetValues retourneert een array van property-objecten. Elk object heeft:

Veld	Type	Beschrijving
`id`	string	Property identifier
`fullId`	string	Volledig pad (punt-notatie voor objects, brackets voor arrays)
`label`	string	Display label
`value`	any	Primitief of array van child-properties
`dataType`	string	`string` \| `boolean` \| `number` \| `long` \| `double` \| `array` \| `object`
`style`	object	UI rendering metadata
`options`	array	Keuzemogelijkheden (optioneel)

DataTypes & Rendering

Primitieve types

dataType	Control	Voorbeeld
`string`	Tekstveld	Hoeklijn_toevoegen
`boolean`	Checkbox	—
`number` / `long` / `double`	Numeriek veld	Aantal, Breedte_totaal

Met options (simpel)

Wanneer options aanwezig is met id + label: dropdown/select.

"options": [
  { "id": "125", "label": "125" },
  { "id": "205", "label": "205" }
]

Voorbeelden: Kastmaat, Kleur_lamel, Toebehoren_bediening

Object met options + properties

dataType: "object" met options die elk een properties array bevatten. Dropdown selecteert een optie, properties worden als preview getoond.

{
  "id": "Geleider_links",
  "dataType": "object",
  "value": [
    { "id": "Geleider", "value": "H25", "style": { "zoomcolumn": "true" } },
    { "id": "Image", "value": "./images/.../H25.jpg", "style": { "image": "true" } }
  ],
  "options": [
    {
      "id": "H25", "label": "H25",
      "properties": [
        { "id": "Geleider", "value": "H25" },
        { "id": "Image", "value": "./images/.../H25.jpg", "style": { "image": "true" } }
      ]
    }
  ]
}

Properties met style.image: "true" worden als afbeelding getoond naast de dropdown.

Object/Array (container)

dataType: "object" of "array" zonder options: inklapbare groep met child-properties.

Visible

Elk item kan een visible boolean bevatten. Wanneer visible: false wordt het element verborgen. Dit werkt recursief: als een bovenliggend element onzichtbaar is, zijn alle onderliggende elementen dat ook.

Instructions Array

De response bevat een aparte top-level Instructions array (dataType: "array", control: "instructions"). Elk item bevat een Code en een Instruction (HTML). Deze array wordt niet gerenderd maar dient als lookup: properties met style.help_code verwijzen naar een code in deze array.

{ "id": "Instructions", "dataType": "array", "value": [
  { "value": [
    { "id": "Code", "value": "breedte-rolluik" },
    { "id": "Instruction", "value": "<html>...</html>" }
  ]}
]}

Style Properties

Property	Waarde	Effect
`control`	`instruction`	Read-only instructie, toont `help_content`
`control`	`price`	Prijsweergave
`control`	`action`	Voert een actie uit wanneer via SetValues op `true` gezet
`control`	`validState`	Boolean die aangeeft of de huidige configuratie geldig is
`unit`	`mm` \| `stuks`	Eenheid achter het veld
`help_content`	HTML string	Help-icoon met popup modal (inline HTML)
`help_code`	string	Verwijst naar een code in de `Instructions` array. Toont help-icoon met de bijbehorende instructie-HTML. Werkt naast `help_content`: als één van beide aanwezig is verschijnt het i-icoon
`apiTab`	string	Groepeert velden in visuele tabbladen binnen de configurator. Items met dezelfde `apiTab` waarde verschijnen samen onder één tab. Items zonder `apiTab` komen in de tab "Zonder tab"

Interactiecyclus

Bij iedere keuze van de gebruiker moet een SetValues + GetValues cyclus uitgevoerd worden. Het model bevat regels (rules) die op basis van de gewijzigde waarde andere velden kunnen aanpassen: opties filteren, waarden herberekenen, velden tonen of verbergen. Alleen door na elke wijziging de volledige state opnieuw op te halen kan de UI correct redeneren over de actuele configuratie.

Gebruiker wijzigt waarde → SetValues + generate → GetValues → UI opnieuw renderen

SetValues Conventies

Gebruik fullId voor geneste properties (Vragen.Geleider_links.Geleider)
Altijd generate: true als laatste item toevoegen
Arrays zijn 1-based (Reference1[1])
Names en Values arrays moeten dezelfde lengte hebben

Model

Email.ToAddress

Bestelflow

Wanneer een klant een bestelling plaatst, doorloop je twee fasen: eerst de configuraties opslaan in ERP, daarna een bevestigingsmail sturen.

Fase 1 — Configuraties opslaan

Iedere configuratie heeft een eigen e-Con sessie. Per configuratie:

SetValues → apiAction.SaveToERP = true

GetValues → Check apiAction.SaveToErpSucceed

Zet apiAction.SaveToERP op true via SetValues
Doe een GetValues en controleer of apiAction.SaveToErpSucceed op true staat
Herhaal dit voor elke configuratie in de bestelling

Productgegevens ophalen

De gegevens voor de bevestigingsmail (omschrijving, SKU, EAN, prijs, afbeelding) haal je uit de individuele configurator sessies via het info object in de GetValues response.

Fase 2 — Bevestigingsmail sturen

Als alle configuraties succesvol zijn opgeslagen, open je een nieuwe e-Con sessie met het orderMailer model om de bevestigingsmail te versturen.

Connect → SetValues (count) → SetValues (products) → SetValues (send) → Disconnect

Stap 1: Connect

Open een sessie met model orderMailer.

Stap 2: SetValues — Aantal producten

Stel het aantal producten in zodat e-Con posities beschikbaar stelt:

Email.aantalproducten = 5

Stap 3: SetValues — Productgegevens

Vul per product de details in (1-based index):

Email.Producten[1].Omschrijving = "Rolluik PVC 125x150"
Email.Producten[1].sku = "RL-PVC-125"
Email.Producten[1].ean = "8710001234567"
Email.Producten[1].prijs = 249.95
Email.Producten[1].afbeelding = "mail/img/product.png"

Het veld afbeelding is optioneel.

Stap 4: SetValues — Verzenden

Stel het ontvangstadres in en trigger de verzending:

Email.ToAddress = "klant@voorbeeld.nl"
Verzendmail = true

Stap 5: Disconnect

Sluit de sessie.

CONFIGUREWISE // AVZ - E-CON SERVICES