Páginas filhas
  • Integração WinThor x Venda Digital - Pluginbot

Versões comparadas

Chave

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

...

Informações
titleConfiguração e Instalação
Expandir
titleConfiguração

Configurações:


Expandir
titleWTA

1.Acesse o WinThor Anywhere e no menu principal, preencha no campo de “Pesquisar” a rotina 801 - Atualização de Serviços Web e tecle “Enter” (ou clique diretamente sobre a rotina no menu principal);

2.Na tela Gerenciador de Rotinas e Serviços, clique o botão Instalações;
3.Marque a opção winthor-ferramenta-gateway na versão mais recente que estiver disponibilizada;
4.Instalar o serviço winthor-pedido-venda na última versão disponível;
5.Instalar o serviço winthor-compras-produto na última versão disponível;
6.Instalar o serviço winthor-estoque-vtex na última versão disponível;
7.Disponibilizar acesso externo ao endereço do WTA para acesso externo (IP/porta)

Expandir
titleCategoria

Quais CATEGORIAS a empresa deseja realizar a integração? Este levantamento deve ser realizado o levantamento juntamente ao cliente que está realizando a implantação.

Após essas informações, para realizar o cadastro das categorias no venda digital, segue link abaixo para apoiar neste cadastro:

Expandir
titleSeção

Quais SEÇÕES a empresa deseja realizar a integração? Este levantamento deve ser realizado o levantamento juntamente ao cliente que está realizando a implantação.

Após essas informações, para realizar o cadastro das seções no venda digital, segue link abaixo para apoiar neste cadastro:


1. A Seção (Rotina 571) deve estar com o campo Enviar para E-commerce igual Sim.
2.Necessário a instalação do serviço winthor-compras-produto.

Expandir
titleDepartamento

1.A categoria (Rotina 513) deve estar com o campo Enviar para E-commerce igual Sim.
2.Necessário a instalação do serviço winthor-compras-produto.

Expandir
titleClientes

CADASTRO DE CLIENTES:
1. Todos os campos obrigatórios do cadastro de cliente (Rotina 302) serão obrigatórios na API.
2. No parâmetro 4013 - Código do ramo de atividade para cadastro de clientes na Ciashop (CODATVCIASHOP) na
rotina 132 informar a atividade, caso não seja enviado, a API utilizará o valor padrão "1";
3. A API utilizar um valor padrão "4729-6/99" do parâmetro 4585- Código do CNAE para cadastro de clientes ecommerce.
(CODCNAEECOMMERCE) na rotina 132;
4. No parâmetro 4532 - "Permite alterar o cliente ao receber dados para inserção via ecommerce/API" permite ou não
alteração do cadastro de cliente de forma automática ao receber dados do cliente ou pedido via API, por padrão esse
campo receberá 'Sim' sendo possível sua configuração por filial;
5. A API utilizará o valor padrão cadastrado no parâmetro "4012 - Código do RCA para cadastro de clientes na
Ciashop" na rotina 132, caso não seja enviado ou seu valor seja igual a 0;
6. Necessário a instalação do serviço winthor-pedido-venda.
Obs.:
Ao inserir um novo registro, o valor do código RCA será registrado na coluna CODUSUR1 da tabela PCCLIENT, e em
caso de alteração de um registro existente, o valor do código RCA será registrado na coluna CODUSUR3 da mesma
tabela, mantendo o registro do código RCA inicial na coluna CODUSUR1.

Expandir
titleEmbalagem/SKU

CADASTRO DE EMBALAGEM/SKU:
1. Necessário a instalação do serviço winthor-compras-produto.
2. A embalagem deve possuir o código EAN parametrizado no cadastro do produto (Rotina 203), campo CODAUXILIAR.
3. Os valores dos campos ("Altura", " Comprimento", "Peso", "Largura", "Volume") são correspondentes as Rotinas 292 ou 2014.
4. Os valores dos campos ("Altura", " Comprimento", "Peso", "Largura", "Volume") são correspondentes as Rotinas 203 / 282.

Expandir
titleEstoque

1. Necessário a instalação do serviço winthor-estoque-vtex.
2. Os produtos devem estar com o campo Enviar para E-commerce igual Sim.
3. Para o caso de venda por Embalagem, sempre utilizaremos a menor embalagem cadastrada para um determinado produto. Sendo obrigatório o cadastro de Embalagem para o produto.
4. Disponibilizaremos o campo fator de conversão da rotina 2014.
5. Quando o for realizada uma movimentação de determinado produto e for integrado, o sistema atualiza o estoque do produto.
6. Será considerado a Origem 'Web' como valor fixo para cadastros de produtos que estejam com o campo Enviar para E-commerce igual Sim.

Expandir
titlePreços

1. Necessário a instalação do serviço winthor-pedido-venda.
2. De acordo com as parametrizações feitas na (Rotina 132 - Parâmetro 2277) é possível expor preço referente a
rotina 201 – Precificar Produto ou 2017 – Precificação Por Embalagem.
3. Caso exista política de preço fixo cadastrada na rotina 357 que se aplique ao conjunto de dados informados
(cliente, região, filial, produto, plano de pagamento, etc), o preço a ser exposto será o cadastrado na política.
4. A parametrização de venda por embalagem e preço de venda por embalagem será por filial.
5. Com o uso do Tipo de precificação Atacado será empregado o preço cadastrado da (Rotina 2017) -
Precificação Por Embalagem, gravando o campo (PCEMBALAGEM.PVENDAATAC).
6. Com o uso do Tipo de precificação Varejo será empregado o preço cadastrado da (Rotina 2017) -
Precificação Por Embalagem, gravando o campo (PCEMBALAGEM.PVENDA).
7. Com o uso do Tipo de precificação Padrão será empregado o preço cadastrado da (Rotina 201) - Precificar
Produto, gravando o campo (PCTABPR.PVENDA1).
8. Deve-se preencher o parâmetro 4257 – Código da região para preço CIASHOP
(CODREGIAOPRECOCIASHOP) com a Região que será utilizada por Filial.
9. Caso parâmetro 4257 Não esteja preenchido, é utilizada a região informada no parâmetro 2832 – Número da
região utilizada pelo e-commerce (REGIAOECOMMERCE).
10. Quando se tratar de produto de Origem Web e/ou E-commerce a API não irá calcular o preço de venda com
Impostos. O preço de venda válido será sempre o preço vindo do E-commerce.
11. Quando o parâmetro 2277 - Tipo de Precificação da rotina 132 estiver cadastrado como Atacado
(A) ou Varejo (V) , o retorno da requisição terá os atributos "offerPrice", "offerStartDate" e "offerEndDate", que
correspondem respectivamente as colunas POFERTA, DTOFERTAINI e DTOFERTAFIM da
tabela PCEMBALAGEM. Do contrário, se o parâmetro estiver como Padrão (P) estes atributos retornarão 0 e
vazio.

Expandir
titleProdutos

1. Necessário a instalação do serviço winthor-compras-produto.
2. O produto deve estar com o campo Enviar para E-commerce igual sim (Rotina 203).
3. A categoria precisa estar previamente integrada ao E-commerce, caso contrário a integração não ocorrerá.
4. A Marca precisa estar previamente integrada ao E-commerce, caso contrário a integração não ocorrerá.
5. O produto precisa estar vinculado a uma Categoria.










Expandir
titlePrincipais dúvidas e conflitos
Totvs custom tabs box
tabsInstalação dos serviços,Verificação dos serviços instalados,Consulta de logs
idspasso1,passo2,passo3
Totvs custom tabs box items
defaultyes
referenciapasso1






Os dados integrados são: 


PCPEDCPCPEDIDescriçãoTipoObrigatório
createDataapcpedi.dataData de criação do pedido

Data (DD/MM/YYYY)

Não
idpcpedc.codclipcpedi.codcliIdentificador do ClienteNuméricoSim
orderIdpcpedc.numpedpcpedi.numpedIdentificador do pedidoNuméricoNão
orderStatuspcpedc.posicao
Estado do pedidoTextoNão
chargingIdpcpedc.codcob
Identificador de cobrançaTextoNão
TotalPricepcpedc.vltotal
Preço total do pedidoNuméricoNão
paymentPlanIdpcpedc.codplpag
Identificador do plano de pagamentoTextoSim
saleTypepcpedc.condvenda
Tipo de venda

     "1"  - Venda normal

     "5" - Bonificação ou brinde.*

     "7" - Venda para Entrega Futura*

     "8" - Simples Remessa de Venda para Entrega Futura*

  • Para uso futuro.
NuméricoSim
branchIdpcpedc.codfilial
Código da FilialTextoSim
saleOriginpcpedc.origemped
Origem do pedidoTextoNão
productSKUERPReferenceKey
pcpedi.codprodEmbalagem do produtoTextoSim
sellPrice
pcpedi.pvendaPreço do produtoNuméricoSim
quantity
pcpedi.qtQuantidade do produtoNuméricoSim
realCost
pcpedi.vlcustorealCusto RealNuméricoNão
warehouseBranchId
pcpedi.codfilialretiraCódigo de praçaTextoSim
position
pcpedi.numseqSequência do pedidoNuméricoNão
taxFigureId
pcpedi.codstFigura tributária da rotina 514NuméricoNão
discountValue
pcpedi.perdescPercentual de desconto aplicado no itemNuméricoNão
valueFreightpcpedc.vlfrete
Valor de freteNuméricoNão
intermediaryCompanyNamepcpedc.descintermediador
Razão Social do Intermediador marketplace ou e-commerceTextoNão
idIntermediaryEmployerpcpedc.cnpjintermediador
CNPJ do Intermediador marketplace ou e-commerceTextoNão
carrierIdpcpedc.codfornecfrete
Identificado da transportadoraNuméricoNão
sellerpcpedc.codusurpcpedi.codusurCódigo do RCA, caso não enviado será utilizado o definido no parâmetro "4012 - Código do RCA para cadastro de clientes na Ciashop" da rotina 132- Parâmetros da PresidênciaNuméricoNão
lastChangepcpedc.dtfat (prioridade 1)
Data de faturamento do pedidoData (DD/MM/YYYY)Não
lastChangepcpedc.data (prioridade 2)
Data de emissão do pedidoData (DD/MM/YYYY)Não
orderIdHubepcpedc.numpedhube
Número do pedido realizado via hube ou conectorTextoNão
orderIdMktplacepcpedc.numpedmktplace
Número do pedido realizado via marketplaceTextoNão
freightDispatchpcpedc.fretedespacho

Utiliza despacho de frete (freteiros)

Valores:

    "C"  - CIF - Contratação do Frete por conta do Remetente  ( Tag ModFrete Nfe= 0)

     "F" - FOB - Contratação do Frete por conta do Destinatário  ( Tag ModFrete Nfe= 1)

     "T" - Contratação do Frete por conta de Terceiros  ( Tag ModFrete Nfe= 2)

     "R" - Transporte Próprio por conta do Remetente ( Tag ModFrete Nfe= 3)

     "D" - Transporte Próprio por conta do Destinatário ( Tag ModFrete Nfe= 4)

     "G" - Gratuito - Sem Ocorrência de Transporte  ( Tag ModFrete Nfe= 9)

    

   

TextoNão
uniqueSequentialNumberpcpedc.nsu
NSUTEF - Apenas para forma de pagamento cartãoNuméricoNão
dateUniqueSequentialNumberpcpedc.dtnsu
Data do número sequencial único do cartão de créditoData (DD/MM/YYYY)Não
otherExpensespcpedc.vloutrasdesp
Outras despesas Numérico

Não


gift
pcpedi.bonificItem bonificado/brindeBoolean

Não

observationpcpedc.obs
Observação do pedidoStringNão
deliveryType
 pcpedi.tipoentrega

Tipo de entrega

Valores:
   RP - Retira Posterior
   RI  - Retira Imediata
   EN - Entrega Normal
   EF  - Encomenda


*Obs: disponível a partir da versão: 1.2.0.1078

StringNão
deliveryStatus

Status Entrega


Valores:
   A: Aguardando 
   R: Pronto Retirada
   E: Entregue


*Obs: disponível a partir da versão: 1.2.0.1078

StringNão
deliveryAddressIdpcpedc.codendentcli

Código do endereço de entrega

*Obs: disponível a partir da versão: 1.2.0.1097

NuméricoNão

sellPriceIPI

pcpedi.vlipi
Valor do IPINuméricoNão
Totvs custom tabs box items
defaultyes
referenciapasso1

VERIFICAÇÃO DOS SERVIÇOS INSTALADOS

Após a instalação dos serviços, verificar através da rotina 812 - Gerenciamento do ambiente WTA se todos os serviços foram instalados de acordo com a versão solicitada durante a instalação

Image Added


Para realizar a pesquisa, informe o serviço instalado no filtro "Pesquisa" e clique no ícone da lupa

Image Added

A rotina listará o serviço instalado, juntamente com a descrição e sua respectiva versão instalada, além do estado do serviço (online ou offline).

Image Added