Set Event Request Guidelines

eventTime

1...1
1/*

String

Required. The date and time the Set Event occurred. Specifically, this may indicate when the physical scan is performed or the date and time provided by the calling application.

serialNumberList

1...1
1/*

String

Required. Indicates the serialized product associated with the Smart Event Manager Event Request. The Set Event request API supports the reporting of either one serial number (which is processed synchronously) or multiple serial numbers (which are processed asynchronously).

At minimum, the Smart Event Manager Event Request API requires the following:

packagingCode
serialNumber
lotNumber
expirationDate

packagingCode

1...1
1/*

String

Required. The packaging code of the serialized product. Supports GTIN-14, NTIN, or CN-RESCODE.

This corresponds to the GS1 Application Identifier 01 if the packagingCode represents a GTIN-14 or NTIN.

packagingCodeType

0...1
0/*

String

The type of the serialized product packaging code. The default value is GTIN-14.

See the PackagingCodeType enumeration list for valid values.

serialNumber

1...1
1/*

String

Required. The serial number associated with the serialized product. This is specified in the GS1 Application Identifier format without parentheses for the AI keys. AI (01) (21) formatted serial numbers for GTINs. Non-GS1 serial numbers (e.g. China) are expressed in native format.

This corresponds to the GS1 Application Identifier 21.

lotNumber

1...1
1/*

String

Required. The lot or batch code associated with the serialized product.

This corresponds to the GS1 Application Identifier 10.

expirationDate

1...1
1/*

String

Required. Indicates the expiration date of the serialized product in YYMMDD format and corresponds to the GS1 Application Identifier 17 as originally reported in the request message. The element supports the value 00 for the DD element.

productionDate

0...1
0/*

Date

The production date associated with the serialized product. This is specified in YYMMDD format.

This corresponds to the GS1 Application Identifier 11.

variant

0...1
0/*

String

The internal product variant associated with the serialized product.

This corresponds to the GS1 Application Identifier 20.

activePotency

0...1
0/*

String

The active potency associated with the serialized product.

This corresponds to the GS1 Application Identifier 7004.

nhrnPZN

0...1
0/*

String

The National Healthcare Reimbursement Number for the Germany PZN associated with the serialized product.

This corresponds to the GS1 Application Identifier 710.

nhrnCIP

0...1
0/*

String

The National Healthcare Reimbursement Number for the French CIP associated with the serialized product.

This corresponds to the GS1 Application Identifier 711.

nhrnCN

0...1
0/*

String

The National Healthcare Reimbursement Number for the Spain Codigo Nacional associated with the serialized product.

This corresponds to the GS1 Application Identifier 712.

nhrnDRN

0...1
0/*

String

The National Healthcare Reimbursement Number for the Brasil ANVISA associated with the serialized product.

This corresponds to the GS1 Application Identifier 713.

nhrnAIM

0...1
0/*

String

The National Healthcare Reimbursement Number for the Portugal AIM associated with the serialized product.

This corresponds to the GS1 Application Identifier 714.

barcode

0...1
0/*

String

The full 2D barcode content of the product scan. At minimum this contains:

packagingCode
serialNumber
lotNumber
expirationDate

This field should include the full raw DataMatrix content in the native GS1 Element String, with FNC1 (codeword 232) symbol character separators preserved so the system can parse variable length data elements accurately. For more information, see Section 2.2. GS1 Element Strings of GS1 Data Matrix Guide — Introduction and Implementation Guideline, version 2.2, published May 2015.

containerID

0...1
0/*

String

The container identifier for the relevant serialNumber.

containerType

0...1
0/*

String

Conditionally required if containerID is present. The type of the serialized product containerId. This may be one of the following:

GTIN-14
SSCC

eventType

1...1
1/*

String

Required. The nature of the Smart Event Manager event request. As a generic observation API, this Smart Event Manager message captures a variety of supply chain and compliance activities.

Valid value: VERIFYING

locationType

1...1
1/*

String

Required. The type of the associated locationValue for the serialized product event.

See the LocationType enumeration list for valid values.

locationValue

1...1
1/*

String

Required. The location where the reported supply chain activity takes place.

extensionData

1...1
1/*

String

Required. Supports a number of name/value pairs for reporting various supply chain and compliance activities.

The extensionData section may contain 0-n name/value pairs. TraceLink reserves these name/value pairs for use in the subsequent synchronous processing for the event. The information in the extensionData section is stored in the Smart Event Manager repository.

market

1...1
1/*

String

Required. The market name/value pair indicates the country where the reported event activity occurs. Must be a 2-letter ISO Code of country where event occurs.

See the CountryCode enumeration list for valid values.

supplyType

0...1
0/*

String

A name/value pair that indicates a description of the compliance/supply chain activity. Use this to describe shipment activity.

See the SupplyType enumeration list for valid values.

po

0...1
0/*

String

The Purchase Order associated with the serial numbers in serialNumberList.

salesOrder

0...1
0/*

String

The Sales Order associated with the serial numbers in serialNumberList.

return

0...1
0/*

String

The Return Order associated with the serial numbers in serialNumberList.

transfer

0...1
0/*

String

The Transfer Order associated with the serial numbers in serialNumberList.

asn

0...1
0/*

String

The Advance Shipped Notice associated with the serial numbers in serialNumberList.

bol

0...1
0/*

String

The Bill of Lading associated with the serial numbers in serialNumberList.

packslip

0...1
0/*

String

The Packing Slip associated with the serial numbers in serialNumberList.

invoice

0...1
0/*

String

The Invoice associated with the serial numbers in serialNumberList.

destruction

0...1
0/*

String

The Destruction Order associated with the serial numbers in serialNumberList.

notaFiscal

0...1
0/*

String

The Nota Fiscal associated with the serial numbers in serialNumberList.

scriptId

0...1
0/*

String

The Script ID associated with the serial numbers in serialNumberList.

fromBusinessParty

0...1
0/*

String

Conditionally required if fromBusinessPartyType is present. The identifier of the company where the serialized product ships to. Use with fromBusinessPartyType, which provides the identifier type.

The fromBusinessParty element is typically used with a SHIPPED, UNDO_SHIPPED, RECEIVED, or UNDO_RECEIVED event.

fromBusinessPartyType

0...1
0/*

String

Conditionally required if fromBusinessParty is present. A name/value pair that indicates the identifier type of fromBusinessParty.

See the CompanyType enumeration list for valid values.

toBusinessParty

0...1
0/*

String

Conditionally required if toBusinessPartyType is present. A name/value pair that indicates the identifier of the company that receives serialized product. Use with toBusinessPartyType, which provides the identifier type.

The toBusinessParty element is typically used with a SHIPPED, UNDO_SHIPPED, RECEIVED, or UNDO_RECEIVED event.

toBusinessPartyType

0...1
0/*

String

Conditionally required if toBusinessParty is present. A name/value pair that indicates the identifier type of toBusinessParty.

See the CompanyType enumeration list for valid values.

userID

0...1
0/*

String

A name/value pair that indicates the email address of the user reporting the event.

customData

0...*
0/*

String

A number of name/value pairs to support the reporting of various supply chain and compliance activities.

The customData section may contain 0-n name/value pairs. These name/value pairs are user-defined and are not used in the subsequent synchronous or asynchronous processing for the event. The information in the customData section is stored in the Smart Event Manager repository.

context

1...1

Enum

Required.The reason the product is being verified. Valid values:

dscsaStatusCheck – The product is being verified for routine reasons to retrieve basic verification information, such as the product's expiration date.
dscsaExceptionVerification – The product is being verified to retrieve more information about a product.
dscsaSuspectIllegitimate – The product is being verified because it is suspected as being illegitimate.
dscsaSaleableReturn – The product is being verified to confirm that it can be resold after being returned.

ctrlPossessAtt

1...1

Boolean

Required. Indicates whether the company submitting the verification request is in possession of the product they are verifying. Valid values:

True – The company is in possession of the product they are verifying.
False – The company is not in possession of the product they are verifying.