Manual de integração com o webservice
Portais Disponíveis
Métodos Disponíveis
- Envio.
- Síncrono.
- Consulta de NFSe Por Rps
- Cancelar NFSe
Observações
- O envio síncrono possui envio em lote.
- Padrão não suporta múltiplos serviços.
- No componente NFSe V2, o erro Exception: Ocorreu um erro durante a comunicação com o servidor: Não foi possível carregar o XML pode ocorrer por conta da máquina não estar conseguindo se comunicar com o link do WebService. Para corrigir, seguir a 2.ª alternativa da seguinte documentação
Geração do XML - Campos Importantes
- O código do serviço segue o que está descrito na LC-116.
- Não é obrigatório informar o Código CNAE.
- O Código de tributação do município é o mesmo utilizado para o Item da lista de serviço.
- O erro <Codigo>EL46</Codigo><Mensagem>Campo NumeroLote informado incorretamente - O campo NumeroLote ja consta no sistema como enviado.</Mensagem> pode ocorrer quando o número do lote enviado não é exatamente sequencial ao último registrado no portal, o envio tem que ser exatamente o número seguinte ao já autorizado.
- O erro EL17-CNPJ não encontrado na base de dados - Confira o número do CNPJ informado. Caso esteja correto o prestador não esta inscrito no município. () pode ser retornado quando a inscrição municipal for informada incorretamente, ou sem os zeros a esquerda, conforme consta no cadastro do prestador na prefeitura.
Campos customizados para a impressão
Impressão do RPS
- RazaoSocialPrestador=String[80]
- NomeFantasiaPrestador=String[80]
- EnderecoPrestador=String[80]
- NumeroPrestador=String[10]
- BairroPrestador=String[80]
- ComplementoPrestador=String[80]
- CepPrestador=String[9]
- CodigoCidadePrestador=String[80]
- UfPrestador=String[80]
- InscricaoEstadualPrestador=String[80]
- InscricaoEstadualTomador=String[80]
- EmailPrestador=String[80]
- TelefonePrestador=String[20]
- SitePrestador=String[80]
- NaturezaOperacao=String[10]
- QuantidadeServico=String[10]
- TotalDemonstrativo=String[10]
- DescontosDiversos=String[10]
- ValorLiquido=String[10]
- MotivoCancelamento=String[80]
- Observacao=String[80]
- InformacoesComplementares=String[256]
Impressão da NFSe
- InscricaoEstadualPrestador=String[80]
- InscricaoEstadualTomador=String[80]
- SitePrestador=String[80]
- NaturezaOperacao=String[10]
- QuantidadeServico=String[10]
- TotalDemonstrativo=String[10]
- DescontosDiversos=String[10]
- ValorLiquido=String[10]
- MotivoCancelamento=String[80]
- Observacao=String[80]
- InformacoesComplementares=String[256]
Novos campos disponibilizados para adequação da Reforma Tributária
| CodigoNbs * |
| CodigoServicoNacional * |
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.
OBSERVAÇÃO SOBRE O CANCELAMENTO
Durante os testes de adequação dos campos CodigoNbs e CodigoServicoNacional, foi identificada instabilidade no comportamento do WebService.
O cancelamento da NFS-e é processado com sucesso; entretanto, não é possível obter o retorno do XML da NFS-e contendo as informações do cancelamento realizado.
Exemplo TX2 de envio:
formato=tx2 padrao=TecnoNFSe NomeCidade=CIDADE_EXEMPLO VersaoEsquema=RTC INCLUIR IdLote= NumeroLote=401 CPFCNPJRemetente=00000000000000 InscricaoMunicipalRemetente=0000000000 ValorTotalServicos=0.10 ValorTotalDeducoes=0.00 ValorTotalBaseCalculo=0.10 CodigoCidadeRemetente=0000000 QuantidadeRps=1 SALVAR INCLUIRRPS IdRps= SituacaoNota=1 TipoRps=1 SerieRps=SR NumeroRps=999 NumeroRPSSubstituido= SerieRPSSubstituido= TipoRPSSubstituido= DataEmissao=2026-01-16T12:00:00 DataVencimento=2026-01-16T12:30:00 Competencia=2026-01-01 cpfcnpjprestador=00000000000000 InscricaoMunicipalPrestador=0000000000 RazaoSocialPrestador=EMPRESA PRESTADORA EXEMPLO LTDA CodigoCidadePrestacao=0000000 DescricaoCidadePrestacao=CIDADE EXEMPLO OptanteSimplesNacional=1 IncentivadorCultural=2 RegimeEspecialTributacao=1 NaturezaTributacao=1 IncentivoFiscal=2 InscricaoEstadualPrestador=000000000 TipoLogradouroPrestador=Rua EnderecoPrestador=Rua Exemplo NumeroPrestador=100 ComplementoPrestador= TipoBairroPrestador= BairroPrestador=Bairro Exemplo CodigoCidadePrestador=0000000 DescricaoCidadePrestador=CIDADE EXEMPLO DDDPrestador= TelefonePrestador= EmailPrestador=contato@exemplo.com CepPrestador=00000000 CpfCnpjTomador=11111111000111 RazaoSocialTomador=EMPRESA TOMADORA EXEMPLO LTDA InscricaoEstadualTomador= InscricaoMunicipalTomador=000000 TipoLogradouroTomador=Rua EnderecoTomador=Rua do Tomador NumeroTomador=500 ComplementoTomador= TipoBairroTomador= BairroTomador=Bairro Tomador CodigoCidadeTomador=0000000 DescricaoCidadeTomador=CIDADE TOMADOR UfTomador=UF DocTomadorEstrangeiro= CepTomador=00000000 DescricaoDocumentoTomador= TipoDocumentoTomador= CidadeEstrangeiraTomador= PaisTomador= DDDTomador= TelefoneTomador= EmailTomador=tomador@exemplo.com CpfCnpjIntermediario= RazaoSocialIntermediario= InscricaoMunicipalIntermediario= CodigoCidadeIntermediario= InscricaoEstadualIntermediario= EnderecoIntermediario= NumeroIntermediario= ComplementoIntermediario= BairroIntermediario= CepIntermediario= UFIntermediario= PaisIntermediario= EmailIntermediario= TelefoneIntermediario= CodigoItemListaServico=140201 CodigoTributacaoMunicipio=1402 CodigoCnae=0000000 CodigoNbs=000000000 DiscriminacaoServico=SERVICO DE TESTE TipoTributacao=6 ExigibilidadeISS=1 Operacao=A MunicipioIncidencia=0000000 ValorServicos=0.10 AliquotaPIS= AliquotaCOFINS= AliquotaINSS=0 AliquotaIR=0 AliquotaCSLL=0 ValorPIS=0 ValorCOFINS=0 ValorINSS=0 ValorIR=0 ValorCSLL=0 OutrasRetencoes= DescontoIncondicionado=0 DescontoCondicionado=0 ValorDeducoes= BaseCalculo=0.10 AliquotaISS=2 ValorIss=0.00 IssRetido=2 ResponsavelRetencao= ValorISSRetido=0 ValorLiquidoNfse=0.10 OutrasInformacoes=INFORMACAO GENERICA PARA TESTE ValorUnitarioServico=0.10 QuantidadeServicos=1 IndicadorDestinatario= CpfCnpjDestinatario= RazaoSocialDestinatario= EnderecoDestinatario= NumeroDestinatario= BairroDestinatario= CodigoCidadeDestinatario= DescricaoCidadeDestinatario= CepDestinatario= UfDestinatario= PaisDestinatario= SituacaoTributariaIbsCbs= ClassificacaoTributariaIbsCbs= MunicipioIncidenciaIbsCbs= DataPagamento= CodigoModoPrestacao= CodigoVinculoPrestacao= SALVARRPS
Soluções Tecnospeed
- Componente NFSe: Release 9.1.60.XXXX
- Manager eDoc: Release 4.1.97.XXXX
Comentários
0 comentário
Por favor, entre para comentar.