Conectar o Oracle WMS: só consultar estoque, sem enviar pedidos
Preencha o Client ID, o Client Secret, a Token URL do IDCS e o endereço da sua instância de tenant na conexão WMS, teste a troca OAuth e ative para consultar estoque. Esta conexão não envia pedidos ao Oracle WMS.
O conector do Oracle WMS conecta este sistema a um tenant do Oracle WMS Cloud para uma única tarefa: consultar estoque. Ele lê as quantidades de estoque da instância do tenant para um SKU. Ele não envia pedidos ao Oracle WMS: o envio de pedidos não faz parte desta conexão, então os pedidos devem continuar chegando ao Oracle WMS pela sua rota atual. Esta conexão é configurada na área WMS, não no assistente de canais, e entra com uma troca OAuth do IDCS usando um Client ID, um Client Secret e uma Token URL, além do endereço da instância do tenant para as chamadas de estoque.
Pré-requisitos#
- Uma instância de tenant do Oracle WMS Cloud e o endereço dela. O endereço é definido por tenant: não há um endereço padrão único que sirva para todos os tenants.
- Um aplicativo confidencial do IDCS criado para a sua instância de WMS, com o Client ID e o Client Secret prontos para copiar.
- O endpoint de token OAuth do seu domínio IDCS, para usar como Token URL. Deve ser o endpoint do mesmo domínio IDCS do aplicativo acima.
- Acordo dentro da sua equipe de que esta conexão é só para consultas de estoque. Os pedidos continuam precisando da rota atual para o Oracle WMS.
Obter credenciais#
- Na configuração da instância do Oracle WMS, pegue o aplicativo confidencial do IDCS criado para esta instância de WMS. Copie o Client ID dele.
- Copie o Client Secret desse mesmo aplicativo. O Client ID e o Client Secret devem vir do mesmo aplicativo: um segredo de outro aplicativo não será trocado por um token aqui.
- Anote a Token URL: o endpoint de token OAuth do seu domínio IDCS.
- Anote o endereço da instância do seu tenant do Oracle WMS como baseUrl. Copie das informações do seu próprio tenant: não use o endereço de outro tenant nem de um exemplo.
Preencher no Integration#
Esta conexão não tem lista de campos no assistente de canais. Abra a conexão WMS do Oracle WMS no Integration e preencha os valores abaixo nesse formulário de conexão WMS. Não procure o Oracle WMS nas etapas de campos do assistente de canais: o assistente não tem campos para ele.
- Client ID, obrigatório: o Client ID do aplicativo confidencial do IDCS criado para a sua instância de WMS.
- Client Secret, obrigatório: o segredo desse mesmo aplicativo do IDCS. É um campo secreto e é usado com o Client ID quando o sistema troca por um token.
- Token URL, obrigatório: o endpoint de token OAuth do seu domínio IDCS. A troca de token é enviada exatamente para este endereço, então copie por inteiro.
- Endereço da instância do tenant (baseUrl), obrigatório para as chamadas de estoque: o endereço da sua própria instância de tenant do Oracle WMS. O teste de conexão não usa este endereço, mas cada consulta de estoque usa, então preencha agora e preencha com exatidão.
Testar a conexão#
Use o teste da conexão WMS. Ele envia uma troca de credenciais de cliente para a Token URL preenchida, autenticado com seu Client ID e seu Client Secret, e só aprova quando um access token volta. Se Client ID, Client Secret ou Token URL estiver ausente, o teste para com MISSING_CREDENTIALS. Se a troca não devolver access token, falha com AUTH_FAILED. Note o que o teste não faz: ele não chama o endereço da instância do tenant, então uma baseUrl errada pode aprovar o teste mesmo assim e só aparece depois, na primeira consulta de estoque. Há duas entradas de teste que você pode encontrar: este teste da conexão WMS é a verificação real de credenciais descrita aqui, enquanto um teste exibido no assistente de canais não contata o IDCS com estes valores: não trate uma aprovação lá como prova de que os valores do IDCS funcionam. Julgue a conexão apenas pelo teste da conexão WMS e depois por uma consulta real de estoque.
Mapping / escolher modelo#
Escolha o modelo de estoque do Oracle WMS. Ele cobre só estoque: um SKU deste sistema corresponde ao registro de estoque desse SKU na instância do tenant, e a quantidade devolvida é a que o tenant informa. Não há modelo de pedidos para escolher nesta conexão, porque os pedidos não são enviados. A chamada de estoque usa a interface de entidades do tenant, então confirme primeiro, num produto conhecido, a forma de SKU que o seu tenant usa: código exato, maiúsculas e qualquer prefixo. Depois que o teste aprovar, execute uma consulta de estoque para um SKU com estoque conhecido e compare o número com o que o tenant mostra, antes de ativar.
Ativar#
Após ativar, as consultas de estoque deste sistema leem as quantidades atuais do seu tenant do Oracle WMS para os SKUs mapeados. Acompanhe as primeiras consultas em Runs / Logs e compare com o tenant antes de deixar a conexão sem supervisão.
O que esta conexão não faz: não envia pedidos ao Oracle WMS e não traz confirmações de expedição do Oracle WMS. Continue enviando os pedidos pela sua rota atual para o Oracle WMS e continue cuidando da confirmação de expedição no sistema onde ela acontece hoje.
Perguntas frequentes#
Uma tentativa de envio de pedido falha com WMS_ENDPOINTS_PENDING
Esta conexão não envia pedidos ao Oracle WMS. A entrada de pedidos no Oracle WMS depende da configuração do tenant, e esta conexão só lê estoque, então o envio para com WMS_ENDPOINTS_PENDING em vez de enviar uma solicitação. Não é um problema de credenciais e tentar de novo não vai mudar isso.
Pare de enviar pedidos por esta conexão. Envie o pedido pela sua rota atual para o Oracle WMS e use esta conexão só para consultas de estoque.
O teste aprova, mas a consulta de estoque falha com MISSING_BASE_URL
O teste só troca por um token na Token URL: ele nunca chama o endereço da instância do tenant. A consulta de estoque é a primeira etapa que precisa de baseUrl, então um endereço de tenant ausente ou vazio só aparece ali, como MISSING_BASE_URL.
Preencha o endereço da instância do tenant na conexão WMS com o endereço exato do seu próprio tenant do Oracle WMS, salve e execute a consulta de estoque novamente. O resultado do teste não precisa mudar: ele nunca esteve verificando este endereço.
O teste WMS falha com AUTH_FAILED
A troca na Token URL não devolveu access token. O par de Client ID e Client Secret não foi aceito nesse endpoint: o segredo não pertence ao aplicativo desse Client ID, ou a Token URL é o endpoint de outro domínio IDCS.
Volte ao aplicativo do IDCS criado para a sua instância de WMS e copie novamente Client ID e Client Secret desse mesmo aplicativo, confirme que a Token URL é o endpoint de token OAuth do mesmo domínio IDCS e teste novamente.
O teste para com MISSING_CREDENTIALS
Falta um dos três valores do IDCS na conexão WMS: Client ID, Client Secret ou Token URL. A troca precisa dos três, então o teste para antes de contatar o IDCS.
Preencha os três campos no formulário de conexão WMS a partir do aplicativo e do domínio do IDCS, salve e teste novamente. Não preencha o endereço da instância do tenant no campo Token URL: são endereços diferentes com funções diferentes.
O teste do assistente de canais aprovou, mas o teste WMS continua falhando
Os dois testes não são a mesma verificação. O assistente de canais não tem campos do Oracle WMS e o teste dele não troca um token com o IDCS usando seu Client ID, seu Client Secret e sua Token URL, então uma aprovação lá não diz nada sobre os valores do IDCS. Só o teste da conexão WMS faz a troca real.
Ignore o resultado do assistente nesta conexão. Execute o teste da conexão WMS e trabalhe a partir do resultado dele, e depois execute uma consulta real de estoque para provar também o endereço do tenant.
A consulta de estoque não devolve nada para um SKU com estoque no tenant
A consulta de estoque pede à instância do tenant o registro de estoque do SKU enviado. Se a forma do SKU enviado (código exato, maiúsculas ou prefixo) não corresponder à que o tenant usa, ou o endereço do tenant apontar para outro tenant, a resposta volta vazia mesmo que haja estoque.
Confirme primeiro que o endereço da instância é o do seu próprio tenant. Depois pegue o SKU exato do registro do produto no tenant, coloque essa forma no mapping e execute a consulta de estoque novamente.