Attribuut type: BTW

Owned by Ron Kanters (Unlicensed)
Last updated: Nov 06, 2023 by Roman Haex
3 min read



Inhoudsopgave

Algemeen

Het attribuuttype BTW controleert of de ingegeven waarde een BTW nummer betreft. Afhankelijk van een domein-instelling wordt daarnaast ook via een API-koppeling het ingegeven BTW-nummer gecontroleerd. Bij het opslaan van de entiteit wordt vervolgens direct zichtbaar of het ingegeven BTW-nummer geldig is. Indien de controle via de API-koppeling niet actief dan wordt alleen gecontroleerd of het BTW nummer qua opmaak voldoet aan een BTW-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 'BTW' 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

Veldnaam

Omschrijving

 Voorbeeld

AttribuutID*

Uniek ID voor een attribuut binnen deze entiteit.

Opmerkingen:

  • Zowel letters als cijfers kunnen gebruikt worden.

  • De volgende waarden kunnen niet worden ingegeven in dit veld: id, ID

  • Indien een ID reeds in gebruik is volgt de melding: "ID ... in gebruik"

  • Nadat een attribuut is opgeslagen kan het AttribuutID niet meer gewijzigd worden

 

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*

 BTW


 



Indien op domein-niveau is aangegeven dat de BTW-controle actief is, dan wordt bij het opslaan van een attribuut van het type BTW in de blauwdruk automatisch nog 2 attributen in de betreffende entiteit aangemaakt, dit zijn:

  • BTW controle datum: dit is een attribuut van het type datum. De datum van het uitvoeren van de BTW controle wordt hierin automatisch ingevuld zodra een entiteit (bijvoorbeeld een klant) wordt opgeslagen.

  • BTW check 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:

  1. In aanvraag

  2. Goedgekeurd

  3. Afgekeurd

  4. Aanvraag mislukt

Bij het opslaan van de entiteit wordt de BTW Check status gezet op 'Aanvraag wordt uitgevoerd'. Open vervolgens de entiteit opnieuw, waarna de juiste status gevuld is in het attribuut.



Dit ziet er als volgt uit 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 'BTW' is de BTW controle validator automatisch toegevoegd. Deze validator controleert of het ingegeven nummer een BTW-nummer betreft. Daarnaast kunnen de volgende validators optioneel toegepast worden bij dit attribuuttype:





Zie ook: