Forespørsel 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 LEVERINGSADRESSE 5 3.3 SLAGER 5 3.4 MELDING / MERKET 5 3.5 EKSTERNREF 5 3.6 BESTOPP 5 3.7 LANDKODER 5 3.8 LINJENR 5 4. MELDINGEN 6 4.1 ENVELOPE 6 4.2 FORESPORSEL 6 - Side 3 of 9 -
1. Innledning EFONELFO Foresporsel XML består av følgende: En Konvolutt med informasjon om avsender og mottaker av meldingen(e) En eller flere Forespørselmeldinger med en Foresporsel i hver melding i hver melding En hodepost med overordnet informasjon for en Bestilling En eller flere linjeposter med basisdetaljer og eventuelt fritekstlinjer En Sumlinje med totaler 2. Generelle retningslinjer Filnavn skal alltid begynne med XI4. 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 Leveringsadresse Feltene for leverings/varemottaker-adresse fylles ut ved leveranse til annet navn / sted enn det som er normal leveringsadresse for kjøper eller prosjektet. Hvis Leveringsadresse-feltene er utfylt, skal feltene LAdrLok og evt. KLager med EAN Lokasjonsnummer ikke tas hensyn til ved fastsettelse av adresse. Hvis Leveringsadresse-feltene ikke er utfylt, kan EAN Lokasjonsnr. fra LAdrLok benyttes til å bestemme adresse, men dette må avtales på forhånd mellom kjøper og selger. Hvis LAdrLok heller ikke er utfylt, kan evt. EAN Lokasjonsnr. fra KLager benyttes til å bestemme adresse, men dette må avtales på forhånd mellom kjøper og selger. 3.3 SLager Selgers lager. Feltet brukes kun når kjøper selv ønsker å hente varene på et bestemt lager hos selger. Bruk av feltet må avtales på forhånd mellom kjøper og selger. Feltet "Melding" brukes til å informere om at varene hentes. I alle andre tilfelle kan selger selv bestemme hvilket lager varene hentes fra. Evt. bruk av EAN Lokasjonsnr. må avtales på forhånd mellom kjøper og selger. 3.4 Melding / Merket Mottaker av bestilling bør ta med disse feltene på alle utskrifter av bestilling-, pakke- og forsendelsesdokumenter. Feltene kan / vil inneholde informasjon beregnet på menneskelig kommunikasjon og det er avgjørende for behandling av dokumentet at informasjonen leses av ordrebehandler. 3.5 EksternRef Fylles ut av kjøper der det er nødvendig med ytterligere identifikasjon av bestillingen ut over bestillingsnummeret. Vanligvis referanse til løpenr. fra ekstern håndholdt enhet hos kjøper, når dataoverføring ikke skjer direkte fra denne enhet til Selgers system. 3.6 BestOpp Bestillingens opprinnelse. Følgende verdier er lovlige. 0 = Umerket 1 = Bestilt fra 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 3.7 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. 3.8 LinjeNr Linjenummer skal være unikt pr. dokument. - 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 Foresporsel Tag/attribytt navn Beskivelse/Bruk EFO Flatfil Bruk Type Lengde Foresporsel 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. Bestillingsnummer Kjøpers bestillingsnummer. Unik identifikasjon av bestilling. BestNr Må A 10 KjopersKundenummer Kjøpers kundenr, oppgitt av selger. KundeNr Må A 10 Referanser Kan 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 ordre/oppdrag. KjopersProsjektnummer Kjøpers prosjektnummer. Brukes ved bestilling til et gitt prosjekt. ProsjektNr Kan A 10 - Side 6 of 9 -
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 Selger Inneholder basisinformasjon om selger Kan ID Selgers foretaksnummer SelgersID Kan 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 SUBTYPE AKTØR : Inneholder basisinformasjon om kjøper Må ID Kjøpers foretaksnummer KjøpersID Må 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 Webadresse Kjøpers webadresse KWebAdr Kan A 40 Kontakt Informasjon om 1 eller flere kontaktpersoner Kan Navn Kontaktperson navn KNavn Kan A 35 Telefon kontaktperson telefonnummer KTelefon Kan A 15 Email kontaktperson e-postadresse KEPost Kan A 15 Fax kontaktperson telefaksnummer KFax Kan A 15 Varemottaker SUBTYPE AKTØR : 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 - Side 7 of 9 -
Adresse2 Varemottakers dressefelt2 LAdr2 Kan A 35 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 Bekreftelsestype Ønsket bekreftelsestype for bestilling. F=Fax, E=Epost, S=SMS, 4 =EFO/NELFO 4.0 ObkrType Kan A 2 flatfil, X = XML 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 SelgerslagerMerknad E=EAN lokasjonsnummer brukt i SelgersLager. 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. 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. LinjeNr Må A 4 Bestillingsnummer Kjøpers bestillingsnummer. BestNr Må A 10 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 Antall Bestilt antall. Oppgis med 2 desimaler og punktum som desimaltegn. Ant Må N 10 Prisenhet Kode for den enhet som danner grunnlag for pris og bestillingsmengde. Gyldige verdier i PrisEnhet Må A 3 hendhold til UN CommonCode. KjopersVarenummer Kjøpers varenummer KVareNr Kan A 25 - Side 8 of 9 -
Leveringsdato Ønsket leveringsdato for varelinjen. Fylles ut når ønsket leveransedato for linjen avviker LevDato Kan D 10 fra ønsket leveransedato for hele bestillingen. Format: ÅÅÅÅ-MM-DD. Kjopersreferanse Fylles ut hvis avvikende referanse fra KjøpersRef i hodeposten. KjøpersRef Kan A 25 DelleveranseTillatt J eller blank=tillatt å dele leveransen av denne varelinjen. N=Ikke tillatt å dele leveransen DelLev Kan A 1 av denne varelinjen. Alternativkode J eller blank = Kjøper tillater levering av tilsvarende alternative produkt. Eventuelle AltKode Kan A 1 varealternativer som kan aksepteres spesifiseres i Alternativ-elementer elementer. Hvis Alternativ-elementer mangler, overlates til selger å velge alternativ vare. N = Ikke tillatt levering av tilsvarende alternative produkt. Bruk av feltet må avtales på forhånd mellom kjøper og selger. Fritekst En eller flere fritekslinjer som er knyttet til en linje Kan Tekstfelt FriTekst Må A 30 Alternativer Kan Alternativ Må Varemerknad Varemerknad. 0=Ukjent, 1=ELnummer, 2=EAN, 3=Produsentens varenummer, VareMrk Må A 1 4=NRFnummer Varenummer El.nummer, EAN eller annet produktnummer jfr. oppgitt Varemerknad. VareNr Må A 14 Oppsummering Må AntallLinjer Antall linjer(artikler) I bestillingen Må A 4 - Side 9 of 9 -