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);

TOTVS Distribuição e Varejo - linha Winthor > Integração Força de Vendas - API > image2019-12-17_11-57-59.png

TOTVS Distribuição e Varejo - linha Winthor > Integração Força de Vendas - API > image2019-12-17_12-4-8.png

2.1 Na tela Gerenciador de Rotinas e Serviços, clique o botão Instalações;

TOTVS Distribuição e Varejo - linha Winthor > Integração Força de Vendas - API > image2019-12-17_12-5-24.png

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

TOTVS Distribuição e Varejo - linha Winthor > Integração Força de Vendas - API > image2019-12-17_15-25-48.png

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

TOTVS Distribuição e Varejo - linha Winthor > Integração Força de Vendas - API > image2020-12-11_16-11-6.png

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:

Verbo	Descrição
GET	Solicita dados de um recurso
POST	Cria um novo recurso
PUT	Atualiza um recurso
DELETE	Exclui 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.