Este documento traz informações sobre o processo de Integração do ERP WinThor com o ambiente do Força de Vendas. Esta integração passa pela utilização do TOTVS Conector (Produto TOTVS). Para contemplar estes serviços foram desenvolvidas API´s que expõem dados para serem utilizadas nos ambientes.

1. Caso ainda não possua, instale o WinThor Anywhere, para isso acesse Como instalar o WinThor Anywhere ?

2. 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.1  Na tela Gerenciador de Rotinas e Serviços, clique o botão Instalações;


2.3 Marque a opção winthor-ferramenta-gateway na versão mais recente que estiver disponibilizada no campo Versão:



3. Instalar o serviço winthor-pedido-venda na última versão disponível. 



Nossas APIs são baseadas no protocolo HTTP E possui URLs previsíveis, é orientada a recursos e utiliza códigos de resposta HTTP para indicar sucesso ou erros e exceções.

As respostas (incluindo os erros) e o corpo das requisições são obrigatoriamente formatados em JSON.

Sobre as requisições à API

Os seguintes verbos HTTP estão disponíveis para uso:

VerboDescrição
GETSolicita dados de um recurso
POST

Cria um novo recurso

PUT

Atualiza um recurso

DELETEExclui um recurso


Cabeçalho das requisições

O cabeçalho de requisição HTTP usado é:

Accept: application/json

Content-Type: application/json

** Deve-se especificá-los no header das requisições à API.


Autenticação/Autorização

Utilizamos o Apache Shiro para identificar se a solicitação de acesso a API está autenticada, portanto apenas passar No Auth no Type Auth.


Erros & Respostas

Utilizamos os códigos de resposta HTTP convencionais para indicar sucesso ou falha em uma solicitação à API.

  • Respostas de informação (100-199),
  • Respostas de sucesso (200-299),
  • Redirecionamentos (300-399)
  • Erros do cliente (400-499)
  • Erros do servidor (500-599).


URI Parameters

Alguns recursos disponibilizados podem oferecer a possibilidade de utilização de “URI Parameters” amigáveis.
Os parâmetros quando disponíveis são:

• filter - Habilita filtragem (consulta) de resultados.

Realiza o login do usuário passando os dados usuário e senha no body da requisição.

URI  :   /winthor/autenticacao/v1/login

Ao performar a requisição será preenchida a tabela temporária PCLIENTFV, assim que finalizar a importação, poderá ser visualizado através da rotina 302 - Cadastrar Cliente.

URI  :   /api/wholesale/v1/salesForce/customer




Importar referencia de cliente (PCCLIEREFFV) juntamente com seu cadastro principal da tabela (PCCLIENTFV), para isso basta relacionar as principais chaves CPF/CNPJ.

IMPORTADO 
1 - Inserido os dados na tabela 
2 - Referencia de cliente importado com sucesso
3 - Cliente não cadastrado ou excluído


PCCLIREFFV
Chaves Obrigatórias : CGCCLI, CODREF
Objetivo: Armazenas as referências de clientes na tabela PCCLIREFFV.

"imported": 1,- PCCLIREFFV.IMPORTADOFlag de importação do pedido
"personIdentificationNumber": {{cpf}},- PCCLIREFFV.CGCCLIcgc/Cpf do cliente
"referenceCode": 1,- PCCLIREFFV.CODREFsequencial para referencia por cliente
"customerCode": 1,- PCCLIREFFV.CODCLICodigo do cliente
"referenceName": "{{$randomCompanyName}}",- PCCLIREFFV.EMPREFERnome da referencia
"referencePhone": "{{$randomPhoneNumber}}",- PCCLIREFFV.TELREFERTelefone da referencia
"referenceContact": "{{$randomLastName}}",- PCCLIREFFV.CONTATOREFERContato da referencia
"creditLimit": "{{$randomPrice}}",- PCCLIREFFV.LIMCREDREFERLimite de credito
"dateRegisterReference": "10/12/2020 14:10:08",- PCCLIREFFV.DTCADASTROREFERData de cadastro da referencia
"dateLastPurchase": "10/12/2020 14:10:08",- PCCLIREFFV.DTULTCOMPREFERData da ultima compra
"valueLastPurchase": "{{$randomPrice}}",- PCCLIREFFV.VLULTCOMPREFERValor da ultima compra
"observation": "testetestetetestetestetestetestetestetesttet",- PCCLIREFFV.OBSObservação
"biggestPurchaseDate": "10/12/2020 14:10:08",- PCCLIREFFV.DTMAIORCOMPREFERData da maior compra
"biggestPurchaseValue": "{{$randomInt}}",- PCCLIREFFV.VLMAIORCOMPREFERValor da maior compra
"referenceChargeCode": "{{$randomInt}}"- PCCLIREFFV.CODCOBREFERCodigo de cobrança
Grava automaticamente- PCCLIREFFV.OBSERVACAO_PCMensagem de retorno da package
Grava automaticamente- PCCLIREFFV.DTINCLUSAOData de inclusão do registro na tabela



























Baixe aqui nossa coleção:  https://www.getpostman.com/collections/3b77290ec3b3cd3bcd9f