U vindt hieronder informatie over deze onderwerpen:
Taakomschrijving
De GPS-dienstverlener stuurt na ontvangst van een databericht of een testbericht een melding naar het AGR-GPS-apparaat, waarin hij meedeelt of het bericht al dan niet correct en volledig werd ontvangen. AGR-GPS is de afkorting van 'Automatische Gegevens Registratie Global Positioning System'.
De GPS-dienstverlener moet de berichten, die hij volledig en correct ontvangen heeft van een AGR-GPS-apparaat, onmiddellijk doorsturen naar de centrale server van de Mestbank. Voordat hij dat doet moet hij:
- als de databerichten afkomstig zijn van een AGR-GPS-apparaat dat niet automatisch de koppeling kan maken tussen het nummer van de sensor en het chassisnummer van de laadruimte waarop de sensor is bevestigd, het nummer van de sensor vervangen door het chassisnummer van de laadruimte waarop de sensor is bevestigd en het naar de centrale server van de Mestbank doorsturen
- het identificatienummer en het wachtwoord dat hij als GPS-dienstverlener ontvangen heeft van de Mestbank toevoegen.
De overige gegevens die hij doorstuurt, mogen niet gewijzigd worden.
De databerichten die naar de centrale server van de Mestbank worden verstuurd, mogen alleen toegankelijk zijn voor de GPS-dienstverlener zolang de centrale server bij de Mestbank geen bericht heeft verstuurd dat het verstuurde databericht correct en volledig werd ontvangen door de Mestbank.
De GPS-dienstverlener moet de gegevens van elk databericht minstens bewaren totdat hij van de centrale server van de Mestbank het bericht krijgt dat het databericht volledig en correct is ontvangen door de Mestbank.
Wanneer de GPS-dienstverlener van de centrale server van de Mestbank het bericht krijgt dat het databericht niet volledig en correct is ontvangen door de Mestbank, moet de GPS-dienstverlener het databericht opnieuw verzenden.
Als de GPS-dienstverlener andere berichten dan de databerichten en testberichten ontvangt van het AGR-GPS-apparaat, mag de GPS-dienstverlener die niet doorsturen naar de centrale server van de Mestbank.
Implementatie van het AGR-GPS-systeem
AGR-gegevens worden opgeslagen in een AGR-GPS-apparaat op het transportmiddel en met GPRS doorgestuurd naar de centrale server van de GPS-dienstverlener. Van daaruit worden de gegevens doorgestuurd via een webservice naar de centrale server bij de Mestbank. Nadat de Mestbank de gegevens heeft ontvangen, wordt het bericht gecontroleerd en wordt een succes- of errorcode teruggestuurd. Voor het versturen van berichten wordt gebruikgemaakt van een XML-bericht.
Versturen van berichten door de GPS-dienstverlener in XML-schema
Alle gegevens in het XML-bericht, verstuurd door de GPS-dienstverlener naar de centrale server van de Mestbank, moeten opgenomen worden volgens de hierna bepaalde volgorde. Alle velden worden omsloten door XML-tags.
Begin <?XML version="1.0"encoding= "ISO-8859-1" ?>
<Opgave>
<IdentificerendDeel>
<webserviceversion>XXX</ webserviceversion>
<gegevensaanleveraarCode>XXX</gegevensaanleveraarCode>
<gegevensaanleveraarWachtwoord>XXX</gegevensaanleveraarWachtwoord>
</IdentificerendDeel>
Begin data <AgrGegevens>
Header <DataTestbericht>XXX</DataTestbericht>
Apparatuur <AgrIdentificatie>XXX</AgrIdentificatie>
<Storingsindicatie>XXX</Storingsindicatie>
Formulier <MadNummer>XXX</ MadNummer>
<EvoaNummer>XXX</ EvoaNummer>
<DataCompleet>XXX</DataCompleet>
<LaadruimteIdentificatie>XXX</ LaadruimteIdentificatie>
Transport Laden<LadenInlezenFormulierGpsLocatie>XXX</LadenInlezenFormulierGpsLocatie>
<LadenInlezenFormulierGpsDatum>XXX</LadenInlezenFormulierGpsDatum>
<LadenInlezenFormulierGpsTijd>XXX</LadenInlezenFormulierGpsTijd>
Tussen <TussenGpsLocatie>XXX</TussenGpsLocatie>
<TussenGpsDatum>XXX</TussenGpsDatum>
<TussenGpsTijd>XXX</TussenGpsTijd>
Lossen <LossenGpsLocatie>XXX</LossenGpsLocatie>
<LossenGpsDatum>XXX</LossenGpsDatum>
<LossenGpsTijd>XXX</LossenGpsTijd>
Einde data </AgrGegevens>
Einde </Opgave>
Verklaring van de gegevens:
Sectie Begin (verplicht bij ieder databericht): deze sectie bestaat uit een identificerend gedeelte waar het identificatienummer en het wachtwoord van de GPS-dienstverlener wordt meegegeven. (gegevensaanleveraarCode, gegevensaanleveraarWachtwoord).
De GPS-dienstverlener ontvangt van de Mestbank bij registratie een identificatienummer en een wachtwoord. Om een transparant versiebeheer toe te laten, wordt het versienummer van de gebruikte webservice (webserviceversion) in het bericht vermeld.
-
Sectie Header (verplicht bij ieder databericht): er is een mogelijkheid tot het versturen van een testbericht, waarbij het veld "DataTestbericht" moet worden ingevuld met de keuze uit 'J' of 'N'.
-
Sectie Apparatuur (verplicht bij ieder databericht): het AGR-GPS-apparaat heeft een uniek AGR-nummer, dat toegekend is door de Mestbank. Dit AGR-nummer moet ingevuld worden in het veld Agrldentificatie. Mocht er een storing (belemmering waardoor de GPS-ontvanger geen GPS-signaal ontvangt) zijn geweest op het moment van het versturen van het databericht vanuit het AGR-GPS-apparaat naar de GPS-dienstverlener, dan wordt dit in het veld "Storingsindicatie" "J" aangegeven.
-
Sectie Formulier (verplicht bij ieder databericht): voor iedere mesttransportcyclus kan slechts één vervoersdocumentnummer "MadNummer of EvoaNummer" ingevuld worden. Dat nummer wordt ingevoerd in het AGR-GPS-apparaat. Het veld "Datacompleet" ('J' of 'N') geeft aan of de mesttransportcyclus al dan niet beëindigd is. In het veld DataCompleet kan enkel "J" worden ingevuld wanneer het een databericht is over het lossen van meststoffen. Wanneer de laadruimte waarin de meststoffen zich bevinden, is voorzien van een sensor, moet de GPS-dienstverlener zorgen dat als inhoud voor het veld "LaadruimteIdentificatie" het chassisnummer van de laadruimte ingevuld is. Dat veld mag maximaal 17 karakters bevatten.
-
Sectie Transport
-
Sectie Laden en Lossen en Tussen (bij ieder databericht minstens een laad-, tussen – of losplaatspositie): tijdens de mesttransportcyclus worden er databerichten verstuurd over het laden van meststoffen, over het lossen van meststoffen en over de tussentijdse positie van het transportmiddel. Bij het laden van meststoffen moet de erkende mestvoerder het nummer van het vervoersdocument invoeren.
Sectie onderdelen positiebepalingen. Bij elk databericht moeten de laatst gemeten GPS-gegevens doorgegeven worden.
Voor het doorgeven van de GPS-positiegegevens moet de volgende methode worden gebruikt:
Latitude/Longitude, WGS84.
Het formaat bestaat uit een aanduiding in graden (D) en minuten (M), aangevuld met een aanduiding in N(orth)/S(outh) voor latitude, en een aanduiding in E(ast)/W(est) voor longitude.
De minuten zijn hierbij in decimale getallen, met een fractie achter het punt.
Formaat: DDMM.MM,[N/S],DDDMM.MM,[E/W]
Voorbeeld: 5050.04,N,00421.12,E
Een positiebepaling bestaat uit het vastleggen van de volgende gegevens:
- GpsLocatie: GPS-coördinaten, die worden gelezen uit de ontvangen GPS-gegevens (latitude/longitude,WGS84).
- GpsDatum: datum waarop de coördinaten waren vastgelegd, die rechtstreeks wordt overgenomen uit de ontvangen GPS-gegevens. De datum moet worden verstuurd in het formaat: ddmmyyyy en weergegeven volgens UTC (Coordinated universal time).
- GpsTijd: tijdstip waarop de coördinaten waren vastgelegd, dat rechtstreeks wordt overgenomen uit de ontvangen GPS-gegevens. Het tijdstip moet worden verstuurd in het formaat: uumm en weergegeven volgens UTC (Coordinated universal time).
Momenten van positiebepaling:
Van iedere mesttransportcyclus moeten de volgende GPS-gegevens worden geregistreerd:
- LadenInlezenFormulierGpsLocatie: positiebepaling net voor het laden van meststoffen
- LadenInlezenFormulierGpsDatum (zie GpsDatum)
- LadenInlezenFormulierGpsTijd (zie GpsTijd)
- LossenGpsLocatie: positiebepaling net voor het lossen van meststoffen.
- LossenGpsdatum (zie GpsDatum)
- LossenGpsTijd (zie GpsTijd)
- TussenGpsLocatie: tussentijdse plaatsbepalingen (om de 15 km)
- TussenGpsDatum (zie GpsDatum)
- TussenGpsTijd (zie GpsTijd)
Tijdens het verzenden en ontvangen van databerichten kunnen problemen optreden, waardoor berichten verkeerd kunnen overkomen of helemaal niet overkomen. Uit de inhoud van de bevestiging is af te leiden of een verzonden databericht in goede staat is ontvangen. Als de bevestiging in zijn geheel uitblijft, moet ervan worden uitgegaan dat het bericht niet is overgekomen. Als dit soort communicatieproblemen optreden, moet naargelang het geval waar de problemen zich situeren, het AGR-GPS-apparaat of de GPS-dienstverlener proberen de transportgegevens opnieuw te versturen.
Bevestiging door de Mestbank
Een door een GPS-dienstverlener verstuurd bericht wordt ontvangen op een daarvoor bestemde HTTPS-server bij de Mestbank.
Als het bericht niet correct is toegekomen op de centrale server van de Mestbank wordt een "HTTP-error" code gegeven aan de centrale server van de GPS-dienstverlener. Bevestigingen via de "HTTP Error code" hebben uitsluitend betrekking op het al dan niet correct toekomen van het bericht en niet over de inhoud ervan. Als het bericht correct toekomt op de centrale server van de Mestbank, krijgt de GPS-dienstverlener een "succesbericht".
Nadat de Mestbank de gegevens heeft ontvangen, wordt het bericht op inhoud gecontroleerd. Het controleren van het XML-bericht, verstuurd door de GPS-dienstverlener, houdt de controle in van de opbouw, de volledigheid en het formaat van het bericht, zoals gespecificeerd volgens het XML-schema hierboven. Er wordt ook gecontroleerd of de gegevensaanleveraarCode en het gegevensaanleveraarWachtwoord overeenstemmen met deze gekend bij de Mestbank. Het antwoord wordt gegeven door middel van een code in het XML-bericht (zie tabel onderaan)
Het XML-bericht verstuurd naar de GPS-dienstverlener door de Mestbank als bevestiging bestaat uit de hierna bepaalde gegevens. Alle velden worden omsloten door XML-tags.
<?XML version="1.0"encoding= "ISO-8859-1" ?>
<Terugmelding>
<statusCode>XXX</statusCode>
</Terugmelding>
De inhoud van de gegevens, zoals het AGR-nummer van het AGR-GPS-apparaat op het transportmiddel (AgrIdentificatie), wordt achteraf gecheckt in de backoffice.
De code met omschrijving wordt volgens classificatie ingedeeld (code 0 tot 4)
0
| goed
| 0 | gegevens geaccepteerd voor verdere verwerking | het bericht is goed ontvangen. |
| 1 | authenticatie | 1 | de gegevensaanleveraarcode en wachtwoord zijn niet correct. | het identificatienummer en het wachtwoord zijn niet in overeenstemming met de gekende gegevens bij de Mestbank. |
| 2 | unexpected lay-out
| 2 | het document is niet goed gevormd en beantwoordt niet aan het XML-schema. | het bericht is niet volgens de standaarden van het XML-schema gevormd. |
| 3 | unexpected content-type | 3 | de inhoud van de velden in het bericht zijn foutief. | de inhoud van de velden in het bericht zijn niet in het juiste formaat. |
| 4 | service not available | 4 | de service is niet beschikbaar. | het informatiesysteem van de Mestbank is tijdelijk niet beschikbaar. |
Communicatiestoringen van de AGR-GPS-apparatuur
Als er netwerk- of serverproblemen optreden, kunnen de berichten niet doorgestuurd worden naar de server van de Mestbank.
De wetgeving stelt dat het AGR-GPS-apparaat de gegevens van elk databericht minstens moet bewaren tot het apparaat van de GPS-dienstverlener het bericht krijgt dat het databericht volledig en correct ontvangen werd. Als dit niet onmiddellijk lukt, moet het apparaat het bericht bufferen en onophoudelijk opnieuw proberen te verzenden.
Als er echter een langdurig probleem optreedt, moet de dienstverlener zo snel mogelijk contact opnemen met de Mestbank om het probleem te melden. Zo kan de Mestbank de erkende mestvoerders met gerichte informatie helpen om de hinder tot een minimum te beperken.
Dienstverleners kunnen deze meldingen of andere vragen versturen naar het e-mailadres dienstverleners-agrgps@vlm.be
Wetgeving