Post via Pingen
Wat het doet
Met de module Brieven per post (pakket Plus en hoger) en een eigen account bij Pingen verstuur je brieven rechtstreeks vanuit de app: Pingen drukt ze in België af, geeft ze aan bpost en meldt per brief wanneer hij op de post ging. De frankering betaalt je coöperatie rechtstreeks aan Pingen; Konsono rekent niets door.
Waar je de koppeling gebruikt, staat bij de knop zelf:
- de oproeping, een rechtzetting, een annulering en nasturen: De oproeping versturen;
- een losse brief of een uittreksel: Een brief maken.
Wat je nodig hebt
- De module Brieven per post in je pakket.
- Een organisatie bij Pingen, op naam van je coöperatie.
- De rol van bestuurder. Lezers zien de kaart, maar wijzigen niets.
Pingen koppelen
Je koppelt in Instellingen › Integraties › Post (Pingen):
- Maak in Pingen een API-client aan. Meld je aan in Pingen, open de organisatie van de coöperatie en maak een API-client aan. Pingen toont het client-ID en het client secret; het secret zie je daar maar één keer.
- Vul het client-ID, het secret en de organisatie in en kies Bewaren. De organisatie-ID vind je in de URL of de instellingen van de organisatie in Pingen. Het secret wordt versleuteld bewaard en nooit meer getoond (je ziet de laatste vier tekens). Kies hier ook de standaard voor je brieven: niet-prioritair of prioritair, recto-verso, zwart-wit of kleur. Het adres staat altijd rechts, in het venster van de omslag: zo zijn de sjablonen gemaakt.
- Maak in Pingen de vier webhooks aan. Na het bewaren toont de app één keer een URL en een signing key. Maak in Pingen op de organisatie een webhook aan voor elk van de vier categorieën issues, sent, undeliverable en delivered, telkens met dezelfde URL en dezelfde signing key. Kopieer ze meteen: ze bevatten een geheim en de app toont ze geen tweede keer. Ben je ze kwijt, kies dan Nieuwe URL en signing key maken en pas de vier webhooks in Pingen aan (de oude werken dan niet meer, en de koppeling staat uit tot een nieuwe test slaagt).
De verbinding testen
Stap 4 op de kaart is Test de verbinding. De app haalt een token bij Pingen, leest de organisatie en kijkt na of de vier webhooks bestaan. Ze maakt of wijzigt zelf niets bij Pingen. Ontbreekt er een webhook, dan noemt de app welke. Weigert Pingen het client-ID of het secret, of de organisatie, dan zegt de app dat ook.
Zet daarna Brieven per post via Pingen aan. Dat kan pas als de test slaagt. Wijzig je later het client-ID, het secret of de organisatie, dan gaat de koppeling uit tot een nieuwe test slaagt.
Ontkoppelen zet de koppeling uit en wist het secret, de URL en de signing key.
Zonder koppeling
Zonder koppeling verandert er niets: je drukt de brieven af en vult zelf in wanneer ze op de post gingen. Ook met de koppeling kan je dat altijd blijven doen.
Als er iets misgaat
- De test zegt dat een webhook ontbreekt: kijk in Pingen na of er voor elk van de vier categorieën een webhook is met precies de URL en signing key uit de app. Twijfel je, maak dan een nieuwe URL en signing key en pas de vier webhooks aan.
- "Pingen weigert het client-ID of het secret": maak in Pingen een nieuwe API-client en geef het nieuwe secret in.
- Een brief blijft lang op "Aan Pingen gegeven": de app rekent met twee werkdagen tot Pingen een brief aan bpost geeft. Ze kijkt ook elke dag zelf na wat Pingen meldt, voor het geval een webhook niet aankwam. Blijft het hangen, kijk de brief na in Pingen.
- Pingen is niet bereikbaar bij het versturen: de brieven wachten en gaan vanzelf zodra Pingen terug is, elk één keer. Antwoordt Pingen niet op het moment dat een brief echt verstuurd wordt, dan staat die brief op Onzeker: kijk na in Pingen: zie Het verzendlog met Pingen, Een onzekere brief.