Skip to main content

Statuses and colours

ITS says a lot with small coloured tags. This page lists them, exactly as they are written on screen, and explains what each one tells you.

How the colours are used​

ColourUsed for
GreenIn order: arrived, verified, tracked, genuine, acknowledged
AmberMovement or attention: departed, transited, needs attention, Overdue now on the Overview, a position that could not be read
GreyClosed or for information: discharged, for information, a connection state
RedWithdrawn, wrong or urgent: cancelled, Overdue on a declaration, an urgent notice, an urgent failed transmission, a document that does not match, an announcement that could not be delivered
Outlined (no fill)Nothing has happened yet, or no claim is made: registered, unsigned, no electronic seal
Never read the colour alone

Every tag also carries its wording, and two states share a colour: Departed and Transited are both amber. Read the words; the colour is only a shortcut.

A missing value is shown as an em dash, —, never as a blank.

Declaration states​

TagColourMeaning
RegisteredOutlinedLodged at the office of departure. The goods have not moved
DepartedAmberReleased to run inland, towards a border it has not reached. Not "left the country". At the destination it reads Released at destination, awaiting discharge
TransitedAmberBetween administrations: stamped transit from one country, not yet stamped in by the next
ArrivedGreenA country's office of entry recorded the goods in its territory. Not only the destination
DischargedGreyThe transit is closed. Final. Normally the destination closed it with its discharge stamp. Where Closed by ITS — destination not on ITS; not evidence of arrival stands beside the tag, ITS closed the transit itself when the goods left the last country connected to ITS, because neither the next country nor the destination has a system on ITS: nobody recorded the goods arriving
CancelledRedWithdrawn by the departure country before any country stamped its transit. Final

A state the portal does not recognise is shown outlined, with its name as ITS sent it, such as Issued or Exited on an old version. A version signed before the Exit→Transit rename, whose record says In transit, is shown as Transited.

On a declaration's fact strip, a red Overdue tag beside Time in transit means the declaration is still open after its transit window closed and the grace the Secretariat allows has run out. The grace is Grace before a transit counts overdue on Settings.

Held by reads:

Held byMeaning
A country's nameThat country recorded the goods and has not stamped them out. A note Declared next to another country names where the goods go next, once it has been named
Between administrationsNobody holds the goods. The note says between whom, for example Transit stamped in Kenya, no Uganda entry stamp, or Awaiting a Uganda entry stamp
Nobody — transit closedThe transit is discharged or cancelled. The note reads Discharged in the country that closed it, Cancelled, or Closed by ITS after the transit from a country when ITS closed it after that country's transit stamp

Under Corridor, a country the goods were sent to that recorded nothing, although a later country did, reads with (no stamps) after its name.

In the Lifecycle card, a filled green dot is a state reached, an empty circle one not reached yet, and an amber ring the current state. See How ITS works.

Stamps​

In the Corridor tab's Stamp register, every stamp is a small green tag:

TagThe act
DepartureThe declaration was lodged at the office of departure
ReleaseThe goods were released to run inland
TransitThe goods left the country; the next country is named
EntryThe goods were recorded at a country's border
DischargeThe destination closed the transit

Custody and corridor​

MarkMeaning
Filled green dot on the corridor lineA country the goods have passed through, Passed
Amber dotWhere the goods are now, Here now
Empty circle, with a dashed line into itA country named next that has not stamped entry, Between administrations or Declared next
Empty circleA country the goods have not reached yet, Not yet reached
Entry stamp expected · Declared next: UGITS is waiting for that country's entry stamp
A country's name · No stamps recorded, with "Named next by" one country; "the next stamp came from" anotherThe goods were sent to that country, it stamped nothing, and the transit carried on in a later country
Closed by ITSThe act that closed a transit ITS could follow no further, after the transit stamp of the last country connected to ITS. It is not a customs stamp

The corridor line sits in the Lifecycle card of a declaration's Overview. The Custody card, with its map and stamp trail, is drawn only when the integrated cargo tracking system has a position for the consignment.

Guarantee​

The verdict sits under Guarantee in a declaration's fact strip, and on the public Track page.

Shown asColourMeaning
VerifiedGreenThe guarantee platform confirms the reference. Proceed
InvalidRedThe platform says the reference is unknown, expired, exhausted or revoked. Stop the consignment
Declared, unverified (Declared, not verified on the Track page)OutlinedNobody could be asked. The document's claim is unchecked; treat it as a claim
Could not be checkedAmberThe platform did not usefully answer. Nothing has been said either way; make a phone call

Cargo tracking and seals​

TagColourMeaning
TrackedGreenThe integrated cargo tracking system answered and its position is live
No electronic sealOutlinedThe load has a metallic seal, which reports no position. Normal
Position unavailableAmberThere is an electronic seal but no usable answer: the tracking system is not connected yet, did not answer, or does not know this seal

On the public Track page, the seal reads Active, Tampered, Could not be reached, Unknown or No e-seal.

Signature​

TagMeaning
Signed (unverified) (green)The version carries a signature, not yet checked in your browser
Unsigned (outlined)The version carries no signature

After Verify signature: Verified (sealed by AfCFTA ITS), Not verified (the signature does not match), Cannot be checked here (no published key to check against), or Check failed.

Ledger​

Where the installation records versions on the consortium ledger, a declaration's Ledger row reads Not yet checked until you select Check ledger. Your browser then checks the version on screen against the ledger's proof:

TagColourMeaning
In ledger batch NGreenThe version on screen is in the batch the proof names
Being anchoredAmberRecorded; its batch is not on the ledger yet
Not anchoredOutlinedThe version predates anchoring on this installation
Not anchored by this deploymentOutlinedThis installation does not record versions on a ledger
Could not checkOutlinedThe proof could not be checked. It says nothing about the document
Document does not matchRedThe document on screen is not what was anchored. Do not rely on it, and report it
Proof does not reach the batch rootRedThe proof does not hold together. Do not rely on it, and report it
History does not matchRedThe previous version named by this one is not the one in the history. Do not rely on it, and report it

The ledger only records ITS's own versions, so that anyone can later prove they were not altered. On the public Verify page the same fact reads Anchored on the consortium ledger on a day, Being anchored or Not anchored. The row is absent where the installation does not anchor.

Verify page answers​

BoxColourMeaning
Genuine documentGreenIssued through ITS
This transit is closedAmberGenuine, but discharged; it no longer covers goods in movement
This declaration is cancelled / Withdrawn — do not rely on this paperRedIssued, then cancelled
No matchAmberNo such code
That is not a full codeAmberFewer than 26 characters

On a genuine document, the row Electronic seal reads Sealed (green) when ITS signed the version, or Not sealed (grey). It is about ITS's signature, not the seal on the load.

History​

On the History tab, each version carries a tag naming what it was, written as ITS records it, in small letters: issuance, endorsement, state_change, attachment (green) or amendment (grey). An amendment adds the section letters it touched, such as amendment (AB).

Attachments​

Shown asMeaning
Digest verifiedThe downloaded file is the one that was filed
These bytes are not the ones signed forThe file does not match its digest. Do not rely on it
Nothing to check againstNo digest was recorded for this file

Announcements​

On the History tab's Who has been told:

TagMeaning
Acknowledged (green)The administration's system acknowledged the announcement. The line gives the time and the system's own reference
Sent, not yet acknowledged (outlined)Delivered to the administration's system, which has not acknowledged it yet
Queued (outlined)Waiting to be sent. With Waiting for outbound transport to be configured, it waits until ITS can send it; it is not lost
Failed, retrying (red)The last attempt failed; ITS will try again. The line counts the attempts so far
Undeliverable, gave up (red)ITS stopped trying after repeated failures

Every announcement goes straight to the administration's own system, at the receiving endpoint the Secretariat approved.

The list is grouped by version. Only the Secretariat and the country that lodged the declaration see it.

Notifications​

MarkMeaning
Amber dotThe notice needs attention
Grey dotFor information
Tinted backgroundYou have not read it. Mark as read on the row clears it
For informationNothing to do
Needs attentionSomething to act on
Urgent (red tag), with a red edge on the rowSomething that can hold up cargo and needs action now. The red edge stays after you have read the notice
FailingThe same urgency, as it is named in the severity filter and on the notice's own page
Red number on the bellAt least one notice needing attention is urgent. Otherwise the number is amber

Each notice also carries a grey tag naming its subject, such as Rules and limits for a change the Secretariat made on Settings. See Notifications.

Failed transmissions​

MarkMeaning
Urgent (red tag), red edge on the rowThe refusal can hold up cargo: ITS itself failed, a credential was refused, or a request that would have changed a declaration was refused
Needs attention (amber tag), amber edge on the rowAny other refusal, such as a refused request to read
Outlined tag, such as ERR-006The error code
The words after the codeWhat that code means, or Refused where ITS has no description for it

See Failed transmissions.

System integration​

The states of an organisation​

System integration uses one word for an organisation's state on every one of its screens: the register, the Secretariat's review screen and the organisation's own workspace.

TagColourWhere the organisation is
RequestedOutlinedKnown to ITS, not yet onboarded
AdmittedGreyOnboarded; no Sandbox credentials yet
In SandboxAmberSandbox credentials exist; the checks are under way
CertifiedGreenAll four checks passed; waiting for the Secretariat to approve Live access
Live approvedGreenLive access approved; no Live credential yet
LiveGreenLive credentials exist
SuspendedRedSuspended by the Secretariat
WithdrawnOutlinedWithdrawn. Final

On Governance, an organisation's Connection reads Not started when it has no onboarding record, or otherwise a grey tag with the same words, except that Live approved still reads Certified there.

An amber striped band reading SANDBOX · TEST PLAYGROUND across the top of the workspace means you are on the Sandbox side. Live has no band.

Sandbox checks​

In the workspace's Sandbox guide, the first step reads To do or Done, and each of the four checks reads Pending or Success. The register shows the same progress as a count, from 0/4 to 4/4. See Your workspace.

Receiving endpoints​

TagColourMeaning
Awaiting approvalAmberDeclared. ITS does not call it until the Secretariat approves it
ApprovedGreenThe address ITS calls
SupersededGreyReplaced by a later endpoint of the same organisation. Final
DisplacedGreyStood down because another organisation receives for the country, for example a REC filing for a member State. The Secretariat can switch back to it

Users and roles​

TagColourWhereMeaning
ActiveGreenA userThe account can sign in
ProvisioningAmberA userITS is still creating the account in the sign-in service
Provisioning failedAmberA userITS could not finish creating the account in the sign-in service. Somebody has to finish it; it is not a refusal
DeactivatedGreyA userThe account cannot sign in
ActiveGreenA roleThe role can be given and grants its permissions
InactiveGreyA roleThe role is switched off

See Users and Roles and permissions.

Audit trail​

Outcome​

On the Activity tab of the Audit trail, every event carries an Outcome tag, and the left edge of its row has the same colour. A request's tag ends with its response code, such as Not found · 404.

TagColourMeaning
SucceededGreenThe request went through
Up to dateGreenThe request went through; the caller already had the current copy
Signed inGreenA successful sign-in
Not signed inRedRefused because the caller was not signed in
Access deniedRedRefused because the caller's role does not allow it
Server errorRedITS failed while handling the request
Sign-in failedRedA sign-in that did not succeed
Not foundAmberWhat was asked for does not exist
ConflictAmberThe request clashed with the record's current state
RejectedAmberITS understood the request and refused its content
RefusedAmberAny other request that could not be honoured as asked
Signed outGreyA sign-out
Session refreshedGreyA session renewed itself in the background
RedirectedGreyThe caller was sent to another address
RecordedGreyA fact with no verdict: every data change, and any event that carries no result

Session status​

On the Sessions tab, see Sessions:

TagColourMeaning
ActiveGreenNot signed out, and seen in the last 15 minutes
IdleGreyNot signed out, and not seen for more than 15 minutes
Signed outGreyA sign-out was recorded for the session

Consortium ledger​

On the Consortium ledger page:

TagColourWhereMeaning
EndorserGreenRole of a memberThe member signs batches
VerifierOutlinedRole of a memberThe member holds a full copy of the ledger and can check any proof on it, but does not sign batches
Written hereGreenState of a streamThis installation of ITS is the one writing the stream
Halted: and a reasonRedState of a streamThis installation has stopped writing the stream, for the reason shown

A stream with nothing written reads Nothing anchored yet under Latest batch.

Settings​

On Settings, a setting's value carries a green Set by the Secretariat tag when the Secretariat chose it, or a grey Default tag when the built-in value applies. A change already decided is listed with an amber Scheduled tag.

A rule or limit in a History list reads Scheduled (its start moment is still ahead), In force, Ended, Withdrawn, or Overridden by a later limit (or value).

Overview figures​

Overdue now is shown in amber only when it is above zero. A figure that could not be read shows — with Could not be read under it, and is never amber: what failed is the reading, not the corridor. It counts declarations still open after their transit window and the Secretariat's grace. The arrows under each figure compare with the same days of the period before: ▲ higher, ▼ lower. No change reads Unchanged on the days compared, with no arrow.