Agora no Bluesoft ERP, é possível incluir um acordo financeiro via API
Para otimizar os processos de integração com sistemas externos e eliminar a necessidade de redigitação manual, agora é possível realizar a inclusão de acordos financeiros diretamente via API. Anteriormente, esse fluxo era restrito exclusivamente à interface do ERP.
Desenvolvemos um novo endpoint que permite o envio de todas as informações do acordo em uma única chamada, abrangendo o cabeçalho, a distribuição de valores por loja e o rateio por centros de resultado.
• Endpoint: POST /api/compras/acordos-financeiros
• Permissão Necessária: Para utilizar essa funcionalidade, o usuário deve possuir a permissão 4390 – API Acordo financeiro (Incluir)
Exemplo de JSON:
{
"fornecedorKey": 4102,
"fornecedorDivisaoKey": 1,
"setorCompraKey": 1,
"tipoLancamentoKey": 1,
"dataAcordo": "24/11/2026",
"dataVencimento": "25/11/2026",
"tipoCobranca": "BANCO",
"tipoFormaPagamento": "DEPOSITO_EM_CONTA",
"prioridadeAcordo": "BAIXA",
"modeloAcordoComercialKey": 1,
"representanteKey": 34414,
"descricaoAcordo": "TESTE",
"negociadorKey": 4001,
"qtdParcelas": 1,
"gerarAcordoAgrupado": true,
"distribuicao": [
{
"lojaKey": 1,
"valor": 100.50,
"observacao": "TESTE 1",
"contaBancariaKey": 53575
},
{
"lojaKey": 2,
"valor": 100,
"observacao": "Teste 2",
"contaBancariaKey": 4183
}
],
"matrizKeys": [
0
],
"rateioCentroResultados": [
{
"centroResultadoKey": 1,
"porcentagem": 100,
"canaisDeVenda": [
{
"canalVendaKey": 1,
"porcentagem": 100
}
]
}
]
}Principais Regras e Validações
Para garantir a integridade dos dados, a API segue as mesmas regras de negócio da tela do ERP:
• Tipos de Cobrança e Pagamento:
◦ Se o tipo de cobrança for CARTEIRA, a forma de pagamento deve ser obrigatoriamente DINHEIRO.
◦ Se o tipo de cobrança for BANCO, é obrigatório informar uma conta bancária válida para cada loja na distribuição.
• Rateio de Centros de Resultado: A soma dos percentuais dos centros de resultado deve ser exatamente 100%. Caso existam canais de venda dentro de um centro, a soma deles também deve totalizar 100% para aquele centro específico.
• Exclusividade de Rateio: O usuário deve optar por usar uma matriz de rateio ou informar os centros de resultado manualmente; não é permitido o envio de ambos simultaneamente.
• Campos Opcionais: Os campos negociadorKey e representanteKey são opcionais, a menos que o parâmetro do ERP para obrigatoriedade de negociador esteja ativo.
• Formatos de Data: As datas de acordo e vencimento devem ser enviadas no formato DD/MM/AAAA.
Para conhecer mais sobre como é a utilização dessa ferramenta, clique aqui.
Para saber mais sobre a utilização das APIs do ERP, clique aqui.