Bestanden
In e-CertNL is het mogelijk om orderregels bij een zending te importeren uit een bestand. Er worden twee bestandsformaten ondersteund: CSV en XML.
CSV
Een CSV-bestand is een tekstbestand waarin op elke regel een orderregel staat. Gegevens op een regel worden gescheiden door een komma, een puntkomma, een tab of een “staander” (piping- teken).
De eerste regel van dit bestand moet een zogenaamde kopregel zijn, waarin de kolommen worden benoemd. De daaropvolgende regels zijn steeds gegevens per orderregel, die zijn opgebouwd volgens de kolommen zoals gedefinieerd in de eerste regel.
Indien er in de kopregel kolomnamen voorkomen die niet in de database voorkomen, dan wordt deze kolom, en de bijbehorende gegevens in de vervolgregels van het bestand genegeerd. Hiervan wordt geen melding gemaakt.
Indien een regel meer gegevens bevat dan het aantal kolommen in de kopregel, worden de overtollige gegevens genegeerd.
Indien een regel minder gegevens bevat dan het aantal kolommen in de kopregel, worden de missende gegevens als leeg (null) geïnterpreteerd.
Indien de gegevens een verkeerde tekensoort bevat (bijvoorbeeld letters op een nummeriek veld), dan volgt er een foutmelding en wordt de verwerking geannuleerd.
Indien de inhoud van een veld een stuurteken bevat (een scheidingsteken, dubbele aanhalings- tekens, CR/LF), dan dient het hele veld tussen dubbele aanhalingstekens te staan. Indien het veld zelf ook dubbele aanhalingstekens bevat, dan dient dat aangegeven te worden met 2x dubbele aanhalingstekens.
Voorbeeld: “Dubbele ““qoutes”” doe je zo”.
Veld separatieteken
Kies hier het teken dat in het CSV-bestand gebruikt wordt om de velden te onderscheiden. Let op: indien u hier kiest voor de komma, dan mag bij
het Decimale teken niet ook de komma geselecteerd zijn. Meest gebruikt is de punt-komma.
Regel separatieteken
Er wordt onderscheid gemaakt tussen de DOS EOL (ASCII-code 13+10) en de UNIX EOL (ASCII- code 10).Bij automatisch wordt er uit gegaan van methode DOS, behalve als er in het hele CSV-bestand geen ASCII-code 13 wordt gevonden. Laat deze instelling bij voorkeur op “Automatisch” staan.
Bewerking
Geef aan hoe u de ingelezen gegevens wilt toepassen.
Aanvullen
De ingelezen regels worden toegevoegd aan de order. Indien de order al orderregels bevat blijven deze bestaan. In dit geval moet iedere regel van het CSV-bestand een orderregelnummer bevatten dat nog niet bestaat in deze order.
Vervangen
De ingelezen regels worden toegevoegd aan de order. Indien de zending al orderregels bevat worden de bestaande regels verwijderd.
Wijzigen
De ingelezen regels overschrijven alleen de reeds bestaande regels van de order. In dit geval moet iedere regel een orderregelnummer bevatten dat al bestaat in de order.
Datumformaat
Geef aan in welk formaat eventuele datums in het CSV-bestand staan.
Decimaal teken
Kies of het decimaalteken de punt (Amerikaans systeem) of de komma (Nederlands systeem) is. Let op: indien u hier kiest voor de komma, dan mag bij het Veld seperatieteken niet óók de komma geselecteerd zijn.
In Nederland wordt doorgaans de komma als decimaalteken gebruikt.
Velden / Kolomnamen
De kolomnamen worden voorafgegaan door “x/”, “c/” of “e/”. De velden die met “x/” beginnen betreffen ordergegevens. Daarnaast zijn er ook velden die met “e/” (exporteiskenmerk) en “c/” (certificaatkenmerk) beginnen. Deze zijn niet opgenomen in deze handleiding, omdat ze veranderlijk zijn en afhankelijk van de sector.
| Gegeven op het scherm | Label in CSV-bestand (niet hoofdlettergevoelig) |
|---|---|
| Nummer van orderregel (verplicht) | x/nummer |
| Referentie | x/referentienummer |
| Productnaam (verplicht) | x/product_naam |
| Productcode op certificaat | x/artikelcode_cft |
| Productnaam op het certificaat | x/artikelomschrijving_cft |
| Artikelcode (alleen voor CZU) | x/artikelcode_ocs |
| Artikelomschrijving (alleen voor CZU) | x/artikelomschrijving_ocs |
| Inspectielocatie (verplicht) | x/opslaglocatie_adressering (Gebruik in Excel ALT-Enter om een regeleinde in te voeren) |
| Netto hoeveelheid (verplicht) | x/netto_hoeveelheid |
| Artikeleenheid (verplicht) | x/eenheid Invoeren als code: Gram = 500 Kilogram = 505 Meter = 510 Liter = 515 Stuks = 081 (voorloopnul !) |
| Bruto hoeveelheid | x/bruto_hoeveelheid |
| Aantal eenheden | x/aantal |
| Handelseenheid (doos, pallet, stuk, enz.) | x/handelseenheid |
| Erkenningsnummer | x/erkenningsnummer |
| Erkenningssoort | x/erkenning_soort |
| Adres erkende | x/erkende_adressering |
| Producent erkenningsnummer | x/producent_erkenningsnummer |
| Producent adres | x/producent_adressering |
| Verpakker adres | x/verpakker_adressering |
| Verpakker erkenningsnummer | x/verpakker_erkenningsnummer |
| Productiedatum | x/productiedatum |
| Productiedatum tot | x/productiedatum_tot |
| Productieperiode | x/productieperiode |
| Productiedatum melk | x/productiedatum_melk |
| Productiedatum melk tot | x/productiedatum_melk_tot |
| Invriesdatum | x/invriesdatum |
| Invriesdatum tot | x/invriesdatum_tot |
| Slachtdatum | x/slachtdatum |
| Slachtdatum tot | x/slachtdatum_tot |
XML
De eenvoudigste manier om een XML-bestand voor uw sector samen te stellen, is een bestaande orderregel uit een van uw eerdere aanvragen te exporteren. In het overzicht met orderregels vind u de knop Exporteer alle orderregels, zie toelichting op het scherm orderregels.
Het bewerken van een XML-bestand kan met een eenvoudige tekstverwerker, maar er is ook gespecialseerde software te vinden.
Heeft u het XML-bestand aangevuld met de gegevens van alle orderregels, dan kunt u deze toevoegen aan een zending via de knop Importeer in het overzicht van orderregels.
Bij het importeren kunt aangeven hoe de gegevens verwerkt moeten worden, net als bij het CSV-bestand, zie omschrijving hierboven.