Skip to content

OCI line Mapping

OCI line in messaging standards

CIMP standard introduced the OCI line (Other Customs, Security and Regulatory Control Information) which was later used by CXML standard. It was later improved with the addition of e-CSD mapping and further customs requirements such as EU ICS2 or US ACAS.

Structure of the OCI line in Messaging standards

The OCI line is a set of data fields that are used to convey Customs or Security information with messaging standards CIMP and CXML. It is a combination of:

  • ISO Country Code: Country Code as per ISO Country code list
  • Information Identifier: An identifier based on Code List 1.19 "Line Identifiers" where only a handful of codes are used for the purpose of OCI information
  • Security and Regulatory Control Information Identifier: An identifier based on Code List 1.100 "Customs, Security and Regulatory Control Information Identifier"
  • Supplementary Security and Regulatory Control Information: A free text field containing the details

Within one message multiple OCI segments can be used to convey as enough information as required.

Structure of the OCI in ONE Record

In order to simplify the mapping between messaging standards and ONE Record, it was decided that the CustomsInformation object replicates the OCI segment structure.

The CustomsInformation object contains the following data properties (in addition to the ones inherited by the superclass LogisticsObject):

  • ociLineNumber: integer used to identify the sequence of the object
  • country: mapped to ISO Country Code
  • subjectCode: Mapped to Information Identifier
  • contentCode: Mapped to Security and Regulatory Control Information Identifier
  • otherCustomsInformation: Mapped to Supplementary Security and Regulatory Control Information

Purpose of ociLineNumber

The order of the OCI line matters in messages. Due to its structure a line can contain only limited information (specific combination of the identifiers and the content). It is sometimes necessary to ensure that two lines are in the right sequence in order to understand the meaning of the information.

The ociLineNumber data property is then used to replicate the order from messages and allow for back and forth conversion between ONE Record and messages.

OCI Composition Rules table

The OCI Table is available in CXML Toolkit publication as well as published in IATA website here.

The OCI Table presents all the recognized combinations of the OCI data properties in order to convey the right information.

With ONE Record all requirements on Security Declaration are already taken care of with the usage of dedicated SecurityDeclaration object and a few specific data properties at Piece level, more details can be found on the Data Model part of the specifications.