This article explains how data syncs between Shopify and Packiyo — what happens immediately via webhooks, what requires a scheduled sync, and what doesn't sync at all. It’s important to understand the differences, as not all changes are directly synced.
Product Updates (Shopify → Packiyo)
When a product field is updated in Shopify, here's what happens in Packiyo:
| Field | Syncs to Packiyo? | How / When |
|---|---|---|
| Name | ✅ Yes | Updated immediately via webhook |
| SKU | ✅ Yes | Updated immediately via webhook |
| Barcode | ❌ No | Only captured at product creation in Packiyo |
| Weight | ❌ No | Only captured at product creation in Packiyo |
| HS Code | ✅ Yes | Updated immediately via webhook |
| Country of Origin | ✅ Yes | Updated immediately via webhook |
If you notice that one of these does not sync after a change, we can ask Packiyo to run a manual Product Sync. If this still does lead to a sync, we can investigate the issue.
Important: Barcode and Weight are only pulled into Packiyo when the product is first created. They will never update afterwards — not even with a manual product sync. Manual and scheduled syncs ping the same webhook endpoints, so barcodes and weight are excluded from those as well. Any changes for these must be made directly in Packiyo to be updated in Packiyo.
Order Updates (Shopify → Packiyo)
When order details are changed in Shopify, here's what happens in Packiyo:
| Change Type | Syncs to Packiyo? | How / When |
|---|---|---|
| Ship-to Address | ✅ Yes | Updated immediately via webhook |
| Bill-to Address | ❌ N/A | Shopify does not allow billing address changes after order creation |
| SKU Line Items / Quantities | ✅ Yes | Updated immediately via webhook |
| Fulfillment Location Change | ⚠️ Partial | Not received via webhook; detected during scheduled sync, which causes Packiyo to cancel the order for different locations |
| Order Status (fulfilled / pending / canceled) | ✅ Yes | Updated immediately via webhook |
| Customer Info (name, email, phone) | ⚠️ Conditional | See details below |
Customer Info Sync Details
- Changes made on the Shopify Customer Profile page: ❌ No updates are reflected in Packiyo.
- Changes made directly on the Shopify Order page:
- Email: If updated on the order, Packiyo updates both shipping and billing email.
- Phone number: Changes are not reflected in Packiyo.
- Why? Packiyo stores separate phone fields for shipping and billing, while Shopify does not distinguish them clearly at the order level.
- If you notice that one of these does not sync after a change, we can ask Packiyo to run a manual Order Sync. If this still does lead to a sync, we can investigate the issue.
Packiyo → Shopify Sync
Packiyo generally does not push changes back to Shopify. Here's the breakdown for the Packiyo to Shopify connection:
- Product changes with Webhooks: name, SKU, barcode, weight, HS code, country of origin
- ❌ Not synced to Shopify
- If a change is made to a product in Shopify or an Product Sync is run, these values in Packiyo will be overridden by the value that is in Shopify
- Product changes without Webhooks: barcode, weight
- ❌ Not synced to Shopify
- Will not be overridden by Shopify values
- Order changes: addresses, items, warehouse, customer info
- ❌ Not synced to Shopify
- Order Status → Fulfilled:
- ✅ Synced to Shopify
- Order status → Canceled:
- ⚠️ Synced if the Order Cancel webhook is enabled and "Cancel order in Shopify when canceled in Packiyo" is turned on in Packiyo's dashboard integration page
Note: The Packiyo dashboard integration page mentioned above is an internal Packiyo admin interface — it is not currently accessible to the 3PL directly. Packiyo always enables the shipment webhook upon connection by default.
Product Name Override Behavior
If a product name is changed in Packiyo but not in Shopify, the Shopify name will eventually override the Packiyo name when the product syncs.
Shopify Variant Naming: If items are set up as a main product with variant SKUs in Shopify (not as two separate products), Packiyo will sync through the variant title automatically. For example, a product called "Cool T-Shirt" with variants "Red" and "Black" will display in Packiyo as:
- Cool T-Shirt / Red
- Cool T-Shirt / Black
Best Practice: SKUs and Barcodes must be unique for each product (though the SKU and barcode for a product can be the same). Product names technically don't have to be unique, as in the system will allow it, but we highly recommend making them unique to avoid confusion during fulfillment. Products with same name makes the chance of errors in fulfillment extremely high.
Shipping Methods
Shopify shipping methods sync to Packiyo under the following rules:
- Methods do not appear upon initial Shopify ↔ Packiyo connection
- Methods only pull over on the first receipt of an order placed with that method
- They do not trigger other methods to appear — each method syncs individually when first used
- On initial connection, typical the previous month of Shopify orders syncs, which means methods from those historical orders (including canceled ones) will appear
Scheduled Syncing
- Scheduled syncing is configured per integration and is disabled by default
- Packiyo typically only enables scheduled syncing on accounts where syncing issues have been reported
- Most data transmissions are completed via normal webhooks, so scheduled syncing is not usually needed
- Manual product syncs use the same webhook endpoints as scheduled syncs
Open Purchase Orders
If a product's name, SKU, or barcode is changed in Packiyo while there is an open Purchase Order containing that SKU, the change will be reflected on the PO as well. Product changes in Packiyo translate over to Purchase Orders.
Quick Reference
| Scenario | Result |
|---|---|
| Client changes product name in Shopify | ✅ Updates in Packiyo via webhook |
| Client changes barcode in Shopify | ❌ Does not update in Packiyo — barcode only set at creation |
| Client changes weight in Shopify | ❌ Does not update in Packiyo — weight only set at creation |
| Client changes ship-to address in Shopify | ✅ Updates in Packiyo |
| Client changes fulfillment location in Shopify | ⚠️ Only detected during scheduled/manual sync |
| HLC changes product name in Packiyo | ❌ Does not sync to Shopify (and Shopify will override it on next sync) |
| We fulfill an order in Packiyo | ✅ Syncs to Shopify |
| We cancel an order in Packiyo | ✅ Syncs to Shopify |
| Shopify shipping methods aren't in Packiyo | Methods appear only after an order uses that method |