Agora no Bluesoft ERP, é possível utilizar o prazo de validade configurado na Ficha Técnica do produto para o cálculo automático da data de validade no momento do apontamento da produção via API.

Objetivo

O objetivo desta melhoria é conferir maior autonomia e agilidade ao integrador, permitindo que o sistema utilize parâmetros já existentes na ficha técnica para calcular a validade, evitando a necessidade de envio manual dessa informação em cada requisição.

Como Era o Processo Antes?

Anteriormente, ao finalizar o apontamento de uma produção que utilizava ficha técnica via API, o integrador era obrigado a enviar manualmente uma data de validade no payload. O cálculo automático (Data Atual + Dias de Validade) só ocorria para ordens de produção que não possuíam ficha técnica.

Como Irá Funcionar a Partir de Agora?

O endpoint de finalização da Ordem de Produção (POST /api/pcp/ordem-de-producao/{ordemProducaoKey}/finalizar) teve seu comportamento atualizado para seguir uma nova hierarquia de prioridades no cálculo da validade:

  1. Prioridade 1 – Envio Manual: Se o campo dataValidade for informado no JSON da requisição, o sistema utilizará exatamente este valor, ignorando cálculos automáticos.
  2. Prioridade 2 – Ficha Técnica: Se o campo dataValidade for omitido e o produto possuir uma Ficha Técnica com o campo Dias de Validade preenchido, a API calculará: Data Atual + Dias da Ficha Técnica.
  3. Prioridade 3 – Cadastro do Produto: Caso a ordem de produção não possua ficha técnica (ou os dias na ficha estejam zerados/nulos), o sistema utilizará os dias de validade definidos no cadastro base do produto.

Observações Importantes!

  • Tratamento de Erros: Caso o integrador tente finalizar uma produção omitindo a data de validade, mas a Ficha Técnica correspondente esteja com os “Dias de Validade” zerados ou nulos e o cadastro base do produto não possua os dias de validade a API retornará erro HTTP 400 Bad Request.
  • Formatação: Todas as datas enviadas ou processadas devem seguir o formato DD/MM/AAAA.
  • Validação de Lote: A API impedirá a finalização caso o campo lote não respeite o limite de 10 a 20 caracteres.
  • Interface ERP: Esta alteração aplica-se exclusivamente à integração via API, não alterando o fluxo das telas manuais dentro do ERP.

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