GET/nfse/cidades/{codigoIbge}

Consultar disponibilidad del municipio y metadatos

Consulta la disponibilidad de emisión y particularidades por código IBGE. Usos típicos: - Confirmar qué municipios ya están atendidos. - Obtener más información del municipio que va a utilizar. Notas: - Esta ruta se actualiza de forma continua.

Producción: https://api.otentecnologia.com.brSandbox: https://api.sandbox.otentecnologia.com.br

Parámetros

codigoIbge

path · obligatorio

Código IBGE de la ciudad que se consultará.

Solicitud

cURL

curl -X GET 'https://api.otentecnologia.com.br/nfse/cidades/{codigoIbge}' \
  -H 'x-api-key: $OTEN_API_KEY' \
  -H 'Content-Type: application/json'

Respuestas

200OK

JSON

{
  "id": 4115200,
  "nome": "Maringá",
  "uf": "PR",
  "padrao": "MARINGA",
  "certificado": true,
  "multiservicos": false,
  "login": false,
  "senha": false,
  "upload": false,
  "sequencial": true,
  "substituicao": true,
  "informacoesComplementares": 0,
  "descricao": 0,
  "padraoNacional": {
    "producao": true,
    "homologacao": true
  }
}

400Bad Request

JSON

{
  "error": {
    "message": "A cidade vinculada ao código IBGE utilizado ainda não foi homologada",
    "data": {
      "id": 4116208,
      "nome": "Morretes",
      "uf": "PR"
    }
  }
}

404Not Found

JSON

{
  "error": {
    "message": "Não localizamos qualquer Cidade com os parâmetros informados",
    "data": {
      "id": "411520"
    }
  }
}