Using The Timatic CLI Mainframe Application
Using The Timatic CLI Mainframe Application
The purpose of this document is to explain to users the latest Timatic software
development and Timatic structure.
Timatic has been redeveloped to ensure the consistency making it easier for check-in
agents understand the responses given as the relevant information will always be
displayed in the same order and place.
Contents
Timatic structure................................................................................................................ 2
Full Text structure ............................................................................................................ 3
Example - Timatic Full Text response: .......................................................................... 4
Specific Database structure .............................................................................................. 5
Visa information............................................................................................................. 6
Departure Warning ........................................................................................................ 7
Examples of TIMATIC Specific Database responses.................................................... 8
Health information ....................................................................................................... 10
Example - TIMATIC Health response:......................................................................... 10
Miscellaneous queries..................................................................................................... 11
TIRULES: Timatic Rules.............................................................................................. 11
TIRGL: Timatic Groups................................................................................................ 13
Links: Improved in TIMATIC Specific Database ............................................................. 14
NEW: TIBACK Command ............................................................................................... 15
Appendix 1 Passport section format ............................................................................... 16
Appendix 2 Visa section format....................................................................................... 17
Appendix 3 TIBACK Example 1 ...................................................................................... 18
TIBACK Example 2...................................................................................................... 19
Timatic structure
Basic Principles
Full Text
A Full Text query returns a complete, up-to-date display of the topic requested. This
topic may be defined by country and section and/or subsection (see Full Text structure).
Specific Database
Miscellaneous
There are also miscellaneous queries comprising of News, Rules ("Terms &
Definitions"), Group lists and City/Country code tables.
Each country listing consists of seven sections, some of which have sub-sections. There are
minor changes (such as to the ordering of sub-sections) compared with Timatic.The Full Text
responses are returned for TIDFT commands, or via the Menu/Keywords.
Two subsections were removed from the Visa (VI) section: Re-Entry Permit (RP) and Exit
Permit (EP).The newly added access codes for subsections appear in bold red below.
The sections and subsections are (section and subsection codes appear in brackets):
1. Geographical information (GE)
2. Passport (PA)
a. Passport Exemptions: (PT)
b. Document Validity: (VA)
c. Admission and Transit Restrictions: (RE)
d. Crew Members: (CR)
e. Military: (ML)
f. Additional Information: (AI)
g. Minors: (MI)
h. Warning: (WA)
i. Notes: (NO)
3. Visa (VI)
a. Visa Exemptions: (VS)
b. TWOV (Transit Without Visa): (TW)
c. Merchant Seamen: (SE)
d. Crew Members: (CR)
e. Military: (ML)
f. Visa Issuance: (IS)
g. Additional Information: (AI)
h. Minors: (MI)
i. Compulsory Currency Exchange: (CO)
j. Warning: (WA)
k. Notes: (NO)
4. Health (HE)
a. Exempt from Yellow Fever vaccination: (EM)
b. Recommended: (RC)
c. Warning: (WA)
d. Notes: (NO)
5. Tax (TX)
6. Customs (CS)
a. Import: (IM)
b. Arms and Ammunition: (AA)
c. Wild Fauna and Flora: (WF)
d. Additional Information: (AI)
e. Export: (EX)
f. Crew Members: (CR)
g. Pets: (PE)
h. Baggage Clearance: (BC)
i. Exempt: (EM)
j. Notes: (NO)
7. Currency (CY)
a. Import: (IM)
b. Export: (EX)
c. Notes: (NO)
TIDFT/GB
TIMATIC-3 / 17MAR08 / 1445 UTC
ALL SECTIONS FULL TEXT FOR: UNITED KINGDOM (GREAT BRITAIN) (GB)
PASSPORT ********
PASSPORT REQUIRED.
PASSPORT EXEMPTIONS:
- HOLDERS OF IDENTITY CARDS ISSUED BY THE GIBRALTAR
AUTHORITIES TO "BRITISH CITIZENS" AND "BRITISH OVERSEAS
TERRITORIES CITIZENS". NOTE THAT THESE CARDS HAVE A RED
STRIPE AND MAY BE VALID ON ARRIVAL.
- HOLDERS OF NATIONAL ID CARDS ISSUED TO NATIONALS OF
New: clear paragraph AUSTRIA, BELGIUM, BULGARIA, CYPRUS, CZECH REP., ESTONIA,
structure is preceded FINLAND, FRANCE, GERMANY, GREECE, HUNGARY, ITALY, LATVIA,
by Subsection headers LIECHTENSTEIN, LITHUANIA, LUXEMBOURG, MALTA, MONACO,
NETHERLANDS, POLAND,[…]
- HOLDERS OF A "LAISSEZ-PASSER", WHILST TRAVELLING ON DUTY,
ISSUED BY:
- THE UNITED NATIONS;
- THE EUROPEAN UNION.
[…]
DOCUMENT VALIDITY:
- PASSPORT AND/OR PASSPORT REPLACING DOCUMENTS MUST BE VALID
New: paragraph FOR THE PERIOD OF INTENDED STAY.
indentation. Paragraphs - EXPIRED BRITISH PASSPORT (NO TIME LIMIT) ENDORSED "BRITISH
are bulleted to aid clarity CITIZEN" IS ACCEPTED. […]
and to indicate separate
information. Paragraph ADMISSION AND TRANSIT RESTRICTIONS:
numbering removed - SINCE JULY 3, 2003, PASSPORTS ISSUED BY SOMALIA ARE NOT
RECOGNISED, IRRESPECTIVE OF WHEN THEY WERE ISSUED.
(SEE NOTE 29908)
A new system of Notes is NOTE 29908: THEY ARE ONLY PERMITTED ENTRY IF HOLDING A
introduced, showing the "DECLARATION OF IDENTITY FOR VISA PURPOSES" (ALSO KNOWN AS
Note right under the A "FORM GV3"), ISSUED BY A BRITISH CONSULATE OR HIGH
paragraph referencing it COMMISSION. IT IS A SINGLE SHEET DOCUMENT SHOWING PHOTO AND
PERSONAL DETAILS. AT THE BOTTOM OF THE FORM THERE IS SPACE
FOR THE APPROPRIATE VISA. THIS FORM SHOULD BE USED FOR
ENTRY TO/TRANSIT THROUGH THE UNITED KINGDOM. THE FORM MUST
BE ENDORSED WITH A VALID VISA.
- AS OF JANUARY 1, 2008 THE "N" SERIES PASSPORTS ISSUED BY
IRAQ AS THESE WERE CANCELLED BY THE IRAQI GOVERNMENT AND
ARE THEREFORE NO LONGER BE VALID FOR TRAVEL, REGARDLESS THE
DATE OF ISSUE OR EXPIRY.
CREW MEMBERS:
- OPERATIONAL CREW: PASSPORT AND CREW MEMBER IDENTIFICATION
CARD REQUIRED. […]
The following describes the way Specific Database responses are constructed:
- Specific Database responses are returned only for TIRV, TIRA and TIRH
commands, or via the Menu (TIFV/TIFA).
- Only the Passport, Visa and Health sections are included in the responses, which
are always formatted as defined below. None of the other Sections or sub-sections is
used.
Passport information;
Visa information;
Health information - for requests including Health; (TIRA/TIRH commands).
- Unlike Full Text responses, no section headers are displayed in SD responses (e.g.
“Passport” or “Visa”).
Whereas Full Text responses always contain a section and/or subsection header
(e.g. “Document Validity:”), these are not always displayed for SD responses
(see: Examples of TIMATIC Specific Database responses).
Passport information
In each Timatic Specific Database request, Visa information always follows Passport
information, separated by a blank line. Visa section information is displayed according to
the format outlined in the Appendix 2.
Timatic always returns a consistent format for Visa section information. (This is different
from Timatic 2 where variable formatting and ordering was the case). There are three
possible rules that will be returned from a Timatic Specific Database Visa request. They
are:
SD command: TIRV/NAFR/DEFR
SD command: TIRV/NANL/DERU
SD command: TIRV/NAUS/DEIN
A correct interpretation of the third case is that, unless the condition is met (in this case
the passenger holds a PIO card) a visa is required.
Since October 1st 2007, the US government requires all nationals departing the US to
hold a (valid) passport, or certain specific passport replacing documents. Although
passengers might not require a passport to enter a certain country, they will require a
(valid) passport to depart the USA. Therefore a departure warning for the US has been
added to those WHTI affected countries that do not require a passport.
TIRV/NAUS/DEMX
TIMATIC-3 / 18JUN08 / 0914 UTC A US citizen can enter Mexico
NATIONAL U.S.A. (US) /DESTINATION MEXICO (MX) with a birth certificate but will
require a (valid) passport to depart
VISA DESTINATION MEXICO (MX) the USA; hence a departure
warning has been added
...... NORMAL PASSPORTS ONLY ......
PASSPORT REQUIRED.
- PASSPORT AND/OR PASSPORT REPLACING DOCUMENTS MUST BE VALID
ON ARRIVAL.
- WARNING: IF DEPARTING FROM THE U.S.A., A (VALID) PASSPORT
WILL BE REQUIRED BY THE U.S. IMMIGRATION AUTHORITIES. FOR
FULL LISTING OF ACCEPTED DOCUMENTS TIRULES/R9
PASSPORT EXEMPTIONS:
- NATIONALS OF U.S.A. HOLDING AN ORIGINAL (OR NOTARIZED COPY
OF) COUNTY OR STATE-ISSUED BIRTH CERTIFICATE.
- NATIONALS OF THE U.S.A. HOLDING A VOTER'S REGISTRATION CARD.
- NATIONALS OF THE U.S.A. HOLDING AN ORIGINAL (OR A CERTIFIED
COPY OF) COUNTY OR STATE-ISSUED BIRTH REGISTRATION PAPERS.
- ACCEPTED PASSPORT REPLACING DOCUMENTS ISSUED TO NATIONALS OF
U.S.A. MUST BE ACCOMPANIED BY AN OFFICIAL GOVERNMENT ISSUED
PHOTO ID, TIDFT/MX/PA/PT/ID29880
The examples below are provided to illustrate how Timatic 3 builds responses for the
Specific Database queries and to show the output format:
TIRV/NAES/DENL
New formatting introduced, showing TIMATIC-3 / 21MAY08 / 0948 UTC
structured responses, condensed to fit NATIONAL SPAIN (ES) /DESTINATION NETHERLANDS (NL)
terminals even with a limited number of lines
VISA DESTINATION NETHERLANDS (NL)
MINORS:
- CHILDREN UP TO / INCLUDING 15 YEARS OF AGE AND TRAVELLING
WITH PARENT OR GUARDIAN, TIDFT/NL/VI/MI/ID19672
WARNING:
- EFFECTIVE FROM APRIL 1, 2008, UP TO/INCL. SEPTEMBER 30,
New: clickable links, taking the user directly 2008: AIRLINES FLYING FROM THE FOLLOWING AIRPORTS TO THE
to the paragraph, eliminating the need to NETHERLANDS: ABUJA INTERNATIONAL, BANJUL INTERNATIONAL,
scroll the Full Text! CAIRO INTERNATIONAL, DAMASCUS INTERNATIONAL, HAVANA JOSE
MARTI INTERNATIONAL, HONG KONG INTERNATIONAL, ISTANBUL
Links need only be followed if the situation ATATURK, KUALA LUMPUR INTERNATIONAL, LAGOS MURTALA
is relevant MUHAMMED INTERNATIONAL, MEXICO CITY INTERNATIONAL, NAIROBI
JOMO KENYATTA, SAO PAOLO GUARULHOS, SINGAPORE CHANGI, ST.
PETERSBURG PULKOVO, TEHERAN IMAM KHOMEINI.
TIDFT/NL/VI/WA/ID31996
SCAN COMPLETE
ALL visa exemptions applicable to the VISA REQUIRED, EXCEPT FOR HOLDERS OF BRITISH PASSPORTS
query are shown, each one of them PROVIDED HOLDING:
starting with VISA REQUIRED, - PASSPORT ENDORSED "BRITISH CITIZEN"(MAX. PERMITTED STAY 6
EXCEPT FOR MONTHS);
- PASSPORT WHICH CLEARLY ESTABLISHES RIGHT OF ABODE IN THE
UNITED KINGDOM(MAX. PERMITTED STAY 6 MONTHS);
- IN ADDITION TO THEIR PASSPORT, ALTERNATIVE DOCUMENTARY
Paragraphs are bulleted with a hyphen to EVIDENCE TO ESTABLISH RIGHT OF ABODE IN THE UNITED
aid clarity and to indicate separate KINGDOM,TIDFT/NZ/VI/VS/ID27071
information. - PASSPORT ENDORSED "BRITISH NATIONAL (OVERSEAS)"(MAX.
PERMITTED STAY 3 MONTHS).
VISA REQUIRED, EXCEPT FOR HOLDERS OF AN APEC BUSINESS TRAVEL
CARD. THE BACK OF THE CARD MUST STATE IT IS VALID FOR TRAVEL
TO NEW ZEALAND.
MINORS:
- MINORS ENTERING NEW ZEALAND TIDFT/NZ/PA/MI/ID18845
ADDITIONAL INFORMATION:
- ALL PASSENGERS (EXCEPT RESIDENTS OF TOKELAU) MUST OBTAIN A
Use clickable links only when the PERMIT TO ENTER TOKELAU TIDFT/NZ/VI/AI/ID9503
information applies to your passenger! - VISITORS MUST HOLD VALID DOCUMENTS PERMITTING RE-ENTRY INTO
COUNTRY OF ORIGIN OR ENTRY INTO THE COUNTRY TO WHICH THEY
For example, if a passenger is not a Minor INTEND TO PROCEED.
– you do not have to read - ALL VISITORS MUST, ON ARRIVAL, BE ABLE TO PRODUCE ONWARD
TIDFT/NZ/PA/MI/ID18845 TICKETS TO A COUNTRY TO WHICH THEY CAN SHOW THEY HAVE A
RIGHT OF ENTRY TIDFT/NZ/VI/AI/ID9505
- ON ARRIVAL, VISITORS WILL BE EXPECTED TO HAVE THE MEANS TO
MAINTAIN THEMSELVES WHILST IN NEW ZEALAND AND
TIDFT/NZ/VI/AI/ID9506
WARNING:
- NON-COMPLIANCE WITH VISA REQUIREMENTS WILL RESULT IN REMOVAL
OF PASSENGER TO COUNTRY OF ORIGIN AT CARRIER'S EXPENSE AND
COULD RESULT IN PROSECUTION OF CARRIER.
SCAN COMPLETE
The responses in the Health section have changed only to the extent that for clarity,
headers have been introduced into the text, making responses more consistent and
readable.
TIRH/EMAO/DEAF
TIMATIC-3 / 02MAY08 / 1001 UTC
EMBARKATION ANGOLA (AO) /DESTINATION AFGHANISTAN (AF)
SCAN COMPLETE
=>
When executing a TIRULES command, the user will be presented with an overview of
the paragraphs containing “Rules, Terms & Definitions” of Timatic
In Timatic the numbering convention has been changed to allow for three digit rules.
This gives more flexibility and structuring of rules information (e.g. TIRULES/R211).
Importantly, the ordering of Rules in Timatic is dynamic, depending on the changes and
additions that are made.
TIRULES
TIMATIC-3 / 02JUN08 / 1010 UTC
RULES
When executing a TIRGL command, the user will be presented with an overview of
groups in Timatic. In addition to already existing groups in Timatic, new groups
containing four letters (appearing in red and bold below) have been introduced.
TIRGL
TIMATIC-3 / 03JUN08 / 1318 UTC
Timatic makes use of links to refer to additional information that might, in certain cases,
be relevant to a particular query.
Timatic groups link information closely within the relevant section or subsection
In addition, a link takes the user directly to the paragraph referenced, eliminating the
need to review text to reach a certain paragraph. Timatic also makes more widespread
use of links to ensure that the most concise and relevant information is displayed.
Links can be present in any sections or subsection of Timatic 3. The user can simply
“click” on the link to view the relevant information. For examples of links, see Examples
of TIMATIC Specific Database responses
It should be noted that it is not necessary to follow (view) the link if it does not apply to
the traveller. For example, if there’s a link appearing in subsection Minors, the user only
needs to follow it when dealing with Minors. The use of links saves the user valuable
time by only having to read the most relevant information and only having to follow the
link in the specific cases.
A new command, TIBACK is introduced in Timatic the purpose of the TIBACK command
is to allow a user to navigate back to the results of the previous TIMATIC command, if
required.
TIBACK is functional system wide and when entered will execute the command before
last (executed by the same user in that session).
Please note: it is only possible to use the TIBACK command after previously executing
at least two commands in a session.
The main benefit of TIBACK is that it allows a user who has followed a link to go back to
the previous page viewed if they wish.
For example, looking at the TIRV/NAES/DENL command in the example on page 10, we
see a link to information regarding minors (TIDFT/NL/PA/PT/ID19470). If the user
decides to use the link, then, after viewing the information about minors, use of the
TIBACK command will take the user back to the previous page. i.e. TIRV/NAES/DENL.
TIBACK Example 1
A Somali minor is travelling with his parents and an agent would like to have more
information:
TIRV/NASO/DEGB
TIMATIC-3 / 18JUN08 / 1038 UTC
NATIONAL SOMALIA (SO)
DESTINATION UNITED KINGDOM (GREAT BRITAIN) (GB)
TIRV/NAUS/DEAF
TIMATIC-3 / 18JUN08 / 1233 UTC
NATIONAL U.S.A. (US) /DESTINATION AFGHANISTAN (AF)
VISA REQUIRED.
ADDITIONAL INFORMATION:
- VISA NOT REQUIRED FOR THOSE, IRRESPECTIVE OF NATIONALITY,
WHO ARE BORN:
- IN AFGHANISTAN; If the passenger is a woman,
- TO PARENTS WHO ARE NATIONALS OF AFGHANISTAN;
- TO PARENTS WHO ARE BORN IN AFGHANISTAN BUT ARE NOT
the following link could be
NATIONALS OF AFGHANISTAN. selected
- VISITORS MUST HOLD RETURN OR ONWARD TICKETS AND ALL
DOCUMENTS REQUIRED FOR THEIR NEXT DESTINATION AND SUFFICIENT
FUNDS FOR THEIR MAINTENANCE.
- WOMEN OF ALL NATIONALITIES TIDFT/AF/VI/AI/ID35
- TOURISTS AND JOURNALISTS ARE ADVISED TO REPORT ON ARRIVAL TO
THE TOURIST BUREAU, PRESS DEPARTMENT, KABUL.
- ALIEN RESIDENTS AND TOURISTS WHOSE VISA HAS BEEN EXTENDED
If the agent now selects the link (TIDFT/AF/VI/AI/ID35) the following information will be
displayed:
=>TIDFT/AF/VI/AI/ID35
TIMATIC-3 / 18JUN08 / 1233 UTC
VISA FULL TEXT FOR: AFGHANISTAN (AF)
ADDITIONAL INFORMATION:
- WOMEN OF ALL NATIONALITIES SHOULD COVER THEIR BODY WITH
CLOTHING, EXCEPT FOR THE FACE, HANDS AND FEET, DURING THEIR
STAY IN AFGHANISTAN.
If the agent wishes to return to the earlier entry that command does not need to
be repeated because entering TIBACK will return to the original command:
TIRV/NAUS/DEAF
TIMATIC-3 / 18JUN08 / 1233 UTC
NATIONAL U.S.A. (US) /DESTINATION AFGHANISTAN (AF)
VISA REQUIRED.
ADDITIONAL INFORMATION:
- VISA NOT REQUIRED FOR THOSE, IRRESPECTIVE OF NATIONALITY,
WHO ARE BORN:
…………
…………