ConfigureWise — AVZ - E-CON SERVICES

Username

Password

Model

Image Base URL

AVZ webshop API tester en live documentatie. Test en verken de e-Con APIs die de AVZ webshop aansturen. Vul hierboven inloggegevens en een model in om calls uit te voeren.

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

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

Execution Pipeline

Response Data

CONFIGUREWISE // AVZ - E-CON SERVICES