[OMS] Novo Pedido

Esse processo é exclusivo para clientes VTEX.

O objetivo desse processo é a criação de um pedido a partir do OMS no ambiente VTEX.

Nessa documentação você aprenderá:

Configurar os Parâmetros no OMS

Acessar os parâmetros https://nomecliente.sintesesolucoes.com.br/SinOMS/ConfigSinOMS/Parametros

Pesquisar pelos seguintes parâmetros:

PLATAFORMA_CARRINHO_COMPARTILHAVEL
PLATAFORMA_NOVO_PEDIDO
PLATAFORMA_VITRINE

Clicar em “Editar Parâmetro” e no campo “Valor”, selecionar o valor VTEX para eles. Após esse processo, o resultado deverá ser como o da imagem abaixo:

Agora temos que fazer algumas configurações no campo “Valor atual” do parâmetro:

VTEX_PARAMETRIZACOES_CARRINHO_COMPARTILHAVEL

Primeiramente, clicar em “Editar Parâmetro” e copiar o conteúdo do campo “Valor atual”. Após copiar o conteúdo, colar em um editor de texto que aceite o formato JSON (Notepad++, https://jsoncrack.com/editor ou similar).

Com o JSON no editor, validar os valores das propriedades abaixo:

conta: Conta principal
politicaComercialCarrinho e politicaComercialVitrine: Verificar com o cliente qual a política comercial devemos configurar para os pedidos que forem gerados pelo carrinho.
baseUrlCarrinho: URL do site do cliente.
appKeySite: AppKey que utilizamos para realizar a integração com a Vtex, disponível no OMS ou no Banco de Dados - Amazon.
tokenSite: AppToken criptografado pelo portal SinIA, disponível no Banco de Dados - Amazon.
especificacaoVariacaoTamanho e especificacaoVariacaoCor: Verificar se as especificações são a nível de PRODUTO ou SKU e preencher com base nisso.
nomeEspecificacao: Os nomes das especificações devem estar EXATAMENTE IGUAIS na Vtex.

Atenção: a propriedade nomeEspecificacao é case sensitive, portanto, os valores atribuídos a ela devem estar exatamente como está cadastrado na Vtex.

Temos dois métodos que podemos utilizar para fazermos a validação do nomeEspecificacao, nos exemplos abaixo utilizaremos a NK como base:

Acessando a Vtex do cliente em Catálogo → Categorias → Ações → Campo (Produto/SKU):

Para esse exemplo vamos acessar o Campo (SKU).

Após isso, a tela abaixo será exibida, nela vamos validar as especificações “Tamanho” e “Cor”:

Portanto, a propriedade nomeEspecificacao em “especificacaoVaricacaoTamanho” e “especificacaoVaricacaoCor“, seria a nível de SKU e assumiria os valores “Cor” e “Tamanho”, exatamente como consta na Vtex (respeitando a regra de case sensitive).

Consulta através da API da Vtex:

A API da Vtex que utilizamos para fazer a consulta dos produtos e validar como os nomes das propriedades case sensitive retornam: https://developers.vtex.com/docs/api-reference/search-api?endpoint=get-/api/catalog_system/pub/products/search

CURL utilizado na consulta:

curl --location 'https://apiexamples.vtexcommercestable.com.br/api/catalog_system/pub/products/search' \
--header 'Accept: application/json' \
--header 'X-VTEX-API-AppKey;' \
--header 'X-VTEX-API-AppToken;'

Inserir o nome da conta do cliente na Vtex na URL.
Ir até “Headers” e preencher com as credenciais do cliente X-VTEX-API-AppKey e X-VTEX-API-AppToken.
Clicar em “Send” e aguardar o retorno de SUCESSO:

No JSON que foi retornado na consulta, localizar as informações abaixo:

Neste exemplo, as propriedades “Cor” e “Tamanho”, possuem a primeira letra maiúscula (assim como validamos na tela da Vtex através do primeiro método), portanto elas devem ser preenchidas dessa forma no JSON do parâmetro VTEX_PARAMETRIZACOES_CARRINHO_COMPARTILHAVEL.

Preenchimento do JSON:

[
  {
    "conta": "nkstore",
    "politicaComercialVitrine": "1",
    "politicaComercialCarrinho": "1",
    "baseUrlCarrinho": "https://www.nkstore.com.br/",
    "appKeySite": "vtexappkey-cliente-INFORMAR_KEY",
    "tokenSite": "INFORMAR_TOKEN",
    "especificacaoVaricacaoTamanho": {
      "nivel": "SKU",
      "nomeEspecificacao": "Tamanho"
    },
    "especificacaoVaricacaoCor": {
      "nivel": "SKU",
      "nomeEspecificacao": "Cor"
    },
    "especificacaoVideo": {
      "nivel": "",
      "nomeEspecificacao": ""
    }
  }
]

Atenção: Caso o cliente utilize a propriedade especificacaoVideo, fazer as validações das propriedades nivele nomeEspecificacao conforme feito anteriormente em especificacaoVaricacaoTamanhoe especificacaoVaricacaoCor.

Quando tudo estiver configurado corretamente, colar o JSON no campo “Valor atual” do parâmetro VTEX_PARAMETRIZACOES_CARRINHO_COMPARTILHAVEL e salvar:

Habilitar a Opção de Novo Pedido no Menu

Para habilitar a opção de Novo Pedido, é necessário localizar a conta que queremos habilitar: https://nomecliente.sintesesolucoes.com.br/SinOMS/Contas

Após localizar a conta, ir até permissões e na permissões de “Pedidos” selecionar a opção “Pedido Inclusão Manual” e clicar em “Salvar”:

Após habilitar a opção acima, fazer o logoff/logon na conta em questão para que a opção “Novo Pedido” apareça no menu de seleção do OMS:

Acessar a Tela de Novo Pedido

Localizar a opção de “Novo Pedido” no menu ou acessar o endereço: https://nomecliente.sintesesolucoes.com.br/SinOMS/PedidoManual

Vídeo da função em funcionamento:

Ao clicar em “FECHAR PEDIDO”, a mensagem abaixo será exibida ao cliente:

Após efetuar o pedido, o cliente deverá validar o pedido na VTEX e finaliza-lo por lá.

Observações Importantes

Observação 1: O pedido manual no OMS funciona da mesma forma que um pedido feito no site — com a diferença de que é criado pelo operador, e não pelo cliente final.
Portanto, nas compras realizadas via carrinho compartilhável, é a Vtex quem define as origens (sellers/estoques), conforme as configurações de logística e priorização definidas no ambiente.

Observação 2: No fluxo de criação do carrinho, utilizamos 100% as APIs da Vtex.
Portanto, todo o processo de consulta de estoque, adição ao carrinho e fechamento do pedido é realizado diretamente pela própria Vtex.

Em todas essas chamadas, as informações necessárias são enviadas à Vtex por meio de JSON no body da requisição.

Observação 3: Deixar o cliente ciente de que essa função do OMS é apenas um facilitador para gerar o carrinho sem passar pelo site. Toda a lógica de vitrine e adição de itens é controlada pelas APIs da Vtex.

Autor(a): Iago Martuci & Isabella Honorato