Páginas filhas
  • Parametrização - Premissas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.
Aviso
titleAviso:

Os programas PD0309, PD0310, PD0623, PD0627 e PD0628 estarão disponíveis até a release 12.1.2311 do sistema para utilização com uma loja por modelo de negócio (B2C/B2B). Para suporte a múltiplas lojas por modelo de negócio ou a partir da versão 12.1.2403 deverá ser utilizada a Central de Configurações E-commerce (https://tdn.totvs.com/x/NhvKK).

CD0101 – Atualização Parâmetro Global

...

Responsável por Habilitar/Desabilitar a funcionalidade do E-commerce por meio do parâmetro "E-commerce".


CD0402 - Transportadores

Image RemovedImage Added

Função:

Vincular o ID da transportadora cadastrada no E-commerce por meio do campo “ID E-commerce” a uma transportadora no ERP Datasul.

Caso o ID da transportadora não esteja cadastrado no ERP Datasul, o pedido não será importado com sucesso no ERP Datasul. Sem o vinculo vínculo será apresentada a mensagem de erro durante a integração do pedido:

 * Código: 55098 
 * Mensagem: Transportadora com ID 1 no E-commerce não cadastrada no ERP.

OBS: O ID 1 é um código fictício para ilustrar a mensagem de erro, esse ID de transportadora é gerado no momento que é realizado o cadastro da transportadora na VTEX (Essa informação deverá ser solicitada ao implantador VTEX). Essa mensagem poderá ser visualizada de duas formas, sendo elas:

Monitor TOTVS Connector

Image Added
Log do appserver:

[22/02/14@16:34:21.999-0300] P-012472 T-006624 2 AS 4GLTRACE       Invoke convertLongcharToJsonObject "{"RowErrors":[{"ErrorSequence":0,"ErrorNumber":5509855098,"ErrorDescription":"Transportadora com ID 1 no E-commerce não cadastrada!","ErrorParameters":"","ErrorType":"EMS","ErrorHelp":"Transportadora com ID 1 de código 55098 - Transportadora com ID "código da transportadora na vtex" no E-commerce não cadastrada no ERP.","ErrorSubType":"ERROR"}]}" [convertTempTableToJsonObject - com.totvs.framework.api.JsonAPIUtils @ 218]

O valor apresentado em "código da transportadora na vtexapós o ID, neste exemplo  o valor "1", é o valor que deve ser informado no campo ID E-commerce do programa CD0402. Significa que o código que da transportadora que está vindo da VTEX é 1, e esse valor deverá ser vinculado a uma transportadora no programa CD0402, por meio do campo "ID E-commerce". Na imagem abaixo, o vínculo da transportadora de código 1 na VTEX foi vinculado a transportadora de código 99.999 no ERP Datasul.

Image Added

Agora toda vez que a VTEX enviar um pedido que possui o código da transportadora 1 na VTEX, o pedido entrará no ERP Datasul com a transportadora 99999 - Padrão.

Informações adicionais para implantador VTEX:

O Código da transportador na VTEX, vem informado na tag "codeCarrier" do JSON do pedido de venda. O valor apresentado na tag codeCarrier é o valor que deve ser informado no campo ID E-commerce do programa CD0402.

Image Added

Utilizando como exemplo a imagem acima do programa CD0402, o valor informado no campo ID E-commerce foi "19301". Isso significa que o código da transportadora que veio da VTEX no JSON do pedido foi codeCarrier:  "19301". Com isso, toda vez , que vir o código de transportadora da VTEX 19301, o pedido entrará com a transportadora 16 - J.R PEREIRA TRANSPORTES 99999 - Padrão no ERP Datasul.


CD0708 – Atualização Representante

Image AddedImage Removed

Função:

É necessário cadastrar o nome do marketplace/e-commerce (onde os produtos serão disponibilizados para venda), como um representante no ERP Datasul. Por exemplo, se o marketplace onde os produtos foram disponibilizados foi a Americanas, a Americanas o "MarketplaceA", deverá ser cadastrado como sendo um representante no ERP Datasul. 

Caso não seja encontrado no ERP Datasul , um representante com o nome abreviado do marketplace, o pedido não será importado com sucesso. Sem o vinculo vínculo será apresentada a mensagem de erro durante a integração do pedido, mensagem de código 2 - :

 * Código: 2
 * Mensagem: Não foi encontrada ocorrência em Representante com a chave informada. Representante: "MarketplaceA". 

Essa mensagem poderá ser visualizada de duas formas, sendo elas:

Monitor Totvs Connector

Image Added

Log do appserver 

[22/02/14@17:12:45.730-0300] P-015364 T-001296 2 AS 4GLTRACE       Invoke convertLongcharToJsonObject "{"RowErrors":[{"ErrorSequence":1,"ErrorNumber":2,"ErrorDescription":"Não encontrado(a) Representante para chave informada.","ErrorParameters":"Representante~Representante: Loja Pedido Cliente: 501229 Cliente: Diogo Luiz","ErrorType":"EMS","ErrorHelp":"Não foi encontrada ocorrência em Representante com a chave informada. Representante: "nome do marketplace".\nRepresentante: Loja Pedido Cliente: 501229 Cliente: Diogo Luiz\n","ErrorSubType":"ERROR"}]}" [convertTempTableToJsonObject - com.totvs.framework.api.Js

O valor apresentado em "nome do marketplace", é o valor que deve ser informado Loja", poderá ser incluso/alterado por meio do programa "prgint/utb/utb112aa - Manutenção de representante", e visualizado no campo nome abreviado do programa CD0708.  O Código do marketplace onde o produto foi disponibilizado, vem informado na tag "sourceChannel" do JSON do pedido de venda. O valor apresentado na tag sourceChannel O valor apresentado após o Representante:, neste exemplo  o valor "Loja", é o valor que deve ser informado visualizado no campo nome abreviado do programa CD0708.

Utilizando como exemplo a imagem acima do programa CD0708, o representante foi cadastrado com o nome abreviado: Americanas. Isso significa que o nome do marketplace que veio da VTEX no JSON do pedido foi sourceChannel:  "Americanas". Com isso toda vez, que vir um pedido onde a venda foi realizada na Americanas, o pedido entrará com o representante 4 - Americanas no ERP Datasul.

Significa que o marketplace onde os produtos foram disponibilizados para venda que está vindo da VTEX é o marketplace "Loja", e esse valor deverá ser vinculado a um nome abreviado de representante no ERP Datasul. Na imagem abaixo, o vínculo do marketplace "Loja" na VTEX foi vinculado a representante de código 2 -  Loja no ERP Datasul.

Image Added

Agora toda vez que a VTEX enviar um pedido que foi realizado no marketplace "Loja", o pedido entrará no ERP Datasul com o representante 2 - Loja.

Image Added

Venda com mais de um marketplace:

Caso os produtos sejam disponibilizados em mais de um marketplace, por exemplo, se além de vender no marketplace da Americanas, "Loja" os produtos também sejam vendidos no marketplace Submarino. Se no JSON do pedido na tag sourceChannel: "Submarino", vier o valor Submarino, este marketplace também deverá ser cadastrado com o nome abreviado Submarino no programa CD0708. Utilizando a imagem abaixo como exemplo, toda vez que vier para o ERP Datasul um pedido que foi vendido no markeplace Submarino, este pedido entrará com o representante 650 - SUBMARINO no ERP DATASUL.marketplace "Loja B", será necessário vincular o markeplace "Loja B" a um novo representante, assim como foi feito para o marketplace "Loja".

Image Added

Image Added

Informações adicionais para implantador VTEX:

O Código do marketplace onde o produto foi disponibilizado, vem informado na tag "sourceChannel" do JSON do pedido de venda. O valor apresentado na tag sourceChannel é o valor que poderá ser visualizado no campo "nome abreviado" do programa CD0708.

Toda vez que vir um pedido onde a venda foi realizada no marketplace "Loja", o pedido entrará no ERP DATASUL como representante "2 - Loja".

Image Added

Image Added

Toda vez que vir um pedido onde a venda foi realizada no marketplace "Loja B", o pedido entrará no ERP DATASUL como representante "4 - Loja B".

Image Added

Image AddedImage Removed


FT0301 - Atualização Parâmetros Faturamento

...

Marcar o parâmetro ICMS incluso no preço, como a plataforma da Ciashop do e-commerce não efetua o cálculo de impostos, os preços deverão ser cadastrados nas tabelas de preços já com o ICMS Incluso no preço.

...

CD0606 - Natureza Operação

Image RemovedImage Added

Função:

Marcar o parâmetro Consumidor Final, pois a integração Ciashop x pois a integração e-commerce x ERP Datasul trata somente operações B2C e por este motivo, todas as operações deverão estar parametrizadas para Consumidor Final. Sendo assim, marcar também o parâmetro Incluir Frete Base IPI, para que o frete seja incluso na base de cálculo do IPI. O parâmetro Incluir IPI Base ICMS também deverá ser marcado ( para naturezas de operação de consumidor final o IPI deve estar parametrizado para ser incluído na base de ICMS). Além disso, o parâmetro  Tipo Base do IPI deve estar parametrizado como Líquido.

Importante ressaltar que todas as naturezas de operação utilizadas nos pedidos que serão integrados pelo

...

e-commerce, deverão possuir essa parametrização, caso contrário o valor do pedido no ERP Datasul

...

não

...

será o mesmo do pedido

...

no e-commerce. Por isso a importância de parametrizar as naturezas de operação informadas no programa PD0310

...

.

IMPORTANTE: Caso informado um tipo de operação

...

no programa PD0310, fazendo com que os pedidos integrados pelo e-commerce utilizem também a sugestão automática da natureza de operação, será necessário parametrizar

...

todas as naturezas que foram vinculadas ao tipo de operação informado no programa PD0310.


CD0206 - Família Comercial

Image Added

Função: 

Para cadastrar uma categoria no E-commerce, é necessário primeiramente cadastrar uma família comercial no ERP Datasul. 

A família comercial no ERP Datasul é uma entidade enviada para o e-commerce, mas no e-commerce a família comercial do ERP Datasul possui o contexto de categoria.

Para que a família comercial (contexto ERP Datasul) seja enviada para o e-commerce, é necessário que a família comercial seja cadastrada como uma categoria no programa PD0623 - Categoria x Itens E-commerce.

Com a família comercial devidamente cadastrada no programa CD0206, acessar o programa PD0623, onde serão listadas todas as categorias cadastradas que serão apresentadas no e-commerce:

Image Added

Para cadastrar uma categoria, clicar no botão "Incluir" do browse "Categoria".

Após clicar no botão "Incluir" será apresentada a tela abaixo:

Image Added

  • No campo "Família Comercial", informar o nome da família comercial cadastrada no programa CD0206 - Família Comercial;
  • No campo "Categoria", informar o nome da categoria que será apresentada no e-commerce (não necessariamente precisa ser o mesmo nome da família comercial no ERP Datasul);
  • No campo "Ativa", deixar marcado este campo para que a categoria seja apresentada no e-commerce, caso este campo esteja desmarcado, a categoria não será apresentada no e-commerce;
  • No campo "Descrição Categoria", descrever do que se trata a categoria em questão.

Após preencher as informações, clicar no botão "Salvar".

Image Added

IMPORTANTE: Para cadastro de categorias em cascata no e-commerce. será necessário indicar qual é a família comercial pai no programa CD0206.

Por exemplo, suponhamos que gostaríamos de apresentar no e-commerce a categoria TV SMART, e que dentro da categoria TV SMART, sejam apresentadas duas categorias separadas, a categoria TV 32 e categoria TV 4K conforme imagem abaixo:

Image Added

Acessar o programa CD0206  - família comercial, cadastrar a família comercial TV 32 e no campo "Família Comercial Pai" informar categoria TV. 

Image Added

Como a família comercial "TV" já foi cadastrada no programa PD0623, para ser enviada para o e-commerce, será apresentada a mensagem 57351:

Image Added 

Ao clicar no botão "Sim", A família comercial TV 32 será automaticamente cadastrada no programa PD0623. 

Image Added

Como o objetivo é vincular também a categoria TV 4K como uma categoria filha da categoria SMART TV, no programa CD0206 cadastrar a família comercial TV 4K e no campo "Família Comercial Pai" informar a categoria "TV"

Image Added

Image Added 

Ao clicar no botão "Sim", A família comercial TV 4K será automaticamente cadastrada no programa PD0623. 

Image Added

Portanto para que seja possível criar uma estrutura de categorias em cascata, as famílias comerciais devem estar previamente cadastradas no programa CD0206. No programa CD0206 deverá ser informado qual a família comercial pai, e estas famílias comerciais devem estar cadastradas no programa PD0623 como sendo um categoria que será considerada no e-commerce.


mpd.html.paymentmethodecommerce - Cadastro de Métodos de Pagamento E-commerce

Image Added

Todo pedido realizado no e-commerce, possui um método de pagamento. Na imagem abaixo o pedido foi pago com o cartão de crédito de bandeira visa:

Image Added

É necessário cadastrar o nome do método de pagamento (visa, mastercard, cielo) no ERP Datasul. Por exemplo, o pedido acima foi pago com o método de pagamento visa, este método possui um nome no e-commerce e ele deverá ser cadastrado no ERP Datasul no programa Cadastro de Métodos de Pagamento E-commerce. 

Caso não seja encontrado no ERP Datasul o método de pagamento que veio do e-commerce, o pedido não será importado com sucesso. Sem o vínculo será apresentada a mensagem de erro durante a integração do pedido:

 * Código: 55314
 * Mensagem: Não foi cadastrado o método de pagamento &1 e estabelecimento &2  no programa "Cadastro de Métodos de Pagamento E-commerce - mpd.html.paymentmethodecommerce".

Essa mensagem poderá ser visualizada de duas formas, sendo elas:

Monitor Totvs Connector

Image Added

Log do appserver

[22/02/15@17:01:33.040-0300] P-024972 T-025016 2 AS 4GLTRACE       Invoke convertLongcharToJsonObject "{"RowErrors":[{"ErrorSequence":0,"ErrorNumber":55314,"ErrorDescription":"Relacionamento de Método de Pagamento não encontrado!","ErrorParameters":"","ErrorType":"EMS","ErrorHelp":"Não foi cadastrado o método de pagamento visaRedeParcelado e estabelecimento 1  no programa "Cadastro de Métodos de Pagamento E-commerce - mpd.html.paymentmethodecommerce"..","ErrorSubType":"ERROR"}]}" [convertTempTableToJsonObject - com.totvs.framework.api.JsonAPIUtils @ 218]

Isso significa que o método de pagamento que veio do e-commerce possui o nome "visaRedeParcelado" e que o estabelecimento cadastrado no programa PD0310 foi o estabelecimento "1". E não foi encontrado no programa "Cadastro de Métodos de Pagamento E-commerce - mpd.html.paymentmethodecommerce" um método de pagamento com o nome "visaRedeParcelado" e para o estabelecimento "1".

Image Added

Quando o método de pagamento não estiver cadastrado no programa "Cadastro de Métodos de Pagamento E-commerce - mpd.html.paymentmethodecommerce", para realizar o cadastrado do método de pagamento deverá ser utilizado o botão "Métodos de Pagamento".

Image Added

Ao clicar no botão "Métodos de Pagamento" será aberto a tela abaixo, onde serão listados todos os métodos de pagamentos já cadastrados, para cadastrar um novo método de pagamento será necessário clicar no botão "Adicionar"

Image Added

Ao clicar no botão "Adicionar", será habilitado 3 colunas, Código, Nome e Grupo.

Image Added

Na coluna código, deverá ser informado o método de pagamento que foi apresentado na mensagem:

Código: 55314 

Mensagem: Não foi cadastrado o método de pagamento visaRedeParcelado. 

Image Added

A coluna Nome e Grupo é apenas um campo informativo para descrever o que é método de pagamento visaRedeParcelado no e-commerce.

Após o preenchimento das 3 colunas, clicar no botão "Salvar".

Após cadastrar o método de pagamento, clicar no botão "Incluir": 

Image Added

Será aberta a tela abaixo, clicar no combo "Método de Pagamento" e selecionar o método que foi cadastrado, neste exemplo: visaRedeParcelado. No Zoom do estabelecimento informar o estabelecimento que foi informado na mensagem:

Código: 55314 

Mensagem: Não foi cadastrado o método de pagamento visaRedeParcelado e estabelecimento 1. 

Image Added

Selecionar no campo Tipo, o meio de pagamento a qual se refere o método de pagamento no e-commerce, se for um boleto selecionar o tipo boleto. Neste caso como o visaRedeParcelado é um cartão de crédito, selecionar o tipo: 3 - Cartão de Crédito. Informar os demais campos como portador, carteira e administradora e clicar no botão "Salvar".

Após clicar no botão "Salvar", será possível consultar no grid o método de pagamento que foi cadastrado, neste caso o "visaRedeParcelado". E agora será possível importar o pedido no ERP Datasul, pois a mensagem de código 55314 - Relacionamento de Método de Pagamento não encontrado! não será mais apresentada.

Image Added


CD0821 - Manutenção Permissão Usuário

Caso não seja encontrado no ERP Datasul o usuário do ERP que foi informado no Connector para realizar a comunicação com as API´s públicas, cadastrado no programa Manutenção Permissão Usuário - CD0821, pedido não será importado com sucesso. Sem o vínculo será apresentada a mensagem de erro durante a integração do pedido:

 * Código: 852
 * Mensagem: Usuário e-commerce não Cadastrado no Banco Comercial Usuário e-commerce não tem permissão para executar esse programa.

Essa mensagem poderá ser visualizada de duas formas, sendo elas:

Monitor Totvs Connector

Image Added

Log do appserver

[22/02/23@16:31:25.473-0300] P-010420 T-011424 3 AS 4GLTRACE       Return from getMessageInformation "ERROR Usuário e-commerce não Cadastrado no Banco Comercial Usuário e-commerce não tem permissão para executar esse programa." [btb/btberrors.p]

Para que a mensagem de código 852 não seja mais apresentada, acessar o programa CD0821 e cadastrar um usuário comercial com o mesmo nome apresentado na mensagem de erro, neste exemplo será necessário cadastrar o usuário comercial: "e-commerce":

Image Added