TOTVS Distribuição e Varejo - linha Winthor

Páginas filhas
  • Integração do Winthor com TOTVS Varejo PDV Omni

Versões comparadas

Versão antiga 116

changes.mady.by.user Rafael Pessoa Rodrigues

Gravado em

comparado com

Nova versão Atual

changes.mady.by.user Rafael Pessoa Rodrigues

Gravado em

Chave

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

...

Aviso
titlePré-requisitos

Confira todos os pré-requisitos na documentação principal de configuração do WSH - WinThor Smart Hub assim como toda a configuração inicial que deve ser feita do WSH.


(estrela) Funcionalidade IP Fixo:

Para IP fixo liberado pelo cliente o mesmo deve ser liberado apenas para o IP indicado pelo Time PDVSYNC com protocolo de segurança habilitado e/ou VPN privada;


(estrela) Funcionalidade IP dinâmico:

Para clientes que não possuem IP fixo e desejam realizar comunicação Online(Pedido, Consulta de estoque etc.) temos a possibilidade do uso do IP Dinâmico, para isso 

deve-se atentar as seguintes premissas:

  • Se provedor de internet com CGNAT, deve estar liberado para conexão;
  • Porta do WTA liberado no roteador e Firewall;
  • Rota liberado sem Redirecionamento de porta ou mascaramento de IP(ex: NAT, proxy, etc.);
  • Configurar rotas do IP dinâmico no WSH(Rotas 82, 83)
  • Liberado apenas para o IP indicado pelo Time PDVSYNC;


Informações
titleProcessos Integrados
Expandir
titleProcessos
Expandir
titleFiliais, lojas e compartilhamentos

Neste processos são integrados os dados de Lojas, Filiais e o compartilhamento de dados entre as lojas.

(seleção) Definir nos parâmetros da integração as filiais que deseja integrar.

Expandir
titlePerfil, usuários e operadores

São integrados 3 perfis principais relacionados no Winthor: Operador, Administrador e Vendedor

Os usuários e operadores são integrados e precisam ter CPF cadastrados.

Expandir
titleCobranças

As cobranças (meios de pagamentos) devem estar devidamente cadastrados na rotina 522:

Tipos:

Expandir
titleGerais

O que não é PIX ou TEF, segue o padrão do WinThor para pedidos e acerto de caixa.

Expandir
titleCobranças TEF (Cartão crédito/ débito)

Devem estar configurados os seguintes campos (os dados são validados não só pelas APIs, mas também pela rotina 2099):

Aba Dados cadastrais

  • Cartao de credito: indica que a cobrança é do tipo TEF
  • Tipo de pagmento: dado solicitado pela SEFAZ
  • Forma de pagamento NF-e: dado solicitado pela SEFAZ
  • Nível Venda: indica o acesso do cliente da venda para esta cobrança


Aba Cartão de credito

  • Cliente (Bandeira cartão): cliente para desdobramento de títulos
  • Cobrança: dado solicitado pelo WinThor, no momento do acerto do caixa
  • Conta: dado solicitado pelo WinThor, no momento do acerto do caixa
  • Operadora: código da autorizadora da transação no SiTef
  • Bandeira da operadora: bandeira do cartão 
  • Prazo (Dias): dado solicitado pelo WinThor, no momento do acerto do caixa
  • % Taxa Adm: dado solicitado pelo WinThor, no momento do acerto do caixa
  • Cód. bandeira TEF (SiTef): bandeira do cartão, para o SiTef
  • Tipo de operação: tipo da transação
  • Tipo de pagamento: modalidade da transação
Expandir
titleCobranças PIX (Carteira digital)

Devem estar configurados os seguintes campos (os dados são validados não só pelas APIs, mas também pela rotina 2099):

Aba Dados cadastrais

  • Carteira digital: indica que a cobrança é do tipo carteira digital (PIX)
  • Tipo de pagmento: dado solicitado pela SEFAZ
  • Forma de pagamento NF-e: dado solicitado pela SEFAZ
  • Nível Venda: indica o acesso do cliente da venda para esta cobrança


Aba Carteira Digital

  • Carteiras Digitais: nome da carteira digital (obrigatório). É o que irá definir a qual carteira o pagamento pertence.
Expandir
titleImpostos

Os produtos deverão estar devidamente tributados (com ICMS e PIS/ COFINS):

  • Parâmetro 'CON_USATRIBUTACAOPORUF' da rotina 132

  • Se a tributação for por região, deverá estar configurado na rotina 271, o código da figura tributária da 514 e, o código da figura de PIS/ COFINS, da rotina 4001.
    • Para validar a região da tributação, é usada a regra abaixo;
      • Verifica se existe região no parametro 'NUMREGIAOPADRAOVAREJO'
      • Se não houver, verifica a região padrão da filial no parametro 'FIL_NUMREGIAOPADRAO'.
      • Se não houver, valida a região padrão no parametro PCCONSUM.NUMREGIAOPADRAO.
  • Se a tributação for por UF, deverá estar configurado na rotina 574, o código da figura tributária da 514 e, o código da figura de PIS/ COFINS, da rotina 4001.

Integramos os seguintes dados fiscais para o PDV:

  • ICMS
  • PIS\COFINS
  • CEST
  • NCM
  • FECP (FUNCEP/ FECP/ FCP)
Expandir
titleProduto

Serão integrados os produtos que, possuírem ao menos uma embalagem cadastrada e, o código de barras do produto exista no cadastro de embalagens.

Sem Formato
PCPRODUT.CODAUXILIAR = PCEMBALAGEM.CODAUXILIAR
  • Somente produtos marcados como revenda igual a Sim.
  • Possua registros na rotina 238.

(seleção) Definir nos parâmetros da integração as filiais que deseja integrar.

Expandir
titlePreços

Para preço por região ativado, são restringidas as seguintes rotinas:

201

São enviados os preços de venda da região padrão do Varejo ('NUMREGIAOPADRAOVAREJO') e, se não houver, o preço da região padrão do parâmetro CiaShop ('CODREGIAOPRECOCIASHOP').


Para preço por embalagem ativado:

2017

Preços de venda e oferta por embalagem são integrados.

Preços de venda de atacado por embalagem são integrados.

Somente ofertas de embalagem (sem atacado) com vigência onde a data de inicio seja menor ou igual a data de fim.


(seleção) Definir nos parâmetros da integração as filiais e região que deseja integrar.


Expandir
titleCampanhas de descontos/ ofertas

357

Somente campanhas com vigência onde a data de inicio seja menor ou igual a data de fim.

Caso a filial seja nula, a integração irá entender que, todas as filiais usarão a campanha.


561/ 4161

Somente campanhas com vigência onde a data de inicio seja menor ou igual a data de fim.

São validadas/ enviadas somente campanhas onde as opções abaixo estejam marcadas ou as condições estejam atendidas:

Aplicar desconto automaticamente: deve estar marcado como Sim.

Tipo de desconto: C - Comercial.

Tipo de entrega "Call Center": Nenhuma.

Grupos de restrição: caso seja informada restrição de grupo, deverá haver registro desta restrição na rotina 3311, referente aos tipos GR ou CL.


(seleção) Definir nos parâmetros da integração as filiais e região que deseja integrar.


Expandir
titleProcessos não integrados (Fora do escopo)
Expandir
titleImposto

De acordo com com o tipo de tributação, os campos CODST e CODTRIBPISCOFINS deverão existir na PCTABPR (se 271) ou, PCTABTRIB (se 574).

Sem Formato
PCTABPR.CODST IS NOT NULL
OU
PCTABTRIB.CODST IS NOT NULL
------------------------------------------
PCTABPR.CODTRIBPISCOFINS IS NOT NULL
OU
PCTABTRIB.CODTRIBPISCOFINS IS NOT NULL

Os cadastros efetuados pela rotina 2034 não são validados/ enviados.

Expandir
titleCobranças/ finalizadoras

Para clientes que utilizam o processo de finalizadoras de venda, cadastradas via rotina 2039, estas não são validadas/ enviadas.

Os dados de parcelamento por classificação mercadológica também não são validados/ enviados.

Expandir
titleProdutos

Não serão enviados produtos diferentes de cesta básica, kit ou liberado.

Sem Formato
PCPRODUT.TIPOMERC IN ('PA','CB','KT','L')

É obrigatório existir pelo menos uma embalagem para cada produto a ser vendido no PDV.

O produto deve possuir NCM informado.

Expandir
titleDetalhes de preços/ descontos

Para preço por embalagem ativado:


2011

A rotina 2011 não está integrada, ou seja, os tabloides (ofertas programadas) não são validados/ enviados.


Para preço região ativado, são restringidas as seguintes rotinas:

561/ 4161

Campanhas que tenham tipo de desconto como Financeiro ou Simulados não são integradas.

Campanhas com faixa de valor ou quantidades informadas não são integradas.

Campanhas que tratem comissões de vendedor não são integradas.

Campanhas para clientes específicos não serão integradas(apenas cliente padrão).



...