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.	b31643fc-a45f-448c-99ee-736a547f6989
unit_token	string	Sim	Token identificador da unidade.	e6988e9e-b0c1-410c-ae08-aed7c64ac71f
id_bank	string	Sim	Identificador do banco.	a6927665-6d56-4839-ad23-37d48717da13
id_bank_type	string	Sim	Identificador do tipo de banco.	a6927665-6d56-4839-ad23-37d48717da13
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": "b31643fc-a45f-448c-99ee-736a547f6989",
  "unit_token": "e6988e9e-b0c1-410c-ae08-aed7c64ac71f",
  "id_bank": "a6927665-6d56-4839-ad23-37d48717da13",
  "id_bank_type": "b4327665-6d56-4839-ad23-37d48717da14",
  "agency": "1234",
  "current_account": "56789",
  "observation": "Conta principal da unidade",
  "code_bank": "033",
  "dv_agencia": "5",
  "dv_conta": "9",
  "nick_name": "Conta Principal",
  "opening_balance": 1000.50,
  "opening_balance_date": "01/01/2025"
}'

---

Resposta

200 OK

Criação realizada com sucesso.

{
  "success": true,
  "message": "Bank account inserted successfully",
  "token": "a6927665-6d56-4839-ad23-37d48717da13"
}

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.