Páginas filhas
  • APIs Integrações - Filiais - EM HOMOLOGAÇÃO

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

Totvs custom tabs box
tabsDados integrados com Winthor, Envio Parâmetros, Resposta da Requisição, Principais dúvidas e conflitos
idspasso1,passo2,passo3,passo4

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

Totvs custom tabs box items
defaultyes
referenciapasso1

Os dados integrados são: 

Table Filter
inversefalse
ddSeparator
sparkNameSparkline
columnSECTIONS | PCFILIAL API
hidePaneTable header
isNewfalse
separatorPoint (.)
labelsSECTIONS | PCFILIAL API
default
ddOperator
cell-width150
datepatternyy-mm-dd
id1698435687462
isORAND
formatVersion2
order0


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

--

optingSimplesNacionalPCFILIAL.
OPTANTESIMPLESNACIONAL
OPTANTESIMPLESNAC--
createdAtPCFILIAL.DTCADASTRO--
lastChangePCFILIAL.DTULTALTER--


Image Added


Totvs custom tabs box items
defaultno
referenciapasso2

Exemplo do envio da requisição:

Bloco de código
languagejs
titleURI
method: 'GET',
url: '/api/branch/v1/'
Bloco de código
languagejs
titleParams
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
defaultno
referenciapasso3

Exemplo JSON da resposta:  

Bloco de código
languagejs
titleResponse
{
    "first": false,
    "items": [
        {
            "id": "1",
            "corporateName": "Totvs Tecnologia em Software de Gestao LTDA ",
            "aliasName": "TOTVS GOIÂNIA",
            "corporateIdentificationNumber": "00000000000000",
            "stateRegistration": "1069532730000000",
            "address": "RUA 135xpto",
            "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
defaultno
referenciapasso4
Expandir
titleApresentou 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
languagejava
<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
titleInstalei 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
languagejava
{
    "mensagem": "O Usuário não está autorizado a utilizar esse recurso",
    "erros": []
}  

...