Shopify APP API / WebServices

Connect Shopify with Qapla’

The connection is made through Shopify’s official Web Services.
To allow Qapla’ to communicate with your Shopify, follow the steps below.

1. Install our App

Install our APP directly from the following link: Qapla’ Connector
Click “Add app.”

2. Follow the instructions in Shopify

Copy the Shop Name and the Qapla’ Token that you’ll find once the app is installed.

3. Enter the data in Qapla’

On the Shopify side, the configuration is complete.
Go to Settings > Channels > [Channel Name] > Configure > E-Commerce, select the platform, and enter the key previously generated on Shopify.

After entering it, click “Save and run test.”

4. Enabling Order Import

To enable order import, go to: Settings > Channels > [Channel Name] > Configure > Imports > Orders
Select the desired import mode:

• Automatic: Qapla’ will query your platform every hour (at :00, e.g., 9:00, 10:00, 11:00, etc.) to import new orders and update existing ones.
• Manual: You can start the import at any time from the Labels section by selecting Shopify and clicking Manual Import.

Excluded Order Statuses
You can exclude specific order statuses from import (in addition to those excluded by default), customizing the workflow based on your operational needs.

Custom Payment Statuses for Cash on Delivery (COD) Orders
Some CMS platforms allow customizing payment statuses beyond the system defaults.
If you have configured custom payment statuses to identify COD orders, it is essential to inform Qapla’ Customer Care to ensure correct order import management.
If you only use standard statuses, no action is required.
Email support@qapla.it listing the exact wording of the custom payment statuses used for COD. Once Qapla’ Customer Care confirms the setup, orders with those payment statuses will automatically be recognized as COD orders.

Advanced Settings
Within Imports > Orders, you can enable the following options:

• Import product images
• Import weight

Pre-assigned Couriers
You can automatically import the pre-assigned courier from Shopify.
To configure this correctly:

1. Check orders in Shopify to analyze the field shipping_lines > carrier_identifier > “code” (you can use WS Test).

2. Each value in the Code field corresponds to the courier code that must be associated with the couriers available on your channel/account.

3. Enter the courier code in the Transcoding Code field in the courier configuration section. If you want to associate multiple courier codes, enter them separated by commas with no spaces. Example: “BARTOLINI,BRT,BRT-IT”

4. Write to support@qapla.it to complete the configuration, sending the channel name, all codes, and the courier to associate them with.

On the next import, orders will be associated with the correct courier.
We recommend verifying the actual import and correct courier assignment on one or more orders after saving the configuration to ensure the value mapping is correct.

Set Default Weight
Set a default weight to apply to imported orders.

Set Default Number of Parcels
Define a default number of parcels for each imported order.

5. Updating Orders on Shopify

To enable automatic updates on Shopify, go to: Settings > Channels > [Channel Name] > Configure > Updates > E-commerce
Enable the available update options:

• Shipped

  • Update the order to “shipped” when the shipment is trackable.
  • Update the order to “shipped” when the goods are actually in the courier’s hands (Qapla’ statuses: Departed, In transit, Out for delivery).
    Both updates also include entering the tracking number.
• Location (site): select the Location, a value present on your platform. The dropdown shows all locations automatically read via the platform connection.
  If your Shopify store uses multiple Locations, we recommend creating a separate Qapla’ channel for each and selecting the specific Location.
  Only one Location can be associated per channel.
• Update with shipment statuses: allows updating the order on Shopify with the shipment’s progress status.
  The update occurs via webhook.

Example:

Mapping Shipment Statuses on Shopify: allows remapping certain shipment statuses so that they are updated on Shopify with a status different from the default.

• • 10 – Pickup Point: select the status from the dropdown.
  • 95 – Returned: select the status from the dropdown.

WARNING: “Picked Up” and “Ready to Pick up,” according to Shopify, appear to relate to in-store pickup and therefore cannot be used for pickup points (such as pickup by the recipient).

6. Enabling Shipment Import

To enable shipment import, go to: Settings > Channels > [Channel Name] > Configure > Imports > Shipments > Connectors > Shopify Connector > Set Connector.
Within this section, set the time when Qapla’ will import shipments from Shopify.

• You can configure up to two times per channel.
• If you want to set more than two times, contact our Customer Care at support@qapla.it.

Imports will run automatically at the scheduled times.

Not working?

Qapla’ uses Shopify’s official APIs (Web Services).
If it doesn’t work, we recommend asking the administrator who manages your Shopify site to verify the setup.

Troubleshooting

In general, connections to servers respond with HTTP error codes.

Pickup Points Management

The Qapla’ PUDO solution is available: pickup points for flexible shipments and deliveries.
Offer your customers the choice of courier pickup points and import all information directly into Qapla’ for shipment management.
See all details in our dedicated guide: Shopify PUDO Plugin.