This guide shows how to configure BoxNow in Shipi. You connect your BoxNow partner account, and your customers can pick a BoxNow parcel locker at checkout. Shipi then creates the BoxNow delivery request and label for the chosen locker.
| Item | Details |
|---|---|
| What you need | BoxNow Client ID, Client Secret and Partner ID |
| Where to get them | From BoxNow: ict@boxnow.gr or sales@boxnow.gr |
| Countries | Greece, Cyprus, Bulgaria, Croatia |
| Checkout | BoxNow locker map, the nearest locker, or just the service name |
| Price at checkout | The fixed price you set per country |
| Labels | PDF or ZPL |
| Options | Cash on delivery, returns via lockers, compartment size, locker link for the customer |
| Setup steps in Shipi | Carrier Account → Packing → Shipping Regions & Pricing → Shipping Label |
Phone format: the Orders Contact Mobile Phone must be a mobile number with its country code, starting with +30, +357, +359 or +385. Shipi won’t let you continue until it matches.
In this guide: What you need · Add BoxNow · Account information · Checkout widget · Ship-from address · Packing · Regions and pricing · Label settings · First label · Troubleshooting · FAQ
What you need to configure BoxNow
- A BoxNow partner account. BoxNow sends you the API credentials (Client ID, Client Secret, Partner ID) directly; request them from ict@boxnow.gr or sales@boxnow.gr.
- Your BoxNow warehouse ID(s), only if you ship from more than one warehouse.
- Weights on your products (BoxNow uses kilograms).
Step 1: Add BoxNow in Shipi
- Sign in to Shipi and click Carriers in the left menu. The Shipping Accounts page opens.
- Click Add Shipping Account. If you haven’t added any account yet, the page shows the carrier list straight away.
- In the Add New Shipping Account window, search for BoxNow and click it.
- The setup form opens. Its steps are listed in the Setup Steps panel on the left: Carrier Account → Packing → Shipping Regions & Pricing → Shipping Label. Click Next at the bottom of each step, and Save Settings on the last one.
The left panel also has a Book a call button. The Shipi team can set up BoxNow with you for free.
Step 2: BoxNow account information
| Field | What to enter |
|---|---|
| Shipping Account Name * | Any name, for example BoxNow Shipping |
| API Environment * | Staging for test orders, Production for real deliveries |
| API Region * | The country of your BoxNow account: Greece (GR), Cyprus (CY), Bulgaria (BG) or Croatia (HR) |
| Client ID * | From BoxNow |
| Client Secret * | From BoxNow |
| Partner ID * | Your partner ID from BoxNow |
| Warehouse IDs | Best left empty: Shipi fetches your main BoxNow warehouse. If you ship from several, enter their IDs separated by commas (for example 123,456). |
| Allow Returns | Yes lets customers return parcels through BoxNow lockers |
| Orders Contact Email * | The sender contact email BoxNow gets with each delivery request |
| Orders Contact Mobile Phone * | The sender mobile number, with country code (+30, +357, +359 or +385) |
| Weight unit | KG_CM (the only option) |
| Services | BoxNow Delivery (always on) |
Checkout widget settings
These fields on the first step control what your customers see at checkout.
| Setting | What it does |
|---|---|
| Show Map or Nearest Locker as Shipping Option | Show BoxNow Locker Map (default): customers pick a locker on BoxNow’s map. Show Nearest Locker: Shipi offers the locker closest to the customer’s address. None: only the service name is shown. |
| Widget GPS Permission | Allow GPS lets the map ask for the customer’s location to find nearby lockers; Disallow GPS turns that off |
| Widget Button Background Color | Colour of the locker selection button |
| Widget Button Text | Text on the button (default Select a Locker) |
| No Locker Selected Message | Warning shown if the customer tries to check out without picking a locker |
Using Wix? See how to enable BoxNow locker selection in Wix.
Step 3: Ship-from address
The Shipping From Address section is under the account fields on the first step. BoxNow uses it as the sender on every label, so enter the address your parcels leave from.
If you already have saved addresses
- Shipper addresses saved in your Address Book appear as cards. Click a card to use it for this account; it gets a green Default badge.
- Click Edit on a card to change it, or + Add New Address to add another.
If you don’t have a saved address yet
| Field | What to enter |
|---|---|
| Shipper Name * | The contact person, printed on the label |
| Company Name * | Your business name |
| Mobile / Contact Number * | A phone number the carrier can call about the shipment |
| Email Address * | Your shipping contact email |
| Address Line 1 * | Street and number |
| Address Line 2 | Unit, floor or building (optional) |
| Country * | The country you ship from |
| State * | Choose from the list for that country |
| City * | Your city |
| Postal/Zip Code * | Your postal code |
| Tax ID / GSTIN | Your VAT, EORI or other tax number, if customs documents need it (optional) |
| House Number | Only if your address has the house number separate from the street (optional) |
The + Add New Address window has the same fields, plus + Add Custom Field to store any extra reference with the address.
Step 4: Packing
The Package Settings step tells Shipi how to turn an order’s items into parcels for BoxNow. Shipi works from your product weights and dimensions, so make sure your products have them.
| Option | How it packs | Use it when |
|---|---|---|
| Pack Items Individually | Every item goes in its own parcel. | Each product ships in its own box. |
| All in one box | All items go in one parcel, whatever their size. | Your orders always fit in one box. |
| Weight Based Packing (Heavy Items First) (default) | Fills a parcel, heaviest items first, up to Max Weight (kg) (25 by default), then starts a new parcel. | You don’t use fixed box sizes. |
| Box or tube or envelope or packet packing | Fits the items into the boxes you define, using their dimensions. | You ship in a few standard box sizes. |
Adding your boxes
With the box option selected, click + Add Box and fill in:
| Field | What to enter |
|---|---|
| Name * | Any name, for example Small Box or Large Mailer |
| Type * | Box (rigid box), Tube (rolled items such as posters), Envelope (documents and thin, flat items) or Packet (soft mailer bag for items that don’t need a box, such as clothes) |
| Weight of Box (kg) * | What the empty packaging weighs |
| Max Weight (kg) * | The most the box can hold, items and packaging together |
| Width (cm) * | Left to right |
| Height (cm) * | Bottom to top |
| Depth (cm) * | Front to back |
Each box appears as a card with Edit and Remove buttons.
Packing settings greyed out? Your store uses one central packing configuration for all its shipping accounts. Click Edit Configuration, then Yes, Edit Settings. Your changes then apply to every shipping account in the store.
More detail and examples: how shipping package configuration works in Shipi.
Step 5: Shipping regions and pricing
One card per country. Only countries you switch on offer BoxNow at checkout.
| Field | What to enter |
|---|---|
| Switch (top right of the card) | Turns BoxNow on for customers in that country |
| Service Name | Name shown at checkout (default BOX NOW) |
| Price (€) | What your customer pays for BoxNow delivery. 0 means free. |
| Max Weight (kg) | Heaviest order that can go by BoxNow (default 20). Heavier orders don’t see the BoxNow option. |
Step 6: Shipping label settings
| Setting | What it does |
|---|---|
| Shipping Label Generation Time | Create Label Manually: you create each label from Shipments. Create Label immediately once order placed: Shipi creates the label as soon as an order with one of this account’s shipping options reaches Shipi. |
| Send Shipping Label to Email Address | Where Shipi emails the label (and invoice, if there is one) each time a label is created. Separate several addresses with commas. If an automatic label fails, Shipi emails the error instead. Leave empty if you don’t want emails. Required when labels are created automatically. |
| Shipper Notes | A note for BoxNow sent with the delivery request |
| Shipping Label Format * | PDF or ZPL (thermal printers) |
| Default Compartment Size | Small, Medium or Large: the locker compartment your parcels usually need |
Before you switch on automatic labels: create one test label and check the service and price are right. Automatic and bulk shipments use your default service when the order has no service chosen at checkout.
After you save
Click Save Settings. The account appears on the Shipping Accounts page with its name, shipper, address and the BoxNow logo.
| Control | What it does |
|---|---|
| Status switch | On: the account is used for live rates. Off: Shipi leaves it out of rates. |
| Edit | Opens the setup form to change any setting |
| Delete (bin icon) | Removes the account |
| Custom Shipping Rule | Set a free-shipping threshold, choose one default domestic and one default international carrier account (with a service), and send chosen countries to a specific account |
Create your first BoxNow label
- Click Shipments in the left menu.
- Click Create Label next to an order, or Create Shipment to ship something that isn’t an order.
- Check the shipper and receiver details and the products, then choose your BoxNow account and a service.
- Set the shipment options below if you need them, then click Create Shipment.
- Shipi shows the tracking number and the label to print. If you entered an email address in the settings, the label is emailed too.
BoxNow options on the label screen:
| Option | What it does |
|---|---|
| Shipper Notes | A note for this delivery |
| Compartment Size | Small, Medium or Large for this parcel |
| Number of Vouchers | How many parcels (labels) the order needs |
| Shipping Label Format | PDF or ZPL |
| Warehouse ID | Where BoxNow collects the parcel |
| Locker | The locker the customer chose. Use Find Nearest Locker, change it, or Enter Manually a Locker ID. |
| Amount to be Collected (COD Amount) | Cash on delivery amount; leave 0 for prepaid orders |
| Send Select Locker Link | Emails the customer a link to choose their locker (for orders without a locker) |
Troubleshooting
| Message or problem | What to do |
|---|---|
| Authentication Failed. Check Client ID/Secret. | Check the Client ID and Secret, and that API Environment and API Region match the credentials BoxNow gave you. |
| Failed to fetch return location (Warehouse). | Shipi couldn’t get your BoxNow warehouse. Enter your Warehouse ID in the account, or ask BoxNow to check your partner setup. |
| No packages generated. Check product dimensions/weights. | Add weights and dimensions to the products in the order. |
| Invalid phone format… | Enter the mobile number with its country code, for example +30 69… |
| BoxNow isn’t offered at checkout | Switch on the customer’s country in Shipping Regions & Pricing, check the order is under Max Weight, and switch on the account’s status. |
Frequently asked questions
BoxNow sends them directly. Email ict@boxnow.gr or sales@boxnow.gr to request your Client ID, Client Secret and Partner ID.
Greece, Cyprus, Bulgaria and Croatia. Switch on each country you deliver to in the Shipping Regions & Pricing step.
The fixed price you set for their country in Shipping Regions & Pricing. Enter 0 to offer free locker delivery.
Yes. With Show BoxNow Locker Map the customer picks a locker on BoxNow’s map. With Show Nearest Locker, Shipi offers the locker closest to their address.
On the label screen, click Find Nearest Locker, enter a Locker ID manually, or use Send Select Locker Link to email the customer a link to choose one.
Yes. Set Allow Returns to Yes in the account settings to let customers return packages via BoxNow lockers.
Related guides
- How to enable BoxNow locker selection in Wix
- How to configure shipping accounts in Shipi
- How shipping package configuration works in Shipi
Last updated: September 24, 2026