Info GPS-dienstverleners voor AGR-GPS-app

​​U vindt hieronder informatie over deze onderwerpen:

Taakomschrijving

De GPS-dienstverlener stuurt na ontvangst van een databericht of een testbericht een melding naar de AGR-GPS-app, 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-app, onmiddellijk doorsturen naar de centrale server van de Mestbank. Voordat hij dat doet moet hij 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 de AGR-GPS-app, mag de GPS-dienstverlener die niet doorsturen naar de centrale server van de Mestbank.

Implementatie van de AGR-GPS-app

AGR-gegevens worden opgeslagen in de AGR-GPS-app en via mobiele data of een andere beschikbare dataverbinding 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): elke landbouwer 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 de AGR-GPS-app 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 transportdocumentnummer "MadNummer of EvoaNummer" ingevuld worden. Dit is het transportnummer dat wordt ingevoerd in de AGR-GPS-app.
    • 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.
    • In het veld "LaadruimteIdentificatie" moet het laadvermogen opgegeven worden van de aanhangwagen.
  • 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 landbouwer het nummer van het transport 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 5 minuten) 
      • 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, de AGR-GPS-app 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 de landbouwer (AgrIdentificatie), wordt achteraf gecheckt in de backoffice.

De code met omschrijving wordt volgens classificatie ingedeeld (code 0 tot 4)

klasse omschrijving status code terugmelding omschrijving
0goed0gegevens geaccepteerd voor verdere verwerkinghet bericht is goed ontvangen.
1authenticatie1de  gegevensaanleveraarcode en wachtwoord zijn niet correct.het identificatienummer en het wachtwoord zijn niet in overeenstemming met de gekende gegevens bij de Mestbank.
2unexpected lay-out2het document is niet goed gevormd en beantwoordt niet aan het XML-schema.het bericht is niet volgens de standaarden van het XML-schema gevormd.
3unexpected content-type3de inhoud van de velden in het bericht zijn foutief.de inhoud van de velden in het bericht zijn niet in het juiste formaat.
4service not available4de service is niet beschikbaar.het informatiesysteem van de Mestbank is tijdelijk niet beschikbaar.

​Gebruik van de AGR-GPS-app door de vervoerder

Telkens de vervoerder (aanbieder of afnemer) meststoffen laadt, start een nieuwe mesttransportcyclus. Een correcte invoer van de AGR-GPS-berichten gebeurt als volgt:

  • De vervoerder start een mesttransportcyclus bij het laden van mest. Dat doet hij als volgt:
    • Hij vult het nummer van het transport in de app in.
    • Hij geeft het laadbericht door. Dat laadbericht moet hij geven op het moment dat hij stilstaat op de exacte laadplaats en voordat hij begint te laden
  • Tijdens het transport stuurt de AGR-GPS-app om de 5 minuten een automatisch tussenbericht over de tussentijdse positie.
  • Als de vervoerder aankomt op het perceel waarvoor de mest bestemd is, voert hij voordat hij begint te lossen een losbericht in. Als de mest bestemd is voor verschillende percelen, voert de vervoerder op elk perceel voordat hij begint te lossen een losbericht in.
  • Nadat de volledige vracht is gelost op het laatste perceel, voert de vervoerder vlak voordat hij dat perceel verlaat een definitief losbericht in (met indicatie dat het om de laatste losplaats gaat). Dat is het einde van de mesttransportcyclus. 

​Communicatiestoringen van de AGR-GPS-app

Als er netwerk- of serverproblemen optreden, kunnen de berichten niet doorgestuurd worden naar de server van de Mestbank.

De wetgeving stelt dat de AGR-GPS-app de gegevens van elk databericht minstens moet bewaren tot de app van de GPS-dienstverlener het bericht krijgt dat het databericht volledig en correct ontvangen werd. Als dit niet onmiddellijk lukt, moet de app 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 landbouwers 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.
Terug naar boven