Como realizar a integração com a C&S Sistemas

O primeiro passo para a integração é efetuar o login na plataforma do olist. 

Após efetuar o login a integração iniciará a troca de chaves com o 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 mencionada logo mais à frente)

É importante ressaltar que, mesmo estando com os parâmetros de liberação para e-commerces habilitados, apenas produtos que possuam GTIN válido serão processados. 

Tela de crítica de produtos

Para consultar os campos obrigatórios exigidos pelo olist, clique aqui.

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

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. 

Informações de dimensões do pacote

O GTIN/EAN do produto também é um campo obrigatório. Utilizamos para definir a concorrência na loja e os marketplaces e 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 nos 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.

Cadastros/Campos adicionais/Grupos

Em seguida cadastre os campos adicionais utilizados para este grupo de Campos Adicionais.

Cadastros/Campos adicionais/Campos

É importante definir a ordem que estes campos adicionais serão apresentados, pois é a ordem de envio para o olist e como serão apresentados nos marketplaces.

 A descrição do produto deve ser detalhada e o campo possui o limite máximo de 2000 caracteres.

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

Cadastros/Campos adicionais/Campos

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

Após o cadastramento dos atributos é preciso acessar o cadastro do produto e fazer a vinculação do produto ao atributo e a 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, apresentado na aba Dados Adicionais > Campos, como é possível observar na imagem a seguir.

Cadastros/Produtos/Produtos

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

Campos adicionais no cadastro do produto

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

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 o olist publicará os produtos nos marketplaces.

Recebimento de Pedidos

Ao receber um pedido vindo do olist, este será listado na tela de "gerenciamento de pedidos" provenientes da web.

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 pelo olist. Os dados de conexão serão configurados nos parâmetros do sistema (aba Notas fiscais) conforme imagem.

Configurações do FTP para envio dos arquivos XML

Lembrando que, como a integração com o 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.

Configuração das condições de pagamento padrão

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

Testes de Recebimento de Pedidos
O servidor de Homologação (sandbox) do olist não envia as notificações para o integrador, isso só ocorrerá em Produção, 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