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
| Colour | Used for |
|---|---|
| Green | In order: arrived, verified, tracked, genuine, acknowledged |
| Amber | Movement or attention: departed, transited, needs attention, Overdue now on the Overview, a position that could not be read |
| Grey | Closed or for information: discharged, for information, a connection state |
| Red | Withdrawn, 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 |
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
| Tag | Colour | Meaning |
|---|---|---|
| Registered | Outlined | Lodged at the office of departure. The goods have not moved |
| Departed | Amber | Released to run inland, towards a border it has not reached. Not "left the country". At the destination it reads Released at destination, awaiting discharge |
| Transited | Amber | Between administrations: stamped transit from one country, not yet stamped in by the next |
| Arrived | Green | A country's office of entry recorded the goods in its territory. Not only the destination |
| Discharged | Grey | The 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 |
| Cancelled | Red | Withdrawn 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 by | Meaning |
|---|---|
| A country's name | That 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 administrations | Nobody 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 closed | The 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:
| Tag | The act |
|---|---|
| Departure | The declaration was lodged at the office of departure |
| Release | The goods were released to run inland |
| Transit | The goods left the country; the next country is named |
| Entry | The goods were recorded at a country's border |
| Discharge | The destination closed the transit |
Custody and corridor
| Mark | Meaning |
|---|---|
| Filled green dot on the corridor line | A country the goods have passed through, Passed |
| Amber dot | Where the goods are now, Here now |
| Empty circle, with a dashed line into it | A country named next that has not stamped entry, Between administrations or Declared next |
| Empty circle | A country the goods have not reached yet, Not yet reached |
| Entry stamp expected · Declared next: UG | ITS 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" another | The goods were sent to that country, it stamped nothing, and the transit carried on in a later country |
| Closed by ITS | The 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 as | Colour | Meaning |
|---|---|---|
| Verified | Green | The guarantee platform confirms the reference. Proceed |
| Invalid | Red | The platform says the reference is unknown, expired, exhausted or revoked. Stop the consignment |
| Declared, unverified (Declared, not verified on the Track page) | Outlined | Nobody could be asked. The document's claim is unchecked; treat it as a claim |
| Could not be checked | Amber | The platform did not usefully answer. Nothing has been said either way; make a phone call |
Cargo tracking and seals
| Tag | Colour | Meaning |
|---|---|---|
| Tracked | Green | The integrated cargo tracking system answered and its position is live |
| No electronic seal | Outlined | The load has a metallic seal, which reports no position. Normal |
| Position unavailable | Amber | There 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
| Tag | Meaning |
|---|---|
| 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:
| Tag | Colour | Meaning |
|---|---|---|
| In ledger batch N | Green | The version on screen is in the batch the proof names |
| Being anchored | Amber | Recorded; its batch is not on the ledger yet |
| Not anchored | Outlined | The version predates anchoring on this installation |
| Not anchored by this deployment | Outlined | This installation does not record versions on a ledger |
| Could not check | Outlined | The proof could not be checked. It says nothing about the document |
| Document does not match | Red | The document on screen is not what was anchored. Do not rely on it, and report it |
| Proof does not reach the batch root | Red | The proof does not hold together. Do not rely on it, and report it |
| History does not match | Red | The 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
| Box | Colour | Meaning |
|---|---|---|
| Genuine document | Green | Issued through ITS |
| This transit is closed | Amber | Genuine, but discharged; it no longer covers goods in movement |
| This declaration is cancelled / Withdrawn — do not rely on this paper | Red | Issued, then cancelled |
| No match | Amber | No such code |
| That is not a full code | Amber | Fewer 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 as | Meaning |
|---|---|
| Digest verified | The downloaded file is the one that was filed |
| These bytes are not the ones signed for | The file does not match its digest. Do not rely on it |
| Nothing to check against | No digest was recorded for this file |
Announcements
On the History tab's Who has been told:
| Tag | Meaning |
|---|---|
| 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
| Mark | Meaning |
|---|---|
| Amber dot | The notice needs attention |
| Grey dot | For information |
| Tinted background | You have not read it. Mark as read on the row clears it |
| For information | Nothing to do |
| Needs attention | Something to act on |
| Urgent (red tag), with a red edge on the row | Something that can hold up cargo and needs action now. The red edge stays after you have read the notice |
| Failing | The same urgency, as it is named in the severity filter and on the notice's own page |
| Red number on the bell | At 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
| Mark | Meaning |
|---|---|
| Urgent (red tag), red edge on the row | The 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 row | Any other refusal, such as a refused request to read |
| Outlined tag, such as ERR-006 | The error code |
| The words after the code | What 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.
| Tag | Colour | Where the organisation is |
|---|---|---|
| Requested | Outlined | Known to ITS, not yet onboarded |
| Admitted | Grey | Onboarded; no Sandbox credentials yet |
| In Sandbox | Amber | Sandbox credentials exist; the checks are under way |
| Certified | Green | All four checks passed; waiting for the Secretariat to approve Live access |
| Live approved | Green | Live access approved; no Live credential yet |
| Live | Green | Live credentials exist |
| Suspended | Red | Suspended by the Secretariat |
| Withdrawn | Outlined | Withdrawn. 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
| Tag | Colour | Meaning |
|---|---|---|
| Awaiting approval | Amber | Declared. ITS does not call it until the Secretariat approves it |
| Approved | Green | The address ITS calls |
| Superseded | Grey | Replaced by a later endpoint of the same organisation. Final |
| Displaced | Grey | Stood 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
| Tag | Colour | Where | Meaning |
|---|---|---|---|
| Active | Green | A user | The account can sign in |
| Provisioning | Amber | A user | ITS is still creating the account in the sign-in service |
| Provisioning failed | Amber | A user | ITS could not finish creating the account in the sign-in service. Somebody has to finish it; it is not a refusal |
| Deactivated | Grey | A user | The account cannot sign in |
| Active | Green | A role | The role can be given and grants its permissions |
| Inactive | Grey | A role | The 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.
| Tag | Colour | Meaning |
|---|---|---|
| Succeeded | Green | The request went through |
| Up to date | Green | The request went through; the caller already had the current copy |
| Signed in | Green | A successful sign-in |
| Not signed in | Red | Refused because the caller was not signed in |
| Access denied | Red | Refused because the caller's role does not allow it |
| Server error | Red | ITS failed while handling the request |
| Sign-in failed | Red | A sign-in that did not succeed |
| Not found | Amber | What was asked for does not exist |
| Conflict | Amber | The request clashed with the record's current state |
| Rejected | Amber | ITS understood the request and refused its content |
| Refused | Amber | Any other request that could not be honoured as asked |
| Signed out | Grey | A sign-out |
| Session refreshed | Grey | A session renewed itself in the background |
| Redirected | Grey | The caller was sent to another address |
| Recorded | Grey | A fact with no verdict: every data change, and any event that carries no result |
Session status
On the Sessions tab, see Sessions:
| Tag | Colour | Meaning |
|---|---|---|
| Active | Green | Not signed out, and seen in the last 15 minutes |
| Idle | Grey | Not signed out, and not seen for more than 15 minutes |
| Signed out | Grey | A sign-out was recorded for the session |
Consortium ledger
On the Consortium ledger page:
| Tag | Colour | Where | Meaning |
|---|---|---|---|
| Endorser | Green | Role of a member | The member signs batches |
| Verifier | Outlined | Role of a member | The member holds a full copy of the ledger and can check any proof on it, but does not sign batches |
| Written here | Green | State of a stream | This installation of ITS is the one writing the stream |
| Halted: and a reason | Red | State of a stream | This 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.