Documentação da API

POST /insert_bank_account

Resumo

Este endpoint permite criar uma nova conta bancária em uma unidade específica.

---

Descrição

Utilize este endpoint para inserir uma nova conta bancária no sistema, associada a uma unidade específica. A conta pode incluir informações como banco, agência, número da conta, saldo inicial, entre outros.

---

Requisição

Body da Requisição

O corpo deve ser um objeto JSON com os seguintes parâmetros:

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
access_token	string	Sim	Token de autenticação do usuário.	aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee
unit_token	string	Sim	Token identificador da unidade.	aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee
id_bank	string	Sim	Identificador do banco.	aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee
id_bank_type	string	Sim	Identificador do tipo de banco.	aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee
agency	string	Não	Número da agência bancária.	1234
current_account	string	Não	Número da conta corrente.	56789
observation	string	Não	Observações sobre a conta.	Conta principal da unidade
code_bank	string	Não	Código do banco.	033
dv_agencia	string	Não	Dígito verificador da agência.	5
dv_conta	string	Não	Dígito verificador da conta.	9
nick_name	string	Não	Apelido da conta.	Conta Principal
opening_balance	number	Não	Saldo inicial da conta.	1000.50
opening_balance_date	string	Não	Data do saldo inicial (formato DD/MM/YYYY).	01/01/2025

---

Exemplo de Requisição

Curl

curl -X POST 'https://portal.fipli.pro/api/v1/insert_bank_account' \
-H 'Content-Type: application/json' \
-d '{
  "access_token": "<access_token>",
  "unit_token": "<unit_token>",
  "id_bank": "<id_bank>",
  "id_bank_type": "<id_bank_type>",
  "agency": "<agency>",
  "current_account": "<current_account>",
  "observation": "<observation>",
  "code_bank": "<code_bank>",
  "dv_agencia": "<dv_agencia>",
  "dv_conta": "<dv_conta>",
  "nick_name": "<nick_name>",
  "opening_balance": <opening_balance>,
  "opening_balance_date": "<opening_balance_date>"
}'

---

Resposta

200 OK

Criação realizada com sucesso.

{
  "success": true,
  "message": "Bank account inserted successfully",
  "token": "<token>"
}

Erros Comuns

Status	Mensagem	Descrição
400	"Missing parameters"	Algum parâmetro obrigatório (access_token, unit_token, id_bank, id_bank_type) não foi enviado.
403	"Invalid data"	Token de autenticação inválido ou não autorizado.
404	"Unit not found"	A unidade com o unit_token fornecido não foi encontrada.
500	"Something went wrong. Please try again later."	Erro interno no servidor.

---

Observações

• O campo opening_balance_date deve estar no formato DD/MM/YYYY e será formatado para armazenamento.
• O campo opening_balance será formatado como valor monetário para armazenamento.
• Campos opcionais (agency, current_account, observation, code_bank, dv_agencia, dv_conta, nick_name, opening_balance, opening_balance_date) podem ser omitidos ou enviados como null.
• A inserção é realizada de forma transacional, garantindo a consistência dos dados no banco.
• A conta bancária é automaticamente marcada como ativa (active: true) ao ser criada.
• Certifique-se de que os tokens estejam válidos e que a unidade exista no sistema.