O ISS-Easy é o integrador responsável por conectar o Shop aos WebServices das prefeituras para emissão, consulta e retorno da NFS-e. Com a evolução do Portal Nacional da NFS-e e os impactos da Reforma Tributária, manter o Shop, o ISS-Easy, os diretórios e os dados fiscais alinhados é essencial para evitar rejeições e falhas de comunicação. Consulte as seções de Detalhamento de Campos para entender a finalidade de cada configuração.
Pré-requisitos
- ISS-Easy instalado com permissões administrativas.
- Certificado digital A1 ou A3 válido e acessível no ambiente de emissão.
- Diretório raiz criado para os XMLs, preferencialmente
C:\DadosISSEasy. - Caminho de instalação do ISS-Easy identificado, normalmente
C:\Program Files (x86)\Alterdata\ISS-Easy. - Usuário com permissões para gravar configurações, criar pastas e acessar logs.
- Empresa, cliente/tomador e serviços previamente cadastrados no Shop.
Instalação e Interface
Prepare o ISS-Easy para operar como integrador entre o Shop e a prefeitura.
-
Execute o instalador do ISS-Easy como administrador.
📸 Instalação do ISS-Easy:
-
Conclua a instalação no diretório padrão
C:\Program Files (x86)\Alterdata\ISS-Easy.
📸 Configurações gerais do ISS-Easy:
-
Defina o modo de operação: Aplicação, quando depender de usuário logado, ou Serviço, recomendado para ambientes de produção.
-
Ao abrir o sistema, utilize a área Cadastro para configurar empresas.
📸 Tela principal do ISS-Easy:
-
Use Agendamento para iniciar, parar ou forçar o processamento de XMLs.
-
Acesse Ferramentas para testar conexão, consultar logs, reimprimir NFS-e e consultar notas.
Detalhamento de Campos - Instalação e Interface
|
Campo |
Onde fica |
Objetivo |
|---|---|---|
|
Modo Aplicação |
ISS-Easy > Modo de operação |
Executa o integrador com dependência de usuário logado no Windows. |
|
Modo Serviço |
ISS-Easy > Modo de operação |
Mantém o processamento em segundo plano, indicado para produção. Compatível com certificado A1. |
|
Cadastro |
Tela principal do ISS-Easy |
Permite incluir, editar, excluir e ativar empresas para integração. |
|
Agendamento |
Tela principal do ISS-Easy |
Controla os ciclos automáticos de leitura, assinatura, envio, consulta e download dos retornos. |
|
Ferramentas |
Tela principal do ISS-Easy |
Centraliza testes de conexão, logs, reimpressão e consulta de notas. |
Configurações no Shop
📸 Habilite o Shop para trabalhar com prestação de serviços e emissão de NFS-e.
-
No Automação Comercial Shop, acesse Configurações e Manutenção.
-
Clique em Opções.
-
Acesse Opções > Movimentação e marque Trabalha com nota fiscal de serviço eletrônica (NFS-e).
-
Acesse Produtos > Dados Fiscais > ISS.
-
Marque Trabalha com Serviços e preencha os parâmetros fiscais exigidos.
-
Quando houver retenção, marque Calcula retenção de impostos (INSS / IRRF / CSRF) e valide as alíquotas com o contador.
-
Clique em Gravar e reinicie os terminais, se necessário.
Detalhamento de Campos - Configurações no Shop
|
Campo |
Onde fica |
Objetivo |
|---|---|---|
|
Trabalha com NFS-e |
Configurações e Manutenção > Opções > Movimentação |
Habilita no Shop as rotinas de emissão de Nota Fiscal de Serviço Eletrônica. |
|
Trabalha com Serviços |
Configurações e Manutenção > Opções > Produtos > Dados Fiscais > ISS |
Libera o tratamento de itens como serviço no cadastro de produtos. |
|
Calcula retenção de impostos |
Configurações e Manutenção > Opções > Produtos > Dados Fiscais |
Habilita os campos e cálculos de INSS, IRRF e CSRF quando aplicáveis. |
|
Somar ISS ao total |
Configurações e Manutenção > Opções > Produtos > Dados Fiscais > ISS |
Define se o ISS será somado ao total do documento, conforme exigência municipal. |
Integração de Diretórios
📸 Configure o caminho usado pelo Shop para localizar o ISS-Easy e gravar os XMLs nos diretórios corretos.
-
No Shop, acesse Estoque > Movimento de Estoque.
-
Acesse Nota Fiscal de Serviço Eletrônica > Configurar NFS-e.
-
No campo de arquivo de configuração, informe o diretório do ISS-Easy, normalmente
C:\Program Files (x86)\Alterdata\ISS-Easy. -
Configure o diretório raiz dos XMLs, preferencialmente
C:\DadosISSEasy. -
Preencha série RPS, CNAE, layout e demais parâmetros exigidos para a geração do RPS.
-
Clique em Gravar.
Detalhamento de Campos - Integração de Diretórios
|
Campo |
Onde fica |
Objetivo |
|---|---|---|
|
Arquivo de configuração do ISS-Easy |
Movimento de Estoque > Nota Fiscal de Serviço Eletrônica > Configurar NFS-e |
Permite que o Shop leia os parâmetros necessários para se comunicar com o ISS-Easy. |
|
Diretório raiz dos XMLs |
ISS-Easy e Configurar NFS-e no Shop |
Define onde ficarão os XMLs de envio, retorno, autorização, rejeição, cancelamento e logs. |
|
Série RPS |
Movimento de Estoque > Configurar NFS-e |
Identifica a série do Recibo Provisório de Serviço gerado antes da NFS-e. |
|
CNAE |
Movimento de Estoque > Configurar NFS-e |
Informa a atividade econômica relacionada à prestação de serviço. |
|
Layout |
Movimento de Estoque > Configurar NFS-e |
Define o modelo de impressão do RPS ou da NFS-e, conforme configuração disponível. |
Cadastro de Serviços
📸 Cadastre corretamente os serviços que serão utilizados na emissão de NFS-e pelo Shop integrado ao ISS-Easy.
-
Acesse Produtos e Serviços > Cadastro de Produtos.
-
Inclua um novo item ou edite um item já existente.
-
Na aba Principal, marque a opção É serviço?.
-
Acesse a aba Dados Fiscais.
-
Preencha Código da lista de serviços (LC 116/03), Código de tributação no município, Alíquota, natureza da operação e demais classificações fiscais.
-
Quando houver retenção, informe as alíquotas de INSS, IRRF e CSRF, sempre com validação do contador.
-
Clique em Gravar.
Detalhamento de Campos - Cadastro de Serviços
|
Campo |
Onde fica |
Objetivo |
|---|---|---|
|
É serviço? |
Produtos e Serviços > Cadastro de Produtos > Principal |
Define que o item será tratado como serviço e seguirá regras de ISS/NFS-e. |
|
Natureza da operação |
Cadastro de Produtos > Dados Fiscais |
Indica como o serviço será tributado, como no município, fora do município, isento ou exportação. |
|
Código LC 116/03 |
Cadastro de Produtos > Dados Fiscais |
Classifica o serviço conforme a legislação federal e é validado por muitas prefeituras. |
|
Código de tributação municipal |
Cadastro de Produtos > Dados Fiscais |
Identifica o código exigido pelo município para aquele serviço. |
|
Alíquota de ISS |
Cadastro de Produtos > Dados Fiscais |
Define o percentual de ISS aplicado ao valor do serviço. |
|
Retenções |
Cadastro de Produtos > Dados Fiscais |
Configura INSS, IRRF e CSRF quando o tomador for responsável por reter tributos. |
|
NBS |
Cadastro de Produtos > Dados Fiscais |
Classifica nacionalmente o serviço e ganha relevância com a padronização fiscal. |
Fluxo de Emissão e Cancelamento
No fluxo normal, o Shop gera o RPS e cria o XML no diretório de envio configurado. O ISS-Easy monitora esse diretório, assina o XML com o certificado digital, envia o lote ao WebService da prefeitura ou ao Portal Nacional, consulta o status e grava o retorno em pastas de autorização ou rejeição.
Para cancelamento, o Shop gera um XML específico e o ISS-Easy realiza o envio e acompanhamento do retorno. Em municípios que exigem cancelamento manual pelo portal da prefeitura, configure essa opção em Movimento de Estoque > Nota Fiscal de Serviço > Configurar NFS-e.
Detalhamento de Campos - Fluxo de Emissão e Cancelamento
|
Campo |
Onde fica |
Objetivo |
|---|---|---|
|
RPS |
Shop > Nota Fiscal de Serviço |
Documento provisório gerado pelo Shop antes da autorização da NFS-e. |
|
Pasta de envio |
|
Armazena os XMLs gerados pelo Shop para processamento pelo ISS-Easy. |
|
Autorizada |
|
Recebe os XMLs de NFS-e autorizadas pela prefeitura ou pelo Portal Nacional. |
|
Rejeitada |
|
Recebe os retornos com erro para análise e correção. |
|
Cancelamento manual |
Movimento de Estoque > Configurar NFS-e |
Indica que o cancelamento deve ser feito diretamente no portal da prefeitura quando o município não aceitar cancelamento via XML. |
Validador e Tratamento de Erros
Use os logs e o validador do ISS-Easy sempre que houver rejeição, falha de envio, lote não recebido ou inconsistência no XML. A análise deve começar pelos arquivos de log e retornos da prefeitura, pois eles indicam a mensagem real devolvida pelo município ou pelo Portal Nacional.
-
Abra os logs do ISS-Easy pela área Ferramentas > Arquivos de log.
-
Localize o XML de envio ou retorno relacionado à nota.
-
Execute o validador do ISS-Easy.
-
Informe o arquivo XML da nota e o XSD correspondente ao provedor/município.
-
Clique em Validar e corrija o campo indicado na mensagem.
Detalhamento de Campos - Validador e Erros
|
Campo |
Onde fica |
Objetivo |
|---|---|---|
|
Arquivos de log |
ISS-Easy > Ferramentas |
Permitem analisar envio, consulta, retorno e falhas de comunicação. |
|
ret-lot |
Diretório de logs do ISS-Easy |
Mostra o retorno real da prefeitura para o lote enviado. |
|
Arquivo XML |
Validador do ISS-Easy |
Arquivo que será validado para identificar problemas de estrutura ou dados. |
|
Arquivo XSD |
Pasta de schemas do provedor |
Define as regras técnicas usadas para validar o XML. |
|
Testar conexão |
ISS-Easy > Ferramentas |
Verifica comunicação com WebService, ambiente e rede. |
Reforma Tributária e NBS
A Reforma Tributária impacta a NFS-e por introduzir novos tributos, como IBS e CBS, que podem coexistir com o ISS durante o período de transição. Isso exige atenção a layouts, regras de cálculo, validações e atualizações do Shop e do ISS-Easy.
A NBS (Nomenclatura Brasileira de Serviços) ganha importância nesse cenário por padronizar a classificação dos serviços, apoiar a tributação correta e facilitar a integração com municípios e com o Portal Nacional da NFS-e.
Detalhamento de Campos - Reforma Tributária e NBS
|
Campo |
Onde fica |
Objetivo |
|---|---|---|
|
IBS |
Layouts e regras fiscais da NFS-e |
Novo tributo sobre bens e serviços previsto na Reforma Tributária. |
|
CBS |
Layouts e regras fiscais da NFS-e |
Contribuição sobre bens e serviços que pode exigir novos campos e validações. |
|
NBS |
Cadastro do serviço > Dados Fiscais |
Padroniza a identificação nacional do serviço prestado. |
|
Portal Nacional da NFS-e |
Integração municipal ou nacional |
Centraliza e padroniza a emissão de NFS-e em municípios aderentes. |
|
Layout XML |
ISS-Easy, provedor e regras municipais |
Define a estrutura técnica aceita pelo município ou Portal Nacional. |
⌨️ Atalhos
|
Ação |
Atalho / Caminho rápido |
|---|---|
|
Configurar opções do Shop |
Configurações e Manutenção > Opções |
|
Configurar NFS-e |
Estoque > Movimento de Estoque > Nota Fiscal de Serviço Eletrônica > Configurar NFS-e |
|
Cadastrar serviço |
Produtos e Serviços > Cadastro de Produtos |
|
Consultar logs |
ISS-Easy > Ferramentas > Arquivos de log |
|
Testar conexão |
ISS-Easy > Ferramentas > Testar conexão |
Aviso de Ecossistema: o Shop é responsável por gerar o RPS e depositar os XMLs nos diretórios configurados; o ISS-Easy monitora esses arquivos, assina, envia para a prefeitura ou Portal Nacional e grava os retornos. Para evitar falhas como lote não recebido, rejeição por layout, ausência de retorno ou erro de certificado, mantenha Shop, ISS-Easy, certificado digital, diretórios, cadastro da empresa e cadastro dos serviços sempre alinhados e atualizados.