Querying Serialized Products
Table of Contents
Querying Serialized Products
3
Querying a Serial Number
3
Querying a Serial Number's History
6
Querying Lots
10
Reconciling the Contents of a Container
12
TraceLink, Inc. ("TraceLink") owns all right, title to, and interest in TraceLink's methodologies, processes, services, software
programs and/or the licensed TraceLink training materials. The training materials are informational in nature and do not
constitute a warranty of TraceLink. The licensed use of the Tracelink training materials is solely in conjunction with the licensed
use of applicable TraceLink services and/or software programs. Any reproduction or modification of the TraceLink training
materials is prohibited. This training material is confidential and can only be used by an authorized customer or partner.
TraceLink, Inc. Copyright 2015-2016. All rights reserved.
Copyright © 2016 TraceLink
Page 2
9/25/2016
Querying Serialized Products
Learning Objectives
At the end of this module, you will be able to:
n
Obtain data, status, and history for serial numbers and lots.
n
Compare the actual contents of a serialized container with the contents for the
container in the SOM repository.
Overview
You can use SOM’s query functions to:
n
Verify serialized products and containers.
n
Obtain details of serial numbers and their associated items.
n
Obtain a list of serialized events and the details for each event.
n
Move up and down through the aggregation hierarchy of serialized products.
n
Troubleshoot issues with serialized products and containers.
Querying a Serial Number
Use SOM to obtain the following data on a serial number:
Serial Number Query Results
Serial number
information
Item information
Copyright © 2016 TraceLink
n
Encoding format
n
Status
n
Status of associated item
n
Item’s code
n
Lot number
n
Packaging level
n
Attributes
Page 3
9/25/2016
Serial Number Query Results
Parent
information
Provides a link to the item’s parent so that you can access its
serial number information.
Child information
Provides a link to the container’s child so that you can access its
serial number information.
In this example, the serial number belongs to a container:
Copyright © 2016 TraceLink
Page 4
9/25/2016
In this example, the serial number belongs to an item:
Query a Serial Number
To query a serial number:
1. In Serialized Operations Manager, click Queries and click the Get Serial Number
Status link.
2. Set Show Data From to the manufacturing site that provisioned the serial
number of the products you’re managing.
3. Enter the Serial Number.
4. Click Search.
Copyright © 2016 TraceLink
Page 5
9/25/2016
Querying a Serial Number's History
Use SOM to display a table containing each event in the lifecycle of a serial number.
The operation returns general information about the serial number and a list of
events:
Copyright © 2016 TraceLink
Page 6
9/25/2016
The Get Serial Number History operation provides the following general information
about the serial number:
Serial Number History Results
Serial Number Information
Item Information
n
Encoding format
n
Status
n
Status of associated item
n
Item’s code
n
Lot number
n
Packaging level
n
Attributes
For each event, the Get Serial Number History operation provides the time the event
occurred as well as the following information:
Event
Value
Description
Event
Serialization event
Possible values: Status
Updated, Received, Shipped,
Packed, Unpacked,
Commissioned, and
Provisioned.
Business Step
Business process step
associated with serialization
event
Possible values: destroying,
receiving, shipping, packing,
unpacking, commissioning,
and reserving.
Disposition
Serialization number status
Possible values: destroyed,
received, in_transit, in_
progress, active, and
reserved.
Business Location
Location GLN identifier /
Location Name
Location where serialization
event occurred.
Transactions
Document corresponding to
the serialization event
Business transactions include
documents such as purchase
orders.
Copyright © 2016 TraceLink
Page 7
9/25/2016
Event
Value
Description
Attributes
List of attributes assigned to
the serial numbers during
status update operations
Possible values: Damaged,
Expired, Quality Released,
Recalled, and Sampled.
Reason Code
Reason code for updating,
destroying, or
decommissioning a serial
number
Possible values: Product
Status Update and Modifying
Product Incorrect Status
Description
Reason description
The reason for the update,
destroy, or decommission
operation. If no value was
entered, the row does not
display.
From
Ship from address
The From row is included if
the Event is Shipped or
Received.
To
Ship to address
The To row is included if the
Event is Shipped or Received.
Copyright © 2016 TraceLink
Page 8
9/25/2016
Event
Value
Description
Distribution Type
Types of shipments and
receipts
The Distribution Type row is
included if the Event is
Shipped or Received.
Shipment distribution types
include:
n
Return - Export
n
Return - In Country
n
Sale - Export
n
Sale - In Country
n
Transfer - Export
n
Transfer - In Country
Receipt distribution types
include:
n
Purchase - Import
n
Purchase - In Country
n
Return - Import
n
Return - In Country
n
Transfer - Import
n
Transfer – In Country
Parent Container
Package containing the item
corresponding to the serial
number. Displays for
aggregate and disaggregate
operations.
Displays the serial number
status of the parent.
Performed By
First and last name and the
system ID of the user.
Indicates the user and system
that initiated the event. If no
value was entered, the row
does not display.
Copyright © 2016 TraceLink
Page 9
9/25/2016
View a Serial Number's History
You can query an item code and lot only if they have associated serialized items.
To view the serial number's history:
1. In Serialized Operations Manager, click Queries and click the Get Serial Number
History link.
2. Set Show Data From to the manufacturing site that provisioned the serial
number of the products you’re managing.
3. Enter the Serial Number.
4. Click Search.
5. To download a CSV file containing a row for each event, click Export Events to
CSV.
Querying Lots
Use SOM to obtain the following data on an item code and lot:
Lot Status Query Results
Item information
Provides the item’s packaging codes and internal material
number.
Lot information
Provides the lot’s expiration date, quality release status,
and the quantity of serial numbers in the repository for the
specified item code and lot.
Copyright © 2016 TraceLink
Page 10
9/25/2016
This example shows the lot status results:
Query an Item Code and Lot
You can query an item code and lot only if they have associated serialized items.
To query an item code and lot:
1. In Serialized Operations Manager, click Queries and click the Get Lot Status
link.
2. Set Show Data From to the manufacturing site that provisioned the serial
numbers of the products you’re managing.
3. Enter the Item Code or click the drop-down icon
and select a code.
If you type the beginning of the number, TraceLink autocompletes it.
The item codes in the list represent the serialized products at the site you
selected in the Show Data From menu.
4. Enter the Lot Number.
5. Click Search.
Copyright © 2016 TraceLink
Page 11
9/25/2016
Reconciling the Contents of a Container
SOM lets you verify that the actual contents of a container match the items
aggregated in the repository for that container.
To make the comparison, you provide:
n
The serial number of the container
n
A list of the serial numbers in the actual container by typing the numbers,
scanning them, or uploading them in a file
By default, SOM provides just the discrepancies:
n
Items from the actual container that are not in the container in the serial
number repository
n
Items aggregated to the container in the repository that are not in the actual
container
Reconcile Container Example
In this example, the container in the repository has the serial numbers shown:
Copyright © 2016 TraceLink
Page 12
9/25/2016
SOM reconciles the container in the repository with the actual container containing
these serial numbers:
If you opt to view the discrepancies only, these results show:
n
The item associated with the first serial number is in the actual container (
but not in the container in the repository (
n
),
).
The item associated with the second serial number is not in the actual container
(
), but it is in the container in the repository (
Copyright © 2016 TraceLink
Page 13
).
9/25/2016
You can turn off the View Discrepancies Only option, in which case you see the list
of items in the actual container and the list of items for the container in the repository
with the mismatch icon ( ) to show where there are discrepancies:
Reconcile a Container’s Contents
This procedure shows how to reconcile a container by specifying the actual serial
numbers for a container and comparing them to the container’s contents in the
repository.
To reconcile a container with its contents in the repository:
1. In Serialized Operations Manager, click Queries and click the Reconcile
Container link.
2. Set Show Data From to the manufacturing site that provisioned the serial
numbers of the products you’re managing.
3. Enter the Container Serial Number.
Copyright © 2016 TraceLink
Page 14
9/25/2016
4. Check View Discrepancies Only to see the differences between the list of
serial numbers you provided and those aggregated in the container in the
repository.
View Discrepancies Only is enabled by default. If you uncheck the option,
you can see the list of items in the actual container and those aggregated to the
container in the repository.
5. Click Reconcile.
Copyright © 2016 TraceLink
Page 15
9/25/2016