[ENG] WooCommerce

 

image-20240725-101008.png

Below is the documentation for the proprietary InPost WooCommerce plugin. It contains information about installation and configuration of the plugin

 

Plugin: (latest version of new release 1.5.9 available on wordpress)

https://wordpress.org/plugins/inpost-for-woocommerce/

Changelog:

1.5.9 - 07.11.2024

  • FIX: integration with Flexible Shipping for Checkout blocks

  • New: new Product settings page

1.5.8 - 04.11.2024

  • FIX: alternative JS-method of map button

  • FIX: hide checkbox “Ship to different address”

1.5.7 - 26.10.2024

  • FIX: parcel locker data view in new Checkout

  • FIX: SmartCourier in filter on page “Shipments”

1.5.6 - 22.10.2024

  • FIX: error on search on page “Shipments”

1.5.5 - 02.10.2024

  • FIX: pagination on page “Shipments”

1.5.4 - 02.10.2024

  • FIX: validation of COD after a change in value

1.5.3 - 30.09.2024

  • FIX: validation on Checkout Blocks on country change

  • FIX: double map widget

1.5.2 - 16.09.2024

  • FIX: message details for error during package createing

1.5.1 - 03.09.2024

  • New: printing dispatch order

  • FIX: html icon

1.5.0 - 12.08.2024

  • New: increasing the number of multipacks created to 11

  • New: taking the insurance amount from the order value

1.4.9 - 26.07.2024

  • FIX: compatibility error for Courier parcels

  • FIX: change COD amount before creating parcel

1.4.8 - 25.07.2024

  • New: SMS and EMAIL service added for Courier Standard

1.4.7 - 17.07.2024

  • New: “Multi-packet shipment” for COD (cash on delivery) courier method.

1.4.6 - 15.07.2024

  • FIX: compatibility with CheckoutWC plugin

  • FIX: map params for Checkout blocks checkout

1.4.5 - 11.07.2024

  • New: added option to generate multi-packet shipments (Standard Courier).

1.4.4 - 01.07.2024

  • FIX: integration with Flexible Shipping for feature “Druga paczka”

  • FIX: colspan on Checkout page

  • FIX: adding buyer’s note for order in Bulk creating mode

1.4.3 - 14.06.2024

  • FIX: we have corrected a bug in the JS for the Courier COD method

  • New: added the ability to pass customer comments from checkout to comments in the shipment (switch in plugin settings)

1.4.2 - 22.06.2024

  • FIX: Validation error for SmartCourier on checkout

1.4.1 - 17.05.2024

  • FIX: Print label format A6/A4

1.4.0 - 16.05.2024

  • New: New method delivery “Smart Courier”

1.3.9 - 25.04.2024

  • FIX: Insurance amount error

1.3.8 - 04.04.2024

  • FIX: Correction of the insurance amount display

1.3.7 - 26.03.2024

  • FIX: More information about the address of the point

1.3.6 - 19.03.2024

  • New: Setting: possibility to create multiple shipments in one order

1.3.5 - 12.03.2024

  • FIX: saving data to order meta for HPOS for all methods

1.3.4 - 07.03.2024

  • FIX: Saving data to order meta for HPOS

1.3.3 - 04.03.2024

  • FIX: For writing data to WooCommerce API

  • FIX: "deprecation warning" error in PHP 8.2

1.3.2 - 26.02.2024

  • FIX: Gab. D for Courier C2C

  • New: Block display of delivery methods from COD for amount over 5 thou.

1.3.1 - 21.02.2024

  • FIX: Size D for Kurier C2C

1.3.0 - 06.02.2024

  • FIX: Limit of order total in 5000 for COD methods

  • FIX: New block’s Checkout when only one Inpost shipping method is enabled

1.2.9 - 12.01.2024

  • FIX: CSS fix

  • FIX: Change enquene of “front-blocks.js” script

  • New: New Setting for shipping methods – disable/enable “free shipping” notice

1.2.8

  • FIX: Conflict in scripts

1.2.7

  • New: Integration with Woo Blocks checkout page

  • New: Additional settings in Debug section

1.2.6

  • FIX: PayPal operation with plugin

  • FIX: Deprecated" PHP errors for PHP 8.2

1.2.5

  • FIX: map opening on plugin setting’s page

  • Autocomplete field “parcel size” for parcel locker shipments based on settings saved in product

1.2.3

  • FIX: Integration with HPOS

  • FIX: Divi Theme

1.2.2

  • Integration with HPOS

1.2.1

  • FIX:: integration with Flexible Shipping plugin

1.2.0

  • FIX: Saving point data at Checkout to LocalStorage

  • FIX: double street on the label

1.1.9

  • FIX: Ability to change order status when creating a package

1.1.8

  • FIX: Functionality: setting default size for courier parcel

 


Authorization

Production environment

You must have access credentials to connect to the ShipX API before installation:

  • Access Token (key)

  • ID organization

and

  • Access Token for Geowidget

Download a tutorial explaining how to quickly create access to the ShipX API and Geowidget on your own:

https://inpost.pl/sites/default/files/2022-03/instrukcja-konfiguracji-api-shipx.pdf

Test environment

Access generation

https://sandbox-manager.paczkomaty.pl/ > tab Moje konto > API

To generate a Token and an organization ID, you need to complete all the data, including billing details under My Account > Data. In order to create a Parcel Locker® shipment you need funds in your account, you will top up your account virtually in the Payments tab

Geowidget:

  • Access Token do Geowidget > tab Moje konto > API > Geowidget


 

Plugin installation

Log in to your store's admin panel on the WooCommerce platform

  1. Go to Plugins → Installed Plugins

 

 

2. In this tab, select the Add new and then Upload Plugin

(Click the button and upload the installation package as an Archive)


 

Plugin configuration

 

Search the module for further configuration by going to InPost → Settings

Logging in (Authorization)

Here you can fill in your API access data (Token, Organization ID), which you can generate yourself in the Parcel Manager under the "API" tab.

(Access to the environments is at the beginning of this documentation)

 

Organization ID

should be completed from Parcel Manager (My Account tab - API, format - 5 digits)

Token

should be completed from the Parcel Manager (My Account - API tab)

Geowidget production token

should be completed from the Parcel Manager (My Account tab - API - Geowidget).

Without this data, the Map will not display correctly

Geowidget sandbox token

should be completed from the Sandbox Parcel Manager (My Account - API - Geowidget tab)

Without this data, the map will not display correctly

API Type

Production/Sandbox

Szybkie Zwroty

here you can fill in the abbreviated name of your account set up on the Fast Returns website

Insurance

Default insurance amount

allows you to specify a default insurance value to be completed on shipments

Send options

Default insurance amount

allows you to specify a default insurance value to be completed on shipments

Default package size

applies to Parcel Locker service - gab. A/B/C

Default courier package size

default dimensions for courier shipments (when checked overwrites the dimensions set in the product)

Default send method

Courier/Parcel Locker

Parcel locker label format

choice of A4 or A6

Default send parcel locker

default parcel locker, which will be substituted when you select the way of shipment - parcel locker

Dispatch Point

Dispatch Point

allows you to add/delete/edit Receipt Points

Sender

Sender

It should be completed with the company data

Additional options

Enable InPost methods for all products in your shop

Checkbox to enable InPost delivery methods in all products at once

Enable SmartCourier method for all products in your shop

Enables SmartCourier delivery method for all products

Do not provide InPost parcel locker service if the weight of goods exceeds 25 kg

Only works if weight is set in the product

Send an email to the buyer about the start of the delivery process just after parcel created?

Sends an email to the customer about the creation of the shipment

Change order status to Completed after shipment created?

Changes the status of an order after creating a shipment in the order

Automatically add buyer order comment to field 'Reference'

Automatically copies the buyer's comment/remarks to the “Reference Number” field when creating a shipment in an order

 

 

Debug Mode

This mode allows you to enable additional options available to the administrator as well as change the location of the "Select Parcel Machine" button display

 

  • Enable JS mode of the map button → Setup for Multisite stores (in the absence of “Choose Parcel Post” button)

  • Disable condition to enable geowidget scripts only on Checkout page → Enable when the “Select Parcel Post” button is not working

 


Quick Returns

The service allows customers to return shipments ordered from the store via Parcel Locker

  1. In the plugin configuration, you need to provide a link to the Fast Returns form (e.g. https://szybkiezwroty.pl/pl/Nazwa_sklepu). The link is created when you create an account for this service through the Sales Representative

  2. A customer who is logged in to the store in the order tab sees a new Fast Returns button this takes them to your form where they can make a return

 

 


 

Available delivery methods

Delivery methods

Description

Delivery methods

Description

InPost Locker 24/7

InPost Locker COD

Delivery of a shipment to Parcel Locker/Parcel Point pickup points

  • Method with COD (cash on delivery method)

InPost Courier

InPost Courier COD

Delivery of the shipment to the address provided by the customer

Service available only for business customer (contract)

  • Method with COD (cash on delivery method)

  • Additional service for Courier Standard - SMS notification, EMAIL notification (paid)

InPost Courier C2C

InPost Courier C2C COD

Delivery of the package to the address provided by the customer

Service available for retail customer - (prepaid) (rates according to the price list on the website InPost.pl

  • Method with COD (cash on delivery method)

InPost Locker Weekend

Delivery of a shipment to Parcel Locker on the weekend available 24/7

InPost SmartCourier

Delivery of a shipment to the address provided by the customer. A service dedicated to the delivery of goods that require personal delivery with confirmation of the recipient's data. The delivery process requires verification of the addressee with such data as first name, last name, age of majority, and if delivery of a category of goods requires sobriety of the recipient of the shipment, this will also be verified


 

Delivery Services

Configuration

To configure the services available in the shopping cart, you need to add each one individually in the configuration

  1. To do this, go to WooCommerce → Settings → Shipping

2. Select the country (edit button)

3. Click Add shipping method

4. Select a specific service

 

 

 

 

5. The service is added. It needs to be configured

 

When selecting a service, we have the ability to configure it:

Changing the name of the service

The name of the service and the logo should be added according to the guidelines in the „Poradniku skutecznej implementacji dostaw InPost w koszyku e-commerce” link: https://inpost.pl/sites/default/files/docs/regulaminy/instrukcja-ekspozycji-dostawy-paczkomat-inpost-247-w-twoim-sklepie-777232.pdf

Changing the logo

originally the current logo is already added to the delivery method

Setting the amount from which free delivery applies

 

Possibility to add the text "free shipping" in the checkout

 

Inclusion of discount for coupons

 

Setting the price for shipping

 

Whether shipping should be taxed (according to WooCommerce rules)

 

Flat-rate

In addition, by unchecking Uniform rate, you can set the shipping price in terms of the weight in the cart, the size as well as the price of the products themselves

weight/size/price are taken from the settings of the product

Shipping class configuration

Configuring a shipping class allows you to group products when it comes to prices

 

Preview:

 

 

 

 


Shipping class costs

Configuring a shipping class allows us to group products when it comes to prices. We create a shipping class, which we can assign to a specific item(s) in the product settings.

We can add as many shipping classes as we want.

 

Class creation:

You need to create shipping classes on the tab WooCommerce → Settings → Shipping → Shipping classesAdd shipping class

 

Configuring in the delivery method:

WooCommerce → Settings → Shipping → Zone

In a given form of delivery, such as InPost Parcel Locker® 24/7, you need to specify what shipping costs will be in a particular class

 

 

Priority of calculation of delivery price:

  1. if the free delivery threshold is reached then - free delivery

2. if the free delivery threshold is not reached - we take the price for the delivery class

3. if the delivery class is not specified - then the settings of our plugin (flat rate or price from the table against the size/weight)

 

Configuration in the product:

Moving to a specific product, you need to set in the Shipping tab which shipping class it should belong to

 


InPost Locker Economy

Products ordered through the provided InPost Paczkomat® Economy Parcel service get an attractive delivery price. Receiving economy parcels from Paczkomat® InPost is the safest way to carry out online orders, especially with the remote opening of the box through the InPost Mobile application

A new shipping method should be added to the operation of the service

  1. WooCommerce tab → Settings → Shipping → Add shipping method

 

2. Then configure the service by providing the commercial product ID given in the contract and complete the price for the service

 

3. When the customer selects the InPost Locker Economy, information about the service and the variant will appear in the order

 

 


Weekend Parcel Service

In order to make the Parcel on the Weekend service available, you need to add a new delivery method

  1. To do this, go to WooCommerce → Settings → Shipping

  2. select a country (edit button)

  3. click Add Shipping Method

 

From the list, select: InPost Locker Weekend

 

 

We proceed to the delivery configuration:

By setting a specific day and time, we indicate at what times the specified service should appear in the shopping cart on the website

 

 

 

 


 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

Order processing/shipping

Order handling

Allows generation of labels, creation of shipments, printing of collection orders

Moving on to the order after the customer selects a specific service, the window for InPost shipping appears

 

 

 

After completing and verifying the data, press the Send Parcel button to generate the package and assign a tracking number

After a while, the Get stickers and tracking number button appears


Mass shipment creation

The plugin allows you to create shipments in bulk

  1. Go to the Orders tab and select the specific orders in which you want to create a shipment

  2. Then expand the list - Bulk actions at the top of the table and select InPost PL create shipments

 


Create multiple shipments in an order

 

It is possible to create several parcels in an order

  1. After creating the first shipment under the Get sticker button, click Create another shipment

  1. Select the delivery method for your next shipment and click Add Another Package

 

  1. A new window with shipment information is shown. Select the Send Parcel button

  2. The window refreshes and the option to download the label appears

 


Creating multi-packet shipments

Standard Courier service is the possibility of generating multi-packet shipments (1/3,2/3 ...).

  1. Entering the order we checkobox: Send as several packages

  2. A window appears with a view of additional shipments 5/5 - remove the unnecessary number of shipments

  3. We enter the dimensions and click Send Parcel

After creating a shipment, you can download labels (number of labels depending on the number of shipments)

 


Mass downloading of labels

The plugin allows you to download labels in bulk

There are two places where this can be done

 

  1. Tab Orders - bulk actions button at the top of the table:

 

 

 

 

2. Tab InPost - Shipments - Get stickers button (after selecting shipments)

 


 

 

Shipping service

Tabs:

InPost → Shipments

 

Here it is possible to handle and view drive-up orders, currently processed and shipped shipments, generate labels, create and print pickup orders

Here you can also create labels in bulk

 

 

 


 

Configure delivery methods in products

Mass editing from within the plugin

We have created a general view of the added products in the store so that we can more easily determine the available delivery methods and product sizes (Parcel Locker)

It is possible to filter by categories, product type or search for products by name

 


Directly in the product

Templates

In each product, it is possible to specify specific dimensions for courier shipments and dimensions for Parcel Post® shipments. They are automatically downloaded to your order.

 

Availability of services

Directly in the product, set the visibility of individual services in the shopping cart:

 

 


 

 

Handling coupons for delivery

Coupon support in the shopping cart can be enabled at WooCommerce → Settings → General → Enable coupons

Configuration can be found under Marketing → Coupons

  1. We click add coupon

  2. We choose from Discount type → Inpost

  3. Set the value of the coupon, its name, expiration date and for which forms of delivery it should appear

  4. Click Publish

 

 

In the shopping cart after the customer adds the coupon, the discount information shows above the shipping and the shipping amount is reduced by the value of the coupon

 

 


 

Integration with Flexible Shipping

 

Our module allows you to integrate with Flexible Shipping plugin

After activating this plugin, the standard list of InPost services disappears

To configure the services available in the shopping cart, you need to add each one individually in the plugin configuration

  1. To do so, go to WooCommerce → Settings → Shipping

2. select a country (edit button)

3. click Add shipping method

4. select Flexible Shipping

 

 

After creating a form of delivery, you need to configure it

Go to the specific newly created service, which is tentatively named Flexible Shipping, and click Edit

  1. We fill in the name of the service

2. We select a specific service assigned to InPost API

3. Set the price and configure further settings of the Flexible Shipping plugin

 


 

Solutions to problems

 

An error occurred while connecting to the API

  • One of the reasons for the above error is when the data provided in the place of Organization ID and Token is incorrect - or the data provided does not apply to the API Type: Sandbox (Sandbox and Production are two separate environments and have different organization IDs)

After each modification of the token or organization ID, save the settings (only then the authorization data is verified)

 

  • This error can also appear when the store's connection to the API is blocked - either on the server side of the store (you should verify this state in your hosting) or on our side. In this case, please contact us via our form https://inpost.pl/formularz-wsparcie

 


Creating a parcel - Selected offer

 

In the order when creating a shipment in the status instead of tracking number appears Status: offer selected

This means that the shipment has not been created

Possible reasons:

  1. Lack of funds in the account in Parcel Manager (for Prepaid customers)

  2. No bank account number in Manager Parcels

  3. In case of courier service, no attached courier contract in Parcel Manager

  4. Error regarding recipient data - post code


Geowidget - no access

When the shopping cart in Geowidget shows the error "No access, check if the token has been generated for the correct site" you need to re-generate the token for Geowidget in Parcel Manager but specifying the correct store site address. The error is related to providing an incorrect store URL.

 

 


No deliveries in the InPost shopping cart

No services in the product

InPost services must be added in a specific product:

 

 

You can also add InPost services to all products at once:

 

 

 

Delivery method 'Free Delivery'

This method in WooCommerce causes that when it meets the condition and can be displayed in the shopping cart next to the product, it removes all other available delivery methods.

It should be removed

Free delivery from a specific amount can be set in our InPost methods


 

 

"Select Parcel Locker" button does not respond

You should:

  • Check if the tokens for Geowidget and API are correct

  • Check if the shipping methods are still added in WooCommerce - Settings - Shipping.

  • Check if InPost services are enabled in products (product configuration)

  • Check if any of the options are enabled in the INPOST tab at the very bottom:

Enable JS mode of the map button

Disable check so that the script for geowidget is connected only on the Checkout page → Enable when the " Select Parcel Post" button does not work


 

 

Contact

 

If you have any questions, please use the Integration Department's contact form, which is available here: https://inpost.pl/formularz-wsparcie  

 After entering the form, just select "Customer Support" from the list, in the category select: InPost module, and in the field "Please specify the name of the module" enter: WooCommerce