Faktura XML Brukerdokumentasjon Versjon: 1.0

Transkript

1 Faktura XML Brukerdokumentasjon Versjon: Side 1 of 10 -

2 ENDRINGSKATALOG DATO VER UTFØRT AV KOMMENTARER Truls Samuelsen Versjon Side 2 of 10 -

3 Innholdsfortegnelse 1. INNLEDNING 4 2. GENERELLE RETNINGSLINJER FORKLARING TIL TABELLENE 4 3. KOMMENTARER TIL FELTENE KJØPERSID / SELGERSID LANDKODER SIGN ØREAVRSIGN ENHETSPRIS, RABATT OG TILLEGG/AVGIFT VABETG VABETG MELDINGEN ENVELOPE FAKTURA 6 - Side 3 of 10 -

4 1. Innledning EFONELFO Faktura XML består av følgende: En Konvolutt med informasjon om avsender og mottaker av meldingen(e) En eller flere Fakturaer med en Faktura i hver melding En hodepost med overordnet informasjon for en Faktura En eller flere linjeposter med basisdetaljer og eventuelt fritekstlinjer En Sumlinje med totaler 2. Generelle retningslinjer Filnavn skal alltid begynne med XF4. Karaktersett: ISO (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 ( =1. desember 2004). DT = ÅÅÅÅ-MM-DD-THH:MM:SS ( T16:00:00) =1. desember 2003 klokken ) 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 ( =1. desember 2004). DT = ÅÅÅÅ-MM-DD-THH:MM:SS ( T16:00:00) =1. desember 2003 klokken ) 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 -

5 3. Kommentarer til feltene 3.1 KjøpersID / SelgersID Kjøper og selger identifiseres med organisasjonsnummer, som skal skrives på formen "NO MVA", alternativt "NO " (for selskap som ikke er MVA-pliktig). Alle tegn skal skrives fortløpende, uten formateringstegn. 3.2 Landkoder Landkoder skrives i henhold til ISO , alfa 2 utgaven. (Samme kodesystem som benyttes av banken ved filbasert overføring til utland). Eksempel: "NO" = Norge, "SE" = Sverige. 3.3 Sign "Sign" finnes både på fakturahode og på linjene. "Sign" i hoderecorden viser om dokumenter er en faktura eller en kreditnota. "Sign" i hoderecorden viser derfor fortegn på dokumentets totalbeløp. "Sign" på linjen viser linjens fortegn. Kreditlinjer skal ha negativ "Sign", debetlinjer (vanlige linjer) skal ha positiv "Sign". Dette gjelder både for faktura og kreditnota. Eksempel: En kreditnota med 1 varelinje skal ha negativ "Sign" både i hodepost og på linjeposten. 3.4 ØreAvrSign "ØreAvrSign" finnes bare på fakturahodet, og viser hvilken vei (+ opp eller - ned) evt. øreavrunding er foretatt, uansett faktura eller kreditnota. 3.5 Enhetspris, rabatt og tillegg/avgift 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. Beløp i feltene "TilleggBel" og "AvgiftBel" gjelder for linjen som helhet (ikke for en enkelt enhet). 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.6 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.7 VaBetg2. VaBetg2 er nødvendig tilleggstekst til VaBetg. Det anbefales å benytte supplerende varetekst fra EFOs gjeldende produktdatabase. - Side 5 of 10 -

6 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 Faktura Tag/attribytt navn Beskivelse/Bruk EFO Flatfil Bruk Type Lengde Faktura 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. Fakturanummer Selgers fakturanummer. Unik id av bestilling FaktNr Må A 8 Fortegn Dokumenttype / fortegn. Viser om feltet "FakTot" er positivt eller negativt, og derved om Sign Må A 1 dokumentet er en faktura eller en kreditnota. Se også kommentarseksjon. + = Faktura - = Kreditnota KjopersKundenummer Kjøpers kundenr, oppgitt av selger. KundeNr Må A 10 Delfaktura Markerer om fakturaen anses som sluttfaktura eller delfaktura. 1 = delfaktura Alle andre verdier, også tomt felt, = sluttfaktura. DelFak Kan A 1 - Side 6 of 10 -

7 Referanser Må SelgersOrdrenummer Selger ordrenummer. SOrdNr Må 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 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 Pakkseddelnummer Selgerens pakkseddelnummer. PakSed Kan A 8 Selgersreferanse Selgers referanse. SelgersRef Kan A 10 FakturamottakersKunde Fakturamottakers kundenr, oppgitt av selger. Brukes når fakturamottakers kundenr. er FKundeNr Kan A 10 nummer forskjellig fra kjøpers kundenr oppgitt i KjøpersKundenummer. LeverandorID Selgerens nummer hos kjøper. LevId 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 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 Eks: "NO"=Norge KLandK Kan A 2 - Side 7 of 10 -

8 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 PostNummer Varemottakers pstnummer LPostNr Kan A 8 PostSted Varemottakers pststed LPostSted Kan A 35 LandKode Varemottakers landkode, jfr ISO Eks: "NO"=Norge LLandK Kan A 2 Fakturamottaker Inneholder basisinformasjon om fakturamottaker Må Navn Fakturamottakers firmanavn FFirmaNavn Må A 35 Adresse Fakturamottakers postadresse Kan Adresse1 Fakturamottakers aressefelt1 FAdr1 Kan A 35 Adresse2 Fakturamottakers dressefelt2 FAdr2 Kan A 35 PostNummer Fakturamottakers pstnummer FPostNr Må A 9 PostSted Fakturamottakers pststed FPostSted Må A 35 LandKode Fakturamottakers landkode, jfr ISO Eks: "NO"=Norge FLandK Kan A 2 Fakturadato Fakturadato. Format: ÅÅÅÅ-MM-DD. FaktDato Må D 10 Forfallsdato Forfallsdato. Format: ÅÅÅÅ-MM-DD. ForfallsDato Må D 10 FakturaNetto Sum netto før moms. For sjekk av momsverdi. Oppgis med 2 desimaler og punktum som FaktUMoms Må N 12 desimaltegn. Moms Sum merverdiavgift av fakturatotal. Oppgis med 2 desimaler og punktum som desimaltegn. Moms Må N 12 Oreavrunding Øreavrunding for fakturaen. Oppgis med 2 desimaler og punktum som desimaltegn. ØreAvr Må N 12 OreavrundingFortegn Fortegn for øreavrunding. + = positiv øreavrunding (å regne som rabatt for kjøper). - = ØreAvrSign Må A 1 negativ øreavrunding (å regne som tillegg for kjøper). FakturaTotal Fakturatotal, inkl. MVA. Oppgis med 2 desimaler og punktum som desimaltegn. FakTot Må N 12 Valutakode Valutakode jfr. ISO Eks: "NOK"=Norske kroner Valuta Må A 3 Merket Merkingstekst som skal skrives på pakke-etikett ved leveranse. Merket Kan A 25 Opprinnelse 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 BestOpp Kan A 1 - Side 8 of 10 -

9 SelgersKID Selgers KID-nr for fakturaen. KID Kan A 27 SelgersKonto Selgers kontonummer (bank / post) Konto Kan A 11 IBAN Selgers IBAN-kode (ref. bank-kontonr.). IBAN Kan A 15 SWIFT Selgers BIC/SWIFT-kode (ref. bank-forbindelse). SWIFT Kan A 15 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 Linjenummer på faktura. LinjeNrFa Må N 4 KjopersBestillingsnum Kjøpers bestillingsnr. Fylles ut hvis avvik fra Fakturahode (FF). BestNr Kan A 10 mer BestillingsLinjenummer Referanse til linjenummer på kjøpers bestilling. LinjeNrBe Kan 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 AntallLevert AntLev : Levert antall. Alltid positivt, også ved retur. Oppgis med 2 desimaler og punktum Ant Må N 10 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. Fortegn Fortegn for denne varelinjen. Se også kommentarseksjon. + = Verdien i feltet "Belop" er Sign Kan A 1 positivt. - = Verdien i feltet "Beløp" er negativt. KjopersVarenummer Kjøpers varenummer KVareNr Kan A 26 Kjopersreferanse Fylles ut hvis avvikende referanse fra KjøpersRef i hodeposten. KjøpersRef Kan A 25 - Side 9 of 10 -

10 Pakkseddelnummer Selgerens pakkseddelnummer. Se PakSed i hodepost. Tas kun med på linjepost dersom PakSed Kan A 8 linjens pakkseddelnummer avviker fra verdi i hodepost. 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å N 4 - Side 10 of 10 -