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: 

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

optingSimplesNacionalPCFILIAL.OPTANTESIMPLESNACIONAL
createdAtPCFILIAL.DTCADASTRO
lastChangePCFILIAL.DTULTALTER
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
page		: 1						- número da página
pageSize	: 10					- quantidade por página
lastChange  :                       - 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": "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
defaultno
referenciapasso4
  • 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
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>

  • 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
languagejava
{
    "mensagem": "O Usuário não está autorizado a utilizar esse recurso",
    "erros": []
}  
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. 



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.