Connect your sales channel to your Verified Account so Zonos can pull your catalog items and keep them compliance-ready for U.S.-bound shipments.
Channel integrations connect your ecommerce platform to your Zonos Verified Account. Once connected, Zonos automatically pulls your catalog items and keeps them in sync—no manual data entry required. Every item in your catalog is then screened for U.S. Partner Government Agency (PGA) requirements, so your shipments don't get held at the border.
This is the option for shippers who sell through one of the supported platforms below. It's the least work of the three ways to build your catalog—there's nothing to export, upload, or code, and your catalog stays current on its own as you add or change products. Connecting a channel takes a few minutes in Dashboard and doesn't require a developer.
If you don't sell through a supported channel, you can import your catalog items with a CSV file or write them directly with the Catalog API instead. Items added either way get the same treatment as synced items.
Connect your sales channel to your Verified Account in Dashboard.
Zonos pulls your catalog items from the channel and keeps them up to date as you add or change products.
Every item is automatically screened for PGA requirements—such as CPSC and FDA regulations—that apply to U.S. imports. Items that need more information show an Open requirements badge in your catalog and on the Requirements tab, and Zonos pre-fills most of the required answers for you to review and confirm. Learn more about PGA checks.
You ship as usual. Because your items are screened before they ship, U.S.-bound shipments are less likely to be delayed or held at the border.
Note: Syncing runs on a schedule rather than instantly. Orders are checked hourly and catalog every two hours. The Channels page shows when orders and catalog each last synced for a connection, so you can always see which of the two you're waiting on. Some situations make a sync take longer—see When syncing takes longer.
Note: PGA checks apply to all U.S. inbound shipments. Shipments to other destinations are not affected.
You can connect the following channels to your Verified Account:
Amazon
Zonos Sync is an app from Zonos that connects an Amazon seller account to your Zonos Verified Account. Amazon hosts your store, so there's no store address to enter—Zonos sends you straight to Seller Central to approve the connection.
What it does
Syncs your catalog. Your Amazon listings flow into Zonos with SKU, title, description, price, image, brand, weight, material composition, and country of origin where you've set it, plus GTIN and manufacturer part number for EU product identifiers. As you add or change listings, Zonos picks up the changes automatically.
Syncs your orders. Orders arrive with line items, totals, tax, and shipping, plus tracking numbers for orders you fulfill yourself.
Classifies your products for customs. Amazon doesn't carry HS codes, so Zonos assigns them. Country of origin is optional on Amazon and often unset—Zonos can't infer it, so supply it for the products where it matters.
Screens for U.S. import requirements. Every synced item is checked against U.S. Partner Government Agency (PGA) rules, such as FDA and CPSC requirements, and flagged before it ships rather than after a parcel is held.
What it doesn't do
It never writes to your Amazon account—no listing edits, price changes, inventory updates, or order modifications.
It never requests buyer personal information—no buyer names, email addresses, phone numbers, or street addresses.
It doesn't create shipping labels or move freight.
Requirements
An active Zonos account.
An Amazon seller account that sells on the U.S. marketplace (amazon.com). Accounts that don't sell there can't connect.
Authorization from the Seller Central account owner.
How to connect
In Dashboard, go to the Channels page.
Click Add channel and select Amazon.
Click Connect to go to Amazon's authorization screen. Sign in to Seller Central as the account owner and approve Zonos's request to access your orders and listings.
You're returned to the Channels page, where the connection shows Sync pending until the first sync completes.
Zonos never asks for your Amazon password, and you can revoke access at any time from Seller Central.
Pricing
Zonos Sync is free to install and use. There's no charge for the app and no per-order or per-listing fee.
Note: The first sync can take several minutes on a large catalog; after that, only changed listings are re-read. Amazon rarely publishes HS codes or country of origin. Zonos assigns the HS codes; country of origin stays empty unless you supply it. Tracking syncs only for orders you fulfill yourself.
BigCommerce
BigCommerce connects through the Zonos Sync app on the BigCommerce App Marketplace. You install the app there, then finish connecting in Dashboard.
In Dashboard, go to the Channels page.
Click Add channel and select BigCommerce.
Click Connect to go to the Zonos Sync listing on the BigCommerce App Marketplace. Click Install and approve Zonos's request to access your orders and products.
In the Zonos Sync app in your BigCommerce control panel, click Continue to Zonos Sync. Dashboard opens in a new tab.
You're returned to the Channels page, where the connection shows Sync pending until the first sync completes.
Note: HS code, country of origin, and customs description sync from a product's Customs information in BigCommerce when you've filled it in. Products without it arrive with no HS code, which Zonos assigns, and no country of origin, which stays empty unless you supply it. Brand syncs from the product itself—values set only on a variant aren't read. For GTIN and MPN, see Add EU PIDs. Weight doesn't sync from BigCommerce. Tracking numbers sync from shipments you create on an order in BigCommerce.
eBay
Connect your eBay seller account to sync your products—including SKU, name, price, and image—to your Zonos catalog.
In Dashboard, go to the Channels page.
Click Add channel and select eBay.
Click Connect to go to eBay's login and authorization screen. Sign in and approve Zonos's request to access your orders and catalog.
You're returned to the Channels page. The connection shows Sync pending until the first sync completes. Once it does, that label is replaced by the times orders and catalog each last synced, plus buttons to view your synced catalog and orders.
Note: Description, weight, brand, HS code, and country of origin don't sync from eBay listings, so those arrive empty. Zonos assigns the HS codes; supply country of origin for the products where it matters. GTIN syncs for listings with variations—see Add EU PIDs. Tracking numbers sync from the shipments you add to an order in eBay, including ones you add after the order first synced.
Etsy
Connect your Etsy shop to sync your products—including SKU, name, description, and price—to your Zonos catalog.
In Dashboard, go to the Channels page.
Click Add channel and select Etsy.
Click Connect to go to Etsy's login and authorization screen. Sign in and approve Zonos's request to access your orders and catalog.
You're returned to the Channels page. The connection shows Sync pending until the first sync completes. Once it does, that label is replaced by the times orders and catalog each last synced, plus buttons to view your synced catalog and orders.
Note: Weight, HS code, country of origin, brand, images, and EU product identifiers don't sync from Etsy. Zonos assigns the HS codes; supply country of origin for the products where it matters. Tracking numbers sync from the shipments you add to an order in Etsy, including ones you add after the order first synced.
Faire
Faire is a wholesale marketplace, so the orders that sync are placed by retailers.
In Dashboard, go to the Channels page.
Click Add channel and select Faire.
Sign in to Faire through the connection window that opens and approve the connection.
You're returned to the Channels page, where the connection shows Sync pending until the first sync completes.
Note: Orders and catalog items sync, with one catalog item per product variant. The catalog includes HS code (Faire's tariff code), country of origin, case-pack unit multiplier, product attributes, and variant options.
Adobe Commerce (Magento)
Because Adobe Commerce runs on your own site, Zonos needs your store's web address, plus a set of API keys you create in your Adobe Commerce Admin—there's no login screen to redirect you to.
In Dashboard, go to the Channels page.
Click Add channel and select Magento.
Enter your store's web address—the same one you use to visit your store—and click Continue. Your store must be reachable over https.
In your Magento Admin, go to System > Extensions > Integrations and click Add New Integration.
Name the integration (for example, "Zonos Sync"), enter your admin password to confirm, then open the API tab.
Under Resource Access, choose Custom and grant these three permissions. Every other resource can stay unchecked.
Sales > Operations > Orders > Actions > View
Sales > Operations > Shipments
Catalog > Inventory > Products
Optionally, also grant Stores > Settings > All Stores so Zonos can read your store's configured weight unit—without it, Zonos defaults to pounds.
Optionally, also grant Stores > Attributes > Product so Zonos can read product attributes you've set up as dropdowns, such as brand. Without it, text attributes still sync, but dropdown values are skipped.
Click Save, then click Activate next to the integration you just created.
Review the permissions and click Allow.
Magento displays four values—Consumer Key, Consumer Secret, Access Token, and Access Token Secret—only once. Copy all four before leaving the page; deactivating and reactivating the integration generates a new set.
Back in Zonos, paste each of the four values into the matching field, then click Continue. Store code is optional—leave it blank unless your Magento install has more than one store view.
You're returned to the Channels page, where the connection shows Sync pending until the first sync completes.
Note: These credentials don't expire, so this is a one-time setup with no periodic reconnection needed. Magento has no core HS code field, so Zonos fills it in for you unless you map an HS code attribute. Country of origin syncs from the core Country of Manufacture attribute when it's set. Brand syncs from a product attribute with the code brand. For GTIN and manufacturer product ID, see Add EU PIDs. A configurable product's variants don't fall back to the parent's values. Tracking numbers sync from shipments recorded in Magento.
Note: To add a permission to an integration you've already connected, edit it in Magento, save, and click Reauthorize. Magento issues four new credential values—paste them into your Magento connection in Zonos so syncing continues.
Mapping your own attributes
If you keep brand, material composition, customs description, GTIN, manufacturer product ID, country of origin, or HS code in product attributes, choose Product attribute mapping from your Magento channel's menu and enter each attribute's code—see Map product fields. Attributes set up as dropdowns need the optional Stores > Attributes > Product permission from step 6.
Shopify
Connect your Shopify store to sync your products—including SKU, name, description, price, weight, image, and brand, plus HS code and country of origin when set in your shop—to your Zonos catalog. Active, draft, and unlisted products sync; archived products don't.
In Dashboard, go to the Channels page.
Click Add channel and select Shopify.
Click Connect to go to the Zonos Channel app listing on the Shopify App Store. Click Add app and approve Zonos's request to access your orders and catalog. Shopify installs the app into the store you're currently signed in to.
You're returned to the Channels page. The connection shows Sync pending until the first sync completes. Once it does, that label is replaced by the times orders and catalog each last synced, plus buttons to view your synced catalog and orders.
Connecting more than one Shopify store
Zonos keeps each store as its own connection, and the Channels page lists them separately with their store addresses. Adding a second store works slightly differently, because Shopify would otherwise install into whichever store you happen to be signed in to:
Click Add channel and select Shopify again—the tile stays available and shows the stores you've already connected.
Click Add another store.
Enter the Shopify domain of the store you want to add and click Continue. This is the .myshopify.com address, not a custom domain you may have set up. You can read it from that store's Shopify admin URL—admin.shopify.com/store/your-store means the domain is your-store.myshopify.com—or find it in Shopify under Settings → Domains.
You're taken to that store's authorization screen. Approve the same request, and the new connection appears alongside the first.
Note: If you sell on several Shopify stores, sign in to the one you want before connecting your first store—Shopify decides that one from your current session rather than asking.
Note: Orders keep up with Shopify after they first sync. When you fulfill, cancel, or take payment on an order in Shopify, its status updates in Zonos at the next order sync, and tracking numbers you add later sync too.
Product identifiers
GTIN and manufacturer product ID sync from each variant's barcodes. See Add EU PIDs for how to set them up.
Mapping metafields
If you keep brand, material composition, or customs description in metafields, choose Metafield mapping from your Shopify channel's menu and enter each metafield's namespace and key—see Map product fields. A mapped brand metafield takes priority over the product vendor; without one, the vendor syncs as the brand.
Square
In Dashboard, go to the Channels page.
Click Add channel and select Square.
Sign in to Square through the connection window that opens and approve the connection.
You're returned to the Channels page, where the connection shows Sync pending until the first sync completes.
Squarespace
Squarespace hosts your store, so there's no store address to enter. You approve the connection in a window that opens over Dashboard.
In Dashboard, go to the Channels page.
Click Add channel and select Squarespace.
Sign in to Squarespace through the connection window that opens and approve the connection.
You're returned to the Channels page, where the connection shows Sync pending until the first sync completes.
Wix
Wix hosts your store, so there's no store address to enter—Zonos sends you straight to Wix to approve the connection.
In Dashboard, go to the Channels page.
Click Add channel and select Wix.
Click Connect to go to Wix's installation screen. Choose the site you want to connect, then approve the Zonos Sync app's read-only request for your orders and products.
You're returned to the Channels page, where the connection shows Sync pending until the first sync completes.
Note: Your site needs Wix Stores added for there to be a catalog to sync. Brand syncs when you've set one on the product. Zonos syncs one catalog item per Wix product. For GTIN and manufacturer product ID, see Add EU PIDs. Wix publishes neither HS codes nor country of origin. Zonos assigns the HS codes; country of origin arrives empty and stays empty unless you supply it. Tracking numbers sync once you fulfill an order in Wix and add tracking details—a fulfillment saved without a tracking number has nothing to sync.
WooCommerce
Because WooCommerce runs on your own site, Zonos needs your store's web address before it can send you anywhere to approve the connection.
In Dashboard, go to the Channels page.
Click Add channel and select WooCommerce.
Enter your store's web address—the same one you use to visit your store—and click Continue. Your store must be reachable over https.
You're taken to your own store's authorization screen. Sign in as an administrator and approve Zonos's read-only request for your orders and products.
You're returned to the Channels page, where the connection shows Sync pending until the first sync completes.
Note: Tracking numbers sync if your store records them in either WooCommerce's Order Fulfillments feature—off by default, and your developer needs to switch it on—or a compatible tracking plugin such as WooCommerce Shipment Tracking or Advanced Shipment Tracking. Other tracking plugins may store tracking where Zonos can't read it. Catalog and order syncing work either way.
Note: Brand syncs from WooCommerce's built-in Brands (WooCommerce 9.6 and later). For GTIN and manufacturer product ID, see Add EU PIDs. WooCommerce has no built-in fields for country of origin or HS code. If you keep them in custom fields or product attributes—such as an attribute named country_of_origin—choose Product field mapping from your WooCommerce channel's menu to sync them; see Map product fields. Otherwise Zonos assigns the HS codes, and country of origin stays empty unless you supply it.
If your store keeps product details in fields of its own—metafields in Shopify, product attributes in Magento, or custom fields and product attributes in WooCommerce—map them so Zonos syncs the values into your catalog.
On the Channels page, open the menu on your channel and choose Metafield mapping (Shopify), Product attribute mapping (Magento), or Product field mapping (WooCommerce).
Click Add field, choose the catalog field, and enter the name of the field in your store that holds it. Add a row for each field you want to map.
Click Save.
Saving a changed mapping re-syncs your whole catalog right away, so existing products pick up the values without you editing them in your store. To stop syncing a field, remove its row and save; values already synced stay in your catalog. A field that's empty in your store never overwrites a value you've added in your Zonos catalog.
Fields you can map
Channel↕
Catalog fields↕
What to enter↕
Shopify
Brand, material composition, customs description
The metafield's namespace and key
Magento
Brand, material composition, customs description, GTIN, manufacturer product ID, country of origin, HS code
The attribute code, from Stores > Attributes > Product
WooCommerce
Brand, material composition, customs description, GTIN, manufacturer product ID, country of origin, HS code
A custom field (meta) key or a product attribute name, such as country_of_origin
How values are read
Material composition should look like Cotton:60,Polyester:40. Percentages are optional; materials without one share the rest evenly.
Country of origin can be a 2- or 3-letter code (AU, AUS) or a country name (Australia). Give each product one country—if a product lists several different countries, it stays empty.
GTIN and manufacturer product ID are the EU product identifiers. Map them if your store keeps them somewhere other than its built-in fields.
Magento: without a row for brand, GTIN, or manufacturer product ID, Zonos uses attributes coded brand, gtin, or ns_pid when your store has them. A mapped country of origin takes priority over Country of Manufacture, which still applies when the mapped attribute is empty.
WooCommerce: a mapped GTIN takes priority over the built-in GTIN field. On variable products, attributes set on the parent and not used for variations apply to every variation; GTIN and manufacturer product ID always come from the variation itself.
When you connect a channel, new and updated products automatically map to your Zonos catalog. Which fields arrive depends on what your channel stores—each channel's section above lists its gaps. Synced fields include:
SKU and product ID
Name and description
Price and currency
Weight and weight unit (Amazon, Magento, Shopify, Wix, and WooCommerce)
Universal HS code (Shopify, Faire, BigCommerce customs information, and Magento or WooCommerce with a mapping, when set)
Country of origin (Amazon, BigCommerce customs information, Faire, Magento, Shopify, and WooCommerce with a mapping, when set)
Brand (every channel except eBay, Etsy, Faire, Square, and Squarespace, when set)
Customs description (Shopify, Magento, or WooCommerce with a mapping, and BigCommerce customs information)
Material composition (Amazon, and Shopify, Magento, or WooCommerce with a mapping)
Orders sync with their line items, totals, and tracking numbers.
The more complete your product data is in your channel, the more accurate your duty calculations and PGA screening will be. If a field like HS code or country of origin is missing, Zonos can fill in the gaps—see how Catalog works for details.
Most of the time orders appear within the hour and catalog within two. These are the situations where it takes longer:
The first sync after you connect. Zonos pulls your whole catalog, not just what changed, along with your recent order history—so your existing products and orders are there from the start rather than only what happens from now on. A large catalog can take several minutes, and a long order history is fetched across several syncs rather than all at once.
A channel that has had nothing new for a while. Zonos checks quiet channels less often—as little as every six hours for orders and every 72 hours for catalog. It returns to the normal schedule as soon as a check finds something, so the first order after a quiet stretch can take longer to appear than the next one.
Busy periods. When a lot of connections are waiting to sync, a scheduled run can be skipped and picked up on the following one.
The periodic full catalog re-sync. Routine catalog syncs only look at products you've added or changed since the last one, which is why they're quick. Every 14 days Zonos re-reads your catalog in full to catch anything a routine sync missed, and that sweep takes longer—closer to the first sync than to a routine one.
A connection that keeps failing. After several consecutive failures Zonos stops syncing that connection until you reconnect it. Its last-synced times stop advancing, which is the signal to reconnect.
Connecting a channel is free. The app that links your Amazon, BigCommerce, eBay, Etsy, Faire, Adobe Commerce (Magento), Shopify, Square, Squarespace, Wix, or WooCommerce account to Zonos costs nothing to install or use, and there is no per-order or per-listing fee for syncing your catalog and orders.
Channel integrations
Channel integrations
Connect your sales channel to your Verified Account so Zonos can pull your catalog items and keep them compliance-ready for U.S.-bound shipments.
Channel integrations connect your ecommerce platform to your Zonos Verified Account. Once connected, Zonos automatically pulls your catalog items and keeps them in sync—no manual data entry required. Every item in your catalog is then screened for U.S. Partner Government Agency (PGA) requirements, so your shipments don't get held at the border.
This is the option for shippers who sell through one of the supported platforms below. It's the least work of the three ways to build your catalog—there's nothing to export, upload, or code, and your catalog stays current on its own as you add or change products. Connecting a channel takes a few minutes in Dashboard and doesn't require a developer.
If you don't sell through a supported channel, you can import your catalog items with a CSV file or write them directly with the Catalog API instead. Items added either way get the same treatment as synced items.
How it works
Connect your sales channel to your Verified Account in Dashboard.
Zonos pulls your catalog items from the channel and keeps them up to date as you add or change products.
Every item is automatically screened for PGA requirements—such as CPSC and FDA regulations—that apply to U.S. imports. Items that need more information show an Open requirements badge in your catalog and on the Requirements tab, and Zonos pre-fills most of the required answers for you to review and confirm. Learn more about PGA checks.
You ship as usual. Because your items are screened before they ship, U.S.-bound shipments are less likely to be delayed or held at the border.
Supported channels
You can connect the following channels to your Verified Account:
Amazon
Zonos Sync is an app from Zonos that connects an Amazon seller account to your Zonos Verified Account. Amazon hosts your store, so there's no store address to enter—Zonos sends you straight to Seller Central to approve the connection.
What it does
What it doesn't do
Requirements
How to connect
Zonos never asks for your Amazon password, and you can revoke access at any time from Seller Central.
Pricing
Zonos Sync is free to install and use. There's no charge for the app and no per-order or per-listing fee.
Support
Email support@zonos.com or contact Zonos support.
BigCommerce
BigCommerce connects through the Zonos Sync app on the BigCommerce App Marketplace. You install the app there, then finish connecting in Dashboard.
eBay
Connect your eBay seller account to sync your products—including SKU, name, price, and image—to your Zonos catalog.
Etsy
Connect your Etsy shop to sync your products—including SKU, name, description, and price—to your Zonos catalog.
Faire
Faire is a wholesale marketplace, so the orders that sync are placed by retailers.
Adobe Commerce (Magento)
Because Adobe Commerce runs on your own site, Zonos needs your store's web address, plus a set of API keys you create in your Adobe Commerce Admin—there's no login screen to redirect you to.
https.Sales > Operations > Orders > Actions > View
Sales > Operations > Shipments
Catalog > Inventory > Products
Optionally, also grant Stores > Settings > All Stores so Zonos can read your store's configured weight unit—without it, Zonos defaults to pounds.
Optionally, also grant Stores > Attributes > Product so Zonos can read product attributes you've set up as dropdowns, such as brand. Without it, text attributes still sync, but dropdown values are skipped.
Mapping your own attributes
If you keep brand, material composition, customs description, GTIN, manufacturer product ID, country of origin, or HS code in product attributes, choose Product attribute mapping from your Magento channel's menu and enter each attribute's code—see Map product fields. Attributes set up as dropdowns need the optional Stores > Attributes > Product permission from step 6.
Shopify
Connect your Shopify store to sync your products—including SKU, name, description, price, weight, image, and brand, plus HS code and country of origin when set in your shop—to your Zonos catalog. Active, draft, and unlisted products sync; archived products don't.
Connecting more than one Shopify store
Zonos keeps each store as its own connection, and the Channels page lists them separately with their store addresses. Adding a second store works slightly differently, because Shopify would otherwise install into whichever store you happen to be signed in to:
.myshopify.comaddress, not a custom domain you may have set up. You can read it from that store's Shopify admin URL—admin.shopify.com/store/your-storemeans the domain isyour-store.myshopify.com—or find it in Shopify under Settings → Domains.Product identifiers
GTIN and manufacturer product ID sync from each variant's barcodes. See Add EU PIDs for how to set them up.
Mapping metafields
If you keep brand, material composition, or customs description in metafields, choose Metafield mapping from your Shopify channel's menu and enter each metafield's namespace and key—see Map product fields. A mapped brand metafield takes priority over the product vendor; without one, the vendor syncs as the brand.
Square
Squarespace
Squarespace hosts your store, so there's no store address to enter. You approve the connection in a window that opens over Dashboard.
Wix
Wix hosts your store, so there's no store address to enter—Zonos sends you straight to Wix to approve the connection.
WooCommerce
Because WooCommerce runs on your own site, Zonos needs your store's web address before it can send you anywhere to approve the connection.
https.Map product fields
If your store keeps product details in fields of its own—metafields in Shopify, product attributes in Magento, or custom fields and product attributes in WooCommerce—map them so Zonos syncs the values into your catalog.
Saving a changed mapping re-syncs your whole catalog right away, so existing products pick up the values without you editing them in your store. To stop syncing a field, remove its row and save; values already synced stay in your catalog. A field that's empty in your store never overwrites a value you've added in your Zonos catalog.
Fields you can map
country_of_originHow values are read
Cotton:60,Polyester:40. Percentages are optional; materials without one share the rest evenly.AU,AUS) or a country name (Australia). Give each product one country—if a product lists several different countries, it stays empty.brand,gtin, orns_pidwhen your store has them. A mapped country of origin takes priority over Country of Manufacture, which still applies when the mapped attribute is empty.What syncs from your channel
When you connect a channel, new and updated products automatically map to your Zonos catalog. Which fields arrive depends on what your channel stores—each channel's section above lists its gaps. Synced fields include:
Orders sync with their line items, totals, and tracking numbers.
The more complete your product data is in your channel, the more accurate your duty calculations and PGA screening will be. If a field like HS code or country of origin is missing, Zonos can fill in the gaps—see how Catalog works for details.
When syncing takes longer
Most of the time orders appear within the hour and catalog within two. These are the situations where it takes longer:
Pricing
Connecting a channel is free. The app that links your Amazon, BigCommerce, eBay, Etsy, Faire, Adobe Commerce (Magento), Shopify, Square, Squarespace, Wix, or WooCommerce account to Zonos costs nothing to install or use, and there is no per-order or per-listing fee for syncing your catalog and orders.
Support
Questions about connecting a channel, or help with a sync:
Related
Was this page helpful?