Agora no Bluesoft ERP, é possível realizar a apuração de lançamentos na conta comercial via API
Para agilizar o fechamento de acordos e permitir a integração com sistemas externos de gestão de contratos, desenvolvemos um novo recurso nas APIs do Bluesoft ERP.
Agora, é possível realizar a apuração de lançamentos na conta comercial diretamente via API, automatizando um processo que antes exigia ação manual em tela.
O que mudou?
Disponibilizamos o endpoint POST /api/compras/acordos-comerciais/apuracao. Com ele, você pode processar uma lista de movimentos da conta comercial e gerar os respectivos acordos no ERP.
A nova rota suporta dois tipos principais de apuração:
1. Acordo Comercial: Para apurações que geram crédito ou débito em mercadoria/verba.
2. Acordo Financeiro: Para apurações que geram boletos ou duplicatas no Contas a Pagar, exigindo dados bancários e rateio de centro de resultado.
Principais Funcionalidades
• Flexibilidade no Agrupamento: É possível definir como os movimentos serão agrupados no acordo gerado através do campo gerarAcordoAgrupado:
◦ NAO: Gera conforme a regra básica (um por movimento).
◦ POR_N_ACORDO_PRODUTO: Agrupa movimentos que tenham o mesmo número de acordo de origem.
◦ TOTAL_GERAL: Soma todos os movimentos selecionados em um único acordo resultante.
• Validação de Status: A API garante a integridade dos dados, rejeitando a operação caso algum dos movimentos enviados já tenha sido apurado anteriormente.
• Escopo: Neste lançamento, a apuração está disponível para o escopo Por Loja (UM_ACORDO_POR_LOJA).
Exemplo de Utilização
Para realizar a apuração, é necessário enviar o tipo de acordo desejado (COMERCIAL ou FINANCEIRO) e preencher o objeto de configuração correspondente.
Exemplo de JSON para acordo comercial:
{
"tipoApuracao": "UM_ACORDO_POR_LOJA",
"tipoAcordo": "COMERCIAL",
"movimentosKeys": [
0
],
"configuracaoComercial": {
"fornecedorDestinoKey": 4102,
"fornecedorDivisaoDestinoKey": 1,
"setorCompraKey": 1,
"representanteKey": 0,
"negociadorKey": 0,
"tipoLancamentoCreditoKey": 0,
"tipoLancamentoDebitoKey": 0,
"gerarAcordoAgrupado": "NAO",
"lojaKeyParaImpressao": 0,
"modeloAcordoComercialKey": 0,
"pedidoKey": 0,
"descricaoAcordo": "string",
"tipoformaPagamento": "ABATIMENTO_NF",
"dataVencimentoComercial": "2019-08-24",
"dataNegociacao": "2019-08-24T14:15:22Z",
"qtdParcelas": 1,
"observacoes": [
"string"
]
}
}
Exemplo de JSON para acordo financeiro:
{
"tipoApuracao": "UM_ACORDO_POR_LOJA",
"tipoAcordo": "COMERCIAL",
"movimentosKeys": [
0
],
"configuracaoFinanceira": {
"setorCompraKey": 1,
"tipoLancamentoKey": 1,
"dataAcordo": "24/11/2026",
"dataVencimento": "25/11/2026",
"tipoCobranca": "BANCO",
"tipoFormaPagamento": "CHEQUE",
"prioridadeAcordo": "NORMAL",
"modeloAcordoComercialKey": 0,
"representanteKey": 0,
"descricaoAcordo": "string",
"negociadorKey": 0,
"qtdParcelas": 1,
"distribuicao": [
{
"observacao": "string",
"contaBancariaKey": 0
}
],
"matrizKeys": [
0
],
"rateioCentroResultados": [
{
"centroResultadoKey": 0,
"porcentagem": 0,
"canaisDeVenda": [
{
"canalVendaKey": 1,
"porcentagem": 0
}
]
}
],
"gerarAcordoAgrupado": "NAO"
}
}
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.