ANVA Hub (vanuit ANVA 4/5)

Inleiding ANVA Hub (vanuit ANVA 4/5)

ANVA Hub is een platform van ANVA met diverse functionaliteit. Als je bijvoorbeeld gebruik wilt maken van de RDC Voertuigscan of RDW koppeling vanuit de ANVA 4/5, verloopt dat via een koppeling met de ANVA Hub. Ook het downloaden van nieuwe releases voor ANVA 4/5 verloopt technisch gezien via ANVA Hub.

Om vanuit ANVA 4/5 gebruik te kunnen maken van de ANVA Hub, is enige inrichting in ANVA 4/5 nodig.

Inrichting ANVA voor ANVA Hub

ANVA Hub activeren in ANVA

Controleer of ANVA Hub al geactiveerd is.

Pad: BYSA, deel 7

1. Controleer of ANVA Hub op Ja staat.
2. Klik op Afsluiten en antwoord Ja op de vraag 'Alles akkoord?'.
3. Staat ANVA Hub op Nee? Neem dan contact op met de Customer Support van ANVA.

Extra gebruikers aanmaken op ANVA Hub

Als beheerder heb jij de rechten om extra gebruikers aan te maken, zodat jouw collega’s toegang krijgen tot ANVA Hub. Bekijk onze tutorial om te zien hoe je dat kan doen.

Rollen in ANVA Hub

De volgende rollen kun je toekennen aan een gebruiker in ANVA Hub:

Microsoft365-account koppelen in ANVA Hub

Wanneer je gebruik maakt van Microsoft 365, kun je jouw Microsoft365 account koppelen aan ANVA Hub. Daardoor kun je jouw e-mails in ANVA Hub zien en kan je deze meteen koppelen aan een relatie en/of contract. Bekijk onze tutorial om te zien hoe je dit doet.

Werken met ANVA Hub

Inloggen bij ANVA Hub

Je kunt inloggen met je [gebruikersnaam] en wachtwoord bij ANVA Hub via hub.anva.io.

Notitie Ben je beheerder bij een serviceprovider? Dan heb je waarschijnlijk rechten bij meerdere 'tenants'. Bij het inloggen opent het laatste kantoor waarop je ingelogd was. Je kunt dan rechtsboven in ANVA Hub (naast je profiel) van kantoor ('tenant') wisselen.
Als je voor het eerst inlogt, opent het eerste kantoor waarvoor je rechten hebt. Ook dan kun je rechtsboven in het scherm van kantoor wisselen.

Wachtwoord wijzigen in ANVA Hub

Je hebt van ANVA een account voor ANVA Hub ontvangen, dat bestaat uit een gebruikersnaam en een wachtwoord. Om veiligheidsredenen moet je het wachtwoord direct wijzigen in een wachtwoord dat alleen jij weet.

Om je wachtwoord te wijzigen:

ANVA Hub

1. Log in op ANVA Hub met de gebruikersnaam en het wachtwoord zoals je die van ANVA hebt gekregen. Zie: Inloggen bij ANVA Hub.
2. Klik op je naam, rechtsboven in het scherm.
3. Klik op Profiel.
4. Klik op Wachtwoord aanpassen.
5. Vul je Oude wachtwoord in
6. Vul je Nieuwe wachtwoord.

   Notitie Het nieuwe wachtwoord moet minstens 8 tekens bevatten, waarvan minimaal 1 kleine letter, 1 hoofdletter, 1 cijfer en 1 leesteken.

7. Klik op Valideren.

Multifactorauthenticatie in ANVA Hub (extra beveiliging)

Multifactorauthenticatie betekent dat je niet alleen inlogt met een gebruikersnaam en wachtwoord, maar ook met bijvoorbeeld een code die je op je smartphone genereert. Als iemand met minder goede bedoelingen wil inloggen op jouw account, heeft hij dus niet alleen jouw gebruikersnaam en wachtwoord nodig, maar ook je smartphone (een tweede 'factor').

Om op deze manier extra veilig in te loggen in ANVA Hub, heb je dus een smartphone met een authenticator-app nodig, bijvoorbeeld Google-authenticator. Deze kun je zelf downloaden op je telefoon en aan ANVA Hub koppelen.

Of multifactorauthenticatie raadzaam is, hangt er vanaf waar het account voor gebruikt wordt:

• Bij een persoonlijk account (dat je dagelijks zelf gebruikt om in te loggen) is het raadzaam om multifactorauthenticatie in te schakelen.
• Als het gaat om een systeem- of service-account moet je geen multifactorauthenticatie gebruiken. Zo'n account wordt ook 'onder water' gebruikt tussen ANVA 4/5 en ANVA Hub zonder tussenkomst van mensen.

Om multifactorauthenticatie aan te zetten voor je account in ANVA Hub:

ANVA Hub

1. Log in op ANVA Hub met de gebruikersnaam en het wachtwoord zoals je die van ANVA hebt gekregen. Zie: Inloggen bij ANVA Hub.
2. Klik op je naam, rechtsboven in het scherm.
3. Klik op Profiel.
4. Klik op MFA aanzetten.
5. Volg de stappen op het scherm in combinatie met Google Authenticator op je smartphone.

IP-adres management ANVA Hub

IP-adres alllowlist maken in ANVA Hub

Met het gebruik van een IP-adres allowlist is het mogelijk om de basisveiligheid (inlognaam/wachtwoord en eventueel MFA-code) te verhogen. Met deze lijst specificeer je vanaf welke public IP-adressen het is toegestaan om toegang te krijgen tot ANVA Hub. Je kunt de allowlist alleen aanmaken als je een beheerdersaccount hebt.

IP-adres management op ANVA Hub kan op verschillende OpenID clients worden ingesteld. Er zijn twee mogelijkheden:

• ANVA Hub gebruikers | medewerkers

  Als een klant het inloggen via een gebruikersaccount wil beperken, dan moet de klant de publieke IP-adressen van de medewerkers met een ANVA Hub gebruikersaccount toevoegen aan de OpenID client met de naam ‘Hub frontend’. Als ze op kantoor en thuis met een ander IP-adres werken dan moeten ze allebei worden toegevoegd. Ook moet het per tenant op ANVA Hub apart worden ingevoerd.

• Externe applicaties XML-koppeling | Business Apps (klantmap) | Telefoniekoppeling

  Als een klant het inloggen door een externe applicatie met een OpenID client wil beperken, dan moet de klant twee dingen instellen:

  1. Alle publieke IP-adressen van deze externe partij moeten worden toegevoegd aan de OpenID client van die betreffende partij. Bijvoorbeeld AWI, Finly, DDi, maar ook externe partijen zoals Business Apps voor de klantmap of een telefonieleverancier zoals Dstny.
  2. Het publieke IP-adres van de ANVA 4/5 server moet ook worden toegevoegd aan de OpenID client van de externe partij.

Weet je niet hoe je het public IP-adres kan achterhalen, neem dan contact op met je systeembeheerder.

Om een IP-adres allowlist te maken voer je de volgende stappen uit:

1. Selecteer rechtsboven de organisatie waarvoor je de allowlist wil aanmaken
2. Klik op Mijn Organisatie
3. Klik op Beheer OpenID Client
4. Klik op de desbetreffende OpenID Client (de algemene OpenID Client heet: Hub Frontend)
5. Klik op IP-adres management
6. Klik op + IP-adres toevoegen
7. Vul het public IP-adres in en geef een duidelijke omschrijving
8. Vink IP-adres management toepassen aan, wanneer je wilt dat alleen de gebruikers waarvan de public IP-adressen op de lijst staan nog toegang hebben tot ANVA Hub. Direct na het aanvinken en bevestigen is de lijst actief en kunnen alleen gebruikers die werken vanaf een public IP-adres die op de lijst staat inloggen.
   

   Let op Vink IP-adres management toepassen pas aan, als je eigen public IP-adres op de lijst staat.

Notitie Zodra de allowlist actief is, kunnen gebruikers alleen inloggen of data ophalen op ANVA Hub vanaf een IP-adres dat op deze lijst staat. Een sessie wordt beëindigd wanneer een gebruiker overstapt op een verbinding waarvan het IP-adres niet op de allowlist staat. Bijvoorbeeld wanneer er een sessie start met een IP-adres dat op de allowlist staat, maar vervolgens de verbinding wijzigt. Dit kan het geval zijn wanneer er wordt verbonden met een ander wifipunt of wordt overgeschakeld naar een mobiel apparaat. De gebruiker wordt dan automatisch uitgelogd.

IP-adressen toevoegen binnen een bepaald bereik in ANVA Hub

Je kunt IP-adressen die binnen een bepaald bereik vallen op de allowlist zetten.

Ga allereerst naar het IP-adres waarvoor je het bereik wilt instellen:

1. Klik op Mijn Organisatie
2. Klik op Beheer OpenID Client
3. Klik op de desbetreffende OpenID Client
4. Klik op IP-adres management
5. Klik op + IP-adres toevoegen

Er zijn verschillende opties om het bereik aan te passen, waaronder:

• Wildcard
  1. Klik onder Acties op het potlood-icoontje bij het desbetreffende IP-adres
  2. Vervang de laatste twee cijfers na de punt door een *

• Ranges
  1. Klik onder Acties op het potlood-icoontje bij het desbetreffende IP-adres
  2. Vervang de twee getallen na de tweede punt voor 0-255

Overzicht inlogpogingen in ANVA Hub

Je kunt als beheerder de gelukte en mislukte inlogpogingen bekijken door de volgende stappen te doorlopen:

1. Selecteer rechtsboven de organisatie waarvan je de inlogpogingen wilt bekijken
2. Klik op Mijn Organisatie
3. Klik op Beheer OpenID Client
4. Klik op de desbetreffende OpenID Client
5. Klik op Inlogpogingen

Wanneer een inlogpoging mislukt is, wordt dit geregistreerd en vind je dit terug in het overzicht. Je kunt het IP-adres dan alsnog meteen toevoegen aan de allowlist door onder Acties op + te klikken. Vul indien gewenst een omschrijving in en klik op Verifiëren en opslaan.

Je kunt in de tab Inlogpogingen zoeken en filteren. Je kunt zoeken op locatie of IP-adres. Daarnaast kun je filteren op Resultaat inlogpoging (Gelukt/Mislukt) en een datumbereik aangeven.

OpenID ANVA Hub

OpenID aanvragen voor derde partijen

XML-koppelingen kunnen, in overleg met ANVA, gebruikt worden door partners van ANVA voor hun softwarepakket. Daarnaast zijn ze, onder voorwaarden, ook beschikbaar voor klanten van ANVA om te integreren met eigen oplossingen.

Proces aanvragen OpenID

1. Controleer of de externe partij bekend is bij ANVA. Het actuele overzicht kun je vinden op anva.nl. Als de partij in de lijst staat kun je door naar stap 2. Wanneer dit niet het geval is moet de externe partij zich aanmelden als developer op ons Developer Portal.
2. Maak een gebruikersaccount aan in ANVA 4/5. Dit gebruikersaccount heeft Customer Support nodig om aan de OpenID Client te koppelen. Dus het is handig als je dit als eerste aanmaakt.
   
   Belangrijk:
   • Maak in ANVA 4/5 (pad BGG) een gebruikersaccount aan met gebruikersnaam: <naam koppeling> <naam leverancier> <kantoornaam>. Let op dat ANVA maar 10 karakters kan hebben en geen spaties.
   • Zorg ervoor dat de gebruiker een beheerder is zodat deze alle permissies heeft.
   • Geef de gebruiker toegang tot het juiste kantoor. Of in het geval van een concern, toegang tot alle kantoren.
3. Maak een ticket aan voor Customer Support met het verzoek om een OpenID Client aan te maken. Vermeld hierin de omgeving (productie of acceptatie) en het gebruikersaccount dat je in ANVA 4/5 hebt aangemaakt.
4. Op het moment dat de ANVA-medewerker het ticket gaat oppakken heeft hij/zij toestemming nodig tot de organisatie op ANVA Hub. De ANVA-medewerker zal toestemming vragen middels een link in het ticket.
5. Zodra de ANVA medewerker toestemming heeft, zal hij/zij een gebruiker en OpenID aanmaken op ANVA Hub. Je ontvangt vier gegevens die de externe partij nodig heeft:
   • Tenantcode/organisatiecode
   • OpenID ClientID
   • OpenID Client Secret*
   • Domein/omgeving
     
     * Om de veiligheid te waarborgen zijn de OpenID ClientID en OpenID Client Secret niet volledig zichtbaar. Wanneer je op de knop ‘Vernieuwen’ klikt krijg je eenmalig de nieuwe gegevens te zien. Sla deze gegevens goed op.
6. Geef de vier gegevens door aan de externe partij. ANVA mag deze gegevens vanwege veiligheidsredenen niet direct aan de externe partij verstrekken. Nu kan de externe partij aan de slag.

Foutmelding '401 Unauthorized' bij aanpassen token

Als je het token aanpast krijg je altijd een '401 Unauthorized' status code terug. Deze foutmelding betekent dat er iets mis is met het token dat je hebt gebruikt.

Mogelijke oorzaken:

• Het token kan oneigenlijk aangepast zijn waardoor het niet meer correct gesigned is en onbekend bij de server (ANVA Hub)
• Het token kan verlopen zijn:

  - Het token kan verlopen zijn doordat de expiratiedatum is bereikt.

  - Het token kan verlopen zijn doordat het client secret van de OpenID client is ververst door een administrator.

  - Het token kan verlopen zijn doordat alle actieve sessies van de OpenID client zijn beeindigd door een administrator.

• Het token kan helemaal vergeten zijn om mee te sturen in de header bij het uitvoeren van een api request.

JSON Web Token en geldigheidsduur
Het token is een jwt (JSON Web Token). Een JWT bestaat inhoudelijk uit claims die in een JSON-object zijn opgenomen. Deze claims zijn eenvoudig uit te lezen voor een JWT parser. In iedere JWT zit altijd een ‘exp’-claim die aangeeft tot wanneer het token geldig is. Het is aan de client (aanroeper van onze api’s) om te controleren of de expiratietijd van het token nog niet verstreken is voordat een aanroep van de api wordt uitgevoerd. Als het token al verlopen is, dan is het dus de bedoeling dat de client dit zelf opmerkt en eerst een nieuw token opvraagt.

Wordt toch een api call gedaan met een verlopen token, dan sturen we dus een '401 Unauthorized' response terug zonder verdere specifieke foutmelding.

Client secret vernieuwen en reeds uitgegeven tokens
Als het client secret wordt vernieuwd dan worden alle op dat moment uitgegeven tokens die nog geldig zijn per direct ongeldig verklaard.

Blijf je toch zo’n ongeldig verklaard token gebruiken bij het aanroepen van de api, dan sturen we een '401 Unauthorized' terug zonder verdere specifieke foutmelding.

Meer specifieke foutmelding teruggeven bij '401 Unauthorized'
Vanwege security redenen nemen we geen extra informatie in de response op die meer vertelt over de exacte reden van de '401 Unauthorized'.

Gebruiksvolumes op ANVA Hub

Met de functie Gebruiksvolumes op ANVA Hub kun je een overzicht weergeven van het aantal contracten in je ANVA-systeem (gebruiksvolumes). Je opent het overzicht via het volgende pad:

ANVA Hub - menu Beheer - knop Gebruiksvolumes - tabblad ANVA contracten

De afbeelding hieronder toont een voorbeeld van het overzicht, je ziet hierin het aantal contracten per maand in staffelvorm:

Nu sta je standaard op de weergave optie 'Categorieën en rubrieken'. Door met de cursor over de staafdiagram van een bepaalde dag te gaan, zie je de aantallen per categorie en rubriek.

Naast 'Categorieën en rubrieken' zijn er ook nog andere weergave opties:

• Kantoren. Via deze weergave optie zie je het aantal contracten per kantoor. Let op: dit is alleen zichtbaar voor klanten die werken met versie 53.P01 of hoger.
• Totalen. Deze optie geeft het totaal aantal contracten, op de geselecteerde datum, weer dat aanwezig is in jouw ANVA-systeem.

Er zijn zeven contractcategorieën op ANVA Hub:

Notitie ZZP-polissen worden meegeteld als Zakelijke polissen.

Onder 'Uitval' worden polissen weergegeven die door het systeem niet konden worden toegewezen aan een van de zeven standaardcategorieën op ANVA Hub. Door instellingen in ANVA te wijzigen, kun je het aantal uitgevallen polissen terugbrengen naar nul (zie Uitvalpolissen).

Notitie De volgende polissen worden niet geteld en weergegeven op ANVA Hub: afgelopen, geroyeerde, opgeschorte, vervallen en nieuwe polissen in de wacht, en niet prolongerende schadepolissen.

Toewijzing van polissen aan categorieën

Polissen worden automatisch ingedeeld in categorieën op basis van een aantal ingevulde kenmerken en instellingen in ANVA. Deze combinatie van gegevens moet in de instellingen van ANVA juist geconfigureerd zijn:

• Maatschappijcode: sorteert volmacht (V_), provinciale (P_) en beurs (B_) polissen.
• Wijzigingsreden: scheidt prolongerende polissen van niet prolongerende polissen.
• Soort relatie: scheidt zakelijke van particuliere polissen op relatieniveau. Gebruik in ANVA pad BLC (label 40) om de ANVA-relatiesoort te koppelen aan de officiële AFD-relatiesoort.
• Productdoelgroep: scheidt zakelijke van particuliere polissen op polisniveau. ZZP valt onder zakelijk.
  Via label 13220 Productdoelgroep selecteer je in de polis de juiste doelgroep:

  - 00010 Particulier

  - 00020 Zakelijk

  - 00030 ZZP

  Label 13220 wordt gevuld bij opvoer van een nieuwe polis. Er wordt dan gekeken in pad BLC bij label 40 Soort relatie of de switch op Particulier of Zakelijk staat. Aan de hand van die switch wordt code 10 of 20 gevuld. Code 30 ZZP dien je, indien van toepassing, zelf te vullen in de polissen.

  Je kan label 13220 op het polischerm plaatsen of met een collectieve wijziging vullen.

  Als de productdoelgroep een andere code aangeeft dan 00010, 00020 of 00030, wordt de polis meegeteld als Zakelijk.

• AFD-codering: verdeelt de polissen over de categorieën 'Schade', de categorie 'Overig' en de categorie 'Onbenoemd'.

  Let op ANVA Hub leest niet de dekking uit per polis om te bepalen of een polis een particuliere of zakelijke dekking heeft. Dat gebeurt aan de hand van de instellingen via ANVA pad BLC.

Uitval

Contracten waarvoor de configuratie in het ANVA-systeem niet compleet of onjuist is, worden getoond onder ‘Uitval’. Door bij de optie 'Categorieën en rubrieken' alleen 'Uitval aan te vinken, wordt een overzicht van de uitval contracten getoond.

Wanneer je op een staaf klikt zie je het totaal aantal uitval contracten van de desbetreffende maand.

Voor meer onderliggende details, kun je rechtsboven klikken op 'Naar detailpagina'. Hier vind je een overzicht van uitval contracten.

In het voorbeeld hierboven worden verschillende soorten niet gecategoriseerde polissen in ‘Uitval’ weergegeven. De tabel hieronder toont per nummer in de afbeelding welke kenmerken in ANVA missen (zie Toewijzing van polissen aan categorieën voor meer uitleg over deze kenmerken).

Uitval corrigeren

Voor het herstellen van uitval, zie Uitval in gebruiksvolumes herstellen in de ANVA Help.

Als extra hulpmiddel om uitval contracten te categoriseren, kun je de volgende bronnen raadplegen:

• Bekijk het instructiefilmpje voor het corrigeren van uitval contracten.
• Gebruik de SIVI AFD-branchecodelijst, aangevuld met ANVA Hub contractcategorieën.

Uitval in gebruiksvolumes ANVA Hub herstellen

Je kunt de contracten onder 'Uitval' volgens onderstaande stappen koppelen aan je codes, voor een realistisch overzicht van jouw contracten.

Zoek eerst in ANVA Hub op welke ANVA-branchecodes niet gekoppeld zijn:

ANVA Hub - menu Beheer - knop Mijn organisatie - knop Gebruiksvolumes - tabblad ANVA contracten

1. Noteer de laatste vijf cijfers in de kolom Branchecode. Dat zijn de codes van de ANVA-branches die niet gekoppeld zijn.

   

Volg dan onderstaande stappen in ANVA 4/5:

Pad: BOAF

1. Zet in veld Label het labelnummer 10142 (dat is label Branche).
2. Klik op Zoeken .
3. Ga in de kolommen Entiteit/Attribuut naar PP BRANCHE en klik op Uit .

   

   Venster Uitgaande ANVA-codes opent. Je ziet hier een overzicht van de branches en de eventuele gekoppelde ADN-branchecode.

4. Dubbelklik op de branche die je wilt koppelen.

   Venster Koppelen uitgaande AFD-codes opent.

5. Klik bij AFD-code op Zoeken om de branche aan een branchecode te koppelen. ANVA adviseert om zoveel mogelijk standaardcodes te gebruiken.

   

6. Klik op Opslaan .
7. Herhaal dit tot je alle branches gekoppeld hebt en je in de gebruiksvolumes in ANVA Hub geen uitval meer hebt. je kunt met de knop Ophalen volumes in ANVA Hub de gebruiksvolumes opnieuw ophalen.

   Notitie Voor uitgebreidere informatie, zie: Koppelingen tussen ANVA-codes en uitgaande AFD-codes.

Lijst met AFD-branchecodes

Bekijk hier de vereenvoudigde SIVI AFD-branchecodelijst.

Connect Postbus statistieken

Inleiding Connect Postbus statistieken

Met de Connect Postbus kunnen EDIFACT-berichten en PDF-documenten verzonden worden door verzekeraars, volmachtkantoren en via Aplaza ontvangen worden door advieskantoren.

Hier vind je de beschrijving van de werking van de statistieken van de berichten in de Connect Postbus. Hiermee kan je o.a. bekijken hoeveel berichten je per periode verzonden of ontvangen hebt, welke berichten al opgehaald zijn of hoeveel berichten nog door welk kantoor opgehaald moeten worden.

Er is ook een PDF-handleiding beschikbaar.

Inloggen ANVA Hub (Connect Postbus statistieken)

Om de statistieken te kunnen bekijken dien je in te loggen met je gebruikersnaam en wachtwoord van een postbusbeheerderaccount.

ANVA Hub

1. Ga naar https://hub.anva.io.

   

2. Voer je gebruikersnaam en wachtwoord in.
3. Klik op .

   Als de authenticatie is ingesteld op MFA (Multi Factor Authentication) komt het volgende scherm:

   

4. Voer de authenticatiecode in.
5. Klik op .

Statistieken bekijken (Connect Postbus statistieken)

Aantallen (Connect Postbus statistieken)

Om de statistieken van de Connect Postbus te bekijken voer je de volgende acties uit.

1. Klik links in de blauwe balk op Postbus om de Connect Postbus-gegevens te openen.
2. Klik op tabblad Statistieken.

   

   Standaard staat de datumrange op de huidige week ingesteld.

3. Klik op het kalendericoontje om de datumrange aan te passen.
4. Geef de datum ‘Vanaf’ en ‘T/m’ in.

   Tip: Kies de kleinst mogelijke periode om de doorlooptijd van de query en de hoeveelheid resultaten te beperken. Per pagina worden maximaal 1000 resultaten getoond.

5. Klik op om de aantallen op te halen.

Onder Inkomend en Uitgaand zie je de aantallen berichten verdeeld in ‘Berichten aangeboden’, ‘Berichten opgehaald’ en ‘Berichten beschikbaar’.

Inkomend (Connect Postbus statistieken)

Onder Inkomend staan de berichten die in jouw postbus in de aangegeven datumrange zijn binnengekomen:

• Berichten aangeboden – dit is het totaal aantal berichten wat tijdens de aangegeven periode is aangeboden aan jouw postbus.
• Berichten opgehaald – dit is het totaal aantal berichten wat je tijdens de aangegeven periode hebt opgehaald in jouw postbus.
• Berichten beschikbaar – dit zijn alle berichten die aangeboden zijn, maar nog niet opgehaald. Dit is onafhankelijk van de datum range.

Uitgaand (Connect Postbus statistieken)

Onder Uitgaand staan de berichten die vanuit jouw postbus verzonden zijn in de aangegeven datumrange:

• Berichten aangeboden – dit is het totaal aantal berichten wat tijdens de aangegeven periode zijn verzonden vanuit jouw postbus.
• Berichten opgehaald – dit is het totaal aantal berichten wat tijdens de aangegeven periode vanuit jouw postbus zijn verzonden en zijn opgehaald.
• Berichten beschikbaar – dit zijn alle berichten in de postbus die nog niet opgehaald zijn. Dit is onafhankelijk van de datumrange.

Soorten berichten (Connect Postbus statistieken)

Er kunnen twee soorten berichten verzonden en opgehaald worden:

• Type edi.

  Dit zijn prolongatie- en mutatieberichten, de zogenaamde EDIFACT-berichten.

• Type xml.

  Dit zijn documenten.

Soorten status (Connect Postbus statistieken)

De berichten kunnen per type de volgende status hebben:

Type edi

• Compleet. Het bericht is succesvol ontvangen en verwerkt door het postbussysteem. Bericht met deze status is ook direct beschikbaar voor de ontvanger in de postbus. Het bericht kan opgehaald worden via Aplaza.
• Opgehaald. Het bericht is opgehaald door de ontvanger. Door de ontvanger is een ‘ontvangstBevestiging’ (volgens GRS-protocol) verstuurd naar het postbussysteem

Type xml

Documenten worden niet als losse berichten klaargezet voor de ontvanger, maar ze worden eerst verzameld in een batchbestand. De aangeleverde berichten worden 1 keer per 10 minuten gebundeld in een batchbestand. Dit batchbestand wordt opgehaald door de ontvanger. Voor dit type zijn dus de volgende statussen beschikbaar:

• Compleet. Het bericht is succesvol ontvangen en verwerkt door het postbussysteem, maar nog niet opgenomen in een batch.
• AssignedToBatch. Het bericht is geselecteerd om opgenomen te worden in een batch. De selectie wordt 1x per 10 minuten gemaakt.
• IncludedInBatch. Het bericht is opgenomen in een batch. Vanaf dit moment staat de batch (met daarin het bericht) klaar in de postbus van de ontvanger. Vanaf dit moment kan de ontvanger dus ook het bericht ophalen via Aplaza.
• Opgehaald. De batch is opgehaald door de ontvanger. Door de ontvanger is een ‘ontvangstBevestiging’ (volgens GRS-protocol) verstuurd naar het postbussysteem. De batch is hierna niet meer zichtbaar in de postbus.

Opmerkingen:

• Als een bericht op status AssignedToBatch blijft staan (langer dan een uur), dan is er iets misgegaan met het bundelen naar het batchbestand. 24 uur later wordt automatisch nogmaals geprobeerd om deze actie uit te voeren. Als het bericht dan nog steeds op deze status staat, kan je contact opnemen met Aplaza.
• Als de status errorWhileCreatingBatch bij een bericht staat, is er iets fout gegaan met het maken van het batchbestand. 24 uur later wordt automatisch nogmaals geprobeerd om deze actie uit te voeren. Als het bericht dan nog steeds op deze status staat, kan je contact opnemen met Aplaza.

Filteren van berichten (Connect Postbus statistieken)

De lijst met berichten kan je filteren door op de knop te klikken:

Toon alleen resultaten verzonden door

Hier kies je de organisatie, waarvan je de binnengekomen of ontvangen berichten wilt zien. Type de organisatienaam. Zodra je begint met typen, worden organisaties met deze letters getoond en kan je al gauw je betreffende organisatie aanklikken. Je hebt alleen de keuze uit organisaties waar je berichten van ontvangt of naar toe zendt. Je kan het organisatieveld ook leeg laten.

Type

Klik in het veld en je ziet de beschikbare types. Hier vink je aan welke type berichten je wilt zien. Als je hier niets aanvinkt worden berichten van alle types getoond. Je kan meerdere opties aanvinken.

Status

Klik in het veld en je ziet de beschikbare statussen. Hier vink je aan welke status je wilt zien. Als je hier niets aanvinkt worden berichten van alle statussen getoond. Je kan meerdere opties aanvinken.

Kies vervolgens voor de knop .

Lijst met berichten (Connect Postbus statistieken)

Na het intoetsen van de knop wordt de gewenste lijst met berichten getoond. Er worden echter maar maximaal 1000 berichten per pagina getoond. Je kunt de volgende 1000 resultaten tonen door onderaan het overzicht op de knop 'Meer weergeven' te klikken. Pas het filter aan als er teveel resultaten zijn. Als dat ongewenst is, kan je het filter aanpassen.

In de lijst zie je per bericht de volgende informatie:

• ProcesID
• Verzonden aan
• Type
• Bestandsnaam
• Status
• Aangeboden op
• Opgehaald op
• Acties

Lijst met berichten downloaden (Connect Postbus statistieken)

Achter elk bericht kan je via de kolom Acties de berichten downloaden:

• Type EDIFACT. Als je op de drie puntjes klikt achter een edi-bericht, kan je het bericht downloaden om deze inhoudelijk te kunnen bekijken.
• Type xml. Via de drie puntjes kan je batches (=uniek procesID) downloaden. Het kan voorkomen dat er veel documenten (max 200) in een batch zitten.Deze kunnen over meerdere regels verspreid zijn met hetzelfde unieke procesID. Je kan xml-berichten met hetzelfde procesID tegelijk downloaden. Het is niet mogelijk om meerdere batches met verschillende procesID’s tegelijk te downloaden.
  Opgehaalde batchbestanden blijven 90 dagen bewaard in de Connect Postbus en kunnen zolang worden gedownload. Niet opgehaalde berichten blijven 180 dagen bewaard

Lijst met berichten mailen (Connect Postbus statistieken)

De volledige lijsten kunnen ook rechtstreeks als CSV-bestand gemaild worden. Dit is vooral handig met grote aantallen, die met Excel dan beter te filteren zijn.

1. Ga bovenin naar de totalen
   
   
   
2. Klik in het betreffende vak op het icoontje

Er wordt direct een mail verstuurd met een link, waarmee de Connect Postbus-statistieken als CSV-bestand te downloaden is. Er volgt een melding: ‘De postbusstatistieken zijn per e-mail verzonden naar <e-mailadres>’.

De reden dat we een link naar het CSV-bestand per e-mail sturen is dat het bij grote aantallen lang (enkele minuten) kan duren voordat de CSV gereed is. Als we dit synchroon vanuit de statistiekenpagina zouden aanbieden, dan zou dit tot time-out meldingen kunnen leiden.

De link in de mail heeft vanwege beveiligingsredenen een beperkte geldigheidsduur.