Handleiding API webformulieren koppeling Econobis Het koppelen van een webformulier Versie Datum Auteur Status 2.0 2-4-2021 Marco Tazelaar Woningdossier toegevoegd 2.1 9-4-2021 M.T Intake velden uitleg 2.2 16-4-2021 M.T Energie leveranciers bijgewerkt 2.3 28-6-2021 M.T. 2.4 5-8-2021 René van Vliet Layout en tekstuele aanpassingen 2.5 10-8-2021 René van Vliet Bij projecten worden per type project alleen een waarde of een aantal geaccepteerd. 2.6 18-9-2021 René van Vliet Tekst over tussenvoegsels 2.7 23-12-2021 M.T S.J Versie met order_eerste_notadatum_start_op in alfresco geplaatst 2.8 04-01-2022 Sjiron de Jong Alfresco Ontdubbelen koppelen aan reeds bestaand contact achternaam check aangevuld 2.9 28-01-2022 Sjiron de Jong Alfresco Redirection for contact form 7 aangepast 3.0 28-01-2022 Sjiron de Jong Alfresco Contact form 7 downgrade toegevoegd 3.1 28-01-2022 Sjiron de Jong Alfresco Gas / Electra optie toegevoegd 3.2 02-08-2022 Sjiron de Jong x Regel over adres toegevoegd aan intakes 3.3 18-9-2022 Yvonne Kleefkens Alfresco Bij contact veld en toegevoegd 3.4 30-9-2022 Yvonne Kleefkens Alfresco Bij keuzelijst intake status nr 4 in behandeling toegevoegd 3.5 11-10-2022 Sjiron de Jong Alfresco Informatie over plugin CF7 to webhook 3.6 9-1-2023 Ineke de Jong Alfresco Veld taak_campagne_id toegevoegd 3.7 27-2-2023 Sjiron de Jong Alfresco Taak types uitgebreid 3.8 24-07-2023 Sjiron de Jong Alfresco forceer_nieuw_contact en contact_groep_ids_contactpersoon toegevoegd 3.9 02-08-2023 Sjiron de Jong Alfresco Keuzelijst maatregelen update mogelijkheid tot uploaden bijlage 3.10 22-01-2024 3.11 29-02-2024 Sjiron de Jong Alfresco Typfout bijlage velden opgelost 3.12 14-05-2024 Marco Tazelaar Vrije velden 3.13 18-04-2024 Sjiron de Jong / Marco Tazelaar Alfresco Changelog geupdate 3.14 15-05-2024 Marco Tazelaar / Sjiron de Jong Alfresco Vrije velden via API sturen 3.15 06-06-2024 Sjiron de Jong Alfresco Backup download voor gravityforms send to third party plugin toegevoegd 3.16 31-07-2024 Sjiron de Jong Alfresco Uitleg woningdossier specificaties velden 3.17 20-08-2024 Sjiron de Jong Alfresco Toevoeging kansactie Velden en kans/kansactie ID’s 3.18 09-09-2024 Sjiron de Jong Alfresco Order Variabele prijs toegevoegd 3.19 30-09-2024 Sjiron de Jong nog niet Kansactie bijlage toegevoegd 3.20 21-10-2024 Ineke de Jong Alfresco Voorbeeld CF7 formulier met groep toegevoegd 3.21 18-11-2024 Sjiron de Jong Alfresco contact_nummer toegevoegd 3.22 12-12-2024 Sjiron de Jong alfresco Verbinding opties toegevoegd 3.24 29-7-2025 Sjiron de Jong Alfresco decimaal_scheidingsteken toegevoegd 3.25 26-8-2025 Sjiron de Jong Alfresco kansactie_afspraak_kalender_id en kansactie_kalender_duratie toegevoegd 3.26 12-1-2026 Sjiron de Jong Wiki kans_code 3.27 20-1-2026 Sjiron de Jong Wiki verbinding_type_id werkt alleen in combinatie met verbinding_met_contact_id 3.28 09-07-2026 Sjiron de Jong Wiki Gravityforms info update 3.29 20-08-2026 Sjiron de Jong Wiki Api type toegevoegd, plus de rechten Kan deelnames aanmaken en Kan orders aanmaken Inleiding Econobis biedt de mogelijkheid om vanuit een extern webformulier gegevens naar Econobis te versturen. De API die hiervoor gebruikt kan worden wordt in dit document beschreven. De stappen om een webformulier te koppelen: Webformulier aanmaken aan op je eigen website Let hierbij op vereiste instellingen en veldnamen (instructie in dit document) Koppeling registreren in Econobis Koppeling activeren in je webformulier Resultaat : Een ingevuld webformulier wordt naar Econobis toegezonden en er wordt een taak aangemaakt. Op basis van de taken kun je de webformulieren afhandelen. Koppeling registreren in Econobis Om gegevens te kunnen ontvangen moet je eerst in Econobis de koppeling registreren (aanmaken). Bij het aanmaken van deze koppeling wordt een API-key gegenereerd, deze is nodig ter identificatie van het formulier. Nieuwe koppeling registreren Ga in Econobis naar Instellingen > Webformulieren om een nieuw webformulier te registreren: Maak een nieuw record aan via het blauwe plusje linksboven. Vul de gegevens van het webformulier in en sla deze op: Api type: het soort koppeling. Kies Webform API voor een regulier webformulier op je eigen website, en Hoomdossier Endpoint API voor de koppeling met Hoomdossier. Dit veld is verplicht. Alleen bij Webform API kun je instellen of het formulier deelnames en orders mag aanmaken; zie de volgende paragraaf. Naam: de weergavenaam van het formulier. Deze naam wordt ook ingevuld in de taak die in Econobis wordt aangemaakt wanneer er een formulier op de website wordt ingevuld dat via deze API gekoppeld is met Econobis. Sleutel (automatisch gegenereerd): De API-key om vanaf het externe formulier verbinding te kunnen maken. Aanvragen per minuut: Een beveiligingsmechanisme welke het aantal aanroepen via dit formulier beperkt tot x per minuut. Als het maximum is overschreden worden de volgende aanroepen geweigerd, na een minuut is de API vervolgens weer toegankelijk. Advies: stel een maximum van 20 per minuut in (meer is onwaarschijnlijk). Datum sleutel: De datum waarop de API-key is aangemaakt. Startdatum/Einddatum: De API-key is alleen geldig binnen het tijdsbestek van deze 2 datums, aanroepen daarbuiten worden geweigerd. Bij het leeg laten van een begin- of einddatum is er geen beperking op het betreffende veld. Verantwoordelijke: Gebruiker of team waaraan taken die worden aangemaakt via dit formulier worden gekoppeld. De verantwoordelijke gebruiker (of alle gebruikers van een team) ontvangt een mail bij een niet te verwerken aanroep (formulier dat niet kan worden verwerkt) met in de mail de ruwe ingevulde gegevens. Deelnames en orders toestaan Kies je bij Api type de waarde Webform API , dan verschijnt onder een scheidingslijn een blok met twee rechten. Daarmee bepaal je per formulier wat de koppeling in Econobis mag aanmaken. Beide staan standaard uit. Let op: een webform API kan altijd contacten aanmaken en personen toevoegen aan groepen ook als je deelnames en orders uit laat staan. De twee rechten, met bij deelnames de toegestane statussen. Kan deelnames aanmaken: staat dit uit, dan worden de deelname_ velden (zie het hoofdstuk Project en deelname velden) niet verwerkt. Toegestane deelnamestatussen: verschijnt zodra Kan deelnames aanmaken aan staat. Hier kies je welke waarden van deelname_mutatie_status_id zijn toegestaan: Interesse (1), Inschrijving (2), Toegekend (3) en Definitief (4). Je kunt er meerdere kiezen. Minimaal één status is verplicht; zonder keuze kun je niet opslaan en verschijnt de melding "Selecteer minimaal 1 status". Kan orders aanmaken: staat dit uit, dan worden de order_ velden (zie het hoofdstuk Order velden) niet verwerkt. Bij orders is er geen extra afbakening zoals de statussen bij deelnames. Bij het API type Hoomdossier Endpoint API zijn deze rechten niet van toepassing en worden ze niet getoond. Na opslaan staan de ingestelde rechten onderaan in het detailscherm van het webformulier: Detailscherm met de ingestelde rechten en de toegestane statussen. Wat er gebeurt als een recht ontbreekt Stuurt een formulier toch deelname- of ordervelden mee terwijl het bijbehorende recht uit staat, of een deelnamestatus die niet is toegestaan, dan geeft de API HTTP 422 terug en staat in het log één van de volgende meldingen: Actie 'participation.create' is niet toegestaan voor dit webformulier. Actie 'order.create' is niet toegestaan voor dit webformulier. Filter 'status_id' met operator 'in' staat waarde '4' niet toe voor actie 'participation.create'. Let op: in het log staat dan "API aanroep vervolg is ongedaan gemaakt!". Alleen het vervolg wordt teruggedraaid: de deelname of order én de taak die normaal bij het webformulier hoort. Het contact dat in dezelfde aanroep is aangemaakt of bijgewerkt blijft wel bestaan. Een verkeerd ingesteld recht levert dus een half verwerkte aanmelding op zonder taak om hem alsnog af te handelen. Controleer de rechten daarom vóórdat het formulier live gaat en houd de foutrapportagemails in de gaten. Een bestaand webformulier aanpassen Webformulieren die vóór deze wijziging zijn aangemaakt hebben nog geen API type. In het detailscherm staat dan Nog te bepalen en worden de rechten niet getoond. Een bestaand formulier zonder API type. Je kunt dit aanvullen zonder het formulier opnieuw aan te maken; de sleutel blijft dus gewoon geldig. Beweeg de muis over het witte blok met de gegevens — er verschijnt een schaduw onder het blok — en klik ergens binnen dat witte blok. Het blok verandert in een invulscherm met de knoppen Sluiten en Opslaan . Kies daar het API type en zet de gewenste rechten. Klikken in het witte blok opent de wijzigmodus. In de wijzigmodus staat naast de sleutel ook de knop Ververs sleutel . Gebruik die alleen bewust: de koppeling werkt daarna met een nieuwe sleutel en de partij die het formulier aanroept moet die overnemen. De API aanroepen Endpoint De API van Econobis is aan te roepen via de volgende url: > Vervang door de betreffende coöperatienaam (de naam die staat in de url waarop Econobis beschikbaar is) Vervang door de gegenereerde sleutel in Econobis. De sleutel kun je eenvoudig naar het klembord kopiëren door in Econobis het webformulier (onder Instellingen) te openen en het klembord icoontje aan te klikken. Het endpoint moet worden aangeroepen via een POST request. Dat wil zeggen dat je in je webformulier het ‘endpoint’ moet configureren / instellen, middels een POST request. Testen Om de functionaliteit te testen los van een formulier kan je gebruik maken van het programma Postman ( https://www.getpostman.com/ ). Op deze manier kan je eenvoudig het resultaat testen van een bepaalde aanroep zonder het hele formulier al te bouwen. Hieronder een voorbeeld: Je vult in postman een post command in met url > waarbij de waarde tussen <> tekens dus verschillen per econobis omgeving en bij key bijvoorbeeldd voornaam en bij waarde Jan Webformulier maken en configureren We gaan er van uit dat je het formulier zelf kunt maken. Dat kan bijvoorbeeld met een Wordpress plugin zoals Context7Forms of Gravity Forms. Contact form 7 Gebruik je Contact forms 7, dan heb je nog een extra plugin nodig: Er zijn 2 opties CF7 to Webhook en Contact form 7 to api + Basic auth Gezien en Contact form 7 to api + Basic auth op dit moment niet werkt met de laatste versie van contact form 7 raden wij CF7 to Webhook aan. CF7 to Webhook Deze werkt op dit moment ook met de nieuwste versie van Contact form 7 Klik in jou wordpress omgeving bij plugins op “nieuwe plugin” en zoek op trefwoord Na activeren moet je in je formulier de antwoordvelden hernoemen naar de waardes in econobis in dit voorbeeld heb je een voornaam, achternaam, mailadres veld en een multiple choice veld met 3 antwoorden waarbij elk antwoord staat voor een ander groeps ID veld in econobis. Als iemand dus kies voor “optie 1” wordt deze contactpersoon toegevoegd aan groep 430 in econobis. Contact form 7 to api + Basic auth Let op: deze plugin werkt op dit moment niet met de laatste versie van Contact form 7 je moet wellicht je contact form 7 downgraden naar versie 5.5.2 en NIET auto-updaten. Meer info over downgraden plugins: https://increasily.com/how-to-downgrade-a-wordpress-plugin/ Gravity forms elite Gravityforms Elite geeft de optie op de “webhooks” plugin te downloaden, deze heb je nodig om informatie naar econobis te sturen. Je kan de webhooks plugin bij een elite versie van gravityforms vinden onder add-ons Zodra de webhooks Zonder gravityforms elite is er een verouderde plugin die (nog) werkt, we raden dit wel af want deze wordt niet actief bijgehouden Het alternatief kan je op eigen verantwoording downloaden op https://econobisbuurtaanpak.nl/wp-content/uploads/2025/09/gravityplus-third-party-post.1.7.0-1.zip Zodra je webhooks hebt geactiveerd kan je bij de formulier instellingen “webhooks” terugvinden (en “send to third party” als je de oude versie nog gebruikt vanaf die pagina klik je op “nieuwe toevoegen” Je kan vervolgens de webhook een naam geven vul de aanvraag URL in (zie hoofdstuk API aanroepen > endpoint voor jou URL) Kies bij body verzoek “velden selecteren” vanaf daar kan je de vragen in jou formulier vertalen naar antwoorden in jou econobis omgeving een voorbeeld van wat standaard velden: (let op, zet dit dus bij het BODY verzoek niet de HEADERS) We kunnen je vanuit Econobis ook ondersteunen bij de API. Dat valt wel buiten de reguliere ondersteuning, dus daarvoor worden de benodigde uren in rekening gebracht. Beschikbare velden Alle in de volgende paragraven beschreven velden zijn beschikbaar om mee te geven. Keuzelijst . Voor een aantal velden zijn alleen bepaalde opties mogelijk. Deze zijn vastgesteld en niet aanpasbaar. Geef voor deze velden het ID mee uit de keuzelijst bij de aanroep naar de API. ID van ……….. Bij sommige velden zoals bij projecten of groepen is het ID nummer nodig dat per Econobis omgeving / coöperatie kan verschillen. Het ID kan je vinden in Url van het project of groep als je bent ingelogd in Econobis. Ga naar het project (of groep) in Econobis. Dan is de ID het Cijfer na laatste slash. In dit geval 1. Nog een voorbeeld van een groep In dit geval is het ID van de groep Buurtwarmte Provinciaal Coördinator 357 Contact Veld Type veld Validatie Default titel_id Keuzelijst titel Moet geldig ID zijn als deze is meegegeven Leeg voorletters Vrije tekst voornaam Vrije tekst tussenvoegsel Vrije tekst Je kan wel een drop down menu maken waarin je definieert welke tussenvoegsels mogelijk zijn. achternaam Vrije tekst geboortedatum Datum (YYYY-MM-DD) Moet geldige datum zijn als deze is meegegeven organisatienaam Vrije tekst Als deze wordt meegegeven wordt er ook een organisatie aangemaakt contact_groep_ids_contactpersoon ID van groep Alleen van toepassing als organisatienaam wordt meegegeven, door het meesturen van deze waarde wordt het contactpersoon ook aan een groep toegevoegd kvk Vrije tekst btw_nr Vrij tekst website Vrije tekst adres_straat Vrije tekst adres_huisnummer Getal Als er letters na het nummer staan worden die aan adres_toevoeging toegevoegd adres_toevoeging Vrije tekst adres_postcode Vrije tekst adres_plaats Vrije tekst adres_land_id Keuzelijst land Niet verplicht Moet geldig ID zijn als deze is meegegeven Leeg adres_type_id Keuzelijst adres Standaard is postal telefoonnummer Vrije tekst emailadres Vrije tekst iban IBAN Iban wordt gecheckt, bij geen geldige Iban wordt dit in de notities van de taak bijgeschreven iban_tnv Vrije tekst incasso_machtiging Boolean Moet 0 of 1 zijn Nee (0) incasso_ondertekening_datum Datum (YYYY-MM-DD) incasso_machtigingskenmerk Vrije tekst Default wordt ordernummer gebruikt incasso_eerste_datum Datum (YYYY-MM-DD) Default wordt orderdatum gebruikt akkoord_privacybeleid Boolean Moet 0 of 1 zijn Nee (0) contact_groep Vrije tekst Wordt alleen verwerkt als er een naam van een bestaande statische groep is meegegeven contact_groep_ids komma gescheiden Id’s van de groepen in Econobis hoomdossier_aanmaken 1 of 0 1 is wel aanmaken, 0 is niet aanmaken contact_opmerkingen Vrije tekst forceer_nieuw_contact 1 of 0 1 is altijd nieuw contact aanmaken 0 is standaard ontdubbeling (zie onderaan dit document) contact_nummer Als je hier een contactnummer mee geeft wordt altijd dit specifieke contact met andere waarde ge-update, er wordt nooit een nieuw contact aangemaakt bijlage URL (directe URL naar het bestand) Alleen PDF, png en jpeg bestanden (bestand te zien bij openen contact dan rechter menu documenten) bijlage2 URL bijlage3 URL verbinding_met_contact_id ID van contact verbinding_type_id Keuzelijst verbinding type Werkt alleen als “verbinding_met_contact_id” is meegegeven decimaal_scheidingsteken , of . Bepaald of je waardes zoals bedragen met komma of punt mee stuurt, default is komma Keuzelijst Titel ID Waarde 1 Dhr 2 Mevr 3 De heer, Mevrouw 4 Familie 5 De heer of mevrouw 6 De heren 7 De dames 8 Erven 9 Geen voorkeur Keuzelijst adres ID Waarde invoice nota postal post visit bezoek deliver aflever Keuzelijst Land ID Waarde AT Oostenrijk AU Australië BE België CA Canada CH Zwitserland DE Duitsland DK Denemarken ES Spanje FI Finland FR Frankrijk GB Verenigd Koninkrijk IE Ierland IT Italië LU Luxemburg NL Nederland NO Noorwegen PT Portugal SE Zweden VS Verenigde Staten Keuzelijst Verbinding ID Waarde 1 Directeur 2 Eigenaar 3 Verkoper 4 Administratief medewerker 5 Technisch medewerker 6 Financieel medewerker 7 Wettelijke vertegenwoordiger 8 Schenker 9 Hoofdvestiging 10 Bewindvoerder 11 Penningmeester 12 Voorzitter 13 Secretaris 14 Medewerker 15 Bestuurslid 16 Huisgenoot 17 Coach van 18 Directeur/bestuurder 19 Directeur-grootaandeelhouder 20 Overste 21 Gegevens beheerd door 22 Projectleider 23 Adviseur 24 Manager 25 Beheerder abonnement 26 Factuur organisatie 27 Buren 28 Politicus 29 Coördinator Tussenvoegsel Het tussenvoegsel veld is een vrij veld in Econobis. Om orde te houden zou je wel een keuze menu kunnen maken op je formulier waarop de mensen kunnen kiezen. De volgende keuze heb je dan "van" "de" "van der" "van de" "van den" "den" "van 't" "van het" "ten" "ter" "te" "el" "le" "in 't" "'t" "von" "du" "da" "de la" "la" "der" "van ter" "op 't" "op den" "op ten" "op de" In forms ziet het er dan als volgt uit

tussenvoegsel: [select tussenvoegsel  first_as_label "Maak keuze uit lijst" "van" "de" "van der" "van de" "van den" "den" "van 't" "van het" "ten" "ter" "te" "el" "le" "in 't" "'t" "von" "du" "da" "de la" "la" "der" "van ter" "op 't" "op den" "op ten" "op de"]

Energieleverancier Veld Type veld Validatie Default energieleverancier_id Keuzelijst energieleverancier Moet geldig ID zijn als deze is meegegeven Leeg energieleverancier_klantnummer Vrije tekst energieleverancier_type_id Keuzelijst type Energieleverancier Verplicht als energieleverancier_id is ingevuld energieleverancier_klant_sinds Datum (YYYY-MM-DD) Moet geldige datum zijn als deze is meegegeven energieleverancier_ean_code_elektra Vrije tekst energieleverancier_status Keuzelijst overstap status energieleverancier energieleverancier_huidig Standaard 1 Keuzelijst Energieleveranciers id Leverancier 26 Agem 27 Anode Energie 24 Betuwe stroom 2 Budget Energie 28 De Groene Stroomfabriek 25 Delta Energie 50 DGB Energie 46 Dorpstroom 3 E.on 45 Easyenergy 4 Eneco 19 Energie VanOns 49 Energie Zero 42 Energiebesteding 5 Energiedirect 21 Energieflex 37 Energyhouse 6 Engie 7 Essent 35 Fenor energie 8 Greenchoice 43 GreenNL 40 Groenpand 44 Hezelaer 9 Holland Wind 33 Holthausen Clean Energy (HCE) 20 Huismerk Energie 30 HVC Kringloop Energie 23 Innova Energie 10 Main energie 38 NieuweStroom 12 NL Energie 1 OM 18 Overig 14 Oxxio 39 ParkStroom 36 Power peers 15 Pure energy 16 Qurrent 48 Qwint 31 Sepa Green 32 Servicehouse 34 Total 22 United Consumers 17 VanDeBron 13 Vattenfall 47 Welkom Energie 41 Windcentrale Keuzelijst type energieleverancier ID Waarde 1 Gas 2 Electriciteit 3 Electriciteit en gas Keuzelijst overstap status energie leverancier ID Waarde 1 Geïnteresseerd 2 Geen Interesse 3 Stapt over 4 Overgestapt Project en deelname velden Een Deelname (participatie) aan een project kan ook via de API worden verwerkt. Let op: het webformulier moet het recht Kan deelnames aanmaken hebben, anders worden onderstaande velden niet verwerkt. Daarnaast moet de meegegeven deelname_mutatie_status_id voorkomen in de Toegestane deelnamestatussen van het webformulier. Zie het hoofdstuk Koppeling registreren in Econobis, paragraaf Deelnames en orders toestaan. Er zijn vier type projecten Lening Obligatie Kapitaal Postcoderoos Bij het kiezen van een project heb je gelijk gekozen voor het type project wat daar bij hoort. Een exacte omschrijving van de type projecten en statussen kan je vinden in de Handleiding projecten De waarden van een project zijn per coöperatie verschillend. De waarde kan je vinden in Url van het project. Ga naar het project in Econobis. Dan is de waarde het Cijfer na laatste slash. In dit geval 1. Deze maken een deelname bij een project aan. Veld Type veld Validatie Default deelname_project_id ID van het project. Moet geldig ID zijn als deze is meegegeven Leeg deelname_iban_uitkering IBAN Iban wordt gecheckt, bij geen geldige Iban wordt dit in de notities van de taak bijgeschreven deelname_iban_uitkering_tnv Vrije tekst deelname_jaarlijks_verbruik Getal Moet heel getal zijn deelname_uitkeren_op_id Keuzelijst deelname uitkering type Alleen bij lening keuze tussen Bijschrijven en Uitkeren deelname_akkoord_regelement 0 of 1 0 niet akkoord 1 is wel akkoord deelname_datum_akkoord_regelement Datum (YYYY-MM-DD) deelname_mutatie_status_id Keuzelijst mutatie status Verplicht deelname_mutatie_aantal Getal deelname_mutatie_bedrag 2 decimalen Mag als geheel getal of met komma geschieden deelname_mutatie_ingangs_datum Datum (YYYY-MM-DD) Verplicht deelname_mutatie_betaal_datum Datum (YYYY-MM-DD) deelname_mutatie_contract_retour Datum (YYYY-MM-DD) deelname_datum_projectinformatie_begrepen Datum (YYYY-MM-DD) deelname_mutatie_betalingskenmerk Keuzelijst mutatie status ID Waarde 1 Interesse 2 Inschrijving 3 Toegekend 4 Definitief Keuzelijst deelname uitkering type ID Waarde 1 Rekening 2 Bijschrijven Bedrag of aantal deelname_mutatie_bedrag Bij een lening gaat het om een € bedrag. De velden bedrag interesse, bedrag inschrijving, bedrag toegekend of bedrag definitief zijn geen aparte velden in de API. Dit bedrag wordt gebruikt voor bedrag interesse, bedrag inschrijving, bedrag toegekend of bedrag definitief en soort bedrag is dus afhankelijk van de status die is meegegeven. deelname_mutatie_aantal Bij Obligaties, Kapitaal en Postcoderoos dan gaat het om een aantal obligaties of deelnames. De velden aantal interesse, aantal inschrijving, aantal toegekend of aantal definitief zijn geen aparte velden in de API. Dit aantal wordt gebruikt voor aantal interesse, aantal inschrijving, aantal toegekend of aantal definitief en soort aantal is dus afhankelijk van de status die is meegegeven. Bij een obligatie en kapitaal moet er alleen een aantal worden aangeleverd. En niet een waarde. Bij een lening moet er alleen een bedrag worden aangeleverd en geen aantal. Daarom is aan de Econobis API kant ingesteld de volgende regels Ongeacht of bedrag en/of aantal binnenkomt via webformulier wordt deelname mutatie (inleg) als volgt gevuld: Bij type Lening projecten wordt nu alleen bedrag overgenomen, aantal in deelname mutatie regel zal leeg blijven. Bij overige typen (Obligatie, Kapitaal en PCR) projecten wordt nu alleen aantal overgenomen, bedrag in deelname mutatie regel zal leeg blijven. Datum velden De verwerkingsdatum en tijd is het moment waarop via de API Econobis wordt gevuld. De velden interessedatum, inschrijvingsdatum en toewijzingsdatum zijn geen aparte velden in de API. deelname_mutatie_ingangs_datum wordt gevuld met verwerkingsdatum. Deze datum wordt gebruikt voor interessedatum, inschrijvingsdatum, toewijzingsdatum en ingangsdatum (bij definitief) en soort datum is dus afhankelijk van de status die is meegegeven. mutatie_datum wordt gevuld met verwerkingsdatum en tijd aanmaak_datum wordt gevuld met verwerkingsdatum en tijd. De deelname_mutatie_betaal_datum is wel een apart veld. Als de deelname_mutatie_betaal_datum niet vanuit de Api wordt gevuld dan wordt als betaal_datum de verwerkingsdatum genomen. Bij alle typen projecten zal indien er geen deelname mutatie ingangsdatum is meegegeven, de datum van vandaag gebruikt worden. Intake velden Een intake wordt alleen aangemaakt als er ook een adres wordt meegegeven. Indien gewenst kan er naast de Intake ook gelijk een Kans worden aangemaakt. Intake_interesses zijn de categorieën waar de intake_maatregelen toe behoren. Bijvoorbeeld de categorie Gevelisolatie heeft de maatregelen “Spouwmuurisolatie” en “Gevel isolatie binnenzijde”. Als er een intake_maatregel wordt meegegeven dan wordt er naast de Intake ook een kans aangemaakt. De Intake_interesse moet dan niet worden meegegeven. Indien "intake_maatregel_ids" (meervoud, gescheiden door komma’s) meegegeven dan: => Kans voor elke intake maatregel specifiek met: - Maatregel categorie (gekoppelde categorie bij maatregel specifiek) - Status Actief Indien "intake_maatregel_id" (enkelvoud) meegegeven en indien intakestatus = 'Afgesloten met kans' is meegegeven: => Kans voor maatregel specifiek (meegegeven "intake_maatregel_id" dus) met: - Maatregel categorie (gekoppelde categorie bij maatregel specifiek) - Status Actief Als er een intake_maatregel wordt meegeven dan worden eventuele Workflows op de Intake binnen Econobis niet geactiveerd. Veld Type veld Validatie Default intake_campagne_id ID van campagne Moet geldig ID zijn als deze is meegegeven Verplicht intake_motivatie_ids Keuzelijst motivatie (meerdere opties komma gescheiden) Ongeldige opties worden genegeerd intake_aanmeldingsbron_ids Keuzelijst aanmeldingsbron (meerdere opties komma gescheiden) Ongeldige opties worden genegeerd intake_interesse_ids Keuzelijst interesse (meerdere opties komma gescheiden) Ongeldige opties worden genegeerd intake_maatregel_id Bij deze optie wordt geen kans aangemaakt bij maatregel_ids wel intake_maatregel_ids Keuzelijst maatregel (meerdere opties komma gescheiden) Hier wordt gelijk een Kans mee gemaakt intake_status_id Keuzelijst intake status Moet geldig ID zijn als deze is meegegeven Open intake_opmerkingen_bewoner Vrije tekst intake_id Encrypted nr Let op: dit moet een encrypted id zijn, deze kan je via mergevelden genereren intake_kans_bijlage URL (directe URL naar het bestand) Alleen PDF, png en jpeg bestanden Het bestand wordt aan de intake gekoppeld en is ook te zien bij kans intake_kans_bijlage2 URL Alleen PDF, png en jpeg bestanden intake_kans_bijlage3 URL Alleen PDF, png en jpeg bestanden intake_id_extern Dit nr kan gebruikt worden om meerdere aparte api verzoeken voor een contact binnen de zelfde intake te laten aanmaken Kans velden Veld Type veld Validatie Default kans_id Encrypted nr Let op: dit moet een encrypted id zijn, deze kan je via mergevelden genereren kans_code numeriek Kans_code kan ook in een email als samenvoegveld gebruikt worden in een email binnen een kans/kansactie in econobis Campagnes Deze waarden zijn per coöperatie verschillend. De ID staat in de Url van de campagne in Econobis. Zie voorbeeld bij productie project hoe je het ID verkrijgt. Kansactie velden Veld Type veld Validatie Default kansactie_id Encrypted nr Let op: dit moet een encrypted id zijn, deze kan je via mergevelden/samenvoegvelden genereren kansactie_update_afspraak_status Keuzelijst kansacties afspraak status Als alleen deze waarde wordt meegegeven kijkt econobis naar de laatste afspraak (kansactie) van dit contact en wijzigt hier de status kansactie_aanmaken Keuzelijst Kansactie type kansactie_org_of_coach contact id van coach of organisatie kansactie_omschrijving Vrije tekst kansactie_status keuzelijst kansactie status Zie keuzelijst kansactie status kansactie_datum_afspraak yyyy-mm-dd hh:mm kansactie_opmerking_coach Vrije tekst kansactie_opmerking_projectleider Vrije tekst kansactie_opmerking_bewoner Vrije tekst kansactie_opmerking_externe_partij Vrije tekst kansactie_budgetaanvraag_bedrag numeriek kansactie_budgetaanvraag_kosten_aanpassing numeriek kansactie_update_afspraak_campagne ID Campagne Heeft effect op kansactie_update_afspraak_status, zal nu de status laatste afspraak van dit contact specifiek op deze campagne updaten kansactie_update_afspraak_coach Contact ID van Coach Heeft effect op kansactie_update_afspraak_status, zal nu de status laatste afspraak van dit contact specifiek voor deze Coach updaten kansactie_bijlage Pdf jpg of png directe link naar bestand als waarde Pdf jpg of png directe link naar bestand als waarde kansactie_bijlage2 kansactie_bijlage3 kansactie_datum_afspraakpoging_1 datum yyyy-mm-dd kansactie_datum_afspraakpoging_2 kansactie_datum_afspraakpoging_3 kansactie_datum_afgehandeld Datum (tijd optioneel) yyyy-mm-dd hh:mm Refereert in een kansactie aan “Afspraak afgerond” kansactie_datum_uitgebracht kansactie_datum_akkoord_bewoner kansactie_datum_akkoord_projectleider kansactie_datum_akkoord_toekenning kansactie_datum_toekenning_in_behandeling kansactie_datum_uitgevoerd kansactie_bedrag_toekenning numeriek 0,00 of 0 kansactie_datum_vaststelling_in_behandeling kansactie_datum_akkoord_vaststelling kansactie_bedrag_vaststelling kansactie_afspraak_kalender_id Numeriek Alleen bij kansactie_aanmaken visit (en kansactie_org_of_coach is verplicht en kansactie_datum_afspraak verplicht kansactie_kalender_duratie Numeriek 1 tot 300 Als niet meegegeven wordt standaard aantal minuten van kalender gepakt Alleen bij visit type kansactie kansactie_org_of_coach verplicht en kansactie_datum_afspraak verplicht Duratie wordt naar boven afgerond naar 30 minuten schaal. Dus duratie 1 min wordt 30 min. En 45 min wordt 60 min. Keuzelijst Motivaties ID Waarde 1 Milieu 2 Comfort 3 Besparing Keuzelijst Aanmeldingsbronnen ID Waarde 1 E-mail 2 Website 3 Evenement 4 Telefoon 5 Enquete 6 Energieloket 7 Digitaal energieloket 8 Mobiel Energieloket 9 Bewonersavond Keuzelijst Interesses id Categorie 1 Vloerisolatie 2 Gevelisolatie 3 Dakisolatie 4 Isolatieglas 5 Kierdichting 6 Ventilatie 7 Cv-ketel 8 Warmtepomp 9 Biomassa 10 Warmte afgifte 11 Zonnepanelen 12 Zonneboiler 13 Opslag 14 Overig 15 Domotica 16 Leidingisolatie overig 17 Warm water toestel 18 Energiebespaaradvies 19 Energiebespaarcoaching 20 Energieconciërge Keuzelijst Intake status ID Waarde 1 Open 2 Afgesloten met kans 3 Afgesloten zonder kans 4 In behandeling Keuzelijst kansacties afspraak status ref status default Geen afspraak gemaakt made Afspraak gemaakt done Afspraak uitgevoerd cancelled Afspraak afgezegd not-made Geen afspraak kunnen maken Keuzelijst kansacties types id Kansactie type quotation-request Offerteverzoek visit Bezoek subsidy-request Budgetaanvraag redirection Doorverwijzing Keuzelijst maatregel Maatregel id’s vind je door in econobis in het linkermenu naar energiebesparking > maatregel te gaan dubbelklik op een maatregel en je vind in de URL het ID Woningdossier velden Veld Type veld Validatie Default woondossier_woningtype_id Keuzelijst woningtype woondossier_bouwjaar woondossier_koophuis 1 = ja 0 = nee woondossier_gebruiksoppervlakte Numeriek woondossier_energielabel_id Keuzelijst Energie label woondossier_aantal_bouwlagen Numeriek woondossier_status_energielabel_id 1 = voorlopig 2 = definitief woondossier_monument 1 = ja 0 = nee woondossier_daktype_id Keuzelijst daktypes woondossier_maatregelen_datums_realisatie Komma gescheiden woondossier_koophuis 1 = ja 0 = nee Default =1 woondossier_aantal_bewoners Numeriek woondossier_verbruik_elektriciteit numeriek woondossier_verbruik_gas Numeriek woondossier_Stooktemperatuur Keuzelijst stooktemp Bij ongeldige of lege waarde komt altijd “weet ik niet” als optie woondossier_maatregelen_campagne_id ID van campagne Deze mag je 1 maal meegeven, alle woondossier specificaties (zie hieronder) worden onder deze campagne aangemaakt woondossier_opbrengst_zonnepanelen numeriek Geen letters meegeven, alleen cijfers Als je via de api ook woondossier specificatie velden wilt doorgeven is hier speciale code voor nodig of diepe kennis van Wordpress/webhooks De velden hiervoor zijn woondossier_maatregelen_ids woondossier_maatregelen_type_merken woondossier_maatregelen_antwoorden woondossier_maatregelen_status_ids woondossier_maatregelen_verdieping_ids woondossier_maatregelen_zijde_ids De waarde van de bovenstaande 3 velden moeten komma gescheiden op dezelfde volgorde worden aangeboden, bijvoorbeeld woondossier_maatregelen_ids:161, 127 woondossier_maatregelen_type_merken: Energieschakelaar broadcom, Ledlamp E14 Philips woondossier_maatregelen_antwoorden:1,2 woondossier_maatregelen_status_ids: 1,1 Wij raden aan om contact op te nemen met Support@econobis.nl als je deze velden wilt doorsturen naar woondossier specificaties voor het bij houden van bestellingen/kleine maatregelen bij huisbezoek. In overleg kunnen wij een oplossing op maat doornemen. Keuzelijst maatregel specificatie status ID’s id status 1 Gewenst 2 Wordt gerealiseerd 3 Aanwezig 4 Onbekend 5 Kans gemaakt Keuzelijst verdieping id id verdieping 1 Begane grond 2 Eerste verdieping 3 Tweede verdieping Keuzelijst zijde woning id zijde 1 Voor 2 Achter 3 Links 4 Rechts Keuzelijst Woningtypes id woningtype 1 Vrijstaand 2 Hoekwoning 3 Tussenwoning 4 Appartement 5 Appartement VVE 6 Gehele tussenwoning 7 Beneden woning meerdere verdiepingen 8 2 onder 1 kap 9 onbekend Keuzelijst Energielabels id Energielabel 1 A+++ 2 A++ 3 A+ 4 A 5 B 6 C 7 D 8 E 9 F 10 G 11 Onbekend Daktypes id Daktypes 1 Hellend dak met pannen 2 Hellend dak met bitumen 3 Hellend rietdak 4 Platdak 5 Geen dak Keuzelijst Stooktemperatuur id Daktypes temp-high Hellend dak met pannen temp-50 Hellend dak met bitumen temp-low Hellend rietdak unsure Weet ik niet Keuzelijst Maatregelen Maatregel id’s vind je door in econobis in het linkermenu naar energiebesparking > maatregel te gaan dubbelklik op een maatregel en je vind in de URL het ID Hier onder een moment opname: id Maatregel specifiek Categorie 1 Isolatie van de vloer Vloerisolatie 2 Isolatie van de bodem Vloerisolatie 3 Isolatie van de bodem inclusief leidingisolatie Vloerisolatie 4 Isolatie van de vloer inclusief leidingisolatie Vloerisolatie 5 Leiding isolatie kruipruimte Vloerisolatie 257 Vloerisolatie, meer info nodig Vloerisolatie 6 Spouwmuurisolatie Gevelisolatie 7 Gevel isolatie binnenzijde Gevelisolatie 8 Gevel isolatie buitenzijde Gevelisolatie 258 Muurisolatie, meer info nodig Gevelisolatie 9 Isolatie hellend dak binnen Dakisolatie 10 Isolatie hellend dak, buiten (vervangen dakpannen,... Dakisolatie 11 Isolatie plat dak, buiten (op huidige dakbedekking... Dakisolatie 12 Isolatie plat dak, buiten (vervanging huidige dakb... Dakisolatie 13 Vegetatiedak Dakisolatie 14 Isolatie zoldervloer, bovenop Dakisolatie 15 Isolatie zoldervloer, tussen plafond Dakisolatie 92 Dakisolatie algemeen Dakisolatie 16 Glas-in-lood Isolatieglas 17 Plaatsen isolatieglas, alleen beglazing Isolatieglas 18 Plaatsen isolatieglas, inclusief kozijn Isolatieglas 19 Plaatsen geïsoleerd kozijn met triple glas Isolatieglas 20 Plaatsen achterzetbeglazing Isolatieglas 93 HR++(+) Isolatieglas 121 Isolerende beglazing Isolatieglas 259 HR++ glas + kozijn Isolatieglas 260 HR+++ glas + kozijn Isolatieglas 21 Kierdichting ramen en deuren Kierdichting 22 Kierdichting aansluiting kozijn en muur Kierdichting 23 Kierdichting aansluiting dak en muur Kierdichting 24 Kierdichting aansluiting nok Kierdichting 25 Kierdichting kruipluik, houten vloer Kierdichting 261 Verbeteren kierdichting Kierdichting 284 Besparen door kierdichting Kierdichting 26 Ventilatie roosters Ventilatie 27 Decentrale ventilatie met wtw Ventilatie 28 Gebalanceerde ventilatie met wtw Ventilatie 29 Vraag gestuurde mechanische ventilatie Ventilatie 30 Gelijkstroom ventilatiebox Ventilatie 115 Reinigen systeem Ventilatie 272 Gebalanceerde ventilatie Ventilatie 273 Decentrale mechanische ventilatie Ventilatie 274 Vraaggestuurde ventilatie Ventilatie 293 Ventilatie algemeen Ventilatie 31 Bestaande HR ketel vervangen CV-Ketel 32 HR ketel incl. afgifte systeem nieuw plaatsen CV-Ketel 33 HR ketel nieuw plaatsen CV-Ketel 286 Verbeteren van de verwarmingsinstallatie CV-Ketel 290 Hybride CV-ketel CV-Ketel 34 Hybride (bron lucht) Warmtepomp 35 Volledig (bron lucht) Warmtepomp 36 Volledig (bron bodem) Warmtepomp 37 Volledig (bron ventilatielucht) Warmtepomp 38 Warmtepompboiler (tbv tapwater) Warmtepomp 118 Warmtenet Warmtepomp 275 Hybride warmtepomp met buitenlucht Warmtepomp 276 Hybride warmtepomp met ventilatielucht Warmtepomp 277 Hybride warmtepomp met pvt panelen Warmtepomp 278 Volledige warmtepomp met buitenlucht Warmtepomp 279 Volledige warmtepomp met bodemwarmte Warmtepomp 280 Volledige warmtepomp met pvt panelen Warmtepomp 289 Warmtepomp algemeen Warmtepomp 39 Pelletkachel Biomassa 40 Houtkachel hoogrendement Biomassa 41 Hoog temperatuur convectoren Warmte Afgifte 42 Hoog temperatuur radiatoren Warmte Afgifte 43 Laag temperatuur convectoren Warmte Afgifte 44 Laag temperatuur radiatoren Warmte Afgifte 45 Laag temperatuur vloerverwarming Warmte Afgifte 46 Laag temperatuur wandverwarming Warmte Afgifte 47 Stralingspanelen Warmte Afgifte 48 Thermostaatknoppen Warmte Afgifte 49 Waterzijdig inregelen Warmte Afgifte 50 Luchtverwarming Warmte Afgifte 51 Zone indeling Warmte Afgifte 84 Radiatorfolie Warmte Afgifte 114 Infraroodverwarming Warmte Afgifte 285 Verbeteren van de radiatoren Warmte Afgifte 292 Laag temperatuur verwarming algemeen Warmte Afgifte 52 Zonnepanelen Zonnepanelen 53 PVT Zonneboiler 54 Zonneboiler voor verwarming Zonneboiler 55 Zonneboiler voor warm tapwater Zonneboiler 56 Zonneboiler voor warm tapwater en verwarming Zonneboiler 57 Thermische opslag Opslag 58 Batterij (huis/buurt) Opslag 59 Koppeling elektrische auto Opslag 60 PCM (phase change materials) Opslag 61 Thermische opslag Opslag 62 Thermochemische opslag Opslag 63 Elektrische apparatuur Overig 64 LED verlichting Overig 65 Witgoed Overig 66 Zonwering Overig 94 Deurdrangers Overig 95 Korter douchen Overig 96 Thermostaat graadje lager Overig 97 Bespaarbox Overig 107 Energiebespaartegoed Overig 120 Energiebespaartegoed 100 euro Overig 255 Aanvraag verduurzamingsfonds Overig 256 Overig uit Hoomdossier Overig 282 Energiezuinige apparatuur Overig 283 Energiezuinige installaties Overig 287 Besparen op warm tapwate Overig 288 Algemeen Overig 291 Inductiekookplaat Overig 67 Energiemanagement Domotica 68 Internet aansturing apparatuur Domotica 69 Monitoring Domotica 70 Slimme thermostaat Domotica 71 Standby verbruik beperken Domotica 72 Weersafhankelijke regeling Domotica 116 Energiedisplay Domotica 73 Isolatie van leidingen anders dan in de kruipruimt... Leidingisolatie overig 74 Spaardouche Warm water toestel 75 Douche wtw Warm water toestel 76 Hotfill Warm water toestel 77 Electrische boiler Warm water toestel 78 Recycle douche Warm water toestel 79 Epa-w Energiebespaaradvies 80 Expertadvies Energiebespaaradvies 81 Nul-op-de-meter advies Energiebespaaradvies 91 Webinar zonnepanelen Energiebespaaradvies 100 Webinar isolatie Energiebespaaradvies 101 Isolatieadvies Energiebespaaradvies 105 Informatiebijeenkomst coöperatie Energiebespaaradvies 106 Informatiebijeenkomst gemeente Energiebespaaradvies 109 Webinar hybride warmtepompen Energiebespaaradvies 117 EP-W Energiebespaaradvies 124 Korter douchen Energiebespaaradvies 125 Thermostaat graadje lager Energiebespaaradvies 254 Webinar ventilatie Energiebespaaradvies 295 Ondersteuning subsidieaanvraag Energiebespaaradvies 296 Ondersteuning offertes beoordelen Energiebespaaradvies 82 Keukentafelgesprek Energiebespaarcoaching 83 Warmtescan Energiebespaarcoaching 88 Online Energiebespaarcoaching 89 Adviesgesprek gratis Energiebespaarcoaching 90 Hoomdossier doe-het-zelf Energiebespaarcoaching 98 Energiecoach Energiebespaarcoaching 99 Woonwensencoach Energiebespaarcoaching 102 CV check Energiebespaarcoaching 103 CV check Doe het zelf Energiebespaarcoaching 108 Handleiding Energiebespaarcoaching 110 Spouwmuurcheck Energiebespaarcoaching 111 CO-2 meting Energiebespaarcoaching 112 Earn-E Energiebespaarcoaching 85 Huisbezoek Energieconciërge 86 Online Energieconciërge 87 Voucher Energieconciërge 104 Huisbezoek E-team Energieconciërge 113 Warmtebeeld Energieconciërge 119 Klimaatklusser Energieconciërge 122 Energierekening Energieconciërge 123 Schouw Woningopname 126 LED verlichting Lampen 127 Lamp type 1 Lampen 128 Lamp type 2 Lampen 129 Lamp type 3 Lampen 130 Lamp type 4 Lampen 131 Lamp type 5 Lampen 132 Lamp type 6 Lampen 133 Lamp type 7 Lampen 134 Lamp type 8 Lampen 135 Lamp type 9 Lampen 136 Lamp type 10 Lampen 137 Lamp type 11 Lampen 138 Lamp type 12 Lampen 139 Lamp type 13 Lampen 140 Lamp type 14 Lampen 141 Lamp type 15 Lampen 142 Lamp type 16 Lampen 143 Lamp type 17 Lampen 144 Lamp type 18 Lampen 145 Lamp type 19 Lampen 146 Lamp type 20 Lampen 147 Lamp type 21 Lampen 148 Lamp type 22 Lampen 149 Lamp type 23 Lampen 150 Lamp type 24 Lampen 151 Lamp type 25 Lampen 281 Besparen met verlichting Lampen 152 Radiatorfolie Kleine Maatregel 153 Deurdrangers Kleine Maatregel 154 Bespaarbox Kleine Maatregel 155 Spaardouche Kleine Maatregel 156 Glasfolie Kleine Maatregel 157 Glasfolie type 2 Kleine Maatregel 158 Glasfolie type 3 Kleine Maatregel 159 Glasfolie type 4 Kleine Maatregel 160 Glasfolie type 5 Kleine Maatregel 161 Schakelmateriaal Kleine Maatregel 162 Schakelmateriaal type 2 Kleine Maatregel 163 Schakelmateriaal type 3 Kleine Maatregel 164 Schakelmateriaal type 4 Kleine Maatregel 165 Schakelmateriaal type 5 Kleine Maatregel 166 Kleding Kleine Maatregel 167 Kleding type 2 Kleine Maatregel 168 Kleding type 3 Kleine Maatregel 169 Kleding type 4 Kleine Maatregel 170 Kleding type 5 Kleine Maatregel 171 Ventilatierooster Kleine Maatregel 172 Ventilatierooster type 2 Kleine Maatregel 173 Ventilatierooster type 3 Kleine Maatregel 174 Ventilatierooster type 4 Kleine Maatregel 175 Ventilatierooster type 5 Kleine Maatregel 176 Radiatorventilator Kleine Maatregel 177 Radiatorventilator type 2 Kleine Maatregel 178 Radiatorventilator type 3 Kleine Maatregel 179 Radiatorventilator type 4 Kleine Maatregel 180 Radiatorventilator type 5 Kleine Maatregel 181 Tochtstrip of band Kleine Maatregel 182 Tochtstrip of band type 2 Kleine Maatregel 183 Tochtstrip of band type 3 Kleine Maatregel 184 Tochtstrip of band type 4 Kleine Maatregel 185 Tochtstrip of band type 5 Kleine Maatregel 186 Brievenbusborstel Kleine Maatregel 187 Brievenbusborstel type 2 Kleine Maatregel 188 Brievenbusborstel type 3 Kleine Maatregel 189 Brievenbusborstel type 4 Kleine Maatregel 190 Brievenbusborstel type 5 Kleine Maatregel 191 Gordijnen type 1 Kleine Maatregel 192 Gordijnen type 2 Kleine Maatregel 193 Tape type 1 Kleine Maatregel 194 Tape type 2 Kleine Maatregel 195 Tape type 3 Kleine Maatregel 196 Tape type 4 Kleine Maatregel 197 Tape type 5 Kleine Maatregel 198 Dorpelprofiel type 1 Kleine Maatregel 199 Dorpelprofiel type 2 Kleine Maatregel 200 Dorpelprofiel type 3 Kleine Maatregel 201 Dorpelprofiel type 4 Kleine Maatregel 202 Dorpelprofiel type 5 Kleine Maatregel 203 Doorstroombegrenzer Kleine Maatregel 204 Douchetimer / zandloper Kleine Maatregel 205 Waardebon Kleine Maatregel 206 Waardebon type 2 Kleine Maatregel 207 Waardebon type 3 Kleine Maatregel 208 Waardebon type 4 Kleine Maatregel 209 Waardebon type 5 Kleine Maatregel 210 Waardebon type 6 Kleine Maatregel 211 Waardebon type 7 Kleine Maatregel 212 Waardebon type 8 Kleine Maatregel 213 Waardebon type 9 Kleine Maatregel 214 Waardebon type 10 Kleine Maatregel 215 Spaardouche type 2 Kleine Maatregel 216 Spaardouche type 3 Kleine Maatregel 217 Spaardouche type 4 Kleine Maatregel 218 Spaardouche type 5 Kleine Maatregel 219 Schakelmateriaal type 6 Kleine Maatregel 220 Schakelmateriaal type 7 Kleine Maatregel 221 Schakelmateriaal type 8 Kleine Maatregel 222 Schakelmateriaal type 9 Kleine Maatregel 223 Schakelmateriaal type 10 Kleine Maatregel 224 Schakelmateriaal type 6 Kleine Maatregel 225 Schakelmateriaal type 7 Kleine Maatregel 226 Schakelmateriaal type 8 Kleine Maatregel 227 Schakelmateriaal type 9 Kleine Maatregel 228 Schakelmateriaal type 10 Kleine Maatregel 229 Thermometer Kleine Maatregel 230 Thermometer type 2 Kleine Maatregel 231 Thermometer type 3 Kleine Maatregel 232 Thermometer type 4 Kleine Maatregel 233 Thermometer type 5 Kleine Maatregel 234 Deursluiters Kleine Maatregel 235 Deursluiters type 2 Kleine Maatregel 236 Deursluiters type 3 Kleine Maatregel 237 Deursluiters type 4 Kleine Maatregel 238 Deursluiters type 5 Kleine Maatregel 239 Buisisolatie Kleine Maatregel 240 Buisisolatie type 2 Kleine Maatregel 241 Buisisolatie type 3 Kleine Maatregel 242 Buisisolatie type 4 Kleine Maatregel 243 Buisisolatie type 5 Kleine Maatregel 244 Buisisolatie type 6 Kleine Maatregel 245 Buisisolatie type 7 Kleine Maatregel 246 Buisisolatie type 8 Kleine Maatregel 247 Buisisolatie type 9 Kleine Maatregel 248 Buisisolatie type 10 Kleine Maatregel 249 Thermostaat Kleine Maatregel 250 Thermostaat type 2 Kleine Maatregel 251 Thermostaat type 3 Kleine Maatregel 252 Thermostaat type 4 Kleine Maatregel 253 Thermostaat type 5 Kleine Maatregel 262 Voegwerk repareren Onderhoud 263 Metselwerk reinigen Onderhoud 264 Gevelimpregnatie Onderhoud 265 Gevelschilderwerk (stuc- of metselwerk) Onderhoud 266 Gevelschilderwerk (hout) Onderhoud 267 Dakpannen vervangen Onderhoud 268 Dakbedekking vervangen Onderhoud 269 Dakreparatie Onderhoud 270 Zinkwerk schuin dak Onderhoud 271 Zinkwerk plat dak Onderhoud 294 Elektrische deelauto Mobiliteit Order velden Let op: het webformulier moet het recht Kan orders aanmaken hebben, anders worden onderstaande velden niet verwerkt. Zie het hoofdstuk Koppeling registreren in Econobis, paragraaf Deelnames en orders toestaan. Veld Type veld Validatie Default order_product_id ID van product Bij geen geldige waarde wordt order aanmaken overgeslagen order_aantal Getal Bij geen geldig getal, default naar 1 order_variabele_prijs Getal 2 cijfers achter komma Alleen meegeven bij producten die een variabele prijs heeft 0,00 indien product variabele prijs heeft order_betaalwijze_id Keuzelijst Betaalwijze Bij geen geldig id wordt betaalwijze van product toegepast order_status_id Keuzelijst order status Bij geen geldig id wordt default toegepast concept order_begindatum Datum (YYYY-MM-DD) Bij geen geldige of lege datum wordt default toegepast Datum van vandaag order_aanvraagdatum Datum (YYYY-MM-DD) Moet geldige datum zijn als deze is meegegeven Leeg order_nota_frequentie_id Keuzelijst Order Frequentie Bij geen geldig id wordt default toegepast order_volgende_nota_datum Datum (YYYY-MM-DD) Bij geen geldige of lege datum wordt default toegepast Datum van vandaag order_eerste_notadatum_start_op Datum (YYYY-MM-DD) Dit is de datum die getoond wordt op een order al periode dus bij een jaarlijkse order van lidmaatschap als je hier 2025-01-01 mee stuurt is de periode van 1 januari 2025 tot 31 december 2025 order_betreft Tekst order_opmerking Tekst Product Deze waarden zijn per coöperatie verschillend. De ID staat in de Url van het product in Econobis. Zie voorbeeld bij Project hoe je de ID verkrijgt. Keuzelijst Betaalwijze ID Waarde collection Incasso transfer Overboeken Keuzelijst Order status ID Waarde concept Concept active Actief closed Beëindigd Keuzelijst Order frequentie ID Waarde once Eenmalig monthly Maandelijks quarterly Per kwartaal half-year Per half jaar yearly Per jaar Taak velden Veld Type veld Validatie Default taak_opmerkingen Vrije tekst Dit veld wordt in de taak opgenomen taak_einddatum Datum (YYYY-MM-DD) Bij geen geldige of lege datum wordt default toegepast Datum van vandaag taak_afgehandeld Getal 1 = ja 0 = nee verantwoordelijke_gebruiker_id Getal Moet geldige waarde van ID van gebruiker zijn Indien niet ingevuld dan wordt de verantwoordelijke gebruiker die op het webformulier in Econobis gebruikt verantwoordelijke_team_id Getal Moet geldige waarde van ID van team zijn Indien niet ingevuld dan wordt de verantwoordelijke gebruiker die op het webformulier in Econobis gebruikt taak_dagen_einddatum Getal De waarde wordt bij huidige datum opgeteld. Dat wordt de einddatum taak_type_id Keuzelijst Taak types (maar één optie mogelijkheid ) Ongeldige opties worden genegeerd taak_campagne_id Getal Moet geldige waarde van ID van campagne zijn taak_aantal Vrije tekst taak_advies Vrije tekst taak_conceptovereenkomst Vrije tekst taak_lid Vrije tekst taak_bedrijf Vrije tekst taak_naam_bedrijf Vrije tekst taak_energiemaatschappij Vrije tekst taak_akkoord Vrije tekst taak_later_bellen Vrije tekst taak_lid_worden Vrije tekst taak_overstappen Vrije tekst taak_jeugdlid Vrije tekst taak_wettelijk_vertegenwoordiger_naam Vrije tekst taak_wettelijk_vertegenwoordiger_telefoonnummer Vrije tekst taak_wettelijk_vertegenwoordiger_emailadres Vrije tekst taak_tijdstip_bellen Vrije tekst taak_jaarverbruik_kwh Vrije tekst taak_bestemd_voor Vrije tekst taak_wil_voorinschrijven Vrije tekst taak_wil_informatie_energiebesparing Vrije tekst taak_aantal_panelen Vrije tekst taak_verzendwijze Vrije tekst Keuzelijst taak types id Waarde 1 Bellen 2 E-mail 3 Offerte maken 4 Contactmoment 5 Overige 6 Webformulier 7 Intern overleg 9 Aanmelding 10 Advies Gesprek 11 Nota maken 12 Informatie toesturen 13 Bezoek 14 Overstap energie leverancier 15 Controleer contactgegevens 16 Hoomdossier quickscan 17 Adreswijziging deelnemer 18 Nazorg 19 Subsidieaanvraag Gas en Electra verbruik/aanbieding Deze gegevens kunnen op dit moment alleen via de API naar Econobis worden verzonden en via een Download bij contacten worden opgehaald. Om deze download knoppen zichtbaar te maken kan je bij instellingen > cooperatie > “Gebruik export energieverbruik tarieven en verbruik” aanzetten Indien verbruik reeds voorkomt bij adres met zelfde begin/einddatum voor elektriciteit/gas, dan zullen bestaande elektriciteit/gas gegevens worden bijgewerkt. Zoniet, dan zal er gecontroleerd worden of begin/einddatum periode voor elektriciteit/gas overlapt met een andere begin/einddatum periode voor electriciteit bij betreffende adres. Bij overlap zal er niets worden verwerkt. Bij geen overlap zullen gegevens nieuw toegevoegd worden. Gas Veld Type veld Validatie Default verbruik_gas_begindatum Datum (YYYY-MM-DD) Verplicht veld voor gas verbruik_gas_einddatum Datum (YYYY-MM-DD) Verplicht veld voor gas verbruik_gas_verbruik_m3 Getal, geen decimalen verbruik_gas_voorgesteld_tarief_vast Getal tot max 2 decimalen Mag als geheel getal of met komma geschieden verbruik_gas_voorgesteld_tarief_variabel Getal tot max 2 decimalen Mag als geheel getal of met komma geschieden verbruik_gas_variabele_kosten Getal tot max 2 decimalen Mag als geheel getal of met komma geschieden verbruik_gas_vaste_kosten Getal tot max 2 decimalen Mag als geheel getal of met komma geschieden Electra Veld Type veld Validatie Default verbruik_electriciteit_begindatum Datum (YYYY-MM-DD) Verplicht veld voor electra verbruik_electriciteit_einddatum Datum (YYYY-MM-DD) Verplicht veld voor electra verbruik_electriciteit_verbruik_hoog Getal, geen decimalen verbruik_electriciteit_verbruik_laag Getal, geen decimalen verbruik_electriciteit_terug_hoog Getal, geen decimalen verbruik_electriciteit_terug_laag Getal, geen decimalen verbruik_electriciteit_voorgesteld_tarief_variabel_hoog Getal tot max 2 decimalen Mag als geheel getal of met komma geschieden verbruik_electriciteit_voorgesteld_tarief_vast_hoog Getal tot max 2 decimalen Mag als geheel getal of met komma geschieden verbruik_electriciteit_voorgesteld_tarief_vast_laag Getal tot max 2 decimalen Mag als geheel getal of met komma geschieden verbruik_electriciteit_voorgesteld_tarief_variabel_laag Getal tot max 2 decimalen Mag als geheel getal of met komma geschieden verbruik_electriciteit_variabele_kosten_hoog Getal tot max 2 decimalen Mag als geheel getal of met komma geschieden verbruik_electriciteit_variabele_kosten_laag Getal tot max 2 decimalen Mag als geheel getal of met komma geschieden verbruik_electriciteit_vaste_kosten_hoog Getal tot max 2 decimalen Mag als geheel getal of met komma geschieden verbruik_electriciteit_vaste_kosten_laag Getal tot max 2 decimalen Mag als geheel getal of met komma geschieden Vrije velden Om de vrije velden in Econobis te vullen moet je bij Instellingen -> Vrije velden bij het vrije veld dat je via webformulieren wil laten vullen het veld “Wijzig veldnaam webformulier” invullen. De naam mag alleen kleine letters, cijfers of een underscore bevatten. Bijvoorbeeld aantal_panelen. Als dit veld op het onderdeel adressen is dan wordt de webformulier veldnaam automatisch adres_aantal_panelen. De door Econobis aangemaakte veldnaam kan je in jouw webformulier opnemen. Let er op dat alleen valide waardes geaccepteerd worden. De waarde van een vrij veld van het type Integer mag geen tekst bevatten. (Dus bij vrije velden met type numeriek alleen nummers mee sturen of vrije velden met masker aa99aa alleen 2 letters 2 cijfers 2 letters) In onderstaand voorbeeld mag je dus via waarde adres_kleur_voordeur via de api de waarde rood meesturen. Als op een later moment voor ditzelfde contact bij adres_kleur_voordeur de waarde zwart wordt meegegeven zal de waarde rood worden overschreven. Voor vrije velden op adres niveau update hij bij een contact het vrije veld van het primaire adres. Ontdubbelen koppelen aan reeds bestaand contact Als er de gegevens van een formulier word ingeschoten in Econobis dan wordt er gecontroleerd of het contact reeds aanwezig is. Om te controleren of een contact al in Econobis voorkomt wordt het onderstaande schema gebruikt: Is het adres identiek? (adres = postcode, huisnummer, huisnummer toevoeging) Nee Ja Is het mailadres identiek? Het adres is identiek of leeg. Is het mailadres identiek? Nee Ja Nee Ja Nieuw contact in Econobis Koppelen aan contact met laagste ID en Taak aanmaken dat contact gecontroleerd moet worden Is de eerste letter van de voornaam  identiek en is achternaam in Econobis 100% identiek*? Is de eerste letter van de voornaam  identiek of een van beide leeg? en is achternaam in Econobis 100% identiek*? Nee (ander contact) Ja Nee Ja Nieuw contact aanmaken plus Taak Econobis -> uitzoeken of er een nieuwe contactpersoon nodig is (evt met verbinding 'huisgenoot') Match, Email adres aan contact toevoegen Koppelen aan contact plus Taak Econobis -> uitzoeken of er een nieuwe contactpersoon nodig is (evt met verbinding 'huisgenoot') Match met contactpersoon in Econobis, niets meer aan doen ;-) Nieuw contact Adres en taak koppelen Nieuw contact + taak Taak aanmaken email plus naam controleren Taak aanmaken naam controleren Taak aanmaken naam controleren *Achternaam Jansen en Achternaam Jansen – Berkenhof is niet identiek als dubbele achternaam in 1 veld is ingevoerd via API *Bijvoorbeeld : Tussenvoegsel moet als apart veld gedefinieerd worden in api. (achternaam van Vliet is niet hetzelfde als “Vliet”) Voorbeeldinstellingen Voorbeeld instellingen Gravity forms Voorbeeld formulier contact form 7 [text* voornaam placeholder "Voornaam"]   [text tussenvoegsel placeholder "Tussenvoegsel"] [text* achternaam  placeholder "Achternaam" ]   [text adres_straat placeholder "Adres"]   [number adres_huisnummer placeholder "Huisnummer"]   [text adres_toevoeging placeholder "Huisnummer toevoeging" ] [text adres_postcode placeholder "Postcode" ] [text* adres_plaats placeholder "Woonplaats" ] [email* emailadres placeholder "E-mail" ] [text telefoonnummer placeholder "Telefoon" ] [textarea intake_opmerkingen_bewoner placeholder "Extra informatie en/of vragen:"] [checkbox* checkbox-949 use_label_element "Ik stem in met het privacybeleid"] privacybeleid  [hidden de /privacybeleid/ vervangen door link naar jullie privacybeleid deze regel kan je weghalen] [radio woondossier_koophuis "Koophuis|1" "Huurhuis|0"] [radio contact_groep_ids "nieuwsbrief ontvangen|290" "geen nieuwsbrief gewenst|0"] [hidden 290 vervangen door het ID van de statische groep die bij jullie de "nieuwsbrief" groep is in econobis. Je kan het ID vinden door de groep te openen en in je internet adresbalk te kijken. deze regel kan je weghalen]  [hidden intake_campagne_id "7"] [hidden het cijfer 7 bij intake campagne id vervangen door het ID van de campagne waarin de intake moet worden aangemaakt deze vind je in de adresbalk bij energiebesparing de campagne te openen in het menu in econobis. deze regel kan je weghalen] [hidden intake_interesse_ids "20"] [hidden intake_maatregel_ids "85"] [hidden intake_status_id 1] [hidden akkoord_privacybeleid "1"] De "het" en "de" in dit voorbeeld doen niets (deze zijn uitleg in de code die was toegevoegd). Toelichting In bovenstaande voorbeeld wordt de nieuwsbrief radio knop gebruikt om aan groep 290 of groep 0 (geen groep) te koppelen. uiteraard kan je ook gewoon een [hidden contact_groep_ids "85"] meegeven i.p.v. dit aan een multiple choice keuze (meerdere groepen) te hangen. Houd er rekening mee dat je contact_groep_ids maar 1 maal mag meegeven in Contact Form 7 en als je meer groepen wil toevoegen dit met komma moet worden aangegeven, dus bijvoorbeeld [hidden contact_groep_ids "85,86"] Er is ook nog een API verzoek mogelijk voor groep toevoegen op basis van de naam van de groep met de code [contact_groep], die zou je eventueel kunnen gebruiken om nog aan 1 andere groep toe te voegen. De naam van de groep in de instellingen van het formulier moet dan identiek zijn aan de naam van de groep in Econobis.