Florecom Coderingen 1.1
Beschrijving codelijsten Bedrijfscodes Locatiecodes Prijsleveringsvoorwaarden Beladinginstructies Data-elementen
Bestandsnaam
: GH25060701v1.2 Florecom Coderingen 1.1.doc
Bestandsnummer
: GH/250607
Datum laatste wijziging
: 22 januari 2008
Documentversie/release
: 1.2
Documentstatus
: Definitief
Florecom Coderingen 1.1
beschrijving coderingen
Copyright © Florecom, 2008 Alle rechten voorbehouden. Niets uit deze uitgave mag worden verveelvoudigd, opgeslagen in een geautomatiseerd gegevensbestand, of openbaar gemaakt, in enige vorm of op enige wijze, hetzij elektronisch, mechanisch, door fotokopieën, opnamen of enig andere manier, zonder voorafgaande schriftelijke toestemming van stichting Florecom. Voor toestemming neemt u contact op met: Stichting Florecom, Postbus 205, 1430 AE Aalsmeer.
Disclaimer Florecom besteedt de uiterste aandacht aan de informatie die zij via haar website en FTP-site verspreidt. Florecom kan echter niet instaan voor de juistheid, volledigheid en tijdigheid van die informatie. Aan de informatie op de website en FTP-site kunnen dan ook geen rechten worden ontleend. Florecom sluit alle aansprakelijkheid uit voor enigerlei schade, direct of indirect en van welke aard dan ook, die voortvloeit uit of in enig opzicht verband houdt met het gebruik van deze sites of de daarop geplaatste informatie, danwel met de onmogelijkheid om deze sites of de daarop geplaatste informatie op enig moment te raadplegen. Verwijzingen naar andere websites en hyperlinks zijn slechts opgenomen ter informatie van de bezoeker van deze site. Florecom staat niet in voor de inhoud of betrouwbaarheid, in welk opzicht dan ook, van die websites en hyperlinks. Florecom behoudt zich alle rechten voor met betrekking tot de op deze sites geplaatste informatie. Openbaarmaking langs andere weg of bewerking van die informatie is niet toegestaan zonder voorafgaande toestemming van Florecom.
Pagina 2
22 januari 2008
Florecom Coderingen 1.1
beschrijving coderingen
Inhoud 1.
Wijzigingsblad
5
2.
Inleiding
6
2.1
Doel van dit document
6
2.2
Bestemd voor...
6
2.3
Uitgangspunten
6
2.4
Distributie
6
2.5
Afkortingen en begrippen
6
3.
Florecom Coderingen
7
4.
Bedrijfscode codelijst
8
4.1
Definitie
8
4.2
Relatie
8
4.3
Inhoud
8
4.4
Voorbeeld
9
5.
Bedrijfsniveau codelijst
10
5.1
Definitie
10
5.2
Relatie
10
5.3
Inhoud
10
5.4
Voorbeeld
10
6.
Bedrijfsrol codelijst
11
6.1
Definitie
11
6.2
Relatie
11
6.3
Inhoud
11
6.4
Voorbeeld
11
7.
Locatiecode codelijst
12
7.1
Definitie
12
7.2
Relatie
12
7.3
Inhoud
12
7.4
Voorbeeld
13
8.
Locatie type codelijst
14
8.1
Definitie
14
8.2
Relatie
14
Pagina 3
22 januari 2008
Florecom Coderingen 1.1
beschrijving coderingen
8.3
Inhoud
14
8.4
Voorbeeld
14
9.
Prijsleveringsvoorwaarde codelijst
15
9.1
Definitie
15
9.2
Relatie
15
9.3
Inhoud
15
9.4
Voorbeeld
15
10.
Beladinginstructie codelijst
16
10.1
Definitie
16
10.2
Relatie
16
10.3
Inhoud
16
10.4
Voorbeeld
16
11.
Data-elementen codelijst
17
11.1
Definitie
17
11.2
Relatie
17
11.3
Inhoud
17
11.4
Voorbeeld
17
Pagina 4
22 januari 2008
Florecom Coderingen 1.1
1.
beschrijving coderingen
Wijzigingsblad
Datum 15-8-2007 15-8-2007 7-1-2008
Versie 1.0 1.1 1.2
Akkoord Gecontroleerd
Auteur G. Heemskerk G. Heemskerk G. Heemskerk
Datum 7-1-2008 7-1-2008
Geaccepteerd namens 7-1-2008 Werkgroep CMG Coderingen Geaccepteerd namens 7-1-2008 Werkgroep standaarden
Wijzigingen Initiële versie Na review CMG Toegevoegd codelijsten (FEC03): - Prijsleveringsvoorwaarden - Beladinginstructies - Data-elementen Toegevoegd: - paragraaf 2.4 Distributie Functionaris G. Heemskerk (Florecom) R. de Horde (FloraHolland) A. Oskam (FloraHolland) B. Ensink (HBAG) H. van Rossen (Florecom) H. Zwinkels (Florecom) G. Heemskerk (voorzitter)
Paraaf
F. P. Dechering (Florecom)
Pagina 5
22 januari 2008
Florecom Coderingen 1.1
2. 2.1
beschrijving coderingen
Inleiding Doel van dit document
Dit document beschrijft de Florecom coderingen die door Florecom worden beheerd en gedistribueerd. In dit document zijn de gegevenssets, de bestandnamen, de definities en beschrijvingen van de codelijsten opgenomen. 2.2
Bestemd voor...
Dit document is bestemd voor gegevensafnemers van Florecom codelijsten. 2.3
Uitgangspunten
Dit document is gebaseerd op: - Algemene Implementatie Richtlijnen Coderingen 1.1 (coderingen volgens algemene aspecten codelijsten; het ‘Linnaeus formaat’). De volgende uitgangspunten worden gehanteerd: - RFC 2007-2 (ronde 2) 2.4
Distributie
De codelijsten worden als gegevenssets (in de vorm van ZIP bestanden per gegevensbeheerder/eigenaar) door Florecom gedistribueerd. De distributie van gegevenssets vindt op de onderstaande wijzen plaats: via website Florecom : http://www.florecom.nl via FTP Server : codes.florecom.nl, Initiële directory : codes, Port : 21 FTP: upload flag: tijdens uploaden verschijnt het bestand: aUploading FTP: einde flag: na einde uploaden verschijnt het bestand: aFinished. Toeganggegevens voor de codelijsten via FTP is middels ‘Aanvraagformulier FTP Codelijsten toegang’ te verkrijgen. Gegevenssets die in testfase zijn zullen op codetest.florecom.nl beschikbaar komen. 2.5 RFC
Afkortingen en begrippen Request for Change
Pagina 6
22 januari 2008
Florecom Coderingen 1.1
3.
beschrijving coderingen
Florecom Coderingen Florecom coderingen beheert en gedistribueerd door Florecom in de vorm van gegevenssets. Een gegevensset bevat één of meerdere codelijsten. Het Florecom releasebeleid is van toepassing op deze gegevenssets. Gegevenssets zijn daarom voorzien van een release- en versienummer in de bestandsnaam en volgen de releasemomenten van ketensoftware. Florecom biedt 3 gegevenssets aan: Gegevensset
Inhoud
Frequentie
FEC010101.zip
Bedrijfscodes met gerelateerde codelijsten
wekelijks
FEC020101.zip
Locatiecodes met gerelateerde codelijsten
wekelijks
FEC030101.zip
Florecom overige codelijsten
maandelijks
FEC 01/02/03 01 01
= Florecom = gegevensetnummer = releasenummer = versienummer
Inhoud gegevenssets: Bestands- BestandsCode naam 1 CCmmddjj.txt FCmmddjj.txt 2 CNmmddjj.txt FNmmddjj.txt 3 CRmmddjj.txt FRmmddjj.txt 4 CLmmddjj.txt FLmmddjj.txt 5 CTmmddjj.txt FTmmddjj.txt 6 CPmmddjj.txt FPmmddjj.txt 7 CImmddjj.txt FImmddjj.txt 8 CDmmddjj.txt Fdmmddjj.txt
Codelijst
FEC01
FEC02
Bedrijfscode
X
X
Bedrijfsniveau
X
X
Bedrijfsrol
X
X
Locatiecode
X
Locatietype
X
FEC03
Prijsleveringsvoorwaarden
X
Beladinginstructies
X
Data-elementen
X
Pagina 7
22 januari 2008
Florecom Coderingen 1.1
4.
beschrijving coderingen
Bedrijfscode codelijst
4.1
Definitie Een bedrijf is een in de bloemisterij opererende onderneming. Deze onderneming wordt op het bedrijfsniveau ‘organisatie’ (bijv. een holding) of ‘commercieel’ vastgelegd. Een commercieel bedrijf is een bedrijf dat transacties afsluit bij de verhandeling van bloemen en planten en beschikt over een aanvoerdernummer of debiteurennummer bij één of meerdere Nederlandse bloemenveilingen.
4.2
Relatie Een bedrijf kan meerdere locaties hebben. Een locatie kan aan meerdere bedrijven toebehoren.
4.3
Inhoud De codelijst ‘company’ heeft de volgende inhoud. Field 1 2 3 4
Field_name Code_list_id GLN_company_address_code company_name FH_registration_nr
M/C M M M C
5
VBA_registration_nr
C
6
VON_registration_nr
C
7
company_location_level_code
M
8
company_role_code
M
9
entry_date
M
10 11
expiry_date change_date_time
C M
format key Contents N..3 '1' N13 P # Bedrijfscode (GLN) AN..70 Bedrijfsnaam N..6 FloraHolland administratienummer. N..6 Bloemenveiling Aalsmeer administratienummer. N..7 Veiling Oost Nederland administratienummer. N1 zie Florecom bedrijfsniveau codelijst. 1 = organisatie 2 = commercieel A1 zie Florecom bedrijfsrol codelijst. B = Koper S = Verkoper A = Agent O = (Beheer)organisatie C = Transporteur …. N8 P # Ingangsdatum (ccyymmdd), zie toelichting hergebruik N8 Vervaldatum (ccyymmdd) N12 Mutatiedatum/tijd (ccyymmddhhmm)
Hergebruik: Het komt voor dat relaties van veilingen worden uitgeschreven om vervolgens enige tijd later te worden heropend. De bedrijfscode zal dan door worden hergebruikt. Daarnaast komt het voor dat een vervallen administratienummer van de veiling later voor andere (nieuwe) relatie wordt gebruikt. In een dergelijk geval zal een nieuwe bedrijfscode (GLN) worden toegekend. Om deze redenen is de ingangsdatum in de sleutel van het record opgenomen.
Pagina 8
22 januari 2008
Florecom Coderingen 1.1
4.4
beschrijving coderingen
Voorbeeld 1;8714231201724;BOUMAN VOF;42947;0;0;2;B;20070101;;200701011000
Pagina 9
22 januari 2008
Florecom Coderingen 1.1
5. 5.1
beschrijving coderingen
Bedrijfsniveau codelijst Definitie Een bedrijfsniveau beschrijft het aggregatieniveau van een bedrijf. Een bedrijf kan als organisatie (bijvoorbeeld Holding) of commercieel bedrijf worden vastgelegd.
5.2
Relatie Eén bedrijfsniveau kan aan meerdere bedrijven toebehoren. Eén bedrijf kent één bedrijfsniveau.
5.3
Inhoud De codelijst ‘company_location_level’ heeft de volgende inhoud. Field Field_name 1 code_list_id 2 company_location_level_code 3 4 5 6
5.4
M/C format Key Contents M N..3 '2’ M N1 P # Bedrijfsniveaucode company_location_level_description M AN..35 Bedrijfsniveauomschrijving entry_date M N8 Ingangsdatum (ccyymmdd) expiry_date C N8 Vervaldatum (ccyymmdd) change_date_time M N12 Mutatiedatum/tijd (ccyymmddhhmm)
Voorbeeld 2;2;Commercial;20070101;;200701011000
Pagina 10
22 januari 2008
Florecom Coderingen 1.1
6.
beschrijving coderingen
Bedrijfsrol codelijst
6.1
Definitie Een bedrijfsrol beschrijft de functie van een bedrijf binnen de keten.
6.2
Relatie Eén bedrijfsrol kan aan meerdere bedrijven toebehoren. Eén bedrijf kent per bedrijfscode één bedrijfsrol.
6.3
Inhoud De codelijst ‘company_role’ heeft de volgende inhoud. Field Field_name 1 code_list_id 2 company_role_code
6.4
M/C M M
3 4
company_role_description entry_date
M M
5
expiry_date
C
6
change_date_time
M
format Key contents N..3 '3’ A1 P # Rol die het bedrijf binnen de keten heeft. AN..35 Bedrijfsrolomschrijving N8 Ingangsdatum (ccyymmdd N8 Vervaldatum (ccyymmdd) N12 Mutatiedatum/tijd (ccyymmddhhmm)
Voorbeeld
3;B;Buyer;20070101;;200701011000 3;S;Seller;20070101;;200701011000
Pagina 11
22 januari 2008
Florecom Coderingen 1.1
7.
beschrijving coderingen
Locatiecode codelijst
7.1
Definitie Een locatie is een fysieke locatie van een bedrijf waar logistieke processen plaatsvinden. De fysieke locatie kan een vestiging zijn, dan wel een specifiek deel binnen die vestiging. Een deel van een vestiging wordt aangeduid als ‘de logistieke plaats’ (bijvoorbeeld dock). Zodra plaatsen binnen een vestiging worden gecodeerd, zal de locatiecode van de vestiging komen te vervallen. De generieke locatiecode maakt dan plaats voor een specifieke locatiecode(s).
7.2
Relatie Eén locatie kan aan meerdere bedrijven toebehoren. Eén bedrijf kan meerdere locaties hebben.
7.3
Inhoud De codelijst ‘location’ heeft de volgende inhoud. Field 1 2 3
Field_name code_list_id GLN_location_code GLN_company_address_code
M/C M M M
format Key N..3 N13 P# N13 PF #
4 5 6
street_name street_number street_number_suffix
M M C
AN..35 AN..9 AN..6
7 8 9
postal_identificaion_code city_name country_name_code
M M M
AN..9 AN..35 AN..3
10
location_type_code
M
N..3
11
location_name
C
AN..35
12
location_description
C
AN..70
Pagina 12
contents '4' Locatiecode Bedrijfscode waartoe locatiecode behoort Straatnaam Huisnummer Huisnummer toevoeging Postcode Plaatsnaam zie ISO 3166-1 code lijst (2 posities) Zie eveneens toelichting landcode. zie Florecom locatie type codelijst in geval v/e vestiging - locatie type code voor bijv. een box of tuin in geval v/e plaats: - locatie type code voor bijv. een dock of kas. Specifieke naam van de locatie: Voorbeeld in geval v/e vestiging ‘C003 – 15B’ of Voorbeeld in geval v/e een plaats ‘C003 – 15B Dock 36’ Generieke (beschrijvende) naam 22 januari 2008
Florecom Coderingen 1.1
beschrijving coderingen
van de locatie, bijvoorbeeld: in geval v/e vestiging - bijv. omschrijving ‘VBA Noord’
13
entry_date
M
N8
14
expiry_date
C
N8
15
change_date_time
M
N12
P#
in geval v/e plaats - bijv. omschrijving ‘dock achterzijde’ Ingangsdatum (ccyymmdd) Vervaldatum (ccyymmdd) Mutatiedatum/tijd (ccyymmddhhmm)
Toelichting landcode: Voor de landcode wordt verwezen naar de ISO landcode codelijst (3166-1) zoals deze opgenomen binnen de ISO Coderingen welke door Florecom beschikbaar worden gesteld. 7.4
Voorbeeld 4;8713783201671;8713782601359;Veilingweg;2;A;2678LN;De Lier;NL;6;;;20070102;;200701021000
Pagina 13
22 januari 2008
Florecom Coderingen 1.1
8. 8.1
beschrijving coderingen
Locatie type codelijst Definitie Een locatie type beschrijft de functie van een fysieke locatie waar logistieke processen plaatsvinden. Een locatie type kan een box zijn (bedrijfsniveau 3: vestiging), dan wel een specifiek deel van die vestiging, bijvoorbeeld een dock (bedrijfsniveau 4: plaats).
8.2
Relatie Eén locatie type kan tot meerdere locaties behoren. Eén locatie kent één locatie type.
8.3
Inhoud De codelijst ‘location_type’ heeft de volgende inhoud. Field Field_name M/C format Key Contents 1 code_list_id M N..3 '5’ 2 company_location_level_code M N1 PF Bedrijfsniveaucode. # 3 = vestiging 4 = (logistieke) plaats (deel v/e vestiging) 3 location_type_code M N..3 P # locatie type code 4 location_type_description C AN..35 locatie type omschrijving 5 entry_date M N8 Ingangsdatum (ccyymmdd) 6 expiry_date C N8 Vervaldatum (ccyymmdd) 7 change_date_time M N12 Mutatiedatum/tijd (ccyymmddhhmm)
8.4
Voorbeeld 5;3;2;Box;20070101;;200701011000
Pagina 14
22 januari 2008
Florecom Coderingen 1.1
9. 9.1
beschrijving coderingen
Prijsleveringsvoorwaarde codelijst Definitie Een prijsleveringsvoorwaarde beschrijft de leveringsvoorwaarden van een prijs.
9.2
Relatie Geen
9.3
Inhoud De codelijst ‘price_delivery_terms’ heeft de volgende inhoud. Field Field_name 1 code_list_id 2 price_delivery_terms_code 3
4 5 6
9.4
M/C format Key Contents M N..3 '6’ M AN..3 P # Prijsleveringsvoorwaardecode price_delivery_terms_description M AN..70 Prijsleveringsvoorwaarde omschrijving entry_date M N8 Ingangsdatum (ccyymmdd) expiry_date C N8 Vervaldatum (ccyymmdd) change_date_time M N12 Mutatiedatum/tijd (ccyymmddhhmm)
Voorbeeld 6;32;Af Bloemenveiling Aalsmeer NL;20070101;;200701011000
Pagina 15
22 januari 2008
Florecom Coderingen 1.1
10.
beschrijving coderingen
Beladinginstructie codelijst
10.1
Definitie Een beladinginstructie beschrijft de wijze van het beladen van een ladingdrager in de vorm van een instructie.
10.2
Relatie Geen
10.3
Inhoud De codelijst ‘loading_instruction’ heeft de volgende inhoud. Field Field_name 1 code_list_id 2 packaging_mode_code
10.4
M/C format M N..3 M AN..3
3
packaging_mode_description
M
AN..35
4
entry_date
M
N8
5
expiry_date
C
N8
6
change_date_time
M
N12
Key P#
Contents '7’ Beladinginstructiecode Beladinginstructieomschrijving Ingangsdatum (ccyymmdd) Vervaldatum (ccyymmdd) Mutatiedatum/tijd (ccyymmddhhmm)
Voorbeeld
7;3;Gestapeld met dozen er boven;20070101;;200701011000
Pagina 16
22 januari 2008
Florecom Coderingen 1.1
11.
beschrijving coderingen
Data-elementen codelijst
11.1
Definitie De basisbouwstenen voor uitwisseling van informatie zijn de data-elementen. In de berichten kan op data-element niveau worden verwezen naar een data-element codelijst. De codelijst bevat alle toegestane waarden van een data-element.
11.2
Relatie Geen
11.3
Inhoud De codelijst ‘data_element’ heeft de volgende inhoud. Field Field_name 1 code_list_id 2 date_element_code
11.4
M/C M M
format N..3 N4
3
date_element_value
M
AN..8
4
date_element_value_description
M
AN..70
5
date_element_remarks
C
AN..70
6
entry_date
M
N8
7
expiry_date
C
N8
8
change_date_time
M
N12
Key Contents '8’ P # Data-element code P # Data-element waarde Data-element waarde omschrijving Toelichting dataelement waarde Ingangsdatum (ccyymmdd) Vervaldatum (ccyymmdd) Mutatiedatum/tijd (ccyymmddhhmm)
Voorbeeld
8;1222;2;overgenomen product;;20070101;;200701011000
Pagina 17
22 januari 2008