NOBB integrasjonsformat

Transkript

1 Dette formatet brukes til å hente informasjon om varer og priser ut av NOBB for import inn i et OFL-system. Filen brukes vanligvis til første gangs etablering av vare informasjon og senere til å hente ut oppdateringer fra systemet. Siste endringer er beskrevet med blå tekst og er kun endringer på feltbeskriveler. ( ) (Endringer beskrevet med rødt tekst ble gjennomført ) Det vil forefinnes 1 varerecord pr. produkt. Hvert produkt kan ha 1 eller flere paknings og prisrecorder. Deltakernummer på prisrecorden kan være ulike, avhengig av hvordan man utfører selve rutinen i NOBB. Generelt kan ett produkt ha mer enn 1 pris. F.eks. trelastprodukter, hvor et produkt har ett varenummer, men priser fra ulike trelastprodusenter. I rutinen for overføring må brukeren i de fleste tilfeller ta stilling til hvilken leverandør som han ønsker å hente pris i fra. Dette medfører at i de fleste tilfeller vil det bare være 1 pris og forholde seg til. I NOBB vil prisen alltid være relatert til vareenheten. Dvs. at pris som er tatt med på integrasjonsformatet bestandig er den som vareeieren har definert som sin vareenhet. Vareeierne har mulighet for å legge inn alternative forpakninger i systemet. Denne recorden (pakninsrecorden) vil da inneholde en omregningsfaktor i forhold til prisen og vareinnholdet på pakningen. Feltet omregningsfaktor kan da benyttes til å beregne pris på alternative enheter. F.eks.: Vareenheten er M2, men vareeieren har lagt inn en forpakning som heter PLATE hvor omregningsfaktoren er definert. Denne kan da benyttes til å beregne PLATE-pris. Felt 6, 7 og 8 på prisrecorden eksisterer bare der hvor brukeren benytter tilleggsprogrammet NOBB- KONTRAKT. Dette formatet krever at brukerens dataleverandør har foretatt de nødvendige tilpasninger i det aktuelle Ordre/Faktura system som er nødvendig for at informasjonen fra NOBB kan leses inn. Det må også forefinnes rutiner for omgjøring av NOBB-prisindeksen til en reell kostpris. Dette medfører at det enkelte datasystem må ha muligheten for å håndtere avtalebetingelser, samt en del variabler som skal brukes som påslag/avslag (f.eks. frakter etc.). Filen legges ut fra NOBB i et komma separert ascii tekst format. Start/Slutt angivelser er inkludert. Lengde er feltets lengde. Feltene er adskilt med komma (,) og alfanumeriske felter er omgitt med anførselstegn ("). Numeriske felter fylles ut med forløpsnuller såfremt verdien ikke fyller hele feltet. Alfa felter venstrejusteres konsekvent. Rader i formatet legges ut i henhold til recordtype definisjonen. Eksempel: 1,2,3,2,2,1,2,3,1,2,3,1,2,3,2,2 Merkenavn er koblet til modulene og blir nå eksportert nest sist i varerecorden. Hvordan leveres varen (er det en lagervare hos produsent eller må varen bestilles som spesialvare)? Som spesialbestilling eller vanlig. Dette eksporteres nå ut til slutt i varerecorden med kode 0 = På bestilling 1 = Vanlig (normalt) Prissammenligningsindikat or (PSE) (endret format ) Integrasjonsformat er utvidet med (til slutt i pakningsrecorden): en markering på pakningsrecorden dersom pakningsenheten også er en prissammenligningsenhet (PSE) eller en ny pakningsrecord på prissammenligningsenheten dersom prisenheten = prissammenligningsenheten og det ikke finnes en pakning på denne Følgende koder brukes: 0 = Enhet matcher ikke PSE1 eller PSE2 1 = Paknings/prisenhet matcher PSE1 Integrasjonsformater for NOBB pr , endret Side 1

2 2 = Paknings/prisenhet matcher PSE2 3 = PSE for varegruppen er overstyrt av vareeier 4 = Ingen PSE er angitt for varegruppe (det finnes ikke standard PSE for varegruppen) 8 = Aktuell varegruppe ikke funnet i Fellesbasen, varegruppe i vare ikke oppdatert (har relevans for ODAs administrasjon) 9 = Fellesbasen ikke tilgjengelig, PSE kan ikke leses (har relevans for ODAs administrasjon) Filen produseres fra Sortimentsdatabasen(e) i NOBB. Felt Beskrivelse Start Slutt Ant./type Kommentar Varerecord 01 Recordtype 1 1 1N 1=Varerecord 02 Nobb nummer N Nobb's artikkelnummer 03 Modul nummer N Nobbs modulnummer 04 Varegruppenr N Nobb's varegruppestruktur 05 Varetekst A Varetekstlinje 1 06 Varetekst A Varetekstlinje 2 07 Modultekst A Intern modultekst 1 08 Modultekst A Intern modultekst 2 09 Ean nummer N Varens EAN-13, UPC kode eller annen EAN kode. Hvis feltet ikke minst inneholder 13 siffer fylles det ut med foranløpende nuller 10 Produsent varenr A Produsentens varenummer. Venstrejustert 11 Leveran.varenr A Leverandørs varenummer Venstrejustert 12 Lev.deltagernr N Leverandørs delt.nr. i NOBB 13 Prod.delt.nr N Produsentens delt.nr. i NOBB 14 Aktiv dato D Vareinfo gyldig fra dato ÅÅÅÅMMDD 15 Utgår dato D Varens utgår fra dato ÅÅÅÅMMDD 16 Merkenavn A Merkenavn fra modulen 17 Leveringsvalg N Hvordan leveres varen fra produsent. Blir lagt ut med kode: 0 = på bestilling, 1 = vanlig (normal) Pakningsrecord 01 Recordtype 1 1 1N 2=Pakningsrecord 02 Pakningskode 4 6 3A 000,001,002...(000=vareenhet) 03 Enhetsbetegnelse A "PAK","PAL",M2 ", etc... Venstrejustert 04 Omregningsfaktor N 7:4 implisitt desimal (Antall vareenheter) Ikke bruk dette feltet, bruk felt Bredde N Angitt i mm 06 Lengde N Angitt i mm 07 Høyde N Angitt i mm 08 Vekt N Angitt i gram 09 Volum N 8:5 implisitt desimal 10 Antall N 8:2 implisitt desimal (Antall vareenheter) 11 EAN-nr N Pakningens EAN-13, UPC kode eller annen EAN kode. Hvis feltet ikke inneholder 13 siffer fylles det ut med foranløpende nuller 12 Omregningsfaktor N 10:4 implisitt desimal Samme feltet som felt nr. 04 med 10 posisjoner 13 DUN-nr N DUN Bestillbar N 0=Ikke Bestillbar, 1=Bestillbar 15 Sammensatt A Sammensatt av pakningskode 16 Antall i pakning N Antall i foregående pakning Integrasjonsformater for NOBB pr , endret Side 2

3 17 PSE-indikator N PSE prissammenligningsindikator. Blir lagt ut med en kode 0 (null), 1, 2, 3, 4, 8 eller 9 Prisrecord 01 Recordtype 1 1 1N 3=Prisrecord 02 Pris N 9:2 implisitt desimal. NOBB-prisindeks hvis valgt ved kjøring. Annen pris hvis valgt ved kjøring. Prisen er alltid i relasjon med pakningskode 000. (Minste enhet). 03 Pris dato f.o.m D Gyldig fra og med ÅÅÅÅMMDD 04 Deltager.nr N Pris kommer fra deltagernr. Deltagernummer i NOBB 05 Deltagers varenr A Vareeiers varenummer Venstrejustert. Hvis enhetsbetegnelsen = NOBB er dette vareeiers eget varenr. Hvis enhetsbetegnelsen er noe annet, er dette prisgivers varenr. 06 Innkjøpspris N 9:2 implisitt desimal NOBB_KONTRAKT 07 Kostpris N 9:2 implisitt desimal NOBB_KONTRAKT 08 Veil.pris N 9:2 implisitt desimal NOBB_KONTRAKT 09 Pris dato t.o.m D Gyldig til og med ÅÅÅÅMMDD 10 Valutakode A NOK=norske kroner, DKK=danske kroner osv 11 PGs varenr A Prisgivers varenr når dette er forskjellig fra vareeiers varenr. 12 PGs EAN-nr N Prisgivers EAN-nr når dette er ulikt vareeiers EAN-nr. Tilleggsrecord 01 Recordtype 1 1 1N 4=Tilleggsrecord 02 Pakningskode 4 6 3A 999 Fast verdi 03 Enhetsbetegnelse A "PAK","PAL",M2 ", etc... Venstrejustert 04 Omregningsfaktor N 7:4 implisitt desimal (Antall vareenheter) 05 Bredde N Angitt i mm 06 Lengde N Angitt i mm 07 Høyde N Angitt i mm 08 Vekt N Angitt i gram 09 Volum N 8:5 implisitt desimal 10 Antall N 8:2 implisitt desimal (Antall vareenheter) 11 EAN-nr N Pakningens EAN-13, UPC kode eller annen EAN kode. Hvis feltet ikke inneholder 13 siffer fylles det ut med foranløpende nuller 12 Omregningsfaktor N 10:4 implisitt desimal Samme feltet som felt nr. 04 med 10 posisjoner 13 DUN-nr N DUN Bestillbar N 0=Ikke Bestillbar 1=Bestillbar 15 Sammensatt A Sammensatt av pakningskode 16 Antall i pakning N Antall i foregående pakning Recordtype 4 (Tilleggsrecord) er avsatt til bruk for kjeder og grossister. Denne recorden inneholder ikke data fra NOBB og kan brukes av kjeder og andre aktører til å sende tilleggsinformasjon. Prisformat i NOBB Prisformat i NOBB er et eget filformat som brukes til import av prisinformasjon inn i NOBB systemet og i en rekke andre dataverktøy. Integrasjonsformater for NOBB pr , endret Side 3

4 Formatet skal i all hovedsak sørge for at prisinformasjon kan utveksles mellom aktører i bransjen. For eksempel kan en grossist sende mange priser pr. NOBB-nr. til en aktør som har tilgang på NOBB uten prisinformasjon. (for eksempel en entreprenør). Formatet er et rent tekst format med faste posisjoner. Feltene er ikke adskilt med noen form for skilletegn og det brukes ikke tekst kvalifikator. Formatet har fast rekordlengde, noe som betyr at alfanumeriske felter er venstrejustert og utfylt med blanke og numeriske felter fylles ut med forløpsnuller. Felt Beskrivelse Start Slutt Ant/Type Kommentar 01 Mottagers delt.nr N Deltakernummer i NOBB eller blank. Blank=alle 02 Prisgivers deltagernr N Prisgivers deltagernummer i NOBB. Må fylles ut. 03 Deltagers varenummer A Prisgivers varenummer. Venstrejustert 04 Nobb artikkelnummer N Nobb-nummer. Må fylles ut 05 Pakningskode A Skal alltid være = 000 og indikerer at pris må oppgis i varens minste enhet. Dette gjelder når formatet skal importeres i NOBB-systemet. Ved bruk mellom ulike aktører kan pakningskoden være gyldig pakningskode for denne NOBB-varen. 06 Pris N 9:2 implisitt desimal (pris i øre) 07 Pris dato f.o.m D Pris dato f.o.m. ååååmmdd 08 Pris dato t.o.m D Pris dato t.o.m. ååååmmdd 09 Priskode A UTS,SPE,EGE Endringsdato D Ååååmmdd Avsender av prisinformasjonen står fritt til å definere hvilke priser som skal sendes til en mottager. Dette kan variere for avsenderens ulike kunder. Rutinen vil normalt være implementert i avsenderens eget datasystem og vil produsere priser som for eksempel: Bruttopriser Nettopriser pr. prismottaker Kampanjepriser Sortimentspriser Rutinen forutsetter at avsender og mottaker er omforent med betydningen av den enkelte pris. Dette styres ved hjelp av deltagernummer og priskode. For eksempel kan en avsender bruke følgende koder: GBL GNL KAI KAU Grossist brutto lager pris Grossist netto lager pris Kampanje innkjøpspris Kampanje utsalgspris Prisformatet støtter mange priser pr. avsender/nobbnummer. Prisene kan datostyres. Prisene vil sorteres i NOBB-klienten til mottakeren basert på avsenders deltagernummer, vareeier, og priskode. Neste gang mottaker mottar prisinformasjon fra samme avsender, samme nonnnummer og samme priskode, vil gamle priser automatisk slettes og gjeldende priser vil tre i kraft. I NOBB er dette formatet tilgjengelig gjennom Brukerpris funksjonaliteten. Andre formater Stikkord liste produserer en fil som inneholder alle stikkord pr. modul i NOBB. Rutinen velges fra Sortiment databasene i NOBB. Integrasjonsformater for NOBB pr , endret Side 4

5 Nobb modulnr 8 Mange stikkord pr. modul.hvert stikkord adskilt med komma (kommaseparert) Stikkord.. 30 Hvert stikkord markeres med anførselstegn rundt. For eksempel plate, gulvplate Hvert stikkord kan være på 30 tegn. Eksempel: ,"3-PIN" Standard liste produserer en fil som inneholder alle standard (koder) pr. modul i NOBB. Rutinen velges fra Sortiment databasene i NOBB. Nobb modulnummer 8 Mange standarder pr. modul. Hver standard skilles med komma (kommaseparert) Standard 20 Hver standard markeres med anførselstegn rundt. for eksempel LN2, NS- ISO Hver standard kan være på 20 tegn ,"LN2","NS-ISO 9001" Eksport av Modul fritekst Noen data systemer benytter uintelligente terminaler som arbeidsstasjoner knyttet opp i mot en hovedmaskin. I disse tilfellene er ikke terminalene i stand til å dra nytte av den beskrivende del av NOBB-informasjonen. Hvis disse systemene har mulighet for å legge inn tekst som er knyttet til produkt, finnes det mulighet for uthenting av denne informasjonen fra NOBB. Rutinen kjøres fra Sortimentsdatabasen og heter Modul fritekst med $ tegn og velges fra Handlinger eksport til fil. Programmet legger ut Nobb's modulnummer samt all tilhørende tekstinformasjon. Felt Beskrivelse Start Slutt Ant Kommentar 01 Modulnr Omsluttet av $$. F.eks. $$ $$ Skrives ut som egen linje med tilhørende modultekst på linjene under. Neste modul starter med modulnr. på egen linje. 01 Tekst Teksten kommer linje for linje og gjelder for foranliggende modulnr. I tillegg finnes det et nytt format som eksporteres i henhold til følgende beskrivelse: Dette formatet velges fra Handlinger-eksport til fil og heter Modul fritekst. Recordtype 1 1 (Nobb modulnr) Nobb modulnr 8 Nobb modulnummer Recordtype 1 2 (Tekstlinje) Modul fritekst 75 Hver linje er max 75 tegn Antall tekstlinjer kan være mange. Hver recordtype = 2 tilhører forangående recordtype 1. 1, ,"våt stein eller files med øksefil. Bryning: Først grovt så fint bryne." 2,"Bruk ikke nakken som hammer." 1, ,"En alt-mulig-øks til felling, kløyving etc. SKJERPING: Sliping må alltid 2,"gjøres på våt stein eller files med øksefil." 2,"Bryning: Først grovt så fint bryne. Bruk ikke nakken som hammer." 1, ,"Skjerping: Sliping må alltid gjøres på våt stein eller files med øksefil." 2,"Bryning: Først grovt så fint bryne. Bruk ikke nakken som hammer." 1, ,"Skjerping: Sliping må alltid gjøres på våt stein eller files med øksefil." 2,"Bryning: Først grovt så fint bryne. Bruk ikke nakken som hammer." 1, ,"Til mur, løsning av muttere m.m." Integrasjonsformater for NOBB pr , endret Side 5

6 1, ,"uttrekksverktøy" 1, ,"Til sentrering av maskinhull. Brukes også som platespett." Eksport av varegruppeinformasjon Rutinen velges fra Fellesdatabasen og lager en fil som består av alle varegrupper i NOBB med varegruppebeskrivelse i henhold til følgende beskrivelse: Nobb varegruppe nummer 7 Skal skrive ut alle varegrupper på 7 siffer. Foranløpende nuller fylles ut. Varegruppe navn 35 Venstrejustert Eksport av deltagerinformasjon Filen er kommaseparert, alfanumeriske felter er omsluttet av anførselstegn og venstrejustert og numeriske felter er utfylt med forløpsnuller. Rutinen kjøres fra deltagerdatabasen og inneholder informasjon om alle deltagere i NOBB i henhold til følgende beskrivelse: deltaker.txt Feltnavn Start Slutt Lengde Beskrivelse Deltakernr N Deltakernr. I NOBB Navn A Deltakers navn Adresse A Adresse 1 Adresse A Adresse 2 Postnr A Postnummer 15 posisjoner for å takle utenlandske postnummer. Sted A Poststed Telefon A Telefon nummer (Streng - nummer kan være > 8) Fax A Telefax nummer Rolle N Deltakers rolle i NOBB. 0= Vareeier, 2 = bruker uten pris, 1 = bruker med pris. Uspesifisert = 3 E-post adresse A Web adresse A Yrkesgruppe A Kjede A Eksport av produsenter Filen er kommaseparert, alfanumeriske felter er omsluttet av anførselstegn og venstrejustert og numeriske felter er utfylt med forløpsnuller. Rutinen kjøres fra deltagerdatabasen og inneholder informasjon om alle produsenter pr. vareeier i NOBB i henhold til følgende beskrivelse: Vareeiers deltagernr 1 6 6N Produsent nummer N Produsent navn A Integrasjonsformater for NOBB pr , endret Side 6

7 Krav til datainnlegg i NOBB NOBB-databasen er et system som vil formidle informasjon om varer fra den enkelte leverandør til forhandlere og selgere av disse varene. Målsettingen er at den informasjon som blir lagt inn av Vareeier skal benyttes uten endringer i sluttbrukerens datasystemer. Det er derfor MEGET VIKTIG at vareeier tar hensyn til dette ved innlegg av data. Følgende forutsetninger er definert : 1: De fleste Ordre/Faktura systemer har kun 30 tegn for varetekst. Da vareteksten til slutt skal fremkomme på sluttbrukerens fakturalinje, må all viktig informasjon i vareteksten plasseres i de 30 første posisjonene. Annen informasjon kan fordeles på de resterende 40 posisjoner. Retningslinjer for varetekst finnes på 2: Hvert produkt skal ha et varegruppenummer. Da dette varegruppenummeret tildeles på modulnivå, må alle varer som naturlig hører sammen, samles i moduler slik at dette blir mulig. Der hvor det ikke er klart hvilket varegruppenummer som skal benyttes, må NOBB kontaktes for avklaring. Retningslinjer for varetekst finnes på 3: Tekniske beskrivelser og monteringsanvisninger (tekstinformasjon) fungerer på samme måte som nevnt i punkt 2. Derfor er dette nok et argument for å samle produktene i moduler som identifiserer egenskapene til varene. Elektronisk informasjon som brosjyrer og annen informasjon samt fremtidig bruk av bilde vil fungere på samme måte. Det oppfordres til at vareeier legger inn denne type informasjon da dette vil bli brukt i salgsfremmende situasjoner. 4: Det bør legges inn fornuftige Stikkord og disse skal være i entallsform. Stikkord benyttes av sluttbrukeren for å finne frem til den aktuelle vare. Det er derfor viktig for vareeier å gjøre dette skikkelig med tanke på profileringen av produktene. Det er plass til max. 10 stikkord pr. modul i NOBB. 5: For varer som er klassifisert som godkjent standard, NS, brannklasse, DIN, ISO etc. skal denne standard legges inn. 6: NOBB-prisindeks skal alltid legges inn på varen. Denne prisen skal være den pris som vareeier vil benytte som grunnlag for de avtaler han inngår med sine kunder. Når innlegg er utført, SKAL Vareeier sende beskjed til sine kunder om hvordan denne prisen er definert i NOBB-databasen. Denne prisen blir også kalt dårligste-pris, eller fabrikk-pris. 7: EAN-13 strekkodenummer skal legges inn. Vareeier må legge dette inn i databasen så snart han har tilgang til disse numrene. Sluttbrukeren kan da overføre disse direkte inn i sine egne systemer. Denne koden blir tildelt produsenten / generalimportøren av varen fra EAN-Norge. 8: Generelt kan man si at vareeier bør gjøre sitt datainnlegg i NOBB så bra som mulig, da dette vil gi positiv markedseffekt. 9: Fullstendig deltakerinformasjon som brukernavn, adresse, ulike telefonnr., faxnr. og ordrefax, e- postadresser og web adresser skal legges inn da dette vil fremkomme på sluttbrukers dataskjerm ved søk i databasen. 10: Pakningsinformasjonen i NOBB er veldig viktig for de som skal kjøpe og selge produktene. Denne informasjonen skal legges inn så detaljert som mulig. Alle enheter som kan selges skal defineres i systemet slik at byggevarehusene kan velge ut de enheter som passer for dem. Samtidig skal enhetene benyttes til bestillingsformål. Vareeier må derfor tenke på hvordan produktene selges og lagerføres i hele verdikjeden når denne informasjonen legges inn. For detaljert informasjon om de enkelte felter i NOBB, henvises til NOBB-brukerveiledning og retningslinjer for innleggelse av data i NOBB. Denne informasjonen er tilgjengelig fra internett området : Integrasjonsformater for NOBB pr , endret Side 7