Conectar o Item WMS: enviar pedidos e recebimentos, sincronizar produtos e estoque

Peça à UNIS seu Company ID, Customer ID e Facility ID, preencha seu usuário e senha do Item WMS no Integration, teste o login, confira o mapping e ative saída, entrada, etiquetas, produtos e estoque.

O conector do Item WMS liga este sistema ao Item WMS (UNIS). Ele envia pedidos de saída e pode cancelá-los, consulta confirmações de pedido e de envio, envia etiquetas de envio, cria e pode cancelar recebimentos de entrada, consulta confirmações de recebimento, importa e busca produtos e lê o estoque por item (disponível, alocado, danificado, congelado e em mãos). Os três IDs de que precisa são atribuídos pela UNIS: você não pode criá-los. Uma conexão trabalha com os valores de empresa, cliente e instalação que você preencher.

Pré-requisitos#

• Um login do Item WMS: um usuário e uma senha com os quais você consiga entrar no Item WMS.
• Seu Company ID, atribuído por um administrador de sistema da UNIS. Peça antes de começar: ele é enviado em quase todas as chamadas à API.
• Seu Customer ID, atribuído pelo Financeiro da UNIS (Finance). Ele vem de uma equipe diferente da do Company ID, então peça ao Financeiro separadamente.
• Seu Facility ID (armazém), atribuído pelo seu ITEM CSR. Confirme que é o ID do armazém com o qual esta conexão deve trabalhar.
• Normalmente você não precisa de uma Base URL: a conexão usa o endereço de produção por padrão. Só anote um endereço diferente se a UNIS lhe deu um ambiente não produtivo ou especial.

Obter credenciais#

1. Peça seu Company ID a um administrador de sistema da UNIS. Todos os IDs abaixo são atribuídos pela UNIS: você não pode criá-los no Item WMS.
2. Peça seu Customer ID ao Financeiro da UNIS. Não reutilize o Company ID aqui: são valores diferentes de equipes diferentes.
3. Peça ao seu ITEM CSR seu Facility ID, o ID do armazém atendido por esta conexão.
4. Anote o usuário e a senha do login do Item WMS para a integração, exatamente como você os usa para entrar no Item WMS.

Preencher no Integration#

1. Abra o Integration, escolha Item WMS e inicie uma nova conexão.
2. username, obrigatório, Username: o usuário de login do Item WMS para a integração, por exemplo your-username.
3. password, obrigatório, Password: a senha desse mesmo login do Item WMS. É guardada como segredo.
4. company_id, obrigatório, Company ID: o ID atribuído por um administrador de sistema da UNIS, por exemplo no formato COMPANY01. Copie exatamente como a UNIS lhe entregou.
5. customer_id, obrigatório, Customer ID: o ID atribuído pelo Financeiro da UNIS, por exemplo no formato CUST001. Não é o mesmo valor que o Company ID.
6. facility_id, obrigatório, Facility ID (armazém): o ID de armazém atribuído pelo seu ITEM CSR, por exemplo no formato WH01.
7. base_url, opcional, Base URL: deixe vazio para usar o endereço de produção padrão https://wms.item.com/api/public/v1/public. Preencha só se a UNIS lhe deu um endereço diferente para um ambiente não produtivo ou especial.

Testar a conexão#

Clique em Testar a conexão. O teste entra de verdade: envia seu username e password ao endpoint de login do Item WMS e só aprova quando um token volta. Aprovar prova, portanto, que o usuário e a senha estão corretos e que o endereço responde. O teste não faz uma chamada de negócio com seus três IDs, então um Company ID, Customer ID ou Facility ID errado pode passar no teste e só falhar depois, na primeira chamada real de pedido, recebimento, produto ou estoque. Depois de aprovar, verifique os três IDs com uma chamada real antes de ativar, como descrito na etapa de mapping.

Mapping / escolher modelo#

Escolha o mapping padrão do Item WMS para pedidos, recebimentos, produtos e estoque, e mantenha os valores de empresa, cliente e instalação da conexão como os valores enviados em cada chamada. Depois verifique antes de ativar: envie ou consulte um pedido real e compare número do pedido, linhas e quantidades; faça uma consulta de estoque de um produto conhecido e compare as quantidades disponível e em mãos com o Item WMS. Essa conferência é também a forma de confirmar os três IDs: o teste de login não consegue verificá-los, então um resultado correto aqui significa que os IDs combinam e apontam para o armazém certo.

Ativar#

Após ativar, a conexão envia pedidos de saída ao Item WMS, manda cancelamentos de pedido, cria recebimentos de entrada e cancelamentos de recebimento, envia etiquetas e continua trazendo confirmações, confirmações de envio e confirmações de recebimento, enquanto importações de produtos, buscas e leituras de estoque correm pela mesma conexão. Acompanhe os primeiros pedidos e recebimentos em Runs / Logs e compare com o Item WMS antes de deixar a conexão sem supervisão.

Tenha o escopo em mente: esta conexão cobre o trabalho de saída, entrada, etiquetas, produtos e estoque listado acima, com o escopo de empresa, cliente e instalação que você preencheu. O trabalho de outra instalação ou outro cliente precisa dos seus próprios valores: não mude os IDs de uma conexão em uso para trocar de armazém; crie uma conexão separada.

Perguntas frequentes#

O teste falha com AUTH_FAILED

O login foi recusado: o Item WMS respondeu à chamada de login, mas não devolveu nenhum token. Isso significa que o usuário, a senha ou o endereço em uso não corresponde: o par de acesso deve ser o próprio login do Item WMS e base_url, quando preenchido, deve apontar para o endereço de API do Item WMS.

Entre diretamente no Item WMS com o mesmo usuário e senha para confirmar que o par funciona, copie os dois valores de novo sem espaços extras e limpe base_url, a menos que a UNIS tenha lhe dado outro endereço. Depois teste novamente.

O teste aprova, mas a primeira chamada real de pedido ou recebimento falha

É o comportamento esperado quando um ID está errado: o teste só entra com usuário e senha, enquanto as chamadas reais também enviam o Company ID, o Customer ID e o Facility ID. Um ID errado ou que não combina passa no teste e falha na primeira chamada de negócio.

Compare os três IDs caractere por caractere com o que a UNIS emitiu: Company ID de um administrador de sistema da UNIS, Customer ID do Financeiro da UNIS, Facility ID do seu ITEM CSR. Corrija o valor errado na conexão, repita a mesma chamada real e confirme que funciona antes de ativar.

Onde consigo o Company ID, o Customer ID e o Facility ID?

Os três IDs são atribuídos pela UNIS: você não pode criá-los e eles vêm de três fontes distintas. Procurar no Item WMS uma página para gerá-los não vai funcionar.

Peça a cada fonte o seu próprio ID: a um administrador de sistema da UNIS o Company ID, ao Financeiro da UNIS o Customer ID e ao seu ITEM CSR o Facility ID. Reúna os três e preencha na conexão exatamente como foram emitidos.

Devo preencher base_url?

Na maioria dos casos, não. base_url é opcional: quando fica vazio, a conexão usa o endereço de produção padrão https://wms.item.com/api/public/v1/public. Preenchê-lo com um endereço copiado ou adivinhado é uma causa comum de falhas de login.

Deixe base_url vazio para o ambiente de produção. Preencha só quando a UNIS lhe deu um endereço diferente para um ambiente não produtivo ou especial, e copie esse endereço exatamente.

As quantidades de estoque neste sistema não batem com o Item WMS

A conexão lê o estoque por item do Item WMS: disponível, alocado, danificado, congelado e em mãos são quantidades separadas. Uma diferença geralmente significa que outro tipo de quantidade foi comparado, ou que o escopo de produto ou de instalação difere entre as duas visões.

Escolha um produto conhecido na mesma instalação, compare o mesmo tipo de quantidade dos dois lados (por exemplo disponível contra disponível) e verifique se o código do produto coincide com o item do Item WMS. Se esse produto bater, confira a lista maior com o mesmo tipo de quantidade.