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: 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 | | optingSimplesNacional | PCFILIAL.OPTANTESIMPLESNACIONAL | | createdAt | PCFILIAL.DTCADASTRO | | lastChange | PCFILIAL.DTULTALTER |
|
| 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 |
|---|
| page : 1 - número da página
pageSize : 10 - quantidade por página
lastChange : - data de ultima alteração |
|
| Totvs custom tabs box items |
|---|
| default | no |
|---|
| referencia | passo3 |
|---|
| Exemplo JSON da resposta: {
"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 |
|---|
| default | no |
|---|
| referencia | passo4 |
|---|
| - 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 |
|---|
| <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>
|
|
|
