Vendor Code

What Is A Vendor Code?

A vendor code is the vendor-side internal code for a specific item. It is the code a supplier uses for that item in their own system, paperwork, quote, or sales conversation.

The exact meaning can vary by vendor. For one vendor, it may be the short code KTP uses when placing an order. For another vendor, it may be a code KTP and the salesperson agreed to use as a practical shorthand.

Each vendor code belongs to one item and one vendor.

Vendor Code can also store a price. This is not the confirmed purchase price and does not mean the item will arrive at that price. It is a reference purchase price: a benchmark price that staff can use during ordering, comparison, or salesperson discussions.

Where To Find It

Open Pricing > Vendor Codes in the Web client.

Screen	Route	Use it to
Vendor Codes	`/v2/vendor-code`	Search items and manage the vendor codes attached to each item.

What Staff See

The Vendor Codes page is item-first. Staff search for an item, then review or add vendor codes under that item.

Area	Notes
Item	Item English name, Korean name, item code or barcode, and UOM.
Vendor	The supplier that uses this code.
Vendor code	The vendor-side internal code for this item.
Vendor price	Optional reference purchase price saved with the code. Prices are entered in dollars.
Archive action	Hides an old vendor code without deleting history.

Add A Vendor Code

Open Pricing > Vendor Codes.
Search for the item.
Select a vendor under that item.
Enter the vendor code.
Enter the vendor price if there is a useful reference purchase price.
Click Add.

If the same vendor already has an active code for the item, adding a new one replaces the active code. The older code is archived.

Archive A Vendor Code

Open Pricing > Vendor Codes.
Search for the item.
Find the vendor code.
Click Archive.
Confirm the archive action.

Archived vendor codes no longer appear in the active Vendor Codes page.

Purchase Invoice Auto-Creation

Vendor codes can also be created from Purchase Invoice work.

When staff prepare a Purchase Invoice row with an item and vendor code, KTPv5 keeps that code on the invoice row. When the invoice is published, KTPv5 checks whether an active vendor code already exists for that invoice vendor and item. If none exists, KTPv5 automatically creates one using:

The invoice vendor
The invoice row item
The invoice row vendor code
The invoice row unit price as the reference vendor price

This helps purchasing staff build the vendor code list naturally while entering supplier invoices.

The auto-created vendor price is still only a reference price. Future Purchase Invoices can use a different real unit price.

Purchase Order Generate Lookup

Purchase Order Generate and Purchase Invoice entry use vendor codes as read-only suggestions. Purchase Order Generate looks up active vendor codes for requested items so staff can see known vendors for each item. Purchase Invoice entry uses vendor codes to fill row code and reference price information for the selected vendor.

This lookup does not create, edit, archive, or replace vendor codes. It only helps purchase staff choose or fill supplier item details before creating purchase documents.

Search Vendor Codes

Use the search box on the Vendor Codes page to search items. Search checks item information such as item name, item code, and barcode. After matching items load, the page shows active vendor codes for those items.

Required Roles

Action	Required role
View vendor codes	`pricing.read` or `pricing.manage`; `purchase_order.manage` and `purchase_invoice.manage` for purchase document lookups
Add a vendor code	`pricing.manage`
Archive a vendor code	`pricing.manage`
Auto-create from published Purchase Invoice	`purchase_invoice.manage`

Common Problems

Problem	What it means
`Select a vendor`	No vendor has been selected before adding the code.
`Code is required`	The vendor code field is empty.
`Price must be a valid amount`	The vendor price is negative or not a number.
Vendor code disappears after adding a replacement	The older active code for the same vendor and item was archived and replaced.
A Purchase Invoice code did not appear on Vendor Codes yet	The invoice may still be a draft. Vendor code auto-creation happens when the Purchase Invoice is published.

Vendor Code

On this page