GetTax, powered by SAC Fiscal

Referência da API

Listar setores

Lista os códigos aceitos no campo sector; exige chave e não consome franquia.

get/v1/enums/sectors

Autenticação: Authorization: Bearer <sua chave>. Como obter a chave

Devolve os códigos aceitos no campo sector da consulta unitária e do lote. O significado de cada setor e o efeito dele no resultado estão em Dados da consulta.

Exige chave de API, como toda rota em /v1/, e não consome franquia. Por isso é a forma recomendada de validar uma chave nova e de checar a saúde da integração.

Exemplos

Terminal
curl -sS "$GETTAX_URL/v1/enums/sectors" \
-H "Authorization: Bearer $GETTAX_KEY"

Respostas

200Lista de setores.›
  • sectorsarray<string>obrigatório
    Códigos de setor aceitos hoje. A lista pode crescer: leia daqui em vez de fixá-la no código.
Exemplo · 200
{
"sectors": [
"VAREJO_GERAL",
"BAR_RESTAURANTE",
"PRODUTOR_RURAL",
"GOVERNO",
"ATACADO",
"ZONA_FRANCA"
]
}
401Chave ausente, malformada, inexistente, revogada ou de cliente desativado.›
Exemplo · 401
{
"error": "INVALID_API_KEY"
}
500Erro inesperado. Repita com backoff exponencial.›
Exemplo · 500
{
"error": "INTERNAL_ERROR"
}
503Serviço temporariamente indisponível. Repita com backoff exponencial.›
  • errorstringobrigatório
    Código do erro, sem mensagem detalhada. Ver Erros e novas tentativas.
    Valores:SERVICE_UNAVAILABLE
Exemplo · 503
{
"error": "SERVICE_UNAVAILABLE"
}

Testar

A chamada sai do seu navegador direto para a API, com a sua chave. É uma chamada real: o que consome franquia numa integração consome aqui também.

Fica só nesta aba (sessionStorage) e vai apenas no cabeçalho Authorization.

GET https://app-web-hmg-01-api-gettax-hmg-dvawffg9g9cpcef3.brazilsouth-01.azurewebsites.net/v1/enums/sectors