Eisen aan het XML-bestand met verkoopstaffeltabellen

Met deze optie kunnen nieuwe verkoopstaffeltabellen worden toegevoegd en bestaande gewijzigd.

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

 

Bij het maken van het inleesbestand dient rekening gehouden te worden met de volgende punten:

Elke verkoopstaffeltabel bestaat uit twee onderdelen: de kopgegevens en één of meer staffels.

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_STAFFELTABELLEN

Veldnaam Omschrijving Mogelijke inhoud Belangrijk

<KING_STAFFELTABELLEN>

Geeft begin en eind aan van het King-inleesbestand met staffeltabellen

Eenmaal <STAFFELTABELLEN >

Verplicht

STAFFELTABELLEN

Veldnaam Omschrijving Mogelijke inhoud Belangrijk

<STAFFELTABELLEN>

Geeft begin en eind aan van de staffeltabellen in het King-inleesbestand

Een of meer keren <STAFFELTABEL >

Verplicht

STAFFELTABEL

Veldnaam Omschrijving Mogelijke inhoud Belangrijk

<STAFFELTABEL>

Geeft per staffeltabel het begin en het eind aan van de in te lezen gegevens

Eenmaal <STAFFELTABELKOP>

Eenmaal <STAFFELTABELREGELS>

Verplicht

STAFFELTABELKOP

Veldnaam Omschrijving Mogelijke inhoud Belangrijk

<STAFFELTABELKOP>

Kopgegevens van de staffeltabel

Zie hierna, bij Velden van de kop van de verkoopstaffeltabel

Verplicht

Velden van de kop van de verkoopstaffeltabel

Veldnaam Omschrijving Mogelijke invoer Belangrijk
<STK_CODE> Code Max. 10 posities Verplicht
<STK_OMSCHRIJVING> Omschrijving Max. 40 posities  
<STK_KORTINGSOORT> Korting soort BEDRAG of PERCENTAGE (hoofdletters!) Een bestaande tabel kan alleen worden gewijzigd van BEDRAG naar PERCENTAGE als de kortingsbedragen van die staffeltabel tussen de -100 en 100 liggen en niet meer dan 2 decimalen hebben

STAFFELTABELREGELS

Veldnaam Omschrijving Mogelijke inhoud Belangrijk

<STAFFELTABELREGELS>

De staffels van de tabel

Een of meer keren <STAFFELTABELREGEL>

Verplicht

STAFFELTABELREGEL

Veldnaam Omschrijving Mogelijke inhoud Belangrijk

<STAFFELTABELREGEL>

De gegevens van een staffel uit de tabel

Zie hierna, bij Velden van de verkoopstaffeltabelregel

Verplicht

Velden van de verkoopstaffeltabelregel 

Veldnaam Omschrijving Mogelijke invoer Belangrijk
<STR_VANAFAANTAL> Vanaf aantal Max. 10 cijfers voor het decimaalteken en 3 decimalen; moet uniek zijn voor deze staffeltabel Verplicht bij een nieuwe tabel. Het ingelezen aantal wordt afgerond op 3 decimalen
<STR_KORTINGSBEDRAG> Kortingsbedrag Max. 10 cijfers voor het decimaalteken en 3 decimalen, eventueel minteken voor het bedrag Alleen ingelezen als de KORTINGSOORT is BEDRAG en in dat geval verplicht. Het ingelezen bedrag wordt afgerond op 3 decimalen.
<STR_KORTINGSPERCENTAGE> Kortingspercentage Percentage tussen -100 en 100, maximaal 2 decimialen Alleen ingelezen als de KORTINGSOORT is PERCENTAGE en in dat geval verplicht. Het ingelezen percentage wordt afgerond op 2 decimalen.
  • Als het bestand geen regel met STR_VANAFAANTAL = 0 heeft, dan wordt die regel bij het inlezen automatisch toegevoegd;
  • De staffeltabelregels van het inleesbestand hoeven niet op volgorde van Vanaf aantal te staan;
  • Als het bestand een of meer staffels bevat en de staffeltabel bestaat al in King, dan worden de staffels van de bestaande tabel verwijderd en krijgt de gewijzigde tabel de staffels uit het inleesbestand.

 

 Voorbeeld van een XML-inleesbestand:

<KING_STAFFELTABELLEN>

<STAFFELTABELLEN>

<STAFFELTABEL>

<STAFFELTABELKOP>

<STK_CODE>541</STK_CODE>

<STK_OMSCHRIJVING>Afgeprijsde boeken</STK_OMSCHRIJVING>

<STK_KORTINGSOORT>PERCENTAGE</STK_KORTINGSOORT>

</STAFFELTABELKOP>

<STAFFELTABELREGELS>

<STAFFELTABELREGEL>

<STR_VANAFAANTAL>0</STR_VANAFAANTAL>

<STR_KORTINGSPERCENTAGE>0</STR_KORTINGSPERCENTAGE>

</STAFFELTABELREGEL>

<STAFFELTABELREGEL>

<STR_VANAFAANTAL>10</STR_VANAFAANTAL>

<STR_KORTINGSPERCENTAGE>5</STR_KORTINGSPERCENTAGE>

</STAFFELTABELREGEL>

<STAFFELTABELREGEL>

<STR_VANAFAANTAL>25</STR_VANAFAANTAL>

<STR_KORTINGSPERCENTAGE>10</STR_KORTINGSPERCENTAGE>

</STAFFELTABELREGEL>

<STAFFELTABELREGEL>

<STR_VANAFAANTAL>100</STR_VANAFAANTAL>

<STR_KORTINGSPERCENTAGE>20</STR_KORTINGSPERCENTAGE>

</STAFFELTABELREGEL>

</STAFFELTABELREGELS>

</STAFFELTABEL>

</STAFFELTABELLEN>

</KING_STAFFELTABELLEN>

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

 

Koppelingspictogram voor conceptenZie ook