MyParcel
Bereid via Zapier MyParcel-conceptzendingen voor vanuit betaalde MemBirds-bestellingen, met veilige sleutels en gecontroleerde adresvelden.
Voor een fysiek product, zoals een boek, kan een betaalde MemBirds-bestelling een Zap starten die een conceptzending in MyParcel maakt. Dit loopt via een productwebhook en een eigen API-aanroep in Zapier, niet via een ingebouwd MyParcel-instellingenscherm. Je rondt de zending en het label af in MyParcel.
Nederlandstalige video: MyParcel koppelen
Dit is een geavanceerd voorbeeld voor MyParcel Nederland (api.myparcel.nl). Knoppen in de video kunnen afwijken van de huidige interface. MyParcels gepubliceerde naslag geeft tegenstrijdige authenticatie-instructies; bevestig vóór ingebruikname welke methode bij je account hoort. Gebruik dit niet ongewijzigd voor internationaal verzenden of automatisch labels kopen.
Voordat je begint
- Een MemBirds-product en betaalpagina. Gebruik onder Algemeen → Formulier Uitgebreid factuuradres en controleer of de benodigde adresvelden worden gevraagd. Dit voorbeeld gebruikt het factuuradres van de bestelling als bezorgadres; het verzamelt geen apart verzendadres.
- Een MyParcel Nederland-shop met een API-sleutel uit de integratie-instellingen van je shop en een geschikte vervoerdersovereenkomst of verzenddienst.
- Een Zapier-account met Webhooks by Zapier → Catch Hook en Custom Request. Mogelijk is een betaald abonnement nodig.
- Een beperkte beginsituatie, bijvoorbeeld één boek per bestelling naar Nederlandse adressen. Bepaal apart hoe je aantallen, gemengde winkelmandjes, orderbumps, andere landen en herhaalleveringen verwerkt.
Gebruik een aparte testbetaalpagina en je eigen testklant om testgegevens te verzamelen. Pas hiervoor niet de prijs van een live klantaanbod aan. Houd rekening met de normale gevolgen voor betaling en factuur.
Een betaalde bestelling naar Zapier sturen
Maak de ontvangende trigger
Maak een Zap met Webhooks by Zapier → Catch Hook. Laat het optionele veld voor een onderliggende sleutel leeg om de hele bestelling te ontvangen en kopieer de webhook-URL. Houd deze URL vertrouwelijk.
Voeg een producthook toe in MemBirds
Open het fysieke product en ga naar Instellingen → Hooks → Hook toevoegen. Kies Checkout order betaald, Webhook aanroepen en Actief. Plak de Zapier-URL bij URL van de webhook en klik op Opslaan. Voor deze uitgaande webhook is geen MemBirds-API-sleutel nodig.
Haal een volledig voorbeeld op
Rond een testaankoop af met je eigen gegevens en volledige adres en laat Zapier het verzoek ophalen. Controleer bestelnummer, product en aantal, e-mailadres van de koper en factuuradres. Gebruik geen producttoegangsgebeurtenis: die bewijst geen betaling en levert deze bestelgegevens niet.
Beperk de automatisering
Voeg vóór de MyParcel-actie voorwaarden toe die alleen het bedoelde product, de bestemming en aantallen toestaan. Stop of stuur onvolledige adressen en niet-ondersteunde winkelmandjes door voor handmatige verwerking. De hook stuurt de hele bestelling, niet alleen de fysieke productregel waaraan hij gekoppeld is.
De MyParcel-aanroep voorbereiden
Voeg Webhooks by Zapier → Custom Request toe:
| Instelling | Waarde |
|---|---|
| Method | POST |
| URL | https://api.myparcel.nl/shipments |
| Data Pass-Through | False |
| Data | Je JSON-zending met gekoppelde velden; zie hieronder. |
| Unflatten | No |
| Basic Auth | Leeg laten wanneer je zelf de Authorization-header invult. |
| Return Raw Response | No, als deze optie wordt getoond. |
Voeg deze headers toe:
| Naam | Waarde |
|---|---|
Content-Type | application/vnd.shipment+json;charset=utf-8;version=1.1 |
User-Agent | CustomApiCall/2 |
Authorization | Het bevestigde authenticatieschema voor je MyParcel-API-sleutel, een spatie en de naar Base64 omgezette sleutel. |
Houd de sleutel privé
Zet de API-sleutel lokaal om, niet op een openbare Base64-website. Base64 is omkeerbare codering, geen versleuteling. Zowel de originele als de omgezette sleutel geeft toegang tot je account. Als Python is geïnstalleerd, kun je bijvoorbeeld dit op je eigen vertrouwde computer uitvoeren; de invoer blijft verborgen en komt niet in het commando zelf:
python3 -c 'import base64,getpass; print(base64.b64encode(getpass.getpass("MyParcel API key: ").encode()).decode())'Kopieer het resultaat privé naar de Authorization-header in Zapier, niet naar de zendingsgegevens. Neem geen regeleinde op in de sleutel. Deel het resultaat niet in screenshots of supportberichten. Is een sleutel gelekt? Vervang hem in MyParcel en werk de Zap bij.
De Add Shipment-naslag noemt Authorization: basic BASE64(API_KEY), terwijl de authenticatiepagina bearer met een naar Base64 omgezette sleutel toont. Vraag MyParcel welk schema bij je integratie hoort en test het met je account voordat je bestellingen verwerkt. Ga er niet van uit dat een OAuth-token of gewone gebruikersnaam met wachtwoord uitwisselbaar is met deze sleutel.
De zendingsgegevens koppelen
Het JSON-sjabloon voor zendingen bevat één zending onder data.shipments. Tekst zoals {{Order Number}} is een aanwijzing om een Zapier-veld te koppelen, geen waarde die je letterlijk moet versturen.
Gebruik die structuur en vervang iedere sjabloonmarkering door een dynamische waarde uit Catch Hook. De getoonde veldnamen in Zapier kunnen verschillen; selecteer de velden uit je eigen voorbeeld.
| MyParcel-veld | Bron in de MemBirds-bestelling |
|---|---|
reference_identifier | order_number, om de zending bij de bestelling terug te vinden. |
recipient.company | invoiceAddress.company_name, indien aanwezig. |
recipient.cc | invoiceAddress.country, een tweelettercode zoals NL, niet een landnaam. |
recipient.person | invoiceAddress.first_name en invoiceAddress.last_name, met een spatie ertussen. Controleer of dit de bedoelde ontvanger is; de accountnaam van de koper kan afwijken. |
recipient.street | invoiceAddress.street. |
recipient.number | invoiceAddress.house_number. |
recipient.number_suffix | invoiceAddress.house_number_suffix, indien aanwezig. |
recipient.postal_code | invoiceAddress.zipcode. |
recipient.city | invoiceAddress.city. |
recipient.email | user.email. |
options.label_description | De naam van het bedoelde fysieke product; voeg niet blind alle producten uit een gemengde bestelling samen. |
Gebruik bij recipient.person de naam van de bedoelde ontvanger uit het factuuradres. Het sjabloon bevat markeringen voor de naam van de koper; vervang die als de ontvanger op het factuuradres afwijkt van de accounthouder.
Beperkingen voor pakket, gewicht en land
Het document zet carrier vast op 1 (PostNL), options.package_type op 6 (klein pakket) en physical_properties.weight op 1000. Dit zijn voorbeeldkeuzes voor verzending, geen instellingen die uit je MemBirds-product worden afgeleid. Gebruik het werkelijke gewicht inclusief verpakking in grammen en de dienst die je MyParcel-account ondersteunt. Type 6 is niet hetzelfde als een brievenbuspakje (type 2).
Sta voor dit eerste voorbeeld alleen gecontroleerde Nederlandse adressen toe met aparte straat, huisnummer, toevoeging, postcode en plaats. MemBirds kan bij andere landen adresregels gebruiken. Die koppelen aan de Nederlandse velden kan een onvolledige zending opleveren. Internationaal verzenden stelt daarnaast eisen aan vervoerder, contract en soms douanegegevens die dit document niet afdekt. Bekijk de MyParcel-verzendopties en adresdefinities voordat je de toepassing uitbreidt.
Behoud de geneste structuur data.shipments, geldige JSON-aanhalingstekens en numerieke waarden voor pakkettype, vervoerder en gewicht. Verwijder overgebleven sjabloonmarkeringen en onbedoelde schuine strepen. Controleer optionele lege velden en namen met leestekens in de echte voorbeeldweergave van het verzoek; blind tekst invoegen kan JSON ongeldig maken.
Testen, publiceren en controleren
- Controleer het volledige verzoek zonder de authenticatiewaarde te delen. Controleer één zending, de bedoelde ontvanger en de juiste dienst en het gewicht.
- Test de actie één keer. Dit maakt echt gegevens in MyParcel; het is geen simulatie. Een geslaagde respons bevat zendings-ID's. Open Zendingen → Overzicht in MyParcel en controleer conceptzending, adres en referentie voordat je een label maakt.
- Controleer vóór een herhaling van een mislukte test of time-out of er al een zending bestaat. De referentie helpt bij controle, maar is geen gedocumenteerde garantie tegen dubbele zendingen. Laat voor productie bestel- en zendings-ID's bijhouden en voorkom herverwerking van dezelfde bestelling. Meerdere producthooks kunnen dezelfde bestelling meermaals sturen.
- Publiceer en benoem de Zap pas nadat je het resultaat hebt gecontroleerd. Volg de eerste bedoelde bestelling in de Zap-geschiedenis en MyParcel. Klopt het adres, verzoek of de authenticatie niet? Stop de Zap en los dit op voordat je meer bestellingen verwerkt.
Dit voorbeeld bereidt een conceptzending voor; het print niet automatisch labels, berekent geen verzendkosten aan de koper, schrijft geen tracking terug naar MemBirds en annuleert geen zendingen na een terugbetaling. Rond die handelingen af en controleer ze in MyParcel. Labels maken is een aparte handeling waarbij afhankelijk van je MyParcel-account betaling nodig kan zijn.
Ontvangt Zapier geen verzoek? Controleer de MemBirds-hooklogs. MemBirds probeert een mislukte webhook niet automatisch opnieuw. Zet de producthook op Inactief en schakel de Zap uit om nieuwe verzoeken te stoppen; bestaande MyParcel-zendingen blijven daarbij staan.