Agora no Bluesoft ERP, é possível cadastrar um produto e utilizar a sugestão automática de PLU do ERP via API.

O objetivo desta melhoria é reduzir a complexidade de integração para clientes que cadastram produtos via API, eliminando a necessidade de controlar sequenciais de códigos externamente e garantindo a paridade funcional entre o cadastro manual em tela e a integração sistêmica.

Como Era o Processo Antes?

No cenário anterior, o endpoint de inclusão de produtos exigia obrigatoriamente o envio manual do código principal (gtinPrincipal). Diferente da tela de cadastro manual no ERP, que já possuía a lógica de sugerir o próximo sequencial disponível, a API não oferecia uma forma de solicitar essa automação.

Como Irá Funcionar a Partir de Agora?

Foi adicionado um novo atributo booleano chamado usarSugestaoDePluErp no request do endpoint POST /api/comercial/produtos.

  • Com sugestão ativa (true): Ao enviar o campo como true, o sistema utiliza a mesma lógica de negócio da tela do ERP para obter o próximo PLU válido e vinculá-lo ao produto.
  • Definição de Principal: Se nenhum código principal for enviado na requisição, o PLU sugerido será automaticamente definido como o gtinPrincipal do produto.
  • Manutenção de Adicionais: Códigos enviados na lista de gtinsAdicionais continuam sendo aceitos e vinculados normalmente ao cadastro.
  • Retrocompatibilidade: Se o atributo não for enviado ou vier como false, o comportamento do endpoint permanece inalterado, mantendo a obrigatoriedade do envio manual do código principal.

Observações / Validações

  • Conflito de Estratégia: Não é permitido informar manualmente um gtinPrincipal quando o atributo usarSugestaoDePluErp estiver definido como true. Caso ocorra, a requisição será rejeitada com erro de validação para evitar ambiguidade.
  • Permissões: O uso do endpoint continua condicionado à permissão de usuário 49 – Produtos 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.18