New Data Entry: Shopify & SKUSavvy Field Reference

Every field SKUSavvy and Shopify share and which way it syncs, so you know where to create or edit products, inventory, orders, customers, and more.

How to Read This Guide

This guide lists every field SKUSavvy and Shopify share, and which way each one moves. Use it to decide where to enter or edit a given piece of data so the two systems agree.

Each field is labeled with one of three sync directions.

Shopify → SKUSavvy: Shopify owns the field. SKUSavvy reads it in and does not push changes back. Edit it in Shopify.
SKUSavvy → Shopify: SKUSavvy owns the field. It writes the value up to Shopify. Edit it in SKUSavvy.
Dual: the field is editable in either system. The most recent change wins and overwrites the other side, so pick one system per field and stick to it.

Dual does not mean the systems merge changes. A later edit in one system replaces the value in the other, so avoid editing the same Dual field in both places.

Quick Reference: Where to Create Each Thing

Start here for the high-level rule, then use the per-field tables below for the detail.

Data	Create it in	After connection, edit in
Products & variants	Shopify	Either (see field tables)
Inventory quantities	Shopify (initial import)	SKUSavvy only
Orders	Shopify (or SKUSavvy)	Either
Customers	Shopify (or SKUSavvy)	Either
Vendors & costs	Shopify product, then SKUSavvy	SKUSavvy
Purchase orders & transfers	SKUSavvy	SKUSavvy only
Bins, lots, serials, dimensions	SKUSavvy	SKUSavvy only

Treat SKUSavvy as the source of truth for inventory quantities. Quantities import once when you connect; after that, never adjust stock in Shopify.

Products

Product-level fields shared between a Shopify product and its SKUSavvy record.

Build the complete product in Shopify: name, description, images, status, category, collections, sales channels, tags, options, and variants (price, SKU, barcode, weight, cost, country of origin, HS code). It syncs into SKUSavvy on connect; SKUSavvy reads what it needs and ignores Shopify-only fields like collections and sales channels.

Field	Syncs	Notes
Product name	Dual	Renaming in either system updates the other.
Status (active, draft, archived)	Dual	Controls whether the product is live.
Tags	Dual	Used for filtering and routing.
Option names (e.g. Size, Color)	Dual	The label of each option, not its values.
Product type	Shopify → SKUSavvy	Read in from Shopify.
Featured image	Shopify → SKUSavvy	Read in from Shopify.

Variants

Fields on each sellable variant of a product.

Field	Syncs	Notes
SKU	Dual	The scannable item code.
Price	Dual	Selling price in your store currency.
Barcode	Dual	Pushes back to Shopify only when it is the variant's only barcode.
Backorder policy	Dual	Whether the store keeps selling when out of stock.
Option values (e.g. Large, Red)	Dual	The chosen value for each option.
Variant image	Shopify → SKUSavvy	Read in from Shopify.

Item Details (Customs & Dimensions)

Customs and physical attributes used for shipping and international paperwork. These import once and are then owned by SKUSavvy.

Field	Syncs	Notes
Weight	Shopify → SKUSavvy	Read once at import. Edit it in SKUSavvy afterward; a later change in Shopify will not flow down.
Harmonized System (HS) code	Shopify → SKUSavvy	Read in from Shopify, then managed in SKUSavvy.
Country of origin	Shopify → SKUSavvy	Read in from Shopify, then managed in SKUSavvy.
Per-country HS codes	Shopify → SKUSavvy	Read in from Shopify, then managed in SKUSavvy.
Dimensions (length, width, height)	SKUSavvy only	Exist only in SKUSavvy; Shopify has no equivalent field.

Weight, HS code, and country of origin are read a single time when the product first imports. Keep them current in SKUSavvy, not Shopify.

Inventory Quantities

Stock counts behave differently from catalog fields: they import once, then SKUSavvy becomes the source of truth.

Field	Syncs	Notes
On-hand quantity per location	Dual	Imported once when you connect. After that SKUSavvy owns the count and pushes it to Shopify. Do not edit quantities in Shopify.

How Inventory Syncs with Shopify

Kitting & Bundles

A bundle combines several products into one sellable product, handled in SKUSavvy as a kit. Put the finished bundle on Shopify so it can be sold, then decide where the inputs live.

Finished bundle product: add to Shopify so it sells on your storefront.
Bundle inputs: add to Shopify only if you also sell them individually; otherwise add them in SKUSavvy and leave them off Shopify.
The kit "recipe" (which inputs build the bundle) and input inventory: managed in SKUSavvy.

SKUSavvy does not currently push a theoretical bundle quantity (the lowest buildable across inputs) up to Shopify. Track buildable kit availability in SKUSavvy.

Orders

Orders usually originate in Shopify. You can also create orders or draft orders in SKUSavvy, which push up to Shopify.

Field	Syncs	Notes
Order (creation)	Dual	Created in Shopify, or created in SKUSavvy and pushed up as a draft or live order.
Order number	Shopify → SKUSavvy	Assigned by Shopify.
Order note	Dual	Edits in SKUSavvy push back to the Shopify order.
Tags	Dual	Used for filtering and routing.
Cart / custom attributes	Dual	Key-value attributes carried on the order.
Payment status	Shopify → SKUSavvy	Owned by Shopify; managed through Shopify payments.
Shipping method & cost	Shopify → SKUSavvy	Set in SKUSavvy only when the order originates there.
Assigned location / warehouse	Shopify → SKUSavvy	Shopify routes the order to a location; SKUSavvy maps it to a warehouse.
Fulfillment status	Dual	Reported by Shopify and updated as SKUSavvy fulfills.

Shopify orders land in SKUSavvy on your default warehouse, then route and split to match the location Shopify assigned. Shopify POS orders also flow in and are auto-fulfilled, creating a reconciliation, or fulfilling from available inventory.

Line Items

The individual items on an order.

Field	Syncs	Notes
Item & quantity	Dual	Change a quantity or add an item in SKUSavvy and it pushes to Shopify as an order edit.
Unit price	Dual	Per-item price on the order.
SKU	Dual	Carried from the variant.
Discounts	Shopify → SKUSavvy	Calculated by Shopify and read in.
Line item properties	Shopify → SKUSavvy	Custom per-line attributes read in from Shopify.
Custom (non-catalog) items	Shopify → SKUSavvy	Items with no matching product are read in as custom line items.

Customers & Addresses

Customer contact details and shipping addresses, whether they arrive on an order or you create them.

Field	Syncs	Notes
Customer name	Dual	First and last name.
Email	Dual	Primary email address.
Phone	Dual	Primary phone number.
Customer note	Dual	Free-text note on the customer.
Shipping address	Dual	Street, city, region, country, and postal code.
Map coordinates	Shopify → SKUSavvy	Latitude and longitude returned by Shopify when an address is created.

Fulfillment & Tracking

Shopify decides where an order ships; SKUSavvy does the picking and packing, then reports the result back to Shopify.

Field	Syncs	Notes
Fulfillment routing (which location ships)	Shopify → SKUSavvy	Shopify assigns the location and signals holds, moves, merges, and splits.
Mark as fulfilled	SKUSavvy → Shopify	Sent to Shopify when you ship in SKUSavvy.
Tracking number & carrier	SKUSavvy → Shopify	Pushed to Shopify with the fulfillment.
Cancel fulfillment	SKUSavvy → Shopify	Cancelling a shipment in SKUSavvy cancels it in Shopify.
Ready-for-pickup status	Dual	Set when a pickup order is staged.
Delivery tracking events (in transit, delivered)	Shopify → SKUSavvy	Carrier scan events read in from Shopify.

Vendors & Costs

Sourcing data. Vendor names seed from Shopify, but the detail lives in SKUSavvy.

Field	Syncs	Notes
Vendor	Shopify → SKUSavvy	Read from the Shopify product's vendor field. There is no push back; manage vendor detail in SKUSavvy.
Unit cost	Shopify → SKUSavvy	Imported from Shopify, then managed in SKUSavvy.

Add vendors in SKUSavvy. When a new product introduces a vendor, the steps depend on whether that vendor already exists.

New product, new vendor: add the product to Shopify with the vendor field filled in, then in SKUSavvy open Vendors > Items and confirm the product is listed under that vendor.
New product, existing vendor: add the product to Shopify (you can leave the vendor field blank), then assign the product to the vendor in SKUSavvy. A product can belong to multiple vendors, each with its own cost.

Purchase Orders & Transfers

Both are managed entirely in SKUSavvy: Shopify has no API for either.

Purchase orders: add your vendors and assign products (with costs) to them, then place the PO and check in inventory as it arrives. A product can carry different costs across vendors.

Transfers: move stock between locations in the SKUSavvy transfers (cross-docking) module. The transfer decrements the origin and increments the destination, and the resulting quantities push to Shopify.

Metafields

Custom metafields on products, variants, and orders.

Field	Syncs	Notes
Product, variant & order metafields	Dual	Editing a synced metafield in SKUSavvy writes it back to Shopify.

Settings That Change Sync Behavior

A few settings change what syncs or which direction it flows. Most live in Company Settings. Click a setting below to jump straight to it.

Setting	Default	What it changes
Sync item weight from Shopify	On	When on, Shopify is the source of truth for item weight and overwrites SKUSavvy on import. Turn it off to own weight in SKUSavvy.
Sync vendors & costs from Shopify	On	When on, vendor names and unit costs seed from Shopify during product import. Turn it off to manage vendors and costs only in SKUSavvy.
Overwrite costs from Shopify	Off	When on, Shopify unit costs overwrite your existing costs. When off, Shopify only fills in costs that are missing.
Replace barcodes from Shopify	Off	When on, a Shopify barcode replaces existing SKUSavvy barcodes. When off, barcodes are merged.
Auto-generate barcodes	Off	When on, SKUSavvy generates a barcode for any variant Shopify does not provide one for.
Ignore order note attributes	Empty (no patterns)	Patterns that drop noisy order note attributes (e.g. app-added cart attributes) as orders import.

syncDraftOrders is a per-store setting on each connected Shopify store (not Company Settings). When on, Shopify draft orders mirror into SKUSavvy and reserve inventory.

Keeping Inventory Accurate During Setup

While you set up SKUSavvy you can keep running normal operations in Shopify: updating quantities and fulfilling orders. Keep these in mind during the transition.

Resync regularly: if you update inventory in Shopify after connecting, run a Shopify → SKUSavvy resync to pull those changes in. You do not need to resync changes you made in SKUSavvy.
Reconcile stock: an order fulfilled outside SKUSavvy is held as a reconciliation. If the product lives in a single bin it reconciles automatically; otherwise reconcile it by hand.
Allocate stock quickly: get your Shopify inventory into bin locations fast. It often makes sense to pause fulfillment for a day and allocate everything at once.
Start fulfilling in SKUSavvy: the sooner stock is in bins, the sooner you can fulfill in SKUSavvy and keep quantities aligned with Shopify.

Managed Only in SKUSavvy

These have no Shopify equivalent and never sync. Create and manage them entirely in SKUSavvy.

Purchase orders, vendor assignments, and check-ins
Inventory transfers between locations
Bins, Shelves, and Areas
Lots and expiration dates
Serial numbers
Physical dimensions and step counts
Kit and bundle inputs (the components consumed to build a sellable bundle)

Shopify offers no API for transfers or for bin-level stock, so SKUSavvy cannot push these up. They stay inside SKUSavvy by design.