Foodsam pris-xml. En standard til udveksling af priser mellem leverandør og grossister

Transkript

1 Foodsam pris-xml En standard til udveksling af priser mellem leverandør og grossister Log over versioner: Version 0.2: : Tilføjet chokoladeafgift og oprettet koder for afgifter Version 0.3: : Name antal max karakterer sat fra 35 til 50. 1

2 Eksempel på kode <?XML VERSION="1.0" ENCODING="ISO "?>" <ITEMLIST SU= " COUNTRY= [iso 3166] CURRENCY= [iso 4217] DATE= [DDMMYY] > <NO></NO> # Varenummer <EAN></EAN> <NAME></NAME> # Varenavn ift. landekoden <UNIT ></UNIT> # Vi sikrer at der kun eksisterer en handelsenhed <QTY></QTY> <IQTY></IQTY> <PRICE ></PRICE> # Decimaltal med mulighed for min. 2 decimaler. Punktum separerer fra heltal. <TAX CODE=[heltal]></TAX> # Decimaltal med mulighed for min. 2 decimaler. Punktum separerer fra heltal. Der kan være mellem 0 og mange taxes <CHANGE> <PRICE></PRICE> # Decimaltal med mulighed for min. 2 decimaler. Punktum separerer fra heltal. <PCT></PCT> # Decimaltal med mulighed for min. 3 decimaler. <AMOUNT></AMOUNT> # Forskel mellem nuværende og ny pris med 2 decimaler. Minus foran beløbet hvis beløbet er negativt. <COMMENT></COMMENT> # Ubegrænset tekstfelt til begrundelse for prisændringen. </CHANGE> </ITEMLIST> Beskrivelse Et item består af en række stamoplysninger, samt to grupperede sæt af oplysninger. Hver liste har som attribut en landekode (ISO 3166), hvor man kan aflæse hvilket sprog er gældende for filen (2 bogstaver). Date som beskriver hvornår prislisten er gældende fra, samt currency som beskriver den valuta som priserne er angivet i. Der benyttes ISO 4217 til at beskrive valutaen (3 Bogstaver). 2

3 Stamoplysninger Stamoplysningerne er følgende Øvrige oplysninger kan hentes i Foodsam XML. NO Tekst Altid Varenummeret på varen (20 karakterer) EAN Heltal Altid Varens EAN nummer (20 cifre) NAME Tekst (50 karakterer) Altid Varens navn. Sproget svarer til det i itemlist angivne landekode. UNIT 3 karakterer (kodet liste) Altid Varens handelsenhed. Oplysningen angives som i Foodsams XML standard. Det forudsættes at der kun er én handelsenhed pr. vare. QTY Heltal Altid Antallet af enheder i handelsenheden. Skal være mindst 1. IQTY Decimal Altid Antal i emballage enheden PRICE Decimaltal Altid Varens nuværende pris. Attributten currency angiver valutaen i form i formatet ISO Prisen er den samlede pris eksklusiv moms. Oplysningssættet TAXES I taxes angives alle relevante skatter og afgifter. Der er altid 1 element af typen TAXES. Der kan være mellem 1 og * elementer af typen tax. Hver kode må kun benyttes én gang. Afgifterne udgør en del af den samlede pris. Der er altid et element med koden 0, som kan indholde værdien 0 altså ingen afgifter. TAX Decimaltal Altid Den enkelte afgift. Attributten code (som benytter Skat s afgiftskoder) angiver hvilken afgift der er angivet. Koden 0 er afgifter i alt. 3

4 Oplysningssættet CHANGE Sættes bruges til at angive ændringen fra den hidtidigt gældende pris til den nye. Der er maksimalt 1 element af CHANGE. Er prisen ikke ændret fra den forrige prisliste angives et tomt element (<CHANGE />). PRICE Decimaltal Altid Den tidligere pris. Prisen er den samlede pris eksl. Moms. PCT Decimaltal Bør Ændringen i procent, kan være negativ. (3 decimaler) AMOUNT Decimaltal Bør Ændringen i beløb, kan være negativ. COMMENT Tekst En kommentar til ændringen (begrundelse) Koder for Taxes 1000: Emballageafgift 1010: Kaffeafgift 1020: Sukkerafgift 1030: Konfektureafgift 1040: Nøddeafgift 1050: Spiritusafgift 1060: Tobaksafgift 1070: Banderoleafgift 1080: Isafgift 1090: Chokoladeafgift 0: Sum af afgifter i alt 4

5 Eksempel: <?XML VERSION="1.0" ENCODING="ISO "?>" <ITEMLIST SU= " COUNTRU= DK CURRENCY= DKK DATE= > <NO> </NO> <EAN> </EAN> <NAME>Tørrede bananer i skiver</name> <UNIT >BG</UNIT> <QTY>12</QTY> <IQTY>4</IQTY> <PRICE >210.50</PRICE> # Decimaltal med mulighed for min. 2 decimaler. Punktum separerer fra heltal. <CHANGE> <PRICE>200.00</PRICE> <PCT>5.250</PCT> <AMOUNT>10.50</AMOUNT> <COMMENT>Generel prisstigning</comment> </CHANGE> <NO> </NO> <EAN> </EAN> <NAME>Carls special</name> <UNIT >CS</UNIT> <QTY>1</QTY> <IQTY>30</IQTY> <PRICE >109.95</PRICE> # Decimaltal med mulighed for min. 2 decimaler. Punktum separerer fra heltal. <CHANGE /> </ITEMLIST> 5