Den digitala affären Filspecifikation - 2014-05-19
Revisionshistorik Datum Ver. Namn Kommentar 2014-02-10 1.0 Anders Bergström, Ninetech Första version. 2014-03-17 1.1 Anders Bergström, Ninetech Specificerat hur ofta fil ska skickas till EEL. 2014-05-19 1.2 Anders Bergström, Ninetech Lagt till kap. 2.2.1 Visningsexemplar. Uppdaterat text om användningsområden för lagersaldoinfo från butik. 2 (7)
Innehållsförteckning 1 Sammanfattning... 4 2 Hantering... 5 2.1 Flöde... 5 2.2 Inkluderade artiklar... 5 2.2.1 Visningsexemplar... 5 2.3 Filnamn... 5 3 Filspecifikation... 6 3.1 Inventory... 6 3.2 CustomerGroup... 6 3.3 Stores... 6 3.4 Store... 6 3.5 Articles... 6 3.6 Article... 6 3.7 Supplier... 6 4 Exempelfil... 7 3 (7)
1 Sammanfattning Detta dokument beskriver struktur och innehåll för den lagersaldofil som kontinuerligt skickas till EEL från butiksdatasystem. Detta ska skickas till EEL var femte (5:e) minut för att kunna hålla så korrekt och uppdaterad data som möjligt i EEL:s centrala system. Informationen används t.ex. till att informera webbkunder om en artikel finns på lager i en specifik butik. 4 (7)
2 Hantering 2.1 Flöde Butiksdatasystem skickar en fil per kundgrupp till EEL via FTP. Leverantör av butiksdatasystem får av EEL en tilldelad sökväg till FTP-katalog där fil ska sparas. Filen ska skickas var femte (5:e) minut. 2.2 Inkluderade artiklar Filen ska innehålla lagersaldo för alla artiklar som skickats ner till butiksdatasystem via EEL:s artikelkatalog (utom visningsexemplar, se eget avsnitt nedan). Notera att även artiklar med annan leverantör än EEL ska inkluderas i filen. Endast artiklar där lagersaldo förändrats sedan föregående fil ska skickas varje gång. 2.2.1 Visningsexemplar Visningsexemplar ska ej vara säljbara på webben och ska därför i BDS sättas (manuellt) till en separat lagertyp som inte skickas upp till EEL från BDS i lagersaldofilen. Visingsexemplar prissätts och säljs endast lokalt i butik. 2.3 Filnamn Filnamn genereras enligt följande format: Inventory_{yyyy-MM-dd HH.mm.ss.ffff}.xml Ex: Inventory _2014-02-10 15.00.00.0000.xml Butiksdatasystem ansvarar för att kontrollera att filnamn inte redan existerar på FTP, nytt filnamn ska då genereras så att inte någon fil skrivs över. 5 (7)
3 Filspecifikation 3.1 Inventory CustomerGroup Komplex typ Information vilken kundgrupp som butikerna i filen tillhör. Stores Komplex typ Lagersaldon per butik. 3.2 CustomerGroup Number Int Kundgruppens nummer. 1 - Elon 2 - Elkedjan Name String Kundgruppens namn. 3.3 Stores Store Komplex typ Butiksinformation. 3.4 Store Name String Butikens namn. GLN String Butikens GLN. Articles Komplex typ Lagersaldo per artikel. 3.5 Articles Article Komplex typ Artikelinformation. 3.6 Article Description String Artikelbeskrivning. EAN String EAN-kod. SupplierArticleNumber String Leverantörens T.ex. EEL, Electrolux. artikelnummer. Supplier Komplex typ Leverantörsinformation TotalQuantity Int Totalt lagersaldo. Totalt lagersaldo, inkl. reserverade. AvailableQuantity Int Disponibelt lagersaldo. Ej reserverade, går att sälja. 3.7 Supplier Name String Leverantörens namn. GLN String Leverantörens GLN. T.ex. EEL, Electrolux. 6 (7)
4 Exempelfil <Inventory> <CustomerGroup> <Number>1</Number> <Name>Elon</Name> </CustomerGroup> <Stores> <Store> <Name>Elon Bålsta</Name> <GLN>7340089510360</GLN> <Articles> <Article> <Description>30B MULTI BLS COMBI PACK</Description> <EAN>4210201072737</EAN> <SupplierArticleNumber>301152</SupplierArticleNumber> <Supplier> <Name>Elon Elkedjan Logistic AB</Name> <GLN>7350023160001</GLN> </Supplier> <TotalQuantity>10</TotalQuantity> <AvailableQuantity>8</AvailableQuantity> </Article> <Article> <Description>Rengöring KeyPart - CCR3 Refil</Description> <EAN>4210201382355</EAN> <SupplierArticleNumber>300488</SupplierArticleNumber> <Supplier> <Name>Elon Elkedjan Logistic AB</Name> <GLN>7350023160001</GLN> </Supplier> <TotalQuantity>0</TotalQuantity> <AvailableQuantity>0</AvailableQuantity> </Article> </Articles> </Store> <Store> <Name>Elektrohuset Elon Skövde</Name> <GLN>7340089510124</GLN> <Articles> <Article> <Description>Rengöring KeyPart - CCR3 Refil</Description> <EAN>4210201382355</EAN> <SupplierArticleNumber>300488</SupplierArticleNumber> <Supplier> <Name>Elon Elkedjan Logistic AB</Name> <GLN>7350023160001</GLN> </Supplier> <TotalQuantity>5</TotalQuantity> <AvailableQuantity>5</AvailableQuantity> </Article> </Articles> </Store> </Stores> </Inventory> 7 (7)