[ENG] WooCommerce International

[ENG] WooCommerce International

image-20240725-101008.png

 

 

Below is the plugin and documentation on our proprietary InPost plugin for WooCommerce.

The documentation describes the module's installation, configuration, and discusses the various functionalities of the module such as shipment creation and label generation.

 

Available for: BE - Belgium / ES - Spain / FR - France / IT - Italy / LU - Luxembourg / NL - Netherlands / PT - Portugal

 

Changelog

1.0.1 - 03.07.2025

  • FIX: calculating of product dimensions

Authorization

Production/test environment

 

Use of the PRODUCTION environment is only possible after signing an INTERNATIONAL service agreement

 

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

  • ClientID and ClientSecret

  • Login and password

In order to connect to InPost services, it is required to obtain a login and password.
To obtain authorization data, contact InPost via the form:
Grant access to API → API International → Environment: Production or Sandbox (for testing the service only)

https://inpost.pl/formularz-wsparcie

Connecting to InPost services is done by redirecting to the website. Please make sure that you have pop-up permissions enabled in your browser.

 


Installation

Log in to the administration panel of your store on the WooCommerce platform

  1. Go to PluginsInstalled plugins

 

  1. In this tab, select the Add New button and then Send Plugin to Server

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


Configuration

Search the module for further configuration by going to the side panel → InPost International

image-20250319-090000.png

 

Description tabs

image-20250319-090856.png

Authorization

Description

ClientID

ID needed for authorization - the AUTHORIZATION tab above describes how this data can be obtained

ClientSecret

Key needed for authorization - in the AUTHORIZATION tab above, it is described how this data can be obtained

Type API

Production mode - allows you to generate real shipments, Sandbox mode - allows you to generate shipments, driveway orders and download labels without charge

Włącz metody wysyłki Inpost International tylko dla administratorów

Enable Inpost International shipping methods for administrators only

Connect to the API

After completing the ClientID and ClientSecret, select CONNECT WITH INPOST where you will need to complete the login and password for Parcel Manager, on which the International service is enabled.

 

Geowidget settings

Description

Geowidget settings

Description

Geowidget production token

It is required to complete a token for Geowidget in order to enable service visibility in checkout (Production environment only).

The token should be generated in InPost - Manager paczek My Account tab - API - Geowidget

Token sandbox Geowidget

It is required to complete a token for Geowidget in order to enable service visibility in checkout (Sandbox environment only)

Generate the token in https://sandbox-manager.paczkomaty.pl/auth/login My Account tab - API - Geowidget

Choose a color

Change the color of the button to select the pickup point in checkout

No visibility of services in the shopping cart

Settings allow the place of visibility of the button to select the checkout point

Enable JS mode and Geowidget script, which enable the pick-up point selection button if checkout is customized

Dealer settings

 

Dealer settings

 

Name and address details of the sender

You need to fill in the data of the sender of the shipments, they may be visible on the labels

 

Dispatch points

 

Dispatch points

 

Add or remove points

Allows you to create a pickup point that will be visible to the courier when you order a shipment to be picked up. Multiple points can be generated.

 

Shipping options

 

Shipping options

 

Do not provide InPost Parcel services when the weight of the product is more than 25kg

If you set the weight in the product - when the weight is more than 25kg InPost services do not show up in the checkout as a form of delivery

Change the order status to COMPLETED after the shipment is generated?

Automatic change of status to Fulfilled after the shipment is generated in the InPost panel

Send an email to the buyer about the start of the delivery process as soon as the shipment is created?

Automatic sending of an email about the start of the delivery process of products after the creation of a shipment (WooCommerce email template)

Automatically copy the buyer's comment into the 'Reference Number' field

Completion of the field Reference number comment added by the buyer when placing the order - if left and create the shipment will appear on the label.

Default shipping method

Settings specify when creating a shipment the default way of sending it → at CURIER or PARCEL LOCKER

Parcel templates

 

ON / OFF this option to fill in the dimensions from the product settings, or create your own templates below and set any as default

Allows you to enable or disable the option to retrieve dimensions from product settings

Templates

Create or delete shipment templates, which can be selected when creating a shipment or automatically assigned to products

 

Product settings

 

Product settings

 

Product settings management

Enables:

  1. Enable InPost International services in bulk or individually

  2. Specify shipment sizes for specific products in bulk

  3. Filter products by category, type and shipping class

 

Shipment table

 

Shipment table

 

Shipment management

Allows you to manage your created orders through the InPost International delivery method. Order pick-ups, download labels, and check shipment status

Creating a driveway order

By selecting the method of shipment - CURIER and clicking FILTER, you will be able to generate a courier pick-up for your shipments


Create delivery methods

 

For proper operation of the InPost International service, you need to add the delivery method to the WooCommerce settings

 

  1. You can go straight to where you need to do this by clicking the → WooCommerce Shipping Settings button in the plugin configuration

 

image-20250319-100744.png
  1. Choose a zone for a specific country or create one with several countries and add a shipping method

Available for: BE - Belgium / ES - Spain / FR - France / IT - Italy / LU - Luxembourg / NL - Netherlands / PT - Portugal

 

image-20250319-101243.png
image-20250319-101332.png
  1. After adding the method, configure it by clicking EDIT

image-20250319-101634.png

Settings

 

Settings

 

Logo

Choice of default uploaded logos or ability to upload your own

Name of methods

Default specified according to the standard

Insurance amount

It is possible to set the amount of insurance with a default value (which will be assigned automatically when creating the shipment) or by checking the checkbox - automatically the value of the order will be assigned to insurance.

Insurance may equate to an additional fee - please discuss this issue with your Account Manager

Free shipping

The amount from which shipping will be free for a given order

Add the label “(free shipping)” to the end of the shipping method title

Replaces the rate of 0 zloty for delivery on the inscription “free shipping”

Discount for coupons

Free shipping will be available based on the order amount before discounts

Flat rate

By setting a flat rate - the amount for delivery is always the same

By unchecking this option you will be able to set the price against:

  1. Prices (orders) - from to → amount for delivery

  2. Weights (orders) - from to → amount for delivery

  3. Number of products - from to → amount for delivery

  4. Based on templates - each template → amount per delivery

image-20250319-102801.png

Cost per order

Cost per order

Tax status

Amount of delivery taxed or not

Shipping class costs

Set prices against shipping class

 


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

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

image-20250321-093656.png

Directly in the product

Templates

In each product there is an option to specify specific dimensions for courier shipments and dimensions for Parcel Post® shipments. They are automatically downloaded to the order

InPost -> Product Settings tab

 

image-20250321-093330.png

 

Availability of services

Directly in the product, set the visibility of individual services in the shopping cart (newly created as well)

 

image-20250321-093450.png

 


Order processing/shipping

Creating a shipment and downloading a label

Allows you to generate shipments and download labels

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

 

Orders

Description

Orders

Description

Selected parcel machine

The name of the device that the customer chose when placing the order

Status

  1. Not created yet → means that no attempt has been made to generate the shipment

  2. Created - created (if the tracking number does not change it means that there is an error during the creation of the shipment - you should check the error logs which may help to solve the problem or contact InPost technical support)

Templates

Allows you to select a previously created template or mark From product settings → dimensions will be taken from the product

image-20250321-090654.png

Dimensions and weight

Downloaded from templates or product → can be edited

insurance amount

Default amount set in the configuration of the delivery method or from the value of the order (if such option was selected in the delivery method)

Method of transmission

Default value from Shipping Options plugin settings → editable possible

Reference number

Default is WooCommerce order number → possible change in Shipping Options on buyer's comments

image-20250321-090118.png

Once the shipment is created, a tracking number appears and a Download Label button → clicking on it downloads the PDF


Mass shipment creation

It is possible to create bulk shipments (those that do not yet have a tracking number) by going to WooCommerce → Orders

  1. We mark specific orders with the checkbox

  2. Choose from Mass Actions → InPost INT creation of shipments

Parcels, once created, will be given a consignment number

 


Mass downloading of labels

Plugin allows you to download labels in bulk

There are two places where this can be done

  1. Orders tab - Bulk Actions button at the top of the table

  2. InPost International tab - Shipment table → select specific shipments and choose Download labels

 


Creation of a courier pickup

Ordering a courier's pick-up is possible in the plug-in's configuration in the SHIPPING TABLE tab.

In the International plug-in in the courier's driveway, we specify the day of pickup, time, number of shipments and their weight

→ the latest pickup time is determined by the postal code and cut-off time of the shipment

 

image-20250321-085144.png

 


Contact

If you have any questions, feel free to use our contact form available at the link https://inpost.pl/formularz-wsparcie . After entering the form, simply select Customer Support from the list, in the category select: InPost International module, and in the field Please specify the name of the module we specify: WooCommerce