Agora no Bluesoft ERP, é possível consolidar movimentos da conta comercial de múltiplas filiais em um único acordo centralizado na Matriz através da integração via API.

Objetivo

O objetivo desta melhoria é otimizar o fluxo de apuração de verbas e acordos para redes varejistas que trabalham com negociações centralizadas, permitindo que a Matriz assuma a responsabilidade financeira e comercial por movimentos gerados em diversas lojas do grupo.

Como Irá Funcionar a Partir de Agora?

A API de apuração foi evoluída para suportar o novo tipo de apuração centralizada. Veja os principais detalhes técnicos:

  • Novo Tipo de Apuração: O campo tipoApuracao agora aceita o valor UM_ACORDO_UNICO_PARA_MATRIZ.
  • Definição da Matriz: Foi incluído o campo matrizKey para informar o ID da loja matriz que centralizará o acordo.
  • Validação de Hierarquia: O sistema valida obrigatoriamente se todos os IDs enviados no array movimentosKeys pertencem a lojas subordinadas à Matriz informada.
  • Segregação de Configuração:
    • Para tipoAcordo: COMERCIAL, deve-se preencher apenas o objeto configuracaoComercial.
    • Para tipoAcordo: FINANCEIRO, deve-se preencher apenas o objeto configuracaoFinanceira.
  • Flexibilidade no Agrupamento: O campo gerarAcordoAgrupado permite definir se o resultado será um acordo por movimento (NAO), agrupado por número de acordo de origem (POR_N_ACORDO_PRODUTO) ou uma soma total em um único documento (TOTAL_GERAL).

Observações / Validações

  • Unicidade: A API rejeitará a operação caso qualquer movimento enviado já tenha sido apurado anteriormente.
  • Formato de Data: Todos os campos cronológicos devem seguir estritamente o formato DD/MM/AAAA.
  • Permissões: A execução deste processo via API requer que o token de autenticação possua a permissão 4422 - API Apuração Acordo Comercial (Incluir).

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.

Disponível a partir da versão r368.01