[ENG] Shopify International

Below is the documentation for InPost's proprietary Shopify solution for InPost International services. It contains information about the installation and configuration of the plugin.

The plugin is available on the Shopify app store

App available to Shopify customers (functional requirement for the app to work:

store must have access to Carrier Service API
Advanced or Shopify plan paid annually

The plugin does not have a Geowidget map → it requires the user to enter an address with a valid postal code based on which available pick-up points will be determined

Plugins

05.02.2025

Marketplace Shopify

InPost International – oficjalna integracja Shopify | Shopify App Store

The plugin is updated automatically

CHANGELOG

Changelog:

05.02.2025 → Making the plugin available in Shopify's app market

1 Plugins
2 CHANGELOG
3 Authorization
- 3.1 Production / test environment
4 Installation
5 Configuration - tabs
- 5.1 Authorization (Login Details)
- 5.2 Services
6 Shipments - management
- 6.1 List/Filtering
- 6.2 Tworzenie przesyłek
- 6.3 Downloading labels
7 Excluded products
8 Checkout - list of points
9 Contact

Authorization

Production / test environment

Installation

Install the app from the Shopify App Store

Steps:

Log in to the Shopify App Store
Find the InPost International app, then click it
On the app's offer page, click Add app
To authorize the use of the app, click Install app in the Shopify dashboard

Once the app is installed, you can view and use it on the Apps page in the Shopify dashboard.

For more information:Instalowanie aplikacji

Po instalacji w panelu sklepu pojawi się aplikacja po lewej stronie:

Configuration - tabs

To configure the plug-in, we go to the InPost International application. Several tabs appear there, below we explain what they mean.

(The changes you make should be saved, by clicking the Save Settings button at the bottom of the screen)

Authorization (Login Details)

Połącz z kontem InPost

This button is responsible for connecting to API International. When pressed, you are redirected to the login panel. There you need to enter login/email and password.

After entering the correct data, the user is redirected to the application and the button becomes inactive and displays information about the currently logged in account. The application does not require logging in again, the association with the account is permanent.

[Delete linkage] It is possible to delete the linkage by selecting Delete linkage, as a result of which a message is displayed asking you to confirm the deletion of the account linkage (the user account is not deleted but only disconnected, other data in the application also remains intact).

Typ API

The environment that is currently enabled

Sandbox - is used to test InPost services. Allows you to generate shipments, order fictitious pick-ups or download the label without payment
Production - using the plugin to actually create shipments and order courier pickup

Status wtyczki

Checkbox to enable or disable the plug-in along with visibility on the checkout page

Services

The tab allows you to configure shipping services

Wybierz usługi	The user can activate the services available to customers: can change the service's own name can select the number of points showing near the customer's address indicates the available type of pickup points showing in the shopping cart (Parcel Machine/Parcel Point/Parcel and Parcel Post) can define the delivery cost for the service can define the cost at which free delivery starts can define the maximum allowed weight can upload a graphic of the service (or overwrite the defined one), this option is only possible for Plus customers (requires checkout access)
Ustawienia nadania	Default parameters for created shipments: several dimensions can be defined the default dimension is the first to be selected when creating the shipment once a dimension is used, it cannot be modified default dimension cannot be deleted until another dimension is set as default.
Punkt odbioru przez kuriera	In a similar way to parcel dimensions, you can define available pick-up points for which you can create drive-up orders in the next step: several points can be defined the default point is prompted as the first one when creating a shipment once used a point cannot be modified a default point cannot be deleted until another one is set as default
Osoba kontaktowa	In a similar way to parcel dimensions, you can define contact persons associated with the created parcel collection orders: it is possible to define several contact persons default contact is as first when creating a shipment once used, the contact cannot be modified default contact cannot be deleted before another one is set as default the contact person is not visible on the shipment label
Domyślna wartość ubezpieczenia	Allows you to set the insurance amount as the default - it will be assigned to each shipment
Nadawca	Shipper data that will appear on the label and in the InPost system

Shipments - management

A place to manage orders and shipments. We can manage them in bulk or by going into individual orders.

List/Filtering

The table contains the following columns:

checkbox to select shipments individually or all in the list
shipment number (link to details/tracking, external link, new tab)
order number, link to order details
shipment status
shipment price
service
features of the shipment
method of shipment
date of order creation
date of shipment
recipient's data
reference number
print action also available in bulk

The user can filter the table by the following filters:

shipment number (text field)
shipment status (selection list)
order creation date (datepicker)
date of shipment dispatch (datepicker)
service (selection list)
method of shipment (selection list)
phone number (text field)
email address (text box)
reference number (text field)

Tworzenie przesyłek

By pressing the button (The button is available for orders for which a tracking number has not been generated.) We can go to a detailed view of a specific order in the InPost International app

order details is a special view inside the Shopify app that provides a full summary of the user's order, including products, total cost, address and billing information

The order details view is divided into 2 sections:

The left section is customer data and order details
The right section is used to generate the shipment

The user can:

define a service → the service selected by the customer at the order stage is loaded by default
change the parcel machine selected by the customer
change the pickup address selected by the customer
define shipment size
define insurance value
method of shipment

After verifying the data, click Create Shipment - a shipment number will be assigned in the “Shipment Number” field

An alternative path to create a shipment is:

Opening the Shopify orders view, which also shows the shipping details to the point:

Display the details of the order and open the menu with the selection of the “Create InPost International shipment” application:

Downloading labels

Once the shipment has been created, the user can download the label and proceed to track the shipment:

Click Download Label

Select Print - it will automatically start downloading the label

Excluded products

Using this tab, it is possible to exclude products for which it is possible to choose delivery via InPost International

Checkout - list of points

An example of how checkout looks with an address in France:

Contact

If you have any questions, please 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 provide the name of the module we specify: Shopify

Developer Documentations