Skip to main content

Bring a colleague on board

Who this is for: administrators at the Secretariat, a State Party or a REC.

What you will achieve: a new colleague who can sign in to the ITS portal and sees the screens their job needs, and no more.

Before you start: you need a role that manages users. See What each role can do.

1. Collect the details​

You needWhy
First and last nameShown in the portal. Both are required.
Work e-mail addressThe set-password e-mail goes here. You can change it later.
UsernameWhat they sign in with. You cannot edit it later.
Phone number (optional)Choose the country first, or type the number starting with its dialling code, such as +256.
Staff ID (optional)Their number in your administration's own records.
What the job isDecides the role (step 2).
For a customs officer, their border post's country and station codeRecorded as a duty station (step 4).

2. Choose the role​

Give the least that lets them do the job. Rights are easy to add and awkward to take away.

The colleague willGive them
Administer your organisation's users and customs offices, and read everything for your countriesOrganisation admin (only the Secretariat can give it)
Look after your system's connection to ITSPartner (only the Secretariat can give it)
Stamp declarations as a customs officerCustoms officer
Amend or cancel your country's declarationsDeparture authority (State Parties only)
Govern ITS for the AfCFTA SecretariatSecretariat admin (Secretariat only)

The Roles list offers only the roles your organisation may give, so a State Party administrator sees Customs officer and Departure authority, and a REC administrator Customs officer. Roles meant for systems are never offered. See What each role can do.

Most declaration work is done by your customs system

ITS is used system to system: your national customs system lodges and stamps declarations through the ITS API. A Customs officer role in the portal lets a person read declarations and two report areas. It does not give them a button to stamp.

3. Create the account​

  1. Open Users & roles.
  2. Select Add user and fill in First name, Last name, E-mail address and Username, and Phone and Staff ID if you have them. See Users.
  3. Pick the role from step 2 under Roles.
  4. Select Add user.

A User created message confirms it and says "An invitation to set a password has been sent to" their address. The sign-in service e-mails your colleague a link to choose their password. Tell them to look out for it, including in their spam folder, and to use it soon: the link works for a limited time, which the Secretariat sets on Settings. If it has expired, they use Forgot Password? on the sign-in form.

If the address already had an account, the message says it "was linked to an existing identity" instead, and no set-password e-mail is sent: your colleague signs in as they already do.

4. Record their duty station (customs officers)​

  1. Select the new colleague's row to open their panel.
  2. Under Duty stations, select Add.
  3. Type the Country and Station codes of their border post (for example UG and BUS). From is optional; left empty, ITS dates the posting itself.
  4. Select Record posting. A Posting recorded message confirms it.

A duty station is a record of who works where. It does not change what the person can stamp.

5. Check it worked, with them​

Ask your colleague to sign in, then check together:

  1. The header. They should see the items their role allows. If Reports is missing for a Customs officer, the role is wrong.
  2. All areas. Everybody has Customs offices and Settings under Administration. An Organisation admin also has Users & roles and System integration under Administration, and Consortium ledger under Oversight. See What each role can do.
  3. The data. On Reports, the sentence You are reading … should name your organisation's countries.
  4. A screen they need. Have them open the one they will use most.

The Roles column on Users should now show the role you gave.

When somebody leaves or changes job​

  • Changing job: open the ⋮ menu on their row and select Edit to change their roles on Users. Roles you cannot give stay on the account, listed under Also holds, which you may neither grant nor remove. If those are the only roles the person holds, the Roles box reads None you can change. Add one….
  • New e-mail address: change E-mail address in the same Edit user window. It takes effect at once, and becomes their username too if their username was their address. Nobody is e-mailed about the change, so tell them.
  • Moving post: under Duty stations, Withdraw the old posting and record the new one.
  • Leaving: select Deactivate in the ⋮ menu on Users. They lose access at once and stay in the list as deactivated; nobody is deleted. You cannot deactivate yourself, and the last Organisation admin of an organisation cannot be deactivated, so make sure somebody else holds it first.