Transcript Byggdok meldingsformat.pdf

ByggDok vil ta imot meldinger fra butikker om gjennomførte salg av byggevarer som utløser krav om utsending av sikkerhetsdatablad og FDV
dokumentasjon.
Meldingene kan sendes inn på 3 måter:
1. Til definert FTP område hos Byggtjeneste
2. Til definert AS2 område hos Bygg-e.no (Byggtjeneste)
3. Til definert webservice hos Byggtjeneste
Meldingene kan bare sendes inn av medlemmer hos Byggtjeneste med eget deltakernummer. Overordnet organisasjon kan sende inn på
vegne av sine underordnede butikker.
Meldingene skal følge en navnestandard som definert under i kapittel 3.
Meldingene skal følge et subset av Nordic e-building XML formatet for ordre som standard. Andre formater kan anvendes men må da mappes
mot dette formatet. Det generiske innholdet er definert i kapittel 2. Subsettet for Nordic e-building XML formatet er definert i kapittel 4.
Det generiske formatet skal være i prinsippet:
<A:Informasjon om kunden>
<B:Informasjon om prosjektet>
<C:Informasjon om salget>
<D:Informasjon om varene som er kjøpt>
A: Inneholder kundeid som kunden har i butikkens system, opt. Navn, opt. ePost, opt. Adresse, opt. Orgnummer
B: Inneholder fritt valgt prosjektnavn eller nummer, evt kundens referanse. Antar at alle ERP systemer har for dette formålet et Kundens
Referanse felt som kan benyttes. E-postadresse til prosjektets kontaktperson. Optional navn etc til samme kontaktperson.
C: Inneholder Dato for salget
D: Inneholder en liste over NOBBnummer for de produktene som er solgt
I vårt system vil vi legge til informasjon om hvem butikken er og hvilken kjede dette er. Det siste er samme som navnet på det systemet som
sender inn, og tilsvarer det mottakspunktet vi har gitt dem. Butikken er nyttig å ha med, og kan gis som del av navnet på meldingen/filen, evt
som en meldingsheader i selve filen. Se kapittel 3.
Meldingsnavnet skal følge en standard som definerer type av melding og hvem som har sendt den inn. Denne informasjonen kan også gis i
header informasjon i meldingen, men navnet på meldingen må også være som angitt her.
Format:
Byggdok_<deltagernummer>_<referansenummer>.xml
<deltagernummer>: Dette er butikkens eller kjedens deltagernummer i NOBB.
<referansenummer>: Dette er en unik (innenfor butikkens sett av meldinger) identifikasjon av meldingen, og kan implementeres som et
forløpende løpenummer. Det kan også gjøres som et dato/klokkeslett nummer. Vi bruker denne kun til å bestemme unikhet, og som et
referansefelt som kan brukes i eventuelt kommunikasjon med innsender. Det er altså helt opp til innsender hva dette nummeret er for noe.
Tabellen under viser hele Nordic eBuilding XML formatet for Ordre, og i siste kolonne er det angitt hvilke felter som anvendes av ByggDok.
Informasjonen er angitt som R (Required/Obligatorisk) og O (opsjon/valgfritt). Om det er informasjon i de andre feltene så vil disse kun bli
ignorert, meldingen vil ikke bli avvist.
Feltet Noter angir notenummer med kommentarer som er angitt etter tabellen.
Hele formatet finnes på denne linken: http://www.virke.no/byggevarehandel/standardisering
Cardinality
1
1
0
1
1
1
0
0
0
0
0
0
0
0
0
0
0
0
0
..
..
..
..
..
..
..
..
..
..
..
..
..
..
..
..
..
..
..
1
1
1
1
1
1
1
1
1
1
1
1
1
1
1
1
1
1
1
Elements and structure
Orders
Order header
Order number
Requested delivery date and time for whole order
Order date and time
Order date
Order date and time
Free Text/information
Delivery instruction marks
Transport information
Party instruction marks
Purchasing information
Language code
Document references
Projectnumber
Customers reference/number
Reference to promotion deal number
Offer number
Reference to price list
Account number
Entity id
ByggDok Note
T3309
T3232
O
T3333
T3310
R
T6002
T6008
T6006
T6007
T1107
T6004
T6005
T6035
T6010
T0006
T6012
R
i
Cardinality
0 .. 1
0 .. 1
0 .. 1
0 .. 1
1 .. 1
0 .. 1
0 .. 1
0 .. 1
0 .. 1
0 .. 1
0 .. 1
0 .. 1
0 .. 1
0 .. 1
0 .. 1
0 .. 1
0 .. 1
0 .. 1
0 .. 1
0 .. 1
0 .. 1
0 .. 1
0 .. 1
0 .. 1
0 .. 1
0 .. 1
0 .. 1
0 .. 1
0 .. 1
0 .. 1
0 .. 1
0 .. 1
Elements and structure
Reference to agreement or contract
Ultimate customers order number
Reference for freight forwarders number
Drawing number
Buyer
Buyer
Id number/Name and adress
Partner Identifier
Party name
Department
Street name
Building
Postal box number
City name
Postal code
Country, coded
Buyer's contact
Name
Phone number
Email address
Identification code ID06
Reference to tax and organization number
Buyer's VAT registration number
Supplier
Supplier
Id number/Name and adress
Partner Identifier
Party name
Department
Street name
Building
Postal box number
Entity id
ByggDok Note
T0007
T6221
T6127
T6222
T0008
R
T6001
T5001
T5002
T5003
T5004
T5020
T5005
T6117
T5007
R
O
T5012
T5010
T5011
T6091
O
O
O
T0099
O
T0009
T6001
T5001
T5002
T5003
T5004
T5020
ii
Cardinality
Cardinality
0
0
0
0
0
0
0
0
0
0
0
0
0
0
0
0
0
0
0
0
0
0
0
0
0
0
0
0
0
0
0
0
0
0
0
0
0
0
0
..
..
..
..
..
..
..
..
..
..
..
..
..
..
..
..
..
..
..
..
..
..
..
..
..
..
..
..
..
..
..
..
..
..
..
..
..
..
..
1
1
1
1
1
1
1
1
1
1
1
1
1
1
1
1
1
1
1
1
1
1
1
1
1
1
1
1
1
1
1
1
1
1
1
1
1
1
1
Elements and structure
Elements and structure
City name
Postal code
Country, coded
Supplier's contact
Name
Phone number
Email address
Reference to tax and organization number
Supplier's VAT registration number
Delivery party
Delivery party
Place of delivery, specified
Id number/Name and adress
Partner Identifier
Party name
Department
Street name
Building
Postal box number
City name
Postal code
Country, coded
Delivery contact
Name
Phone number
Email address
Invoicee
Invoicee
Id number/Name and adress
Partner Identifier
Party name
Department
Street name
Postal box number
City name
Postal code
Country, coded
Invoicee's contact
Name
Entity id
Entity id
ByggDok Note
T5005
T6117
T5007
T5012
T5010
T5011
T0064
R
T0037
T6015
T6001
T5001
T5002
T5003
T5004
T5020
T5005
T6117
T5007
R
O
O
O
O
O
O
O
O
T5012
T5010
T5011
O
O
O
T0085
T6001
T5001
T5002
T5003
T5020
T5005
T6117
T5007
T5012
iii
Cardinality
0 .. 1
0 .. 1
0 .. 1
0 .. 1
0 .. 1
0 .. 1
0 .. 1
0 .. 1
0 .. 1
0 .. 1
0 .. 1
0 .. 1
0 .. 1
Elements and structure
Phone number
Email address
Reference to tax and organization number
Invoiceer's VAT registration number
Ship from
Shipper
Id number/Name and adress
Partner Identifier
Party name
Department
Street name
Building
City name
Entity id
ByggDok Note
T5010
T5011
T6030
T0129
T6001
T5001
T5002
T5003
T5004
T5005
Cardinality
Elements and structure
Cardinalit Elements and structure
y
0
0
0
0
0
0
0
0
0
0
0
0
0
0
0
0
0
0
0
0
0
0
0
0
0
0
0
0
0
0
0
0
0
0
0
0
0
0
..
..
..
..
..
..
..
..
..
..
..
..
..
..
..
..
..
..
..
..
..
..
..
..
..
..
..
..
..
..
..
..
..
..
..
..
..
..
1
1
1
1
1
1
1
1
1
1
1
1
1
1
1
1
1
1
1
1
1
1
1
1
1
1
1
1
1
1
1
1
1
1
1
1
1
1
Postal code
Country, coded
Ship from contact
Name
Phone number
Email address
Ulitimate customer
Ultimate customer
Id number/Name and adress
Partner Identifier
Party name
Department
Street name
Building
City name
Postal code
Country, coded
Ultimate customer contact
Name
Phone number
Email address
Carrier
Carrier
Id number/Name and adress
Partner Identifier
Party name
Street name
Postal box number
City name
Postal code
Country, coded
Carriers contact
Name
Phone number
Email address
Consignee
Consignee
Id number/Name and adress
Entity id
ByggDok Note
Entity id
ByggDo
k
T6117
T5007
T5012
T5010
T5011
T6223
O
T6001
T5001
T5002
T5003
T5004
T5005
T6117
T5007
O
O
O
O
O
O
O
O
T5012
T5010
T5011
O
O
O
T3208
T6001
T5001
T5003
T5020
T5005
T6117
T5007
T5012
T5010
T5011
T0036
iv
Cardinality
0 .. 1
0 .. 1
0 .. 1
0 .. 1
0 .. 1
0 .. 1
0 .. 1
0 .. 1
0 .. 1
0 .. 1
0 .. 1
0 .. 1
1 .. 1
1 .. 1
Elements and structure
Partner Identifier
Party name
Street name
Postal box number
City name
Postal code
Country, coded
Consignee's contact
Name
Phone number
Email address
TAX Handling
Duty/tax/fee type, coded
Duty or tax or fee category code
Entity id
ByggDok Note
T6001
T5001
T5003
T5020
T5005
T6117
T5007
T5012
T5010
T5011
T6707
T6708
Cardinality
Cardinality
0
1
0
0
0
0
0
0
0
0
0
0
0
0
0
0
1
1
0
1
0
0
0
0
0
0
0
0
0
0
0
0
0
0
1
1
0
0
..
..
..
..
..
..
..
..
..
..
..
..
..
..
..
..
..
..
..
..
..
..
..
..
..
..
..
..
..
..
..
..
..
..
..
..
..
..
1
1
1
1
1
1
1
1
1
1
1
1
1
1
1
1
unbounded
1
1
1
1
1
1
1
1
1
1
1
1
1
1
1
1
1
1
1
1
1
Elements and structure
Elements and structure
Justification for tax exemption, clear text
VAT rate
Currency
Rate of exchange
Reference currency
Order currency
Transport method information
Transport mode name code
Mode of transport
Mode of transport name
Delivery method information
Delivery function code
Terms of delivery
Place of delivery,
Shipping marks consignment instruction
Shipping marks consignment
Order line
Line number
Requested delivery date for this order line
Identification, article number
Global Trade Item Number(GS1)
GTIN number of consumer unit
Supplier's article number
Buyersr's article number
NOBB article number
TUN article number
Finfo/Vilma article number
Manufacturer's article number
Norsk Rörgrossistföreningenr's article number
RSK article number
Electrical Wholsalers Norway, article number
E number
Article description
Package level code
Quantitys
Ordered quantity group
Ordered quantity
Measurement unit code
Entity id
Entity id
ByggDok Note
ByggDo
k
T6116
T0027
T0283
T6017
T6018
T6130
T6131
T6224
T6019
T6710
T6020
T0086
T0051
T0041
R
R
R
T0154
T6225
T0172
T6022
T6027
T6028
T6029
T1120
T6024
T6023
T6026
T0260
T6226
T6128
O
R
R
T0039
T6706
R
v
Cardinality
0 .. 1
0 .. 1
0 .. 1
0 .. 1
0 .. 1
0 .. 1
0 .. 1
0 .. 1
0 .. 1
1 .. 1
1 .. 1
0 .. 1
0 .. 1
0 .. 1
Elements and structure
Consumer units in traded unit Group
Number of consumer units in traded unit
Measurement unit code
Free Text/information
Line Item information
Product information
Customers remarks
Language code
Price
Price amount
Price code qualifier
Price type code
Price specification code
Price unit basis quantity
Entity id
ByggDok Note
T0026
T6706
T6031
T6037
T6036
T1107
T6235
T6025
T6720
T6721
T6722
Cardinality
Cardinality
0
0
0
0
0
0
0
0
0
0
0
0
0
0
1
0
0
0
1
0
1
0
0
0
1
0
0
..
..
..
..
..
..
..
..
..
..
..
..
..
..
..
..
..
..
..
..
..
..
..
..
..
..
..
1
1
1
1
1
1
1
1
1
1
1
1
1
unbounded
1
1
1
1
1
unbounded
1
1
1
1
1
1
1
Elements and structure
Elements and structure
Measurement unit code
Document references
Projectnumber
Customers reference/number
Reference to promotion deal number
Offer number
Reference to price list
Account number
Reference to agreement or contract
Ultimate customers order number
Drawing number
Shipping marks consignment instruction
Shipping marks consignment
Allowance/discount,
Allowance and charge code
Description of special service
Percentage
Allowance/charge basis amount
Allowance/charge amount
Charge
Allowance and charge code
Description of special service
Percentage
Allowance/charge basis amount
Allowance/charge amount
Order trailer
Control total - number of lines
Entity id
Entity id
ByggDok Note
T6706
T6004
T6005
T6035
T6010
T0006
T6012
T0007
T6221
T6222
T0086
T6719
T6111
T6228
T6229
T6230
T6719
T6111
T6228
T6229
T6230
T0043