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 Parametrizações WTA.

...

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:

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-

filiais

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 7

Nova versão Atual

Chave