Optionele module: Link bouwsoft-cebeo, import

Transcriptie

1 Optionele module: Link bouwsoft-cebeo, import Gebruikers van bouwsoft, die klant zijn bij de leverancier Cebeo, kunnen intekenen op de optionele module Link bouwsoft-cebeo. De optionele module wordt beschikbaar gesteld via de online webshop: webshop.bouwsoft.be Vooraf U dient klant te zijn of te worden bij Cebeo. U dient te beschikken over een e-shop account of deze aan te vragen. U dient door Cebeo een bouwsoft gebruiker te laten aanmaken. Belangrijk: gebruik als browser steeds Internet Explorer. Afbeelding 1 Pag. 1 / 11

2 Klant worden, Om klant te worden of een e-shop account aan te vragen kan u terecht op de Cebeo website: en klikt u verder op AANVRAAG USER ID. Hier vindt u een lijst met regionale verkoopfilialen en hun contactgegeven. Neem contact op om klant te worden bij Cebeo. e-shop account aanvragen Eens u beschikt over een geldig klantnummer, dan kan u via de Cebeo website een e-shop account aanvragen. Ga naar de Cebeo website: en klik u verder op AANVRAAG USER ID. Zodra deze is goedgekeurd, kan u een specifieke bouwsoft gebruiker laten aanmaken. Afbeelding 2 Bouwsoft e-shop gebruiker laten aanmaken Laat door de Cebeo helpdesk ( ) een bouwsoftgebruiker aanmaken op de e-shop. De gebruikersnaam van de bouwsoft gebruikers start altijd met de letters BS, gevolgd door een spatie en de rest van de naam. Pag. 2 / 11

3 Importeren van de Cebeo lijst Het importeren gebeurt in 4 stappen, waarbij de eerste 2 slechts eenmalig moeten worden uitgevoerd: Stap 1: Eénmalige installatie. Stap 2: Configuratiebestand opstellen. Stap 3: Ophalen lijst. Stap 4: Importeren lijst. Eénmaal uitgevoerd, volstaat het stappen 3 en 4 te herhalen om de prijslijst opnieuw op te halen. Stap 1: Eénmalige installatie. Belangrijk: Gebruik als browser steeds Internet Explorer. Download export.exe Via de link kiest u eerst uw voorkeurstaal. Vervolgens klikt u op de link Meer info + Installatie. Hier zullen uw Cebeo login-gegevens worden gevraagd: gebruikersnaam en wachtwoord. U krijgt dan een stappenplan te zien. In stap1 download u het uitvoerbaar bestand export.exe. U vindt hier tevens een handleiding. Uitvoeren export.exe Open het gedownloade bestand. U bepaalt zelf in welke folder u dit bestand wenst op te slaan. Standaard wordt C:\CebeoExport voorgesteld. Afbeelding 3 Pag. 3 / 11

4 Stap 2: opstellen configuratiebestand. In deze stap maakt u een bestand aan, waarmee u aangeeft welke materialen u uit de catalogus van Cebeo wenst te gebruiken en in welke vorm deze dient te worden opgeslagen. Klik op de link Maak configuratiebestand aan. Afbeelding 4 Klantgegevens Onder Customer staan uw klantnummer en gebruikersnaam standaard ingevuld, let erop dat de gebruikersnaam (e-shop username) begint met BS. Het wachtwoord dient u hier opnieuw in te voeren. Pag. 4 / 11

5 Export-instellingen Onder het puntje Export dient u de bestandsnaam export te behouden en als bestandstype te kiezen voor CSV. Als decimaalteken laat u de komma geselecteerd staan. U kan het aantal artikels waarvoor een lijst wordt opgesteld beperken, zodat u kan verhinderen dat teveel artikels worden ingelezen, waardoor zoekacties sterk zouden vertragen. Belangrijk: teveel materiaalitems vertraagt het zoeken. De volledige catalogus bevat immers meer dan materialen. Het is sterk aanbevolen hier een waarde lager dan (dertigduizend) in te voeren. Filter-instellingen Via filters kan u aanpassen welke materialen u wenst te exporteren naar een materiaallijst. Contacteer Cebeo om deze goed in te stellen. Als bron source kan u kiezen voor één van volgende mogelijkheden: All = Alle artikelen worden dan overgebracht. Contract = Alle artikelen waarvoor u een contract hebt bij Cebeo. History = Alle artikelen die u de laatste 4 jaar bestelde bij Cebeo. History+Stock = Alle artikelen die u de laatstet 4 jaar bestelde bij Cebeo en alle artikelen op stock bij Cebeo. Own reference = Alle artikelen waarvoor u in de e-shop een customerreference hebt opgegeven. Er kunnen één of meerdere productcenters worden geselecteerd via PClist. Als u hier verschillende PC's (productcenters) wenst te selecteren, dan dient u deze onder elkaar te plaatsen. Volgende waarden zijn mogelijk: 01 = Huishoudapparaten / Ménager 02 = Installatiemateriaal / Installation 03 = Industrie 04 = Technische verlichting / Eclairage technique 05 = Kabel, draad & koper / Fils & cables 06 = Audio & video 07 = Netwerken / Réseaux informatiques 08 = Verwarming / Chauffage 09 = Witgoed / Gros blanc 10 = Electronica / Electronique 11 = Domotica / Domotique 12 = Architecturale verlichting / Eclairage architecturale Pag. 5 / 11

6 Er kunnen één of meerdere gammalijsten worden geselecteerd via de PClist. Ook hier dienen ze telkens op een nieuwe regel te worden geplaatst. Opgelet gammanaam staat niet altijd voor het merk. De volledige lijst is beschikbaar na het uitvoeren van stap 3 in de folder C:\CebeoExport als het bestand export.csv. Het export.csv-bestand kan geopend worden met Microsoft Excel of OpenOffice.org Calculator. Voorbeelden: 36 = NIKO 77 = KOPEREN STAVEN EN DRAAD/BARES MEPLATS ET FIL DE CUIVRE 238 = BTICINO Voor StockCodeList bestaan 3 mogelijke waarden, wat betreft eisen aan de beschikbaarheid van materialen. Ook hier is het mogelijk om combinaties van waarden te gebruiken door ingave op verschillende regels. A = In alle depots gebruikelijke op stock. B = In het hoofddepot gebruikelijk op stock. C = Gebruikelijk niet op stock. Klik op de OK-knop en sla het bestand op als exportconfig.xml in folder waarin export.exe is uitgevoerd, standaard: C:\CebeoExport. Voor meer geavanceerdere opties kan het exportconfig.xml bestand manueel worden aangepast. Een technische uitleg hierover is beschikbaar in de ExportManual beschikbaar via de link nadat u uw logingegevens heeft ingevoerd. Een andere mogelijkheid is dat u contact opneemt met de Cebeo helpdesk ( ), zodat zij samen met u een exportconfig.xml bestand kunnen opmaken. Pag. 6 / 11

7 Stap 3: ophalen lijst. Het ophalen van de lijst kan met het programma Run.bat, aanwezig in de folder C:\CebeoExport. Stap 4: importeren lijst. Afbeelding 5 Het importeren van de opgehaalde lijst gebeurt via bouwsoft. Open het menu Importeren / Exporteren en klik op Overzicht. In de boomstructuur opent u Import, materiaalplatform, Cebeo. Als bestandslocatie geeft u de Cebeo ExportFolder op, standaard C:\CebeoExport. Klik op uitvoeren om de lijst in bouwsoft te importeren. Afbeelding 6 Tijdens het importeren ziet u het aantal ingelezen materiaalitems oplopen tot ze allemaal zijn toegevoegd of geüpdate. Dat kan enkele minuten in beslag nemen afhankelijk van het aantal materiaalitems dat wordt ingevoerd. Het duurt 5 tot 40 minuten om materiaalitems te importeren afhankelijk van de snelheid van uw computer. Belangrijk: Voer geen aanpassingen uit aan de materiaalbibliotheek tijdens het importeren. Pag. 7 / 11

8 Afbeelding 7 In dit venster kan u tevens uw klantgegeven invoeren. Via de knop met het winkelwagentje heeft u onmiddellijk toegang tot de cebeo e-shop. Bij het importeren worden volgende gegevens geüpdate: Materiaallijst: Alle materiaal wordt toegevoegd aan de lijst Cebeo, indien deze niet bestaat wordt ze aangemaakt. Groepsnaam Materiaalnummer1: CEB + Cebeo referentienummer. Materiaalnummer2: Referentie van de fabrikant. Beschrijving Beschrijving Alt.: Franstalige beschrijving. Nota Nota Alt.: Franstalige nota. Merk Barcode Basiseenheid Aankoopprijs Leverancier: Cebeo Pag. 8 / 11

9 Velden Nota en Nota Alt. Opgelet: standaard worden de velden Nota en Nota Alt. niet ingevuld. Om dit mogelijk te maken dient u het exportconfig.xml bestand manueel aan te passen. Open hiertoe het exportconfig.xml bestand met kladblok en pas volgende regels aan: <COMOMSNL index="0" name="comdescrnl"/> <COMOMSFR index="0" name="comdescrfr"/> moet worden: <COMOMSNL index="27" name="comdescrnl"/> <COMOMSFR index="28" name="comdescrfr"/> Waarbij de getallen 27 en 28 cijfers moeten zijn opvolgen op de vorige regels. Bijvoorbeeld: <ARIDAR index="1" name="supplierid"/> <GAKDAR index="2" name="brandcode"/> <ARNRAR index="3" name="reference"/> <RBKDAR index="4" name="reelcode"/> <RBLEAR index="5" name="reellength"/> <OMNLAR index="6" name="descriptnl" length="40"/> <OMFRAR index="7" name="descriptfr" length="40"/> <PCKDAR index="8" name="prodcenter"/> <SGKDAR index="9" name="subgamme"/> <FAKDAR index="10" name="family"/> <SKKDAR index="11" name="stockcode"/> <EHMVAR index="12" name="unitofmeas"/> <ORVGAR index="13" name="unitpoblig"/> <EHVGAR index="14" name="unitpack"/> <URL index="15" name="url"/> <ARLVRT index="16" name="customerid"/> <BWKDAR index="17" name="tav"/> <SABAAR index="18" name="sabam"/> <ECOTAR index="19" name="ecotax"/> <RECUAR index="20" name="recupel"/> <PRNET index="21" name="netprice"/> <EANKRT index="22" name="ean"/> <MERKNL index="23" name="brandnl"/> <MERKFR index="24" name="brandfr"/> <FAMNL index="25" name="famnl"/> <FAMFR index="26" name="famfr"/> <COMOMSNL index="27" name="comdescrnl"/> <COMOMSFR index="28" name="comdescrfr"/> <PCOMSNL index="0" name="pcdescrnl"/> <PCOMSFR index="0" name="pcdescrfr"/> Vervolgens dient u stap 3 en 4 opnieuw uit te voeren om de gegevens binnen te halen. Pag. 9 / 11

10 Wanneer uitvoeren? Cebeo adviseert om elke dag de prijzen binnen te halen. Dat gebeurt bij voorkeur tussen 4u30 en 7u00, de meest prijsaanpassingen worden immers 's nachts doorgevoerd. Het volstaat om stap 3 en 4 uit te voeren. Stap 2 of manuele aanpassingen aan het exportconfig.xml bestand zijn enkel nodig als u de te importeren gegevens wenst te wijzigen. Hulp Hebt u hulp nodig bij stap 2, dan kan u hiervoor de Cebeo Helpdesk raadplegen op nummer: Pag. 10 / 11

11 Foutmeldingen en hun oplossingen Tijdens het binnenhalen van de lijst kunnen volgende foutmeldingen optreden. Stap 3: Error 503, service unavailable Mogelijk krijgt u in sommige gevallen een foutmelding in stap3. Tijdelijk kan de e-shop niet bereikbaar zijn door werkzaamheden. Wacht dan enkele uren en probeer later opnieuw. Blijft het probleem bestaan, neem dan contact op met de Cebeo Helpdesk op nummer Stap 3: Exception in thread main java.lang.outofmemoryerror Als er veel gegevens moeten worden binnengehaald, dan is het mogelijk dat er een OutOfMemoryError optreedt. Afbeelding 8 U kan dit oplossen door het bestand export.bat te openen en de regel: jre\bin\java -jar export.jar %1 %2 %3 %4 %5 %6 %7 %8 %9 te vervangen door jre\bin\java -Xms32m -Xmx512m -jar export.jar %1 %2 %3 %4 %5 %6 %7 %8 %9 Daarna voert u het bestand run.bat opnieuw uit. Pag. 11 / 11