CMO Use Cases
TraceLink Roles
TraceLink API Guides group messages by application. Each API Guide contains all messages available within that application. Your company's business type (e.g. CMO, Wholesale Distributor, 3PL) and role in the TraceLink Network (Owner or Partner1) determine which of these messages to develop (i.e. not all messages within this guide may fulfill your business or compliance needs).
See below to confirm which messages you should develop based on your role in the supply chain and/or the TraceLink Network.
Configure and exchange (send or receive) each message separately as a best practice.
Serialized Operations Manager ESM Owners


CMOs send the ESM Commission message to TraceLink, which associates a serial number to a particular object, product, or container.

CMOs send the ESM Commission message to TraceLink, which associates a serial number to a particular object, product, or container.

CMOs send the ESM Decommission message to TraceLink, which terminates the use of an associated serial number from a product or container. CMOs are able to recommission a decommissioned serial number at a later time with updated information.

CMOs send the ESM Decommission message to TraceLink, which terminates the use of an associated serial number from a product or container. CMOs are able to recommission a decommissioned serial number at a later time with updated information.

CMOs send the ESM Destroy message to TraceLink, which permanently terminates a serial number when a product is damaged or expired and the product or case is physically eliminated. A destroyed serial number cannot be recommissioned or re-used.

CMOs send the ESM Destroy message to TraceLink, which permanently terminates a serial number when a product is damaged or expired and the product or case is physically eliminated. A destroyed serial number cannot be recommissioned or re-used.

CMOs send the ESM Aggregation message to TraceLink, which details parent-child relationships when child products are added to a parent container during an aggregation event.

CMOs send the ESM Aggregation message to TraceLink, which details parent-child relationships when child products are added to a parent container during an aggregation event.

CMOs send the ESM Disaggregate message to TraceLink, which notifies upstream partners of any unpacking events. This message maintains the parent-child relationship between serialized items or cases, and their containers.

CMOs send the ESM Disaggregate message to TraceLink, which notifies upstream partners of any unpacking events. This message maintains the parent-child relationship between serialized items or cases, and their containers.

CMOs send the ESM Shipment message to TraceLink, which indicates a sale, transfer, or return-movement of goods. The EPCIS v1.0 message does not support the combination of the Commission and Aggregation messages into one Shipment message.

CMOs send the ESM Shipment message to TraceLink, which indicates a sale, transfer, or return-movement of goods. The EPCIS v1.2 message supports the combination of the Commission and Aggregation messages into one Shipment message, instead of sending the information separately for each event. The Shipment message requires the shipment information and supports the following use cases:
- Shipment only: CMOs only send the Shipment information because the Commission and Aggregation events have already been processed.
- Shipment + Commission + Aggregation: CMOs report all three events at the same time from their external system to TraceLink.
- Shipment + Commission: CMOs omit the Aggregation message because the product does not require aggregation.
- Shipment + Aggregation: CMOs omit the Commission message because the information has already been processed.

CMOs send the ESM Shipment message to TraceLink, which indicates a sale, transfer, or return-movement of goods. The XML message supports the combination of the Commission and Aggregation messages into one Shipment message, instead of sending the information separately for each event. The Shipment message requires the shipment information and supports the following use cases:
- Shipment only: CMOs only send the Shipment information because the Commission and Aggregation events have already been processed.
- Shipment + Commission + Aggregation: CMOs report all three events at the same time from their external system to TraceLink.
- Shipment + Commission: CMOs omit the Aggregation message because the product does not require aggregation.
- Shipment + Aggregation: CMOs omit the Commission message because the information has already been processed.

CMOs send the ESM Receive message to TraceLink, which communicates the transfer of product. The message conveys the receipt of a transfer, return, or purchase between customers and trade partners from an internal enterprise serialization system of record to TraceLink's Serialized Operations Manager.

CMOs send the ESM Receive message to TraceLink, which communicates the transfer of product. The message conveys the receipt of a transfer, return, or purchase between customers and trade partners from an internal enterprise serialization system of record to TraceLink's Serialized Operations Manager.

CMOs send the ESM Receive message to TraceLink, which communicates the transfer of product. The message conveys the receipt of a transfer, return, or purchase between customers and trade partners from an internal enterprise serialization system of record to TraceLink's Serialized Operations Manager.

CMOs send the Take Product Sample message to update item status to "Sampled" when quality personnel remove serialized product for sampling purposes. This enables a Serialized Operations Manager Owner to:
- Disaggregate items from the container if already packed.
- Trigger a notification to the Pharmaceutical Manufacturer which may trigger government reporting by the Pharmaceutical Manufacturer for the sampling of serial numbers.

CMOs send the ESM Void Shipment message to TraceLink, which informs TraceLink that a completed delivery has been voided. This message can only be sent for a shipment that has been marked as a sale, not a transfer. CMOs use the Void Shipment message for the following use cases:
- The shipment is damaged or the customer completely cancels the order.
- The customer accepts the delivery, but the delivery contains incorrect information. The customer voids the delivery and creates a new one to correct and replace the inaccurate information.

CMOs use the ESM Update Serial Number Status message to synchronize serial number status update data from their enterprise serialization system of record. This can be used to correct mistakes or indicate certain state changes for compliance reporting purposes.