Nota Fiscal - Configurar o emissor
O que é
É aqui que você conecta o Viagilize ao seu emissor de NFS-e. A conta do emissor é da sua agência: o certificado digital e a configuração fiscal ficam lá, e o Viagilize só usa as credenciais que você informar para mandar os dados do pedido.
Só um emissor fica ligado por vez. Ligar um desliga o outro, e o que estiver ligado recebe todas as notas novas.
Antes de começar, combine com o seu contador o código do serviço, a alíquota de ISS e se o ISS é retido. Para agenciamento de viagens e turismo, o item da LC 116 costuma ser o 9.02 e o CNAE o 7911200, mas quem confirma é o contador.
Como usar
- Vá em Nota Fiscal > Configurações.
- No bloco Emissores, clique no card do seu emissor. A configuração dele abre logo abaixo.
- Preencha as credenciais e os dados fiscais (veja cada emissor a seguir).
- Quando houver o botão Buscar dados (Omie, Asaas, PlugNotas e Conta Azul têm), clique nele para escolher o serviço, a categoria e a conta direto da lista do emissor, em vez de digitar códigos.
- Clique em Testar conexão para conferir as credenciais.
- Ligue o emissor e clique em Salvar emissor.
O card mostra a situação do emissor: Ligado, Falta configurar, Configurado, desligado ou Não configurado.
Configuração de cada emissor
Omie
- App Key e App Secret: no painel da Omie, em Configurações > API. Cada empresa da Omie tem as suas.
- Serviço cadastrado na Omie: o jeito recomendado. Cadastre o serviço uma vez na Omie (com CNAE, código e alíquota) e escolha aqui com Buscar dados da Omie. Os campos Código do serviço no município, Código da LC 116 e Alíquota de ISS só precisam ser preenchidos se você não escolher um serviço cadastrado.
- Cidade da prestação do serviço: exatamente como a Omie escreve, com a sigla do estado. Exemplo: SAO PAULO (SP).
- Categoria financeira e Conta corrente: onde a receita entra na Omie.
- Etapa em que a ordem de serviço nasce: deixe em branco para usar a etapa padrão (20).
- Faturar na hora (emite a nota): desligado, o Viagilize só cria a ordem de serviço e a sua equipe fatura dentro da Omie, que é quando a nota é emitida. Nesse modo os botões passam a dizer Enviar para a Omie. Ligado, o Viagilize fatura a ordem e a nota é emitida.
Asaas
- Usar a chave que já está em Pagamentos: se você já recebe pelo Asaas, marque e não precisa digitar a chave de novo. Se não, preencha Chave de API do Asaas.
- Ambiente de teste (sandbox): ligado, nada vai para a prefeitura. Use só para conferir o fluxo.
- Descrição do serviço municipal: obrigatório pelo Asaas, como o serviço é descrito na sua prefeitura.
- Serviço municipal cadastrado: só aparece se a sua prefeitura usa lista de serviços. Use o botão Buscar dados.
- Código do serviço no município, Alíquota de ISS (%) (o Asaas espera a alíquota, por exemplo 5 para 5%) e ISS retido pelo tomador.
- Autorizar na hora: ligado, a nota é mandada para a prefeitura assim que é criada.
PlugNotas
- Token de API: no painel da PlugNotas, em Configurações > Token.
- Ambiente de teste (sandbox): ligado, nada vai para a prefeitura.
- CNPJ da empresa emitente: a empresa precisa estar cadastrada na PlugNotas, com o certificado digital.
- Código do serviço (LC 116), Código de tributação no município (algumas prefeituras exigem), CNAE, Alíquota de ISS (%) e ISS retido pelo tomador.
- A PlugNotas envia a nota por e-mail ao cliente: ligado, quem avisa o cliente é a PlugNotas.
Focus NFe
- Token da empresa e Ambiente de homologação (ligado, nada vai para a prefeitura; troque para o token de produção ao desligar).
- CNPJ da empresa emitente (só números) e Inscrição municipal (obrigatória pela Focus).
- Código do município (IBGE): sete dígitos, do município onde o serviço é prestado.
- Item da lista de serviço (LC 116), Código tributário do município, CNAE, Alíquota de ISS (%) e ISS retido pelo tomador.
- Optante do Simples Nacional e Natureza da operação (a maioria das agências usa a 1; confirme com o contador).
Conta Azul
- Conectar Conta Azul: abre o login do Conta Azul. Entre com a conta da agência e autorize; não há chave para copiar.
- Serviço cadastrado no Conta Azul: o serviço da venda e da nota, com a tributação configurada no Conta Azul. Escolha com Buscar dados.
- Categoria financeira e Conta financeira: onde a receita e o recebimento entram no Conta Azul.
- Aprovar a venda na hora: ligado, a venda já nasce aprovada, com a conta a receber no financeiro do Conta Azul, e a nota segue a configuração fiscal de lá. Desligado, a venda fica em andamento esperando alguém aprovar no Conta Azul.
- Registrar o recebimento: com a venda aprovada, marca a conta a receber como recebida, porque o pedido já foi pago no Viagilize.
Envio automático no pagamento
No bloco Automação, a opção Enviar ao emissor quando o pedido for pago manda o pedido sozinho para o emissor ligado assim que o pagamento é confirmado, sem precisar clicar em Emitir nota fiscal. Pedido cancelado, cortesia ou de valor zero não é enviado. A opção nasce desligada: ligue depois de conferir algumas notas enviadas à mão. Clique em Salvar automação.
Exibição
No bloco Exibição, Fixar no topo do menu coloca o módulo Nota Fiscal no topo do menu lateral. Clique em Salvar exibição.
Erros comuns e como resolver
- O card mostra "Falta configurar": o emissor está ligado, mas falta um campo obrigatório. Abra o card e complete.
- Testar conexão falha: confira se a chave ou o token é do ambiente certo (teste ou produção) e se foi copiado inteiro.
- "Buscar dados" não traz nada: salve as credenciais antes e confira se o serviço, a categoria e a conta estão cadastrados no emissor.
- Notas recusadas pela prefeitura: quase sempre é código de serviço, alíquota ou cidade. Corrija aqui e envie de novo pela lista de notas.
Onde encontrar
- URL:
/admin/nota-fiscal/configuracoes - Caminho no menu: Nota Fiscal > Configurações
- Permissão necessária:
nota-fiscal.config - Addon necessário: Nota Fiscal