RESTWeb Service REST

Produto:

TOTVS Automação Fiscal

Versões:

12.1.17+

Este documento tem o objetivo de fornecer informações para utilização do Web Service REST de integração com o TOTVS Automação Fiscal.

Para mais detalhes sobre o conceito de um serviços REST clique aqui.

Para mais detalhes sobre serviços REST na arquitetura Protheus clique aqui.


Índice

Definição do Serviço

Nome: EsocialEstablishment

Objetivo: Disponibilizar os cadastros de estabelecimentos do TAF eSocial através de webservice REST.

Descrição: Retorna os cadastros de estabelecimentos de acordo com os parâmetros enviados, através de webservice REST.

Métodos: GET.

Definição dos métodos

GET

Descrição do Método: O método GET retorna os registros do cadastro de estabelecimentos de acordo com os parâmetros (atributos) enviados na URL.

A Consulta pode combinar parâmetros utilizando a sintaxe “Query String” conforme exemplo abaixo:

http://localhost:17115/rest/EsocialEstablishment/v1?companyId=T1&branch=D MG 01


ParâmetroDescriçãoObrigatório
companyIdIdentificador da empresa*


  • companyId– Código identificador da empresa.
Estrutura da Resposta do método GET (Response):


Atributo

Pai

Nivel

Ocorrência

Formato

lotations

-

1

1

-

branchId

1

2

1

String

companyId121String

id

1

2

1

String

lotationCode

1

2

1

String

description

1

2

1

String

internalId121String


  • branchId– Identificador da filial.
  • companyId– Identificador da empresa.
  • id– Id da lotação.
  • lotationCode– Código da lotação.
  • description– Descrição da lotação.
  • internalId– Id interno da lotação.


Exemplos de requisição utilizando o método GET:

Request:

http://localhost:17115/rest/EsocialEstablishment/v1?companyId=T1&branch=D MG 01



{
    "establishments": [
        {
            "registrationNumber": "68416327000182 ",
            "registrationType": "1"
        },
        {
            "registrationNumber": "98599322000101 ",
            "registrationType": "1"
        }
    ]
}