Integração BackOffice Datasul x

E-commerce

A integração entre o BackOffice Datasul e a Plataforma e-Commerce da Ciashop de E-commerce tem como objetivo realizar a comunicação da loja de comércio eletrônico com o ERP Datasul.

Sistemas Envolvidos 

Linha VTEX

• VTEX: Sistema vertical desenvolvido pela VTEX, empresa do ecossistema TOTVS, que dispõe de módulos e aplicativos voltados para o e-commerce. Com a plataforma Framework VTEX, é possível montar sua própria loja de comércio eletrônico, integrando esta loja com os principais marketplaces disponíveis no mercado.

Linha Datasul (BackOffice)

• ERP

Sistemas Envolvidos

Linha CiashopTabela de Preço

• Ciashop: Sistema vertical desenvolvido pela Ciashop, empresa do ecossistema TOTVS, que dispõe de módulos e aplicativos voltados para o e-commerce. Com a plataforma Framework Ciashop, é possível montar sua própria loja de comércio eletrônico, integrando esta loja com os principais marketplaces disponíveis no mercado.

Linha Datasul (BackOffice)

• ERP Datasul: Sistema de BackOffice para gestão de empresas com ênfase no segmento de Manufatura. Disponibiliza módulos de gestão e controle da distribuição com foco nos requisitos comerciais, fiscais e tributários, entre eles: Pedidos de Venda, Faturamento e Embarques.

Integração

A forma de comunicação entre ERP DATASUL e Ciashop VTEX se dará por meio de mensagens enviadas e recebidas de um Web service RESTful. Os Web services RESTful são serviços construídos com o estilo de arquitetura RESTful. A construção de Web services com a abordagem RESTful está surgindo como uma alternativa popular ao uso de tecnologias baseadas em SOAP para implantação de serviços na Internet, por ser mais leve e ter a capacidade de transmitir dados diretamente via HTTP.

Escopo

A plataforma Framework Ciashop VTEX é uma plataforma em que o cliente pode montar sua própria loja de comércio eletrônico.

O Ciashop permite que o cliente monte sua própria loja virtual. Para estabelecer a estrutura da loja virtual Para estabelecer a estrutura da loja virtual com seus departamentos e itens postos à venda, o ERP deverá fornecer tais informações. A loja virtual estará integrada com o ERP transmitindo para este os clientes e pedidos cadastrados na loja virtual.

O conceito de Marketplace (MP), no comércio eletrônico, é a utilização de uma loja virtual de terceiros para vender os seus produtos. Sales Hub é um aplicativo disponível para Lojas Framework da Ciashop que concentra diversos marketplaces, tais como Extra e Walmart. Por meio deste aplicativo, é possível ofertar os produtos da loja nestes marketplaces e gerenciar os pedidos gerados nestes canais em sua própria loja.

O objetivo da integração é possibilitar a integração dos Estabelecimentos (Filiais), Cadastros de Famílias Comerciais, Itens, Preços do Item, Depósitos e Saldo em Estoque disponível do Datasul para o CiashopE-commerce. Assim como, a integração do recebimento de pedidos de venda oriundos do Ciashop E-commerce e a atualização do status destes pedidos.

Pré-requisitos instalação/implantação/utilização

Datasul

Versão\release 12.1.23

Parâmetros de integração ativo: Cadastros Gerais -> Cadastros Gerais -> Cadastros -> Função: Manutenção Cadastros Gerais Parâmetro Global (CD0101 - Aba Integr II)

Parâmetros de configuração da integração ativo: Menu -> Logística -> Pedidos -> Cadastros -> Função: Parâmetros Integração Ciashop

Instalação/Atualização

Vide tópico Pré-requisitos instalação/implantação/utilização.

Datasul

Vide tópico Pré-requisitos instalação/implantação/utilização.

Manutenção Loja E-commerce (PD0309)

Atualização Parâmetros faturamento (FT0301) > O campo "ICMS Incluso no Preço" deverá estar marcado. O preço de tabela integrado para o e-commerce já possui o ICMS incluso. 

Natureza Operação > O campo "Consumidor final" da aba ICMS deverá estar marcado. Os cálculos de impostos são aplicados para vendas com natureza de operação voltada ao consumidor final (pessoa física / pessoa jurídica).

Pagamento via cartão de crédito > Necessário que o modulo de Cobranças Especiais (SCO) esteja implantado.

Instalação/Atualização

Vide tópico Pré-requisitos instalação/implantação/utilização.

Datasul

Vide tópico Pré-requisitos instalação/implantação/utilização.

Controle de Versão

O grupo TOTVS, representado por suas marcas, administrará as demandas de evolução das mensagens de integração e demais ajustes, acordando junto aos solicitantes o prazo de liberação de release.

Todas as evoluções programadas deverão ser discutidas

Controle de Versão

O grupo TOTVS, representado por suas marcas, administrará as demandas de evolução das mensagens de integração e demais ajustes, acordando junto aos solicitantes o prazo de liberação de release.

Todas as evoluções programadas deverão ser discutidas e aprovadas pelas marcas antes do início do desenvolvimento e somente serão desenvolvidas em caso de concordância das marcas e alinhamento com as diretivas definidas pelo Comitê de Integração TOTVS.

Suporte

O suporte aos recursos da Integração será de responsabilidade de todas as linhas, sendo assim as equipes de suporte dos produtos Ciashop VTex e Backoffice Datasul estarão aptas a fazer a primeira análise e, quando necessário, repassar para a equipe mais adequada em cada caso.

Observação: Este modelo de suporte está sendo revisado pela TOTVS.

Transações/Entidades/Mensagens únicas

Fluxo das Informações

Os cadastros devem ser realizados no ERP Datasul e replicados para o CiashopE-commerce, por meio do programa de carga presente no ERP DatasulTOTVS Connector. Importante ressaltar que, qualquer movimentação na plataforma do Ciashop E-commerce (inclusão, alteração, eliminação) não é replicada para o ERP Datasul. A operação de eliminação dos registros (referentes aos cadastros) no ERP Datasul, também não integra com o Ciashop.Por meio do programaIntegração Batch Ciashop - PD0624, é possível realizar a carga/atualização dos registros em lote, ele pode ser acessado pelo menu do Datasul em: Logística -> Pedidos -> Tarefas.

O sucesso das operações de inclusão e alteração de registros pode ser verificado acessando o programa Monitor Integração Ciashop - PD0625. Por meio deste programa, é possível realizar a consulta do envio dos registros referente aos cadastros de Estabelecimento, Família Comercial, Itens, Preço Item, Depósito, Saldo em Estoque, recepção dos pedidos e atualização da situação dos pedidos.

No programa Categoria x Itens E-commerce - PD0623, é possível definir todas as famílias comercias (Categoria) e seus respectivos itens (Produtos) que serão enviados ao E-commerce.

Importante ressaltar que, os itens que serão enviados para ao E-commerce precisam obrigatoriamente estarem cadastrados no programa Tabela Preço - CD1508, este cadastro é necessário, pois o preço do produto no E-commerce é o valor informado no campo Preço FOB do programa CD1508. E a tabela de preço ao quais os itens estão vinculados devem estar cadastradas no programa Loja x Tabelas de Preço E-commerce - PD0627 ou para versões superiores a 12.1.2311 utilizar o cadastro da Central de Configurações E-commerce

No programa Categoria x Itens Ciashop - PD0623, é possível definir todas as famílias comercias (Categoria) e seus respectivos itens (Produtos) que serão enviados ao Ciashop. Importante ressaltar que, os itens que serão enviados para o Ciashop precisam obrigatoriamente estarem cadastrados no programa Tabela Preço - CD1508, este cadastro é necessário, pois o preço do produto no Ciashop é o valor informado no campo Preço FOB do programa CD1508. Para que o saldo disponível em estoque do item seja enviado ao CiashopE-commerce, é necessário que este possua saldo em estoque disponível, caso o item não possua saldo, é possível realizar o cadastro por meio do programa Transações Diversas Estoque - CE0220. Para o envio das informações de saldo, será considerado o depósito informado no programa Loja x Estabelecimento Ciashop - PD0310. Já E necessário também cadastrar o depósito por meio do programa  Loja x Depósitos - E-commerce - PD0628 ou para versões superiores a 12.1.2311 utilizar o cadastro da Central de Configurações E-commerce, para o envio do preço saldo do item, será considerada a tabela de preço padrão informada no programa Loja Ciashop - PD0309 Obrigatoriamente, todos os itens enviados para o Ciashop deverão estar cadastrados na tabela de preço informada no programa PD0309, assim como deverão estar cadastrados com saldo em estoque para o depósito informado no programa PD0310. Caso o cliente possua o módulo MultiPreço ou MultiCD da Ciashop, será possível parametrizar mais de uma tabela de preço por meio do programa Loja x Tabelas de Preço Ciashop - PD0627 ou parametrizar mais de um depósito por meio do programa  Loja x Depósitos Ciashop - PD0628 para o envio do preço e saldo do item. Somente será enviado para o e-commerce o saldo em estoque disponível para depósitos associados a loja e para itens que foram destacados para serem enviados para o e-commerce, conforme configurado na Central de Configurações E-commerce. 

Conceito de Grade por ROOT x SKU ao invés de Grade por Referência

• Configuração disponível nos parâmetros da Central de Configurações E-commerce, quando ativo, significa que empresa deixa de utilizar o conceito padrão de grade por referência, e passa a utilizar o conceito de grade por Root e SKU, mais detalhes em Cadastro de Root E-commerce.

Controle do saldo em estoque

Para melhor assertividade no controle dos estoques, o cliente deverá considerar uma das opções abaixo:

- Clientes que trabalham com alocação lógica no pedido devem ter um depósito exclusivo para vendas na Loja ou Marketplace, não poderão trabalhar com mais de um depósito.

- Clientes que trabalham com alocação física automática – o sistema já irá fazer o tratamento correto. 

- Clientes que trabalham com alocação física manual –  a alocação será feita de forma automática para os pedidos com origem igual a Ciashopao E-commerce. 

- Os clientes que forem implantar a integração com Ciashop E-commerce e não trabalharem com alocação no pedido terão que marcar o parâmetro para alocação física – manual e o parâmetro “Realocação Física/Lógica” deverá igual a Não Obrigatória. Desta forma não irá impactar na rotina atual, ou seja, não irá impactar a implantação de pedidos cuja a origem seja diferente de Ciashop E-commerce e, para os pedidos com origem Ciashop E-commerce o tratamento para baixa do estoque será feita de forma correta.

Cadastros 

Antes de enviar os cadastros de estabelecimento, item, família comercial, saldo em estoque, depósito e preço item, é necessário ativar a integração por meio do programa Atualização Parâmetro Global - CD0101, aba Integr II, campo Ciashop:

Image Removed

Realizar a parametrização da loja por meio da funcionalidade Loja Ciashop - PD0309:

Image Removed

Segue detalhamento dos campos: 

• Código Loja: Informar a loja que será utilizada na integração.
• Nome Loja: Descrição da loja.
• Tabela de Preço Padrão: A tabela de preço que for parametrizada no Ciashop como padrão, deverá ser a mesma informada neste campo.
• URL do DANFE: Informar a URL para consulta do DANFE, a URL informada neste campo será disponibilizada no manager do Ciashop.
  
• Nr Último Pedido: Este campo será atualizado conforme a entrada de pedidos oriundos do Ciashop no ERP Datasul. Neste campo estará informado sempre o código do último pedido Ciashop que foi buscado pelo programa PD0624 (Integração Batch Ciashop).
• Assume número do pedido da loja: Altera o número do pedido cliente para o número do pedido da loja.
• Crédito: Indica o crédito que novos clientes implantados a partir da integração irão possuir no sistema. Este campo possui a mesma funcionalidade do campo Crédito da funcionalidade Informações Crédito Clientes (CM0102). 
• Host: O host deverá ser solicitado a Ciashop.
• Porta Padrão: A porta deverá ser solicitada a Ciashop.
• Token: O token deverá ser solicitado a Ciashop.
• multiCD: Quando a funcionalidade de multiCD estiver ativa na plataforma Ciashop, é possível trabalhar com múltiplos depósitos, por meio da funcionalidade Loja x Depósitos Ciashop - PD0628 . 
• multiPreço: Quando a funcionalidade de multiPreço estiver ativa na plataforma Ciashop, é possível trabalhar com múltiplas tabelas de preço, por meio da funcionalidade Loja x Tabelas de Preço Ciashop - PD0627.
• Testar Conexão: Este botão permite que se faça um teste da conexão por estabelecimento com a plataforma Ciashop .

Além disso, é necessário realizar a parametrização da loja por estabelecimento por meio do programa Parâmetros Integrações Ciashop - PD0310:

Image Removed

Segue detalhamento dos campos: 

• Código Loja: Informar a loja que será utilizada na integração 
  
• Estabelecimento: Informar o estabelecimento que será utilizado na integração.
• Grupo Cliente: O grupo cliente padrão será utilizado para a inclusão de clientes no ERP, durante a implantação do pedido oriundo do Ciashop no ERP Datasul. As informações que serão consideradas são: Natureza, Portador, Modalidade, Representante, Atividade, Tipo Receita/Despesa e Percentual de Desconto. Estas informações podem ser consultadas por meio do programa CD0701 (Manutenção Grupo Cliente).
• Natureza de operação: Informar neste campo a natureza de operação estadual que será utilizada durante a implantação do pedido de venda no ERP Datasul.
• Natureza de operação interestadual: Informar neste campo a natureza de operação interestadual que será utilizada durante a implantação do pedido de venda no ERP Datasul.

• Natureza Operação Brinde: Informar neste campo uma natureza de operação estadual que será utilizada durante a implantação do pedido de venda de brinde no Datasul.

• Natureza Interestadual Brinde:Informar neste campo uma natureza de operação interestadual que será utilizada durante a implantação do pedido de venda de brinde no Datasul. 

• Depósito: Na primeira fase a integração não está tratando múltiplos depósitos. Para consulta do saldo em estoque, será considerado apenas o depósito informado neste campo.
• Tipo Op. Venda: Caso esteja habilitada a funcionalidade de sugestão automática da natureza de operação, durante a implantação do pedido de venda, será realizada a sugestão da natureza de operação de acordo com a regra que foi parametrizada para o tipo de operação de venda informada neste campo. Documentação: DPED0082 - Sugestão Automática da Natureza de Operação

Família Comercial:

Para que a integração do cadastro de Família Comercial seja realizada, é obrigatório:

Além disso, é necessário cadastrar esta família comercial no programa Categoria x Itens Ciashop - PD0623:

•     Ao cadastrar uma família comercial, todos os itens vinculados a esta família serão automaticamente apresentados em tela.

As famílias comerciais (no contexto Ciashop possuem a descrição de categorias), enviadas do BackOffice Datasul para o Ciashop, poderão ser consultadas no manager do Ciashop, por meio do menu: Categorias e Produtos -> Gerenciar Categorias:

Image Removed

Item:

Para que a integração do cadastro de itens seja realizada, é obrigatório marcar o parâmetro "Item" no programa Integração Batch Ciashop - PD0624, aba parâmetro:

Image Removed

Além disso, é necessário definir que este item será considerado na integração com o Ciashop por meio do programa Categoria x Itens Ciashop - PD0623:

Image Removed

• A imagem acima é uma demonstração de que os itens TV-4k e TV-LED serão considerados na integração com o Ciashop.
• Além disso, é necessário cadastrar os itens que serão enviados para o Ciashop na tabela de preço (Tabela Preço - CD1508) que foi informado no programa Loja Ciashop - PD0309.

• Caso necessário, é possível informar para os itens que serão enviados ao Ciashop o código EAN/GTIN por meio do campo Cód GTIN (TRIB), que está localizado no programa Atualização Itens Faturamento - CD0903, aba Fiscal.

• Para itens com referência, é necessário que seja informado no campo "tipo de referência" do programa Manutenção Referências Itens - CD1506 a identificação da referência. Por exemplo: Cor, Tamanho e entre outros.

Os itens enviados do BackOffice Datasul para o Ciashop, poderão ser consultados no manager do Ciashop, por meio do menu: Categorias e Produtos -> Catálogos de Produtos:

Image Removed

Preço/Tabela de Preço:

Para que a integração da atualização do preço do item seja realizada, é obrigatório:

• Integração Ciashop ativada no programa Atualização Parâmetro Global - CD0101.
  
• A tabela de preço informada no programa Loja Ciashop - PD0309 deve estar cadastrada no manager do Ciashop. Caso o cliente possua o módulo MultiPreço da Ciashop, as demais tabelas de preços cadastradas no manager da Ciashop precisam ser vinculadas no programa Loja x Tabelas de Preço Ciashop - PD0627.
• Definir os itens que serão considerados na integração com o Ciashop por meio do programa Categoria x Itens Ciashop - PD0623.
  

Além disso, é necessário cadastrar os preços para todos os itens que serão enviados para o Ciashop por meio do programa Tabela Preço - CD1508:

 Image Removed

Os preços enviados do BackOffice Datasul para o Ciashop, poderão ser consultados no manager do Ciashop, por meio do menu: Categorias e Produtos -> Catálogos de Produtos -> Cadastros de Produtos -> Preço e Estoque:

Saldo em Estoque: 

Para que a integração da atualização do saldo em estoque disponível dos itens seja realizada, é obrigatório:

O cadastro de saldo em estoque poderá ser realizado por meio do programa Transações Diversas Estoque - CE0220:

•  Os itens que serão integrados, deverão estar com saldo em estoque cadastrados para o depósito informado no programa PD0310. Caso o cliente possua o módulo MultiCD da Ciashop, será possível vincular mais de um depósito no programa Loja x Depósitos Ciashop - PD0628 para a busca do saldo em estoque.

 Image Removed

O saldo em estoque enviado do BackOffice Datasul para o Ciashop, poderá ser consultado no manager do Ciashop, por meio do menu: Categorias e Produtos -> Catálogos de Produtos -> Cadastros de Produtos -> Preço e Estoque:Image Removed

Quando a funcionalidade de MultiCD estiver ativa na plataforma Ciashop, é possível consultar os depósitos e suas respectivas quantidades de saldo em estoque, para isso é necessário clicar no lápis localizado ao lado campo Estoque Armazém. 

Image Removed

Após clicar no lápis, será aberta a tela que apresenta todos os depósitos disponíveis para o item selecionado:  

Image Removed

Por meio do programa Monitor Integração Ciashop - PD0625, é possível realizar a consulta do envio dos registros referente aos cadastros de Estabelecimento, Família Comercial, Itens, Preço Item, Depósito, Saldo em Estoque, recepção dos pedidos e atualização da situação dos pedidos:

• Quando um registro for integrado com sucesso, a cor do registro na grade ficará destacada em azul.
• Quando um registro não for integrado com sucesso, a cor do registro na grade ficará destacada em vermelho.

Image RemovedSegue o detalhamento dos campos:

• Loja: Filtra a consulta das mensagens pela faixa de loja.
• Data do Registro: Filtra a consulta das mensagens pela faixa de data do registro.
• Nr Docto: Filtra a consulta das mensagens pela faixa de número do documento.
• Documento: Filtra a consulta das mensagens por documento (Todos, Categoria, Item, Preço, Saldo, Pedido, Estabelecimento ou Depósito).
• Processado: Filtra a consulta das mensagens pela situação do processamento da mensagem (Ambos, processado com sucesso ou não processado com sucesso).
• Origem: Filtra a consulta das mensagens pela origem da mensagem (Ambos, mensagem recebida – IN ou mensagem enviada - OUT).
• Check: Realiza a atualização do browse registros de acordo com a parametrização informada.

Segue detalhamento dos botões: 

Para ativar a integração, acessar a rotina Atualização Parâmetro Global - CD0101, aba Integr II,  e marcar o campo E-commerce:

Image Added

Realizar as parametrizações na Central de Central de Configurações E-commerce, essa rotina nova em HTML substituí alguns dos cadastros descritos mais abaixo que não estão mais disponíveis à partir da 12.1.2307.

1) Cadastro e Consulta de múltiplas lojas:

Image Added

2) Parâmetros Gerais E-commerce:

Image Added

2) Configuração dos parâmetros da Loja e associação dos Estabelecimentos, Tabelas de Preço, Depósitos, Categorias/Itens e Clientes (Esse somente para lojas no modelo de negócio B2B) :

Image Added

Realizar a parametrização da loja por meio da funcionalidade Loja E-commerce - PD0309, disponível somente até 12.1.2311 (Substituído pela Central de Configurações E-commerce):

Image Added

Segue detalhamento dos campos: 

• Código Loja: Código da Loja.
• Nome Loja: Descrição da loja.
• Grupo Cliente: O grupo cliente padrão será utilizado para a inclusão de clientes no ERP, durante a implantação do pedido oriundo do E-commerce no ERP Datasul. As informações que serão consideradas são: Natureza, Portador, Modalidade, Representante, Atividade, Tipo Receita/Despesa e Percentual de Desconto. Estas informações podem ser consultadas por meio do programa CD0701 (Manutenção Grupo Cliente).

• Completa Pedido: Define se o pedido oriundo do E-commerce entrará no ERP Datasul completo.
• Assume número do pedido da loja: Altera o número do pedido cliente para o número do pedido da loja.
• Não permite entrada do pedido se a sugestão automática não encontrar regra: Ao marcar essa opção, se algum item do pedido não tiver sua natureza de operação alterada por alguma natureza da regra da sugestão automática de natureza de operação, o pedido não entrará no ERP, sendo rejeitado com a mensagem: 57382 - Natureza operação não encontrada com a sugestão automática.

Obs.: Esse erro será apresentado no log do Connector. Após inserir regra que atenda o item rejeitado, o pedido será reprocessado e integrado.

• Crédito: Indica o crédito que novos clientes implantados a partir da integração irão possuir no sistema. Este campo possui a mesma funcionalidade do campo Crédito da funcionalidade Informações Crédito Clientes (CM0102). 

Além disso, é necessário realizar a parametrização da loja por estabelecimento por meio do programa Loja x Estabelecimento E-commerce - PD0310, disponível somente até 12.1.2311 (Substituído pela Central de Configurações E-commerce):

Image Added

Segue detalhamento dos campos: 

• Código Loja: Informar a loja que será utilizada na integração 
  
• Estabelecimento: Informar o estabelecimento que será utilizado na integração.
• Natureza de operação: Informar neste campo a natureza de operação estadual que será utilizada durante a implantação do pedido de venda no ERP Datasul.
• Natureza de operação interestadual: Informar neste campo a natureza de operação interestadual que será utilizada durante a implantação do pedido de venda no ERP Datasul.

• Natureza Operação Brinde: Informar neste campo uma natureza de operação estadual que será utilizada durante a implantação do pedido de venda de brinde no Datasul.

• Natureza Interestadual Brinde: Informar neste campo uma natureza de operação interestadual que será utilizada durante a implantação do pedido de venda de brinde no Datasul. 

• Tipo Op. Venda: Caso esteja habilitada a funcionalidade de sugestão automática da natureza de operação, durante a implantação do pedido de venda, será realizada a sugestão da natureza de operação de acordo com a regra que foi parametrizada para o tipo de operação de venda informada neste campo. Documentação: DPED0082 - Sugestão Automática da Natureza de Operação

Família Comercial:

Para que a integração do cadastro de Família Comercial (Categoria no contexto E-commerce) seja realizada, é obrigatório:

•     Integração E-commerce ativada no programa CD0101.
  

Além disso, é necessário cadastrar esta família comercial no programa Categoria x Itens E-commerce - PD0623, disponível somente até 12.1.2311 (Substituído pela Central de Configurações E-commerce):

•     Ao cadastrar uma família comercial (Categoria no contexto E-commerce), todos os itens vinculados a esta família serão automaticamente apresentados em tela.

Image Added

As famílias comerciais (no contexto E-commerce possuem a descrição de categorias), enviadas do ERP Datasul para o E-commerce, poderão ser consultadas no manager do E-commerce, por meio do menu: Produtos → Catálogo → Categorias:

Image Added

Item:

Para que o itens do ERP Datasul sejam enviados para o E-commerce, é obrigatório que o item esteja informado no programa Categoria x Itens E-commerce - PD0623, no GRID inferior direito do programa:

Image Added

• A imagem acima é uma demonstração de que os itens 900100, 900101, 900102, 900103, 900104, 900105,900107, 900200 e 900201 serão considerados na integração com o E-commerce. 
• O item FORNOELETRICO não estará sendo considerado na integração com o E-commerce, pois o GRID inferior esquerdo é somente para apresentar todos os itens que estão vinculados a categoria selecionada, no GRID inferior direito são os itens que foram selecionados para integração.

• Caso necessário, é possível informar para os itens que serão enviados ao E-commerce, o código EAN/GTIN por meio do campo Cód GTIN (TRIB), que está localizado no programa Atualização Itens Faturamento - CD0903, aba "Fiscal". As dimensões do item podem serem informadas na aba "Inf Complem".

• Para itens com referência, o código EAN/GTIN e suas respectivas dimensões são informadas no programa Manutenção Referências Itens - CD1506 por meio do botão "Informações Adicionais Referências Item". 
• Para relacionar itens controlados por referência, primeiramente é necessário que as referências tenham sido vinculadas ao item no programa Manutenção Referências Itens - CD1506, caso contrário, ao tentar relacionar um item uma mensagem será exibida: "Código 57422, Existem item(s) que possui tipo de controle de estoque por referência, mas não foi encontrado nenhuma referência vinculada no programa Manutenção Referências Item(CD1506)".

Image Added

Utilizando o conceito de Root/SKU ao invés do conceito padrão por Referência:

Por meio do Cadastro Root E-commerce é possível informar as grades para associação dos itens e os itens por grade. 

Image Added

Informando os itens por grade (Root):

Image Added

Os itens enviados do ERP Datasul para o E-commerce, poderão ser consultados no manager do E-commerce, por meio do menu: Produtos → Catálogo → Produtos e SKUs:

Image Added

Preço/Tabela de Preço:

Para que a integração da atualização do preço do item seja realizada, é obrigatório:

• Integração E-commerce ativada no programa Atualização Parâmetro Global - CD0101.
  
• As tabelas de preço que serão utilizadas na integração com o E-commerce precisam ser vinculadas no programa Loja x Tabelas de Preço E-commerce - PD0627, disponível somente até 12.1.2311 (Substituído pela Central de Configurações E-commerce)
• Definir os itens que serão considerados na integração com o E-commerce por meio do programa Categoria x Itens E-commerce - PD0623., disponível somente até 12.1.2311 (Substituído pela Central de Configurações E-commerce)
  

Além disso, é necessário cadastrar os preços para todos os itens que serão enviados para o E-commerce, por meio do programa Tabela Preço - CD1508:

•  O Preço do item que será considerado ao enviar o registro para o E-commerce, é o valor informado no campo Preço FOB do programa CD1508.

 Image Added

Os preços enviados do BackOffice Datasul para o E-commerce, poderão ser consultados no manager do E-commerce, por meio do menu: Produtos → Preços → Lista de preços:

Image Added

Saldo em Estoque: 

Para que a integração da atualização do saldo em estoque disponível dos itens seja realizada, é obrigatório:

•  Integração E-commerce ativada no programa CD0101.
  

O cadastro de saldo em estoque poderá ser realizado por meio do programa Transações Diversas Estoque - CE0220:

•  Os itens que serão integrados, deverão estar com saldo em estoque cadastrados para os depósitos informados no programa Loja x Depósitos E-commerce - PD0628, disponível somente até 12.1.2311 (Substituído pela Central de Configurações E-commerce)

 Image Added

• Somente será enviado o saldo em estoque dos itens que estão informados no programa Categoria x Itens E-commerce - PD0623 e dos depósitos informados no programa Loja x Depósitos E-Commerce - PD0628

O saldo em estoque que foi enviado do ERP Datasul para o E-commerce, poderá ser consultado no manager do E-commerce, por meio do menu: Pedidos → Estoque & entrega → Gerenciar inventário:

Image Added

Recepção do Pedido de Venda:

Para que a recepção do pedido de venda seja realizada é obrigatório:

• Integração E-commerce ativada no programa Atualização Parâmetro Global - CD0101
• Vincular o ID da transportadora cadastrada no E-commerce por meio do campo “ID E-commerce” presente no programa Transportadores - CD0402, na aba "Fretes". Caso o ID da transportadora não esteja cadastrado no ERP Datasul, o pedido não será importado com sucesso no ERP Datasul.
• É necessário cadastrar o intermediador (marketplace onde foi realizada a compra do pedido), como um representante no ERP Datasul. Por exemplo, se o pedido foi realizado no marketplace da "Loja A", a "Loja A" deverá ser cadastrada como sendo um representante no ERP Datasul. 
• Necessário também que existam métodos de pagamentos cadastrados no programa Cadastro de Métodos de Pagamento E-commerce (mpd.html.paymentmethodecommerce), de acordo com os métodos de pagamentos que foram disponibilizados no e-commerce, como por exemplo: boleto, transferência bancária, cartão de crédito ou faturado. 
• Acesse a documentação Parametrização - Premissas para verificar as premissas necessárias para integração e-commerce.

Image Added

• A política comercial cadastrada no manager E-commerce deverá estar cadastrada no ERP Datasul, a política comercial poderá ser consultada no manager do E-commerce, por meio do menu: CONFIGURAÇÕES DA LOJA → Políticas Comerciais, e a política comercial do E-commerce deverá ser vinculada a uma tabela de preço no ERP Datasul por meio do botão "Políticas Comerciais" do programa CD1508:

Image Added

Image Added

Image Added

• No programa  Consulta Informações do Pedido de Venda - PD1001, na aba "Geral", é possível consultar no campo Pedido Repres o número do pedido de venda no VTex. E na aba "Sit", no campo Mét. Pgt, o método de pagamento que foi utilizado para este pedido.

Funcionamento dos tipos de métodos de pagamento

1. Tipo Método de Pagamento	Integração de

Confirmar Pagamento: Quando o tipo do pagamento for Boleto ou Transferência Bancária, permite ao usuário executar novamente a atualização da situação do pedido para pagamento aprovado. 

No grid Ocorrências Integração do programa PD0625, é possível detalhar a mensagem de erro com um clique duplo caso necessário.

Image Removed

Recepção do Pedido de Venda:

Para que a recepção do pedido de venda seja realizada é obrigatório:

• Integração Ciashop ativada no programa Atualização Parâmetro Global - CD0101
• Vincular o ID da transportadora cadastrada no Ciashop por meio do campo “ID Ciashop” presente no programa Transportadores - CD0402. Caso o ID da transportadora não esteja cadastrado no ERP Datasul, o pedido não será importado com sucesso no ERP Datasul.
• É necessário cadastrar o nome do canal de origem presente no Ciashop como um representante no ERP Datasul. Por exemplo, se o canal de origem for o Walmart, o Walmart deverá ser cadastrado como sendo um representante no ERP Datasul.

1. Quando a integração for com a Loja do Ciashop, é necessário também que existam métodos de pagamentos cadastrados no programa Cadastro de Métodos de Pagamento Ciashop, de acordo com os métodos de pagamentos que foram disponibilizados na loja, como por exemplo: boleto, transferência bancaria, cartão de crédito ou faturado. Quando a integração for com marketplace, é necessário cadastrar um único método de pagamento, o método de pagamento a ser cadastrado no programa Cadastro de Métodos de Pagamento Ciashop deverá ser o "pagamentoNaoIdentificado" e com o tipo "Faturado".
   Funcionamento dos tipos de métodos de pagamento
   

   Tipo Método de Pagamento	Integração de Título a Receber	Funcionamento
   Boleto	No Pedido de Venda	Será integrado um título a receber por pedido de venda com origem "PEDVDA". Informações obrigatórias: Espécie, Série Fiscal, Portador e Carteira Informações opcionais: Cliente e Representante Deverá ser informada um espécie de título do módulo de contas a receber parametrizada com os campos Contabilização = Não e Gera Antecipação = Sim (exemplo abaixo). Deverá ser informada uma série fiscal cadastrada no programa UTB113AA. Deverão ser informados um portador e carteira cadastrados e compatíveis com o banco emissor do boleto proveniente da plataforma CiashopVTex. Quando o título a receber integrado for liquidado integralmente, o pedido de venda será liberado para faturamento e será criada uma antecipação para o cliente com origem PEDVDA vinculada ao respectivo pedido. O titulo título a receber proveniente do faturamento (nota fiscal) também será integrado ao módulo de contas a receber e será liquidado automaticamente na integração, usando a antecipação gerada na liquidação da baixa do título do boleto. Esta liquidação automática poderá ser desativada no programa ACR009AA, desmarcando a opção "Abater Antecip PEDVDA Automaticamente" (abaixo). Importante: Para pagamento com métodos de pagamento "Boleto", a plataforma da Ciashop VTex informa o número bancário (nosso número). Desta forma, é possível usar a rotina de retorno de cobrança escritural para liquidas liquidar os títulos.
   Transferência Bancária	No Pedido de Venda	O funcionamento do tipo de método de pagamento "Transferência Bancária" é idêntica ao tipo de método de pagamento "Boleto" descrito acima. A única diferença é que a plataforma não informa o número bancário (porque não existe) e as liquidações deverão ser feitas manualmente no módulo de Contas a Receber.
   Cartão de Crédito	Na Nota Fiscal	No tipo de método de pagamento "Cartão de Crédito", o risco de crédito é assumido pela Administradora de Cartão, portanto, o pedido entra liberado para faturamento e os títulos são integrados a partir da nota fiscal. Além do módulo de Contas a Receber, as vendas com cartão de crédito são integradas com o módulo de Cobranças Especiais que controlará o parcelamento da venda e o percentual de comissão retida pelas administradoras. Informações obrigatórias: Portador, Carteira, Administradora e Bandeira. O cadastro de Administradora/Carteira deverá ser feito no programa ACR002AA. Informação opcional: Representante.
   Faturado	Na Nota Fiscal	No tipo de método de pagamento "Faturado", o pedido de venda deverá ter seu crédito aprovado para liberá-lo para faturamento e o título a receber será integrado a partir do faturamento (nota fiscal). Este deverá ser o tipo de método de pagamento quando se estiver trabalhando com Marketplaces, em que este recebe os valores do consumidor final e os repassa periodicamente para a empresa vendedora. Informações obrigatórias: Portador e Carteira Informação opcional: Cliente e Representante.

   Importante:

   Estorno de títulos a receber e cancelamento de pedido de venda:

   Para títulos a receber integrados a partir do pedido de venda (Boleta Boleto e Transferência Bancária) é possível estornar os títulos não pagos através por meio do programa ACR546AA (abaixo). Este programa estornará os títulos a receber e cancelará o pedido de venda. Esta opção foi criada para facilitar o controle dos pagamento com boleto e transferência bancária, pois ocorre frequentemente que o cliente desiste da compra e não efetua o pagamento. Selecionar a opção "Somente títulos origem PEDVDA".

   

A recepção do pedido de venda é realizada por meio do parâmetro "Pedido Venda" no programa Integração Batch Ciashop (PD0624), aba parâmetro:

• Por meio do programa Monitor Integração Ciashop - PD0625, será possível verificar se o pedido foi importado com sucesso ou não, em caso de falha, será possível realizar a importação desse pedido novamente por meio do botão "Buscar Pedido", localizado no programa PD0625.
• No programa Loja Ciashop - PD0309, existe o campo Nr Último Pedido, sempre que a recepção do pedido de venda for executada, o pedido a ser solicitado ao Ciashop, sempre será o número do último pedido + 1, ou seja, caso no campo Nr último Pedido esteja armazenado o valor 20, será solicitado ao Ciashop todos os pedidos que possuírem o número de pedido superior ao 20.
• Para a recepção de novos pedidos, utilizar o programa Integração Batch Ciashop - PD0624 para pedidos que já foram importados do Ciashop, mas que por algum motivo não foram incluídos com sucesso, utilizar o botão "Buscar Pedido" do programa Monitor Integração Ciashop - PD0625.
• No programa  Consulta Informações do Pedido de Venda - PD1001, na aba "Geral", é possível consultar no campo Pedido Repres o número do pedido de venda no Ciashop. E na aba "Sit", no campo Mét. Pgt, o método de pagamento que foi utilizado para este pedido.
   
  

Os pedidos disponíveis no Ciashop, poderão ser consultados no manager do Ciashop, por meio do menu: Minhas Vendas -> Gerenciar Pedidos -> Listagem de Pedidos:

Image Removed

Atualização da situação do Pedido de Venda: 

Para a atualização da situação do pedido de venda, é obrigatório:

•  Integração Ciashop ativada no programa CD0101. 

A atualização da situação do pedido de venda é realizada por meio do parâmetro "Atualizar situação dos Pedidos " no programa Integração Batch Ciashop - PD0624, aba parâmetro:

A situação dos pedidos disponíveis no Ciashop, poderão ser consultados no manager do Ciashop, por meio do menu: Minhas Vendas -> Gerenciar Pedidos -> Listagem de Pedidos. Ou por meio do programa Monitor Integração Ciashop - PD0625 no BackOffice Datasul, coluna "Situação":

Envio da Nota Fiscal para o Ciashop:

O envio da nota fiscal para o Ciashop é realizado após o uso autorizado da Nota Fiscal que foi originada a partir de um pedido de venda oriundo do Ciashop :

Image Removed

No momento do envio da nota fiscal para o Ciashop será atualizado a situação do pedido para Empacotado.

Os dados da nota fiscal poderá ser consultada no manager do Ciashop, por meio do menu: Minhas Vendas -> Gerenciar Pedidos -> Informações do Pedido:

Image Removed

Ao clicar no botão Editar, será possível consultar maiores informações da Nota Fiscal:

Image Removed

Envio da URL de rastreamento para o Ciashop: 

Para a atualização da situação do pedido de venda, é obrigatório:

•  A nota fiscal deverá ter sido gerada a partir de um pedido de venda oriundo do Ciashop. 

O envio da URL de rastreamento para o Ciashop é realizado por meio do botão "Rastreamento" no programa Manutenção Notas Fiscais - FT0502, Aba Inf Gerais:

Image Removed

Ao clicar no botão Rastreamento, informar a URL de rastreamento, ao clicar no botão "OK", esta URL será enviada para o Ciashop:

Image Removed

Após informar a URL no Datasul, será atualizado no Ciashop o status do pedido para Enviado.

A URL de rastreamento poderá ser consultada no manager do Ciashop, por meio do menu: Minhas Vendas -> Gerenciar Pedidos -> Listagem de Pedidos -> Visualização do Pedido:

Image Removed

Consulta Pedido de Pagamento Ciashop:

Permite consultar as informações do pagamento do pedido de todos os pedidos de vendas que são oriundos da integração com o Ciashop:

Image Removed

Image Removed

Limitações / Restrições Gerais

• Ao eliminar um registro no Ciashop, este registro não será eliminado automaticamente no BackOffice Datasul.
• Caso o item possua algum caractere especial no nome, o caractere especial será retirado durante o envio para o Ciashop. No Ciashop o item será apresentado sem caracteres especiais.

Os pedidos disponíveis no E-commerce, poderão ser consultados no manager do E-commerce, por meio do menu: Pedidos → Gerenciamento de pedidos → Todos os pedidos:

Image Added

Atualização da situação do Pedido de Venda: 

Para a atualização da situação do pedido de venda, é obrigatório:

•  Integração E-commerce ativada no programa CD0101. 

A atualização da situação do pedido de venda no E-commerce é realizada em dois momentos:

• Pedidos cancelados no ERP Datasul
• Pedidos faturados no ERP Datasul

A situação dos pedidos disponíveis no ERP Datasul, poderão ser consultados no manager do E-commerce, por meio do menu: Pedidos → Gerenciamento de pedidos → Todos os pedidos, selecionar um dos pedidos listados para que seja possível verificar a situação do pedido selecionado:

Image Added

Envio da Nota Fiscal para o E-commerce:

Após o envio da nota fiscal para o E-commerce, o fluxo do pedido no E-commerce é atualizado para "Faturado" e é possível consultar em FATURA o número da nota fiscal e o seu respectivo valor:

Image Added

Pedido cancelado no ERP Datasul: 

Após o cancelamento do pedido no ERP Datasul, o pedido será cancelado também no E-commerce:

Image Added

Limitações / Restrições Gerais

• Ao eliminar um registro no E-commerce, este registro não será eliminado automaticamente no ERP Datasul.
• Itens vinculados ao E-commerce não poderão ter seus códigos e/ou unidades de medidas alteradas pelo programa CD0205 - Alteração Códigos Unidades Itens. Isso porque não altera o código do item na tabela item-integr-loja. Ficando o registro nela com o código do item antigo "perdido". Caso seja necessário alteração de um item E-commece recomendamos a criação de um novo item com o novo código no sistema. Em última instância, caso não seja possível criar um novo item, deverá ser desvinculado do E-commerce e realizada a alteração pelo CD0205.

Links

• Rotinas - Documentação de todos os programas da integração e-commerce
• Parametrização - Premissas - Documentação dos procedimentos que devem serem realizados para que a integração e-commerce ocorra
• Central de Configurações E-commerce - Manutenção e configuração por loja dos dados utilizado para integrar com o e-commerce.
• Cadastro de Root E-commerce - Manutenção e configuração das grades e itens no modelo Root x SKU.
• Fluxo - Boleto e Transferência Bancária - Documentação do fluxo de um pedido com o método de pagamento boleto/transferência bancária
• Fluxo - Cartão de Crédito - Documentação do fluxo de um pedido com o método de pagamento cartão de crédito/débito
• Fluxo - Faturado ou Intermediador - Documentação do fluxo de um pedido com o método de pagamento faturado
• Rotas REST - E-commerce - Documentação das rotas envolvidas na integração e-commerce
• DT Nova rota na API pública de Simulação de Impostos para Ecommerce B2B
• DT Nova rota na API pública de Notas Fiscais de Ecommerce Autorizadas para Ecommerce B2B

Erros de integração:

DATASUL >

CIASHOP

DATASUL >

DATASUL >

CIASHOP

DATASUL >

DATASUL >

DATASUL >

DATASUL >

DATASUL >

DATASUL >

DATASUL >