跳到主要内容

标准

为便于集成并保证信息完整性，整个 API 遵循以下已定义的标准。

带时区的日期和时间​

一些示例：

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

按照 ISO 8601 表示。在这种情况下，时区紧跟在时间之后，必须表示该数据有效的地点的时区。例如，如果租约计划在巴西利亚机场于 09:30 开始，发送的时间应表示为 09:30-03:00；如果租约计划在马瑙斯于 09:30 开始，则应表示为 09:30-04:00。

用于验证的掩码如下：

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

不带时区的日期和时间​

一些示例：

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

按照 ISO 8601 表示。与时区无关的数据应不带时区发送，始终以 UTC 表示，字母 Z 表示该数据为 UTC。因此，将验证以下格式：

YYYY-MM-ddThh:mm:ssZ

日期​

一些示例

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

对于只接收日期的字段（例如出生日期），应不包含任何时间，使用以下格式发送：

YYYY-MM-dd

文件编号​

由于文件编号差异很大，且许多文件编号包含非数字字符，因此所有文件编号均定义为字符串。将其定义为字符串的另一个好理由是避免前导零消失。本页中预定义的文件编号具有明确的掩码，需经过验证。其他文件编号（如 RG）由于缺乏标准化，将不进行验证。

CPF​

针对已定义掩码验证的有效 CPF 示例：

123.456.789-12
321.987.543-23
111.283.333-00

针对已定义掩码验证的无效 CPF 示例：

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

CPF 始终定义为字符串，并将针对以下掩码进行验证：

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

CNPJ​

针对已定义掩码验证的有效 CNPJ 示例：

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

针对已定义掩码验证的无效 CNPJ 示例：

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

CNPJ 始终定义为字符串，并将针对以下掩码进行验证：

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