InPost Parcel Lockers

The InPost Parcel Lockers tab allows basic integration with InPost Parcel Lockers (Paczkomaty) in terms of paying for parcels and generating labels.

Note

InPost Parcel Lockers are a Polish pick-up point network. The integration works both with online payment and payment on collection. The minimum data we need to collect from customers in order to generate a label is an email address and a Polish phone number. Orders are only fulfilled within Poland.

Available options

Here is a list of the available options with a short explanation.

InPost integration

Determines whether the InPost integration is active. If it is active, an additional button will appear on the order list, which allows you to generate a label for the given order. For this to be possible, you must have an active BASIC or PRO account, and the delivery method selected by the customer must be InPost Parcel Locker.

Test mode

Determines whether the integration works in test mode or not. In test mode you can test the operation of the whole system, but this requires a special account, which can be created here: https://sandbox-manager.paczkomaty.pl/

Note

If you use a test account, remember that the access data from the “normal account” will not work (and vice versa) - keep this in mind.

Organisation ID

This is a number assigned by InPost in the Parcel Manager. You can find it after logging in, in the tab: “My account > API > Organisation settings”

API TOKEN

This is a string of characters generated by InPost in the Parcel Manager. You can find it after logging in, in the tab: “My account > API > ShipX API”. If you have not generated an API TOKEN yet, you can consult the instructions that describe the whole process in detail: https://inpost.pl/sites/default/files/2022-03/instrukcja-konfiguracji-api-shipx.pdf

Default parcel size

Determines the default size of the parcel you will create.

Default shipping method

Determines how the parcel will be sent.

Drop-off at any point - you send the parcel yourself at any Parcel Locker or PaczkoPunkt.
Courier pick-up - Additional paid option. The courier comes and picks up the parcels from you. You must create the parcel pick-up order directly in the InPost Parcel Manager.

Default label type

Determines the type of label that will be generated for the parcel.

Default label size

Determines the default label size that will be generated for the parcel.

Geowidget token

Your own token for the InPost Parcel Locker map (Geowidget v5) that the customer sees in the shop when choosing a pick-up point. How to generate it is described in the Parcel Locker map (Geowidget) section.

Parcel Locker map (Geowidget)

When placing an order, the customer chooses a Parcel Locker or PaczkoPunkt on the InPost map displayed in your shop. Once you enter your own Geowidget token, the shop loads the new InPost map (Geowidget v5). Without a token the shop still works and uses the old map, so you can complete this part of the configuration at any time.

Note

The Geowidget token is independent of the InPost integration and Test mode options and of the Organisation ID and API TOKEN data - you can save it even if you do not generate labels in Foto.Guru. The new map loads only for BASIC or PRO licences.

Generating the token in the Parcel Manager

Log in to the InPost Parcel Manager (https://manager.paczkomaty.pl/) and go to the “My account > API” tab (“Moje konto > API”). At the bottom of the page you will find the “Geowidget” section - click the “Generate” (“Generuj”) button there.

Geowidget section in the InPost Parcel Manager panel

In the window that appears, in the “Allowed domains” (“Dozwolone domeny”) field, enter the domains your shop runs on (without https://). The list of domains you need to enter is shown in the Foto.Guru panel below the Geowidget token field - usually it is app.foto.guru and, if you use your own domain, that domain as well. Then click “Generate” (“Generuj”).

Warning

The map will only open on the domains entered in the token. If you omit the shop domain, the customer will not be able to choose a Parcel Locker.

Geowidget token generation window with the Allowed domains field

The generated token will appear on the list of Geowidget tokens. Click “Copy” (“Kopiuj”), then paste it into the Geowidget token field in the Foto.Guru panel and save the changes.

Checking the saved token

The token is verified when saved. If it does not come from the InPost Parcel Manager, has expired, or does not contain the shop domain, you will see an error message and the token will not be saved.

After saving, the token status is displayed below the Geowidget token field:

production or test (sandbox) - the environment the token comes from. A token from a test account (https://sandbox-manager.paczkomaty.pl/) loads a test map in the shop, so use a token from a production account for normal sales.
the list of domains assigned to the token,
an expired warning with a date if the token is no longer valid. The shop then falls back to the old map - generate a new token in the Parcel Manager and save it again,
a warning about a missing shop domain, e.g. when you connected your own domain after saving the token. Generate a new token with all domains in that case.

Generating labels for an order

If the InPost Parcel Locker integration is enabled, a new button will be added to orders placed with delivery via a Parcel Locker, which allows you to pay for and generate a label.

The orange colour of the button means that the label has not yet been paid for and generated, while the green colour means that it has been paid for. If you wish, you can download an already paid label at any time, e.g. choosing a different type and format.

Paying for and generating a label

After clicking the orange button (with a box), a window will load with the default options for the parcel and label settings selected.

If we have set the default options sensibly, it is usually enough to simply click “Pay and generate label” for the process to start. If there are no errors, the label should be downloaded or displayed automatically.

In case of errors, they will be displayed in the window.

Downloading a label again

If for some reason you want to change the label format or download it again, after clicking on an already paid label (green button with a box), you can download it again, choosing the desired format or keeping the default settings.