docs
DocumentaciónDocs FuncionaisNFS-e com códigos de serviço definidos por cliente

NFS-e com códigos de serviço definidos por cliente

Actualizado el 12/08/2026 · Odoo 17.0

NFS-e com códigos de serviço definidos por cliente

Até esta versão, os códigos de serviço usados na emissão da NFS-e (Tipo de Serviço, Código no Município e Código CNAE/NBS) eram configurados apenas no cadastro do produto. Quando o mesmo serviço precisava sair com códigos diferentes conforme o cliente da nota, não havia como resolver dentro do sistema. Esta entrega adiciona o Padrão Fiscal de Serviço do Contato: os códigos passam a poder ser definidos no cadastro do cliente, e a NFS-e usa os códigos do cliente no lugar dos códigos do produto.

1. Ativação na posição fiscal

Em Edoo Fiscal > Configuração > Posições Fiscais, abra a posição fiscal usada para a emissão da NFS-e. No grupo Configurações de Serviços, marque a opção Utiliza Padrão Fiscal de Serviço do Contato.

  • A opção vem desmarcada por padrão. Com ela desmarcada nada muda: a NFS-e continua usando os códigos do produto.
  • A ativação vale para todas as notas emitidas com essa posição fiscal.


2. Códigos de serviço no cadastro do cliente

No cadastro do cliente, aba Informações Fiscais, foi criado o grupo Padrão Fiscal de Serviço (NFS-e), com três campos:

  • Tipo de Serviço (NFS-e): o código do indicador de operações que deve valer para este cliente.
  • Código no Município (NFS-e): o código de tributação do município para este cliente.
  • Código CNAE/NBS (NFS-e): o código CNAE/NBS para este cliente.


3. Emissão da NFS-e com os códigos do cliente

Ao confirmar a fatura com a posição fiscal ativada, a NFS-e é gerada com os códigos do cliente no lugar dos códigos do produto. Os valores aplicados podem ser conferidos na nota, na aba Itens (e no detalhe da linha, aba ISS).

  • Campo preenchido no cliente substitui o campo equivalente do produto.
  • Campo vazio no cliente continua vindo do produto. A substituição é campo a campo: é possível, por exemplo, definir apenas o Código no Município no cliente e manter os demais códigos do produto.
  • Se o contato da fatura for um contato filho (endereço de entrega ou contato de faturamento) sem nenhum dos três códigos preenchidos, o sistema busca os códigos na empresa principal do contato.


4. Exceções por serviço (ajuste manual)

Quando um cliente possui regra diferente apenas para determinados serviços, mantenha o padrão do cliente no cadastro e, nas notas desses serviços específicos, ajuste os códigos manualmente no rascunho da nota, nas linhas da aba Itens, antes do envio.

  • Atenção: se a fatura for redefinida para provisório e confirmada novamente, as linhas da nota são regeradas a partir do cadastro e os ajustes manuais são descartados. Nesse caso, refaça o ajuste antes de reenviar.

Ativação e onde encontrar

  • Atualização do módulo: o edoo_br_nfe precisar estar na versão 17.0.2.0.12 no ambiente. 
  • Opção na posição fiscal: Edoo Fiscal > Configuração > Posições Fiscais > (abrir a posição fiscal de NFS-e) > Configurações de Serviços > Utiliza Padrão Fiscal de Serviço do Contato.
  • Códigos no cliente: Contatos > (abrir o cliente) > aba Informações Fiscais > Padrão Fiscal de Serviço (NFS-e).
  • Pré-requisito: a substituição só acontece nas notas cuja posição fiscal estiver com a opção marcada e cujo cliente tiver os códigos preenchidos.
🗂️ Docs Funcionais