FPB CLOCKT 3.4 Functionele beschrijving Kloktransactiebericht

Transcriptie

1 FPB CLOCKT 3.4 Functionele beschrijving Kloktransactiebericht Bestandsnaam : HvR0197v2.3 FPB CLOCKT 3.4.docx Bestandsnummer : HvR/0197 Datum laatste wijziging : 5 mei 2009 Documentversie/release : 2.3/3.4 Documentstatus : Definitief

2 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 FTPsite 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 5 mei 2009

3 Inhoud 1. Wijzigingsblad 4 2. Inleiding Doel van dit document Bestemd voor Uitgangspunten Afkortingen en begrippen 5 3. Toepassing van het Florecom CLOCKT bericht 6 4. Koppeling tussen CLOCKT bericht en distributie-bon 7 Bijlage 1. Invulinstructie CLOCKT 8 Bijlage 2. Wijzigingen t.o.v. CLOCKT Pagina 3 5 mei 2009

4 1. Wijzigingsblad Versie Auteur Wijzigingen 2.0 Hans van Rossen Nieuw: verzending vanuit FloraHolland Bleiswijk 2.1 Hans van Rossen Ronde verwerkt, Release Hans van Rossen Tekstuele verbeteringen. 2.3 Hans van Rossen Gewijzigde distributiebon naaldwijk. Akkoord Datum Functionaris Paraaf Hans van Rossen HvR (Auteur) Gecontroleerd Kwaliteitscontrole Florecom Geaccepteerd namens Werkgroep CMG Geaccepteerd namens Werkgroep standaarden A. Oskam (FloraHolland) B. Ensink (HBAG) Gerhard Heemskerk (Florecom) Hans van Rossen (Florecom CMG Kwekers) Frans-Peter Dechering (Florecom WG Standaarden) AO BE GH HvR FPD Pagina 4 5 mei 2009

5 2. Inleiding 2.1 Doel van dit document Het CLOCKT-bericht wordt toegepast door de veilingen om op een standaard wijze commerciële transactiegegevens elektronisch te versturen naar de handelaren. Het kloktransactie verantwoordingsbericht bevat voor een bepaalde datum een of meerdere kloktransacties die op een veiling hebben plaatsgevonden. De transacties behoren bij één kopernummer. 2.2 Bestemd voor... Dit document is bestemd voor softwareleveranciers van ketenpartners en voor Stichting Florecom. 2.3 Uitgangspunten Dit document is gebaseerd op: - Edifact Message Library D.93A - RFC s uit ronde De volgende uitgangspunten worden gehanteerd: - Beeldreferenties zijn conform VBN beeldbeleid 2.4 Afkortingen en begrippen EKT FEC Klok transactie Spoedkoop BI Kenmerkcode Kenmerkwaarde VBN Elektronische klok transactie Florecom (codebeheerder) Transactie gemaakt op een klok in één der tribunes van de Nederlandse bloemenveilingen Transactie gekocht met indicatie spoedkoop (FH Rijnsburg) Met een toeslag wordt de gekochte partij versneld afgeleverd in de box van de koper. Betrouwbaarheidsindex van de aanleverende kweker samengesteld uit het aantal fouten in bericht en zelfkeur. Codelijst aanduiding van de VBN kenmerkcodes, deze omvatten productkenmerken, sorteerkenmerken, kwaliteitskenmerken, logistieke kenmerken. enz. In de CLOCKT kunnen maximaal 99 kenmerken per regel worden meegegeven. Unieke identifier van een kenmerk uit een VBN kenmerkcodelijst. Verenigde Bloemenveilingen Nederland (codebeheerder) Pagina 5 5 mei 2009

6 3. Toepassing van het Florecom CLOCKT bericht In het berichtscenario, dat een volgordelijke weergave van de berichtuitwisseling tussen partijen is, neemt het leveringbericht de volgende plaats in: Figuur 1: Berichtuitwisseling Het CLOCKT-bericht geeft de (medewerkers in de box van de) koper informatie over gekochte producten op de klok. Deze informatie kan worden gebruikt om de producten die worden afgeleverd door de veiling te controleren (bijv. aantal fusten), om de producten al (administratief) te verdelen over aanwezige orders of om facturen voor de klanten te maken. Het CLOCKT-bericht bevat informatie waarmee de koppeling naar de barcode op de distributiebon kan worden gemaakt. Pagina 6 5 mei 2009

7 4. Koppeling tussen CLOCKT bericht en distributie-bon De indeling van de barcode op de distributie-bon is het volgende: Bij FloraHolland Aalsmeer, Bleiswijk Naaldwijk en Rijnsburg Barcodepositie Betekenis Veld in CLOCKT Pos. 1 Voorloopcode (altijd 0 ) (Bij Aalsmeer niet afgedrukt op bon) Pos. 2-3 Veilingcode NAD, party qualifier = FLA Pos. 4-5 Kloknummer RFF, reference qualifier = FAC Pos. 6-8 Dagnummer Pos Commercieel transactienummer RFF, reference qualifer = AGJ Pos Logistiek transactievolgnummer (Bij Rijnsburg altijd 00 Pos. 16 Herstartindicatie (altijd 0 ) Pos Aantal fusten QTY, quantity qualifier = 66 Bij TFA Barcodepositie Betekenis Veld in CLOCKT Pos. 1 Voorloopcode (altijd 0 ) Pos. 2-3 Veilingcode NAD, party qualifier = FLA Pos. 4-5 Kloknummer RFF, reference qualifier = FAC Pos. 6-8 Dagnummer Pos Commercieel transactienummer RFF, reference qualifer = AGJ Pos Logistiek transactievolgnummer Pos Aantal fusten QTY, quantity qualifier = 66 Pagina 7 5 mei 2009

8 Bijlage 1. Invulinstructie CLOCKT Segment Data Omschrijving Verplicht Lengte Waarde element UNB S001:0001 Syntax identificatie Ja a4 UNOA S001:0002 Syntax Versienummer Ja n1 2 S002:0004 Identificatie Verzender Ja An13 FEC bedrijfscode veiling D93A S002:0007 Partner Identificatie Ja an S003:0010 Identificatie Ontvanger Ja an..35 Adm.Nr. Koper S003:0007 Partner Id. qualifier Ja an..4 ZZ S003:0014 Adres Specificatie Nee an..14 S004:0017 Datum aanmaak transmissie Ja n6 YYMMDD S004:0019 Tijd aanmaak transmissie Ja n4 HHMM (00<=HH<=23) 0020 Transmissie Identificatienummer Ja an..14 Uniek transmissienummer S005:0022 Wachtwoord ontvanger Nee an..14 S005:0025 Wachtwoord qualifier Nee an Identificatie softwareleverancier Nee an..14 Volgens dataelementenlijst spatie versienummer 0035 Test Indicatie Nee n1 1 = testbericht UNH 0062 Bericht nummer Ja an..14 S009:0065 Type EDI-Bericht Ja an..6 CLOCKT S009:0052 Versie nummer Ja an S009:0054 Release nummer Ja an S009:0051 Organisatie Ja an..2 EF BGM C002:1001 Bericht type Ja an = klok-transactie DTM C507:2005 Transactiedatum Ja an C507:2380 Datum Ja n8 CCYYMMDD C507:2379 Formaat Datum Ja an (= CCYYMMDD) NAD 3035 Qualifier koper Ja an..3 BY C082:3039 Kopernummer Ja n..6 Veiling kopernummer NAD 3035 Qualifier afleverlocatie Ja an..3 DP C082:3039 Afleverlocatie koper Ja n..13 FEC Locatiecode C082:1131 Party ID Ja an C082:3055 Code list resp. agency Ja an..3 9 NAD 3035 Qualifier veilingcode Ja an..3 FLA C082:3039 Waarde Ja n..6 Volgens data-elementenlijst LIN C212:7140 VBN productcode Ja n..7 Volgens VBN productcodelijst Max 999x C212:7143 Type productcode Ja an..3 VBN DTM C507:2005 Procesdatum en -tijd Ja an..3 9 C507:2380 Commerciële transactietijd Ja n6 HHMMSS C507:2379 Formaat Ja an (= HHMMSS) NAD 3035 Qualifier producent Ja an..3 MF C082:3039 Kwekernummer Ja n..6 Veiling aanvoerdernummer RFF C506:1153 Qualifier toevoeging transactienr. Ja an..3 AAD C506:1154 Koper subnummer Ja an..7 Wordt niet gebruikt bij Aalsmeer RFF C506:1153 Ja an..3 ACE C506:1154 Karnummer Ja an..7 Alleen voor Rijnsburg en Venlo RFF C506:1153 Ja an..3 ACE C506:1154 Partij aanvoerbriefnummer Ja an..7 Voor Aalsmeer, Naaldwijk, Bleiswijk en Eelde C506:1156 Partij aanvoerbriefvolgletter Ja an1 RFF C506:1153 Qualifier koperplaatnummer Ja an..3 ADZ C506:1154 Koperplaatnummer Ja an..7 RFF C506:1153 Qualifier transactie volgnr per klok Ja an..3 AGJ C506:1154 Transactie volgnummer per klok Ja an..7 RFF C506:1153 Qualifier te leveren partij Ja an..3 BT C506:1154 Barcode distributiebon Ja an..26 Niet bij Eelde, Venlo en Bleiswijk RFF C506:1153 Qualifier zetelnummer Ja an..3 CTS C506:1154 Zetelnummer Ja an..7 RFF C506:1153 Qualifier kloknummer Ja an..3 FAC C506:1154 Kloknummer Ja an..7 RFF C506:1153 Qualifier partij veilvolgnummer Ja an..3 FAN C506:1154 Partij veilvolgnummer Ja an..7 RFF C506:1153 Qualifier beeldreferentie Ja an..3 IRN C506:1154 Beeldreferentie Ja an..26 Volgens beeldbeleid: 13 pos FEC bedrijfscode van de bron + volgnr. C506:4000 Volgnummer Ja n..3 1 = Hoofdfoto, 2, 3, 4 enz. Bijfoto Pagina 8 5 mei 2009

9 QTY C186:6063 Qualifier APE Ja an C186:6060 Aantal stuks per eenheid Ja n..4 QTY C186:6063 Qualifier aantal eenheden Ja an C186:6060 Gekocht aantal eenheden Ja n..4 PRI C509:5125 Qualifier inkoopprijs Ja an..3 INV C509:5118 Prijs in Euro (3 dec.) Ja n..9 max. 9 pos., dec. punt, drie dec. C509:5284 Prijs Inclusief in Euro (Aalsmeer 1 ) Nee n..9 max. 9 pos., dec. punt, drie dec. IMD 7081 VBN productkenmerkcode Ja an3 S99 C273:7008 (Afwijkende) productomschrijving Ja an..35 Hoofdletters (Zie UNB.S ) IMD 7081 VBN productkenmerkcode Ja an3 K01 of K02 C273:7009 Keurcode negatief Ja an..3 Zie VBN kenmerkwaarde codelijst IMD 7081 VBN productkenmerkcode Ja an3 P01 of P02 of P03 C273:7009 Fytosanitair (P01), Kwaliteit (P02) Ja an..3 Zie VBN kenmerkwaarde codelijst Veilingspecifiek (P03) IMD 7081 VBN productkenmerkcode Ja an3 S62 C273:7009 Land van herkomst Ja an..3 Zie VBN kenmerkwaarde codelijst IMD 7081 VBN kenmerkcode Ja an3 V22 (Alleen Aalsmeer) C273:7009 Fleurprimeurindicatie Ja an IMD 7081 VBN productkenmerkcode Ja an3 S97 C273:7009 Overige leveranciers informatie Ja an..3 Bijvoorbeeld 004 = MPS A, 008 = MPS B, 009 = MPS C IMD 7081 VBN productkenmerkcode Ja an3 S98 C273:7009 Kwaliteitsklasse Ja an..3 A1 of A2 of B1 IMD 7081 Kenmerkcode Ja an3 Zie VBN kwaliteit codelijst K11 C273:7009 Betrouwbaarheids Index waarde Ja an..3 BI klasse A t/m E IMD 7081 VBN productkenmerkcode Ja an3 S61 C273:7009 Extra toevoeging (steeketiket, hoes) Ja an..3 Zie VBN kenmerkwaarde codelijst PRI C509:5125 Qualifier prijstoevoeging Ja an3 APT C509:5118 Prijs van extra toevoeging Ja n..9 max. 9 pos., dec. punt, drie dec. IMD 7081 Kenmerkcode Ja an3 V02 (Alleen Rijnsburg) C273:7009 Spoedkoopindicatie Ja an IMD 7081 Kenmerkcode Ja an3 L11 C273:7009 Aantal stelen per bos Ja an IMD tot max 99x 7081 Overige/Toekomstige Kenmerkcode Ja an3 Zie VBN kenmerk codelijst C273:7009 Kenmerkwaarde Ja an..3 Zie VBN kenmerkwaarde codelijst PAC C202:7065 Fustcode Ja an..3 Zie VBN fustcodelijst. Bij producten zonder fust (zoals kerstbomen) code 800 gebruiken PRI C509:5125 Qualifier fustkoopprijs Ja an..3 PAP C509:5118 Waarde Ja n..9 max. 9 pos., dec. punt, drie dec. C509:5387 Qualifier fusthuurprijs Nee an..3 PRP C509:5284 Waarde Nee n..9 max. 9 pos., dec. punt, drie dec. EQD 8053 Qualifier transportmiddel Ja an..3 BX C224:8155 Transportmiddel Ja n..2 Zie data-elementenlijst: 1 (stapel-wagen) 2 (deense container 2 ) EQN C523:6350 Partij aantal transportmiddelen Ja n..5 (Aalsmeer: Het aantal hele transportmiddelen gekocht in 1 commerciële transactie. 0 = geen hele kar gekocht, 1 = hele kar, 2 = 2 hele karren, etc.) C523:6353 Waarde Ja an..3 2 (# stuk transportmiddelen) EQN C523:6350 Commerciële transactie aantal tableaus Ja n..5 Bij DC aantal bladen, bij STW aantal extra legborden. C523:6353 Waarde Ja an..3 3 (# lagen) EQD Max 4x 8053 Qualifier logistiek middel Ja an C224:8155 Logistiek middel Ja n..2 Zie data-elementenlijst voor logistieke middelen. 11 Deense container bled, 19 Nederlandse veiling container bled 1 De inclusiefprijs in Aalsmeer bevat de commerciële transactieprijs aangevuld met de volgende heffingen: splitsheffing, PT heffing, DC heffing, serviceheffing en fusthuur. De prijs wordt verlaagd met: Bonus-eenkoop. N.B. De Inclusiefprijs kan dus ook lager dan de Klokprijs zijn. 2 In geval van denenveilen wordt enkel de monsterstapelwagen in meerdere transacties verkocht, Denen worden altijd per hele kar verkocht. Pagina 9 5 mei 2009

10 EQN C523:6350 Aantal stuks logistieke middelen Ja n..5 Aantal C523:6353 Waarde Ja an..3 1 (# stuks logistieke middelen) UNT 0074 Aantal segmenten in een bericht Ja n..6 UNH is het 1 ste segment en UNT is het laatste segment 0062 Bericht referentie nummer Ja an..14 Is gelijk aan ref nummer in dataelement 0062 uit UNH UNZ 0036 Controlecijfer Ja n Bericht referentienummer Ja an..14 Zelfde als in data-element 0020 uit UNB Legenda Verplichte segmenten Optionele segmenten Pagina 10 5 mei 2009

11 Bijlage 2. Wijzigingen t.o.v. CLOCKT 3.3 LEVEL 0 UNB C 1 UNH BGM DTM UNT UNZ C 1 1 NAD M 3 1M 999 LIN 2C 99 3C 1 4C 5 2 DTM NAD RFF C 20 QTY M 2 PRI IMD PAC EQD 3 PRI C 1 PRI C 1 EQN C 2 Segment Wijziging UNH:S009: wordt 004 NAD Van 2 naar 3 voorkomens NAD:3035 Nieuwe qualifier DP Delivery party, voor opgave van FEC locatiecode voor afleveren goederen door de veiling. NAD:C082:3039 FE format van n..6 naar n..13 t.b.v. FEC locatiecode NAD:C082:1131 Was not used, nu verplicht bij gebruik NAD+DP voor opgeven codelijst. NAD:C082:3055 Was not used, nu verplicht bij gebruik NAD+DP voor opgeven beheerder LIN:RFF Van 7 naar 20 voorkomens LIN:RFF:C506:1153 Nieuwe qualifier BT Batch number/lot number, voor opgave van de volledige barcode zoals afgedrukt staat op de distributiebon van deze te leveren partij. Nieuwe qualifier IRN Image Reference Number, voor opgave van één of meerdere referenties naar beelden van de gekochte partij. LIN:RFF:C506:1154 FE format van an..7 naar an..26 t.b.v. Barcode en Beeldreferentie. LIN:RFF:C506:4000 Was not used, nu verplicht bij opgave van beeldreferenties voor indicatie Hoofdfoto = 1 en Bijfoto s = 2, 3, 4, enz. Pagina 11 5 mei 2009