Vat (BTW-tarief)
Vat is de stamgegevensentiteit voor BTW-tarieven in Ultimo: elk record bevat een code, omschrijving en het bijbehorende percentage dat op kosten, inkoopdocumenten, facturen en reserveringen wordt toegepast. Zonder correct ingerichte BTW-tarieven kunnen financiële transacties niet worden afgerond en klopt de aansluiting met externe boekhoudsystemen niet. De entiteit wordt breed gerefereerd door 34 andere entiteiten, van Article en PurchaseLine tot ReservationLine en InternalCharge.
Entiteitsnaam: Vat
Databasetabel: Vat
Primaire sleutel: VATID (UltimoString(3))
Contextsbewerken
| Value | Naam | Beschrijving |
|---|---|---|
| 0 | VatContext.None | Standaard |
Statussenbewerken
| Value | Naam | Beschrijving |
|---|---|---|
| -1 | VatStatus.Trash | Trash |
| 0 | VatStatus.None | None |
Belangrijkste propertiesbewerken
De entiteit heeft in totaal 13 properties. Hieronder de belangrijkste; gebruik
lookup_entity("Vat")voor de volledige lijst.
| Property | Type | Kolom | Nullable | Default | Omschrijving |
|---|---|---|---|---|---|
| Id | UltimoString(3) | VATID | Nee | Unieke code voor het BTW-tarief (maximaal 3 tekens), bv. 'H' voor hoog of 'L' voor laag | |
| Description | UltimoString(200) | VATDESCR | Ja | Leesbare omschrijving van het tarief, bv. 'BTW Hoog 21%' | |
| ProviderMutationDate | DateTime? | VATPROVIDERMUTDATE | Ja | Laatste mutatiedatum aangeleverd door de externe data-provider | |
| RecordChangeDate | DateTime? | VATRECCHANGEDATE | Ja | Laatste wijzigingsdatum van het record | |
| RecordCreateDate | DateTime? | VATRECCREATEDATE | Ja | SYSDATETIME | Aanmaakdatum van het record |
| Context | Context | VATCONTEXT | Nee | Context van het BTW-tarief; alleen standaardwaarde 0 (None) wordt gebruikt | |
| DataProvider | UltimoString(50) | VATDATAPROVIDER | Ja | Naam van de externe data-provider die dit tarief aanlevert | |
| ExternalId | UltimoString(50) | VATEXTERNALID | Ja | Identificatie van dit tarief in het externe bronsysteem | |
| ExternalStatus | UltimoString(50) | VATEXTERNALSTATUS | Ja | Status van het tarief in het externe bronsysteem | |
| Percentage | Decimal | VATPERCENTAGE | Nee | Het BTW-percentage als decimaal getal, bv. 21 voor 21% | |
| Status | Status | VATRECSTATUS | Nee | Recordstatus: 0 = actief, -1 = verwijderd (Trash) | |
| TransferNextTime | Boolean | VATTRANSFERNEXTTIME | Nee | 0 | Vlag die aangeeft dat dit record bij de volgende synchronisatie moet worden overgedragen |
Onderliggende / verwijzende entiteiten (1-op-veel)bewerken
De volgende entiteiten verwijzen naar Vat:
| Entiteit | Via property |
|---|---|
| Article | Vat |
| ArticleSite | Vat |
| ContractLine | Vat |
| ContractLineCost | Vat |
| ContractLineCostMutation | Vat |
| ContractLineCostMutationCreateDetail | Vat |
| Customer | Vat |
| DomainSettings | DefaultHoursVat |
| External | Vat |
| InternalCharge | Vat |
| InternalChargeLine | CostVat, Vat |
| InvoiceLine | Vat |
| JobExternal | Vat |
| JobInternalChargeInstallment | Vat |
| JobMaterial | Vat |
| JobPlanPurchaseRequestLine | Vat |
| JobResource | Vat |
| JobTool | Vat |
| JobWeekLabour | Vat |
| PmJobExternal | Vat |
| PmJobMaterial | Vat |
| PmJobPurchaseRequestLine | Vat |
| PmJobResource | Vat |
| PmJobTool | Vat |
| PurchaseAdviceLine | Vat |
| PurchaseLine | Vat |
| PurchaseRequestLine | Vat |
| RentableRealEstateContractLine | Vat |
| RentableRealEstateContractLineCostMutation | Vat |
| ReservableObject | Vat |
| ReservableObjectType | Vat |
| ReservationLine | Vat |
| Tool | Vat |
| WarehouseServeOutline | Vat |
Tips voor consultantsbewerken
- Klein stamgegeven, groot bereik: Vat heeft geen outbound foreign keys maar wordt door 34 entiteiten gerefereerd — van artikelen en inkoopregels tot reserveringen en interne orders. Controleer bij integraties of alle gebruikte codes in het doelsysteem bekend zijn.
- Percentage is leidend: Het veld
Percentage(VATPERCENTAGE) bepaalt de daadwerkelijke berekening; deId-code is slechts een sleutel. Zorg dat het percentage overeenkomt met de actuele belastingwetgeving en stem dit af met de financiële afdeling. - Standaard uren-BTW via DomainSettings:
DomainSettings.DefaultHoursVatverwijst naar dit record en bepaalt het default BTW-tarief voor urenregels op jobs. Vergeet dit veld niet in te stellen bij de initiële configuratie. - Koppeling met Customer: Een klant kan een eigen default BTW-tarief krijgen (
Customer.Vat). Dit is relevant bij organisaties met gemengde BTW-plicht (bv. zorg + commercieel). - Exportvlag TransferNextTime: Bij koppeling met een ERP-systeem (bv. via EDI of import-connector) wordt
TransferNextTimegebruikt om gewijzigde tarieven klaar te zetten voor export. Stel dit in als de interface dat verwacht.
Database Detailsbewerken
De tabel dba.Vat bevat 12 kolommen, 0 eigen trigger(s), 0 externe triggers en 0 foreign keys.
Belangrijke defaultsbewerken
| Kolom | Default |
|---|---|
VatContext |
0 |
VatRecStatus |
0 |
VatPercentage |
0 |
VatRecCreateDate |
sysdatetimeoffset() |
VatTransferNextTime |
0 |
Brondatabewerken
Let op: De wiki-samenvatting hierboven toont een curated subset van properties en praktische consultant-tips. Voor ground truth (exacte kolomnamen, alle properties, defaults, triggers) gebruik de onderstaande tools.
- Entity-definitie —
lookup_entity("Vat")· reference/entities/Vat Alle properties, contexts en statussen. Bron:Entities.xml. - DB-schema —
lookup_table_schema("Vat")· reference/tables/Vat Alle DB-kolommen, triggers, computed columns en defaults. Bron:database-schema.json. - Gerelateerde workflows —
find_workflows("", entity="Vat")Alle Before/After Save events en andere workflow-ActionFields. Bron:workflows.xml.
Zie ookbewerken
- purchase-line - Inkoopregels waarop BTW wordt toegepast
- internal-charge - Interne orders met BTW-toewijzing
- reservation-line - Reserveringsregels met BTW
- article - Artikelen met een standaard BTW-tarief
- customer - Klanten met een eigen default BTW-tarief
- domain-settings - Systeeminstellingen incl. DefaultHoursVat