Pular para o conteúdo principal

Objeto Account

A conta é uma entidade organizacional que permite o cadastramento de dispositivos. Está api foi projetada para atender a Normativa 491 do BACEM, logo nos dados da conta são obrigatórios números de agência e conta.

Definição do Objeto Account

Request Body
{
"account_id": "12345678",
"account_type": "natural_person",
"registration_date": "2019-12-11T11:37:15.12-03:00",
"account_data": {
"account_number": "12345678",
"agency_number": "1234"
}
}

Todas as trocas de informação de uma conta utilizam a seguinte definição para este objeto. Em alguns casos, para facilitar a implementação e diminuir o fluxo de dados entre as partes, algumas informações poderão ser omitidas.

nometipodescrição
account_idstringIdentificador da conta.
É essencial que este número seja único para cada conta (obrigatório)
account_typestringIdentificador do tipo de conta cadastrada no sistema de cadastro de dispositivo. As contas podem ser do tipo pessoa física natural_person ou pessoa jurídica legal_person .(obrigatório)
registration_datedatetimeData e hora do registro da conta (obrigatório)
account_dataobjectobjeto que pode conter quais quer dados da conta, mas deve conter no mínimo o número da conta account_number e agência agency_number sendo os dois do tipo string.

Enviar um Account

Request Body
  {
"account_id": "12345",
...
}
Response Body
  {
"account_id": "12345678",
"account_type": "natural_person",
"registration_date": "2019-12-11T11:37:15.12-03:00",
"account_data": {
"account_number": "12345678",
"agency_number": "1234"
}
}

Para realizar a criação de uma conta, basta enviar um objeto do tipo Account ao seguinte endpoint:

POST https://api.caas.qitech.app/device_manager/account