Fiscal (NFS-e)
O módulo Fiscal gerencia a emissão de documentos fiscais eletrônicos no padrão brasileiro. O Opero emite NFS-e (Nota Fiscal de Serviços Eletrônica) por meio do provedor PlugNotas, que faz a transmissão à prefeitura.
Add-on pago: a emissão de NFS-e é o add-on NFS-e Brazil, contratado separadamente na Opero Store.
O que são documentos fiscais?
Documentos fiscais são comprovantes obrigatórios que registram a prestação de serviços ou venda de produtos para fins tributários. No Brasil, hotéis e hospedagens precisam emitir notas fiscais para:
- Diárias de hospedagem
- Serviços de alimentação e bebidas (A&B)
- Estacionamento, lavanderia, spa e outros serviços
- Locação de espaços para eventos
Tipos de documento
| Tipo | Nome completo | Quando usar |
|---|---|---|
| NF-e | Nota Fiscal Eletrônica | Venda de produtos — não é emitida pelo Opero |
| NFC-e | Nota Fiscal de Consumidor Eletrônica | Vendas diretas ao consumidor — não é emitida pelo Opero |
| NFS-e | Nota Fiscal de Serviços Eletrônica | Serviços prestados, como hospedagem (varia por município) |
Nota: O tipo exato de documento depende do regime tributário do hotel e do município. Consulte seu contador para a configuração correta.
Configuração inicial
Antes de emitir notas fiscais, acesse Configurações > Configurações Fiscais e selecione a entidade fiscal (Owner). A emissão automática só acontece para propriedades no Brasil com CNPJ cadastrado.
Dados de emissão (NFS-e)
| Campo | Descrição |
|---|---|
| Status | Habilitado ou Desabilitado |
| Ambiente | Sandbox (testes) ou Produção |
| Chave da API | Chave de acesso ao PlugNotas |
| Modo de Emissão Automática | Manual, No Check-in ou No Check-out |
| Código IBGE | Código do município |
| Inscrição Municipal | Inscrição do prestador na prefeitura |
| Acesso à Prefeitura | Usuário e senha do portal da prefeitura |
| Procuração Específica | Se há procuração para emissão |
O regime tributário (Simples Nacional, Lucro Presumido ou Lucro Real) é lido do cadastro do proprietário (Owner); sem essa informação, o sistema considera Simples Nacional.
Certificado digital
Para emitir notas, é necessário um certificado digital A1:
- Na seção “Certificado Digital A1”, selecione o arquivo .pfx ou .p12
- Informe a senha do certificado (e, se quiser, a data de validade)
- O sistema armazena o certificado de forma criptografada e mostra a validade
- O certificado A1 vale um ano: envie um novo antes do vencimento
Perfis de serviço
Em Perfis de Serviço, cadastre os serviços que serão faturados (ex.: Hospedagem). Cada perfil tem nome, tipo de documento, código LC 116, CNAE, código de serviço municipal, alíquota de ISS (%) e a discriminação padrão do serviço. As abas IBS/CBS, Comércio Exterior e Extras guardam os campos da Reforma Tributária, de comércio exterior e os tributos aproximados (Lei 12.741).
Importante: Comece no ambiente Sandbox para testar. Mude para Produção apenas quando tudo estiver validado.
Emitir uma nota fiscal
Emissão automática (check-in ou check-out)
Se o Modo de Emissão Automática for No Check-in ou No Check-out, o Opero emite a NFS-e automaticamente nesse momento:
- Ao realizar o check-in ou check-out, o sistema verifica se a emissão fiscal está habilitada e qual é o modo configurado
- Se o modo coincidir, gera a NFS-e com os dados da reserva
- Envia ao PlugNotas e acompanha o retorno da prefeitura
Emissão manual
Para notas avulsas ou situações especiais:
- Abra o folio da reserva (Reservas > ícone “Ver Folio”)
- Na seção Documentos Fiscais, clique em “Emitir NFS-e”
- Preencha:
| Campo | Obrigatório | Descrição |
|---|---|---|
| Valor Bruto | Sim | Valor da nota |
| Nome do Tomador | Não | Nome do cliente |
| Descrição | Não | Detalhamento do serviço |
- Clique em “Emitir NFS-e”
- A nota aparece na lista de Documentos Fiscais da reserva com o seu status
Impostos
O Opero não calcula os tributos da empresa (DAS, PIS, COFINS, IRPJ, CSLL). Na emissão da NFS-e, ele envia ao provedor o regime tributário do proprietário e a alíquota de ISS do perfil de serviço. A apuração fiscal deve ser feita pelo contador da empresa.
Status das notas fiscais
| Status | Significado |
|---|---|
| Pendente | Aguardando envio |
| Processando | Enviada, aguardando o retorno da prefeitura |
| Emitida | Autorizada |
| Rejeitada | Recusada (erro nos dados) |
| Erro | Falha no envio; o sistema tenta reenviar automaticamente (até 5 tentativas) |
| Cancelada | Emitida e depois cancelada |
Cancelamento
Uma nota emitida pode ser cancelada:
- Localize a nota na seção Documentos Fiscais do folio
- Clique em “Cancelar Documento”
- Informe o motivo do cancelamento (obrigatório)
- O sistema envia o cancelamento ao provedor
Boas práticas
- Configure em Sandbox primeiro — Teste antes de emitir notas reais
- Mantenha o certificado atualizado — Renove antes do vencimento para evitar interrupções
- Confira os dados do tomador — Especialmente em notas para empresas
- Cancele dentro do prazo — Após o prazo do município, não é possível cancelar
- Consulte seu contador — Para regime tributário e alíquotas específicas do seu município