As APIs do Omie permitem realizar diversas operações no ERP. Com isso, você consegue integrar diferentes aplicativos, expandindo ainda mais as possibilidades.
Em casos em que o município dispõe de um protocolo de cooperação (convênio) entre a Prefeitura e a Sefaz do estado para arrecadação do ISS, por meio da emissão da NFC-e com serviços prestados (também conhecida como NFC-e Conjugada), disponibilizamos uma API para consultar a situação do município em relação à emissão de NFC-e com serviços.
Descubra como verificar a condição de sua Cidade para a importação de Cupom Fiscal de Serviço! 🚀
⚠️ Atenção
A emissão de NFC-e Conjugada é uma prática específica, que depende da legislação de cada estado e Prefeitura. Conforme regulamentação estadual da maioria dos estados e Prefeituras, há casos onde se deve realizar a emissão de documentos fiscais para Serviços prestados separadamente, a partir da emissão de NFS-es. Consulte a sua contabilidade para confirmar a disponibilidade da prática em seu estado/Prefeitura.
Após a consulta da condição de sua Cidade, conforme as orientações deste artigo, a importação de NFC-e de Serviço deve prosseguir conforme o status retornado. Para Cidades com situação "CONVENIADA" ou "HABILITADA", que possibilitam a emissão/importação de Cupom Fiscal de Serviço, prossiga com a importação via API conforme orientações deste artigo:
Para Cidades com situação "INDISPONIVEL", consulte o Suporte para verificar a possibilidade de integração:
Tópicos do Artigo:
Informações importantes
Antes de iniciar seus testes com a nossa API, é fundamental conhecer alguns processos básicos:
✅ Acessando a documentação: Consulte nossa documentação oficial para entender os endpoints disponíveis e seus respectivos parâmetros.
🔑 Chaves de Integração da API: Saiba como obter e utilizar suas credenciais de acesso para autenticar as requisições.
⚙️ Características e Recomendações: Fique por dentro das melhores práticas para otimizar sua experiência com a API da Omie.
🔐 Login no Portal: Para testar suas requisições no Portal do Desenvolvedor é necessário fazer login na plataforma com o mesmo e-mail e senha que você já usa no ERP. Fácil, né? 😉
🧪 Aplicativo Teste: Aprenda a criar um Aplicativo Teste gratuito e descubra, na prática, como utilizar nossas APIs e aproveitar ao máximo os nossos recursos.
💡 Dica Omie: Você pode testar nossas APIs diretamente no nosso Portal do Desenvolvedor. Além disso, ferramentas como Postman, Insomnia e ThunderClient (extensão do VS Code) também são ótimas opções para realizar testes.
Consultando a condição da Cidade para emissão de NFC-e de Serviço
1) Para consultar a condição da Cidade para importação de NFC-e de Serviço será necessário utilizar o método "CidadeCupomConsultar":
2) Você terá a seguinte requisição inicial:
{
"cCod": ""
}
3) O cCod deve ser preenchido com o código da cidade ou código IBGE, obtido na API PesquisarCidades. Se não for informado nenhum valor, será considerada a cidade cadastrada para o aplicativo Omie.
Após ajustar a requisição para sua necessidade, envie a sua requisição.
4) Com tudo certo, você poderá obter um dos seguintes retornos:
ℹ Para expandir a informação, basta clicar na seta em cima da descrição do campo de interesse.
cStatus: CONVENIADA
cStatus: CONVENIADA
{
"cCod": "xxxxxxx (xx)",
"cCodIBGE": "xxxxxxx",
"cNome": "xxxxxxx (xx)",
"cStatus": "CONVENIADA"
}
cStatus: HABILITADA
cStatus: HABILITADA
{
"cCod": "xxxxxxx (xx)",
"cCodIBGE": "xxxxxxx",
"cNome": "xxxxxxx (xx)",
"cStatus": "HABILITADA"
}
cStatus: INDISPONIVEL
cStatus: INDISPONIVEL
{
"cCod": "xxxxxxx (xx)",
"cCodIBGE": "xxxxxxx",
"cNome": "xxxxxxx (xx)",
"cStatus": "INDISPONIVEL"
}
5) E pronto! A consulta de condição da Cidade para emissão de NFC-e de Serviço foi realizada! 🚀
📚 Artigos Relacionados
