Skip to main content

Standards

To facilitate integration and ensure data integrity, some standards have been defined and are followed throughout the entire API.

Date and Time with Time Zone​

Some examples:

2019-10-15T22:35:12-03:00
2018-05-01T13:32:11+00:00
2019-05-01T00:00:00+00:00

It is represented according to ISO 8601. In this case, the time zone is placed right after the time and must represent the time zone of the location where that data is valid. For example, if a rental is scheduled to start at 09:30 at Brasília airport, the time sent must be represented as 09:30-03:00. If the rental is scheduled to start at 09:30 in Manaus, it must be represented as 09:30-04:00.

The validation mask used is the following:

YYYY-MM-ddThh:mm:ss±hh:mm

Date and Time without Time Zone​

Some examples:

2019-10-15T22:35:12Z
2018-05-01T13:32:11Z
2019-05-01T00:00:00Z

It is represented according to ISO 8601. Data that does not depend on a time zone must be sent without it, always in UTC, with the letter Z indicating that the data is in UTC. Therefore, the following format will be validated:

YYYY-MM-ddThh:mm:ssZ

Date​

Some examples:

2019-10-15
2019-01-01
2017-03-20

For fields that accept only a date, such as a birthdate, only the date should be sent, without any time, using the following format:

YYYY-MM-dd

Documents​

Since document numbers can vary greatly and many of them contain non-numeric characters, all document numbers are defined as strings. Another important reason to define them as strings is to prevent leading zeros from being lost. Documents listed on this page have a well-defined mask and will be subject to validation. Other documents, such as RG, due to their lack of standardization, will not be validated.

CPF​

Examples of CPFs valid against the defined mask:

123.456.789-12
321.987.543-23
111.283.333-00

Examples of CPFs invalid against the defined mask:

8.577.477-8
08.104.627/0001-23
123.456.789-1
23.456.789-01

The CPF is always defined as a string and will be validated against the mask:

###.###.###-##

CNPJ​

Examples of CNPJs valid against the defined mask:

08.104.627/0001-02
01.079.210/0114-67
32.402.502/0001-35

Examples of CNPJs invalid against the defined mask:

8.577.477-8
123.456.789-12
321.987.543-23
32.402.502/0001-3
032.402.502/0001-3

The CNPJ is always defined as a string and will be validated against the mask:

##.###.###/####-##