Vernieuwing 09.04 Materiaalplatform, Cebeo, Import rev.0
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
Vernieuwing 09.04 Materiaalplatform, Cebeo, Import rev.0
Klant worden, Om klant te worden of een e-shop account aan te vragen kan u terecht op de Cebeo website: www.cebeo.be, 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: www.cebeo.be, 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 ( 056 – 36 47 20 ) 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
Vernieuwing 09.04 Materiaalplatform, Cebeo, Import rev.0
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 http://b2b.cebeo.be/export 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
Vernieuwing 09.04 Materiaalplatform, Cebeo, Import rev.0
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
Vernieuwing 09.04 Materiaalplatform, Cebeo, Import rev.0
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 300.000 materialen. Het is sterk aanbevolen hier een waarde lager dan 30000 (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 Contract History History+Stock
–
Own reference
= Alle artikelen worden dan overgebracht. = Alle artikelen waarvoor u een contract hebt bij Cebeo. = Alle artikelen die u de laatste 4 jaar bestelde bij Cebeo. = Alle artikelen die u de laatstet 4 jaar bestelde bij Cebeo en alle artikelen op stock bij Cebeo. = 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 02 03 04 05 06 07 08 09 10 11 12
= Huishoudapparaten / Ménager = Installatiemateriaal / Installation = Industrie = Technische verlichting / Eclairage technique = Kabel, draad & koper / Fils & cables = Audio & video = Netwerken / Réseaux informatiques = Verwarming / Chauffage = Witgoed / Gros blanc = Electronica / Electronique = Domotica / Domotique = Architecturale verlichting / Eclairage architecturale
Pag. 5 / 11
Vernieuwing 09.04 Materiaalplatform, Cebeo, Import rev.0
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 77 238
= NIKO = KOPEREN STAVEN EN DRAAD/BARES MEPLATS ET FIL DE CUIVRE = 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 B C
= In alle depots gebruikelijke op stock. = In het hoofddepot gebruikelijk op stock. = 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 http://b2b.cebeo.be/export , nadat u uw logingegevens heeft ingevoerd. Een andere mogelijkheid is dat u contact opneemt met de Cebeo helpdesk ( 056 – 36 47 20 ), zodat zij samen met u een exportConfig.xml bestand kunnen opmaken.
Pag. 6 / 11
Vernieuwing 09.04 Materiaalplatform, Cebeo, Import rev.0
Stap 3: ophalen lijst. Het ophalen van de lijst kan met het programma “Run.bat”, aanwezig in de folder “C:\CebeoExport”.
Afbeelding 5 Stap 4: importeren lijst. 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 10.000 materiaalitems te importeren afhankelijk van de snelheid van uw computer. Belangrijk: Voer geen aanpassingen uit aan de materiaalbibliotheek tijdens het importeren.
Pag. 7 / 11
Vernieuwing 09.04 Materiaalplatform, Cebeo, Import rev.0
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
Vernieuwing 09.04 Materiaalplatform, Cebeo, Import rev.0
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:
moet worden:
Waarbij de getallen 27 en 28 cijfers moeten zijn opvolgen op de vorige regels. Bijvoorbeeld:
<SGKDAR index="9" name="SubGamme"/> <SKKDAR index="11" name="StockCode"/> <EHMVAR index="12" name="UnitOfMeas"/> <EHVGAR index="14" name="UnitPack"/> <SABAAR index="18" name="Sabam"/> <ECOTAR index="19" name="Ecotax"/> <EANKRT index="22" name="EAN"/> <MERKNL index="23" name="BrandNl"/> <MERKFR index="24" name="BrandFr"/> Vervolgens dient u stap 3 en 4 opnieuw uit te voeren om de gegevens binnen te halen.
Pag. 9 / 11
Vernieuwing 09.04 Materiaalplatform, Cebeo, Import rev.0
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: 056 – 36 47 20
Pag. 10 / 11
Vernieuwing 09.04 Materiaalplatform, Cebeo, Import rev.0
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 056 – 36 47 20. 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