Validating ACI messages

When you send an eManifest message to the border protection agency, the agency checks the message for syntactical errors, and for completeness and correctness of information. eManifest contains two functions to help you prepare error-free messages before you send them. These functions are available as buttons, and as options under the Edit menu:

image1

  • Validate Only

    Validate Only checks for missing or outdated information, and displays a report in the Validation Results window. The purpose of the report is to direct you to the appropriate order or trip data so you can make corrections.

    You should repeat the process of validation and correction until the Validation Results window does not report any errors. Validation may report information items; these are not errors, but you should still investigate and correct them as needed.

  • Validate and Send

    The main purpose of Validate and Send is to transmit eManifest messages to the border protection agency. Validate and Send begins by checking for errors, but the check serves more as a final confirmation.

    Note that some items are time-critical, so a trip that passed validation a day or two before can generate an error later. For example, validating a trip that begins a few days late can cause an error because the truck misses the scheduled arrival for the border crossing.

The ACI Validation Results window

The Validation Results window displays the results of a Validate Only or Validate and Send operation.

image2

Fields in this window are read-only.

Field Definition

UserName

The ID of the user logged in to eManifest

Ico

An icon representing the error level.

  • image3a Information

  • image3b Warning

  • image3c Critical

ErrorLevel

A description of the severity of the error

  • Information
    The informational issue will not prevent the message from being accepted by the border protection agency. You should still investigate the issue before transmitting the message.

  • Warning
    A warning will not necessarily prevent the message from being accepted by the border protection agency. You should investigate and correct the issue before transmitting the message.

  • Critical
    A critical error will cause the message to be rejected by the border protection agency. You must locate the issue and correct it before you transmit the message.

ErrorSource

The Message data (freight, driver, etc.) where the error exists.

For most errors, you can select a Message data section and inspect the field in question. You can then decide whether to correct the error in the order (preferred), or in the eManifest window.

ErrorText

A detailed description of the error.

This information is usually sufficient to pinpoint the field responsible for the error.

Critical Only

Select this checkbox to limit the validation results to warnings and critical errors.

To simplify making corrections, the Validation Results window contains Export and Print buttons. Use these to make an electronic or print copy of the validation results for reference.

  • Print
    Sends the report to your default Windows printer.

  • Export
    Saves the report as a Microsoft Excel file.

Validating an ACI message without sending

When you are ready to validate a message, perform these steps:

If you validate a 309 Complete or 309 Preliminary message, where the truck enters the US empty, errors will result, even though all required ACE information is recorded. Use a 358 Trip Info message or 358 Update message instead.
  1. With an order loaded into eManifest, select the type of message you want to validate. This selection determines the types of information the system validates, and what types of information it ignores.

    image4

  2. Click Validate Only or select Edit > Validate Only.

    image1

    The Validation Results window opens.

    • If there are no critical errors, warnings, or information items, the Validation Results window is blank.

      image5

      If you want to send the message now, click Close, and continue with Validating and sending an ACI message.

      Note: An informational item should not cause a transmitted message to be rejected.

    • If the window displays errors:

      • The Ico and ErrorLevel fields indicate the severity of the error (Critical, Warning, or Information).

      • The ErrorSource field indicates the part of the order or trip containing the error.

      • The ErrorText field describes the error.

        image6

  3. Review the Validation Results window.

    Notes:

    1. To limit results to critical errors and warnings, select the Critical Only checkbox.

    2. To record the window contents for reference, click Export or Print.

  4. Click Close.

  5. Correct errors by opening the order externally in your order entry or dispatch application, or by correcting them directly within the eManifest window.

    • To open an order externally, you do not need to close eManifest, but you will need to reload the modified order into eManifest.

    • If you edit a field in eManifest that also exists on an order, your changes will appear in transmitted messages, but will not automatically be written back to the order. Be sure to update the actual order as soon as possible.

  6. Reload the order into eManifest if needed, and revalidate for the desired message type.

  7. Repeat Steps 1-6 until the Validation Results window does not display any critical errors or warnings.

  8. Continue with Validating and sending an ACI message.

Validating and sending an ACI message

When you are ready to transmit a message, perform these steps:

  1. With a previously-validated, error-free order loaded into eManifest, select the type of message you want to send.

    image4

  2. Click Validate and Send or go to Edit > Validate and Send.

    image1

    The Validation Results window opens.

    eManifest validates the message and displays the Validation Results window.

    image7

    • If there are no critical errors or warnings, click Close.

      eManifest automatically transmits the message and displays a confirmation for the sent message type.

      image8

      Click OK. You are finished sending the ACE message.

    • If the Validation Results window contains critical errors or warnings, click Print or Export to record the window contents for reference.

      image9

  3. Click Close.

    The system displays a message noting that errors and warnings exist, and asks whether you want to continue sending the message:

    image10

    Do one of the following:

    • It is strongly recommended you click No; correct critical errors and warnings, and revalidate the message. See Validating an ACI message without sending.

    • To transmit the message anyway, click Yes. The system transmits the message as-is, and displays a confirmation message.

      image11

      Click OK.

      Notes:

      1. Sending a message containing critical errors or warnings can result in the message being rejected, or can cause delays or other problems when the truck reaches the border crossing location.

      2. An information item will not cause a message to be rejected.

      3. The confirmation may indicate the message was "successfully created." This does not confirm correctness or acceptance of the message contents.