DABAS Update Produktblad 2012-11-13 1
Innehåll Innehåll... 2 Inledning... 3 Hur kommer man igång?... 3 Meddelandeadressering... 4 Meddelande... 5 Meddelandekvittens... 5 Exempel på NACK:... 6 Exempel på ACK:... 7 Meddelandets identifierare... 7 Frågor?... 7 2
Inledning DABAS Update är en tilläggstjänst som ger er möjlighet att koppla samman ert affärssystem/artikeldatabas med Dabas och skicka in artikelinformation via XML direkt till Dabas utan manuell inmatning. Den stora fördelen med tjänsten för uppgiftslämnare är att artikelinformation bara behöver uppdateras på ett ställe, vilket ger tidsbesparing och högre kvalitet då risken för fel minskar. Formatet på filerna är aktuell version av GS1s artikelinformation i XML-format. Informationen i databasen kan därefter, vid behov, kompletteras/rättas online via DABAS uppgiftslämnarprogram. Hur kommer man igång? Kontakta Delfi Marknadspartner och diskutera förutsättningarna för att integrera ert system med Dabas för att kunna skicka artikelinformation via fil. Delfi erbjuder ett etableringsprojekt innan tjänsten Dabas Update tecknas där kunden och vi tillsammans går igenom alla förutsättningar, säkerställer att all nödvändig information finns, att filerna följer rätt tekniska format och sätter upp kommunikationen mellan Dabas och ert egna system. Delfi hjälper er att komma igång! Hämta artikelinformationsspecifikationen på GS1s hemsida (www.gs1.se) Ta fram filer ur ert egna system i enlighet med ovanstående specifikation Fyll i dokumentheadern för xml-meddelandet enligt anvisning nedan (se avsnitt Meddelandeadressering nedan) Validera filen mot GS1s xml-scheman Skicka ett antal testfiler till DABAS verifieringsmiljö och verifiera att integrationen och transaktionen fungerar. Efter att tester har genomförts och allt fungerar är ni redo att skicka in era filer till Dabas produktionsmiljö. Varje sändning följs av ett kvitto/valideringsresultat som skickas till den e-mailadress som angivits i e-postmeddelande till Delfi Marknadspartner för verifieringsmiljö och till den adress som angivits som företagets e-postadress under Företagsuppgifter i uppgiftslämnarprogrammet för Dabas. 3
Eventuella fel och brister (utifrån valideringsresultatet) kan sedan rättas online via DABAS (www.dabas.com), eller så får man rätta internt och skicka om informationen. (OBS, att man till DABAS alltid skickar fullständig information, som läser över tidigare information i DABAS) Efter verifiering skickar Delfi Marknadspartner en adress mot vilken meddelandet pekas om, så att meddelanden kan skickas in till produktionsmiljö, DABAS (www.dabas.com). Därefter är man igång! Meddelandeadressering Meddelandet inleds med en header som innehåller samtlig information nödvändig för att det ska nå önskad mottagare. Denna header följer UNECEs formatstandard för xml-dokument som går att hämta på GS1s hemsida. För att meddelandet skall nå DABAS bör följande värden fyllas : Sender/Identifier skall vara avsändarens(uppgiftslämnarens) GLN, så som det är registrerat i DABAS. Receiver/Identifier skall vara DABAS i klartext. Denna information används av EDI-växeln för att skicka meddelandet vidare till DABAS-applikationen. DocumentIdentification/InstanceIdentifier skall vara en unik identifierare för meddelandet. Observera att identifieraren måste vara globalt unikt (Globally Unique Identifier - GUID) genererad i det avsändande systemet. DocumentIdentification/Type skall vara BatchUpd DocumentIdentification/CreationDateAndTime skall vara tidsangivelse för sändning från avsändande system. Exempel på hur en meddelandeheader skall se ut: <sh:standardbusinessdocumentheader> <sh:headerversion>1.0</sh:headerversion> <sh:sender> <sh:identifier Authority="EAN.UCC">7211310056685445 </sh:identifier> </sh:sender> <sh:receiver> <sh:identifier Authority="EAN.UCC">DABAS </sh:identifier> </sh:receiver> <sh:documentidentification> <sh:standard>ean.ucc</sh:standard> <sh:typeversion>2.2</sh:typeversion> <sh:instanceidentifier>2b22c3ef-c7bd-4953-8784- 39ab03c54825</sh:InstanceIdentifier> <sh:type>batchupd</sh:type> 4
<sh:creationdateandtime>2009-12- 02T11:22:14.6041894+01:00 </sh:creationdateandtime> </sh:documentidentification> </sh:standardbusinessdocumentheader> Meddelande Varje meddelande förses med en åtgärdstyp som anger vad som skall vidtas med artikelinformationen. Denna åtgärstyp kan innehålla följande värden: Ny artikel ADD Radering av artikelinformation DELETE Ändrad artikel/ingen förändring CHANGE_BY_REFRESH Korrigering av artikelinformation CORRECT Vid användning av koden ADD förutsätts att artikeln skall skapas som ett nyupplägg i DABAS. Koderna CHANGE_BY_REFRESH och CORRECT har samma betydelse och innebörd I DABAS. Stödet för de båda koderna finns för att system som integrerar Validdoo skall fungera med transperens. Vid användning av dessa båda koder förutsätts att artikeln, d v s GTIN finns i DABAS register sedan tidigare. Lika så när koden DELETE används, förutsätts att artikel med inskickat GTIN finns registrerad sedan tidigare i DABAS databas. Åtgärdstypen anges i elementet documentcommandheader, på följande ställe i xml-strukturen: <eanucc:message> <eanucc:transaction> <entityidentification> <uniquecreatoridentification>c3358c43-e3ae-4ab4-9320- C1D8322EB7B3</uniqueCreatorIdentification> <contentowner> <gln>7510962000013</gln> </contentowner> </entityidentification> <command> <eanucc:documentcommand> <documentcommandheader type="add"> Meddelandekvittens Ett kvitto/valideringsresultat för försändelsen skickas till den e-postadress som finn registrerad för uppgiftslämnaren (administreras i DABAS under följande menyval: Systemunderhåll/Uppgiftslämnare). 5
Kvittensen skickas i form av ett e-postmeddelande, i vilket meddelandetexten innehåller information om försändelsen. En kvittens skickas både för meddelanden som går igenom(ack) utan anmärkning och för meddelanden som innehåller felaktigheter(nack). Observera att en försändelse kan generera ett ACK om artikeln sparas OK i DABAS och dessutom ett NACK om artikeln innehåller varningar. Alltså kan en försändelse generera två meddelandekvittenser. Exempel på NACK: Valideringsrapport från DABAS Kräftor 063100474239 Varningar: 3 Fel: 0 Warning Produktgruppsindelning måste anges Warning Förpackningsmaterial kod och Förpackningsmaterial vikt är obligatoriskt förutom när: Alternativ 1: Avgift erlagd för förp.material t.ex REPA. Alternativ 2: Emballaget är returnerbart Alternativ 3: Aktuell artikel har Förpacknings-/kollityp kod = NE/Oförpackad Warning Djup (T4018) är alltid större än eller lika med en artikels bredd (T4017) för en icke konsumentartikel. Kräftor 063100474239 Varningar: 2 Fel: 0 Warning Om och endast om en artikel är beställningsbar, så skall artikeln också vara fakturerbar Warning Förpackningsmaterial kod och Förpackningsmaterial vikt är obligatoriskt förutom när: Alternativ 1: Avgift erlagd för förp.material t.ex REPA. Alternativ 2: Emballaget är returnerbart Alternativ 3: Aktuell artikel har Förpacknings-/kollityp kod = NE/Oförpackad Kräftor 063100474239 Varningar: 3 Fel: 0 Warning Toppnivåns kan bara vara beställningsbar om den är en exponeringsenhet. Warning Toppnivåns "Listpris" får endast anges om det är en exponeringsenhet. Warning Om och endast om en artikel är beställningsbar, så skall artikeln också vara fakturerbar. UniqueCreatorIdentification: 55D19DA7-B220-4D61-AEB8-EF61A4488E07 6
Exempel på ACK: STATUS OK. UniqueCreatorIdentification: 55D19DA7-B220-4D61-AEB8-EF61A4488E07 Meddelandets identifierare Det som knyter inskickat meddelande till respektive kvittens är fältet UniqueCreatorIdentification. Detta fält skickas i xml på följande sätt: <eanucc:message> <entityidentification> <uniquecreatoridentification>84628d51-3414-420f-b241-8f063f6265ab </uniquecreatoridentification> och det är alltså informationen i detta fält som skickas med ut i kvittensen efter rubriken UniqueCreatorIdentification (se avsnit Exempel på NACK ovan) Frågor? För frågor eller mer information, vänligen kontakta oss: Delfi MarknadsPartner AB, Box 6620, 113 84 Stockholm Tel: 08-52 22 43 00 eller info@delfi.se 7