Histórico da Página

...

Totvs custom tabs box

tabs	Dados integrados com Winthor, Envio Parâmetros, Resposta da Requisição, Principais dúvidas e conflitos
ids	passo1,passo2,passo3,passo4

A integração consiste em retornar todas as filiais cadastradas na rotina 535

Totvs custom tabs box items

default	yes
referencia	passo1

Os dados integrados são:

SECTIONS \| PCFILIAL
API	Referência Winthor
id	PCFILIAL.CODIGO
corporateName	PCFILIAL.RAZAOSOCIAL
aliasName	PCFILIAL.FANTASIA
corporateIdentificationNumber	PCFILIAL.CGC
stateRegistration	PCFILIAL.IE
municipalRegistration	PCFILIAL.IM
address	PCFILIAL.ENDERECO
addressNumber	PCFILIAL.NUMERO
addressComplement	PCFILIAL.COMPLEMENTOENDERECO
district	PCFILIAL.BAIRRO
city	PCFILIAL.CIDADE
state	PCESTADO.ESTADO
federativeUnit	PCESTADO.UF
codStateIbge	PCESTADO.CODIBGE
codCityIbge	PCFILIAL.CODMUN
zipCode	PCFILIAL.CEP
phoneNumber	PCFILIAL.TELEFONE
exclusion	PCFILIAL.DTEXCLUSAO
optingSimplesNacional	PCFILIAL.OPTANTESIMPLESNACIONAL
createdAt	PCFILIAL.DTCADASTRO
lastChange	PCFILIAL.DTULTALTER

Totvs custom tabs box items

default	no
referencia	passo2

Exemplo do envio da requisição:

Bloco de código

language	js
title	URI

method: 'GET',
url: '/api/branch/v1/'

Bloco de código

language	js
title	Params

page		: 1						- número da página
pageSize	: 10					- quantidade por página
lastChange  :                       - data de ultima alteração

Totvs custom tabs box items

default	no
referencia	passo3

Exemplo JSON da resposta:

Bloco de código

language	js
title	Response

{
    "first": false,
    "items": [
        {
            "id": "1",
            "corporateName": "Totvs Tecnologia em Software de Gestao LTDA ",
            "aliasName": "TOTVS GOIÂNIA",
            "corporateIdentificationNumber": "00000000000000",
            "stateRegistration": "106953273",
            "address": "RUA 135",
            "addressNumber": 0,
            "district": "MARISTA",
            "city": "GOIANIA",
            "state": "GOIAS",
            "federativeUnit": "GO",
            "codStateIbge": 52,
            "codCityIbge": 5208707,
            "zipCode": "74180020",
            "phoneNumber": "0623250020",
            "createdAt": "2022-04-25T09:12:04",
            "lastChange": "2022-04-25T09:12:04"
        }
    ],
    "hasNext": false
}

Totvs custom tabs box items

default	no
referencia	passo4

Apresentou Status Code 404 Not Found ao enviar a requisição?

Caso obtenha o conteúdo abaixo ao enviar a requisição, verifique na rotina 812 do WTA se o serviço winthor-filiais está instalado. Caso não esteja, acesse a rotina 801 do WTA e realize a instalação conforme indicação na documentação APIs Integrações - Filiais

Bloco de código

language	java

<html>
 
<head>
    <meta http-equiv="Content-Type" content="text/html;charset=utf-8" />
    <title>Error 404 Not Found</title>
</head>
 
<body>
    <h2>HTTP ERROR 404</h2>
    <p>Problem accessing /api/branch/v1/. Reason:
        <pre>    Not Found</pre>
    </p>
    <hr><a href="http://eclipse.org/jetty">Powered by Jetty:// 9.3.21.v20170918</a>
    <hr />
 
</body>
 
</html>

Instalei o serviço e apresentou Status Code 403 Forbidden ao enviar a requisição?

Caso apresente 403 Forbidden, verifique se realizou a autenticação antes do envio da requisição.

Bloco de código

language	java

{
    "mensagem": "O Usuário não está autorizado a utilizar esse recurso",
    "erros": []
}

Expandir

title	Parametrizações WTA

Totvs custom tabs box

tabs	Procedimentos Iniciais
ids	passo1,

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.

4. Instalar o serviço winthor-compras-produto na última versão disponível.

5. Instalar o serviço winthor-estoque-vtex na última versão disponível.

Páginas filhas

Versões comparadas

Versão antiga 11

Nova versão 12

Chave