Nettpilot Mybring API for WooCommerce · PRODUCT NAME as seen in the Bring Product selector. 13. Pickup points: Set the user options for the cart and the checkout a. Activate pickup

Tosobakken 11, 3520 Jevnaker – [email protected] – tlf. 400 43 101 – org.nr 987598131 MVA

nettpilot.no/produkt/bring-fraktguiden-api-til-woocommerce/ (oppdatert 22/1 – 2020)

Nettpilot Mybring API for WooCommerce

With Shipping Calculations, EDI, Tracking, Shipping labels for Print and RFID.

The latest version of the plugin will always be available on an activated customers client

account https://www.nettpilot.no/min-konto/

If there is no downloadable product, then check your last order date. If it is more than 12

months since your last order, you’ll need to renew access

Order renewal from here: https://www.nettpilot.no/produkt/fornyelse-lisens-til-plugin/

How to set it up the plugin and make it work

1. Log in and sign up for a free Mybring Account at https://www.mybring.com/

2. Get your API key (Min Profil/Min API-nøkkel)

mailto:[email protected]

https://www.nettpilot.no/produkt/bring-fraktguiden-api-til-woocommerce/

https://www.nettpilot.no/min-konto/

https://www.nettpilot.no/produkt/fornyelse-lisens-til-plugin/

https://www.nettpilot.no/produkt/fornyelse-lisens-til-plugin/

https://www.mybring.com/



3. Order and download Bring API for WooCommerce plugin from Nettpilot:


4. Install plugin and activate it in WordPress admin backend.

5. Go to WooCommerce > Settings > Shipping > Bring.






6. The start screen points out the most important elements that used to be the major part of all

support requests. It still is

a. Set weight and dimensions for all products and variations.

We have added e feature that allows default product and cart dimensions and weight,

but still suggest customers to set this on product og product category level.

b. Be aware that Klarna checkout and custom themes made by design agencies with little

woocommmerce experience tend to make trouble. The same goes for Vipps direct

payment as such methods tend to bypass the standard WooCommerce shipping

calculation step, that is mandatory for a function like Bring Shipping caldulator to work.





Allways talk to either Klarna support or theme developer before reaching out to us for

help.

We will charge you for support if you need help with Klarna, or if we need to make

adaptations in your theme.

Usually the solution will be to force the shipping calculations to be made BEFORE

entering the Klarna checkout page.

We made a plugin called WooCommerce Shipping Forcer to address this issue.

c. Shipping zones has to be set right in order for the Bring shipping option to appear in the

cart calculation area.

Do not set Norway as a shipping zone as it will overrule Bring as Shipping method for

Norway.

You can set a pick in store option if you want, but then you will need to define zip codes

like this:



https://www.nettpilot.no/produkt/woocommerce-shipping-forcer/



7. Check the Bring validation check marks in the product list views. The red cross means no

shipping data input on the product level





8. Overview of the setup. Activate Bring in the plugin settings:

Notice the links and the Bring customernumbers the right column, in case you get stucked and

need help and support from either Bring or Nettpilot.

You can find your Bring costumer numbers via MyBring here:

https://www.mybring.com/useradmin/external/administration/customers/list?organisationNu

mber=

If trouble, then check if they are identical.



https://www.mybring.com/useradmin/external/administration/customers/list?organisationNumber=

https://www.mybring.com/useradmin/external/administration/customers/list?organisationNumber=



9. Mybring settings:

Since Fraktguiden 2.0, and Nettpilots plugin release version 2.3.2 then MyBring data is

mandatory. You must fill out ALL the Fields, except the address line 2 which can be left without

content. This is a screenshot of a test account.





Activate eVarsling, choose whether you will deliver the packages to the Post office, or let Bring

fetch them at your address (web shop base address).

You can also activate Return Label Integration:

10. When saving, make sure there is a green note saying: “Bring API connection Built Successfully”.

And you should be able to see your Bring Customer numbers in the right column. If not, please

check your WoCommerce systemstatus, and fix the notes in red letters.





11. General settings:

a. Set the name of shipping method in frontend and in order texts,

b. Set the language for Bring products as they should be shown in the checkout (fetches

the corresponding texts from the Bring API repository. Please tell Bring is you find

strange texts.

c. Set the webshop base country and zip. Very important.

d. If you have a lot of products and little time, the set default product and cart dimensions

here. We suggest that you only use this as a failsafe, and not as a permanent solution.





12. Select which Bring Products you would like your customers to choose from:

Please notice that Mybring does NOT support Norgespakke, and MAIL.

Visit http://developer.bring.com/api/products/ to learn more about limitations and possibilities.



http://developer.bring.com/api/products/



13. Pricing:





a. Activate support for coupons with free shipping

b. Make all customer shipping free on all orders, but still get Mybring bookings made.

c. Remember to set the VAT calculation correct.

d. Round shipping prices to nearest whole amount

e. Remove decimals for the customers

f. Set the fixed price in price adjustments without vat, use the Precise SHIPPING GUIDE

PRODUCT NAME as seen in the Bring Product selector.

13. Pickup points:

Set the user options for the cart and the checkout

a. Activate pickup points or not

b. Choose number of pickup points (max 10)

c. Choose whether to show pickup points address and opening hours or not

d. Add you own Google map API key (ours tend to be overloaded)

e. Choose what kind of pickup point map you want





14. When entering a zip in the calculator you should get a view like this:

15. The above map view is the Pickup Point Single Map setting. Try the Pickup Point Map setting for

smaller screens and mobile views.

16. Add help text or meta. Help text fetches Brings meta description from the Bring product options.

The meta should only be used if you know what you are doing.

17. Activate test settings for testing purposes and activate debugging.





18. Save and test Bring Shipping Guide API functionality.

19. If settings are made as in the below example the checkout should look like this if no zip is being

entered:

We suggest that you change the translation of the original shipping calculator text in

WooCommerce: There is no shipping methods available.(…)

Change it into a text like this:

Please enter your zip (maybe country) in order to see the available shipping options.





20. Test the workflow from the customer perspective and see if it all works out as expected.

21. Test the workflow from the shop owner perspective and see if it all works out as expected.

22. Shipping labels and MyBring orders are generated when changing the order status from

Pending to Processing (NO=Behandler)

23. After change of order status to Processing the Booking order is now also available at

Mybring.com:

24. Links to the orders shipping labels can be found in the right side of the screen in the order notes

under each order in the WooCommerce orders view.





25. Consignment number and links to Links to Bring order tracking page can be found in the order

notes under each order.

26. Links for labels is also presented as a label icon in the order list view.

27. If no label is showing up after changing status to Processing, then check the data that is being

sent and the error feedback from the Bring API. If you need support then we will allway ask that

you send us this error feedback. Without it, we cannot do anything but guess. And we do not





want to base our support on guessing. Sometimes we will ask you to send your request to Bring

Customer integrations at [email protected] and let them look into your issue as som

problems relates to MyBing account structure and customernumbers.

Example, here is a call that tells us what the error is.

28. In order to print regular shipping labels, you can order a reasonable thermo printer here:

http://bit.ly/etikettskriver

In order to print RFID labels, you can find and order RFID Printers here:

http://bit.ly/rfid-skriver

You can find and order labels for RFID and regular thermoprint her:

http://bit.ly/etikettruller

Before asking for help please read this:

29. Make sure you have the right API keys and Bring customernumbers.

30. Use Brings own Customerservice feedback form if you get error responses regarding

missing access on certain customer numbers and productnumbers.




http://bit.ly/etikettskriver

http://bit.ly/rfid-skriver

http://bit.ly/etikettruller

https://www.mybring.com/frontpage/feedback.html



31. Updated Changelog and update instructions can be found her: https://www.nettpilot.no/bring-

kunnskapsbase/

You’re good to go!

Questions and comments can be directed to Nickolass Jensen, Nettpilot,

[email protected].



https://www.nettpilot.no/bring-kunnskapsbase/

https://www.nettpilot.no/bring-kunnskapsbase/


Documents

Nettpilot Mybring API for WooCommerce · PRODUCT NAME as seen in the Bring Product selector. 13. Pickup points: Set the user options for the cart and the checkout a. Activate pickup