erp4me

Shop ISS-Easy - Configurações

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.

  1. Execute o instalador do ISS-Easy como administrador.

    📸 Instalação do ISS-Easy:

    ISSEasy_Instalador.png
  2. Conclua a instalação no diretório padrão C:\Program Files (x86)\Alterdata\ISS-Easy.

    📸 Configurações gerais do ISS-Easy:

    ISSEasy_Config Geral.png


  3. Defina o modo de operação: Aplicação, quando depender de usuário logado, ou Serviço, recomendado para ambientes de produção.

  4. Ao abrir o sistema, utilize a área Cadastro para configurar empresas.

    📸 Tela principal do ISS-Easy:

    ISSEasy_Tela principal.png


  5. Use Agendamento para iniciar, parar ou forçar o processamento de XMLs.

  6. 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.

ISSEasy_Config Shop.png
  1. No Automação Comercial Shop, acesse Configurações e Manutenção.

  2. Clique em Opções.

  3. Acesse Opções > Movimentação e marque Trabalha com nota fiscal de serviço eletrônica (NFS-e).

  4. Acesse Produtos > Dados Fiscais > ISS.

  5. Marque Trabalha com Serviços e preencha os parâmetros fiscais exigidos.

  6. Quando houver retenção, marque Calcula retenção de impostos (INSS / IRRF / CSRF) e valide as alíquotas com o contador.

  7. 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.

ISSEasy_Config Mov Estoque.png
  1. No Shop, acesse Estoque > Movimento de Estoque.

  2. Acesse Nota Fiscal de Serviço Eletrônica > Configurar NFS-e.

  3. No campo de arquivo de configuração, informe o diretório do ISS-Easy, normalmente C:\Program Files (x86)\Alterdata\ISS-Easy.

  4. Configure o diretório raiz dos XMLs, preferencialmente C:\DadosISSEasy.

  5. Preencha série RPS, CNAE, layout e demais parâmetros exigidos para a geração do RPS.

  6. 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.

ISSEasy_Item Serviço.png
  1. Acesse Produtos e Serviços > Cadastro de Produtos.

  2. Inclua um novo item ou edite um item já existente.

  3. Na aba Principal, marque a opção É serviço?.

  4. Acesse a aba Dados Fiscais.

  5. 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.

  6. Quando houver retenção, informe as alíquotas de INSS, IRRF e CSRF, sempre com validação do contador.

  7. 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

C:\DadosISSEasy\Envio\RecepcaoNFSe\Pendente

Armazena os XMLs gerados pelo Shop para processamento pelo ISS-Easy.

Autorizada

C:\DadosISSEasy\Recebimento\RecepcaoNFSe\Autorizada

Recebe os XMLs de NFS-e autorizadas pela prefeitura ou pelo Portal Nacional.

Rejeitada

C:\DadosISSEasy\Recebimento\RecepcaoNFSe\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.

  1. Abra os logs do ISS-Easy pela área Ferramentas > Arquivos de log.

  2. Localize o XML de envio ou retorno relacionado à nota.

  3. Execute o validador do ISS-Easy.

  4. Informe o arquivo XML da nota e o XSD correspondente ao provedor/município.

  5. 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.