Eisen aan het XML-bestand met magazijnontvangsten

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

Het is alleen mogelijk om nieuwe magazijnontvangsten toe te voegen. Bestaande ontvangsten 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 dat elke magazijnontvangst uit drie onderdelen bestaat: de kopgegevens, één of meer ontvangstregels en per ontvangstregel eventueel één of meer specificatieregels.

Voor een voorbeeld van de opbouw van het inleesbestand met de magazijnontvangsten,

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_MAGAZIJNONTVANGSTEN

Veldnaam	Omschrijving	Mogelijke inhoud	Belangrijk
<KING_MAGAZIJNONTVANGSTEN>	Geeft begin en eind aan van het King-inleesbestand met magazijnontvangsten	Eenmaal <MAGAZIJNONTVANGSTEN >	Verplicht

MAGAZIJNONTVANGSTEN

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

MAGAZIJNONTVANGST

Veldnaam	Omschrijving	Mogelijke inhoud	Belangrijk
<MAGAZIJNONTVANGST>	Geeft per magazijnontvangst het begin en het eind aan van de in te lezen gegevens	Eenmaal <MAGAZIJNONTVANGSTKOP> Eenmaal <MAGAZIJNONTVANGSTREGELS>	Verplicht

MAGAZIJNONTVANGSTKOP

Veldnaam	Omschrijving	Mogelijke inhoud	Belangrijk
<MAGAZIJNONTVANGSTKOP>	Kopgegevens van de magazijnontvangst	zie hierna, bij Velden van de Magazijnontvangstkop	Verplicht

Velden van de Magazijnontvangstkop

Veldnaam	Omschrijving	Mogelijke invoer	Belangrijk
<MOK_ONTVANGSTNUMMER>	Volgnummer magazijnontvangst	Maximaal 10 cijfers, mag nog niet voorkomen in King	Als het veld leeg is, dan wordt het volgnummer gegenereerd overeenkomstig de Vaste gegevens inkopen
<MOK_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
<MOK_LEVERANCIEREANCODE>	EAN-code leverancier	Moet voorkomen als EAN-code bij een crediteuradres	Verplicht als het leveranciernummer niet in het bestand voorkomt
<MOK_ONTVANGSTDATUM>	Ontvangstdatum	JJJJ-MM-DD	Als het veld leeg is, dan wordt de datum ingevuld overeenkomstig de Vaste gegevens inkopen
<MOK_MAGAZIJNCODE>	Magazijncode	Maximaal 3 cijfers, moet voorkomen als magazijn in King	Verplicht
<MOK_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
<MOK_BEDRAG>	Totaalbedrag van de magazijnontvangst exclusief BTW	Maximaal 10 cijfers voor het decimaalteken, maximaal 2 decimalen	Niet verplicht
<MOK_BETALINGSCONDITIE>	Betalingsconditie	Maximaal 3 cijfers, moet voorkomen als betalingsconditie in King
<MOK_AANGEMAAKTDOOR>	Code van de gebruiker die de ontvangst heeft aangemaakt	Maximaal 40 posities	Als het veld niet is ingevuld, dan wordt de code ingevuld van de gebruiker die het bestand inleest
<MOK_AANGEMAAKTOP>	Datum waarop de ontvangst is aangemaakt	JJJJ-MM-DD	Als het veld leeg is, dan wordt de datum ingevuld overeenkomstig de Vaste gegevens inkopen
<MOK_AANGEMAAKTOP_TIJDSTIP>	Tijdstip waarop de ontvangst is aangemaakt	00:00:00
<MOK_OMSCHRIJVING>	Omschrijving	Maximaal 40 posities	Als het veld leeg is, dan wordt de omschrijving ingevuld overeenkomstig de Vaste gegevens inkopen
<MOK_ONTVANGSTLOCATIE>	Ontvangstlocatie	Maximaal 20 posities	Locatie moet bekend zijn binnen KING. Als het veld leeg is, dan blijft de ontvangstlocatie in de kop ook leeg. Geef je een geblokkeerde locatie mee dan volgt een blokkerende melding tijdens import. Geef je de tag helemaal niet mee dan wordt er gekeken naar de Vaste gegevens Inkopen. Is de in te vullen locatie (volgens de Vaste gegevens inkopen) geblokkeerd dan blijft de Ontvangstlocatie leeg maar is de XML wel te importeren.
<MOK_PAKBONNUMMERLEVERANCIER>	Pakbonnummer leverancier	Maximaal 20 posities
<MOK_OPMERKING>	Opmerking	Onbeperkt
<MOK_FACTUURBOEKINGMAKEN>	Factuurboeking maken ja/nee	true of false, 1 of 0	Als het veld aanwezig is, dan worden tags MOK_INKOOPFACTUURAANMAKEN en MOK_INKOOPFACTUURVERWERKEN genegeerd. Als het veld gevuld is met 1, dan wordt de inkoopfactuur aangemaakt èn geboekt.
<MOK_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.
<MOK_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.
<MOK_FACTUURNUMMER>	Factuurnummer	Maximaal 40 posities	Komt bij deze leverancier al een openstaande post voor met dit factuurnummer, dan moet de valuta van de magazijnontvangst 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
<MOK_FACTUURDATUM>	Factuurdatum	JJJJ-MM-DD	Als het veld leeg is, dan wordt de factuurdatum ingevuld overeenkomstig de Vaste gegevens inkopen
<MOK_VERVALDATUM>	Vervaldatum factuur	JJJJ-MM-DD	Als het veld leeg is, dan wordt de vervaldatum ingevuld overeenkomstig de Vaste gegevens inkopen
<MOK_BETALINGSKENMERK>	Betalingskenmerk	Maximaal 24 posities	Als het veld leeg is, dan wordt de vervaldatum ingevuld overeenkomstig de Vaste gegevens inkopen

MAGAZIJNONTVANGSTREGELS

Veldnaam	Omschrijving	Mogelijke inhoud	Belangrijk
<MAGAZIJNONTVANGSTREGELS>	Ontvangstregel	Een of meer keren <MAGAZIJNONTVANGSTREGEL>	Verplicht

MAGAZIJNONTVANGSTREGEL

Veldnaam	Omschrijving	Mogelijke inhoud	Belangrijk
<MAGAZIJNONTVANGSTREGEL>	Ontvangstregel	zie hierna bij Velden van de Magazijnontvangstregel	Verplicht

Velden van de Magazijnontvangstregel

Veldnaam	Omschrijving	Mogelijke invoer	Belangrijk
<MOR_SOORT>	Regelsoort	ART of TAR (hoofdletters!)	Als het veld leeg is, wordt gekozen voor ART
<MOR_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.
<MOR_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.
<MOR_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.
<MOR_BESTELNUMMER>	Volgnummer bestelling	Maximaal 10 cijfers, moet voorkomen in King	Verplicht als het bestelregelnummer in het bestand voorkomt. Als het bestelnummer in het bestand staat maar het magazijn afwijkt, kan de bestelling toch gekoppeld worden aan de magazijnontvangst
<MOR_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 magazijnontvangst 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 magazijnontvangstregel.
<MOR_PARTIJNUMMER>	Partijnummer	Maximaal 20 cijfers, moet voorkomen in King	Alleen ingelezen met de optie Partijenregistratie. Verplicht als het artikel een partijartikel is
<MOR_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 MOR_VOORRAADEENHEDENINKOOPEENHEID is ingevuld (de inkoopeenheid wordt dan alleen opgeslagen in de ontvangstregel maar niet bij het artikel)
<MOR_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.
<MOR_AANTALONTVANGEN>	Aantal ontvangen	Maximaal 10 cijfers voor het decimaalteken en maximaal 3 decimalen
<MOR_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.
<MOR_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.
<MOR_KORTINGSBEDRAG> of <MOR_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.
<MOR_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)
<MOR_AANTALCORRECTIE>	Aantal correctie	Maximaal 10 cijfers voor het decimaalteken en maximaal 3 decimalen
<MOR_OPMERKING>	Opmerking		Als het veld leeg is, wordt het gevuld overeenkomstig de Vaste gegevens
<MAGAZIJNONTVANGSTREGELDETAILS>	Specificatieregels magazijnontvangst	Een of meer keren <MAGAZIJNONTVANGSTREGELDETAIL>	Niet verplicht

MAGAZIJNONTVANGSTREGELDETAIL

Veldnaam	Omschrijving	Mogelijke inhoud	Belangrijk
<MAGAZIJNONTVANGSTREGELDETAIL>	Ontvangstregel	Zie hierna bij Velden van de Specificatieregel Magazijnontvangst.

Velden van de Specificatieregel Magazijnontvangst

Veldnaam	Omschrijving	Mogelijke invoer	Belangrijk
<MORD_SERIENUMMER>	Serienummer	Maximaal 20 posities	Alleen ingelezen als de optie Serienummerregistratie actief is en als het artikel een serienummerartikel is
<MORD_LOCATIECODE>	Locatiecode	Maximaal 20 posities, moet voorkomen in King	Als het veld leeg is, wordt het gevuld overeenkomstig de Vaste gegevens inkopen. Locatiecode mag niet blokkerend zijn.
<MORD_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 ontvangstregel (omgerekend naar de voorraadeenheid, exclusief het correctie-aantal)
<MORD_AANTALCORRECTIE>	Aantal correctie	Maximaal 10 cijfers voor het decimaalteken en maximaal 3 decimalen, mag negatief zijn	Komt er definitief minder of meer binnen dan er is besteld, dan kun je de bestelregel toch op 'volledig ontvangen' zetten door het verschil vast te leggen als Aantal correctie
<MORD_ORDERNUMMER>	Ordernummer	Maximaal 10 cijfers, moet voorkomen in King	Alleen ingelezen met de optie Directe inkoop en als de ontvangstregel gekoppeld is aan een bestelling. Via het ordernummer kan dan een koppeling worden gemaakt naar een verkooporder.
<MORD_ORDERREGELNUMMER>	Orderregel	Maximaal 3 cijfers, moet voorkomen in de betreffende verkooporder	Alleen ingelezen met de optie Directe inkoop en als de ontvangstregel gekoppeld is aan een bestelling.
<MORD_BESTELREGELSOORT>	Soort bestelregel	MAGAZIJN of VERKOOPORDER	Alleen ingelezen met de optie Directe inkoop. Als het veld leeg is, of als MORD_ORDERNUMMER en MORD_ORDERREGELNUMMER niet zijn ingevuld, en/of als deze ontvangstregel niet is gekoppeld aan een bestelling, dan wordt gekozen voor MAGAZIJN

Voorbeeld van een XML-inleesbestand:

<KING_MAGAZIJNONTVANGSTEN>
 <MAGAZIJNONTVANGSTEN>
  <MAGAZIJNONTVANGST>
   <MAGAZIJNONTVANGSTKOP>
    <MOK_ONTVANGSTNUMMER>33</MOK_ONTVANGSTNUMMER>
    <MOK_LEVERANCIERNUMMER>17003230</MOK_LEVERANCIERNUMMER>
    <MOK_ONTVANGSTDATUM>2009-09-24</MOK_ONTVANGSTDATUM>
    <MOK_MAGAZIJNCODE>1</MOK_MAGAZIJNCODE>
    <MOK_VALUTA>Eur</MOK_VALUTA>
    <MOK_BEDRAG>0</MOK_BEDRAG>
    <MOK_AANGEMAAKTOP>2009-09-24</MOK_AANGEMAAKTOP>
    <MOK_AANGEMAAKTOP_TIJDSTIP>13:05</MOK_AANGEMAAKTOP_TIJDSTIP>
    <MOK_AANGEMAAKTDOOR>Gebruik</MOK_AANGEMAAKTDOOR>
    <MOK_OMSCHRIJVING>V.O.F. De Eendracht</MOK_OMSCHRIJVING>
    <MOK_ONTVANGSTLOCATIE></MOK_ONTVANGSTLOCATIE>
    <MOK_FACTUURBOEKINGMAKEN>1</MOK_FACTUURBOEKINGMAKEN>
    <MOK_FACTUURNUMMER>32</MOK_FACTUURNUMMER>
    <MOK_FACTUURDATUM>2009-09-24</MOK_FACTUURDATUM>
    <MOK_VERVALDATUM>2009-10-24</MOK_VERVALDATUM>
    <MOK_BETALINGSKENMERK>135/32</MOK_BETALINGSKENMERK>
   </MAGAZIJNONTVANGSTKOP>
   <MAGAZIJNONTVANGSTREGELS>
    <MAGAZIJNONTVANGSTREGEL>
     <MOR_SOORT>ART</MOR_SOORT>
     <MOR_ARTIKELNUMMER>BD-R25GB</MOR_ARTIKELNUMMER>
     <MOR_ARTIKELEANCODE>4902520283085</MOR_ARTIKELEANCODE>
     <MOR_BESTELNUMMER>30</MOR_BESTELNUMMER>
     <MOR_BESTELREGELNUMMER>1</MOR_BESTELREGELNUMMER>
     <MOR_INKOOPEENHEID>Stuk</MOR_INKOOPEENHEID>
     <MOR_VOORRAADEENHEDENININKOOPEENHEID>1</MOR_VOORRAADEENHEDENININKOOPEENHEID>
     <MOR_AANTALONTVANGEN>10</MOR_AANTALONTVANGEN>
     <MOR_PRIJS>12.77</MOR_PRIJS>
     <MOR_KORTINGSPERCENTAGE>0</MOR_KORTINGSPERCENTAGE>
     <MOR_BTWCODE>11</MOR_BTWCODE>
     <MOR_AANTALCORRECTIE>0</MOR_AANTALCORRECTIE>
     <MAGAZIJNONTVANGSTREGELDETAILS>
      <MAGAZIJNONTVANGSTREGELDETAIL>
       <MORD_LOCATIECODE>P002S002</MORD_LOCATIECODE>
       <MORD_AANTALONTVANGEN>0</MORD_AANTALONTVANGEN>
       <MORD_AANTALCORRECTIE>0</MORD_AANTALCORRECTIE>
       <MORD_BESTELREGELSOORT>MAGAZIJN</MORD_BESTELREGELSOORT>
      </MAGAZIJNONTVANGSTREGELDETAIL>
      <MAGAZIJNONTVANGSTREGELDETAIL>
       <MORD_LOCATIECODE>P002S002</MORD_LOCATIECODE>
       <MORD_AANTALONTVANGEN>10</MORD_AANTALONTVANGEN>
       <MORD_AANTALCORRECTIE>0</MORD_AANTALCORRECTIE>
       <MORD_ORDERNUMMER>20090022</MORD_ORDERNUMMER>
       <MORD_ORDERREGELNUMMER>1</MORD_ORDERREGELNUMMER>
       <MORD_BESTELREGELSOORT>VERKOOPORDER</MORD_BESTELREGELSOORT>
      </MAGAZIJNONTVANGSTREGELDETAIL>
     </MAGAZIJNONTVANGSTREGELDETAILS>
    </MAGAZIJNONTVANGSTREGEL>
   </MAGAZIJNONTVANGSTREGELS>
  </MAGAZIJNONTVANGST>
 </MAGAZIJNONTVANGSTEN>
</KING_MAGAZIJNONTVANGSTEN>

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

Zie ook