Ordrebekreftelse 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 KJØPERSID / SELGERSID 5 3.2 BEKREFTELSENR 5 3.3 VAREMRK 5 3.4 ENHETSPRIS, RABATT OG TILLEGG/AVGIFT 5 3.5 LANDKODER 5 4. MELDINGEN 6 4.1 ENVELOPE 6 4.2 ORDREBEKREFTELSE 6 - Side 3 of 9 -
1. Innledning EFONELFO Ordrebekreftelse XML består av følgende: En Konvolutt med informasjon om avsender og mottaker av meldingen(e) En eller flere Ordrebekreftelser med en Ordrebekreftelse i hver melding En hodepost med overordnet informasjon for en Ordrebekreftelse En eller flere linjeposter med basisdetaljer og eventuelt fritekstlinjer En Sumlinje med totaler 2. Generelle retningslinjer Filnavn skal alltid begynne med XC4. 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 KjøpersID / SelgersID Kjøper og 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. 3.2 BekreftelseNr Identifisering av bekreftelsen. Hvis bekreftelse sendes ut flere ganger, bør bekreftelsenr. innbefatte et sekvensnr. 3.3 VareMrk Se beskrivelse av VareMrk i vareformatet. Bruk VareMrk 9=Tilleggsvare for å spesifisere avgifter som gjelder for hele ordrebekreftelsen. 3.4 Enhetspris, rabatt og tillegg/avgift Bruk av felter for enhetspris og rabatt på ordrebekreftelse må avtales mellom kjøper og selger. Dersom feltene brukes på ordrebekreftelse, skal følgende retningslinjer følges: Feltet "EnhetsPris" skal alltid være oppgitt pr. enhet / prisenhet. Dette gir 3 mulighet for overføring av prisinformasjon: 1. Listepris føres i feltet "EnhetsPris". Feltene "Rabatt" har ingen definert verdi (blank / null). 2. Listepris føres i feltet "EnhetsPris". Feltene for "Rabatt" har en definert verdi (rabattsats). 3. Nettopris føres i feltet "EnhetsPris". Feltene for "Rabatt" har ingen definert verdi (blank / null). Verdien i feltene for "Rabatt" skal alltid tolkes som rabatt. Verdien i feltene for "Tillegg" og "Avgift" skal alltid tolkes som tillegg. Fortegn skal ikke benyttes for rabatt eller tillegg/avgift. Ved bruk av både Rab1 og Rab2 er Rab1 å forstå som rabatt på EnhetsPris, og Rab2 som rabatt på netto. Satsene skal ikke summeres! Merk! Når rabatt, tillegg eller avgift angis i prosent skal tilhørende felt for rabatt-, tillegg- eller avgiftsbeløp fylles ut. Eksempel: Brutto linjebeløp: 200,00 kr, rabatt: 60%. Rab1P skal være "6000" og Rab1Bel skal være "12000". Når rabatt, tillegg eller avgift utelukkende skal angis som beløp skal tilhørende felt for prosentsats ikke fylles ut. Merk at det skal være overensstemmelse mellom feltene for PrisEnhet, EnhetsPris, antall, rabatter, tillegg, avgift og linjesum. Det skal være mulig for mottaker å kontrollsummere varelinjen og avstemme mot netto linjesum. 3.5 Landkoder Landkoder skrives i henhold til ISO 3166-1, alfa 2 utgaven. (Samme kodesystem som benyttes av banken ved filbasert overføring til utland). Eksempel: "NO" = Norge, "SE" = Sverige. - Side 5 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 OrdreBekreftelse Tag/attribytt navn Beskivelse/Bruk EFO Flatfil Bruk Type Lengde OrdreBekreftelse 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 Hodepost gir informasjon om partene, og referanser/adresser/merking som er Må aktuelle å bruke. Bekreftelsesnummer Selgers bekreftelsenummer.. BekreftelseNr Må A 10 KjopersKundenummer Kjøpers kundenr, oppgitt av selger. KundeNr Må A 10 Referanser Kan SelgersOrdrenummer Selger ordrenummer. SOrdNr Kan A 10 Bestillingsnummer Kjøpers bestillingsnummer. Må fylles ut dersom det er fylt ut på tilhørende bestilling. BestNr Kan A 10 KjopersKundeavdeling Kjøpers kunde id., oppgitt av kjøper. For å skille avdelinger eller forskjellige kundekonti KundAvd Kan A 10 hos kjøper. KjopersOrdrenummer Kjøpers ordrenummer, som benyttes mot Kjøpers kunde. Brukes ved bestilling til en KOrdNr Kan A 10 - Side 6 of 9 -
ordre/oppdrag. KjopersProsjektnummer Kjøpers prosjektnummer. Brukes ved bestilling til et gitt prosjekt. ProsjektNr Kan A 10 Kjopersreferanse Kjøpers referanse. Skal returneres på ordrebekreftelse og faktura dersom det er fylt ut her. KjøpersRef Kan A 25 AvtaleIDMerknad Angir hva slags type AvtaleID som er brukt.r=rabattavtalenummer T=Tilbudsnummer AvtaleIDMrk Kan A 1 P=Prosjektnummer AvtaleID Henvisning til Selgers rabattavtalenr, tilbudsnr, eller prosjektnr oppgitt av Selger. AvtaleID Kan A 10 Eksternreferanse Ekstern referanse, oppgitt av kjøper. EksternRef Kan A 10 Selgersreferanse Selgers referanse. SelgersRef 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 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 Navn Kjøpers firmanavn KFirmaNavn Kan A 35 Adresse Kjøpers postadresse Kan Adresse1 Kjøpers aressefelt1 KAdr1 Kan A 35 Adresse2 Kjøpers dressefelt2 KAdr2 Kan A 35 PostNummer Kjøpers pstnummer KPostNr Kan A 9 PostSted Kjøpers pststed KPostSted Kan A 35 LandKode Kjøpers landkode, jfr ISO 3166. Eks: "NO"=Norge KLandK Kan A 2 Kontakt Informasjon om 1 eller flere kontaktpersoner Kan Navn Kontaktperson navn KNavn Kan A 35 Varemottaker Inneholder basisinformasjon om varemottager Kan Lokasjonsnummer EAN lokasjonsnummer hvis finnes. Bruk av lokasjonsnr. må avtales på forhånd mellom LAdrLok Kan A 14 kjøper og selger. Navn Varemottakers firmanavn LFirmaNavn Kan A 35 Adresse Varemottakers postadresse Kan Adresse1 Varemottakers aressefelt1 LAdr1 Kan A 35 Adresse2 Varemottakers dressefelt2 LAdr2 Kan A 35 - Side 7 of 9 -
PostNummer Varemottakers pstnummer LPostNr Kan A 8 PostSted Varemottakers pststed LPostSted Kan A 35 LandKode Varemottakers landkode, jfr ISO 3166. Eks: "NO"=Norge LLandK Kan A 2 Fakturamottaker Inneholder basisinformasjon om fakturamottaker Må Navn Fakturamottakers firmanavn FFirmaNavn Kan A 35 Adresse Fakturamottakers postadresse Kan Valutakode Adresse1 Fakturamottakers aressefelt1 FAdr1 Kan A 35 Adresse2 Fakturamottakers dressefelt2 FAdr2 Kan A 35 PostNummer Fakturamottakers pstnummer FPostNr Kan A 9 PostSted Fakturamottakers pststed FPostSted Kan A 35 LandKode Fakturamottakers landkode, jfr ISO 3166. Eks: "NO"=Norge FLandK Kan A 2 Transportform Informasjon om ønsket transportmåte. Bruk av feltet må avtales på forhånd mellom kjøper TransportMåte Kan A 25 og selger. Merket Merkingstekst som skal skrives på pakke-etikett ved leveranse. Merket Kan A 25 Melding Melding til transportør. Mottaker bør ta med feltet på utskrifter. Se også Melding Kan A 25 kommentarseksjonen. Leveringsdato Ønsket leveringsdato. Format: ÅÅÅÅ-MM-DD. LevDato Kan D 10 Opprinnelse Bestillingens opprinnelse. Følgende verdier er lovlige. "0" = "Umerket". "1" = Bestilt fra BestOpp Kan A 1 kjøpers ERP-system. "2" = Bestilt fra WEB (selgers e-handels system). "3" = Bestilt fra håndholdt enhet (pda). "4" = Hentet på plukklager / i butikk (bestilling er ikke sendt på forhånd). "5" = Telefon. "6" = Telefaks. "7" = E-post (fritekst bestilling). "8" = Bestilt fra kjøpers kontor, fra andre enheter enn de beskrevet av de øvrige koder (for eksempel serverprogram for håndholdt enhet). "K" = Kreditt/Retur KjoperslagerMerknad E=EAN lokasjonsnummer, brukt i Kjoperslager element. Ikke utfylt=udefinert KLagerMrk Kan A 1 Kjoperslager Kjøpers lager. Det lager kjøper bestiller varer til. EAN lokasjonsnummer kan benyttes. KLager Kan A 14 Bruk av lokasjonsnr. må avtales på forhånd mellom kjøper og selger. Fritekst En eller flere fritekstlinjer som er knyttet til hodepost. Kan Tekstfelt Friteksetfelt Fritekst Må A 30 Linjer Må Linje Må Linjenummer Fortløpende nummerering av linjeposter per dokument. LinjeNrBekr Må A 4 BestillingsLinjenummer Referanse til linjenummer på kjøpers bestilling. LinjeNrBe Må A 4 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 AntallBestilt Bestilt antall. Antall kan være omregnet til levert forpakningsstørrelse og gjelder for VareNr. Oppgis med 2 desimaler og punktum som desimaltegn. Ant Må N 10 - Side 8 of 9 -
AntallLeveres Leveres antall. Antall kan være omregnet til levert forpakningsstørrelse og gjelder for Lev Må N 10 VareNr. Oppgis med 2 desimaler og punktum som desimaltegn. RestAntall Antall i rest. Antall kan være omregnet til levert forpakningsstørrelse og gjelder for Rest Må N 10 VareNr. Oppgis med 2 desimaler og punktum som desimaltegn. Prisenhet Kode for den enhet som danner grunnlag for pris og bestillingsmengde. Gyldige verdier i PrisEnhet Må N 3 hendhold til UN CommonCode. Enhetspris Pris pr. oppgitt PrisEnhet. Oppgis med 2 desimaler og punktum som desimaltegn. EnhetsPris Kan N 11 Rabattprosent1 Rabattsats i prosent av oppgitt enhetspris. Oppgis med 2 desimaler og punktum som Rab1P Kan N 5 desimaltegn. Rabattbelop1 Rabatt i beløp. (Se Rab1P). Oppgis med 2 desimaler og punktum som desimaltegn. Rab1Bel Kan N 12 Rabattprosent2 Rabattsats i prosent. Beregningsgrunnlag er brutto linjesum fratrukket "Rab1Bel". Oppgis Rab2P Kan N 5 med 2 desimaler og punktum som desimaltegn. Rabattbelop2 Rabatt i beløp. (Se Rab2P). Oppgis med 2 desimaler og punktum som desimaltegn. Rab2Bel Kan N 12 Tilleggsprosent Tillegg i prosent. Oppgis med 2 desimaler og punktum som desimaltegn. TilleggP Kan N 5 Tilleggbelop Tilleggsbeløp. (Se TilleggP). Oppgis med 2 desimaler og punktum som desimaltegn. TilleggBel Kan N 12 Avgiftsprosent Avgift i prosent. 2 desimaler. Oppgis med 2 desimaler og punktum som desimaltegn. Eks. AvgiftP Kan N 5 Miljøavgift, metall. Avgiftbelop Avgiftsbeløp. (Se AvgiftP). Oppgis med 2 desimaler og punktum som desimaltegn. AvgiftBel Kan N 12 Belop Netto varelinjebeløp inkl. rabatter og tillegg. Oppgis med 2 desimaler og punktum som Beløp Kan N 4 desimaltegn. KjopersVarenummer Kjøpers varenummer KVareNr Kan A 26 KjopersBestilltAntall Kjøpers opprinnelige bestilte antall som gjelder for KVareNr. Oppgis med 2 desimaler og KAnt Kan N 10 punktum som desimaltegn. Leveringsdato Forventet leveringsdato for varelinjen. Må fylles ut når leveringsdato for linjen avviker fra LevDato Kan D 10 ordrens leveringsdato (se hodepost). Format: ÅÅÅÅ-MM-DD. LeveringsdatoRest Forventet dato for levering av rest. Bør fylles ut ved restleveranse. Format: ÅÅÅÅMMDD. RLevDato Kan D 10 Kjopersreferanse Fylles ut hvis avvikende referanse fra KjøpersRef i hodeposten. KjøpersRef Kan A 25 SelgerslagerMerknad E=EAN lokasjonsnummer brukt i SLager. Ikke utfylt=udefinert SLagerMrk Kan A 1 Selgerslager Selger lager. Brukes av kjøper for å spesifisere det lager hos selger der kjøper selv ønsker å SLager Kan A 14 hente varene. EAN lokasjonsnummer kan benyttes. Bruk av lokasjonsnr. må avtales på forhånd mellom kjøper og selger. Fritekst En eller flere fritekstlinjer som er knyttet til hodepost. Kan Friteksetfelt Fritekst Fritekst Må A 30 Oppsummering Må AntallLinjer Antall linjer(artikler) I bestillingen Må A 4 - Side 9 of 9 -