Manual de integração com o webservice
Portais Disponíveis
Métodos Disponíveis
- Envio:
- Síncrono.
- Consulta de NFSe por RPS;
- Cancelamento de NFSe.
Observações
- Este padrão possui ambiente de Homologação.
- Não possui envio em Lote, sendo o mesmo limitado a uma nota por vez.
Novos campos Reforma Tributária
CodigoItemListaServico=99.99.99
CodigoNbs=999999999
CodigoObra=OBR99Exemplo de Tx2 com campos da Reforma Tributária
formato=tx2
padrao=TecnoNFSe
NomeCidade=CIDADETESTE
ModoEnvio=
VersaoEsquema=RTC
INCLUIR
IdLote=
NumeroLote=0
CpfCnpjRemetente=11111111000199
InscricaoMunicipalRemetente=9999
RazaoSocialRemetente=EMPRESA DE TESTE LTDA
QuantidadeRps=1
CodigoCidadeRemetente=
Transacao=
DataInicio=2026-01-23
DataFim=2026-01-23
Versao=
MetodoEnvio=
ValorTotalServicos=1
ValorTotalDeducoes=0
ValorTotalBaseCalculo=1
SALVAR
INCLUIRRPS
IdRps=
SituacaoNota=1
TipoRps=1
SerieRps=9
NumeroRps=999
NumeroRPSSubstituido=
SerieRPSSubstituido=
TipoRPSSubstituido=
;idintegracao=
DataEmissao=2026-01-23T10:00:00
DataVencimento=2026-01-23T10:00:00
Competencia=2026-01-01
CpfCnpjPrestador=11111111000199
InscricaoMunicipalPrestador=9999
RazaoSocialPrestador=EMPRESA DE TESTE LTDA
CodigoCidadePrestacao=3500000
DescricaoCidadePrestacao=Cidade Exemplo
OptanteSimplesNacional=1
IncentivadorCultural=2
RegimeEspecialTributacao=6
NaturezaTributacao=
IncentivoFiscal=2
InscricaoEstadualPrestador=9999999999999
TipoLogradouroPrestador=Avenida
EnderecoPrestador=Endereco Exemplo
NumeroPrestador=100
ComplementoPrestador=
TipoBairroPrestador=Bairro
BairroPrestador=Bairro Exemplo
CodigoCidadePrestador=3500000
DescricaoCidadePrestador=Cidade Exemplo
DDDPrestador=11
TelefonePrestador=999999999
;EmailPrestador=prestador@exemplo.com
CepPrestador=00000000
CpfCnpjTomador=99999999999
RazaoSocialTomador=CLIENTE DE TESTE
InscricaoEstadualTomador=
InscricaoMunicipalTomador=
TipoLogradouroTomador=Rua
EnderecoTomador=Rua Exemplo
NumeroTomador=100
ComplementoTomador=SALA 1
TipoBairroTomador=Bairro
BairroTomador=Bairro Exemplo
CodigoCidadeTomador=3500000
DescricaoCidadeTomador=Cidade Exemplo
UfTomador=SP
DocTomadorEstrangeiro=
CepTomador=00000000
DescricaoDocumentoTomador=
TipoDocumentoTomador=
CidadeEstrangeiraTomador=
CodigoPais=
PaisTomador=1058
DDDTomador=
TelefoneTomador=
;EmailTomador=cliente@exemplo.com
CodigoItemListaServico=99.99.99
CodigoNbs=999999999
CodigoObra=OBR99
CodigoTributacaoMunicipio=99.99
CodigoCnae=9999999
CodigoServicoNacional=
DiscriminacaoServico=Servico de Teste para Homologacao||Valor aprox. dos tributos, federais R$100.00, estaduais R$0.00, municipais R$20.00
TipoTributacao=6
ExigibilidadeISS=1
Operacao=A
MunicipioIncidencia=3500000
ValorServicos=1
CepEvento=
CodigoCidadeEvento=
UFEvento=
BairroEvento=
LogradouroEvento=
NumeroEvento=
ComplementoEvento=
ExteriorEvento=
CidadeExteriorEvento=
EstadoEvento=
ValorPIS=0
ValorCOFINS=0
ValorINSS=0
ValorIR=0
ValorCSLL=0
OutrasRetencoes=
DescontoIncondicionado=0
DescontoCondicionado=0
ValorDeducoes=
BaseCalculo=1
AliquotaSimplesNacional=
AliquotaISS=2
ValorIss=0.02
IssRetido=2
ResponsavelRetencao=
ValorISSRetido=0
ValorLiquidoNfse=1
ValorCargaTributaria=
SALVARRPSExemplo de XML Envio com campos Reforma Tributária
<GerarNfseEnvio xmlns="http://www.abrasf.org.br/nfse.xsd">
<Rps>
<InfDeclaracaoPrestacaoServico Id="RPS_999">
<Rps>
<IdentificacaoRps>
<Numero>999</Numero>
<Serie>9</Serie>
<Tipo>1</Tipo>
</IdentificacaoRps>
<DataEmissao>2026-01-23</DataEmissao>
<Status>1</Status>
</Rps>
<Competencia>2026-01-01</Competencia>
<Servico>
<Valores>
<ValorServicos>1.00</ValorServicos>
<ValorDeducoes>0.00</ValorDeducoes>
<ValorPis>0.00</ValorPis>
<ValorCofins>0.00</ValorCofins>
<ValorInss>0.00</ValorInss>
<ValorIr>0.00</ValorIr>
<ValorCsll>0.00</ValorCsll>
<OutrasRetencoes>0.00</OutrasRetencoes>
<ValorIss>0.02</ValorIss>
<Aliquota>2</Aliquota>
<DescontoIncondicionado>0.00</DescontoIncondicionado>
<DescontoCondicionado>0.00</DescontoCondicionado>
</Valores>
<IssRetido>2</IssRetido>
<CodigoCnae>9999999</CodigoCnae>
<CodigoTributacaoMunicipio>99.99</CodigoTributacaoMunicipio>
<Discriminacao>Servico de Teste para Homologacao Valor aprox. dos tributos, federais R$100.00, estaduais R$0.00, municipais R$20.00</Discriminacao>
<CodigoMunicipio>3500000</CodigoMunicipio>
<ExigibilidadeISS>1</ExigibilidadeISS>
<MunicipioIncidencia>3500000</MunicipioIncidencia>
<cTribNac>99.99.99</cTribNac>
<CodigoNbs>9.9999.99.99</CodigoNbs>
<cObra>OBR99</cObra>
</Servico>
<Prestador>
<CpfCnpj>
<Cnpj>11111111000199</Cnpj>
</CpfCnpj>
<InscricaoMunicipal>999999</InscricaoMunicipal>
</Prestador>
<Tomador>
<IdentificacaoTomador>
<CpfCnpj>
<Cpf>99999999999</Cpf>
</CpfCnpj>
</IdentificacaoTomador>
<RazaoSocial>CLIENTE DE TESTE</RazaoSocial>
<Endereco>
<Endereco>RUA EXEMPLO</Endereco>
<Numero>100</Numero>
<Complemento>SALA 1</Complemento>
<Bairro>BAIRRO TESTE</Bairro>
<CodigoMunicipio>3500000</CodigoMunicipio>
<Uf>SP</Uf>
<CodigoPais>1058</CodigoPais>
<Cep>00000000</Cep>
</Endereco>
</Tomador>
<ConstrucaoCivil>
<CodigoObra>OBR99</CodigoObra>
</ConstrucaoCivil>
<RegimeEspecialTributacao>6</RegimeEspecialTributacao>
<OptanteSimplesNacional>1</OptanteSimplesNacional>
<IncentivoFiscal>2</IncentivoFiscal>
</InfDeclaracaoPrestacaoServico>
</Rps>
</GerarNfseEnvio>
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, entretanto, caso informado será gerado no XML.
- Código CNAE segue a tabela nacional com 7 digítos.
- No momento da homologação deste padrão não havia nenhuma consulta disponível no WebService.
- O cancelamento é feito via portal no momento da homologação deste padrão.
- Padrão aceita acentos e caracteres especiais, o tx2 deve ser codificado em ANSI.
Campos customizados para a impressão
Impressão do RPS
- RazaoSocialPrestador=String[150]
- NomeFantasiaPrestador=String[60]
- InscricaoEstadualPrestador=String[15]
- EnderecoPrestador=String[125]
- NumeroPrestador=String[10]
- ComplementoPrestador=String[60]
- BairroPrestador=String[60]
- CodigoCidadePrestador=String[7]
- CepPrestador=String[8]
- TelefonePrestador=String[11]
- InscricaoEstadualTomador=String[15]
- BaseCalculo=String[20]
- ValorIssRetido=String[15]
- ValorSestSenat=String[15]
- ValorIssDevido=String[15]
- ValorLiquidoNfse=String[20]
Impressão da NFSe
- InscricaoEstadualTomador=String[15]
- InscricaoEstadualPrestador=String[15]
- ValorSestSenat=String[15]
- ValorIssdevido=String[15]
Soluções Tecnospeed
- Componente NFSe: Release 10.1.68.X
- Manager eDoc: Release 5.1.X.X
Comentários
0 comentário
Por favor, entre para comentar.