O primeiro passo para que seja possível a comunicação é efetuar o login na plataforma Olist

Após efetuar o login a integração iniciará a troca de chaves com a Olist possibilitando a utilização dos recursos disponíveis.

Carga Inicial dos Produtos

No primeiro acesso será necessário efetuar a carga inicial dos produtos clicando no botão Carga Inicial.

Atenção: Antes de fazer a carga inicial, configure os campos adicionais necessários para importação dos produtos (configuração esta mencionada logo mais à frente)

É importante ressaltar que, mesmo estando com os parâmetros de liberação para e-commerce habilitados, apenas produtos que possuam GTIN válido serão processados. Imagem 3 – Carga inicial dos produtos A Olist tem alguns campos que são obrigatórios para a carga de produtos e caso ocorra algum erro na carga inicial será exibida uma página onde serão listados os produtos que não puderam ser criados na Olist.

Imagem 3 – Carga inicial dos produtos

A Olist tem alguns campos que são obrigatórios para a carga de produtos e caso ocorra algum erro na carga inicial será exibida uma página onde serão listados os produtos que não puderam ser criados na Olist.

Imagem 4 – Tela de crítica de produtos

Os campos obrigatórios exigidos pela plataforma podem ser consultados em https://dev.olist.com/docs/creating-a-product-1 (acessado em 03/09/2020).

As imagens dos produtos são um destes campos obrigatórios e devem ser disponibilizadas em um site onde seja possível o download pela Olist. A URL deste site será configurada no arquivo de configuração da integração conforme a imagem 1. Os nomes dos arquivos devem ser os mesmos que estão configurados no C&S Gestor.

Imagem 5 – Cadastro de fotos do produto

Outros dados obrigatórios para o envio dos produtos são as dimensões dos produtos que podem ser configurados na aba Dados para internet do Cadastro de Produtos do Gestor. Estas informações são utilizadas para o cálculo do frete para entrega.

Imagem 6 – Informações de dimensões do pacote

O GTIN/EAN do produto também é um campo obrigatório. A Olist o utiliza para definir a concorrência na loja e os marketplaces o utilizam para agrupar todas as lojas em uma listagem única para o respectivo produto.

Os atributos são campos que possuem uma grande relevância no processo de cadastro do produto nas marketplaces.

Para que seja possível o cadastro de atributos com maior flexibilidade foi criado uma aba de campos adicionais no cadastro de produtos. Para que os campos adicionais sejam apresentados na aba de Dados Adicionais – Campos, na tela de produtos, devem ser seguidos os seguintes passos:

Cadastrar um grupo de campos adicionais. Por Exemplo: Eletrodomésticos.

Imagem 7 – Cadastros/Campos adicionais/Grupos

Em seguida cadastre os campos adicionais que serão utilizados para este grupo de Campos Adicionais.

Imagem 8 – Cadastros/Campos adicionais/Campos

É importante definir a ordem que estes campos adicionais serão apresentados pois é a ordem que serão enviados para a Olist e que serão apresentados nas marketplaces.

A Olist pede que seja criado um campo de descrição que possua até 2000 caracteres e que seja uma descrição detalhada do produto.

Utilizaremos um atributo para este fim. Criaremos o atributo DESCRICAO do tipo memorando com ordem 999.

Imagem 9 – Cadastros/Campos adicionais/Campos

Este campo, assim como os demais atributos, é de extrema relevância para a aprovação do cadastro do produto nas diversas marketplaces.

Após o cadastramento dos atributos é preciso acessar o cadastro do produto e fazer a vinculação do produto ao atributo e inserção do valor deste atributo.

É possível ter diversos grupos de produtos associados a um determinado produto. Para isto basta selecionar os grupos no combobox que é apresentado na aba Dados Adicionais – Campos, como é possível observar na imagem a seguir.

Imagem 10 – Cadastros/Produtos/Produtos

Selecionando apenas um grupo serão apresentados os campos associados a ele

Imagem 11 – Campos adicionais no cadastro do produto

E após inserir os valores e clicar em confirmar os campos adicionais serão apresentados na Grid.

Imagem 12 – Campos adicionais selecionados/informados

Para alterar os valores basta selecionar novamente o grupo e clicar no botão Campos adicionais. Caso queira excluir o campo basta selecionar o grupo, clicar no botão Campos adicionais e apagar o valor informado, desta forma o campo não será mais apresentado.

Após a carga inicial a Olist a publicará nas marketplaces conforme contratado. Recebimento de Pedidos

Ao receber um pedido vindo da Olist, este será listado na tela de Gerenciamento de pedidos provenientes da web.

Imagem 13 – Gerenciador de pedidos provenientes da Web

Ao gravar este pedido será possível efetuar o recebimento. No momento em que for emitida a NFe do pedido será necessário enviar o arquivo XML para um site onde seja possível o download pela Olist. Os dados de conexão serão configurados nos parâmetros do sistema (aba Notas fiscais) conforme imagem.

Imagem 14 – Configurações do FTP para envio dos arquivos XML

Lembrando que, como a integração com a Olist utiliza o mesmo webservice que o Handel para comunicação com o Gestor, é preciso fazer as configurações referente às condições de pagamento padrão.

Imagem 15 – Configuração das condições de pagamento padrão

Após isso o CESHubMktPlace fará o envio dos dados da fatura para a Olist fechando assim o ciclo de faturamento.

Testes de Recebimento de Pedidos O servidor de Homologação (sandbox) da Olist não envia as notificações para o integrador, isso só ocorrerá em Produção, sendo assim é necessário utilizar o aplicativo Postman para simular o envio da notificação.

O envio da solicitação deve ser conforme a imagem abaixo alterando a URL e porta apontando para o endereço onde o integrador está hospedado.

Encontrou sua resposta?