1 / 17. Schema VatList. Inleiding

Transcriptie

1 Schema VatList Inleiding Het doel van dit document is de beschrijving van het bestandsformaat zoals dit verwacht wordt voor de uitwisseling van XML-bestanden met INTERVAT inzake de indiening van de listing-klanten voor een onderneming (functie LK/LC). Algemene informatie Naam van het schema : VatIntra-1.3.xsd. Versie : 1.3. Datum : Versie INTERVAT : (INTERVAT III). Toepasbaarheid : vanaf 5 februari Wijzigingen : - Wijziging van attribuut Versiontech van 1.2 naar Wijziging van attribuut ControlRef (van 14 numeriek naar 14 chars maximum) - Wijziging van de lengte van de elementen Name (van 32 naar 200 chars), Street (van 24 naar 200 chars) en CityAndZipCode (van 50 naar 200 chars) - In CompanyInfo onder AgentRepr Wijziging van de betekenis van Country naar «Landcode van het adres (ISO alpha-2)» Wijziging van het element VATNum (van 12 naar 14 chars), het BTW-nummer van de vertegenwoordiger tot maximum 14 posities (Landcode ISO 3166 alpha-2) + BTW-nummer. vb : BE ) - In DeclarantList: Wijziging van het element Period (van xs:gyear naar xs:unsignedlong 4 digits) Wijziging van de betekenis van het element Farmer. Toevoegen van de optionele elementen FileAttachment et Comment. In CompanyInfo : Wijziging van de betekenis van Country naar «Landcode van het adres (ISO alpha-2)» In CompanyInfo onder ClientList: Wijziging van de betekenis van Country naar «Landcode van het BTW-nummer (ISO alpha-2) Documentatie : / 17

2 Beschrijving van de algemene struktuur De opgezette boomstruktuur in het schema van het verwachtte XML-document laat toe om een preciese en éénduidige weg naar de verschillende samenstellende elementen te bepalen. In dit document wordt het vinden van de weg in de boomstruktuur vergemakkelijkt door de aanwezigheid van hyperlinks die die het navigeren tussen de elementen en hun samenstellende delen toelaten ; vertrekkende van de root (VatList) tot de kleinste elementen. Het verwachtte XML-bestand is samengesteld uit de volgende elementen: Het bericht wordt ingediend ofwel door de aangever, ofwel door een mandataris Het bericht is van het type VatList root element Voor de aangever bevat het de lijst van zijn klanten. Voor de indiener/mandataris bevat het de identificatie van deze laatste en een lijst van de aangiften van de mandatarissen van de indiener. Het type van een aangifte is DeclarantListType en de naam is DeclarantList. Per aangever bevat het bericht zijn identificatie en de lijst van zijn klanten. De klantenlijst is van het type ClientListType en de naam is ClientList. 2 / 17

3 Boomstruktuur : 3 / 17

4 STRUCTUUR Root Element : VatList Indiening van de jaarlijkse klantenlisting. Volgorde : Referentie : AgentRepr Element : DeclarantList DeclarantListType maxoccurs : unbounded attributegroup Referentie : VatListAttributes 4 / 17

5 Type genest : AgentRepr Dit element bevat de gegevens met betrekking tot een mandataris/indiener. Ingeval de aangever zijn aangifte indient bevat dit element zijn gegevens Volgorde : Element : CompanyInfo CompanyInfoAgent Informatie met betrekking tot de indiener/mandataris. Attribuut : DecNumber xs:unsignedint minexclusive : 0 Aantal aangevers in het bericht (minimum = 1). VatList 5 / 17

6 Type genest : DeclarantListType Informatie met betrekking tot een aangever of een mandataris Volgorde : Element : CompanyInfo CompanyInfoBe Referentie : Period Element : TurnOver xs:long minoccurs : 0 totaldigits : 13 Voor de kleine ondernemingen : bedrag van de omzet in eurocents en getekend. Deze zone wordt niet gegeven als de aangever geen kleine onderneming is. Element : Farmer xs:short minoccurs : 0 liste valeurs : «0» «1» Deze zone wordt niet gegeven als de aangever geen landbouwer is. Deze zone bevat «0» als de aangever landbouwer is en geen jaarlijkse opgave van intracommunautaire leveringen van goederen moet indienen. Deze zone bevat «1» als de aangever landbouwer is en een jaarlijkse opgave van intracommunautaire leveringen van goederen moet indienen. Element : Comment Comment_Type minoccurs : 0 Vrije commentaar. Element : FileAttachment FileAttachment_Type minoccurs : 0 maxoccurs : unbounded Informatie betreffende een bijlage. Element : ClientList ClientListType minoccurs : 0 maxoccurs : unbounded Klant in de opgave. AttributeGroup Reference : DeclarantListAttributes VatList 6 / 17

7 Attribute group : VatListAttributes Lijst van de attributen van het bericht. Attribuut : RecipientId optional waardenlijst : «VAT-ADMIN» Gebruikt voor de terugwaartse compatibiliteit met Edivat. Dit veld is verouderd. Dit attribuut identifieerd de ontvanger van het bericht, zijnde de BTW-Administratie. Indien aanwezig heeft het dus altijd de waarde «VAT-ADMIN». Attribuut : SenderId maxlength : 14 commentaire : Dit attribuut identifieerd de afzender van het bericht. Het BTW-nummer van de afzender wordt gebruikt. De nummers van buitenlandse afzenders worden voorafgegaan door hun landcode (zie CountryList). Voorbeeld : FR + NumTVA. Attribuut : ControlRef maxlength : 14 commentaire : Dit attribuut is een unieke identificatie toegekend door de afzender van het bericht. Het wordt gebruikt als middel voor identificatie en van integriteitsbeveiliging en -verificatie. Voor de belgische afzenders wordt het samengesteld uit de 10 karakters van het ondernemingsnummer aangevuld met een volgnummer voor het bericht bestaande uit 4 posities. Attribuut : MandataireId maxlength : 14 optional Gebruikt voor de terugwaartse compatibiliteit met Edivat. Dit veld is verouderd. Dit attribuut identifieerd de vertegenwoordiger van de onderneming. Het is een reeks van 14 karakters. Attribuut : SenderDate xs:date Datum waarop het bericht opgesteld werd. Volgens het formaat CCYY-MM-DD. Attribuut : VersionTech maxlength : 4 waardenlijst: optional Dit attribuut bevat de versie van de technische bijlage van het XSDschema dat gebruikt werd om de XML te maken. Attribuut : Test 7 / 17

8 liste valeurs : 0 false optional Dit attribuut wordt niet meer gebruikt. VatList 8 / 17

9 Attribute-group : DeclarantListAttributes Commentaar: Liist van de attributen gebruikt voor elke aangever. Attribuut : SequenceNum xs:unsignedint Volgnummer van de aangifte. Attribuut : DeclarantNum xs:nonnegativeinteger totaldigits : 19 format : \d{19} Dit attribuut is een unieke identificatie toegekend door de afzender van de aaangifte. Dit nummer wordt gevormd op basis van het attribuut ControlRef van het element VatList, aangevuld met een volgordenummer van 5 posities, met dus als resultaat een nummer van 19 posities. Attribuut : ClientNbr xs:unsignedint Dit attribuut bevat het aantal klanten in de lijst van de klanten van de aangever. Het wordt gebruikt bij de validatie. Attribuut : TurnOverSum xs:long Dit attribuut totaliseert de omzet van de klanten van de aangever.dit bedrag wordt getekend en wordt gebruikt bij de validatie. Attribuut : TaxSum xs:long Dit attribuut totaliseert de BTW-bedragen van de klanten van de aangever.dit bedrag wordt getekend en wordt gebruikt bij de validatie. DeclarantListType 9 / 17

10 Type genest : ClientListType Lijst van de klanten van een aangever. Volgorde: Element : CompanyInfo CompanyInfoClient Referentie : Referentie : Amount TurnOver Attribuut : SequenceNum xs:unsignedint minexclusive : 0 commentaar: Volgnummer van de klant binnen de klantenlijst van de aangever. DeclarantListType 10 / 17

11 Type genest : CompanyInfoAgent Informatie betreffende de indiener. Volgorde : Element : VATNum maxlength : 14 BTW-identificatie van de indiener volgens europees formaat (landcode twee letters volgens de standaard ISO 3166 alpha-2, gevolgd door de nationale BTW-identificatie ). Referentie : Referentie : Referentie : Name Street CityAndZipCode Element : Country CountryList AgentRepr 11 / 17

12 Type genest : CompanyInfoBe Informatie betreffende de aangever. Volgorde : Element : VATNum xs :unsignedint totaldigits : 10 format : \d{10} BTW-nummer van een belgische onderneming zonder de landcode (standard ISO alpha-2). Referentie : Referentie : Referentie : Name Street CityAndZipCode Element : Country CountryList minoccurs : 0 Landcode van het adres. Momenteel mag dit veld overgeslagen worden. DeclarantListType 12 / 17

13 Type genest : CompanyInfoClient Informatie betreffende een klant van de aangever. Volgorde : Element: name: VATNum type: totaldigits: 10 format: \d{10} BTW-nummer zonder de landcode van een belgische onderneming (standard ISO alpha-2). Element : Country CountryBe minoccurs : 0 ClientListType 13 / 17

14 Type genest : FileAttachment_Type Beschrijving van een bijgevoegd bestand. Volgorde : Element : FileType FileType_Type Type van de bijlage. Element : FileName xs:token Naam van het bestand (naam van het bestand in het zip-bestand dat het bericht en zijn bijlagen omvat). Element : FileDescription minoccurs : 0 Bijkomende informatie over het bestand. DeclarantListType 14 / 17

15 Type : FileType_Type waardenlijst : FileType_Type «application/pdf» «image/jpeg» «image/tiff» FileAttachment_Type 15 / 17

16 Element : Name Name maxlength : 200 Naam van de fysieke persoon of van de onderneming. CompanyInfoAgent CompanyInfoBe Element : Street Street maxlength : 200 Adres (straat, nummer en busnummer) van de fysieke persoon of van de onderneming. CompanyInfoAgent CompanyInfoBe Element : CityAndZipCode CityAndZipCode maxlength : 200 Naam van de plaats en postcode. CompanyInfoAgent CompanyInfoBe Element : Period Period xs:unsignedlong totaldigits : 4 Deze zone bevat het jaar volgens het formaat CCYY DeclarantListType Element: Amount Amount xs:long totaldigits : 13 Deze zone bevat het bedrag van de belasting uitgedrukt in eurocents. Ze moet getekend worden. ClientListType Element : TurnOver TurnOver xs:long totaldigits : 13 Deze zone bevat het bedrag van de omzet uitgedrukt in eurocents. Ze moet getekend worden. 16 / 17

17 ClientListType Element : CountryBe waardenlijst : CountryBe <blanc> «BE» Deze zone bevat de landcode van België, dus : BE. CompanyInfoClient Element : CountryList CountryList maxlength : 2 De landcode van een land van de EEG volgens standaard ISO 3166 alpha-2. Voorbeeld : België = BE. CompanyInfoBe CompanyInfoAgent Element : Comment_Type Comment_Type maxlength : 2000 Vrije commentaar. DeclarantListType 17 / 17