Exibir origem

CD0101 – Atualização Parâmetro Global

Integrações > Parametrização - Premissas > image2021-6-14_18-5-52.png

Função:

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

CD0402 - Transportadores

Integrações > Parametrização - Premissas > image2022-2-14_16-46-9.png

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 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

Integrações > Parametrização - Premissas > image2022-2-14_16-41-20.png
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 no E-commerce não cadastrada no ERP.","ErrorSubType":"ERROR"}]}" [convertTempTableToJsonObject - com.totvs.framework.api.JsonAPIUtils @ 218]

O valor apresentado apó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.

Integrações > Parametrização - Premissas > image2022-2-14_16-49-58.png

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.

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

CD0708 – Atualização Representante

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 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 vínculo será apresentada a mensagem de erro durante a integração do pedido:

* 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

Integrações > Parametrização - Premissas > image2022-2-14_17-13-51.png

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. \nRepresentante: Loja Pedido Cliente: 501229 Cliente: Diogo Luiz\n","ErrorSubType":"ERROR"}]}" [convertTempTableToJsonObject - com.totvs.framework.api.Js

O valor apresentado em "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 valor apresentado após o Representante:, neste exemplo o valor "Loja", é o valor que deve ser visualizado no campo nome abreviado do programa CD0708. 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.

Integrações > Parametrização - Premissas > image2022-2-14_17-24-55.png

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.

Integrações > Parametrização - Premissas > image2022-2-14_17-26-35.png

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 "Loja" os produtos também sejam vendidos no marketplace "Loja B", será necessário vincular o markeplace "Loja B" a um novo representante, assim como foi feito para o marketplace "Loja".

Integrações > Parametrização - Premissas > image2022-2-14_17-30-7.png

Integrações > Parametrização - Premissas > image2022-2-14_17-32-21.png

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".

Integrações > Parametrização - Premissas > image2022-2-14_17-35-4.png

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".

Integrações > Parametrização - Premissas > image2022-2-14_17-34-12.png

Integrações > Parametrização - Premissas > image2022-2-14_17-34-45.png

FT0301 - Atualização Parâmetros Faturamento

Integrações > Parametrização - Premissas > image2019-4-9_15-4-31.png

Função:

Marcar o parâmetro ICMS incluso no preço, como a plataforma da Ciashop 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

Integrações > Parametrização - Premissas > image2019-4-9_15-9-11.png

Integrações > Parametrização - Premissas > image2019-5-29_14-8-14.png

Função:

Marcar o parâmetro Consumidor Final, pois a integração Ciashop x 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.