| Expandir |
|---|
| | Expandir |
|---|
| title | WTA | Quais serviços são necessários realizar a integração? |
|---|
| Instale os seguintes serviços para realizar a integração entre o sistema de venda digital e o ERP WinThor. - winthor-ferramenta-gateway
- winthor-pedido-venda
- winthor-compras-produto
- winthor-estoque-vtex
Caso tenha dúvidas de como realizar o processo de instalação dos serviços, segue link abaixo para apoiar neste processo: Comece por aqui -> Parametrizações WTA |
| Expandir |
|---|
| Quais DEPARTAMENTOS 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 departamentos no venda digital, segue link abaixo para apoiar neste cadastro: Lembrando que, para que a integração seja realizada com sucesso, o cadastro de departamentos e o vínculo com o produto é OBRIGATÓRIO! Caso esse processo não seja realizado da forma correta, a integração não será realizada! |
| Expandir |
|---|
| 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: Lembrando que, para que a integração seja realizada com sucesso, o cadastro de seções e o vínculo com o produto é OBRIGATÓRIO! Caso esse processo não seja realizado da forma correta, a integração não será realizada! |
| Expandir |
|---|
| 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: Lembrando que, para que a integração seja realizada com sucesso, o cadastro de categorias e o vínculo com o produto é OBRIGATÓRIO! Caso esse processo não seja realizado da forma correta, a integração não será realizada! |
| Expandir |
|---|
| Quais MARCAS a empresa deseja realizar a integração? Este levantamento deve ser realizado juntamente ao cliente que está realizando a implantação. Após essas informações, para realizar o cadastro das marcas no venda digital, segue link abaixo para apoiar neste cadastro: Lembrando que, para que a integração seja realizada com sucesso, o cadastro de marcas e o vínculo com o produto é OBRIGATÓRIO! Caso esse processo não seja realizado da forma correta, a integração não será realizada! |
| Expandir |
|---|
| Quais PRODUTOS a empresa deseja realizar a integração? Este levantamento deve ser realizado juntamente ao cliente que está realizando a implantação. Após essas informações, para realizar o cadastro dos produtos no venda digital, segue link abaixo para apoiar neste cadastro: Caso todos os vínculos informados no link acima não sejam realizados de forma correta, a integração dos produtos não será realizada!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 |
|---|
| 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 |
|---|
| 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 |
|---|
| 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 |
|---|
| 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. |
Quais EMBALAGENS a empresa deseja realizar a integração? Este levantamento deve ser realizado juntamente ao cliente que está realizando a implantação. Após essas informações, para realizar o cadastro das embalagens no venda digital, segue link abaixo para apoiar neste cadastro: |
| Expandir |
|---|
| Como é realizado o cadastro de CLIENTES e quais clientes a empresa deseja realizar a integração? Este levantamento deve ser realizado juntamente ao cliente que está realizando a implantação. Após essas informações, para realizar o cadastro das clientes no venda digital, segue link abaixo para apoiar neste cadastro: |
| Expandir |
|---|
| Como é realizado o funcionamento do ESTOQUE DISPONÍVEL na integração no venda digital? Segue abaixo link para demonstrar e apoiar: |
| Expandir |
|---|
| Como é realizado a parametrização dos PREÇOS na integração no venda digital? Segue abaixo link para demonstrar e apoiar: |
|
| Expandir |
|---|
| | Expandir |
|---|
| title | Verificação dos serviços instalados |
|---|
|
| | Expandir |
|---|
| title | Principais dúvidas e conflitos |
|---|
| | Totvs custom tabs box |
|---|
| tabs | Verificação dos serviços instalados,Consulta de logs |
|---|
| ids | passo1,passo2 |
|---|
| | Totvs custom tabs box items |
|---|
| | default | yes |
|---|
| referencia | passo1 |
|---|
| | Totvs custom tabs box items |
|---|
| default | no |
|---|
| referencia | passo2 |
|---|
| 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 Modified
Para realizar a pesquisa, informe o serviço instalado no filtro "Pesquisa" e clique no ícone da lupa.
 Image Modified
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 Modified
| Expandir |
|---|
| Caso tenha algum tipo de problemas na instalação do serviços, para consultar os logs, acesse a rotina 810 - Gerenciamento de logs, realize o download do log que deseja analisar e verifique o problema ocorrido.  Image Added
Para realizar a pesquisa, informe o log desejado no filtro "Pesquisa" e clique no ícone da lupa.  Image Added
A rotina listará os logs gerados e para realizar o download do arquivo para análise, clique no link "Download log".  Image Added
O log será salvo na pasta de downloads da máquina do usuário. |
| Expandir |
|---|
| title | Biblioteca das API's |
|---|
| Baixe aqui a coleção de API's | View file |
|---|
| name | LOCAL - 8889.postman_environment.json |
|---|
| height | 250 |
|---|
|
| View file |
|---|
| name | API Integrações OFICIAL.postman_collection.json |
|---|
| height | 250 |
|---|
|
Como sugestão, utilizamos a ferramenta POSTMAN para realizar as requisições das API's, Clique aqui para acessar um manual de como utilizar a ferramenta. | Aviso |
|---|
Caso tenha a necessidade de pesquisar todos os serviços instalados através do POSTMAN, pode utilizar a seguinte requisição abaixo: URI: http://{{host}}:{{port}}/winthor/ferramenta/servidor/v1/info/winthor-features/all |
|
| Expandir |
|---|
| title | Geração de token de autenticação |
|---|
| Para realizar a geração do token de autenticação e utilizar as API's, segue link para apoio: |
| Expandir |
|---|
| title | Como consultar os pedidos integrados? |
|---|
| Para verificar se o pedido foi integrado entre venda digital e o ERP WinThor, o usuário pode utilizar as seguintes rotinas: Alterar a posição do pedido de venda, segue link abaixo para auxiliar na utilização da rotina: Cancelar o pedido de venda realizado, segue link abaixo para auxiliar na utilização da rotina: |
| Expandir |
|---|
| title | Como acessar o WTA - Winthor Anywhere em outras estações? |
|---|
| Para acessar o Winthor Anywhere em outra estação de trabalho da sua empresa realize os seguintes passos: 1. Acesse a rotina 132 - Parâmetros da presidência
2. Obtenha o ID e PORTA do WTA nos parâmetros 2851- IP do Servidor WTA e 2849 - Número da Porta do WTA respectivamente;
3. Acesse o seu navegador de internet e coloque o IP e a PORTA separados por ":", conforme exemplo: 10.62.46.50:8180
4. Ao abrir a tela de acesso da ferramenta, utilize o mesmo usuário e senha do WinThor. | Aviso |
|---|
Caso não consiga trafegar pelo navegador da máquina da sua empresa é possível que seja bloqueio por conta de ferramentas como (microtic, Firewall e ou PF Sense), então solicite para o administrador da rede de infraestrutura para fazer a liberação. |
|
| Expandir |
|---|
| title | Exportar XML de NF-e |
|---|
| Para exportar XML de NF-e emitida na rotina 1452, realize os procedimentos abaixo conforme link: |
|
|
