Attribuut type: KvK
Inhoudsopgave
Algemeen
Het attribuuttype KvK (Kamer van Koophandel) controleert of de ingegeven waarde een KvK nummer betreft. Afhankelijk van een domein-instelling wordt daarnaast ook via een API-koppeling het ingegeven KvK-nummer gecontroleerd. Bij het opslaan van de entiteit wordt dan direct zichtbaar of het ingegeven KvK-nummer geldig is. Indien de controle via de API-koppeling niet actief dan wordt alleen gecontroleerd of het KvK nummer qua opmaak voldoet aan een KvK-nummer.
Indien de koppeling actief is wordt bij elke controle een bepaald bedrag in rekening gebracht. Het resultaat van elke controle wordt direct in Beeyond weergegeven, nadat de entiteit is opgeslagen. De controle vindt plaats via een webservice: https://companyinfo.nl/webservices.
Velden
Bij het toevoegen van een een attribuut van het type 'KvK' dienen de onderstaande velden ingevuld te worden. De eerste 4 velden betreffen algemene velden die bij elk attribuuttype zichtbaar zijn. Velden gemarkeerd met * zijn verplichte velden.
Veldnaam | Omschrijving | Voorbeeld |
|---|---|---|
AttribuutID* | Uniek ID voor een attribuut binnen deze entiteit. Opmerkingen:
|
|
Naam* | Naam van het veld, zoals dit ook voor de gebruiker zichtbaar zal zijn. Het vlaggetje achter het veld naam geeft de taal van de omschrijving weer. Door op bewerken te klikken kan een naam in een andere taal worden ingegeven. Afhankelijk van de taalinstellilng van de gebruiker wordt dan de betreffende taal weergegeven. |   |
Beschrijving | Hierin kan een korte omschrijving van het attribuut worden weergegeven. Deze omschrijving verschijnt als hint bij het betreffende veld indien een gebruiker de muis over dit veld beweegt. Net als bij het veld 'Naam' kan men dit veld in meerdere talen ingeven. Afhankelijk van de taalinstelling van de medewerker wordt dan de betreffende taal weergegeven. | |
Attribuut type* | KvK |
|
Standaard waarde | Door dit veld aan te vinken zal het betreffende veld bij het aanmaken van een entiteit automatisch zijn aangevinkt. |
Indien op domein-niveau is aangegeven dat de KvK-controle actief is, dan wordt bij het opslaan van een attribuut van het type KvK in de blauwdruk automatisch nog 2 attributen in de betreffende entiteit aangemaakt, dit zijn:
KvK controle datum: dit is een attribuut van het type datum. De datum van het uitvoeren van de KvK controle wordt hierin automatisch ingevuld zodra een entiteit (bijvoorbeeld een klant) wordt opgeslagen.
KvK controle status: in dit attribuut wordt de status van de controle weergegeven. Dit veld kan door de eindgebruiker niet aangepast worden, en wordt dus alleen via de webservice aangepast. De volgende statussen zijn mogelijk:
In aanvraag
Goedgekeurd
Afgekeurd
Aanvraag mislukt
Bij het opslaan van de entiteit wordt de KvK Check status gezet op 'Aanvraag wordt uitgevoerd'. Open vervolgens de entiteit opnieuw, waarna de juiste status gevuld is in het attribuut.
Dit kan er als volgt uit zien in een entiteit:
Let daarnaast op dat de 3 attributen in de entiteitdefinitie allemaal in dezelfde attribuutgroep geplaatst worden. Indien dit niet gebeurd verschijnt bij het opslaan van de entiteit definitie de melding:
"In de attribuutgoep unused_property dient bij BTW/KvK attributen de begeleidende attributen in één attribuutgroep aanwezig te zijn"
Validators
Bij het attribuut type 'KvK' is de KvK controle validator automatisch toegevoegd. Deze validator controleert of het ingegeven nummer een KvK-nummer betreft. Daarnaast kunnen de volgende validators optioneel toegepast worden bij dit attribuuttype:
Zie ook: