TOTVS Distribuição e Varejo - linha Winthor

Páginas filhas
  • Integração Força de Vendas - API

Versões comparadas

Versão antiga 59

changes.mady.by.user Helen Crystina Godinho Amorim

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.

...

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

Aviso

As API's de força de vendas e estão em fase de homologação e não liberadas para produção.

Novas integrações(vendas e/ou implantações) devem ser alinhadas com antecedência entre o time Comercial e de Produto (Winthor). 

É importante estar atento ao escopo atendido na integração, dentro da documentação de cada processo é possível visualizar os campos atendidos. 


Expandir
titleParametrizações WTA
Totvs custom tabs box
tabsProcedimentos Iniciais
idspasso1,

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. 



Expandir
titleSobre as APIs

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

Será necessário estar logado no sistema WTA.

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

...