Rabattavtale XML Brukerdokumentasjon Versjon: 1.0 - Side 1 of 9 -
ENDRINGSKATALOG DATO VER UTFØRT AV KOMMENTARER 30.10.2004 4.0 Truls Samuelsen Versjon 4.0. - Side 2 of 9 -
Innholdsfortegnelse 1. INNLEDNING 4 2. GENERELLE RETNINGSLINJER 4 2.1 FORKLARING TIL TABELLENE 4 3. KOMMENTARER TIL FELTENE 5 3.1 VAREMRK 5 3.2 VARENR 5 3.3 AVTPRIS 5 3.4 SELVKOSTBEREGNINGS-MODELL/REKKEFØLGE: 5 4. MELDINGEN 7 4.1 ENVELOPE 7 4.2 RABATTAVTALE 7 - Side 3 of 9 -
1. Innledning EFONELFO Rabattavtale XML består av følgende: En Konvolutt med informasjon om avsender og mottaker av meldingen(e) En eller flere Rabattavtaler med en Rabattavtale i hver melding En hodepost med overordnet informasjon for en Rabattavtale En eller flere linjeposter med basisdetaljer og eventuelt fritekstlinjer En Sumlinje med totaler 2. Generelle retningslinjer Filnavn skal alltid begynne med XR4. Karaktersett: ISO 8859-1 (inkluderer norske tegn) Desimaltegn: Punktum Tomme elementer er ikke tillatt. Dataformat A = Alfanumerisk (alle tegn er tillatt). N = Numerisk tallverdi (kun tegn fra og med 0 til og med 9 er tillatt samt punktum som desimaltegn er tillatt)). D = ÅÅÅÅ-MM-DD (2004-12-01 =1. desember 2004). DT = ÅÅÅÅ-MM-DD-THH:MM:SS (20041201T16:00:00) =1. desember 2003 klokken 16 00 ) 2.1 Forklaring til tabellene Tag/attributt navn Beskivelse/Bruk EFO Flatfil Bruk Type Lengde logisk, forklarende navn på det aktuelle elementet. angir regler for utfylling, lovlige verdier mm. angir om feltet er Må = Feltet må alltid være med og ha en verdi. Kan = Feltet kan utelates. A = Alfanumerisk (alle tegn unntatt semikolon er tillatt). N = Numerisk tallverdi (kun tegn fra og med 0 til og med 9 er tillatt samt punktum som desimaltegn er tillatt). D = ÅÅÅÅ-MM-DD (2004-12-01 =1. desember 2004). DT = ÅÅÅÅ-MM-DD-THH:MM:SS (20041201T16:00:00) =1. desember 2003 klokken 16 00 ) Feltets maksimale lengde. Der feltet også har en minimumslengde fremkommer dette av kommentarfeltet, eller av feltets type. (Dato vil for eksempel alltid være på 10 tegn). - Side 4 of 9 -
3. Kommentarer til feltene 3.1 VareMrk Se beskrivelse av VareMrk i vareformatet. Bruk VareMrk 9=Tilleggsvare for å spesifisere avgifter som gjelder for hele ordrebekreftelsen. 3.2 VareNr Feltet benyttes for unik identifikasjon av produktet/rabattgruppe innen angitt kodesystem (VareMrk). Kombinasjonen PostType + VareMrk + VareNr skal være unik i filen. 3.3 AvtPris Pris er oppgitt i forhold til PrisEnhet for angitt varenummer. Tekst Beskrivende tekst, bør fylles ut, men kan være blank. Forståelse av beregningsmodellen for rabattavtale/selvkost En rabatt eller pris kan gis på flere nivåer. Hvis man finner en AvtaltPris i rabattfilen, brukes denne, og ikke prisgrunnlag fra Vareformatet, som grunnlag for evt. videre rabattberegning. Finnes ingen AvtaltPris, bare en rabattsats, brukes denne rabattsatsen og prisgrunnlag fra Vareformatet i kostprisberegning. Se likevel forbehold mht. prisgrunnlag og pristypefelt i Vareformat. 4 Prisgrunnlag fra Vareformatet: Pris i Vareformatet minus evt. rabatt i Vareformatet gir prisgrunnlaget, under forutsetning av at pristypefeltet i Vareformatet = B eller blank. Hvis pristypefeltet = N skal rabatt fra rabattavtalen ikke anvendes. Prinsippet for Varefil gjelder også for Pristilbud. 3.4 Selvkostberegnings-modell/rekkefølge: - Side 5 of 9 -
- Side 6 of 9 -
4. Meldingen 4.1 Envelope Tag/attribytt navn Beskivelse/Bruk EFO Flatfil Bruk Type Lengde Bestilling Må Hode Må InterchangeID Unik referanse for denne utvekslingen Kan A 10 Til Unik identifisering av endelig mottaker av meldingen(e) i utvekslingen, for eksempel Må A 14 org.nummer Fra Unik identifisering av avsender, for eksempel org.nummer Må A 14 Dato Dato utvekslingen ble generert. (YYYY-MM-DDTHH:MM:SS) Må DT 19 AntallMeldinger Totalt antall meldinger i denne utvekslingen Må A 4 Melding Inneholder meldingen(e). Må 4.2 Rabattavtale Tag/attribytt navn Beskivelse/Bruk EFO Flatfil Bruk Type Lengde Rabattavtale Må Versjon Versjonsnummer på format X.Y. Alltid lik '4.0' Versjon Må A 3 ProdusertDato Dato meldingen er produsert Format = YYYY-MM-DDTHH:MM:SS Må DT 19 Eier Alltid 'EFONELFO' Format Må A 8 Hode Må KjopersKundenummer Kjøpers kundenummer, oppgitt av selger. Fylles ikke ut ved generell varefil. KundeNr Kan A 10 FraDato Dato avtalen gjelder fra. Format: ÅÅÅÅ-MM-DD. Den dato filen er produsert. FraDato Må D 10 TilDato Dato avtalen gjelder til. Format: ÅÅÅÅ-MM-DD TilDato Kan D 10 Valuta Valutakode jfr. ISO 4217. Eks: NOK=Norske kroner Valuta Må A 3 AvtaleID Identifikasjon av denne varefilen, f.eks tilbudsnr. Kan refereres til i en bestilling. AvtaleID Kan A 10 Selger Inneholder basisinformasjon om selger Må ID Selgers foretaksnummer SelgersID Må A 14 Navn Selgers firmanavn SFirmaNavn Kan A 35 Adresse Selgers postadresse Kan - Side 7 of 9 -
Adresse1 Selgers aressefelt1 SAdr1 Kan A 35 Adresse2 Selgers dressefelt2 SAdr2 Kan A 35 PostNummer Selgers pstnummer SPostNr Kan A 9 PostSted Selgers pststed SPostSted Kan A 35 LandKode Selgers landkode, jfr ISO 3166. Eks: "NO"=Norge SLandK Kan A 2 Kjoper Inneholder basisinformasjon om kjøper Kan ID Kjøpers foretaksnummer KjøpersID Kan A 14 Linjer Linje Varemerknad Varemerknad 0=Ukjent, 1=Elnummer, 2=EAN, 3=Produsentens varenr, 4=NRF nummer. VareMrk Må A 1 Varenummer Varenummer i.h.t Varemerknad VareNr Må A 14 Varebetegnelse Varebetegnelse (produktets handelsbetegnelse) VaBetg Må A 30 Varebetegnelse2 Utfyllende varetekst til Varebetegnelse VaBetg2 Kan A 30 MaleEnhet Egenskap ved varen som angir enhet for oppmåling av en installasjon. Lovlige verdier: MåleEnhet MÅ N 1 1=stykk, 2=meter, 3=liter, 4=kilogram PrisEnhet Kode for den enhet som danner grunnlag for: Pris (9) og bestillingsmengde. Gyldige PrisEnhet Må A 3 verdier i henhold til UN CommonCode. Se under kommentarer og PrisEnhetsTabell.. PrisEnhetTekst Forklarende PrisEnhetTxt. PrisEnhetTxt Kan A 8 Pris Katalog/listepris pr. oppgitt PrisEnhet (7). Oppgis med 2 desimaler og punktum som Pris Må N 11 desimaltegn. Mengde Antall MåleEnhet (6) som inngår i PrisEnhet (7). Oppgis med 4 desimaler og punktum som Mengde Må N 10 desimaltegn. PrisDato Registreringsdato for ny Pris. Format: ÅÅÅÅ-MM-DD PrisDato Må D 10 Status Statuskode til bruk v/flagging av poster: 0=Uendret 1=Ny vare, 2=Endret, 3=Utgår Status Må N 1 Blokknummer Blokknummer i EFO Produktdatabase (nivå 3). Format: 000000. Hele feltet fylles ut når BlokkNummer Kan N 6 det eksisterer blokknummer på varen. Rabattgruppe Selgers rabattgruppe. RabattGruppe Kan A 14 Fabrikat Selgers spesifikasjoner. Søkebegrep. Fabrikat Kan A 10 Type Selgers spesifikasjoner. Søkebegrep. Type Kan A 10 Lagerfort Viser om varen normalt sett er lagerført hos selger. J = varen er lagerført N = varen er ikke LagerFørt Kan A 1 lagerført Blank = koden ikke i bruk hos selger. Salgspakning Antall PrisEnhet (7) som inngår i minste normale bestillingsmengde/forpakning. Hvis SalgsPakning Kan N 10 varen finnes i flere salgspakninger, er dette beskrevet i VA/PA-Alternativer (se nedenfor). Oppgis med 4desimaler og punktum som desimaltegn. Rabatt Rabattprosent. Brukes kun ved pristilbud (Posttype PL). Oppgis med 2 desimaler og Rabatt Kan N 5 punktum som desimaltegn Pristype B = Bruttopris. N = Nettopris. Må brukes ved pristilbud (Posttype PL). Prisgrunnlaget for PrisType Må A 1 eventuell videre rabattberegning utifra avtaler, er Pris (9) minus eventuell Rabatt (19). Hvis type = B, kan rabattavtale anvendes på prisgrunnlaget. Hvis type = N, skal rabattavtale ikke anvendes. Tilleggsinformasjon Vare Tilleggsinformasjon Kan FeltId FELTID : Feltnavn eks: DIMENSJON, VEKT, FDV, HMS, BILDE Må A 10 - Side 8 of 9 -
Verdi VERDI : Fritt. Avtales i hvert enkelt tilfelle. f.eks URL-adressen til et bilde på internett. Se kommentarfelt. Må A 70 Alternativer Vare Alternativer Kan Alternativ Gjentas en gang per alternativ Må Varemerknad Varemerknad 0=Ukjent, 1=Elnummer, 2=EAN, 3=Produsentens varenr, 4=NRF nummer. VareMrk Kan A 1 Varenummer Varenummer i.h.t Varemerknad VareNr Kan A 14 Varetype A=alternativ vare, E=Erstatningsvare, V= Alternative vareidentifikasjon, VaType Må A P=Pakningsstørrelse. SalgsPakning Antall PrisEnhet (7) fra Linjepost som inngår i forpakning. Oppgis med 4 desimaler og SalgsPakning Må N 10 punktum som desimaltegn Oppsummering AntallLinjer Total antall linjeposter I medlingen - Side 9 of 9 -