Eisen aan het XML-bestand met directe leveringen

Met deze optie kan een XML-bestand met directe leveringen in King worden ingelezen.

Het is alleen mogelijk om nieuwe leveringen toe te voegen. Bestaande directe leveringen kunnen met deze inleesmodule dus niet worden 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 directe levering bestaat uit drie onderdelen: de kopgegevens, één of meer leveringsregels en per leveringsregel eventueel één of meer specificatieregels.
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_DIRECTELEVERINGEN

Veldnaam	Omschrijving	Mogelijke inhoud	Belangrijk
<KING_DIRECTELEVERINGEN>	Geeft begin en eind aan van het King-inleesbestand met directe leveringen	Eenmaal <DIRECTELEVERINGEN >	Verplicht

DIRECTELEVERINGEN

Veldnaam	Omschrijving	Mogelijke inhoud	Belangrijk
<DIRECTELEVERINGEN>	Geeft begin en eind aan van de directe leveringen in het King-inleesbestand	Een of meer keren <DIRECTELEVERING >	Verplicht

DIRECTELEVERING

Veldnaam	Omschrijving	Mogelijke inhoud	Belangrijk
<DIRECTELEVERING>	Geeft per directe levering het begin en het eind aan van de in te lezen gegevens	Eenmaal <DIRECTELEVERINGKOP> Eenmaal <DIRECTELEVERINGREGELS>	Verplicht

DIRECTELEVERINGKOP

Veldnaam	Omschrijving	Mogelijke inhoud	Belangrijk
<DIRECTELEVERINGKOP>	Kopgegevens van de directe levering	zie hierna, bij Velden van de Directe-leveringkop	Verplicht

Velden van de Directe-leveringkop

Veldnaam	Omschrijving	Mogelijke invoer	Belangrijk
<DLK_ONTVANGSTNUMMER>	Volgnummer directe levering	Maximaal 10 cijfers, mag nog niet voorkomen in King	Als het veld leeg is, dan wordt het volgnummer gegenereerd overeenkomstig de Vaste gegevens inkopen
<DLK_LEVERANCIERNUMMER>	Nummer leverancier (crediteur)	Maximaal 10 cijfers, moet voorkomen als crediteurnummer in King	Verplicht als de EAN-code van de leverancier niet in het bestand voorkomt
<DLK_LEVERANCIEREANCODE>	EAN-code leverancier	Moet voorkomen als EAN-code bij een crediteuradres	Verplicht als het leveranciernummer niet in het bestand voorkomt
<DLK_ONTVANGSTDATUM>	Ontvangstdatum	JJJJ-MM-DD	Als het veld leeg is, dan wordt de datum ingevuld overeenkomstig de Vaste gegevens inkopen
<DLK_VALUTA>	Valutacode	Maximaal 3 posities, moet voorkomen als valutacode in King	Als het veld leeg is en in de Vaste gegevens inkopen is gekozen voor Ontvangst invoeren tegen vaste verrekenprijs, dan wordt de basisvaluta gekozen en anders de valuta van de leverancier
<DLK_BEDRAG>	Totaalbedrag van de directe levering exclusief BTW	Maximaal 10 cijfers voor het decimaalteken, maximaal 2 decimalen	Niet verplicht
<DLK_BETALINGSCONDITIE>	Betalingsconditie	Maximaal 3 cijfers, moet voorkomen als betalingsconditie in King
<DLK_AANGEMAAKTDOOR>	Code van de gebruiker die de directe levering heeft aangemaakt	Maximaal 40 posities	Als het veld niet is ingevuld, dan wordt de code ingevuld van de gebruiker die het bestand inleest
<DLK_AANGEMAAKTOP>	Datum waarop de directe levering is aangemaakt	JJJJ-MM-DD	Als het veld leeg is, dan wordt de datum ingevuld overeenkomstig de Vaste gegevens inkopen
<DLK_OMSCHRIJVING>	Omschrijving	Maximaal 40 posities	Als het veld leeg is, dan wordt de omschrijving ingevuld overeenkomstig de Vaste gegevens inkopen
<DLK_PAKBONNUMMERLEVERANCIER>	Pakbonnummer leverancier	Maximaal 20 posities
<DLK_OPMERKING>	Opmerking	Onbeperkt
<DLK_FACTUURBOEKINGMAKEN>	Factuurboeking maken ja/nee	true of false, 1 of 0	Als het veld aanwezig is, dan worden tags DLK_INKOOPFACTUURAANMAKEN en DLK_INKOOPFACTUURVERWERKEN genegeerd. Als het veld gevuld is met 1, dan wordt de inkoopfactuur aangemaakt èn geboekt.
<DLK_INKOOPFACTUURAANMAKEN>	De inkoopfactuur wordt aangemaakt o.b.v. de regels van deze directe levering.		Als het veld leeg is, dan wordt het gevuld overeenkomstig de vaste gegevens.
<DLK_INKOOPFACTUURVERWERKEN>	De inkoopfactuur wordt aangemaakt o.b.v. de regels van deze directe levering.		Als het veld gevuld is met 1, dan wordt de aangemaakte inkoopfactuur ook gelijk geboekt. Als het veld leeg is, dan wordt het gevuld overeenkomstig de vaste gegevens.
<DLK_FACTUURNUMMER>	Factuurnummer	Maximaal 40 posities	Komt bij deze leverancier al een openstaande post voor met dit factuurnummer, dan moet de valuta van de directe levering dezelfde zijn als de valuta van de openstaande post. Als het veld leeg is, dan wordt het factuurnummer ingevuld overeenkomstig de Vaste gegevens inkopen. Is dat niet mogelijk, dan moet het factuurnummer in het bestand staan
<DLK_FACTUURDATUM>	Factuurdatum	JJJJ-MM-DD	Als het veld leeg is, dan wordt de factuurdatum ingevuld overeenkomstig de Vaste gegevens inkopen
<DLK_VERVALDATUM>	Vervaldatum factuur	JJJJ-MM-DD	Als het veld leeg is, dan wordt de vervaldatum ingevuld overeenkomstig de Vaste gegevens inkopen
<DLK_BETALINGSKENMERK>	Betalingskenmerk	Maximaal 24 posities	Als het veld leeg is, dan wordt de vervaldatum ingevuld overeenkomstig de Vaste gegevens inkopen

DIRECTELEVERINGREGELS

Veldnaam	Omschrijving	Mogelijke inhoud	Belangrijk
<DIRECTELEVERINGREGELS>	Leveringsregel	Een of meer keren <DIRECTELEVERINGREGEL>	Verplicht

DIRECTELEVERINGREGEL

Veldnaam	Omschrijving	Mogelijke inhoud	Belangrijk
<DIRECTELEVERINGREGEL>	Leveringsregel	zie hierna bij Velden van de Leveringsregel	Verplicht

Velden van de Leveringsregel

Veldnaam	Omschrijving	Mogelijke invoer	Belangrijk
<DLR_SOORT>	Regelsoort	ART of TAR (hoofdletters!)	Als het veld leeg is, wordt gekozen voor ART
<DLR_ARTIKELNUMMER>	Artikelnummer of Tariefcode	Maximaal 20 cijfers, moet voorkomen als artikel of tarief in King	Verplicht, behalve als de EAN-code in het bestand voorkomt of het Artikelnummer leverancier. Als het veld leeg is, wordt het bij het inlezen ingevuld op basis van de EAN-code of het Artikelnummer leverancier.
<DLR_ARTIKELEANCODE>	EAN-code artikel	Maximaal 30 posities	Verplicht, behalve als het artikelnummer in het bestand voorkomt of het Artikelnummer leverancier. Als het veld leeg is, wordt het bij het inlezen ingevuld op basis van het Artikelnummer of het Artikelnummer leverancier.
<DLR_ARTIKELNUMMERLEVERANCIER>	Artikelnummer leverancier	Maximaal 20 cijfers, moet voorkomen in King	Verplicht, behalve als het artikelnummer of de EAN-code in het bestand voorkomen. Als het veld leeg is, wordt het bij het inlezen ingevuld op basis van het Artikelnummer of de EAN-code.
<DLR_BESTELNUMMER>	Volgnummer bestelling	Maximaal 10 cijfers, moet voorkomen in King	Verplicht als het bestelregelnummer in het bestand voorkomt
<DLR_BESTELREGELNUMMER>	Volgnummer bestelregel	Moet voorkomen in King	Als het veld is ingevuld, wordt geprobeerd om de bestellingregel erbij te zoeken. Lukt dat niet, dan kan de directe levering niet worden ingelezen. Is het veld niet ingevuld maar is in de Vaste gegevens inkopen bij Koppelen bestelling gekozen voor Automatisch, dan wordt ook geprobeerd om de bestellingregel erbij te zoeken op basis van de overige gegevens in de leveringsregel.
<DLR_PARTIJNUMMER>	Partijnummer	Maximaal 20 cijfers, moet voorkomen in King	Alleen ingelezen met de optie Partijenregistratie. Verplicht als het artikel een partijartikel is
<DLR_INKOOPEENHEID>	Inkoopeenheid	Moet voorkomen in King bij dit artikel en bij deze leverancier	Alleen ingelezen bij een artikelregel. Als het veld leeg is en er geen bestelregelnummer is ingevuld, dan wordt de voorraadeenheid van het artikel gebruikt. Is het veld leeg maar is het bestelregelnummer ingevuld, dan wordt de voorraadeenheid van de betreffende bestelregel gebruikt. Als de inkoopeenheid onbekend is bij het artikel/leverancier, kan de regel alleen worden ingelezen als het veld DLR_VOORRAADEENHEDENINKOOPEENHEID is ingevuld (de inkoopeenheid wordt dan alleen opgeslagen in de leveringsregel maar niet bij het artikel)
<DLR_VOORRAADEENHEDENININKOOPEENHEID>	Aantal voorraadeenheden per inkoopeenheid	Maximaal 10 cijfers voor het decimaalteken. Aantal decimalen mag niet hoger zijn dan het Aantal decimalen aantallen van het artikel	Alleen ingelezen bij een artikelregel. Verplicht als de Inkoopeenheid niet voorkomt in King bij het artikel/leverancier.
<DLR_AANTALONTVANGEN>	Aantal ontvangen	Maximaal 10 cijfers voor het decimaalteken en maximaal 3 decimalen
<DLR_INKOOPPRIJSPER>	Inkoopprijs per	INKOOPEENHEID of AANTALVOORRAADEENHEDEN (hoofdletters!)	Genegeerd als een koppeling met een bestelling gemaakt kan worden; in dat geval wordt de 'Inkoopprijs per' overgenomen van de bestelregel. Genegeerd als de combinatie van artikel, leverancier en inkoopeenheid in King voorkomt; in dat geval wordt de 'Inkoopprijs per' overgenomen van de inkoopeenheid. Als het veld leeg is en de waarde kan niet aan de bestelling of inkoopeenheid worden ontleend, dan wordt gekozen voor AANTALVOORRAADEENHEDEN.
<DLR_PRIJS>	Prijs	Maximaal 10 cijfers voor het decimaalteken en maximaal 3 decimalen	Is in de Vaste gegevens gekozen voor het invoeren van de ontvangsten tegen de werkelijke inkoopprijs en is het veld leeg, dan wordt de prijsinformatie ontleend aan de bijbehorende bestelregel (eventueel omgerekend naar een andere inkoopeenheid) en als er geen koppeling met een bestelregel is, dan wordt de inkoopprijs van de partij/artikel gebruikt. Is in de Vaste gegevens gekozen voor het invoeren van de ontvangsten tegen de VVP, dan wordt de prijs niet ingelezen en wordt altijd de kostprijs van het artikel overgenomen.
<DLR_KORTINGSBEDRAG> of <DLR_KORTINGSPERCENTAGE>	Korting	Percentage van –100 t/m 100 of Bedrag (max. 10 cijfers voor de punt en 3 decimalen)	Als het veld leeg is, wordt de korting ontleend aan de bijbehorende bestelregel, als die er niet is dan aan de partij, als die er ook niet is dan aan de inkoopeenheid, en anders is de korting 0.
<DLR_BTWCODE>	BTW-code	Maximaal 3 cijfers, moet voorkomen in King	Als het veld leeg is, wordt de BTW-code overgenomen van het artikel of tarief (behalve als het tarief een BTW-code voor Af te dragen BTW heeft)
<DLR_AANTALCORRECTIE>	Aantal correctie	Maximaal 10 cijfers voor het decimaalteken en maximaal 3 decimalen
<DLR_OPMERKING>	Opmerking		Als het veld leeg is, wordt het gevuld overeenkomstig de Vaste gegevens
<DIRECTELEVERINGREGELDETAILS>	Specificatieregels directe levering	Een of meer keren <DIRECTELEVERINGREGELDETAIL>	Niet verplicht

DIRECTELEVERINGREGELDETAIL

Veldnaam	Omschrijving	Mogelijke inhoud	Belangrijk
<DIRECTELEVERINGREGELDETAIL>	Ontvangstregel	Zie hierna bij Velden van de Specificatieregel Directe levering

Velden van de Specificatieregel Directe levering

Veldnaam	Omschrijving	Mogelijke invoer	Belangrijk
<DLRD_SERIENUMMER>	Serienummer	Maximaal 20 posities	Alleen ingelezen als de optie Serienummerregistratie actief is en als het artikel een serienummerartikel is
<DLRD_AANTALONTVANGEN>	Aantal ontvangen	Maximaal 10 cijfers voor het decimaalteken en maximaal 3 decimalen, mag negatief zijn	Bij een serienummer moet het aantal 1 of -1 zijn. Als het veld leeg is, wordt het aantal ingevuld op basis van het aantal ontvangen van de leveringsregel (omgerekend naar de voorraadeenheid, exclusief het correctie-aantal)
<DLRD_AANTALCORRECTIE>	Aantal correctie	Maximaal 10 cijfers voor het decimaalteken en maximaal 3 decimalen, mag negatief zijn	Wordt er definitief minder of meer geleverd dan er is besteld, dan kun je de bestelregel toch op 'volledig ontvangen' zetten door het verschil vast te leggen als Aantal correctie
<DLRD_ORDERNUMMER>	Ordernummer	Maximaal 10 cijfers, moet voorkomen in King	Als de leveringsregel gekoppeld is aan een bestelling, dan kan via het ordernummer een koppeling worden gemaakt naar een verkooporder.
<DLRD_ORDERREGELNUMMER>	Orderregel	Maximaal 3 cijfers, moet voorkomen in de betreffende verkooporder
<DLRD_BESTELREGELSOORT>	Soort bestelregel	BESTELLING of VERKOOPORDER	Als het veld leeg is, of als DLRD_ORDERNUMMER en DLRD_ORDERREGELNUMMER niet zijn ingevuld, en/of als deze leveringsregel niet is gekoppeld aan een bestelling, dan wordt gekozen voor BESTELLING

Voorbeeldbestand

<KING_DIRECTELEVERINGEN>

<DLK_LEVERANCIERNUMMER>17003230</DLK_LEVERANCIERNUMMER>

<DLK_ONTVANGSTDATUM>2014-09-24</DLK_ONTVANGSTDATUM>

<DLK_VALUTA>Eur</DLK_VALUTA>

<DLK_BEDRAG>0</DLK_BEDRAG>

<DLK_AANGEMAAKTOP>2014-09-24</DLK_AANGEMAAKTOP>

<DLK_AANGEMAAKTDOOR>Gebruik</DLK_AANGEMAAKTDOOR>

<DLK_OMSCHRIJVING>V.O.F. De Eendracht</DLK_OMSCHRIJVING>

<DLK_FACTUURBOEKINGMAKEN>1</DLK_FACTUURBOEKINGMAKEN>

<DLK_FACTUURNUMMER>32</DLK_FACTUURNUMMER>

<DLK_FACTUURDATUM>2014-09-24</DLK_FACTUURDATUM>

<DLK_VERVALDATUM>2014-10-24</DLK_VERVALDATUM>

<DLK_BETALINGSKENMERK>135/32</DLK_BETALINGSKENMERK>

</DIRECTELEVERINGKOP>

<DLR_SOORT>ART</DLR_SOORT>

<DLR_ARTIKELNUMMER>HARDDISK001</DLR_ARTIKELNUMMER>

<DLR_ARTIKELEANCODE>4902520283085</DLR_ARTIKELEANCODE>

<DLR_BESTELNUMMER>15</DLR_BESTELNUMMER>

<DLR_BESTELREGELNUMMER>1</DLR_BESTELREGELNUMMER>

<DLR_INKOOPEENHEID>Stuk</DLR_INKOOPEENHEID>

<DLR_VOORRAADEENHEDENININKOOPEENHEID>1</DLR_VOORRAADEENHEDENININKOOPEENHEID>

<DLR_AANTALONTVANGEN>1</DLR_AANTALONTVANGEN>

<DLR_PRIJS>11.77</DLR_PRIJS>

<DLR_KORTINGSPERCENTAGE>0</DLR_KORTINGSPERCENTAGE>

<DLR_BTWCODE>11</DLR_BTWCODE>

<DLR_AANTALCORRECTIE>0</DLR_AANTALCORRECTIE>

<DLRD_AANTALONTVANGEN>1</DLRD_AANTALONTVANGEN>

<DLRD_AANTALCORRECTIE>0</DLRD_AANTALCORRECTIE>

<DLRD_BESTELREGELSOORT>BESTELLING</DLRD_BESTELREGELSOORT>

</DIRECTELEVERINGREGELDETAIL>

</DIRECTELEVERINGREGELDETAILS>

</DIRECTELEVERINGREGEL>

</DIRECTELEVERINGREGELS>

</DIRECTELEVERING>