1. Customs Filing Integration Guide
  2. Customs Filing Statuses

Customs Filing Statuses

Statuses are a good way to trace where a declaration, or the associated filing document, is in the lifecycle of the filing process. Global Trade Management Cloud by default has a set of status types and values on the filing document that are specific to the AES filing process. These status types and values are listed below.

SHIPMENT_CUSTOMS_STATE: Indicates the state of the declaration that the document is associated with. Indirectly, it indicates the submission state of the filing document. This status type has the status values:

  • New: Declaration has not been filed yet.
  • Update: Declaration has been modified after filing at least once.
  • Cancel: Declaration has been cancelled after filing at least once.

CUSTOMS_FILING_GENERATION: Indicates the generation status of the filing document. This status type has the status values:

  • Not Generated: Document has not yet been generated.
  • Generated: Document has been generated.

CUSTOMS_FILING: Indicates the status of the filing process. This status type has the status values:

  • Not Started: Filing process not started.
  • Submitted: Filing document has been submitted.
  • Cancellation Submitted: Cancellation of a prior filing has been submitted.
  • Replacement Submitted: Replacement of a prior filing has been submitted.
  • Accepted: Filing response that the filing has been accepted.
  • Accepted Verify: Filing response is conditionally accepted.
  • Replaced: Filing response that a prior filing has been replaced.
  • Cancelled: Filing response that a prior filing has been cancelled.
  • Compliance: Filing response that filing has compliance problems.
  • Rejected Fatal: Filing response that filing has been rejected with fatal errors.
  • Rejected Warning: Filing response that filing has been rejected with warnings.

When you generate a document, using the Generate Document action on a declaration, the status value for CUSTOMS_FILING_GENERATION is set to Generated.

When you transmit the filing document, for the very first time, the status value for CUSTOMS_FILING is set to Submitted. When a response is received from AES, the status value is set to indicate the response result.

If you want to modify a declaration, after its filing document has been submitted and want to re-file the export declaration for the declaration, first you must run the action Update Shipment Custom State, which sets SHIPMENT_CUSTOMS_STATE to Modified, and CUSTOMS_FILING_GENERATION to Not Generated. Next, you must re-generate the filing document by running the Generate Document action, which sets the status value for CUSTOMS_FILING_GENERATION to Generated. Finally, you must run the File Customs action to transmit the modified filing document, which sets the status value for CUSTOMS_FILING to Replacement Submitted or Cancellation Submitted, based on the intent of modifying the declaration.

You can define your own customs status types and values to indicate other conditions that you might be interested in or when filing with other regimes.