Listando UF's e Cidades via API de Administração do Manager SaaS

Neste post será explicado como utilizar as rotas HTTP disponibilizadas para o consultar as UFs e Cidades utilizadas no cadastro de clientes na interface de Administração do Manager SaaS via API, nos anexos deste é possível realizar o download da aplicação em C#.

Atenção!

Para ser possível realizar a comunicação, primeiramente é necessário gerar o token que será necessário na autenticação da comunicação para o cadastro de grupos/empresas e na atualização de certificados, o mesmo é válido por 3 horas. Para isso, você pode acessar esse artigo e verificar como gera-lo.

Listar UF's

Para listar as UF's com o código da UF, sigla e descrição, basta enviar uma requisição GET na rota:

GET

** Tabela de Codigos das UFs IBGE

Exemplo de Retorno

{
    "mensagem": "Registros retornados com sucesso",
    "dados": [
        {
            "handle": 19,
            "codigouf": 33,
            "sigla": "RJ",
            "descricao": "Rio de Janeiro"
        }
    ],
    "total": 1
}

Listar Cidades

Para listar cidades é possível informar o ID da UF que seria o Handle retornado na consulta demonstrada acima.

Utilizando a rota abaixo é possível obter apenas uma cidade ou todas as cidades disponíveis dentro da UF basta enviar uma requisição GET na rota:

GET

{
    "mensagem": "Registros retornados com sucesso",
    "dados": [
        {
            "handle": 3178,
            "iduf": 19,
            "codigoibge": "3300225",
            "descricao": "Areal",
            "descricaopadrao": "AREALRJ",
            "descricaopadraocomuf": "AREALRJ",
            "nfsehomologada": true,
            "nomepadrao": "BETHA"
        }
    ],
    "total": 1
}

Essa consulta por ser feita tanto com o iduf quanto com o codigoibge.