Externe Artikelen handleiding eenvoudig gebruik

2013-04-21T12:52:07Z

Merlijn: 1 versie

= Doel van de procedure =
Het doel van deze procedure is om artikelen die door leveranciers of anderen in elektronische vorm (tekstbestand of spreadsheet) zijn aangeleverd in te lezen in het eigen artikelbestand. Dit kunnen nieuwe artikelen zijn, bestaande artikelen waarvan bijvoorbeeld de prijs is gewijzigd of aanduidingen van vervallen artikelen.

Vaak heeft iedere leverancier zijn eigen indeling van de gegevens, maar levert deze wel iedere keer op dezelfde manier aan.

In plaats van de leverancier voor te schrijven op welke manier hij zijn gegevens moet aanleveren (meestal kan of wil de leverancier hieraan niet voldoen) is er een andere opzet gemaakt.

Hierbij wordt de '''manier''' waarop de leverancier zijn gegevens aanlevert vastgelegd in een document dat iedere keer weer kan worden gebruikt bij het inlezen van de door die leverancier aangeleverde gegevens. Dit document noemen wij een 'N-document'. Simpel gesteld: in het 'N-document' staat welke gegevens de leverancier aanlevert en de volgorde van de kolommen.

Bij het inlezen van gegevens wordt dus altijd gebruik gemaakt van twee documenten:
* het 'N-document' dat de indeling beschrijft
* het inleesbestand van de leverancier zelf

=Waar zijn de opdrachten te vinden=
Om de gegevens daadwerkelijk in te lezen kiest U één van de volgende opdrachten :

* [[Handleiding Inkoper Archief opdracht Importeer ...|Importeren in de Inkoper]]
* [[Handleiding Verkoper Archief opdracht Importeer ...|Importeren in de Verkoper]]

= Het inleesbestand van de leverancier voorbereiden=
De bestanden van een leverancier kunnen soms in één keer worden ingelezen, maar soms is een voorbereiding nodig door het voorbewerken van het document met een spreadsheetprogramma.

Het inleesbestand moet aan een aantal voorwaarden voldoen om gebruikt te kunnen worden:
* spreadsheetformaat
* het bestand moet een "schoon" bestand zijn, dus zonder verwijzingen of formules
* bij getallen kunnen voorloop nullen een probleem opleveren
* gebruik van spaties en voorloop nullen (bijv: artikelcode) alleen als dit zo bedoeld is
* de bedragen moeten in centen zijn

Afgezien van de volgorde van de velden is ook de scheiding tussen de velden vaak verschillend (tab, return, puntkomma enzovoorts) of hebben deze een vaste lengte van de gegevens.

NB: na wijziging wordt het document opgeslagen als '''Text-only''' document, anders kan Merlijn deze niet verwerken.

=Maken van een 'N-document'=
De specificaties worden in speciale documenten vastgelegd de 'N-documenten'. Deze documenten komen in een speciale map binnen de [[administratiemap]] te staan : de map ''LeverancierSpecs''.
Voor het maken van een N-document is de beste manier een spreadsheetpakket (bijv: Numbers van Apple's of Excel van Microsoft) op te starten, hierin de indeling te maken en dit document als '''Text-only''' formaat weg te schrijven.

De 'N-documenten' krijgen altijd een vaste naam, zodat het pakket deze kan herkennen. Deze naam bestaat uit :
* de letter 'N'
* het relatienummer van de leverancier

Voor een leverancier met het relatienummer 1234 wordt de naam van het document 'N1234''. De documenten komen in een speciale map binnen de [[administratiemap]] te staan : de map ''LeverancierSpecs''.

Voor het inlezen van de eerder uit Merlijn geëxporteerde bestanden wordt leverancier 'nul' gebruikt, dus heet het document 'N0' (nul).

Voordat een 'N-document' kan worden gemaakt moeten een aantal gegevens beschikbaar zijn:
* hoe zijn de gegevens gescheiden van elkaar (met tabs, puntkomma of hebben deze vaste lengtes)
* welke velden worden aangeleverd en in welke volgorde
* welke velden van de leverancier komen overeen met welke velden van Merlijn
* wat zijn de vermelde prijzen ? Bruto/netto, inclusief of exclusief BTW

Voor het maken van een N-document is de beste manier een spreadsheetpakket (bijv: Numbers van Apple's of Excel van Microsoft) op te starten, hierin de indeling te maken en dit document als '''Text-only''' formaat weg te schrijven.

De documenten krijgen altijd een vaste naam, zodat het pakket deze kan herkennen " bestaande uit "
* de letter 'N'
* het relatienummer van de leverancier

Bij een leverancier met het relatienummer 1234 wordt de naam van het document 'N1234' of 'W1234'.

==Indeling 'N-document'==
Het document bevat alle specificaties die nodig zijn voor :
* het type bestand (tab-delimited of puntkomma gescheiden)
* het aantal regels dat overgeslagen moet worden voor de data begint (bij beiden dus nu 1 regel)
* het aantal velden van het document
* een aantal regels met Merlijn veldnamen, met een 'dummy' veld voor de velden die overgeslagen moeten worden. De regel begint met de veldnaam, gevolgd door een code voor de actie die ondernomen moet worden (zie verderop)
* de code 'EOF velden' om duidelijk aan te geven dat de velddefinities over zijn
* de filterspecificaties voor het inlezen van de artikelen

===Type bestand ===
Het type bestand wordt als volgt aangegeven :
* 'tab' is tab-delimited
* 'puntkommma' is punt-komma gescheiden
* 'vast' bestand met vaste lengtes

=== Veldnamen ===
Als we naar de veldnamen zelf kijken zijn er verschillende mogelijkheden, die we kunnen aangeven door achter de veldnaam een | neer te zetten, gevolgd door 1 van onderstaande acties :
* 'overslaan' : de kolom overslaan. Er hoeft dan ook geen andere actie te volgen
* 'nieuw' :de kolom inlezen
* 'nieuwleeg: indien de rubriek leeg is de nieuwe waarde overnemen, anders laten staan
* 'default' : de defaultwaarde van het veld overnemen
* 'fixed : het veld krijgt de vaste waarde die hierachter staat gedefinieerd
* 'speciaal' : een speciale behandeling die per gebruiker is vastgelegd

=== Filter ===
Als eerste zullen wij duidelijk aangeven wat de 'normale' situatie is, waarvoor de onderstaande uitzonderingen zullen gelden. Wat hiermee bedoeld wordt is dat alles ingelezen wordt, behalve de uitzonderingen of juist niets, behalve de uitzonderingen.

Verder is iedere volgende regel een uitzondering (bij alles) of een aanvulling (bij niets} op de eerste regel.

* Op de eerste regel 'Alles' is alles inlezen, 'Niets' is niets inlezen

De regels eronder geven aan welke uitzonderingen er zijn door :
* een veldnaam
* '=', gelijk aan, '#' bevat, '<' kleiner dan waarde, '>' groter dan waarde
* het vergelijkingsveld
* de velden worden gescheiden door een '|'

== Het eerste document ==
Omdat de totale uitwerking de nodige tijd zal kosten zullen wij eerst uitgaan van een vereenvoudigde oplossing :
* in de eerste regel 'tab' of 'puntkomma'
* veldnamen allemaal dummy of inlezen, behalve groep --> 250
* filter op 'omschrijving-2' = merk
* filter op omschrijving-1 bevat 'TLP' of 'TLA' , dat zijn alle site-licenties

Bij de uitwerking is er voor gekozen om de koppen en filters in een tekstbestand met kolommen (TAB-Delimited) op te slaan,
zodat het onderhoud hiervan met Excel kan plaatsvinden en het geheel overzichtelijk blijft.

==Sleutelwoorden==
In de eerste kolom van iedere regel dient altijd een van de volgende sleutelwoorden te staan,
ieder sleutelwoord is een aanduiding over hetgeen wat er voor de rest op die regel staat.

Het pakket kent de volgende sleutelwoorden :
* MERLIJNKOP
* LEVKOP
* ZWART
* WIT
* FORCEER
* PERCENT
* SKIPLINES
* INITVELD
* USE_AANWEZIG
* AANWEZIG
* URL
* SCHEIDING

=== MERLIJNKOP ===
Op deze regel komen de Merlijn importsleutelwoorden te staan, zoals ARTCODE, OMSCHR1, INKPRIJS, e.d.
De volgorde van sleutelwoorden dienen overeen te komen met de indeling van het te importeren bestand.
Voor kolommen die niet ingelezen mogen/kunnen worden kan "DUMMY" als importsleutelwoord worden gebruikt.

=== LEVKOP ===
Dit is een kopie van de kop uit het aangeleverde artikelbestand
Deze heeft alleen een commentaarfunctie en dient voor een gemakkelijke vergelijking met de MERLIJNKOP

=== ZWART ===
Op deze regel kunnen zwart-condities worden opgenomen, bv ADOBE in de kolom van de fabrikant,
en #bevat TLD in de kolom van de omschrijving.
Zwart regels kunnen meerdere keren in document worden toegevoegd.
Overslaan gebeurt uiteindelijk als één van de zwart-regels een positief resultaat oplevert.
Een regel levert een postief resultaat op als aan alle ingevulde condities op die regel is voldaan.

=== WIT ===
Op deze regel kunnen wit-condities worden opgenomen.
Wit regels kunnen meerdere keren in document worden toegevoegd.
Meenemen gebeurt uiteindelijk als één van de wit-regels een positief resultaat oplevert.
Een regel levert een postief resultaat op als aan alle ingevulde condities op die regel is voldaan.

Indien Zwart een positief resultaat heeft opgeleverd wordt het artikel altijd overgeslagen

=== FORCEER ===
Ongebruikt.

=== PERCENT ===
Om een bepaalde kolom te berekenen met een percentage adhv een ander veld.
Bv De verkoopprijs kan bepaald worden aan de hand van de inkoopprijs door in de kolom van de verkoopprijs de volgende toekenning te zetten :
* INKPRIJS*120,00
Bij een inkoopprijs van 100,00 wordt de verkoopprijs dan 120,00

=== SKIPLINES ===
Het aantal regels dat moet worden overgeslagen van het te importeren document.
Normaalgesproken is dat 1 kopregel.
In de tweede kolom zet je dan een 1.

=== INITVELD ===
Wordt gebruikt om bepaalde velden een initiële waarde te geven, bv groep op 250.
In iedere kolom mag 1 toekenning worden gezet, er wordt niet naar de kolomkop gekeken.
* GROEP=250
* EENHOMS=Stuks
Leidende spaties worden ook in de tekst meegenomen, dus direct achter de = beginnen

=== USE_AANWEZIG ===
Zet een 1 in de 2e kolom achter dit sleutelwoord. In dat geval wordt de regel "AANWEZIG" gebruikt, waarmee per kolom kan worden aangegeven of bij bestaande artikelen,
dit veld moet worden overschreven of niet.

=== AANWEZIG ===
Met "AANWEZIG" kan per kolom worden aangegeven of bij bestaande artikelen,
dit veld moet worden overschreven of niet, of alleen indien het nog leeg is :
* + Altijd overschrijven met de nieuw aangeleverde waarde
* - Niet overschrijven
* 0 Alleen overschrijven indien het veld nog op nul staat, leeg is of met een spatie begint.

=== URL ===
Voor automatisch downloaden importbestanden.
* 1e kolom : Usernaam
* 2e kolom : Userpasswoord
* 3e kolom : FTP-Path
Het is voldoende om bij Usernaam (1e kolom achter sleutelwoord) iets in te vullen om bij de import het extra venster voor bestandsdownload te laten verschijnen. Ook via dat importvenster kunnen de FTP-gegevens dan worden ingevuld.

Het gedownloadde bestand krijgt als naam :
* Artikelbestand
* Relatienr. leverancier
* Datum van vandaag
en wordt automatisch geopend indien de download goed is gegaan, anders krijg je het open venster waarin een artikelbestand geselecteerd kan worden.

=== SCHEIDING ===
De scheiding tussen rubrieken. Zet een van de volgende code-woorden in de 2e kolom :
* TAB
* KOMMA
* PUNTKOMMA
Indien "SCHEIDING" ontbreekt in het specificatiedocument vraagt het pakket als vanouds om het scheidingsteken via een venster.

=== FUNCTIES ===
* #bevat Gebruikt in WIT/ZWART regels om te controleren of het veld een bepaalde tekst bevat aan de hand waarvan de import van het artikel dan geblokkeerd kan worden of niet.

= Het document zelf =
[[Afbeelding:N-document.jpg]]

Met sleutelwoorden wordt aangegeven welke velden in het inleesdocument staan :
* zet in cel A1 het woord 'MERLIJNKOP'
* in cel B1 het sleutelwoord van de eerste kolom
* in cel C1 het sleutelwoord van de tweede kolom
enz.

Staat een kolom '''wel''' in het in te lezen document maar mag niet worden ingelezen, dan wordt het sleutelwoord '''niet''' ingevuld en blijft de kolom blanco.

Op de tweede regel wordt aangegeven hoe de kolommen van elkaar zijn gescheiden :
* zet in cel A2 het woord 'SCHEIDING'
* in cel B2 het woord 'TAB'

Tenslotte wordt nog aangegeven of van het inleesdocument de eerste regels moeten worden overgeslagen omdat hierin bijvoorbeeld bladnummers of kolomkoppen staan :
* zet in cel A3 het woord 'SKIPLINES'
* in cel B3 het cijfer '1' (of hoeveel regels overgeslagen moeten worden)

Meer gegevens zijn niet nodig.

==Inlezen==
Het 'N0' document wordt in een speciale map binnen de [[administratiemap]] geplaatst : de map ''LeverancierSpecs''.

==Nieuwe artikelen of gewijzigde==
* Wanneer het artikel (artikelcode) al bestaat, worden de artikelgegevens gewijzigd.
* Wanneer het artikel (artikelcode) nog niet bestaat, wordt een nieuw artikel toegevoegd.

Speciaal met Excel-documenten en nullen vooraan in de artikelcode is dus enige voorzichtigheid geboden om te verhinderen dat de routine grote aantallen nieuwe artikelen toevoegt, terwijl dat niet de bedoeling was.

{{:Handleiding Sleutelwoorden Verkoopartikelen}}
{{:Handleiding Sleutelwoorden Inkoopartikelen}}

=Inlezen=

[[Afbeelding:Inkoper Menu Archief Importeer.png]]

Start de Inkoper op, kies uit het menu Archief voor de opdracht Importeer.

[[Afbeelding: Inkoper Archief Importeer.png]]

In dit venster, kies voor Importeer artikelen en klik OK.

[[Afbeelding:Bepaal_leverancier.png]]

* Indien u inkoopartikelen wilt inlezen kies '''Bepaal de leverancier'''
* Indien u alleen verkoopartikelen wilt inlezen kies '''Gebruik N0-document'''

[[Afbeelding:Zoekmethode.png]]

Selecteer uit het pop-up menu de zoekmethode en geef de return toets.
Geef vervolgens het zoekgegeven in.

[[Afbeelding:Volledig bestand.png]]

Volledig bestand staat voor alle artikelen inlezen, nieuw en gewijzigde artikelen en maakt gebruik van het Nxx document.

Prijzenbestand staat voor alléén inkoopprijs inlezen van de bestaande artikelen en maakt gebruik van het Pxx document.

Geef OK.

[[Afbeelding:Regels in N-doc.png]]

In dit venster wordt het aantal regels aangegeven in het hulpbestand Nxx of Pxx.

Geef OK.

[[Afbeelding:Blokkeer of overschrijf.png]]

Indien u kiest voor 'Blokkeer reeds bestaande artikelen' worden alléén de nieuwe artikelen ingelezen.

Indien u kiest voor 'Overschrijf importgegevens van best. artikelen' wordt alléén het Prijzenbestand ingelezen.

[[Afbeelding:Open N-Doc.png]]

Via het volgende venster kunt u het inleesdocument selecteren. Zoek het bestand van de leverancier op, op de plek waar u het heeft bewaard.

In dit voorbeeld heet de map 'N-Document' en het inleesdocument 'Seapower CR-UTF8.txt'.

Selecteer dit document en klik op OPEN.

[[Afbeelding:Aantal regels in inleesdoc.png]]

In het volgende venster wordt nog aangegeven hoeveel artikelen in het inleesbestand staan.

[[Afbeelding:Inkoper_Import_Gereed.png]]

Als de gegevens zijn ingelezen wordt in dit venster ter controle aangegeven hoeveel nieuwe artikelen zijn ingevoerd en hoeveel er zijn gewijzigd.

Handleiding Kassa Vraag en Antwoord

2013-04-21T12:52:05Z

Merlijn: 1 versie

{{Kassa navigatie home}}

Dit zijn de beschrijvingen van de verschillende vragen en antwoorden die in de Kassa kunnen worden gesteld.

{{:Handleiding Algemeen Vraag en Antwoord}}

== Boodschap op het scherm ==

*Er verschijnt een boodschap [[Handleiding Kassa vraag naMerFSWrite|naMerFSWrite]] op het scherm.

== Kassa opmaken op een andere plaats ==

Kan ik mijn kassa ook op een andere plaats opmaken omdat ik niet graag mijn geld sta te tellen in de winkel zelf ?

 '''Antwoord'''

Er zijn verschillende mogelijkheden :

*bij gebruik van een Inkoper of Verkoper als backofficepakket is de mogelijkheid in deze pakketten aanwezig.
*bij de Kassa met Kassabeheerder kan van 'Remote Desktop' gebruik gemaakt worden. Dit is een pakket dat Apple levert. Nadeel is wel dat het opmaken dat op het scherm van de Kassa zelf zichtbaar blijft, maar dat kan opgevangen worden door het scherm donker te zetten.
*de derde mogelijkheid is de simpelste : neem de lade mee naar een andere plaats, tel deze en noteer de aantallen munten en biljetten op een kladje en voer deze later in de winkel in. Niemand ziet dan dat U in de lade bezig was.

== Hoe verwerk ik een retourartikel in de kassa ==

*voer een normale bon in
*kies het artikel
*geef bij aantal '-1' in

==Het gebruik van VVV-bonnen en dergelijke==
Het gebruik van VVV-bonnen of andere tegoedbonnen kent twee situaties:
* het '''uitgeven''' van de bon:hier is het een normaal artikel dat verkocht wordt en waar een betaling tegenover staat
* het '''innemen''' van de bon: nu is het een betaalmiddel geworden, net zoals contant of pinnen. Als deze 'betaalsoort' nog niet aanwezig is kan deze toegevoegd worden via de procedure: [[Handleiding_Kassa_Tabellen_opdracht_Wijzig_betaalsoorttabel|Tabellen opdracht Wijzig betaalsoorten]].

== Deelbetaling en restbetaling==
Voor een deelbetaling is een speciale transactie beschikbaar, waarbij in de betalingswijze aangegeven kan worden welk deel op rekening wordt geleverd.

Voor de restbetaling kan de 'Z-transactie' gebruikt worden. Kies vervolgens 'betaling debiteur', daarna het bedrag ingeven en klik op bon maken. Er verschijnt een invulscherm waarin de naam, factuurnr (kan gewijzigd worden in bonnummer) en omschrijving ingeven kan worden. Er worden vervolgens twee bonnen afgedrukt waarvan een voor de administratie.

==Corrigeren verschil tussen kas en pinnen==
Dit kan op twee manieren:
* via een Z-transactie
* via de Kasopmaak

==Systeem blijft vragen om opnieuw te starten==
Als een andere taal is ingesteld (voorkeuren of via een toetscombinatie) dan kan het systeem soms blijven vragen om opnieuw te starten. Verwijder dit document 'merlijn documenten/merlijn voorkeuren/voorkeuren/humtaal', hierna moet de kassa weer in het Nederlands opstarten.

==Starprinter opnieuw instellen==
Vanaf versie 10.4.0 hoeft de Starprinter slechts éénmalig te worden ingesteld.

Als een verkeerde papierinstelling is gekozen moet deze opnieuw worden ingesteld. Ga hierbij als volgt te werk:
* Sluit kassa en kassabeheerder af
* In de map Programma's staat een map Merlijn Kassa. Daarbinnen zit een map Printer. In deze map staat een bestandje dat heet 'Star'. Verwijder dit.
* Start de kassa op. Kies 'Print kopie-bon'. Hierna vraagt deze om de printer. Selecteer printer Star en zet papierformaat op 72x180

Bon komt eruit... Kassa werkt normaal. U kunt verder met de Kassa.

= Woordenlijst =

*[[Handleiding Algemeen Woordenlijst|Algemene woordenlijst]]
*[[Handleiding Kassa Woordenlijst|Kassa woordenlijst]]

[[Category:Handleiding_Kassa]]