Integração Millennium [Interno]

O escopo dessa integração envolve os fluxos:

Criação de pedidos de venda;
Sincronização de estoque com opção de multi depósitos/filiais;
Sincronização de produto pelo Hub (não inclui imagem de produto)

Como integrar?

A primeira etapa consiste em solicitar os dados para ativar a conexão com o sistema da Millennium do cliente, como no exemplo abaixo:

URL da API: exemplo: http://179.124.192.50:6017
Usuário: exemplo: VNDA
Senha: exemplo: VNDA
Vitrine: exemplo: 303
Tabela: exemplo: 2
Código externo da filial: Informar a filial onde o pedido deve ser integrado
Utiliza wts-session: Sim ou não?

Importante que o cliente tenha feito o cadastros dos produtos na vitrine da Millennium, pois deve ser utilizada a interface do Hub em SKUs para validar se funcionou corretamente a busca dos produtos.

Nesse acesso, a coluna "SKU na Vnda" são os SKUs que devem ser utilizados no cadastro dos produtos na Vnda. É recomendado utilizar a paginação de 100 linhas e extrair essa informação para um Google Sheets.

Existe o usuário e senha para acessar a documentação, que é diferente do que deve ser usado para API. Para validar estes dados, tentar acessar essa URL no navegador: http://179.124.192.44:6017/api/millenium_eco/$help

Ou pelo Postman: Autenticação wts

Cadastros de Mapeamentos

Enviar para o consultor da Millennium uma cópia dessa planilha e pedir para que exportem da Millennium de acordo com os cadastros feitos no ERP do Seller:

Modelo - Mapeamentos Millennium

Meio de Pagamento

Conseguimos consultar os possíveis valores ao criar o mapeamento, então é só encontrar a opção correspondente. Ao cadastrar esse mapeamento, pode utilizar no campo “Para” os valores retornados em “Possíveis valores (Integração)”:

Exemplo:

De (Vnda):	Para (Integração):
Mastercard - Crédito	MASTER
Pix	PIX
Depósito	DEPÓSITO

Condição de pagamento

Solicitar para que o cliente faça esse acesso na Millennium para passar os valores:

Utilitários > Comercial > Condições de pagamento

Na planilha de mapeamentos é a coluna “Descrição” que deve ser utilizada para preencher o campo “Para”.

Exemplos:

De (Vnda):	Para (Integração):
Mastercard - Crédito:1	CARTAO DE CREDITO MASTER A VISTA
Mastercard - Crédito:6	CARTAO DE CREDITO MASTER 6X
Boleto:1	BOLETO

Tipo de pagamento:

Novas versões da Millennium exigem esse mapeamento. Para identificar se é necessário, verificar se o retorno de erro ao integrar o pedido é esse:

“Natureza de pagamento não encontrado"

Solicitar os valores dos tipos de pagamento na Millennium, são números.

Exemplos:

De (Vnda)	Para (Integração)
Mastercard - Crédito	016
Pix	012

Transportadora:

Solicitar que o cliente encaminhe os valores cadastrados nesse acesso na Millennium: Logística > TMS > Cadastros > Transportadoras. O seller pode enviar uma planilha da Millennium com essas informações.

Utilizar o slug da forma de entrega do pedido (dentro do parênteses) para identificar como preecher o campo "De (Vnda)".

Preencher o campo “Para (Integração)” conforme a coluna "TRANSPORTADORA_INTERNO" enviado na planilha de mapeamentos.

Exemplos:

De (Vnda)	Para (Integração)
sedex	1
pac	1
total-express-expressa	3

Código da transportadora:

Utilizar o campo conforme o nome da forma de entrega do pedido (fora do parênteses):

Preencher o campo “Para” conforme a coluna TIPO_FRETE_INTERNO da planilha de mapeamentos gerada pelo seller no acesso a millennium em Logística > TMS > Cadastros > Transportadoras.

Exemplos:

De (Vnda)	Para (Integração)
Correios PAC	3
Correios Sedex	2
Total Expresso Expressa	9

Depósitos para serem sincronizados

Sincronização de estoque (campo "depósito" nas configurações do Hub): Deve ser preenchido com o código "Filial" conforme endpoint "/api/millenium_eco/produtos/saldoestoque?vitrine=". Caso seja mais de um depósito, preencher os códigos separados por ",".

Importação pedido de venda (campo "Código externo da filial" nas configurações do Hub): deve ser preenchido conforme o campo "cod_filial" no endpoint "endpoint /api/millenium_eco/produtos/saldoestoque?vitrine=" para indicar qual depósito será consumido ao lançar estoque no pedido de venda importado pela integração.

Mapeamento de produto

reference:cod_produto,description:descricao1,product_name:descricao1,sku:sku.sku_vnda,variant_name:sku.desc_produto,width:sku.largura,height:sku.altura,length:sku.comprimento,weight:sku.peso,price:sku.preco1,property1:sku.desc_tamanho,property2:sku.desc_cor

Importante verificar a ordem dos atributos cadastrado na loja e revisar essa parte do mapeamento: property1:sku.desc_tamanho,property2:sku.desc_cor

Em casos de erro na sincronização de estoque e pedido, validar esses 4 tópicos:

Produto tem 3 atributos na Millennium dentro do mesmo código pai/referência, caso sim, isso pode causar inconsistência na sincronização de produto assim como nos pedidos e estoque.
O nosso modelo prevê a sincronização com no máximo 2 atributos por código pai na Millennium.

Estoque de produto está cadastrado na filial ou filiais das quais estão sendo utilizadas na sincronização de estoque?

Produto está com a flag de ativo na Millennium para incluir no e-commerce?

Existe estoque de segurança configurado na Millennium?

Caso existam dúvidas sobre os mapeamentos a serem realizados e os possíveis valores para preencher no campo De "(Vnda)", consultar no Hub as lojas com essa integração ativa, depois acessar a view mapeamentos.