Skip to main content

System integration

System integration is where an organisation connects its own customs system to ITS, and where the Secretariat follows and approves that connection. A State Party or a REC uses it to get the credentials its system signs in with, to pass the four Sandbox checks, and, once it is in Live, to say where ITS should send announcements. The Secretariat uses it to onboard organisations, to approve Live access and receiving endpoints, and to suspend, restore or withdraw an organisation.

This chapter describes the screens. The process they belong to, from admission to Live, is told step by step in Onboarding. How your system calls ITS is in the Guides.

Before you start​

  • System integration is listed for System admin, Secretariat admin, Organisation admin and Partner (the technical contact). See What each role can do.
  • Anybody else who types its address sees You do not have access to this area: "System integration is for the Secretariat and admitted partners. Partners use one Portal for Sandbox checks and Live access. Ask the Secretariat to check the role on your ITS account."

How to open it​

  1. Select All areas in the console header.
  2. Under Administration, select System integration.

Which screen you land on​

The same entry opens a different screen depending on who you are.

You areYou land onYou can also open
A State Party's Organisation admin or PartnerYour workspace, for your own organisation
A REC's Organisation adminYour workspace, for the RECOrganisations you file for: the register, limited to your REC and the member States it files for, without the Secretariat's buttons
A REC's Partner without Organisation adminYour workspace, for the REC
Secretariat admin or System adminThe register of every organisationThe review screen of any organisation

An organisation's administrator and its technical contact see the same workspace and can do the same things in it. In most organisations one person holds both roles.

Sandbox and Live​

Every organisation has two separate environments, each with its own credentials.

SandboxLive
What it isA test environment. Declarations sent here stay in Sandbox and never reach a customs authorityReal declarations, sent to customs authorities
When it opensAs soon as the Secretariat has onboarded the organisationWhen the organisation has passed all four Sandbox checks and the Secretariat has approved the results
What the workspace showsA step-by-step guide whose steps 3 to 6 are the four checksThe organisation's Live status and Announcements to your system
How to tellAn amber striped band reading SANDBOX · TEST PLAYGROUND across the topNo band

The Environment switch in the workspace header moves between the two. While Live is closed its Live button is greyed out and carries a padlock. Once the Secretariat approves Live access, the workspace opens in Live every time you sign in, and you can still switch to Sandbox at any time. The portal does not remember which side you were on.

The states of an organisation​

An organisation moves through these states. The register, the Secretariat's review screen and the organisation's own workspace all show the same word.

Where the organisation isShown as
Known to ITS, not yet onboardedRequested
Onboarded; no Sandbox credentials yetAdmitted
Sandbox credentials exist; checks under wayIn Sandbox
All four checks passed; waiting for the SecretariatCertified
Live access approved; no Live credentials yetLive approved
Live credentials existLive
Suspended by the SecretariatSuspended
WithdrawnWithdrawn

Two rows deserve a second look:

  • Approving Live access is not the last step. The organisation reads Live approved until it creates its first Live credentials, and only then Live. The register's State filter has no Live approved choice: choose Certified to find those organisations too.
  • The fourth check certifies the organisation by itself. Nobody presses a button to move an organisation from In Sandbox to Certified.

Pages in this chapter​

For a State Party or a REC

For the Secretariat