Agora no Bluesoft ERP, é possível incluir uma pré-transferência/venda multiloja pela API já com o status: Gerado (FECHADO), informando o novo campo opcional gerado na requisição.

O objetivo desta melhoria é permitir que a integração conclua a inclusão e a geração da pré-transferência no mesmo processamento, proporcionando mais agilidade ao fluxo operacional e eliminando a necessidade de geração manual pelo ERP.

Como Irá Funcionar?

A comunicação é realizada pela API de inclusão de pré-transferência/venda multiloja:

POST /api/modulos/estoque/operacoes-entre-lojas/pre-transferencia-multiloja

  1. Inclusão com geração
    • Ao enviar o campo gerado com o valor true, o ERP realizará as validações necessárias para geração.
    • Quando as regras forem atendidas, a pré-transferência será criada com status FECHADO.
    • Para utilizar esse fluxo, a credencial de integração deve possuir a permissão 3730 — Incluir uma nova pré-transferência/venda multiloja pela API.
  2. Inclusão sem geração
    • Ao enviar gerado com o valor false, null ou não informar o campo, a pré-transferência será criada com status ABERTO.
    • Esse comportamento preserva o funcionamento das integrações já existentes.
  3. Validações da geração
    • Ao utilizar gerado: true, serão aplicadas as mesmas validações realizadas na geração de pré-transferências pelo ERP.
    • Caso alguma regra impeça a geração, a inclusão será cancelada integralmente, sem manter agrupador, pré-transferências ou itens.
    • O parâmetro que permite transferência/venda entre lojas sem saldo também será considerado durante a validação.
  4. Limite de produtos
    • A requisição permite informar até 500 produtos distintos por loja de destino.
    • Ao ultrapassar esse limite para a mesma loja, a API retornará uma mensagem de validação.

Observações Importantes!

  • Status da pré-transferência: o valor true cria a pré-transferência como FECHADA; false, null ou campo ausente mantêm o status ABERTO.
  • Compatibilidade: integrações que não enviarem o campo gerado continuarão funcionando sem alteração de comportamento.
  • Permissão: a geração pela API não exige a permissão 1239 — Pré-Transferência Pedido — Gerar.
  • Processamento: a inclusão e a geração são realizadas na mesma transação quando o campo gerado for enviado como true.

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 r371.80