Connecting Zonos

If the fulfilment company ships your parcels to the United States with PostNL, PostNL asks for data from Zonos: your Zonos Organization ID and, per product, the Zonos Item ID from your Zonos catalog. With the connection, Stockhub automatically puts that data on your PostNL shipments to the United States and Puerto Rico. You create the connection yourself in the customer portal.

When you can choose Zonos

• Zonos is only in the list if the fulfilment company has an active connection with PostNL.
• You can have one Zonos connection. If you already have an active Zonos connection, Zonos no longer appears in the list.

Setting up Zonos first

You set up your Zonos account and your products in Zonos itself. Zonos explains this in its own guides:

• Create a free Zonos Verified Account: Account setup
• Add products to your Zonos catalog through a connected webshop: Channel integrations
• Or with a CSV file: Catalog CSV import
• Add the required product data: Product data

Stockhub matches products to Zonos by SKU. So use the same SKU in Zonos as in Stockhub. If you let Stockhub add missing products to Zonos, you do not need to fill the catalog beforehand (see Product sync below).

Looking up the data in Zonos

You need two pieces of data from the Zonos Dashboard:

• API key: you find your keys under Settings > Integrations. Use the API key, not the Account key. The API key starts with credential_live_.
• Organization ID: it is on the Dashboard home page in step 3 of the setup steps, with a button to copy it. You also find it under Settings > Integration at Organization ID.

More information from Zonos: https://zonos.com/docs/postal/shipping-via-posts/zonos-and-postnl/verified-accounts/add-zonos-information

Creating the connection in Stockhub

1. In the menu, go to Integrations > External connections.

2. Click Add External Connection. The Add External Connection window opens.

3. Choose Zonos.

4. Under Authorisation, fill in a name in the Channel field, for example Zonos. Paste the API key from Zonos into API Key.

   

5. Click Test connection. You first see Connecting and then Connected. If you see Connection failed, check the key.

6. Click Next.

7. Under Configuration, fill in your Organization ID at Zonos Organization ID. This field is required.

8. At Product sync, choose how Stockhub works with your Zonos catalog:

   • Only read Item IDs from Zonos: you manage your products in Zonos yourself, for example through a connected webshop. Stockhub only fetches the Item IDs. This is the default.
   • Read Item IDs and add missing products to Zonos: Stockhub also creates the products that are missing in your Zonos catalog.

9. Click Save.

What the connection does

• Data on the shipment: with every PostNL shipment to the United States or Puerto Rico, Stockhub sends your Organization ID along in the customs data. If a product has a Zonos Item ID, it is sent along per product. If a product has no Zonos Item ID, only your Organization ID is sent for that product. So before your first shipment to the United States, check that your products have a Zonos Item ID.
• Fetching Item IDs: about once an hour, Stockhub looks up the Item ID in your Zonos catalog for your active products that have no Zonos Item ID. Stockhub searches by SKU. Upper and lower case do not matter. Products without a SKU are skipped.
• Adding products: if you choose Read Item IDs and add missing products to Zonos, Stockhub creates missing products in Zonos with the SKU, the description as name and customs description, the country of origin, the first six digits of the HS code, the weight and the sale price in euros. Fields without a usable value are left out. So fill in that data in Stockhub as completely as possible.

Zonos Item ID per product

The detail screen of a product has the field Zonos Item ID. You see the field if the fulfilment company ships with PostNL. You can also fill in the Item ID yourself. You find it in Zonos under Catalog: click the product and copy the Catalog Item ID on the Product details tab.

If you have a Zonos connection, the Sync now button is next to the field. With it you look up the Item ID of this product straight away, also if the product already has an Item ID. You then see Zonos Item ID updated. or This product was not found in Zonos. If you see the last message, check that the SKU in Zonos is exactly the same as the SKU in Stockhub.

If you delete a product in your Zonos catalog and add it again, it gets a new Item ID. Then click Sync now to fetch the new ID.

Changing the settings later

In the External connections overview, click the connection. On the Details tab you change the API Key, the Zonos Organization ID and the Product sync. Then click Save.

See also Externe koppelingen for the overview, the detail screen and deleting a connection.