Vareformat XML Brukerdokumentasjon Versjon: 1.0 - Side 1 of 10 -
ENDRINGSKATALOG DATO VER UTFØRT AV KOMMENTARER 30.10.2004 4.0 Truls Samuelsen Versjon 4.0. - Side 2 of 10 -
Innholdsfortegnelse 1. INNLEDNING 4 2. GENERELLE RETNINGSLINJER 4 2.1 FORKLARING TIL TABELLENE 4 3. KOMMENTARER TIL FELTENE 5 3.1 SELGERSID 5 3.2 VAREMRK 5 3.3 VARENR 5 3.4 VABETG. 5 3.5 VABETG2. 5 3.6 MÅLEENHET 5 3.7 PRIS 5 3.8 PRISENHETSTABELL / UN COMMON CODE PRISENHET PRISENHETTXT 5 3.9 MENGDE 6 3.10 SALGSPAKNING 6 3.11 PRISDATO 6 3.12 STATUS 6 3.13 BLOKKNUMMER 6 3.14 RABATTGRUPPE 7 3.15 LAGERFØRT 7 3.16 INNHOLD FOR FELT VERDI I POSTTYPE VX/PX 7 4. MELDINGEN 8 4.1 ENVELOPE 8 4.2 VAREFORMAT 8 - Side 3 of 10 -
1. Innledning EFONELFO Vareformat XML består av følgende: En Konvolutt med informasjon om avsender og mottaker av meldingen(e) En eller flere Vereformatmeldinger med en Vareformat i hver melding En hodepost med overordnet informasjon for en Vareformat En eller flere linjeposter med basisdetaljer og eventuelt fritekstlinjer En Sumlinje med totaler 2. Generelle retningslinjer Filnavn skal alltid begynne med XV4. 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 10 -
3. Kommentarer til feltene 3.1 SelgersID Selger identifiseres med organisasjonsnummer, som skal skrives på formen "NO123456789MVA", alternativt "NO123456789" (for selskap som ikke er MVA-pliktig). Alle tegn skal skrives fortløpende, uten formateringstegn. Identifisering av bekreftelsen. Hvis bekreftelse sendes ut flere ganger, bør bekreftelsenr. innbefatte et sekvensnr. 3.2 VareMrk Se beskrivelse av VareMrk i vareformatet. Bruk VareMrk 9=Tilleggsvare for å spesifisere avgifter som gjelder for hele ordrebekreftelsen. 3.3 VareNr Feltet benyttes for unik identifikasjon av produktet/rabattgruppe innen angitt kodesystem (VareMrk). Kombinasjonen PostType + VareMrk + VareNr skal være unik i filen. 3.4 VaBetg. VaBetg er produktets handelsbetegnelse (fakturatekst). Målsetning med informasjonen i VaBetg er å få til gjenbruk av data til f.eks. fakturatekster, hvilket betyr at det anbefales å benytte varetekst fra EFOs gjeldende produktdatabase. 3.5 VaBetg2. VaBetg2 er nødvendig tilleggstekst til VaBetg. Det anbefales å benytte supplerende varetekst fra EFOs gjeldende produktdatabase. 3.6 MåleEnhet MåleEnhet vil bli benyttet ved kalkulasjon av sammenlignbare priser. Produkter som ved montasje (anvendelse) ikke kan deles i mindre enheter og hvor forbruk måles i antall enheter av produktet, gis MåleEnhet 1=stykk. Produkter hvor forbruk måles i lengde, gis MåleEnhet 2=meter. Produkter hvor forbruk måles i kapasitet, gis MåleEnhet 3=liter. Produkter hvor forbruk måles i masse, gis MåleEnhet 4=kg. 3.7 Pris Pris feltet inneholder pris på produktet. Pris feltet må være gitt med en positiv numerisk verdi større eller lik 0. 3.8 PrisEnhetstabell / UN Common Code PrisEnhet PrisEnhetTxt BD BRETT BG POSE BK KURV BQ FLASKE BX BOKS CA KANNE CT KARTONG EA STYKK KGM KILOGRAM LTR LITER MTR METER OP PAR PF PALL PK PAKKE RL SNELLE RO RULL E-NVare4.0 5 SET SETT ST ARK - Side 5 of 10 -
3.9 Mengde Mengde skal inneholde antall angitte MåleEnheter (6) som inngår i en Pris (7). Feltet Mengde skal være numerisk (N), antall desimaler skal være 4, desimaltegn brukes ikke. Hele feltet skal fylles ut. Verdien av Mengde feltet må være gitt med en positiv heltallsverdi større eller lik 00001=0,0001 Generell formel: Bestilt antall PrisEnheter = RundOpp (Behov/(Mengde * SalgsPakning)) * SalgsPakning. Eksempler på bruk av MåleEnhet, Pris, Mengde Eksempel 1 Vareformat En kabelbro har egenskapen at den er 2,50 meter lang. Kabelbroen prises og leveres pr. stk kabelbro. En kabelbro kan deles i mindre enheter ved montasje. MåleEnhet (6) 2 (meter) Pris (7) 96000 (kr 960,-/stk) Mengde (8) 25000 (2,5 m pr. stk) SalgsPakning (16) 10000 (minste bestilling er 1 stk) PrisEnhet (17) EA (stk) Omregning fra behov i MåleEnhet (meter) til bestillingsmengde (stk): Bestillingsformat. Behov 25 meter Kabelbroer Antall PrisEnheter bestilt: 25 meter/2,5 meter pr stk=10stk Eksempel 2 Vareformat a) En kabel leveres på rull à 50 meter. Leverandørens prisliste viser pris pr. m kr 15,-. Ved anvendelse/montasje av kabelen kan denne deles i mindre enheter (meter). MåleEnhet (6) 2 (meter) Pris (7) 1500 (kr 15,-/m) Mengde (8) 10000 (1 meter pr meter) SalgsPakning (16) 500000 (minste bestilling er 50 meter) PrisEnhet (17) MTR (meter) Bestillingsfomat. Behov i MåleEnhet: 140 meter kabel Antall PrisEnheter bestilt: 140/1meter pr meter=140 meter Avrundet opp til: 150 meter. b) En kabel leveres på rull à 50 meter. Leverandørens prisliste viser pris pr. rull kr 750,-. Ved anvendelse/montasje av kabelen kan denne deles i mindre enheter (meter). MåleEnhet (6) 2 (meter) Pris (7) 75000 (kr 750,-/rull; 750/ = kr 15,-/m) Mengde (8) 500000 (50 m (felt 6) pr rull (felt 17)) SalgsPakning (16) 10000 (minste bestilling er 1 rull) PrisEnhet (17) RO (rull) Omregning fra behov i MåleEnhet (meter) til bestillingsmengde (rull): Bestillingsfomat. Behov 140 m kabel: Antall PrisEnheter bestilt: 140meter/50 meter rull=2.8 ruller Avrundet opp til: 3 ruller 3.10 SalgsPakning Salgspakning er den minste kvantumsenhet som varen kan leveres i. 3.11 PrisDato PrisDato angir hvilken dato pris sist ble registrert eller endret. 3.12 Status Status angir om produktet er nytt, endret eller utgått fra selgers varesortiment. 3.13 BlokkNummer BlokkNummer systemet er et søkehierarki i 3 nivåer som administreres av Elektroforeningen. Systemet omfatter en søkestruktur for gjenfinning av produkter som er uavhengig av struktur på varenummer. Blokknummer systemet er kodebasert, hvor kode for hvert nivå identifiserer en unik tekst. BlokkNummer består av 6 siffer i området 0-9, og har følgende struktur: XXYYZZ. XX angir kode for 1. nivå, YY angir kode for 2. nivå og ZZ angir kode for 3. nivå. - Side 6 of 10 -
Blokknummer skal alltid oppgis når dette eksisterer for produktet. Angivelse av riktig blokknummer er som for fabrikat og type meget viktig for søk etter produkter. Feil blokknummer vil medføre at bruker ikke finner produktet det søkes etter. Siden blokknummeret er kodebasert er problemer med forskjellig representasjon av samme type informasjon utelukket (jfr. fabrikat og type). 3.14 RabattGruppe RabattGruppe er en statistikk kode som benyttes for gruppering av produkter. Grupperingen benyttes som referanse for rabattering av produktgrupper. System for RabattGruppe utvikles og vedlikeholdes av hver enkelt selger. Fabrikat, Type Fabrikat og type kan legges ut som egne felter for å kunne benytte denne informasjonen ved søk etter produkter. Eks.: Fabrikat: SIEMENS, ELKO, NOBØ. Type: PFSP, PR. 3.15 Lagerført Feltet brukes for å fortelle om varen normalt sett er lagerført hos selger. Informasjonen er nyttig for mottager i de tilfeller der rabatter, leveringstidspunkter og så videre er knyttet til lagerførte varer. Feltet skal være tomt (uten verdi) når selgeren ikke oppgir denne informasjonen. 3.16 Innhold for felt VERDI i Posttype VX/PX DIMENSJON: bredde, høyde, lengde oppgitt i millimeter, adskilt med bokstaven x. VEKT: Oppgitt i gram. FDV: Oppgis i URL adresse. HMS: Oppgis i URL adresse. BILDE: Oppgis i URL adresse. - Side 7 of 10 -
4. Meldingen 4.1 Envelope Tag/attribytt navn Beskivelse/Bruk EFO Flatfil Bruk Type Lengde Envelope 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 Vareformat Tag/attribytt navn Beskivelse/Bruk EFO Flatfil Bruk Type Lengde Vareformat 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 8 of 10 -
Linjer 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 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. Pristype B = Bruttopris. N = Nettopris. Må brukes ved pristilbud (Posttype PL). Prisgrunnlaget for PrisType Kan 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 Verdi VERDI : Fritt. Avtales i hvert enkelt tilfelle. f.eks URL-adressen til et bilde på internett. Se Må A 70 - Side 9 of 10 -
kommentarfelt. 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 SalgsPakning P=Pakningsstørrelse. Antall PrisEnhet (7) fra Linjepost som inngår i forpakning. Oppgis med 4 desimaler og punktum som desimaltegn Oppsummering AntallLinjer Total antall linjeposter I medlingen SalgsPakning Kan N 10 - Side 10 of 10 -