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

colocar print do JSON

Utilizando como exemplo a imagem acima do programa CD0402, o valor informado no campo ID E-commerce foi "2131". Isso significa que o código da transportadora que veio da VTEX no JSON do pedido foi codeCarrier: "2131". Com isso, toda vez que vir o código de transportadora da VTEX 2131, o pedido entrará com a transportadora 16 - J.R PEREIRA TRANSPORTES 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 a Americanas, a Americanas deverá ser cadastrado como sendo um representante no ERP Datasul.

Caso não seja encontrado no ERP Datasul, um representante com o nome do marketplace, o pedido não será importado com sucesso. Sem o vinculo será apresentada a mensagem de erro durante a integração do pedido, mensagem de código 2 - Não foi encontrada ocorrência em Representante com a chave informada. Representante: "nome do marketplace".

O valor apresentado em "nome do marketplace", é o valor que deve ser informado 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 que deve ser informado 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.

Caso os produtos sejam disponibilizados em mais de um marketplace, por exemplo se além de vender no marketplace da Americanas, 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.

Integrações > Parametrização - Premissas > image2022-2-9_17-49-2.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 poderá não ser o mesmo do pedido na loja.

Por isso a importância de parametrizar as naturezas de operação informadas no programa PD0310 ,e caso, informado um tipo de operação informado 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.