Skip to main content

Failed transmissions

Failed transmissions lists the requests from connected customs systems that ITS refused: a declaration with a missing field, a stamp at the wrong office, a call made with a credential ITS does not accept. It is where you look when your customs system's team says "ITS rejected it", and where the Secretariat sees who is having trouble.

Each refusal is one line. Selecting it opens a panel that says what was wrong, which fields to correct and the reference to quote.

Nothing on this screen changes a declaration. You read it, and pass what it says to the team that runs your customs system.

Before you start​

  • Your account must be able to read declarations. The Secretariat, the administrators of a State Party or a REC, and customs officers can all open this screen. See What each role can do.
  • If you are chasing one refusal, have its correlation ID ready. It is the value your system received in the X-Correlation-ID header of the refused response, and the reference shown in the portal's own error messages.

How to open it​

  • Select Overview, then the Failed transmissions tab.
  • Or open All areas and select Failed transmissions under Operations.
  • Or select a notification about refused requests, in the bell or in the notification centre. The screen then opens already filtered to that problem. See Open it from a notification.

Failed transmissions for the Secretariat: the Correlation ID search, the organisation filter on All organisations, the Serial number and Error code filters, Outcome, the Received From and To dates, and a table with the columns Received, Organisation, Request, Urgency, Refusal and Status, each row with an amber edge and a Needs attention tag; the ninety-day notice sits under the table

What you see depends on who you are​

What you see depends on who you are
You areThe list shows
The SecretariatRefusals of every organisation. The organisation filter beside the search opens on All organisations; choose one to see only its refusals. An Organisation column, and an Organisation line in the panel, say whose request each one was
A State Party or a RECYour own organisation's refusals only. There is no organisation filter and no Organisation column

Failed transmissions for a State Party: the Correlation ID search, the Serial number, Error code, Outcome and Received filters, and the organisation's own refusals in the columns Received, Request, Urgency, Refusal and Status, with no organisation filter and no Organisation column

Read the list​

Rows are newest first, ten to a page.

ColumnWhat it shows
ReceivedThe date and time ITS received the request, in UTC, with how long ago underneath, such as 11 days ago. The coloured edge at the start of the row is its urgency: red for Urgent, amber for Needs attention
OrganisationThe Secretariat only: the organisation whose request it was, by name, with its country's flag or, for a REC, its badge. — when ITS could not tell who was calling
RequestThe method and the address that was called, for example POST /api/v1/etd. A long address is cut short; the panel shows it whole
UrgencyThe Urgent or Needs attention tag
RefusalThe error code, such as VAL-ETD-001, and a short title for it. The title is Refused when ITS has no title for the code
StatusThe HTTP status of the answer, for example HTTP 400

Every column is always shown. When the table is wider than the space it has, for example on a phone or while the panel is open beside it, scroll it sideways inside its box.

Urgent or Needs attention​

Every refusal carries one of two tags.

TagWhenWhat it means for you
Urgent (red)ITS itself failed (status 500 or above); or your system's credential or permission was refused (status 401 or 403); or the refused request was anything other than a read of a declaration, such as lodging one, a stamp, a correction or an attachmentCargo can be held up. Act on it first
Needs attention (amber)Everything else. In practice, a request to read a declaration that found nothing or was badly formedWorth fixing, but no consignment waits on it

Move through the list​

Under the table:

  • Items per page changes how many rows a page holds.
  • The count reads like 1–10 of 1,234 failed transmissions. ITS stops counting at ten thousand, and the count then reads of 10,000+.
  • The Previous and Next arrows move one page at a time, Next towards older refusals. There are no page numbers.

Narrow the list​

The filters sit in one bar above the table. Each one applies as soon as you set it, and they combine.

FilterWhat it doesRules
The organisation filter (the Secretariat only)Shows one organisation's refusals. It opens on All organisationsIt reads Loading organisations… while the list of organisations arrives, and Organisation list unavailable if it cannot be read; the filter cannot then be used
Serial numberShows the refusals of requests about one declarationType the whole serial number, then press Enter or move out of the field. It must match exactly. Lower-case letters are turned into capitals
Error codeShows the refusals with one error code, such as VAL-ETD-001The same: the whole code, then Enter
OutcomeEvery refusal, Lookups or ITS errorsLookups are refused requests to read something. ITS errors are the requests ITS itself failed to handle (status 500 or above)
Received: From and ToThe days counted. They open on the current monthThe days are UTC days, so a refusal in the last hours of the month in your time zone can belong to the next month

To set the period:

  1. Select From.
  2. Select the first day in the calendar.
  3. Select To.
  4. Select the last day.

The list reloads after each choice. A field holding a date reads like From: 01 Oct 2026 and shows an ×; select it to empty the field, which then reads Any date. With only one date set, the list runs from that day onwards, or up to that day. Empty both and the list returns to the current month.

If To is earlier than From, both fields are marked and the bar says The end date cannot be before the start date. Correct one of them.

Clear filters, at the end of the bar, appears while any filter or a correlation ID is set. It removes them all in one step.

The filters are kept in the page's address, so a copied link opens the same view for a colleague in your organisation.

Open one refusal​

  1. Select the row. With the keyboard, move to the row and press Enter or Space.

    A panel headed Failed transmission opens beside the table. Its title is the refusal's title, with its Urgent or Needs attention tag.

    The Failed transmission panel open beside the list for a State Party: the Refusal section with the error code, its title and what to do about it; then Request with Method, Path and Status; Who with Sent by; When with Received and Swept on; and the Correlation ID with its copy button

  2. Read Refusal first: it says what to correct.

  3. To pass the refusal to your technical team, select the copy button beside the Correlation ID. The icon turns to a tick when the ID is copied.

  4. To close the panel, select Close panel at its top, or use the browser's Back button.

SectionWhat it shows
RefusalThe error code and its title, and what to do about it where ITS knows. When particular fields were wrong, the panel lists each field by name, with the reason and, after Sent:, the value your system sent. For ERR-015 the advice above the list reads The affected fields are marked below.
RequestMethod and Path, the address that was called. Route is the general form of that address, shown when it differs. Serial number, Stamp type, Version and Attachment appear when the request named one. Status is the HTTP status and the reason, for example HTTP 400 · INVALID_FIELDS
WhoOrganisation (the Secretariat only, with the flag or REC badge), and Sent by: An integrated system, or A person, in the console
WhenReceived, in UTC to the second, with how long ago; and Swept on, the day ITS will remove this refusal from the list
Correlation IDThe value ITS returned in the X-Correlation-ID header of the refused response. Search your own system's logs for it, and quote it when you ask for help: it names this one request

The Serial number is a link to the declaration, except when the refusal was HTTP 404: a declaration that was not found cannot be opened.

The meaning of every error code is in the error catalogue, and what to do about the common ones is in Errors and troubleshooting.

Look one refusal up by its correlation ID​

  1. Select the search box, which reads Correlation ID — press Enter to look it up.
  2. Paste the correlation ID.
  3. Press Enter.

The table shows every refusal recorded under that ID, on one page, whatever period and other filters are set. There is no page count under a lookup.

The list holds only requests made by connected systems. A lookup is the one exception: the reference shown in one of the portal's own error messages also finds that refusal, and the panel then reads Sent by: A person, in the console.

To return to the list, select Clear filters, or empty the search box and press Enter.

Open it from a notification​

ITS groups the refusals of one kind into one notification: the same request, refused with the same error code, on the same UTC day. See Refused requests.

  1. Select the notification, in the bell or in the notification centre.

    Failed transmissions opens with Error code and Received already set to that problem and day. A grey Route tag in the bar names the request, for example Route /api/v1/etd/{serial_no}. For the Secretariat, the organisation filter is set too.

  2. To see the same error on every request, select the × beside the Route tag. It is labelled Remove the route filter.

The Route tag only appears this way, or from a link that carries it. It cannot be set by hand.

Clear the notifications from here​

While you have unread notifications about refused requests, a blue strip above the list reads, for example, 2 unread notifications about failed transmissions.

  1. Look at the refusals in the list.
  2. Select Mark as read on the strip.

The strip disappears, and those notifications are marked read for you, in the bell and in the notification centre. Nothing changes for your colleagues.

When new refusals arrive​

The screen checks for new refusals about every half minute while it is open. When there are some under the filters you have set, a bar appears above the filters: 3 new failures — show them.

  1. Select the bar.

The list reloads from the newest refusal. The bar does not appear during a correlation ID lookup.

When the list is empty or cannot be read​

What you seeWhat it meansWhat to do
Nothing was refusedNo request was refused in the period. Nothing else is filteredNothing. An older period can also be empty because refusals are kept for ninety days only
Nothing found for that search, after a correlation ID lookupNo refusal carries that IDCheck the ID against the X-Correlation-ID header of the response and, as the Secretariat, that the organisation chosen is the one that made the request
Nothing found for that search, with filters setThe filters match nothingWiden the period, or select Clear filters
Grey placeholder rows under the column headingsThe list is loadingWait a few seconds
An error message in place of the tableThe list could not be readTry again from the message. If it persists, report it with the reference shown, which Copy reference copies; see Troubleshooting

What ITS keeps, and for how long​

A notice under the table says Failed transmissions are swept after ninety days. Each refusal is removed ninety days after it was received; the panel's Swept on gives the day.

  • An empty list means nothing was refused in that period, not that nothing was ever refused.
  • ITS never stores the content of a refused request. It keeps the names of the fields that were wrong and the values that were sent for those fields, which is what your technical team needs to fix it.
  • Credentials and source addresses are stored only in scrambled form and are never shown.