Este artigo reúne as especificações do padrão NFS-e INTERSOL20 para integração via web service, incluindo portais (Produção/Homologação), métodos disponíveis (emissão, consulta, cancelamento), tipo de impressão do documento, regras e observações do padrão, além de orientações específicas para emissão via PlugNotas, Manager eDoc/Manager SaaS e Componente NFSe. Também detalha parâmetros de autenticação, erros comuns e campos customizados de impressão.
Tópicos deste artigo (Sumário)
- Manual do web service
- Portais disponíveis
- Métodos disponíveis
- Tipo de impressão
- Observações gerais do padrão
- Campos customizados para impressão do RPS
- Campos customizados para impressão da NFS-e
- Compatibilidade / versões mínimas
Manual de integração com o web service
Portais disponíveis
| Ambiente | URL/Portal | Observações |
| Produção |
Cada cidade possui seu proprio identificador que deve substituir o placeholder {{CIDADE}} Exige certificado digital |
|
| Homologação |
URL única para homologação Exige certificado digital |
Métodos disponíveis
Envio
-
Envio sequencial: (x) Necessita envio sequencial / ( ) Não necessita envio sequencial
- Nota: “envio sequencial” = numeração do RPS precisa estar na sequência esperada.
- Modo: ( ) Síncrono / (x) Assíncrono / ( ) Ambos
- Lote de RPS: (x) Aceita lote / ( ) Não aceita lote
Consulta
- (x) Consulta de lote
- ( ) Consulta por RPS
- (x) Consulta por NFS-e
- ( ) Consulta por protocolo
Cancelamento
- (x) Cancelamento de NFS-e via web service
- ( ) Cancelamento apenas administrativo (fora do web service)
Tipo de impressão
Selecione uma opção e explique os impactos nos produtos.
- ( ) Impressão via link da prefeitura
- Nossos produtos fazem download do PDF gerado pela prefeitura.
-
(x) Impressão via layout Tecnospeed
- Nossos produtos geram o PDF, aproximando ao máximo o layout da prefeitura.
Observações gerais do padrão
- As prefeituras estão em processo de aderência ao novo layout, portanto é necessário conferir se a cidade utilizada já foi migrada.
Observações sobre a geração do XML
O código do serviço segue o padrão nacional descrito na LC-116.
O layout do XML segue o modelo Nacional.
Novos campos disponibilizados para adequação da Reforma Tributária
| CodigoNbs | CodigoModoPrestacao | CodigoVinculoPrestacao | TipoMoedaEstrangeira |
| ValorServicosEstrangeiro | TipoFomentoTomador | TipoMovimentacaoBens | NumeroDeclaracaoImp |
| NumeroRegistroExp | TipoMDIC | TipoCST | ValorBCPisCofins |
| TipoRetPisCofins | ValorPercTotalTribFed | ValorPercTotalTribEst | ValorPercTotalTribMun |
| ValorPercAliqSN | FinalidadeNFSe | OperacaoPessoal | CodigoOperacao |
| TipoOperacao | TipoEnteGovernamental | SituacaoTributariaIbsCbs | ClassificacaoTributariaIbsCbs |
| ChaveNFSe | TipoChaveDF | ChaveDFe | DescricaoTipoChaveDFe |
| MunicipioDocumentoFiscal | NumeroDocumentoFiscal | DescricaoDocumentoFiscal | NumeroDocumentoNaoFiscal |
| DescricaoDocumentoNaoFiscal | CpfCnpjFornecedor | NifFornecedor | MotivoNaoNifFornecedor |
| RazaoSocialFornecedor | TipoValorDedutivel | ValorDedutivel | DescricaoValorDedutivel |
| IndicadorDestinatario | CpfCnpjDestinatario | NifDestinatario | RazaoSocialDestinatario |
| PaisDestinatario | EnderecoDestinatario | NumeroDestinatario | ComplementoDestinatario |
| BairroDestinatario | DescricaoCidadeDestinatario | RegiaoDestinatario | TelefoneDestinatario |
| EmailDestinatario | InscricaoFiscalImovel | CodigoCIB | CodigoCidadeImovel |
| CepImovel | DescricaoCidadeImovel | RegiaoImovel | EnderecoImovel |
| NumeroImovel | ComplementoImovel | BairroImovel | PaisImovel |
| ValorPercDiferimentoEstadual | ValorPercDiferimentoMunicipal | ValorPercDiferimentoCbs | ValorPercReducaoCompraGov |
| RegimeApuracaoTributaria | MunicipioIncidenciaIbsCbs |
PercReducaoIbsCbs |
ValorDeducoesIbsCbs |
BaseCalculoIbsCbs |
AliquotaIbsEstadual |
PercReducaoIbsEstadual |
AliquotaEfetivaIbsEstadual |
AliquotaIbsMunicipal |
PercReducaoIbsMunicipal |
AliquotaEfetivaIbsMunicipal |
ValorIbsTotal |
AliquotaCbs |
PercReducaoCbs |
AliquotaEfetivaCbs |
ValorTotalNfIbsCbs |
PercCredPresumidoIbs |
ValorCredPresumidoIbs |
ValorDifIbsEstadual |
ValorIbsEstadual |
ValorDifIbsMunicipal |
ValorIbsMunicipal |
PercCredPresumidoCbs |
ValorCredPresumidoCbs |
ValorDifCbs |
ValorCbs |
AliquotaEfetivaRegIbsEstadual |
ValorTribRegIbsEstadual |
AliquotaEfetivaRegIbsMunicipal |
ValorTribRegIbsMunicipal |
AliquotaEfetivaRegCbs |
ValorTribRegCbs |
IbsEstadualCompraGov |
ValorIbsEstadualCompraGov |
IbsMunicipalCompraGov |
ValorIbsMunicipalCompraGov |
CbsCompraGov |
ValorCbsCompraGov |
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 empresas optantes do Simples Nacional, o preenchimento do campo RegimeApuracaoTributaria (regApTribSN) é obrigatório:
| RegimeApuracaoTributaria=1 | Regime de apuração dos tributos federais e municipal pelo SN (Recolhimento via DAS) |
| RegimeApuracaoTributaria=2 | Regime de apuração dos tributos federais pelo SN e o ISSQN por fora do SN (Recolhimento via DAM Municipal - Ex: Excesso de sublimite) |
| RegimeApuracaoTributaria=3 | Regime de apuração dos tributos federais e municipal por fora do SN (Regime Normal) |
Para maiores informações sobre a forma de preenchimento destes campos novos, acesse nossa documentação do Padrão Unificado de TX2.
Exemplos de TX2 e XML:
- XML Envio
- XML Autorizado
- TX2
Campos customizados para impressão
Impressão da NFS-E
BaseCalculo=String[15]
EnderecoPrestador=String[-]
EnderecoTomador=String[-]
OutrasInformacoes=String[255]
NfseSubstituida=String[10]
DataCancelamento=String[10]
RazaoSocialIntermediario=String[80]
Impressão do RPS
ValorIss=String[10]
OutrasRetencoes=String[10]
BaseCalculo=/RPS/ValorServicos
CnpjPrestador=String[14]
NomeFantasiaPrestador=String[80]
RazaoSocialPrestador=String[80]
EnderecoPrestador=String[80]
UfPrestador=String[2]
NumeroEnderecoPrestador=String[10]
ComplementoEnderecoPrestador=String[40]
BairroPrestador=String[40]
CepPrestador=String[8]
EnderecoTomador=/RPS/EnderecoTomador/Logradouro
OutrasInformacoes=String[255]
RazaoSocialIntermediario=String[80]
CodigoMunicipioPrestador=String[10]
DiscriminacaoServico=String[2000]
Compatibilidade / versões mínimas
Manter como bloco curto e direto.
- Componente NFSe: Release [INSERIR] (ex.: 8.7.52.X)
- Manager eDoc: Release [INSERIR] (ex.: 3.0.86.X)
Comentários
0 comentário
Por favor, entre para comentar.