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.