Changelog
Back to All
Added

Novo campo "Produto Perigoso" nos endpoints de produtos

2 days ago by Angela Santos

Implementamos a exposição do campo "Produto Perigoso" em nossa API Pública de Catálogo.

Esta atualização permite que lojistas e parceiros de tecnologia automatizem a identificação de itens com restrições de manuseio e transporte, garantindo que informações críticas de segurança trafeguem sem fricção entre o ERP, o WMS e a plataforma Wake.

Como era antes:

Anteriormente, a marcação de um item como "Produto Perigoso" estava restrita ao banco de dados e à interface do Admin. Isso impedia que sistemas externos soubessem dessa condição via integração, forçando os lojistas a realizarem atualizações manuais no painel para garantir a conformidade logística e o cálculo correto de frete em transportadoras especializadas.

O que mudou?

Liberamos a propriedade produtoPerigoso em todos os fluxos de integração de produtos. O novo campo é do tipo booleano e foi inserido na estrutura do objeto de variantes. A atualização contempla os seguintes pontos de integração:

  1. Consulta e Detalhamento (GET): Os endpoints de listagem <Anchor label="(/produtos)" target="_blank" href="https://wakecommerce.readme.io/reference/retorna-todos-os-produtos">(/produtos)</Anchor> e detalhamento por identificador <Anchor label="(/produtos/id)" target="_blank" href="https://wakecommerce.readme.io/reference/retorna-um-produto-buscando-pelo-seu-identificador">(/produtos/id)</Anchor> agora retornam a flag de periculosidade. Isso permite que sistemas de gestão de armazém (WMS) e hubs de frete identifiquem automaticamente o tipo de carga antes do despacho.
  2. Criação e Atualização (POST, PUT e PATCH): Agora é possível definir se um produto é perigoso no momento da criação ou atualizar essa informação de forma massiva.
  • POST: Inserção do campo na criação do produto/variante.
  • PUT: Atualização total para ajustar a sinalização de segurança de itens já cadastrados.
  • PATCH: Atualização parcial para ajustar a sinalização de segurança de itens já cadastrados.
  1. Padronização de Dados: Para manter a integridade do catálogo, caso o valor não seja enviado ou esteja nulo na base de dados, a API assumirá o valor padrão false, garantindo que não haja quebras em integrações existentes.

Benefícios e Ganhos

  • Automação Logística: Elimina a necessidade de intervenção manual no Admin para sinalizar itens restritos. Agora, o dado flui automaticamente do sistema de gestão para a plataforma.

  • Conformidade e Segurança: Garante que produtos que exigem manuseio especial sejam identificados corretamente desde a entrada no estoque, evitando multas e problemas com regulamentações de transporte.

  • Cálculo de Frete Preciso: Permite que gateways de frete utilizem essa flag para selecionar apenas transportadoras homologadas para cargas especiais, reduzindo recusas de coleta.

  • Eficiência Operacional: Com o suporte aos métodos de escrita, o lojista ganha agilidade na manutenção de grandes catálogos, garantindo que a informação de segurança esteja sempre atualizada.