Agora no Bluesoft ERP, é possível enviar, gravar, alterar e consultar os campos de lastro e camada diretamente no cadastro principal do produto por meio da API pública de produtos.

O objetivo desta melhoria é garantir a consistência de dados entre o ERP e a API pública , permitindo que as integrações mantenham o cadastro logístico e as informações de paletização completas sem a necessidade de fluxos complementares ou ajustes manuais.

Como Irá Funcionar a Partir de Agora?

A API pública de produtos foi reestruturada para receber os campos de paletização no cadastro principal. O comportamento foi unificado nas seguintes operações:

  • Inclusão (POST): A rota POST /api/comercial/produtos passa a aceitar os campos "lastro" e "camada" no contrato de entrada.
  • Alteração (PUT): As rotas de atualização por produtoKey, gtin ou codigo-integracao foram adequadas para permitir a modificação destes valores. Se os campos forem omitidos no envio, os valores atuais gravados no ERP são preservados.
  • Consulta (GET): Os retornos das consultas detalhadas e da listagem geral passam a exibir o lastro e a camada como dados logísticos do produto principal, sem restrição conceitual a produtos do tipo caixa.

Especificação Técnica dos Campos:

* lastro: Valor numérico inteiro, opcional, maior ou igual a zero e com limite técnico de até 4 dígitos. Define a quantidade de unidades por camada na paletização.

* camada: Valor numérico inteiro, opcional, maior ou igual a zero e com limite técnico de até 4 dígitos. Define a quantidade de camadas na paletização.

Observações / Validações

  • Validação de Dados: O envio de valores negativos, não inteiros ou com mais de 4 dígitos resultará em bloqueio da requisição com o retorno de erro correspondente (Status 400 – Bad Request).
  • Manutenção de Regras e Compatibilidade: Integrações legadas que não enviam esses campos continuam funcionando normalmente sem impactos fiscais, comerciais ou cadastrais.
  • API de Caixas: A API específica de caixas do produto não sofreu nenhuma alteração de comportamento ou regressão.

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 r370.01