Eisen aan het XML-bestand met partijen

Met de optie XML-koppeling partijen kunnen o.a. nieuwe partijen 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:

Als de kostprijs wordt gewijzigd van een partij met voorraad, dan wordt een journaalpost aangemaakt om de boekwaarde van de voorraad aan te passen. Hiervan wordt melding gemaakt in het verwerkingsverslag;
Elk artikel kan meer partijen bevatten en elke partij meer factuurteksten.
Zie het voorbeeldbestand aan het einde van dit document voor de opbouw die het inleesbestand dient te hebben.

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_PARTIJEN

Veldnaam	Omschrijving	Mogelijke inhoud	Belangrijk
<KING_PARTIJEN>	Geeft begin en eind aan van het King-inleesbestand met partijen	Eenmaal <ARTIKELEN>	Verplicht, moet eenmaal in het bestand voorkomen

ARTIKELEN

Veldnaam	Omschrijving	Mogelijke inhoud	Belangrijk
<ARTIKELEN>	Geeft begin en eind aan van de artikelgegevens in het King-inleesbestand met artikelen	Een of meer keren <ARTIKEL>	Verplicht, moet eenmaal in het bestand voorkomen

ARTIKEL

Veldnaam	Omschrijving	Mogelijke inhoud	Belangrijk
<ARTIKEL>	Geeft per artikel het begin en het eind aan van de in te lezen gegevens	Zie hierna, bij Velden van het Artikel	Verplicht, moet per artikel eenmaal in het bestand voorkomen

Velden van het Artikel

Veldnaam	Omschrijving	Mogelijke inhoud	Belangrijk
<ART_NUMMER>	Artikelnummer	Max. 20 tekens, moet bestaan in King	Verplicht, moet per artikel eenmaal in het bestand voorkomen
<PARTIJEN>	Geeft per artikel het begin en het eind aan van de bijbehorende partijen	Een of meer keren <PARTIJ>	Verplicht, moet per artikel eenmaal in het bestand voorkomen

PARTIJ

Veldnaam	Omschrijving	Mogelijke inhoud	Belangrijk
<PARTIJ>	Geeft per partij het begin en het eind aan van de in te lezen gegevens	Zie hierna, bij Velden van de Partij	Verplicht, moet per partij eenmaal in het bestand voorkomen

Velden van de Partij

Veldnaam	Omschrijving	Mogelijke inhoud	Belangrijk
<PARTIJ_NUMMER>	Partijnummer	Max. 20 tekens	Als het veld ontbreekt of leeg is, wordt het partijnummer gegenereerd overeenkomstig de instellingen van het artikel
<PARTIJ_OMSCHRIJVING>	Omschrijving partij	Max. 40 tekens
<PARTIJ_LEVERANCIER>	Leverancier	Max. 10 cijfers, moet bestaan als crediteur in King
<PARTIJ_NUMMER_BIJ_LEVERANCIER>	Partijnummer bij leverancier	Max. 20 tekens
<PARTIJ_VALUTACODE_INKOOPPRIJS>	Valutacode inkoopprijs	Max. 3 tekens, moet bestaan in King	Als het veld ontbreekt of leeg is, wordt de basis valutacode gebruikt
<PARTIJ_INKOOPPRIJS>	Inkoopprijs	Max. 10 cijfers voor het decimaalteken, max. 3 decimalen
<PARTIJ_KOSTPRIJS>	Kostprijs	Max. 10 cijfers voor het decimaalteken, max. 3 decimalen	Alleen ingelezen als bij het artikel is aangegeven dat er een aparte kostprijs geldt voor de partijen. Als de kostprijs wordt gewijzigd van een partij met voorraad, dan wordt er een journaalpost aangemaakt. Hiervan wordt melding gemaakt in het verwerkingsverslag
<PARTIJ_PRODUCTIEDATUM>	Productiedatum	JJJJ-MM-DD
<PARTIJ_GEBLOKKEERD_VOOR_MAGAZIJNONTVANGST>	Geblokkeerd voor magazijnontvangst	true of false (hoofd- en/of kleine letters); 1 of 0
<PARTIJ_BTWCODE_VERKOOP>	BTW-code verkoop	Max. 3 cijfers, moet bestaan in King	Als het veld ontbreekt of leeg is, wordt de BTW-code verkoop van het artikel gebruikt
<PARTIJ_VERKOOPPRIJS_INCLBTW> of <PARTIJ_VERKOOPPRIJS_EXCLBTW>	Verkoopprijs incl. BTW of excl. BTW	Max. 10 cijfers voor het decimaalteken, max. 3 decimalen	Alleen ingelezen als bij het artikel is aangegeven dat er een aparte verkoopprijs geldt voor de partijen
<PARTIJ_KORTINGSBEDRAG> of <PARTIJ_KORTINGSPERCENTAGE>	Korting als bedrag Korting als percentage	Percentage van -100 tot 100 en max. 2 decimalen of een Bedrag met max. 10 cijfers voor het decimaal teken en max. 3 decimalen	Alleen ingelezen als bij het artikel is aangegeven dat er een aparte verkoopprijs geldt voor de partijen
<PARTIJ_VERKOOP_TOEGESTAAN_VANAF>	Verkoop toegestaan vanaf	JJJJ-MM-DD
<PARTIJ_VERKOOP_TOEGESTAAN_TM>	Verkoop toegestaan t/m	JJJJ-MM-DD	moet na de datum van PARTIJ_VERKOOP_TOEGESTAAN_VANAF vallen (als die is ingevuld)
<PARTIJ_THT_DATUM>	THT-datum	JJJJ-MM-DD
<PARTIJ_GEBLOKKEERD_VOOR_VERKOOP>	Geblokkeerd voor verkoop	true of false (hoofd- en/of kleine letters); 1 of 0
<PARTIJ_CBS_LANDOORSPRONG>	Land van oorsprong	Max. 3 posities, moet voorkomen in de King-administratie
<PARTIJ_OPMERKING>	Opmerking
<PARTIJ_TEKSTWIJZIGEN_BIJ_ORDERINVOER>	Tekst wijzigen bij orderinvoer	true of false (hoofd- en/of kleine letters); 1 of 0
<PARTIJ_FACTUURTEKSTEN>	Geeft begin en eind aan van de bijbehorende factuurteksten	Zie hierna, bij FACTUURTEKST	Alleen ingelezen als bij het artikel is aangegeven dat per partij een Aparte Tekst op factuur moet worden gebruikt

FACTUURTEKST

Veldnaam	Omschrijving	Mogelijke inhoud	Belangrijk
<PARTIJ_FACTUURTEKST>	Geeft begin en eind aan van de factuurtekst	Zie hierna, bij Velden van de factuurtekst

Velden van de Factuurtekst

Veldnaam	Omschrijving	Mogelijke inhoud	Belangrijk
<PARTIJ_FACTUURTEKST_TAALCODE>	Taalcode	Max. 3 posities, moet bestaan in King
<PARTIJ_FACTUURTEKST_TEKST>	Tekst op factuur

PARTIJ_VRIJERUBRIEK

Veldnaam	Omschrijving	Mogelijke inhoud	Belangrijk
<PARTIJ_VRIJERUBRIEK>	Gegevens vrije rubriek	Zie hierna, bij Velden van de Vrije rubrieken partijen	Komt eenmaal voor per partij per vrije rubriek

Velden van de Vrije rubrieken partijen

Veldnaam	Omschrijving	Mogelijke invoer	Belangrijk
<PARTIJ_VRIJERUBRIEK_NAAM>	Naam van de vrije rubriek	Max. 40 tekens, moet bestaan in King
<PARTIJ_VRIJERUBRIEK_WAARDE>	Inhoud van de vrije rubriek	Afhankelijk van het type rubriek.	Als het veld leeg is, wordt het gevuld met de default (indien aanwezig)

Voorbeeld van en XML-bestand

<KING_PARTIJEN>
 <ARTIKELEN>
   <ARTIKEL>
    <ART_NUMMER>COMPUTERKAST001</ART_NUMMER>
     <PARTIJEN>
	<PARTIJ>
	 <PARTIJ_NUMMER>X-25G</PARTIJ_NUMMER>
	 <PARTIJ_OMSCHRIJVING>Test omschrijving</PARTIJ_OMSCHRIJVING>
	 <PARTIJ_LEVERANCIER>1799999999</PARTIJ_LEVERANCIER>
	 <PARTIJ_NUMMER_BIJ_LEVERANCIER>BCD-250G</PARTIJ_NUMMER_BIJ_LEVERANCIER>
	 <PARTIJ_VALUTACODE_INKOOPPRIJS>USD</PARTIJ_VALUTACODE_INKOOPPRIJS>
	 <PARTIJ_INKOOPPRIJS>256.781</PARTIJ_INKOOPPRIJS>
	 <PARTIJ_KOSTPRIJS>568.19</PARTIJ_KOSTPRIJS>
	 <PARTIJ_PRODUCTIEDATUM>1967-08-13</PARTIJ_PRODUCTIEDATUM>
	 <PARTIJ_GEBLOKKEERD_VOOR_MAGAZIJNONTVANGST>1</PARTIJ_GEBLOKKEERD_VOOR_MAGAZIJNONTVANGST>
        <PARTIJ_BTWCODE_VERKOOP>3</PARTIJ_BTWCODE_VERKOOP>
	 <PARTIJ_VERKOOPPRIJS_INCLBTW>123.45</PARTIJ_VERKOOPPRIJS_INCLBTW>
	 <PARTIJ_KORTINGSBEDRAG>5.43</PARTIJ_KORTINGSBEDRAG>
	 <PARTIJ_VERKOOP_TOEGESTAAN_VANAF></PARTIJ_VERKOOP_TOEGESTAAN_VANAF>
	 <PARTIJ_VERKOOP_TOEGESTAAN_TM>2010-05-15</PARTIJ_VERKOOP_TOEGESTAAN_TM>
	 <PARTIJ_THT_DATUM>2010-05-20</PARTIJ_THT_DATUM>
	 <PARTIJ_GEBLOKKEERD_VOOR_VERKOOP>0</PARTIJ_GEBLOKKEERD_VOOR_VERKOOP>
	 <PARTIJ_OPMERKING>String</PARTIJ_OPMERKING>
	 <PARTIJ_TEKSTWIJZIGEN_BIJ_ORDERINVOER>0</PARTIJ_TEKSTWIJZIGEN_BIJ_ORDERINVOER>
	 <PARTIJ_FACTUURTEKSTEN>
	   <PARTIJ_FACTUURTEKST>
		<PARTIJ_FACTUURTEKST_TAALCODE>N</PARTIJ_FACTUURTEKST_TAALCODE>
		<PARTIJ_FACTUURTEKST_TEKST>Factuurtekst partij x</PARTIJ_FACTUURTEKST_TEKST>
	   </PARTIJ_FACTUURTEKST>
	   <PARTIJ_FACTUURTEKST>
		<PARTIJ_FACTUURTEKST_TAALCODE>D</PARTIJ_FACTUURTEKST_TAALCODE>
		<PARTIJ_FACTUURTEKST_TEKST>Factuurtekst partij x</PARTIJ_FACTUURTEKST_TEKST>
	   </PARTIJ_FACTUURTEKST>
	 </PARTIJ_FACTUURTEKSTEN>
	</PARTIJ>
    </PARTIJEN>
   </ARTIKEL>
 </ARTIKELEN>
</KING_PARTIJEN>

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

Zie ook