Skip to main content

Parcel Status Codes

A parcel is the file-level container transmitted between trading partners on ECGrid. Each parcel wraps one or more EDI interchanges. Parcel status tracks where the file is in the transmission lifecycle — from receipt or queueing through final delivery or archival.

For status codes at the interchange level (individual EDI transactions), see Interchange Status Codes.

InBox States​

Inbound parcels are files that have arrived at your mailbox from a trading partner or carrier.

StatusDescription
InBoxReadyThe parcel file has been received and is available for download. Your system has not yet retrieved it. Polling your inbox will return this parcel.
InBoxTransferredThe parcel file has been successfully downloaded by the recipient. A download confirmation (confirm-download) should follow to acknowledge receipt.
InBoxArchivedThe parcel has been moved to long-term archive storage after a successful confirmed download. It is no longer returned in standard inbox queries.

OutBox States​

Outbound parcels are files queued for delivery from your mailbox to a trading partner or carrier.

StatusDescription
outboxPendingThe parcel has been accepted by ECGrid and is queued for outbound transmission. No delivery attempt has been made yet.
outboxSentECGrid has transmitted the parcel to the next hop (carrier, VAN, or trading partner endpoint). Awaiting delivery confirmation.
outboxAcknowledgedThe receiving party has confirmed successful receipt of the parcel. This is a terminal success state.
outboxRetryThe initial delivery attempt failed. ECGrid will automatically retry according to its retry schedule. The parcel is not yet permanently failed.
outboxFailedAll delivery retry attempts have been exhausted. The parcel could not be delivered. Manual investigation and possible resend are required.
outboxDeliveryErrorA delivery error occurred during transmission. This is a transient error state that may resolve to outboxRetry or outboxFailed.
outboxTransferredThe parcel has been handed off to a downstream carrier or VAN for final leg delivery. ECGrid's direct responsibility has ended.

Channel-Specific States​

These states indicate both the direction and the communication channel used for the parcel.

StatusDescription
as2ReceiveThe parcel was received over an AS2 channel. Indicates inbound AS2 traffic.
as2SentThe parcel was delivered over an AS2 channel. Indicates successful outbound AS2 delivery.
ftpReceivedThe parcel was received over an FTP or SFTP channel. Indicates inbound FTP/SFTP traffic.
ftpSentThe parcel was delivered over an FTP or SFTP channel. Indicates successful outbound FTP/SFTP delivery.

Special States​

StatusDescription
CancelledThe parcel was explicitly cancelled before delivery completed. All interchanges within the parcel are also cancelled. No further processing will occur.
VaultReadyThe parcel has been stored in the ECGrid Vault for long-term compliance archiving. It can be retrieved via vault queries but is no longer in the active inbox or outbox.

Parcel vs. Interchange Status​

ConceptScopeUse Case
Parcel statusThe entire fileTracking file-level transmission (upload, download, delivery)
Interchange statusIndividual EDI transaction within the fileTracking EDI-level routing and acknowledgment

A single parcel may contain multiple interchanges. The parcel may reach outboxAcknowledged while individual interchanges inside it are still being processed for functional acknowledgment (997/999).

Lifecycle Overview​

Inbound parcel (your mailbox receives):

as2Receive / ftpReceived
    → InBoxReady
    → InBoxTransferred  (after download)
    → InBoxArchived     (after confirm-download)

Outbound parcel (your mailbox sends):

outboxPending           (after upload)
    → outboxSent
    → outboxAcknowledged   (success path)

outboxPending
    → outboxSent
    → outboxRetry          (transient failure)
    → outboxFailed         (permanent failure — requires manual action)

See Also​