Stappenplan koppelen Kringloopwijzer Het is van belang om z.s.m. te koppelen met Kringloopwijzer zodat uw klanten met een druk op de knop de leveringsgegevens kunnen inlezen in Kringloopwijzer. Als u tijdig koppelt kunnen uw klanten over 2015 de voer- en kunstmestleveringen automatisch inlezen in de KringloopWijzer waardoor ze tijd besparen en fouten worden voorkomen. Onderstaand vind u de stappen om snel te kunnen koppelen met Kringloopwijzer. Stap 1: Aanmelden Stuur een mail naar koppelingen@dekringloopwijzer.nl en geef aan dat u wilt koppelen met Kringloopwijzer*. Vermeld bedrijfsgegevens met KvK nr., contactpersonen (technisch en functioneel) en hun telnr en mailadres(sen) Geef ook aan welke gegevensgroepen u wilt uitwisselen: voer / kunstmest / fourage (meerdere gegevensgroepen mogelijk) Hebt u nog geen koppeling met EDI Circle vraag dan een overeenkomst EDI Circle op via koppelingen@dekringloopwijzer.nl, deze overeenkomst kunt u ingevuld terugsturen. Stap 2: Intake Na aanmelding nemen we contact met u op om de aansluiting meer in detail af te stemmen Wanneer u nog geen koppeling met EDI circle heeft lever dan z.s.m. aan: o Gegevens van minimaal 1 klant: NAW-gegevens, klantnr., KvK-nr en BRS-nr. i.v.m. het technisch testen van de koppeling. o Gegevens over de webservice (endpoint en inloggegevens) waarmee getest kan worden Stuur deze gegevens naar koppelingen@dekringloopwijzer.nl Als we alle bovenstaande informatie binnen hebben richten we de koppeling voor u in** Stap 3: Testen van de inrichting Als de koppeling is ingericht sturen we u de inloggegevens van de Kringloopwijzer Daarna kunt u zelf testbedrijven in Kringloopwijzer aanmelden en machtigen (zie instructie acceptatietest Kringloopwijzer") Na de inrichting kunt u de werking van de koppeling testen (zie instructie acceptatietest Kringloopwijzer ) Loopt u bij het testen aan tegen knelpunten meldt deze dan via koppelingen@dekringloopwijzer.nl, we nemen dan contact met u op Mochten alle testen succesvol zijn geef dan accoord om de koppeling live te zetten via koppelingen@dekringloopwijzer.nl Wij zorgen er daarna voor dat de koppeling operationeel gemaakt wordt Wanneer u medio september live wilt zijn met uw koppeling met Kringloopwijzer dan is het noodzakelijk dat u voor 31 juli alle bovengenoemde informatie aanlevert en de berichten in het beschreven standaardformaat aanbiedt. * De kosten voor het configureren van de koppeling binnen EDI Circle zijn eenmalig 400 euro *Mocht u de berichten niet in het AgroConnect XML standaard 1.05 formaat kunnen aanleveren dan kan VAA ICT consultancy ondersteuning bieden op basis van nacalculatie om uw formaat om te zetten in dit standaardformaat
Bijlage 1: Technische specificaties AgroConnect XML standaard versie 1.05 In de bijgesloten zip-files vindt u alle technische documentatie om de berichten conform de Agroconnect XML standaard versie 1.05 uit te wisselen. In bijlage 2 staan de protocollen die hierbij worden ondersteund. De aangeleverde berichten moeten aan deze standaarden voldoen*. De volgende bestanden hebben betrekking op de berichtstandaard: 141211.Invoerinstructie XML-Leveringsbericht voor Kringloopwijzer.pdf: Informatie over het vullen van attributen die wel door de KringloopWijzer gebruikt worden, maar niet door CRV Mineraal. Specificatie XML-Leveringsbericht v1.05, 19feb15.pdf: Beschrijving van het leveringsbericht. Dit document geeft aan hoe de velden in het bericht in de praktijk gevuld worden. Datamodel XML-Leveringsbericht: De structuur van het bericht in PDF formaat: RPT_ Bericht Leveringsb. v1.05, 9nov12.pdf: volgorde van elementen in het bericht RPT_ Gebeurtenissen Leveringsb. v1.05, 9jan15.pdf: lijst van XML-elementen met beschrijving RPT_ Gegevenselementen Leveringsb. v1.05, 9jan15.pdf: lijst van XML-attributen met beschrijving RPT_ Coderingslijsten Leveringsb. v1.05, 3nov14.pdf: lijsten van gebruikte codes met hun betekenis XML-Leveringsbericht-Voorbeelden: Voorbeelden van leveringsbericht-xml bestanden. *Mocht u de berichten niet in het AgroConnect XML standaard versie 1.05 kunnen aanleveren dan kan VAA ICT consultancy ondersteuning bieden op basis van nacalculatie om uw formaat om te zetten in het standaardformaat
Bijlage 2: Technische specificaties protocollen uitwisseling berichten In de bijgesloten zip-files vindt u alle technische documentatie van de protocollen die ondersteund worden bij het uitwisselen van berichten. De aangeleverde berichten moeten aan deze standaarden voldoen*. U heeft keuze uit 2 uitwisselprotocollen: 1. Volgens de AgroConnect webservice standaard: Protocol XML-Leveringsbericht v1.04, 15nov10.pdf: Beschrijving van de AgroConnect standaard webservice voor het ophalen van leverberichten (pull). Dit document geeft aan hoe de webservice zich gedraagt. XSDs XML-Leveringsbericht: technische beschrijving van het XML-leveringsbericht en de webservice: algemeen: https://nl.wikipedia.org/wiki/xml_schema en https://nl.wikipedia.org/wiki/web_services_description_language) 2. Volgens het insturen o.b.v. de EDI webservice: EDI-Circle-berichten-insturen-soapui-project.xml: push berichten aanleveren naar EDI Circle HL Upload WebService EDI-Circle (AgroConnect leveringsbericht).doc: upload webservice voor push berichten naar EDI Circle
Bijlage 3: instructie acceptatietest Kringloopwijzer Onderstaand een korte instructie voor het inrichten van het testbedrijf van een voorbeeld veehouder waarmee u kunt testen of de berichten via de koppeling goed binnenkomen in Kringloopwijzer. Het testen kent een aantal stappen: 1. Aanmelden van de veehouder waarmee getest wordt 2. Testen van het binnenkomen van leveringsberichten 1. Aanmelden veehouder Zoek de website www.kringloopwijzer.vaa.com op. Dit is de testomgeving van Kringloopwijzer. U komt dan op onderstaande website. Log vervolgens in via Inloggen met E-Herkenning: Log hier in als veehouder met het gekozen testbedrijf
Voer bij eherkenning token 10 karakters (cijfers of letters) in te starten met de eerste 3 letters van de bedrijfsnaam Vul het KvK nummer van de veehouder in Klik op de knop eherkenning omzeilen, u komt dan op de volgende pagina: Vul hier de persoonlijke gegevens van de veehouder van het voorbeeldbedrijf in. LET OP: vul bij het mailadres uw eigen adres in en niet dat van de veehouder! Anders krijgt de veehouder de mail van de testen. Bij hoedanigheid kiezen voor veehouder. Aanvinken dat u akkoord gaat met de voorwaarden. Als alles is ingevuld klikt u op Wanneer er gegevens aanwezig zijn wordt je automatisch ingelogd. Wanneer je niet automatisch wordt ingelogd geeft het systeem de volgende melding:
Wanneer u deze melding krijgt neem dan contact op via koppelingen@dekringloopwijzer.nl Nu bent u klaar met het deel voor het aanmelden van de veehouder.
2. Testen binnenkomen berichten Als het aanmelden goed is verlopen ziet u het volgende scherm: Kies hier het menu dat betrekking heeft op het leveringsbericht dat verstuurd is, bijvoorbeeld voer om te controleren of de leveringsberichten voor voer binnen zijn. Kies voor de optie Aanleg en aanvoer voorraad, u komt dan in het volgende scherm:
Om na te gaan of er leveringsberichten binnen zijn gekomen klikt u op De berichten die via de koppeling zijn binnengekomen worden dan als volgt getoond: Controleer of de berichten correct en compleet zijn, te denken valt aan de volgende controles: Algemene controles Test minimaal 3 klanten Verschillende artikelsoorten, check of deze terugkomen bij de juiste categorie Verschillende diercategorieen, check of de leveringen a.d.h.v. de codes juist worden ingelezen of afgewezen Juiste berekening van gehalten, N, P, Ras, VEM Updates van leveringsberichten, worden waarden overschreven Retouren, worden leveringen met negatieve hoeveelheden correct verwerkt (ook kg N, P etc.) Leveringen met ontbrekende gehalten N, P, Ras Checken op gehalten buiten de toegestane waarden Opvragen gegevens over periode langer dan 1 jaar worden leveringen van klanten met meerdere afleveradressen bij elkaar opgeteld Enz. Specifieke controles (alleen van toepassing bij bijproducten en strooisel) Bij natte bijproducten juiste berekening van kg ds, N, P, Ras Strooisel wordt via segment Diversen aangeleverd en ingelezen\ Enz. Als dit het geval is dan is de test geslaagd, mail dan het akkoord van de test naar koppelingen@dekringloopwijzer.nl Als dit niet het geval is werkt de koppeling nog niet helemaal goed, meldt dit dan via koppelingen@dekringloopwijzer.nl