A integração entre o BackOffice Datasul e a Plataforma de E-commerce tem como objetivo realizar a comunicação da loja de comércio eletrônico com o ERP Datasul.
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 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.
A forma de comunicação entre ERP DATASUL e 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.
A plataforma Framework VTEX é uma plataforma em que o cliente pode montar sua própria loja de comércio eletrônico.
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. 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 Cadastros de Famílias Comerciais, Itens, Preços do Item, Depósitos e Saldo em Estoque disponível do Datasul para o E-commerce. Assim como, a integração do recebimento de pedidos de venda oriundos do E-commerce e a atualização do status destes pedidos.
Versão\release 12.1.32
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: 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.
Vide tópico Pré-requisitos instalação/implantação/utilização.
Vide tópico Pré-requisitos instalação/implantação/utilizaçã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.
O suporte aos recursos da Integração será de responsabilidade de todas as linhas, sendo assim as equipes de suporte dos produtos 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.
Método | ID | Descrição | Origem | Destino | API |
Cadastros | 01 | Família Comercial | E-commerce | Datasul | apiBusinessFamilyPublic |
02 | Itens | E-commerce | Datasul | apiProductPublic | |
03 | Preço Item | E-commerce | Datasul | priceItemPublic | |
04 | Tabela Preço | E-commerce | Datasul | priceTablePublic | |
05 | Saldo Estoque | E-commerce | Datasul | stockBalancePublic | |
Processos | 01 | Receber pedidos | E-commerce | Datasul | apiOrdersPublic |
02 | Receber clientes | E-commerce | Datasul | apiCustomerPublic | |
03 | Cancelar Pedido | E-commerce | Datasul | apiOrdersPublic | |
04 | Atualizar NF-e | E-commerce | Datasul | apiInvoicePublic |
Os cadastros devem ser realizados no ERP Datasul e replicados para o E-commerce, por meio do TOTVS Connector. Importante ressaltar que, qualquer movimentação na plataforma do E-commerce (inclusão, alteração, eliminação) não é replicada para o ERP Datasul.
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.
Para que o saldo disponível em estoque do item seja enviado ao E-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. E necessário também cadastrar o depósito por meio do programa Loja x Depósitos - E-commerce - PD0628 para o envio do saldo do item. Somente será enviado para o e-commerce o saldo em estoque disponível dos depósitos que foram cadastrados no programa PD0628 e dos itens que foram destacados para serem enviados para o e-commerce no programa PD0623.
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 ao E-commerce.
- Os clientes que forem implantar a integração com 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 E-commerce e, para os pedidos com origem E-commerce o tratamento para baixa do estoque será feita de forma correta.
Cadastros
Obs.: Esse erro será apresentado no log do Connector. Após inserir regra que atenda o item rejeitado, o pedido será reprocessado e integrado.
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.
Família Comercial:
Para que a integração do cadastro de Família Comercial (Categoria no contexto E-commerce) seja realizada, é obrigatório:
Além disso, é necessário cadastrar esta família comercial no programa Categoria x Itens E-commerce - PD0623:
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:
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:
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".
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:
Preço/Tabela de Preço:
Para que a integração da atualização do preço do item seja realizada, é obrigatório:
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:
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:
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:
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:
Recepção do Pedido de Venda:
Para que a recepção do pedido de venda seja realizada é obrigatório:
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 VTex. 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 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 VTex informa o número bancário (nosso número). Desta forma, é possível usar a rotina de retorno de cobrança escritural para 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 (Boleto e Transferência Bancária) é possível estornar os títulos não pagos 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".
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:
Atualização da situação do Pedido de Venda:
Para a atualização da situação do pedido de venda, é obrigatório:
A atualização da situação do pedido de venda no E-commerce é realizada em dois momentos:
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:
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:
Pedido cancelado no ERP Datasul:
Após o cancelamento do pedido no ERP Datasul, o pedido será cancelado também no E-commerce: