Objetivo
Este documento tem como objetivo explicar o funcionamento da integração com filiais.
Pré-Requisitos e Restrições
- Necessário instalar o serviço winthor-filial na rotina 801 do WTA, conforme indicação Parametrizações WTA.
Integração
| 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 |
|---|
|
|
OPTANTESIMPLESNACIONAL
 Image Added
|
|
| Totvs custom tabs box items |
|---|
| default | no |
|---|
| referencia | passo2 |
|---|
| Exemplo do envio da requisição: | Bloco de código |
|---|
| method: 'GET',
url: '/api/branch/v1/' |
| Bloco de código |
|---|
| 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 |
|---|
| {
"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 |
|---|
| 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 |
|---|
| <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 |
|---|
| {
"mensagem": "O Usuário não está autorizado a utilizar esse recurso",
"erros": []
} |
|
|
|
...
