Lista de cidades disponíveis

Importante para Integração Direta Para você conseguir integrar é obrigatória a leitura sobre "Utilização das APIs" e recomendada a leitura sobre "Instruções Iniciais" e "Client Credentials e Client ID"

Quais são os requisitos para a uso desta API?

Token: possuir um token de acesso válido é essencial. Caso ainda não tenha gerado um, temos um guia detalhado disponível no tópico Fluxos de Autorização e Autenticação.

Parâmetros de resposta

Parâmetro	Tipo	Descrição
ibge_code obrigatório	Int	Código IBGE da cidade, que identifica de forma única cada município no Brasil
city obrigatório	String	Nome da cidade, sem acentos
state obrigatório	String	Sigla do estado ao qual a cidade pertence
active obrigatório	Boolean	Informa se a cidade está ativa para emissão de notas fiscais na Cora, ou não
certificate obrigatório	Boolean	Indica se a cidade necessita de certificado para emissão de notas fiscais
login obrigatório	Boolean	Indica se a cidade precisa de login para emissão de notas fiscais
password obrigatório	Boolean	Indica se a cidade requer senha para emissão de notas fiscais
issuer_template obrigatório	IssuerTemplateResponse	Objeto IssuerTemplateResponse

Dicas de implementação

Premissas

Esta API permite a consulta de disponibilidade para emissão municipal, a emissão aplicável quando o cliente prestador de serviço está localizado em uma cidade específica e requer uma nota fiscal emitida localmente. No entando, é importante observar que existe a opção de emissão nacional para alguns cliente, como MEIs, por exemplos.

Tipos de Objetos

Objeto IssuerTemplateResponse

Parâmetro	Tipo	Descrição
id obrigatório	String	UUID que funciona como identificador do padrão correspondente da cidade
name obrigatório	String	Nome do padrão correspondente da cidade. Ex.: GOVDIGITAL
allow_cancellation obrigatório	Boolean	Indica se o padrão permite cancelamento

Integração Direta e Testes

Esta plataforma de documentação, atualmente, não permite o upload de informações importantes como certificados e private keys. Por isso, não recomendamos o uso dela para testes da modalidade de Integração Direta.

Para fazer os testes que incluam essas informações sensíveis pedimos que use um sistema de sua escolha.