GS1 Data Source Handleiding afnemer-interface Datum: 24 juni 2015, versienummer 3.2.0

Transcriptie

1 GS1 Data Source Handleiding afnemer-interface Datum: 24 juni 2015, versienummer 3.2.0

2 Inhoud 1 GS1 Data Source afnemer-interface Inloggen Aanmaken abonnementen Mijn artikelen GS1 NL Catalogus Levensmiddelen en Drogisterij Data ontvangen via een beveiligde verbinding 10 2 Versiebeheer en contact 11

3 Inleiding In deze korte handleiding vertellen wij hoe u aan de slag kunt met de GS1 Data Source interface voor dataontvangers. Bekende issues De tool is nog in ontwikkeling en er zijn enkele zaken die nog niet naar behoren werken. De naam van de dataleverancier wordt in de lijst met abonnementen nog niet weergegeven, alleen de GLN van die leverancier. Ook is de functionaliteit van de interface nog enigszins beperkt, we zijn in overleg met de leverancier om deze uit te breiden. We zijn ons bewust van bovenstaande issues en werken aan een oplossing. Vragen? Mocht u nog vragen hebben dan kunt u contact opnemen met onze Customer Support afdeling. Deze is te bereiken op werkdagen op of via info@gs1.nl. All contents copyright GS1 Nederland 24 juni

4 1 GS1 Data Source afnemer-interface 1.1 Inloggen U kunt inloggen met de aan u verstrekte gegevens via dit toegangsscherm: Figuur 1.1: inlogscherm afnemer-interface Vul hier uw gebruikersnaam, GLN en wachtwoord in. Nadat u bent ingelogd komt u binnen op het Dashboard van de afnemer-interface. Hier vindt u een aantal algemene kenmerken over uw dataset. Figuur 1.2: Dashboard afnemer-interface N.B. Als u voor het eerst inlogt dan is de catalogus nog leeg omdat er nog geen abonnementen zijn aangemaakt. All contents copyright GS1 Nederland 24 juni

5 1.2 Aanmaken abonnementen Het GDSN netwerk werkt op basis van artikelberichten die aan een afnemer worden verstuurd. Er is daarvoor van twee kanten een actie nodig: een publicatie van de leverancier en een subscriptie/abonnement van de afnemer. Pas als die beiden er zijn wordt de data verzonden. In hoofdstuk 1.6 vindt u voorbeeld brieven om uw leveranciers te benaderen om de gegevens aan u te gaan publiceren. Ga voor het aanmaken van abonnementen naar het menu-item Abonnement lijst. Figuur 1.3: Locatie menu-item Abonnement lijst Ook dit scherm is leeg als u voor het eerst inlogt, omdat er nog geen abonnementen zijn aangemaakt. Het aanmaken van abonnementen kan op verschillende niveaus/combinaties. Het meest algemene abonnement is dat op de doelmarkt. U ontvangt bij dit abonnement alle artikelberichten die aan uw GLN óf aan de doelmarkt zijn gepubliceerd. Dit betekent dat er mogelijk artikelen bijzitten van leveranciers waarmee u geen zaken doet of van sectoren waarin u niet actief bent (bijvoorbeeld de doe-het-zelf sector). Om deze reden adviseren wij om per leverancier een abonnement in te stellen, gecombineerd met de Target Market Nederland. Vult u geen Target Market in bij de leverancier dan ontvangt u de gegevens van alle markten. Let op dat grote leveranciers (zoals Unilever) veel gegevens kunnen bevatten. De verschillende velden in de pop-up zijn: Informatieleverancier Doelmarkt GPC (Global Product Classification) De leverancier die artikelgegevens aan u gepubliceerd heeft. Vul hier de GLN (adrescode) in. De markt waarvoor de gegevens bedoeld zijn. Dit is in principe altijd Nederland. Dit veld moet altijd ingevuld worden. U kunt zich abonneren op bepaalde delen uit All contents copyright GS1 Nederland 24 juni

6 Artikel (GTIN) Tabel 1.1: Velden in de afnemer-interface met uitleg het assortiment, door een GPC-code in te vullen. Dit wordt meestal leeg gelaten. U kunt zich abonneren op specifieke artikelen uit het assortiment, door een GTIN in te vullen. U ontvangt dan alleen de gegevens van dat artikel. Dit wordt meestal leeg gelaten. U kunt een nieuw abonnement (subscription) aanmaken door op het blauwe plusteken te klikken. Dan verschijnt het volgende pop-up scherm. Figuur 1.4: Pop-up scherm bij het aanmaken van nieuwe abonnementen In dit pop-up scherm kunt u de verschillende parameters invullen. Het aankruisvakje RFCIN wordt gebruikt om gegevens opnieuw te laten versturen. Dit kan een grote hoeveelheid berichten genereren en moet daarom altijd leeg gelaten te worden. Op dit moment is de uitklaplijst met GLN s nog niet gevuld. U kunt hier zelf een GLN invullen. De lijst met GLN s van GS1 Data Source deelnemers kunt u hier vinden. Nadat de abonnementen zijn aangemaakt zullen de gegevens vanuit de datapool verstuurd worden. De gegevens worden zichtbaar in de mijn Artikelen lijst, daarnaast worden ze ook verstuurd via de AS2 of SFTP verbinding. Normaal gesproken worden nieuwe gegevens een keer per uur verstuurd. NB. Het aanmaken abonnementen kan ook vanuit de catalogus GS1 NL Levensmiddelen en drogisterij. Zie het betreffende hoofdstuk voor meer informatie. All contents copyright GS1 Nederland 24 juni

7 1.3 Mijn artikelen Alle aan u gepubliceerde items verschijnen in Mijn artikelen. Figuur 1.5: Mijn artikelen Automatische validaties Door de Afnemerinterface wordt een aantal automatische validaties op de gegevens uitgevoerd. Wanneer een artikel niet aan deze validaties voldoet zal automatisch een retourbericht aan de leverancier worden verzonden met daarin waarschuwing of een foutmelding(en). In de interface krijgt het artikel de status (Item state) Beoordeel. All contents copyright GS1 Nederland 24 juni

8 Zolang het item de status Beoordeel en er is spraken van een fout (ERROR) heeft zal het niet als XML-bestand via AS2 of SFTP worden aangeboden. Op die manier ontvangt u als data-ontvanger alleen gevalideerde gegevens. Als er alleen een waarschuwing (WARNING) is gegeven worden de gegevens wel doorgezonden. De status in de interface is dan Beoordeel, Gesynchroniseerd. Zodra de leverancier de gegevens heeft gecorrigeerd, wordt een nieuwe versie van het artikel verzonden. Als dit wel aan alle validaties voldoet zal het ook als XML-bericht beschikbaar zijn. De status zal dan veranderen in Gesynchroniseerd. 1.4 GS1 NL Catalogus Levensmiddelen en Drogisterij Er is met name voor groothandels een openbare catalogus toegevoegd GS1 NL Catalogus Levensmiddelen en Drogisterij. Hieraan kunnen leveranciers van merkartikelen hun gegevens publiceren, zodat ze voor (potentiële) afnemers inzichtelijk zijn, zonder dat die een abonnement op de gegevens hoeven te hebben. De catalogus is zichtbaar als optie in de bovenbalk. U kunt hier gegevens inzien die zijn gepubliceerd aan de doelmarkt of aan de GLN van de catalogus ( ). In de catalogus heeft u dezelfde zoekmogelijkheden als in uw eigen catalogus. Daarnaast kunnen de artikelen als PDF of Excel-bestand worden gedownload. In deze catalogus is het ook mogelijk om abonnementen aan te maken. Als u een artikelen selecteert en op het blauwe plusteken drukt dan verschijnt een pop-up waarin een aantal gegevens al vooraf ingevuld zijn: All contents copyright GS1 Nederland 24 juni

9 Standaard zijn alle gegevens van de betreffende GTIN al ingevuld, inclusief GPC en GTIN. Als u een abonnement op de GLN en Doelmarkt wilt aanmaken dan kunt u de GPC en GTIN verwijderen. Als u een abonnement heeft aangemaakt ontvangt u de gegevens als XML-bestand indien de leverancier aan de aan de Doelmarkt of aan uw GLN heeft gepubliceerd Zoekmogelijkheden en iconen In de interface zijn er verschillende zoekmogelijkheden. Bij Snel zoeken kunt u zoeken op tekst of getallen (bijv. GTINS). U kunt een * (sterretje) als wildcard gebruiken. Bij Geavanceerd zoeken kunt u op de inhoud van de verschillende velden zoeken. U kunt een zoekactie opslaan door bij Zoekprofielen op het diskette icoon te drukken en een naam op te geven. In de bovenbalk van de interface staan enkele iconen. Deze worden hieronder toegelicht. Het artikel inzien. U opent het artikel en ziet nagenoeg dezelfde interface als de leverancier. Deze bevat namelijk de velden die voor de Nederlandse markt zijn afgesproken. Via dit icoon kunt u de leverancier feedback geven over het artikel als u fouten constateert. Een artikel weigeren (reject). Er worden niet langer updates over dit artikel verstuurd. Een geweigerd artikel opnieuw activeren. Er zullen weer updates over dit artikel verstuurd worden. De geschiedenis van een artikel bekijken. All contents copyright GS1 Nederland 24 juni

10 Een download van één of meer artikelen maken in Excel of als PDF bestand. Alle rijen op alle pagina s selecteren. U kunt hiermee een complete download in Excel maken. Let op: wanneer er geen selectie wordt gemaakt kan dit bestand erg groot worden. De lay-out opslaan. Als u wijzigingen in bijv. de volgorde van kolommen heeft aangebracht dan blijven deze bewaard, ook wanneer u heeft uitgelogd. Tabel 1.2 Toelichting iconen bovenbalk 1.5 Data ontvangen via een beveiligde verbinding De gegevens worden als XML-berichten voor de dataontvanger gegenereerd. Deze kunnen op twee manieren aan de ontvanger beschikbaar worden gesteld: via Secure FTP (SFTP) of via AS2. Afhankelijk van uw set-up zult u een van beide protocollen moeten inrichten: SFTP Voor het ophalen van de CIN-berichten kan bijv. een programma als Filezilla ( worden gebruikt. Als u dit inregelt met de inloggegevens die u hiervoor heeft ontvangen, dan kunt u uit de map Outgoing de bestanden downloaden. Standaard zijn de login gegevens als volgt opgebouwd: Gebruikersnaam: uw GLN Wachtwoord: Wordt toegestuurd Adres: sftp-eu.1worldsync.com Poort: 5000 AS2 Met behulp van het AS2 Protocol worden de data naar de afnemer verzonden. Hiervoor zijn verschillende programma s beschikbaar. Een voorbeeld hiervan is RSS Bus: ( Dit pakket is gratis als het wordt gebruikt met één handelspartner. Structuur XML bestand Meer informatie met betrekking tot de XML-bestanden kunt u vinden op: LET OP: In mei 2016 vindt er een Major Release plaats in het GDSN netwerk. De standaard zal dan veranderen van versie 2.8 in versie 3.1. De structuur van het bericht verandert sterk met deze update. Dit heeft consequenties voor bestaande en nieuwe implementaties. Zo zullen onder andere mappingen en dergelijke aangepast moeten worden. All contents copyright GS1 Nederland 24 juni

11 2 Versiebeheer en contact Datum Versie Gewijzigd door Wijzigingen Sjoerd Schaper Eerste publicatie Sjoerd Schaper Sjoerd Schaper Sjoerd Schaper Toevoeging m.b.t. automatische contoles Aanpassing als gevolg van de nieuwe release Toevoeging m.b.t. abonnementen, voorbeeldbrieven en Major Release De tekst uit deze publicatie mag zonder toestemming vooraf worden verveelvoudigd op voorwaarde dat de bron wordt vermeld. Hoewel alle zorg is betracht om te garanderen dat de inhoud van dit document juist is, kan GS1 Nederland niet aansprakelijk worden gehouden voor fouten of ontbrekende gegevens in deze publicatie. Neem bij vragen over de inhoud van deze publicatie contact op met de Customer Support van GS1 Nederland. Deze is bereikbaar via telefoonnummer of door een te sturen aan info@gs1.nl. All contents copyright GS1 Nederland 24 juni

12 Click here to enter text. All contents copyright GS1 Nederland 24 juni