Troubleshooting
Find the thing you are seeing, read what it means, and do what the last column says. Nothing on this page requires technical knowledge.
If you have to report a problem, note the exact wording of any message, the reference it shows (a long string of letters and digits), the screen you were on and roughly when it happened. That is usually all the ITS team needs.
Signing in
| What you see | What it means | What to do |
|---|---|---|
| Invalid username or password | The user name and password do not match | Type them again carefully. Five failures in a row lock the account for a minute, and each further lockout lasts a minute longer, up to fifteen. It unlocks itself; wait before trying again |
| A code is asked for after your password | Your installation signs people in with a second step | Type the code from your authenticator app or from the e-mail ITS sent you. See The second step |
| You have lost the phone with your authenticator app | Your second step cannot be given | On the code page, choose to try another way and use one of your recovery codes, or have a code e-mailed to you. If neither works, ask your organisation's administrator to reset your second factor (see Reset a person's second factor). See The second step |
| Your old recovery codes no longer work. after Change my second step | You changed your second step, and new recovery codes replaced the old ones | Keep the new codes the sign-in service gave you |
| Changing your second step is not available here. | This installation does not use a second step at sign-in | Nothing; sign in with your password alone |
| No invitation e-mail arrived | It may be in the spam folder, or the address on your account is not the one you are watching | Check spam, then ask your administrator which address the account carries |
| The invitation link has expired | Invitation links work once, for a limited time, which the Secretariat sets as Invitation link lifespan on Settings | Use Forgot password? on the sign-in form |
| Sign-in is unavailable / The sign-in service did not respond, so the console cannot open. | The portal could not reach the sign-in service | Select Try again after a few minutes. If it keeps happening, tell your administrator |
| Sign in takes you straight in, without a password | The sign-in service still holds your earlier session | Normal on your own computer. On a shared one, always finish with Sign out |
| After signing in you land on System integration | That is the Secretariat's starting page, and a partner technical contact's | The Secretariat selects Overview or Declarations in the header. A technical contact works here. See System integration |
| A plain 404 Not Found page with no ITS header | The address you typed or reloaded ends like a file name, such as .pdf or .json, and is not a file of the portal | Use your browser's back button or open the portal's home address. See Known limitations |
| You are back on the landing page without asking | Your session ended after a period without activity | Sign in again. See Your session and signing out |
Not allowed, or not there
The portal shows you only what your account may use.
| What you see | What it means | What to do |
|---|---|---|
| A tab or an area is missing | Your account does not include it | See What each role can do. Ask your administrator if you need it |
| You do not have access to this area / Ask the Secretariat to check the role on your ITS account. | You opened the address of a screen your account may not use, such as Governance, Roles, Audit trail, Consortium ledger or the declaration form | Nothing is broken. Go back, or ask for the role if you need the screen |
| A section of Settings is missing, or it has no Change button | Everybody reads Settings; only the Secretariat changes it, and Operations is shown only to administrators | Nothing. Ask the Secretariat if a rule or limit needs changing. See Settings |
| Not available / No declaration with this serial number is visible to your administration. | The declaration does not exist, or it is outside your scope. ITS will not say which | Check the serial number. If it is right, the declaration belongs to another administration's scope |
| Page not found, under the console header | A link inside the console led to a page that does not exist | Select the way back to your workspace on the page |
| No Attach documents box on the Attachments tab | Your account does not hold the Customs officer role, which attaching needs | Nothing. Attaching is done by your customs system |
Finding declarations
| What you see | What it means | What to do |
|---|---|---|
| Nothing to show in the register | Nothing in your scope matches your filters or your search | Select Clear filters and try part of the serial number |
| A declaration you expected is missing | It is outside your scope, or the serial number is mistyped | Check the number with whoever gave it to you |
| Created shows a different day from the date in the serial | The serial uses ITS's clock in UTC; Created uses your browser's time zone, named in the column heading | Nothing. Both are right |
| Released at destination, awaiting discharge | The destination released the goods inland to reach an inland office, and has not closed the transit yet | Nothing. The discharge follows |
| An Overdue tag on a declaration | It is still open after its transit window closed and the Secretariat's grace ran out | Follow it up with the country named under Held by |
| A declaration is past its transit window and has no Overdue tag | It is still within the grace the Secretariat allows, Grace before a transit counts overdue on Settings | Nothing; the tag appears when the grace has run out |
| Discharged, with Closed by ITS — destination not on ITS; not evidence of arrival | The destination has no system on ITS, so ITS closed the transit itself after the last transit stamp | Do not read it as proof that the goods arrived. Ask the destination's administration if you need that |
| Position unavailable under Cargo tracking | The consignment has an electronic seal, but the integrated cargo tracking system has no position for it, does not know the seal, or could not be reached | Nothing. The customs stamps are unaffected, and ITS will ask again later |
| Waiting for outbound transport to be configured under Who has been told | The announcement is queued until ITS can send it. It is not lost, and not a failure | Nothing on the declaration. If it stays queued for long, report it with the serial number |
| History does not match after Check ledger | The previous version this one names is not the one in the declaration's history | Do not rely on the document. Report it with the serial number and the version |
| Not on the map, the register has no position for them yet: and office codes, under the Custody map | Those customs offices have no latitude and longitude in the register | An administrator of the office's country adds its position in Customs offices. See The office's position |
| 1–20 of 10,000+ declarations | The register stops counting at 10,000 | Nothing. Narrow the list with the filters, or page on with Next |
| Selecting Overdue now opens the full register rather than an overdue list | Your account cannot read the Register reports, where the overdue worklist lives | Ask for a role with the Register reports, or filter the register yourself |
Public pages
| What you see | What it means | What to do |
|---|---|---|
| That is not a full code | Fewer than 26 characters were typed | Check the code under the QR code and type all of it |
| No match on Verify | No document has that code | Check the code. A code that never matches was not issued by ITS |
| No match on Track | The serial number or the TIN is wrong, or the TIN is not the declarant's or the consignee's | Check both against the document |
| A message under a Track field when you select Track | That field is empty or not in the expected form | Fill both fields as the message says |
| Times on Track differ from the officer's by a few hours | Track shows stamp times in UTC, as its heading says | Nothing; the order is right |
Figures that look wrong
| What you see | What it means | What to do |
|---|---|---|
| Discharged differs from the funnel's Discharged | They count differently: the funnel follows only declarations registered in the period | Quote the one that answers your question, and say which |
| Discharged on time reads —, or no rows | No transit deadline in the period has passed yet. A deadline counts only once its day has ended in UTC and the Secretariat's grace has run out | Choose a period that has ended |
| Lost handovers is 0 although goods left a country and have not entered the next | A handover counts as lost only after the declaration's transit deadline and the grace have passed | Nothing; until then the goods are in transit |
| A REC's figures leave out a member | Only members that have delegated filing to the REC count, and only while the delegation is in force | Ask the Secretariat to check the delegation. See Governance |
| A notice saying requests from your system were refused, sometimes tagged Urgent | Your customs system's calls were refused. Each kind of refusal gets one notice a day, kept up to date as more arrive. Urgent means it can hold up cargo | Select the notice: it opens Failed transmissions on those refusals. Pass the error code and the correlation ID to the team that runs your system |
| A declaration your system sent was refused for its HS code or for being over a limit | New declarations need an HS code of 8 to 12 digits, and must stay within the limits under Declarations on Settings | Correct the declaration in your customs system and send it again |
| Tracked consignments: 0 on the map | The integrated cargo tracking system has no position for any consignment in your scope | Nothing to do in the portal |
| Reconnecting… instead of Tracked consignments on the Overview map | The map's live connection dropped. The last positions it had stay on the map | Nothing. The portal reconnects by itself, waiting a little longer each time, at most thirty seconds |
| Not counted yet. This period's figures are still being recounted; check again later. under Officers on duty | ITS has not finished recounting that period | Check again later |
| 1–20 of 10,000+ notifications | The notification centre stops counting at 10,000 | Nothing. Use the filters, or page on with Next |
Messages and loading
| What you see | What it means | What to do |
|---|---|---|
| The seal over a moving bar, grey placeholder rows or Loading… | The portal or the page is still loading. Some pages take fifteen seconds | Wait. If nothing arrives after half a minute, reload |
| A message in the corner of the screen with Reference: and a string of letters and digits | A request failed | Note the wording and the reference, reload and try again. If it persists, report it |
| Some readings are unavailable on the Overview | One or more tiles could not load | Select Try again; the rest of the page is current |
| Could not load declarations | The register could not be read | Reload. If it persists, report it with the reference |
| Still there? with a countdown | You have been inactive; you will be signed out | Select Stay signed in |
Settings, System integration and the ledger
| What you see | What it means | What to do |
|---|---|---|
| Give the longitude too, or clear the latitude (or the other way round) when saving a customs office | An office's position needs both figures or neither | Fill in both, or clear both |
| Request failed when the Secretariat saves a change on Settings | The setting already has a value recorded for exactly that day and time, even a withdrawn one. Each setting holds one value per start moment | Choose another time or day. See Change a setting |
| Choose a moment at least 1 minute from now when the Secretariat schedules a change on Settings | A change can never start in the past, and must start at least one minute ahead | Set a later time or day. See Change a setting |
| An amber striped band reading SANDBOX · TEST PLAYGROUND | You are on the Sandbox side of your integration workspace. Nothing sent there reaches a customs authority | Use the Environment switch to move to Live, once the Secretariat has approved Live access |
| A receiving endpoint stays Awaiting approval | ITS calls it only once the Secretariat approves it | Ask the Secretariat to review it. See Announcements to your system |
| The ledger could not be read on Consortium ledger | The ledger did not answer, or the installation is not connected to one. Declarations are not affected | Open the page again after a while. If it persists, report it with the reference under the message |
| Older activity is archived on the Audit trail | From or To is earlier than the period the screen reads | Choose a more recent date range |
Getting help
- For a problem with your customs system's connection to ITS, see Support and Errors and troubleshooting.
- For your account, ask your organisation's administrator.