Met deze optie kun je een XML-bestand met projectmutaties of weekstaten importeren in King.
Dat 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:
-
Elk projectmutatiebestand en elke weekstaat bestaat uit kopgegevens en één of meer mutatieregels.
-
Elke mutatieregel kan weer één of meer serienummers bevatten.
-
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_PROJECTMUTATIES
| Veldnaam | Omschrijving | Mogelijke inhoud | Belangrijk |
|---|---|---|---|
|
<KING_PROJECTMUTATIES> |
Geeft begin en eind aan van het King-inleesbestand met projectmutaties/weekstaten |
Eenmaal <PROJECTMUTATIES > |
Verplicht |
PROJECTMUTATIES
| Veldnaam | Omschrijving | Mogelijke inhoud | Belangrijk |
|---|---|---|---|
|
<PROJECTMUTATIES> |
Geeft begin en eind aan van de projectmutaties in het King-inleesbestand |
Een of meer keren <PROJECTMUTATIE > |
Verplicht |
PROJECTMUTATIE
| Veldnaam | Omschrijving | Mogelijke inhoud | Belangrijk |
|---|---|---|---|
|
<PROJECTMUTATIE> |
Gegevens projectmutatie/weekstaat |
Eenmaal <PROJECTMUTATIEKOP> Eenmaal <PROJECTMUTATIEREGELS> |
Verplicht |
PROJECTMUTATIEKOP
| Veldnaam | Omschrijving | Mogelijke inhoud | Belangrijk |
|---|---|---|---|
|
<PROJECTMUTATIEKOP> |
Kopgegevens projectmutatie/weekstaat |
Zie hierna, bij Velden van de projectmutatiekop |
Verplicht |
Velden van de Projectmutatiekop/Weekstaatkop
| Veldnaam | Omschrijving | Mogelijke invoer | Belangrijk |
|---|---|---|---|
|
<PMK_VOLGNUMMER> |
volgnummer mutatiebestand / weekstaat |
Max. 10 cijfers, mag nog niet voorkomen in King |
Als het veld ontbreekt, wordt het volgnummer gegenereerd volgens de instelling in de Vaste gegevens |
|
<PMK_OMSCHRIJVING> |
omschrijving mutatiebestand / weekstaat |
Max. 40 posities |
Als het veld ontbreekt, wordt als omschrijving "XML-import <bestandsnaam>" gebruikt |
| <PMK_WEEKSTAAT_MEDEWERKER> |
zoekcode van de projectmedewerker van deze weekstaat |
10 posities, moet voorkomen in King en mag niet geblokkeerd zijn |
Invoer verplicht als PMK_WEEKSTAAT_JAAR of PMK_WEEKSTAAT_WEEK is ingevuld. Voor de combinatie van medewerker, jaar en week mag nog geen weekstaat in King voorkomen |
| <PMK_WEEKSTAAT_JAAR> | jaar weekstaat | Max. 4 cijfers, boekjaar hoeft niet te bestaan in King | Invoer verplicht als PMK_WEEKSTAAT_MEDEWERKER of PMK_WEEKSTAAT_WEEK is ingevuld. Voor de combinatie van medewerker, jaar en week mag nog geen weekstaat in King voorkomen |
| <PMK_WEEKSTAAT_WEEK> | weeknummer weekstaat | Minimaal 1, maximaal 53 | Invoer verplicht als PMK_WEEKSTAAT_MEDEWERKER of PMK_WEEKSTAAT_JAAR is ingevuld. Voor de combinatie van medewerker, jaar en week mag nog geen weekstaat in King voorkomen |
PROJECTMUTATIEREGELS
| Veldnaam | Omschrijving | Mogelijke inhoud | Belangrijk |
|---|---|---|---|
|
<PROJECTMUTATIEREGELS> |
Regel projectmutatie / weekstaat |
Een of meer keren <PROJECTMUTATIEREGEL> |
Verplicht |
PROJECTMUTATIEREGEL
| Veldnaam | Omschrijving | Mogelijke inhoud | Belangrijk |
|---|---|---|---|
|
<PROJECTMUTATIEREGEL> |
Projectmutatieregel / Weekstaatregel |
Zie hierna, bij Velden van de Projectmutatieregels |
Verplicht |
Velden van de Projectmutatieregels/Weekstaatregels
| Veldnaam | Omschrijving | Mogelijke invoer | Belangrijk |
|---|---|---|---|
|
<PMR_SOORT> |
Mutatiesoort (activiteit, artikel of overige kosten) |
ACT, TAR, MACH of ART (hoofdletters). Zowel TAR als MACH zijn bestemd voor een projecttarief van de soort Overige kosten |
Verplicht |
|
<PMR_ARTIKELNUMMER> |
tariefcode of artikelnummer |
20 posities, moet voorkomen in King, tariefcode mag niet geblokkeerd zijn |
Verplicht |
|
<PMR_TEKST> |
regelomschrijving |
|
Als het veld niet voorkomt, wordt de Tekst op factuur van het artikel of projecttarief overgenomen |
|
<PMR_PROJECTCODE> |
projectcode |
10 posities, moet voorkomen in King en de status In voorbereiding of Onderhanden hebben |
Verplicht |
|
<PMR_PROJECTONDERDEEL> |
code projectonderdeel |
40 posities, moet voorkomen in het project |
Verplicht |
| <PMR_WEEKSTAATREGELNUMMER> | regelnummer weekstaat | Max. 10 cijfers. Met behulp van het regelnummer kunnen mutaties bij elkaar worden geplaatst |
Alleen toegestaan bij een weekstaat. Mag niet ingevuld zijn bij een artikelmutatie, als de mutatie betrekking heeft op een andere projectmedewerker dan in PMK_WEEKSTAAT_MEDEWERKER is ingevuld, of als de mutatiedatum van deze regel buiten de PMK_WEEKSTAAT_WEEK valt. Per weekstaat mag een regelnummer vaker voorkomen, maar daarbij gelden de volgende regels:
Is het regelnummer niet ingevuld, dan wordt het nummer door King bepaald bij het inlezen. Mutaties die niet in de weekstaat kunnen worden ondergebracht, worden wel ingelezen maar komen terecht in het bijbehorende projectmutatiebestand. |
|
<PMR_MEDEWERKER> |
zoekcode van de projectmedewerker |
10 posities, moet voorkomen in King en mag niet geblokkeerd zijn |
Verplicht als PMR_SOORT = ACT |
|
<PMR_CATEGORIEEN> |
categorieën |
|
|
|
<PMR_MUTATIEDATUM> |
|
JJJJ-MM-DD |
Als het veld leeg is, wordt de verwerkingsdatum gebruikt |
|
<PMR_AANTALBESTEED> |
aantal besteed |
Max. 10 cijfers voor het decimaalteken; aantal decimalen afhankelijk van artikel/tarief |
Verplicht veld. Bij een tarief met een doorbelastingspercentage wordt altijd een aantal van 1 gehanteerd |
| <PMR_AANTALBESTEED_MINUTEN> | aantal bestede minuten | Minimaal 0, maximaal 5999, geen decimalen | Waarde wordt opgeteld bij PMR_AANTALBESTEED. Alleen ingelezen als PMR_SOORT = ACT. Alleen toegestaan als het aantal decimalen van het projecttarief 2 of 3 is. Als dit veld is ingevuld en de begintijd niet, dan is de invoer van de regel in tijdsnotatie |
| <PMR_AANTALBESTEED_BEGINTIJD> | begintijd activiteit | uu:mm | Alleen ingelezen als PMR_SOORT = ACT. Minuten zijn alleen toegestaan als het aantal decimalen van het projecttarief 2 of 3 is. Is dit veld ingevuld, dan is de invoer van de regel in Begintijd/Eindtijd |
|
<PMR_AANTALDECLARABEL> |
aantal declarabel (in de factuureenheid) |
Max. 10 cijfers voor het decimaalteken; aantal decimalen afhankelijk van artikel/tarief |
Alleen ingelezen bij projectonderdelen van de soort Regie. Als het veld leeg is, wordt het aantal declarabel berekend op basis van het aantal besteed, rekening houdend met de factuureenheid van de activiteit. Bij een tarief met een doorbelastingspercentage wordt altijd een aantal van 1 gehanteerd. Bij projectonderdelen van de soort Termijn is het Aantal declarabel gelijk aan het Aantal besteed |
| <PMR_AANTALDECLARABEL_MINUTEN> | aantal declarabele minuten | Minimaal 0, maximaal 5999, geen decimalen | Waarde wordt opgeteld bij PMR_AANTALDECLARABEL. Alleen ingelezen als PMR_SOORT = ACT en bij projectonderdelen van de soort Regie. Alleen toegestaan als het aantal decimalen van het projecttarief 2 of 3 is. Als dit veld is ingevuld en de begintijd niet, dan is de invoer in tijdnotatie |
|
<PMR_DIRECTEINKOOP> |
directe inkoop ja/nee |
true of false (hoofd- en/of kleine letters); 1 of 0 |
Alleen ingelezen als PMR_SOORT = ART, TAR of MACH |
|
<PMR_PARTIJNUMMER> |
partij |
Max. 20 posities, moet voorkomen bij het artikel |
Verplicht bij partij registrerend artikel. Alleen ingelezen als PMR_SOORT = ART en PMR_DIRECTEINKOOP = false |
|
<PMR_MAGAZIJN> |
magazijncode |
Max. 3 cijfers, moet voorkomen in King |
Verplicht. Alleen ingelezen als PMR_SOORT = ART en PMR_DIRECTE INKOOP = false. Als het veld leeg is, wordt het default-magazijn van de gebruiker overgenomen, en als dat er niet is, magazijn 001 |
|
<PMR_LOCATIE> |
locatiecode |
Max. 20 posities, moet voorkomen in het opgegeven magazijn |
Als het veld ontbreekt, wordt de default-locatie van het artikel in het magazijn overgenomen. Alleen ingelezen als PMR_SOORT = ART en PMR_DIRECTE INKOOP = false |
|
<PMR_SERIENUMMERS> |
Serienummers |
Eenmaal <PMR_SERIENUMMERS> |
Alleen ingelezen als PMR_SOORT = ART en PMR_DIRECTE INKOOP = false |
|
<PMR_LEVERANCIERNUMMER> |
nummer leverancier |
Max. 10 cijfers, moet als crediteur voorkomen in King |
Alleen ingelezen als PMR_DIRECTE INKOOP = true, is in dat geval ook verplicht |
|
<PMR_KOSTPRIJS> |
kostprijs per eenheid |
Max. 10 cijfers voor het decimaalteken; aantal decimalen afhankelijk van artikel/tarief |
Alleen ingelezen als PMR_DIRECTE INKOOP = true of als het gaat om een tarief met een doorbelastingspercentage. Als het veld leeg is, wordt de kostprijs van het artikel of tarief overgenomen |
|
<PMR_VERKOOPPRIJS> |
verkoopprijs per factuureenheid |
Max. 10 cijfers voor het decimaalteken; aantal decimalen afhankelijk van artikel/tarief |
Als het veld leeg is, dan wordt de verkoopprijs berekend. Niet ingelezen bij een tarief met een doorbelastingspercentage. |
| <PMR_OPMERKING> | opmerkingen veld | onbeperkt |
Ingelezen projectmutaties hebben de status Concept.
PMR_SERIENUMMERS
| Veldnaam | Omschrijving | Mogelijke invoer | Belangrijk |
|---|---|---|---|
|
<PMR_SERIENUMMERS> |
Serienummers |
Een of meer keren <PMR_SERIENUMMER> |
|
PMR_SERIENUMMER
| Veldnaam | Omschrijving | Mogelijke invoer | Belangrijk |
|---|---|---|---|
|
<PMR_SERIENUMMER> |
Serienummer |
Zie hierna, bij Velden van het Serienummer |
|
Velden van het Serienummer
| Veldnaam | Omschrijving | Mogelijke invoer | Belangrijk |
|---|---|---|---|
|
<PMR_SERIENUMMER_NUMMER> |
Serienummer |
Max. 20 posities, moet voorkomen bij het artikel en bij de partij (als een partij is opgegeven) |
|
Voorbeeld van een XML-inleesbestand
<KING_PROJECTMUTATIES>
<PROJECTMUTATIES>
<PROJECTMUTATIE>
<PROJECTMUTATIEKOP>
<PMK_OMSCHRIJVING>Jansen week 6</PMK_OMSCHRIJVING>
</PROJECTMUTATIEKOP>
<PROJECTMUTATIEREGELS>
<PROJECTMUTATIEREGEL>
<PMR_SOORT>ART</PMR_SOORT>
<PMR_ARTIKELNUMMER>MON007</PMR_ARTIKELNUMMER>
<PMR_TEKST>LCD 17inch </PMR_TEKST>
<PMR_PROJECTCODE>Autom0903</PMR_PROJECTCODE>
<PMR_PROJECTONDERDEEL>balie</PMR_PROJECTONDERDEEL>
<PMR_MEDEWERKER>Jansen</PMR_MEDEWERKER>
<PMR_CATEGORIEEN>monitoren</PMR_CATEGORIEEN>
<PMR_MUTATIEDATUM>2012-02-09</PMR_MUTATIEDATUM>
<PMR_AANTALBESTEED>2</PMR_AANTALBESTEED>
<PMR_AANTALDECLARABEL>2</PMR_AANTALDECLARABEL>
<PMR_DIRECTEINKOOP>false</PMR_DIRECTEINKOOP>
<PMR_PARTIJNUMMER>090124</PMR_PARTIJNUMMER>
<PMR_MAGAZIJN>001</PMR_MAGAZIJN>
<PMR_LOCATIE>P001S001</PMR_LOCATIE>
<PMR_SERIENUMMERS>
<PMR_SERIENUMMER>
<PMR_SERIENUMMER_NUMMER>X654378906</PMR_SERIENUMMER_NUMMER>
</PMR_SERIENUMMER>
<PMR_SERIENUMMER>
<PMR_SERIENUMMER_NUMMER>M543527890</PMR_SERIENUMMER_NUMMER>
</PMR_SERIENUMMER>
</PMR_SERIENUMMERS>
</PROJECTMUTATIEREGEL>
</PROJECTMUTATIEREGELS>
</PROJECTMUTATIE>
</PROJECTMUTATIES>
</KING_PROJECTMUTATIES>
Overige aandachtspunten:
-
Het bestand wordt ingelezen als weekstaat als de velden PMK_WEEKSTAAT_MEDEWERKER, PMK_WEEKSTAAT_JAAR en PMK_WEEKSTAAT_WEEK zijn ingevuld. Afhankelijk hiervan is de Herkomst van het ingelezen bestand Import projectmutaties of Import weekstaat;
-
Het partijnummer wordt alleen ingelezen als de administratie beschikt over de optie Partijenregistratie én als het betreffende artikel een partijen-artikel is;
-
Het serienummer wordt alleen ingelezen als de administratie beschikt over de optie Serienummerregistratie én als het betreffende artikel een serienummer-artikel is.
Kijk voor extra aandachtspunten: Inlezen XML-bestand > Overige aandachtspunten
Zie ook