This Help Center is a preview of a future release. The final Help Center will be available on the Validation date.
Type = API Reference,; Topic = Multienterprise Information Network Tower (MINT), Transforms,;Persona = TraceLink Administrator, User, Solution Partner,; Orchestration = Manufacturing, Commerce,; Function = Supply Chain, IT, Procurement,
Customs event advisory details transactions
Customs Events Advisory Details is a standardized EDI transaction that communicates cargo transportation events to customs authorities and government agencies during international trade. Carriers, freight forwarders, logistics providers, and other transportation organizations exchange this transaction to report significant shipment events.
Customs Events Advisory Details reports transportation events such as:
-
Cargo arrival
-
Cargo departure
-
Cargo transfer
-
In-bond movement
-
Other transportation status update
The transaction provides structured information that includes:
-
Shipment and manifest identifiers
-
Bill of lading and container references
-
Carrier and conveyance information
-
Port and customs location information
-
Event dates and times
-
Transportation status code
The transaction uses standardized EDI segments and data elements to exchange transportation event information between transportation systems and customs authorities. This standardized structure enables consistent, accurate, and interoperable communication across trading partners.
Transportation organizations generate a Customs Events Advisory Details transaction whenever a reportable transportation event occurs for goods under customs control during the cross-border shipping lifecycle. Customs authorities use the information to monitor cargo movement, update customs clearance records, initiate compliance and inspection workflows, and maintain regulatory reporting.
Using Customs Events Advisory Details helps organizations:
-
Receive timely transportation event notifications.
-
Improve shipment visibility throughout customs processing.
-
Support customs compliance and regulatory reporting.
-
Reduce manual reporting and data entry errors.
-
Coordinate activities across ports, terminals, carriers, and logistics providers.
-
Improve operational efficiency.
-
Strengthen regulatory oversight.
-
Reduce reporting delays.
-
Increase transparency throughout international supply chain operation
Customs Events Advisory Details(X12)
The Customs Events Advisory Details X12 communicates customs-related cargo movement events, such as arrivals, departures, transfers, and status updates, between carriers, logistics providers, and customs authorities.
Contact your TraceLink Services representative for more information about integrating with this message.
Message Type: MPC_CUSTOMS_EVENTS_ADVISORY_DETAILS
Transform Names:
B2B_EDI_X12_353_CustomsEventsAdvisoryDetails_lB_V1
B2B_EDI_X12_353_CustomsEventsAdvisoryDetails_OB_V1
| Input Element | Occurs | Length | Description | Example | |||
|---|---|---|---|---|---|---|---|
| ISA | 1…1 | - | Required. ISA interchange envelope. | - | |||
| ISA01 | 1…1 | 2/2 | Required. Qualifier for authorization control number in ISA02. | 00 | |||
| ISA02 | 1…1 | 10/10 | Required. Information used for additional identification or authorization of the interchange sender or the data in the interchange/ 10 spaces a valid entry. | - | |||
| ISA03 | 1…1 | 2/2 | Required. Qualifier for security information in ISA04. | 00 | |||
| ISA04 | 1…1 | 10/10 | Required. Identifies security information about the interchange sender or data | - | |||
| ISA05 | 1…1 | 2/2 | Required. Interchange sender partner ID qualifier.
| 07 | |||
| ISA06 | 1…1 | 15/15 | Required. Instance 1 interchange sender identification mapping to fileSenderNumber with party type defined in ISA05. | 7777776067344 | |||
| ISA07 | 1…1 | 2/2 | Required. Interchange receiver partner ID qualifier.
| 01 | |||
| ISA08 | 1…1 | 15/15 | Required. Instance 1 EDI receiver ID mapping to file control header and to ServiceLinkId. | 888888404358877 | |||
| ISA09 | 1…1 | 6/6 | Required. Interchange date in 6 char YYMMDD format. | 250615 | |||
| ISA10 | 1…1 | 4/4 | Required. Interchange time in 4 char HHMM format. | 1420 | |||
| ISA11 | 1…1 | 1/1 | Required. This value is dependent on X12 version.
| ^ | |||
| ISA12 | 1…1 | 5/5 | Required. Interchange control version number. This could be any X12 version. | 00501 | |||
| ISA13 | 1…1 | 9/9 | Required. Interchange Control Number mapping to file control header. | 0000000000619827 | |||
| ISA14 | 1…1 | 1/1 | Required. Interchange level acknowledgment requested. Valid values:
| 0 | |||
| ISA15 | 1…1 | 1/1 | Required. Indicates whether the interchange is for production, test, or information purposes. Valid values:
| P | |||
| ISA16 | 1…1 | 1/1 | Required. Component element separator. Delimiter that separates data elements within a composite data structure. Must be different than the data element separator and segment terminator. | > | |||
| GS | 1…* | - | Required. GS group functional envelope. Child of ISA. Only one GS group expected per interchange. | - | |||
| GS01 | 1…1 | 2/2 | Required. GS group function code. Valid value:
| SO | |||
| GS02 | 1…1 | 2/15 | Required. Application Sender's Code. | 2222224043588 | |||
| GS03 | 1…1 | 2/15 | Required. Application Receiver's Code. | TRACELINK | |||
| GS04 | 1…1 | 8/8 | Required. Current date stamp in 8 char X12 date format YYYYMMDD. | 20250615 | |||
| GS05 | 1…1 | 4/8 | Required. Current time stamp in 6 char X12 time format HHMMSS. | 142000 | |||
| GS06 | 1…1 | 1/9 | Required. Group Control ID Number. | 619827 | |||
| GS07 | 1…1 | 1/2 | Required. Responsible Agency Code. Valid values:
| X | |||
| GS08 | 1…1 | 1/12 | Required. X12 message version code. This could be any X12 version. | 005010 | |||
| ST | 1…* | - | Required. ST transaction set envelope. Child of GS group. Only one ST transaction expected. | - | |||
| ST01 | 1…1 | 3/3 | Required. Transaction set identifier code. | 353 | |||
| ST02 | 1…1 | 4/9 | Required. Transaction set ID number. Counter for each ST segment beginning with 1. | 0001 | |||
| M10 | 0…1 | - | Required. Customs events advisory details beginning segment. | - | |||
| M1001 | 0…1 | 2/4 | Required. Standard Carrier Alpha Code (SCAC) of the carrier that will receive the bill of lading. | SCAC | |||
| M1002 | 0…1 | 1/2 | Required. Code specifying the method or type of transportation for the shipment. Valid list of values can be referred from mentioned enum list. Valid values:
| J | |||
| M1003 | 0…1 | 2/3 | Country code. | US | |||
| M1004 | 0…1 | 1/8 | Vessel Identifier. | 2ABC | |||
| M1005 | 0…1 | 2/28 | Mapping for M1005 for transport method ocean. Ocean vessel name. For transport method rail, this would be the train identifier for land border crossings. The carrier that crossed the border assigns the train identifier. | UN2343 | |||
| M1006 | 0…1 | 2/30 | M1006 mapping to voyageIdentifier for voyage, trip or flight identifier for truck or ocean shipments. | UN2343 | |||
| M1007 | 0…1 | 1/80 | Manifest identification number mentioned by carrier. | 123212332 | |||
| M1008 | 0…1 | 1/15 | Numeric value of quantity - used for number of bills lading. | 10 | |||
| M1009 | 0…1 | 1/1 | It identifies the type of shipment manifest transmitted. | B | |||
| M1010 | 0…1 | 1/1 | Vessel code providing agency code. Valid values :
| B | |||
| M1011 | 0...1 | 1/1 | It indicates if the transmission involves an in-bond participant. A "Y" indicates it does; an "N" indicates it does not.
| "Y | |||
| M1012 | 0…1 | 1/80 | Shipment manifest identifier for transport method TRUCK mapping to truckManifest, if available. If not available and transport method = truck, generate manifest identifier with date time stamp YYYYMMDDHHMMSSNNN. | 123212332 | |||
| M1013 | 0...1 | 2/2 | Transaction Set Purpose Code. (missing or bad snippet) | - | |||
| M1014 | 0...1 | 2/2 | It defines the business context or classification of the load tender. Valid values:
| 39 | |||
| P4 | 0…1 | - | Port or terminal Function details. | - | |||
| P401 | 1...1 | 1/30 | Required. Port location identifier using CBP Port Codes (Census Schedule D) in the US and UN/ECE Recommendation No. 16: UN/LOCODE in the rest of the world. Pass thru mapping. | 87859652 | |||
| P402 | 1...1 | 8/8 | Required. Estimated datetime of arrival in date format YYYYMMDD or datetime format YYYYMMDDTHHMMSS:nnnZ if time available in external format. | 20261210 | |||
| P403 | 0...1 | 1/15 | Numeric value of quantity - used for number of bills lading. | - | |||
| P404 | 0...1 | 1/30 | Port location identifier using CBP Port Codes (Census Schedule D) in the US and UN/ECE Recommendation No. 16: UN/LOCODE in the rest of the world. Pass thru mapping. | 12493 | |||
| P405 | 0…1 | 4/8 | P405 is the estimated time of arrival for P402. | 11445966 | |||
| CM | 0…1 | - | Cargo Manifest information To identify specific flight or voyage information for multimodal shipments. | - | |||
| CM01 | 0…1 | 2/30 | Identifying designator for the particular flight or voyage on which the cargo travels. | XY13 | |||
| CM02 | 0…1 | 1/1 | Location function code for the port or terminal. Valid values:
| 5 | |||
| CM03 | 0…1 | 2/24 | Free-form name for the place at which an offshore carrier originates or terminates (by transshipment or otherwise) its actual ocean carriage of property. | Sacramento | |||
| CM04 | 0…1 | 8/8 | Date of manifest performed at port or terminal date in date format YYYY-MM-DD or. | 2026-05-14 | |||
| CM05 | 0…1 | 1/17 | Number assigned by the carrier for space reservation. | XY13 | |||
| CM06 | 0…1 | 2/4 | Carrier code for shipper. | SCAC | |||
| CM07 | 0…1 | 2/4 | Previous Carrier code for shipper. | SCAC2 | |||
| CM08 | 0…1 | 8/8 | Manifest Date. | - | |||
| CM09 | 0…1 | 2/28 | Name of ship as documented in "Lloyd's Register of Ships". | XY1345SD | |||
| CM10 | 0…1 | 1/4 | Identifying number for the pier. | MNJ9056 | |||
| CM11 | 0…1 | 2/14 | Free-form name of the pier. | USA | |||
| CM12 | 0…1 | 2/30 | Free-form field for terminal name. | CANADA | |||
| CM13 | 0…1 | 2/2 | Standard State/Province as defined by appropriate government agency. | ML | |||
| CM14 | 0…1 | 2/3 | Country Code. | US | |||
| CM15 | 0…1 | 1/80 | Describes the vessel agent number. | XY1345SD | |||
| CM16 | 0…1 | 2/2 | Code indicating that the transaction set contains information which corrects previous information. | XY13 | |||
| CM17 | 0…1 | 1/2 | Transport method type. Valid values:
| J | |||
| M15 | 1…9999 | - | Required. Line item details for customs events advisory details, required. To notify Customs of in-bond cargo movement or of a conveyance arrival or departure, or of transfer of custodial liability when an in-bond movement involves multiple legs. | - | |||
| M1501 | 1…1 | 1/2 | Required. There are different types of notifications sent to customs either by in-bond or departure ship. Valid values:
| 8 | |||
| M1502 | 1…1 | 1/80 | Required. For cargo arrival or export notifications or transfer of liability, M1502 can be an in-bond number, bill of lading number or container ID. For conveyance arrival and departures, M1502 will contain the voyage or trip number. | XGFH1234MNGH | |||
| M1503 | 1…1 | 8/8 | Required. Date of customs entry date in date format YYYY-MM-DD. | 2026-05-28 | |||
| M1504 | 0…1 | 1/30 | Location identifier for the port of transaction or entry. | ML | |||
| M1505 | 0…1 | 2/4 | Standard Alpha Carrier Code (SCAC) for the carrier that issued the Bill of Lading. | SCAC | |||
| M1506 | 1…1 | 4/8 | Required. Time of customs entry in time format HHMMSS. | 102256 | |||
| M1507 | 0…1 | 2/15 | Unique number on seal used to close a shipment. | SEAL5674 | |||
| M1508 | 0…1 | 1/80 | Internal Revenue Service identification number of the next in-bond carrier. | BOL3452 | |||
| M1509 | 0…1 | 2/4 | Standard Carrier Alpha Code (SCAC) of the next in-bond carrier. | SCAC | |||
| M1510 | 0…1 | 2/30 | City. | NEWYORK | |||
| M1511 | 0…1 | 2/2 | State or region code. | CN | |||
| M1512 | 0…1 | 1/1 | It indicates if the upcoming port is intermediate port or final destination identified through M1504 location.
| Y | |||
| M1513 | 0…1 | 2/3 | Transaction reference type for X12 segments REF and N9 and EDIFACT RFF for general reference data that is not a transaction document identifier.
| MB | |||
| M1514 | 0…1 | 1/80 | Transaction reference identifier value as defined by enum in transactionReferenceType. | MBOL5463 | |||
| M1515 | 0…1 | 2/28 | Name of ship as documented in "Lloyd's Register of Ships" | MAERSK | |||
| M1516 | 0…1 | 1/2 | Transport method type. Valid values:
| J | |||
| M1517 | 0…1 | 1/30 | Place of cargo from FIRMS system, transfer of liability or conveyance arrival or departure. | USA | |||
| M1518 | 0…1 | 8/8 | Date the border was crossed by the shipment transport. | 2026-05-28 | |||
| M1519 | 0…1 | 4/8 | Time the border was crossed by the shipment transport. | 102256 | |||
| M7A | 0…22 | - | Original seal numbers on equipment to be replaced any a new seal number. Used by US CBP for the USA-Canada in-transit program for rail. Also used for ocean transport. | - | |||
| M7A01 | 1…1 | 2/15 | Required. Original seal number to be replaced. | 3212312 | |||
| M7A02 | 1…1 | 2/15 | Required. Replacement seal number. | 4567DFG | |||
| M7A03 | 0…1 | 8/8 | Date seal number is changed or replaced in date format YYYY-MM-DD. | 2026-05-28 | |||
| M7A04 | 0…1 | 2/3 | Code identifying an organizational entity, a physical location, property or an individual related to the seal. Valid values:
| CA | |||
| M7A05 | 0…1 | 1/60 | Free form name. | 3212312 | |||
| M7A06 | 0…1 | 1/80 | Free form description. | XYZ45SDF | |||
| M7A07 | 0…1 | 1/3 | Code indicating a location on a piece of equipment, as observed from the rear-end. The rear-end of the equipment is based on the equipment type (i.e. container door, chassis wheels, brakes.). (missing or bad snippet) | C | |||
| V1 | 0…1 | - | Vessel identifier information . | - | |||
| V101 | 0…1 | 1/8 | Vessel Identifier. | 3212312 | |||
| V102 | 0…1 | 2/28 | Name of ship as documented in "Lloyd's Register of Ships". | MAERsk | |||
| V103 | 0…1 | 2/3 | Ship/Vessel registered country code. | US | |||
| V104 | 0…1 | 2/30 | Voyage identifier on which the cargo travels. | BHFG45678 | |||
| V105 | 0…1 | 2/4 | Identifies Ocean Carrier SCAC code. | SCAC | |||
| V106 | 0…1 | 1/1 | Vessel requirement code. Valid values :
| F | |||
| V107 | 0…1 | 2/2 | All valid and available type of vessels. Valid values:
| BD | |||
| V108 | 0…1 | 1/1 | Vessel code providing agency code. Valid values :
| B | |||
| V109 | 0…1 | 1/2 | Transport method type. Valid values:
| J | |||
| V2 | 0…1 | - | Routing information associated with the conveyance movement. | - | |||
| V201 | 0…1 | 1/30 | Vessel registered locationIdentifier. | DFGH3212312 | |||
| V202 | 0…1 | 1/80 | Vessel registered identifier. | 212312 | |||
| V203 | 0…1 | 1/10 | Weight of vessel. | 21.98 | |||
| V204 | 0…1 | 1/1 | Type of weight recorded. Valid values:
| E | |||
| V213 | 0…1 | 1/60 | Vessel Name. | MAERSK | |||
| V214 | 0…1 | 1/8 | Largest horizontal dimension of an object measured when the object is in the upright position. | 50 | |||
| V215 | 0…1 | 2/2 | Unit of measure for the measurement type and value recorded.
| EA | |||
| V216 | 0…1 | 1/15 | It is the number of vessels. | 20 | |||
| V217 | 0…1 | 1/15 | It is the number of passengers. | CA | |||
| MEA | 0…1 | - | Specifies physical measurements for shipment, including weights, dimensions, tolerances, variances, and weights. | - | |||
| MEA01 | 0…1 | 2/2 | Measurement Reference ID code, valid values:
| AK | |||
| MEA02 | 0…1 | 1/3 | Code identifying a measurement type for a measurement value. (missing or bad snippet) | DP | |||
| MEA03 | 0…1 | 1/20 | Measurement value - The value of the measurement. | 12324 | |||
| MEA04.1 | 1…1 | 2/2 | Marks and numbers used to identify a shipment or parts of a shipment
| CA | |||
| K1 | 0…4 | - | Free form text details part of line item. | - | |||
| K101 | 1…1 | 1/30 | Required. Free test string. | 3212312 | |||
| K102 | 0…1 | 1/30 | Free test string. | CA | |||
| SE | 1…1 | - | Required. ST … SE transaction set trailer envelope. Child of GS group. Only one ST transaction expected. | - | |||
| SE01 | 1…1 | 1/10 | Required. Total count of segments in ST … SE transaction set including ST and SE segments. | 10 | |||
| SE02 | 1…1 | 4/9 | Required. Transaction set control number. | 0001 | |||
| GE | 1…1 | - | Required. GS … GE functional group trailer envelope. Child of ISA interchange. Only one GS group expected. | - | |||
| GE01 | 1…1 | 1/6 | Required. Number of transaction sets in functional group. | 5 | |||
| GE02 | 1…1 | 1/9 | Required. Functional group control number. | 619827 | |||
| IEA | 1…1 | - | Required. ISA … IEA interchange control trailer envelope. Only one interchange expected per transmission. | - | |||
| IEA01 | 1…1 | 1/5 | Required. Number of functional groups in interchange. | 1 | |||
| IEA02 | 1…1 | 9/9 | Required. Interchange control number. | 0000000000619827 | |||
ISA*00*authorizat*00*securityIn*16*SENDER1 *14*RECEIVER1 *260616*1428*U*00401*000000263*1*T*:~
GS*SO*2222224043588*TRACELINK*20260616*142811*619827*X*005010~
ST*353*0001~
M10*SCAC*R*US*2ABC*UN2343*20260616*000001*28*B*L*Y**16*44~
P4*87859652*20260616*36**14281112~
CM*XY13*5*Sacramento*20260616*XY13*SCAC*UPSC**XY1345SD*MNJ9*USA*CANADA*ML*US*XY134SD**J~
M15*R*XGFH1234MNGH*20260616*ML*SCAC*14281112*SEAL5674*BOL3452*SCAC*NEWYORK*CN*Y*MB*MBOL5463*MAERSK*J*USA*20260616*14281112~
M7A*3212312*4567DFG*20260616*CA*3212312*XYZ45SDF*C~
V1*3212312*MAERSK*US*BHFG45678*SCAC*F*CT*B*J~
V2*DFGH321231*2*21.98*K*********MAERSK*86.12*EA*88.13~
MEA*AF*DP*91*CA~
K1*freeForm*Text2~
SE*10*0001~
GE*5*619827~
IEA*1*100111111~
Tag end


