Histórico da Página

...

Necessário instalar o serviço winthor-filial(Versão 202501.36 ou superior) na rotina 801 do WTA, conforme indicação no Parametrizações WTA.

Integração

...

Totvs custom tabs box

tabs	Dados integrados com Winthor, Envio Parâmetros, Resposta da Requisição, Passo 04Principais 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:

Table Filter

inverse	false
ddSeparator
sparkName	Sparkline
column	SECTIONS \| PCFILIAL API
hidePane	Table header
isNew	false
separator	Point (.)
labels	SECTIONS \| PCFILIAL API
default
ddOperator
cell-width	150
datepattern	yy-mm-dd
id	1698435687462
isOR	AND
formatVersion	2
order	0

SECTIONS \| PCFILIAL
API	Referência Winthor	Referência da imagem abaixo
id	PCFILIAL.CODIGO	1
corporateName	PCFILIAL.RAZAOSOCIAL	4
aliasName	PCFILIAL.FANTASIA	5
corporateIdentificationNumber	PCFILIAL.CGC	2
stateRegistration	PCFILIAL.IE	3
municipalRegistration	PCFILIAL.IM	--
address	PCFILIAL.ENDERECO	7
addressNumber	PCFILIAL.NUMERO	9
addressComplement	PCFILIAL.COMPLEMENTOENDERECO	12
district	PCFILIAL.BAIRRO	8
city	PCFILIAL.CIDADE	--
state	PCESTADO.ESTADO	13
federativeUnit	PCESTADO.UF	10
codStateIbge	PCESTADO.CODIBGE
codCityIbge	PCFILIAL.CODMUN	12
zipCode	PCFILIAL.CEP	11
phoneNumber	PCFILIAL.TELEFONE	6
exclusion	PCFILIAL.DTEXCLUSAO	--
optingSimplesNacional	PCFILIAL.

OPTANTESIMPLESNACIONAL

OPTANTESIMPLESNAC	--
createdAt	PCFILIAL.DTCADASTRO	--
lastChange	PCFILIAL.DTULTALTER	--
creditLimitPaymentMethod	Parâmetro da 132: UTILIZALIMCREDCOB	--

Image Added

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

id			: 1						- código da filial
page		: 1						- número da página
pageSize	: 10					- quantidade por página
lastChange  :                        AAAA-MM-DDTHH:MM:SS   - 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

0000000",


            "address": "RUA

135

 xpto",


            "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

"
}
],

",
            "creditLimitPaymentMethod": boolean
        }
    ],
    "hasNext": false
}

Totvs custom tabs box items

default	no
referencia	passo4

Expandir

title	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-filial 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>

Expandir

title	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": []
}

Páginas filhas

Versões comparadas

Versão antiga 3

Nova versão Atual

Chave

Integração