Oplossing

Dit is altijd de voorwaarden kolom, e.g. Vanaf gewicht x. Echter is de naam van deze kolom dynamisch, afhankelijk van je tablerate configuratie. Dit kan een van de volgende namen hebben:

Order Subtotal (an above)
Weight (and above)
# of Items (and above)

Zorg ervoor dat deze kolom met een nummer in de US formaat gevuld is. m.a.w. een positief nummer, waarvan de decimal separator een punt is.

[POSTNL-0247] Invalid PostNL Table Rates File Format in Row

Probleem

De aangegeven regel van het PostNL tarieven csv bestand heeft niet het juiste format.

Oplossing

Zorg ervoor dat de aangegeven regel in het csv bestand komma-gescheiden is en alle kolommen bevat (zijn er 5).

[POSTNL-0245] Warning : To successfully send orders with Extra@Home, you must fill in the product attributes name, weight and volume.

Probleem

Bij het aanmaken van een zending krijgt u de melding:

"Warning : To successfully send orders with Extra@Home, you must fill in the product attributes name, weight and volume."

Oorzaak

Bij het aanmaken van een Extra@Home zending wordt het totaal volume (cm3) en gewicht berekend. Indien deze berekening 0 terug geeft kan de zending niet aangemaakt worden.

Oplossing

Login in de backend van uw shop en navigeer vervolgens naar de producten welke als het type Extra@Home ingesteld zijn. Controleer onder het tabje General of in het Nederlands Algemeen of het gewicht is ingevuld. Navigeer vervolgens door naar het tabje PostNL en controleer (indien het product type op Extra@Home staat) of het veld PostNL product volume is ingevuld.

Indien het product uit meerdere pakketen bestaat, tel dan het aantal kubieke centimeters bij elkaar op.

PostNL Extra@Home settings

U krijgt de melding:
“Your PostNL customer code appears to be incorrect. Please make sure you have entered the correct code.”

Oplossing

Oplossing

Oplossing

“Cannot create an invoice without products.”

Oplossing

Dit kan voorkomen door een probleem in de code of database.

[POSTNL-0160] A required configuration value is missing:

Invalid name supplied: %s.

Oplossing

Dit wijst op een probleem in de code of database.

[POSTNL-0153] Invalid fee amount entered: %s incl. VAT. Please enter a value between 0.00 and 2.00 EUR incl. VAT

Probleem

Bij het opslaan van de configuratie krijgt u de volgende melding:
Invalid fee amount entered: %s incl. VAT. Please enter a value between 0.00 and 2.00 EUR incl. VAT.

Oplossing

An error occurred while updating the PostNL Checkout order (eventueel aanvullende error).

Oplossing

U gebruikt 1 PostNL Checkout account in meerdere webshops. Een PostNL Checkout account kan aan slechts 1 webshop gekoppeld zijn. Gebruik in uw verschillende webshops verschillende PostNL Checkout accounts of stel Magento zo in dat iedere winkel unieke ordernummers gebruikt. Dit kunt u doen door bijvoorbeeld in de tweede winkel alle order nummers met het getal 2 te laten beginnen.

Mocht bovenstaande situatie en oplossing niet voor u van toepassing zijn Neem contact op met de digitale klant support, stuur dan eerst een e-mail naar digitaleklantsupport@postnl.nl of bel met PostNL op telefoonnummer 088-2255651.

[POSTNL-0112] Winkelwagen is leeg

Probleem

Uw klant krijgt de volgende melding:

Your shopping cart is empty. Please add a product and try again.

Oplossing

Uw klant probeert PostNL Checkout te gebruiken zonder producten in de winkelwagen. De oorzaak is het wisselen naar een nieuw tabblad. De klant dient het hele bestelproces in 1 tabblad te doorlopen.

[POSTNL-0111] Unable to retrieve barcode data.

Probleem

U probeert een GlobalPack zending aan te maken en te verwerken zonder dat de benodigde configuratie instellingen hiervoor zijn gedaan.
Dit probleem kan ook naar voren komen bij het aanmaken van een retour.

Oplossing

Oplossing

PostNL Checkout is niet beschikbaar omdat het totaalbedrag van de winkelwagen lager is dan het minimum dat de webshop heeft ingesteld.
De consument dient een hoger orderbedrag af te rekenen om gebruik te kunnen maken van de PostNL Checkout.

De mogelijkheid om een minimaal orderbedrag te hanteren is een functionaliteit van Magento. U kunt deze functionaliteit vinden in het menu System -> Configuration -> Sales -> Sales -> Minimum Order Amount.

[POSTNL-0104] De winkelwagen is virtual

Probleem

PostNL Checkout is niet beschikbaar, omdat de quote geheel bestaat uit virtuele of downloadbare producten.

Oplossing

Voeg een fysiek product toe aan de winkelwagen.

[POSTNL-0103] PostNL Checkout is uitgeschakeld

Probleem

De volgende melding is zichtbaar in de Checkout:

“PostNL Checkout has been disabled.” of “PostNL Checkout is uitgeschakeld”.

Oplossing

PostNL Checkout is niet beschikbaar, omdat checkout uitgeschakeld staat. Zet PostNL Checkout aan in Systeem > Configuratie > PostNL > Geavanceerde Instellingen > PostNL Checkout Instellingen.

[POSTNL-0102] Producten in winkelwagen niet op voorraad

Probleem

De volgende melding is zichtbaar in de Checkout:
“One or more items in the cart are out of stock.” of “EÃ©n of meer producten in de winkelwagen zijn niet op voorraad.”.

Oplossing

PostNL Checkout is niet beschikbaar, omdat een product niet op voorraad is. Verwijder het product dat niet op voorraad is of zet in Systeem > Configuratie > PostNL > Geavanceerde Instellingen > PostNL Checkout de optie ‘Activeer de PostNL checkout voor orders die producten bevatten die niet op voorraad zijn op ‘ja’.

[POSTNL-0101] Gewicht van bestelling te laag

Probleem

De volgende melding is zichtbaar in de Checkout:
“The quote’s total weight is below the miniumum required to use PostNL Checkout.” of “Het totale gewicht van de bestelling is beneden het minimum om gebruik te kunnen maken van PostNL Checkout.”.

Oplossing

PostNL Checkout is niet beschikbaar, omdat het totale gewicht van de bestelling te laag is. Voeg meer producten toe of zet in Systeem > Configuratie > PostNL > > Geavanceerde Instellingen > PostNL Checkout de optie ‘Activeer de PostNL checkout voor orders onder de 2 kg’ op ‘ja’.

[POSTNL-0100] Het PostNL account heeft geen toegang tot deze actie

Probleem

Op dit moment heeft het huidige account geen toegang tot de gevraagde actie.

Oplossing

Neem contact op met de digitale klant support, stuur dan eerst een e-mail naar digitaleklantsupport@postnl.nl of bel met PostNL op telefoonnummer 088-2255651.

[POSTNL-0098] Live modus inschakelen

Let op. Dit artikel is gebaseerd op de PostNL Magento extensie versie 1.1.4.
Indien u een oudere versie van de extensie gebruikt kunt u geen gebruik maken van de beschreven functionaliteiten en raden wij u aan de extensie te upgraden.

De extensie bevindt zich na installatie in testmodus.
Er zijn test accountgegevens ingevuld waar u de extensie mee kunt testen. De zendingen die aangemaakt zijn in de testmodus kunnen niet worden verzonden.

Volg onderstaande stappen om de extensie in livemodus te configureren:

1. Schakel de livemodus in. Twee configuratie waardes dient u hiervoor aan te passen.
De eerste configuratie waarde vindt u in het tabje “Voormelden & Label Printen Instellingen”.
De tweede configuratie waarde vindt u in het tabje “PostNL Checkout Instellingen”.

Oplossing

De cron kan niet opgeslagen worden. Dit wijst op een probleem in de code of database. Neem contact op met uw technisch beheerder.

[POSTNL-0083] Extensie succesvol geüpdatet

Oplossing

Dit kan o.a. voorkomen als de Track & Trace e-mail al verzonden is voor deze zending of als het geselecteerde e-mail template niet beschikbaar is.

Vanaf versie 1.4.1 is het een bekend probleem dat de Track&Trace e-mail niet verzonden kan worden. Dit komt meestal doordat, tijdens de upgrade, de standaard template niet kan worden gevonden door Magento. Om dit op te lossen, kan het onderstaande stappenplan gevolgd worden:Â

- Navigeer naar Systeem->Transactionele E-Mails.Â

- Selecteer hier als sjabloon ‘PostNL Track & Trace e-mail’Â

- Laad het sjabloon in

- Geef het template een naam

- Sla het sjabloon op

- Navigeer naar Systeem->configuratie->PostNL->Geavanceerde instellingen->Track&Trace

- Selecteer het nieuw gemaakte Track &Â Trace template als gebruikte template

- Sla de configuratie op

[POSTNL-0076] De actie sendTrackAndTraceEmail is niet beschikbaar

Probleem

Op dit moment is het niet mogelijk om de actie “sendTrackAndTraceEmail” uit te voeren.

Neem contact op door een e-mail te sturen naar citservicedesk@postnl.nl of bel met 088-2255652.

[POSTNL-0075] Barcode kan niet aan zenden worden gekoppeld

Probleem

De volgende melding is zichtbaar bij het voormelden:
“Unable to add tracking info: no barcode or shipment available.” of “Onmogelijk om tracking informatie toe te voegen. Geen barcode of verzending beschikbaar.”.
Het is niet mogelijk om de barcode aan de verzending te koppelen.

Oplossing

Oplossing

Het adres is niet correct. Controleer het adres van de bestelling.

Het is mogelijk dat een ander adres-formaat gebruikt wordt voor bepaalde landen. Bij enkele landen wordt eerst het huisnummer vermeld, gevolgd door de straatnaam.

Dit heeft tot gevolg dat de PostNL extensie het huisnummer behandelt als straatnaam en andersom. Dit kan opgelost worden door de betreffende bestelling te openen en de straatnaam en huisnummer omwisselen.

Daarnaast is het ook verstandig om duidelijk te labellen welk veld gebruikt dient te worden voor straatnaam en welke voor huisnummer, in plaats van ‘adresregel 1 en 2’.

[POSTNL-0059] Ongeldig huisnummer

Probleem

Het opgegeven huisnummer is onjuist.

Probleem

PostNL heeft een onverwachte reactie gestuurd op een shippingStatus verzoek.

Oplossing

Dit wijst op een (tijdelijk) probleem in de communicatie tussen PostNL en de extensie. Probeer het later nog eens. Als het probleem zich blijft voordoen, neem dan contact op met je technisch beheerder.

[POSTNL-0054] Ongeldige barcode

Probleem

De volgende melding is zichtbaar: “Invalid barcode response: {response}” of “Ongeldige barcode : %s”.

Oplossing

[POSTNL-0049] Kan geen order creëren

Probleem

De volgende melding is zichtbaar bij het afrekenen:

“Unable to create an order for quote #{quote ID}” of “Kan geen order creÃÂ«ren voor quote #{quote}”.

Oplossing

Dit wijst op een probleem in de code of database. Neem contact op met je technisch beheerder.

[POSTNL-0048] De geselecteerde betaalmethode is niet beschikbaar

Probleem

Wanneer je “Selected payment method {methodName} is not available.” op je scherm krijgt. Betekent het dat {betaalmethode} niet beschikbaar is.

Oplossing

“OrderToken missing for quote #’{quote ID}” of “OrderToken is niet aanwezig voor quote #{quote ID}”.

Oplossing

Dit wijst op een probleem in de code of database. Neem contact op met je technische beheerder.

[POSTNL-0044] Ongeldig object

Probleem

De volgende melding is zichtbaar:

“Invalid object specified: {object}” of “Ongeldig object gespecificeerd: {object}”.

Oplossing

Dit wijst op een probleem in de code. Neem contact op met je technische beheerder.

[POSTNL-0043] Ongeldig referentie type opgevraagd

Probleem

De volgende melding is zichtbaar: “Invalid reference type requested: {reference type}” of “Ongeldige referentie type opgevraagd: {reference type}”

Oplossing

De volgende melding is zichtbaar: “No quote available to initiate PostNL Checkout.” of “Geen quote beschikbaar voor PostNL Checkout”.

Oplossing

De klant heeft geen geldige quote. Probeer het nogmaals.

[POSTNL-0038] Onverwachte reactie op pingverzoek

Probleem

De volgende melding is zichtbaar: “Invalid PingStatus response: {response}” of “Ongeldig PingStatus antwoord: {response}”.

Oplossing

[POSTNL-0037] Ongeldige UpdateOrder ontvangen

Oplossing

PostNL functioneert enkel wanneer de base currency in uw winkel op EUR (Euro )staat. Zet deze op EUR in System > Config > Currency setup > Currency options.
N.B. Wijzigen in dit menu hebben een grote impact op de prijzen die u hanteert in de webshop.

[POSTNL-0031] Verzendmethode is niet geactiveerd

Probleem

De volgende melding is zichtbaar: “The PostNL shipping method has not been enabled.” of “De PostNL verzendmethode is niet geactiveerd.”.

Oplossing

Zet de PostNL verzendmethode aan in het verzendmethodes menu.

[POSTNL-0030] Extensie staat niet aan

Oplossing

Dit kan diverse oorzaken hebben. Bijvoorbeeld:

De zending is al voorgemeld
De zending wordt al door een ander proces verwerkt (lock)
De zending is niet gekoppeld aan een order
De zending is een EU zending
Labels zijn nog niet geprint

Order is al verzonden
Order is geannuleerd

De Magento logging kunt u inschakelen in het menu Systeem > Configuratie > Gevorderd > Ontwerper > Log instellingen.

De PostNL logging kunt u inschakelen in het menu Systeem > Configuratie > PostNL > Geavanceerde instellingen > Technische instellingen.

[POSTNL-0009] PostNL-only handeling op niet-PostNL zending

Probleem

In de backend is de melding “This action cannot be used on non-PostNL shipments.” of “Deze actie kan niet gedaan worden op niet-PostNL zendingen.”Â zichtbaar.

Oplossing

Enkel PostNL zendingen en orders kunnen door de PostNL extensie verwerkt worden. PostNL-only acties zijn o.a.: labels printen, zendingen voormelden, Track & Trace e-mails versturen.

Wanneer deze melding verschijnt als een bestelling wel verwerkt moet worden als PostNL zending, is het sinds 1.3.1 mogelijk om een externe verzendmetode te activeren als PostNL verzendmethode. Dit kan gedaan worden door het volgende stappenplan te volgen:Â

Controleer binnen de bestelling welke verzendmethode is gebruikt. Deze verzendmethode moet namelijk geactiveerd worden als PostNL verzendmethode.Â

Navigeer naar de PostNL configuratie (Systeem->configuratie->PostNL).Â

Wanneer er gebruik gemaakt wordt van versie 1.4.1, kan de instelling gevonden worden onder Geavanceerde instellingen->Technische instellingen->PostNL verzendmethodes. Activeer hier de verzendmethode welke afgehandeld moeten worden als PostNL verzendmethode.Â

Let er wel op dat, hoewel het meeste probleemloos werkt, er geen garantie kan worden gegeven dat een externe verendmethodegebruikt kan worden als PostNL verzendmethode.Â

Boven elke pagina in de backend staat:

“PostNL: It appears that your cron is not working properly. PostNL requires the cron to be active in order to function.”

“PostNL: Uw cron lijkt niet correct te functioneren. PostNL heeft de cron nodig om correct te functioneren.”

Oplossing

Er zijn twee methoden om uw klanten te voorzien van Track & Trace informatie:

1. Automatische e-mails op basis van de cronjob.

2. Handmatige e-mail op basis van de button “Send tracking information”.

In de configuratie van de extensie kunt u kiezen welke methode u wilt gebruiken in het tabblad “Track& Trace” van de Geavanceerde instellingen.
Ook zonder werkende cron kunt u dus uw klanten voorzien van Track&Trace informatie. Wij adviseren andere niet zichtbare functionaliteiten van de extensie wel om de Magento cron te laten draaien.

De PostNL extensie maakt gebruik van enkele cronjobs. Deze zijn nodig om de statussen van zendingen bij periodiek bij te werken indien u hiervoor heeft gekozen in de configuratie van de extensie. De extensie haakt in op de cron functionaliteit van Magento.

Mocht deze melding niet verdwijnen binnen een uur na installatie dan zijn er twee mogelijke oorzaken:
1. Er is op de server geen actieve cronjob ingesteld.
2. Magento cron functionaliteit is niet actief.

Server cronjob
De wijze waarop u cronjobs op uw server instelt verschilt per hostingprovider omdat er meerdere webserverbeheer systemen bestaan. Voorbeelden hiervan zijn DirectAdmin, Plesk en Cpanel.
Hieronder vindt u een voorbeeld van de wijze waarop u een cronjob instelt voor de DirectAdmin van Magento.

1. Ga naar het account waar de Magento omgeving op draait en klik “Cronjobs” aan.

2. Voor een Magento Community webshop stelt u in dat de cronjob elke 5 minuten geactiveerd moet worden (zoals in onderstaand voorbeeld). Voor een Magento Enterprise stelt u in dat de cronjob elke minuut geactiveerd moet worden.

3. Controleer met SSH of u de cronjob kunt activeren.
Dit kan door in een terminal venster in te loggen en het command in te voeren. In ons voorbeeld is dat “/home/magento/public_html/cron.sh”. Dit dient u te doen met root rechten.

Mocht dit niet werken of mocht uw server geen shell mogelijkheid hebben dan kunt u uitwijken naar het cron.php bestand.Â

In dat geval dient u twee cronjobs aan te maken. U dient aan te geven waar PHP draait voor de opdrachten. U kunt deze locatie achterhalen met de PHP constante PHP_BINDIR.

Achter de opdrachten dient u een parameter te plaatsen:

Opdracht 1: cron.php -malways 1

Opdracht 2: cron.php -mdefault 1

Zie onderstaand screenshot voor een voorbeeld.

4. Zorg dat uw cron.sh (of cron.php) bestand 755 rechten heeft.

De server roept nu elke 5 minuten (Community Edition) of elke minuut (Enterprise Edition) de cron functionaliteit van Magento aan.

Magento cron

1. Ga naar het menu System > Configuration > Advanced > System > Cron (Scheduled Tasks).

2. Zorg dat de instellingen gelijk zijn aan onderstaande afbeelding.

Nadat de cron actief is kan het enige tijd duren voor de melding verdwijnt, er zal namelijk een wachtrij aan taken voor de cron zijn.Â
U kunt het best de database openen en de table “cron_schedule” openen. Die zal direct gevuld worden en daarin kunt u zien of de aanpassingen effect hebben.

[POSTNL-0005] Gescheiden adresregels

Probleem

Op dit moment wordt er in de shop geen gebruik gemaakt van de gescheiden adres regels. Dit kan problemen veroorzaken bij het printen van verzend-labels. Bij internationale adressen is het zelfs noodzakelijk om gescheiden adres regels te hebben.

Oplossing

Magento Community

a.) Ga in uw Magento beheeromgeving naar Systeem > Configuratie en klik links onder het kopjeÂ

Â Â Â Â Klanten op Klant Configuratie.

b.) Klik vervolgens op het kopje Naam en Adresinstellingen.

c.) Voer bij het veld Aantal regels in adres het getal 3 in en klik op de Sla Configuratie op button.

Ga verder bij stap d.

Magento Enterprise
Volg deze a,b,c stappen alleen wanneer u een Magento Enterprise webshop heeft.

a.) Ga in uw Magento beheeromgeving naar Klanten > Attributen > Beheer klant adresgegevens.

b.) Klik op de attribuutcode street.

c.) Voer bij het veld lijn telling het getal 3 in en klik op de sla eigenschap op button.

Vervolgstappen voor Magento Community en Magento Enterprise

d.) Ga weer naar Systeem > Configuratie en klik op PostNL. Klik op het kopje Winkel Instellingen.

e.) Zet een vinkje achter ‘Deel straatnaam velden op’.

Â Â Â Â Â Â Â Â Â Â

f.) Kies bij Straatnaam veld de gewenste adresregel_._

g.) Kies bij Huisnummer veld de gewenste adresregel.

h.) Zet een vinkje achter ‘Deel huisnummer op’.

i.) Kies bij Huisnummer extensie veld de gewenste adresregel en klik op de _Sla configuratie opÂ _button.

Let op: Zorg dat voor straatnaam, huisnummer en huisnummer extensie verschillendeÂ velden worden gebruikt.

j.)Â Â Eventueel kunt u voor Gebied, Gebouw naam, Afdeling naam, Deurcode en Verdieping nog aparteÂ adresvelden aanmaken. Hiervoor moet u het getal dat u bij stap c heeft ingevoerd aanpassen.Â

Let op: Voor Magento Community kunnen er maximaal 4 adresregels worden ingesteld. Â Â Â Â Â Â Â Â

De adresgegevens zijn nu juist ingesteld. Vergeet niet de velden in de frontend goed te labelen. Hoe dit moet kun je hier vinden.

[POSTNL-0004] Extra verplichte velden nog niet actief