Item Barcode

This API accepts item-barcode payloads, validates them against the interface specification, and loads them into the existing stage table used by the Input Interface.

The API can run synchronously (default) or asynchronously depending on async_flg.

URL

POST .../wms/lgfapi/v10/stage/item_barcode

Highlights / Behavior

• Accepts JSON payloads and stages them into the existing input-stage table (same table used by the non-JSON interface).
• async_flg controls synchronous vs asynchronous processing:
  • false (default): synchronous: validate & process in the same request and return result.
  • True: asynchronous: perform initial validations, enqueue for processing, return acknowledgement with a request id.
• System validates all values (per ItemBarcode_Required.json, ItemBarcode_All.json, and interface spec). If any validation fails, the API returns descriptive error messages; invalid async requests are rejected (not queued).
• Clients must include all mandatory fields. Non-mandatory fields are optional.

Request Parameters

Section	Name	Type	Required	Description / Notes
stage_item_barcode_list (record-level)	vendor_barcode	String	Yes	Vendor-supplied barcode for the item (external barcode key). Must meet length/format rules in spec.
	item_barcode	String	Yes	Internal item barcode or alternate barcode in WMS. Must be valid per catalog rules.
	action_code	String	Yes	Action to perform. Typical allowed values: CREATE, UPDATE, DELETE. Use interface spec for full list.
	uom	String	Conditional/Yes*	Unit of measure for the barcode mapping (e.g., UNITS, CASES) — must be valid in WMS. If mapping is UOM-specific, this is mandatory.
	qty_per_uom	Number/String	No (default 1)	Quantity represented by one UOM (if applicable). Must be numeric and comply with pack/case rules.
	associated_pack_case_qty	String/Integer	No	Associated pack/case quantity when barcode maps to a pack or case. If provided, must be a valid integer and consistent with uom/qty_per_uom.

Request Body

{
  "async_flg": false,
  "stage_item_barcode_list": [
    {
      "vendor_barcode": "JNORITM031",
      "item_barcode": "JNORITM3",
      "action_code": "CREATE",
      "uom": "UNITS",
      "qty_per_uom": "1",
      "associated_pack_case_qty": ""
    }
  ]
}

Sample Response

200 OK