⚠️ O padrão ISSNETONLINE20 está em fase de migração para ISSNETONLINE30 (layout Nacional). Disponibilizamos em 21/05 o ambiente de Homologação para início de testes. Orientamos a consulta da documentação técnica do padrão ISSNETONLINE30, responsável por atender o novo layout nacional, contendo as orientações de configuração, regras de preenchimento e particularidades necessárias para emissão em homologação e futuramente em produção.
Documentação Técnica - Padrão ISSNETONLINE30
Tópicos deste artigo
Manual do web service
Portais disponíveis
- Produção
- Homologação (Para alguns municípios)
Métodos disponíveis
Emissão
Envio sequencial: ( ) Necessita (X) Não necessita
Modo: ( ) Síncrono ( ) Assíncrono (X) Ambos
Lote: (X) Aceita lote ( ) Não aceita lote
Consulta
(X) Consulta de lote
(X)Consulta por RPS
(X) Consulta por NFS-e
( ) Consulta por protocolo
( ) Consulta de notas tomadas
( ) Consulta por período
Cancelamento / Eventos
(X) cancelamento via web service
( ) cancelamento administrativo
O padrão possui cancelamento de NFS-e, mas há exceções e regras específicas por município. Em Aparecida de Goiânia, por exemplo, o cancelamento não é aceito via web service e deve ser feito pelo portal; em Anápolis e Brasília há regras próprias de prazo e fluxo.
Tipo de impressão
(X) link da prefeitura
Os produtos realizam o download do PDF gerado pela prefeitura.(X) layout TecnoSpeed
Os produtos geram o PDF da NFS-e, aproximando-se ao máximo do layout da prefeitura.
Importante: o tipo de impressão depende do que o padrão permite. Não é possível editar livremente o layout além das opções suportadas pelo produto/padrão.
Observações gerais do padrão
O padrão possui quebra de linha.
Para dúvidas diretamente com o sistema, entre contato com
suporte@notacontrol.com.br.Cada município geralmente possui uma série específica, então esse parâmetro deve ser validado antes da implantação.
O padrão aceita emissão sem informação de tomador. Para clientes PlugNotas, orientamos não enviar o nó
tomador. Para os demais produtos, a orientação é manter os campos do tomador vazios no TX2.Atualmente o padrão conta com impressão via link e também RTM. Para impressão via link, o certificado do prestador precisa estar configurado.
Autenticação
O padrão ISSNETONLINE20 utiliza comunicação pela Internet com SSL e autenticação com certificado digital. São aceitos certificados emitidos por autoridade certificadora credenciada pela ICP-Brasil, de pessoa física ou jurídica, dos tipos A1, A3 ou certificado de servidor (híbrido). O certificado é exigido tanto para a assinatura das mensagens quanto para a transmissão entre o sistema do contribuinte e o web service.
Componente NFS-e : Configurando a Autenticação pelo Certificado Digital
PlugNotas: Cadastrando Certificados via API e Cadastrando Certificado pela interface
Manager Saas: Como cadastrar, consultar e deletar certificados digitais
Observações específicas por município
| Cidade | Observação |
| Anápolis/GO |
|
| Aparecida de Goiânia/GO |
|
| Brasília/DF |
|
| Cuiabá/MT |
|
| Dracena/SP |
|
| Duque de Caxias/RJ |
|
| Goiânia/GO |
|
| Itatiaia/RJ |
|
| Macapá/AP |
|
| Ribeirão Preto/SP |
|
| Santa Maria/RS |
|
| Barbacena/PA |
|
| São Vicente/SP |
|
| Cruz Alta/RS |
|
Observações sobre a geração do XML
O código do serviço segue o que está descrito na LC-116, sem ponto.
Em municípios com regra específica de tomador, série ou cancelamento, o XML e o fluxo operacional devem respeitar essas variações locais.
Para Brasília/DF, quando houver estrangeiro no tomador, é possível informar apenas a razão social; porém, se qualquer campo do grupo de endereço for enviado, todos os campos desse grupo devem ser preenchidos para evitar rejeição por schema.
Caso o tomador e o prestador do serviço sejam de municípios diferentes, a IM do tomador não deverá ser informada.
Campos disponibilizados para adequação da Reforma Tributária
| CodigoNbs * | CodigoModoPrestacao | CodigoVinculoPrestacao | TipoMoedaEstrangeira |
| ValorServicosEstrangeiro | TipoFomentoTomador | TipoMovimentacaoBens | NumeroDeclaracaoImp |
| NumeroRegistroExp | TipoMDIC | TipoCST | ValorBCPisCofins |
| AliquotaPIS | AliquotaCOFINS | ValorPIS | ValorCofins |
| TipoRetPisCofins | ValorPercTotalTribFed | ValorPercTotalTribEst | ValorPercTotalTribMun |
| ValorPercAliqSN | FinalidadeNFSe | OperacaoPessoal | CodigoOperacao |
| TipoOperacao | ChaveNFSe | TipoEnteGovernamental | IndicadorDestinatario |
| SituacaoTributariaIbsCbs | ClassificacaoTributariaIbsCbs | MunicipioIncidenciaIbsCbs | ValorPercReducaoCompraGov |
| BaseCalculoIbsCbs | TipoChaveDF | DescricaoTipoChaveDFe | ChaveDFe |
| MunicipioDocumentoFiscal | NumeroDocumentoFiscal | DescricaoDocumentoFiscal | NumeroDocumentoNaoFiscal |
| DescricaoDocumentoNaoFiscal | CnpjFornecedor | CpfFornecedor | NifFornecedor |
| MotivoNaoNifFornecedor | RazaoSocialFornecedor | DataEmissaoDedutivel | DataCompetenciaDedutivel |
| TipoValorDedutivel | DescricaoValorDedutivel | ValorDedutivel | PaisTomador |
| ComplementoEndExteriorTomador | CodigoEndPostExteriorTomador | CidadeEstrangeiraTomador | RegiaoTomador |
Observação: Campos obrigatórios conforme o arquivo de esquema do Padrão estão destacados em negrito.
Ressaltamos que, para manter a funcionalidade em ambos os ambientes de emissão (produção e homologação), essas regras de validação ainda não foram aplicadas em nossas aplicações.
Para maiores informações sobre a forma de preenchimento destes campos novos, acesse nossa documentação do Padrão Unificado de TX2.
Erros comuns
O artigo atual do padrão traz uma relação objetiva de rejeições recorrentes e suas ações corretivas.
| Código | Mensagem (resumo) | Causa provável | Como resolver |
|---|---|---|---|
| E029 | O código de serviço prestado não permite retenção de ISSQN | ISS retido informado indevidamente | Preencher ISSRetido com 0
|
| E035 | Código de tributação inexistente |
CodigoTributacaoMunicipio inválido |
Preencher conforme a tabela do município |
| E043 | Inscrição Municipal do prestador não encontrada | IM incorreta ou cadastro/tributação divergente; em homologação pode haver inconsistência de ambiente | Revisar cadastro do emitente, IM e parâmetros tributários; validar ambiente |
| E090 | Número do RPS inválido | Numeração fora da sequência do prestador ou série incorreta | Validar numeração disponível no portal e série enviada |
| E138 | Usuário não autorizado a realizar o serviço | Certificado divergente do emitente ou falta de liberação para consumo do web service | Validar certificado e solicitar liberação em suporte@notacontrol.com.br
|
| E178 | Lote aguardando processamento | Instabilidade ou excesso de solicitações no web service | Aguardar o processamento e consultar novamente |
| [SEM CÓDIGO] | Unable to translate bytes [A0] at index 0 from specified code page to Unicode |
Arquivo de integração com caracteres em codificação incompatível | Revisar codificação do arquivo, por exemplo em editor compatível. Essa documentação pode auxiliar nesse processo. |
| E232 | Ocorreu um erro no processamento do arquivo | Instabilidade do web service da cidade | Confirmar no portal se não houve autorização e tentar reenviar até normalização |
Campos customizados para impressão
Impressão do RPS
- RazaoSocialPrestador=String[200]
- NomeFantasiaPrestador=String[200]
- EnderecoPrestador=String[200]
- NumeroEnderecoPrestador=String[200]
- ComplementoEnderecoPrestador=String[200]
- BairroPrestador=String[200]
- CepPrestador=String[50]
- TelefonePrestador=String[50]
- CodigoMunicipioPrestador=String[50]
- UfPrestador=String[10]
- FaxCelular=String[30]
- EmailPrestador=String[200]
- CnpjCpfIntermediario=String[50]
- InscricaoMunicipalIntermediario=String[50]
- RazaoSocialIntermediario=String[100]
- DescricaoCodigoTributacaoMunicipio=String[250]
- Aliquota=String[10]
- BaseCalculo=String[10]
- ValorIss=String[10]
- CodObra=String[50]
- Art=String[50]
- DescricaoCodigoTributacaoMunicípio=String[250]
Impressão da NFS-e
- FaxCelular=String[30]
- ResponsavelRetencao=String[100]
- CnpjCpfIntermediario=String[50]
- InscricaoMunicipalIntermediario=String[50]
- RazaoSocialIntermediario=String[100]
- CodObra=String[50]
- Art=String[50]
Comentários
0 comentário
Por favor, entre para comentar.