Item Code Sync

What this menu does

WMS must know your items before it can accept picking notes or POs. This menu pushes your AutoCount item master (stock items) to WMS.

Think of it as introducing your items to the warehouse — once WMS knows "Item ABC-123 exists, looks like this", it can accept orders for that item.

⚡ Important first

An item can have at most 3 packagings

WMS only supports EA + INP + CS (each / inner-pack / case). If an AutoCount item has more than 3 UOMs, the extras are dropped. Warehouse scan workflows may not work for the dropped packagings.

Trim your AutoCount UOMs to the 3 most important.

AutoCount Item Type must already exist in the WMS category list

WMS Sync Hub sends the item's Item Type to WMS as a SKU category.

• If that Item Type doesn't exist in WMS categories → WMS won't display the synced item code, as if nothing happened.
• Fix: Use the Item Type Sync... button at the top-right of this page to push AutoCount Item Types to WMS BAS in bulk. Or have the warehouse admin create them manually.
• If Item Type is empty in AutoCount → WMS puts it in the GENERAL default bucket, which is hard to track.

Recommended: On first use, click Item Type Sync... to push all categories first, then start syncing items.

How to use

1. Click Item Code Sync in the left navigation.
2. Use the Search box at the top to find your item (Enter = Filter).
3. Tick the Sync column on that row (max 20 rows per push).
4. Click the Sync Now button at the top.
5. A confirmation dialog lists the items you ticked — click Yes.
6. Watch the Sync Status column:
   • N = pending (not yet pushed)
   • S = synced successfully
   • E = error (hover for the message)

tip

Tick multiple items and push them together. Limit is 20 rows — keeps you within WMS API rate limits.

caution

All Sync Now buttons trigger a confirmation dialog. This prevents accidental pushes. Read the list carefully before clicking Yes.

Auto-sync new (the toggle)

The Auto-sync new checkbox at the top of the page, when ticked, automatically queues + pushes any newly created items in AutoCount (provided Start Sync is ON). Existing items are unaffected — those still require manual tick + Sync Now.

Retry Failed Items

If some items failed to sync (Sync Status = E) — typically due to a network blip, WMS being temporarily down, or Item Type missing on WMS — fix the cause then retry:

1. Tick the Sync column on the failed rows (max 20).
2. Click Retry Failed Items at the top.
3. The confirmation dialog lists what you're retrying — click Yes.
4. Status resets from E → N; the worker will repush on the next poll.

note

Retry Failed only touches rows you ticked AND in status E. Untouched rows and rows in status N / S are unaffected.

The three helper buttons at the top

The Item Code Sync page also has three special buttons in the top-right:

Push UOM (focused)

• Purpose: Single-row trigger — push the UOM names (e.g. UN / CT) of the currently focused row to WMS BAS, overwriting the packagingList description.
• When to use: The item's UOM names look wrong on WMS, or you want to backfill UOM descriptions after the initial push.
• Pre-condition: The item must already be synced (LastSyncDate is not null).

Item Type Sync...

• Purpose: Opens the Item Type Sync dialog. Pushes AutoCount Item Types in bulk to WMS BAS as SKU categories.
• The Sync Now button inside the dialog has its own confirmation dialog and queues every Item Type at status ≠ S for the worker to process.

UOM Names Sync...

• Purpose: Opens the Push UOM Names to WMS dialog. Phase 2 batch sync — pushes UOM descriptions for every item that hasn't had it pushed yet, one by one via the BAS API.
• A master switch controls whether this is enabled; OFF by default (opt-in).
• Make sure your BAS credentials are configured before using.

What it looks like on WMS after syncing

Your AutoCount items can have any number of UOMs — UN, CT, PK, BX, BD, etc. WMS only recognises 3 packagings:

WMS packaging	Plain English
EA	Each — single piece, one unit
INP	Inner Pack — a small bundle (e.g. a few EA in a polybag)
CS	Case / Carton — biggest packaging (the full carton)

So when syncing, WMS Sync Hub maps your AutoCount UOMs into these 3. Rules:

1. The row with Rate = 1 → EA (base unit; WMS requires it)
2. The row with UOM = 'CT' → CS (carton)
3. All other UOMs → INP (inner pack)

Real example

Suppose AutoCount item 113005 has 3 UOMs:

AutoCount UOM	Rate	Meaning
UN	1	1 UN = 1 piece
CT	4	1 CT = 4 pieces
PK	6	1 PK = 6 pieces

After syncing, WMS will see:

WMS packaging	pcsQty (number of EA inside)	Mapped from
EA	1	UN (Rate=1)
INP	6	PK (rule 3, others)
CS	4	CT

The respective barcode also gets sent — if the AutoCount UOM has a BarCode filled in, that barcode is usable for that packaging on WMS.

What happens in different scenarios

AutoCount has	WMS gets	Anything lost?
Only UN (Rate=1)	Only EA	✅ All preserved
UN + CT (most common)	EA + CS	✅ All preserved
UN + CT + PK	EA + INP + CS	✅ All preserved
UN + PK (no CT)	EA + INP, no CS	✅ All preserved (CS slot empty)
UN + PK + BX (two non-CT)	EA + INP (PK wins, BX dropped)	⚠️ BX dropped
No ItemUOM record	Only EA, pcsQty=1 placeholder	⚠️ Packaging info lost

FAQ

• Q: Can I delete an item from WMS? No — once an item is on WMS, it stays. Just stop sending orders that use it. Mark it inactive in AutoCount when you're done with it.
• Q: What if I forget to sync an item and try to push a picking note? The picking note will fail with "item not found on WMS". Go to Item Code Sync, tick the missing item, click Sync Now, wait for S, then re-sync the picking note.
• Q: Do I need to re-sync after editing item description? No — the worker auto-detects items where Item.LastModified > LastSyncDate and re-pushes on the next poll. No manual action needed.