Eisen aan het XML-bestand met tarieven

Met de optie XML-koppeling artikelen/tarieven kunnen o.a. nieuwe tarieven worden toegevoegd en bestaande gewijzigd.

Het XML-inleesbestand moet aan onderstaande eisen voldoen, anders kan King het bestand niet (volledig) inlezen!

Zie voor een opbouw het voorbeeld aan het einde van dit document.

XSD-schema

Een XSD-schema, wijzigingen ten opzichte van een vorige versie en de specificaties voor de XML import/export zijn beschikbaar op https://support.kingsoftware.nl/king5-releases/ .

Kies de juiste King5-versie.
Kijk onder de tab 'Aandachtspunten King 5.xx'.
Download: 'Download hier de XSD-schema’s met de XML-importbestanden voor King 5.xx (ZIP-bestand)' .
Je ziet hier ook een *.pdf met de wijzigingen in de XSD-bestanden in deze King-versie ten opzichte van de vorige King-versie.

KING_TARIEVEN

Veldnaam	Omschrijving	Mogelijke inhoud	Belangrijk
<KING_TARIEVEN>	Geeft begin en eind aan van het King-inleesbestand met tarieven	Eenmaal <TARIEVEN >	Verplicht

TARIEVEN

Veldnaam	Omschrijving	Mogelijke inhoud	Belangrijk
<TARIEVEN>	Geeft begin en eind aan van de tarieven in het King-inleesbestand	Een of meer keren <TARIEF >	Verplicht

TARIEF

Veldnaam	Omschrijving	Mogelijke inhoud	Belangrijk
<TARIEF>	Geeft per tarief het begin en het eind aan van de in te lezen gegevens	Zie hierna, bij Velden van het Tarief	Verplicht

Velden van het Tarief

Veldnaam	Omschrijving	Mogelijke invoer	Belangrijk
<TAR_NUMMER>	Tariefcode	Max. 20 posities	Verplicht
<TAR_ZOEKCODE>	Zoekcode	Max. 8 posities
<TAR_OMSCHRIJVING>	Omschrijving (intern)	Max. 40 posities
<TAR_OPBRENGSTGROEP>	Groep	Max. 4 cijfers, moet voorkomen als opbrengstgroep in King	Als het veld ontbreekt, wordt de opbrengstgroep overgenomen uit de Vaste gegevens tarieven
<TAR_BTWCODEVERKOOP>	BTW-code	Max. 3 cijfers, moet voorkomen als BTW-code in King	Als het veld ontbreekt, wordt de BTW-code overgenomen uit de Vaste gegevens tarieven.
<TAR_KORTINGSPERCENTAGE>	Kortingspercentage	Bedrag tussen –100 en 100, max. 2 decimalen	Als het veld ontbreekt, wordt de korting overgenomen uit de Vaste gegevens tarieven.
<TAR_AANTALDECIMALENPRIJZEN>	Aantal decimalen prijzen	0, 1, 2 of 3	Als het veld ontbreekt, wordt het aantal decimalen overgenomen uit de Vaste gegevens tarieven.
<TAR_AANTALDECIMALENAANTALLEN>	Aantal decimalen aantallen	0, 1, 2 of 3	Als het veld ontbreekt, wordt het aantal decimalen overgenomen uit de Vaste gegevens tarieven.
<TAR_KOSTPRIJS>	Kostprijs exclusief BTW	Max. 10 cijfers voor het decimaalteken en max. 3 decimalen	Wordt afgerond op het gekozen AANTAL DECIMALENPRIJZEN. Als het veld ontbreekt en in de Vaste gegevens tarieven gekozen is voor het automatisch berekenen van de kostprijs én de verkoopprijs bekend is, dan wordt de kostprijs berekend.
<TAR_VERKOOPPRIJSEXCLBTW> óf <TAR_VERKOOPPRIJSINCLBTW>	Verkoopprijs exclusief BTW óf inclusief BTW	Max. 9 cijfers voor het decimaalteken en max. 3 decimalen	Wordt afgerond op het gekozen AANTAL DECIMALENPRIJZEN. Als het veld ontbreekt en in de Vaste gegevens tarieven gekozen is voor het automatisch berekenen van de verkoopprijs én de kostprijs bekend is, dan wordt de verkoopprijs berekend.
<TAR_AANTALLEN_BIJHOUDEN>	Aantallen	true of false (hoofd- en/of kleine letters); 1 of 0
<TAR_GEBLOKKEERDVOORVERKOOP>	Geblokkeerd voor verkooporders	true of false (hoofd- en/of kleine letters); 1 of 0
<TAR_KOSTPRIJSWIJZIGENBIJORDERINVOER>	Kostprijs wijzigen bij orderinvoer	true of false (hoofd- en/of kleine letters); 1 of 0	Als het veld ontbreekt, wordt deze waarde overgenomen uit de Vaste gegevens tarieven.
<TAR_TEKSTWIJZIGENBIJORDERINVOER>	Tekst wijzigen bij orderinvoer	true of false (hoofd- en/of kleine letters); 1 of 0	Als het veld ontbreekt, wordt deze waarde overgenomen uit de Vaste gegevens tarieven.
<TAR_BTW_AFSTANDSVERKOPEN>		zie TAR_BTW_LAND
<TAR_WEBTARIEF>	Web-tarief	true of false (hoofd- en/of kleine letters); 1 of 0	Alleen ingelezen met de optie Koppeling met Webwinkel
<TAR_WEBWINKELS>	De webwinkels	Eén of meerdere keren <TAR_WEBWINKEL>	Niet verplicht
<TAR_WEBTONENVANAF>	In webwinkel vanaf	JJJJ-MM-DD	Alleen ingelezen als TAR_WEBTARIEF = true
<TAR_WEBTONENTM>	In webwinkel t/m	JJJJ-MM-DD	Alleen ingelezen als TAR_WEBTARIEF = true
<TAR_TAALOMSCHRIJVINGEN>	Tekst op factuur	Een of meer keren <TAR_TAALOMSCHRIJVING>	Als het veld ontbreekt, wordt de interne omschrijving overgenomen als Tekst op factuur voor de default-taal van de administratie.
<TAR_IS_PROJECT_TARIEF>	Tarief is projecttarief	true of false (hoofd- en/of kleine letters); 1 of 0	Als het veld ontbreekt, is de waarde false. Mag niet op false worden gezet als het tarief voorkomt in een voorcalculatieregel of projectmutatie.
<TAR_PROJECT_GEGEVENS>	Projectgegevens	Zie hierna, bij Velden van de projectgegevens	Alleen ingelezen als TAR_IS_PROJECT_TARIEF = true

TAR_BTW_LAND

Veldnaam	Omschrijving	Mogelijke invoer	Belangrijk
TAR_BTW_LAND		Zie hierna bij velden van TAR btw land

Velden van TAR btw land

Veldnaam	Omschrijving	Mogelijke invoer	Belangrijk
TAR_BTW_LEVERINGVANUIT_EIGENLAND
TAR_BTW_LEVERINGVANUIT_ANDER_EU_LAND
TAR_BTW_LEVERINGVANUIT_LAND_VAN_AANGIFTE
TAR_BTW_LEVERINGVANUIT_NIET_EU_LAND

TAR_WEBWINKEL

Veldnaam	Omschrijving	Mogelijke invoer	Belangrijk
TAR_WEBWINKEL	Een webwinkel	Zie hierna bij velden van TAR webwinkel	Niet verplicht

Velden van TAR webwinkel

Veldnaam	Omschrijving	Mogelijke invoer	Belangrijk
TAR_WEBWINKEL_ID	Webwinkel ID	20 posities, moet voorkomen in de King-administratie	Niet verplicht

TAR_TAALOMSCHRIJVING

Veldnaam	Omschrijving	Mogelijke inhoud	Belangrijk
<TAR_TAALOMSCHRIJVING>	Tekst op factuur in een bepaalde taalcode	Zie hierna, bij Velden van de Tekst op factuur

Velden van de Tekst op factuur

Veldnaam	Omschrijving	Mogelijke invoer	Belangrijk
<TAR_TAALOMSCHRIJVING_TAALCODE>	Taalcode Tekst op factuur	Max. 3 posities, moet voorkomen als taalcode in King
<TAR_TAALOMSCHRIJVING_TEKST>	Tekst op factuur per taalcode

Velden van de Projectgegevens

Veldnaam	Omschrijving	Mogelijke invoer	Belangrijk
<TAR_PROJECT_TARIEFSOORT>	Tarief is	ACT (activiteit) of MACH (overige kosten)	Als het veld ontbreekt, is de waarde ACT
<TAR_PROJECT_EENHEID>	Eenheid	Max. 20 posities	Alleen ingelezen als TARIEFSOORT = MACH; bij een Activiteit is de eenheid altijd "Uren"
<TAR_PROJECT_HEEFT_FACTUUREENHEID>	Uren factureren in andere eenheid	true of false (hoofd- en/of kleine letters); 1 of 0	Alleen ingelezen als TARIEF SOORT = ACT. Mag niet worden gewijzigd als het tarief voorkomt in een voorcalculatieregel of projectmutatie.
<TAR_PROJECT_FACTUUREENHEID>	Afwijkende factuureenheid	Max. 20 posities	Alleen ingelezen als HEEFT_FACTUUREENHEID = true. Niet te wijzigen als het tarief voorkomt in een voorcalculatieregel of project mutatie.
<TAR_PROJECT_FACTUUREENHEIDFACTOR>	Omrekenfactor afwijkende factuureenheid	Bedrag tussen 0,01 en 99,99.	Alleen ingelezen als HEEFT_FACTUUREENHEID = true, als het veld ontbreekt, wordt 1 als factor gebruikt. Niet te wijzigen als het tarief voorkomt in een voorcalculatieregel of projectmutatie.
<TAR_PROJECT_BEREKENVERKOOPPRIJSOBV>	Verkoopprijs o.b.v.	VERKEXCLBTW of DOORBELPERC	Als het veld ontbreekt, wordt gekozen voor VERKEXCLBTW
<TAR_PROJECT_VERKOOPPRIJSEXCLBTW>	Verkoopprijs excl. BTW per factuureenheid	Max. 10 cijfers voor het decimaalteken en max. 3 decimalen	Aantal ingelezen decimalen is afhankelijk van de gekozen AANTALDECIMALENPRIJZEN. Als het veld ontbreekt, wordt de verkoopprijs excl. BTW van het tarief overgenomen
<TAR_PROJECT_DOORBELASTPERCENTAGE>	Doorbelastingspercentage	Minimaal 0, maximaal 10.000	Als het veld ontbreekt, wordt gekozen voor een percentage van 100
<TAR_PROJECT_STANDAARD_GEBRUIKSTOESTEMMING>	Standaardwaarde voor gebruikstoestemming	true of false (hoofd- en/of kleine letters); 1 of 0	Als het veld ontbreekt, is de waarde true
<TAR_PROJECT_GEBLOKKEERDVOORINVOER>	Geblokkeerd voor invoer	true of false (hoofd- en/of kleine letters); 1 of 0	Als het veld ontbreekt, is de waarde false

Voorbeeld van een XML-inleesbestand:

<KING_TARIEVEN>
  <TARIEVEN>
    <TARIEF>
      <TAR_NUMMER>Schoonmaak</TAR_NUMMER>
      <TAR_ZOEKCODE>SCHOON</TAR_ZOEKCODE>
      <TAR_OMSCHRIJVING>Schoonmaakwerkzaamheden</TAR_OMSCHRIJVING>
      <TAR_OPBRENGSTGROEP>50</TAR_OPBRENGSTGROEP>
      <TAR_BTWCODEVERKOOP>1</TAR_BTWCODEVERKOOP>
      <TAR_KORTINGSPERCENTAGE>5</TAR_KORTINGSPERCENTAGE>
      <TAR_AANTALDECIMALENPRIJZEN>2</TAR_AANTALDECIMALENPRIJZEN>
      <TAR_AANTALDECIMALENAANTALLEN>1</TAR_AANTALDECIMALENAANTALLEN>
      <TAR_KOSTPRIJS>10</TAR_KOSTPRIJS>
      <TAR_VERKOOPPRIJSINCLBTW>80</TAR_VERKOOPPRIJSINCLBTW>
      <TAR_AANTALLEN_BIJHOUDEN>true</TAR_AANTALLEN_BIJHOUDEN>
      <TAR_GEBLOKKEERDVOORVERKOOP>false</TAR_GEBLOKKEERDVOORVERKOOP>
      <TAR_WEBTARIEF>true</TAR_WEBTARIEF>
      <TAR_WEBWINKELS>
        <TAR_WEBWINKEL>
            <TAR_WEBWINKEL_ID>Koffie.nl</TAR_WEBWINKEL_ID>
        </TAR_WEBWINKEL>
        <TAR_WEBWINKEL>
            <TAR_WEBWINKEL_ID>Theeshop.nl</TAR_WEBWINKEL_ID>
        </TAR_WEBWINKEL>
      </TAR_WEBWINKELS>
      <TAR_WEBTONENVANAF>2013-01-01</TAR_WEBTONENVANAF>
      <TAR_WEBTONENTM>2014-12-31</TAR_WEBTONENTM>
      <TAR_TAALOMSCHRIJVINGEN>
        <TAR_TAALOMSCHRIJVING>
          <TAR_TAALOMSCHRIJVING_TAALCODE>N</TAR_TAALOMSCHRIJVING_TAALCODE>
          <TAR_TAALOMSCHRIJVING_TEKST>Het pand schoonmaken </TAR_TAALOMSCHRIJVING_TEKST>
        </TAR_TAALOMSCHRIJVING>
        <TAR_TAALOMSCHRIJVING>
          <TAR_TAALOMSCHRIJVING_TAALCODE>E</TAR_TAALOMSCHRIJVING_TAALCODE>
          <TAR_TAALOMSCHRIJVING_TEKST>Cleaning the building</TAR_TAALOMSCHRIJVING_TEKST>
        </TAR_TAALOMSCHRIJVING>
      </TAR_TAALOMSCHRIJVINGEN>
      <TAR_IS_PROJECT_TARIEF>true</TAR_IS_PROJECT_TARIEF>
      <TAR_PROJECT_GEGEVENS>
        <TAR_PROJECT_TARIEFSOORT>ACT</TAR_PROJECT_TARIEFSOORT>
        <TAR_PROJECT_EENHEID>Uren</TAR_PROJECT_EENHEID>
        <TAR_PROJECT_HEEFT_FACTUUREENHEID>false</TAR_PROJECT_HEEFT_FACTUUREENHEID>
        <TAR_PROJECT_FACTUUREENHEID>Uren</TAR_PROJECT_FACTUUREENHEID>
        <TAR_PROJECT_FACTUUREENHEIDFACTOR>1</TAR_PROJECT_FACTUUREENHEIDFACTOR>
        <TAR_PROJECT_BEREKENVERKOOPPRIJSOBV>DOORBELPERC</TAR_PROJECT_BEREKENVERKOOPPRIJSOBV>
        <TAR_PROJECT_VERKOOPPRIJSEXCLBTW>50</TAR_PROJECT_VERKOOPPRIJSEXCLBTW>
        <TAR_PROJECT_DOORBELASTPERCENTAGE>60</TAR_PROJECT_DOORBELASTPERCENTAGE>
        <TAR_PROJECT_STANDAARD_GEBRUIKSTOESTEMMING>1</TAR_PROJECT_STANDAARD_GEBRUIKSTOESTEMMING>
        <TAR_PROJECT_GEBLOKKEERDVOORINVOER>false</TAR_PROJECT_GEBLOKKEERDVOORINVOER>
      </TAR_PROJECT_GEGEVENS>
    </TARIEF>
  </TARIEVEN>
</KING_TARIEVEN>

Kijk voor extra aandachtspunten: Inlezen XML-bestand > Overige aandachtspunten

Zie ook