Documentação Técnica - Padrão SATURNO20

Manual de integração com o webservice

Download do manual

Portais Disponíveis 

• Produção

Métodos Disponíveis 

• Envio.
  • Síncrono.
• Consulta de NFSe por RPS.

Observações

• Possui envio em lote.
• Não possui Múltiplos Serviços.
• No momento da homologação o método de cancelamento ainda não estava funcionando, portanto o cancelamento é apenas via portal da prefeitura.

Geração do XML - Campos Importantes 

• O código do serviço segue o que está descrito na LC-116.
• O código CNAE pode possuir até 7 dígitos, consultar o portal de produção da prefeitura para saber quais códigos estão habilitados.
• O campo CodigoTributacaoMunicipio não é obrigatório.

Campos RTC

Foi disponibilizado dois novos camops para atender  padronização da Reforma Tributária: 

• CodigoNbs 
• NifTomador 

Campos Customaziados Impressão

Impressão do RPS

• NomeFantasiaPrestador=String[80]
• RazaoSocialPrestador=String[80]
• InscricaoEstadualTomador=String[80]
• InscricaoEstadualPrestador=String[80]
• EnderecoPrestador=String[80]
• CodigoCidadePrestador=String[10]
• UfPrestador=String[2]
• NumeroPrestador=String[7]
• ComplementoPrestador=String[20]
• BairroPrestador=String[40]
• CepPrestador=String[8]
• TelefonePrestador=String[20]
• EmailPrestador=String[80]
• BaseCalculo=String[80]
• ValorIss=String[80]
• ValorIssRetido=String[80]
• PrevidenciaSocial=String[20]
• Orcamento=String[20]
• Fatura=String[20]
• Vencimento=String[20]
• Aidf=String[20]

Impressão da NFSe

• InscricaoEstadualTomador=String[80]
• InscricaoEstadualPrestador=String[80]
• PrevidenciaSocial=String[80]
• ValorIssRetido=String[20]
• Orcamento=String[20]
• Fatura=String[20]
• Vencimento=String[20]

• Aidf=String[20]

   

Exemplo Tx2 com campos RTC

formato=tx2
padrao=TecnoNFSe
NomeCidade=CATANDUVA
ModoEnvio=
VersaoEsquema=RTC
INCLUIR
IdLote=
NumeroLote=999999
CpfCnpjRemetente=11111111000199
InscricaoMunicipalRemetente=99999
RazaoSocialRemetente=EMPRESA EXEMPLO SERVICOS LTDA
QuantidadeRps=1
CodigoCidadeRemetente=
Transacao=
DataInicio=2026-01-12
DataFim=2026-01-12
Versao=
MetodoEnvio=
ValorTotalServicos=1
ValorTotalDeducoes=0
ValorTotalBaseCalculo=1
SALVAR
INCLUIRRPS
IdRps=
SituacaoNota=1
TipoRps=1
SerieRps=0
NumeroRps=12345
NumeroRPSSubstituido=
SerieRPSSubstituido=
TipoRPSSubstituido=
;idintegracao=
DataEmissao=2026-01-12T09:26:07
DataVencimento=2026-01-12T16:26:07
Competencia=2026-01-12
CpfCnpjPrestador=11111111000199
InscricaoMunicipalPrestador=99999
RazaoSocialPrestador=EMPRESA EXEMPLO SERVICOS LTDA
CodigoCidadePrestacao=3511102
DescricaoCidadePrestacao=CATANDUVA
OptanteSimplesNacional=2
IncentivadorCultural=2
RegimeEspecialTributacao=
NaturezaTributacao=
IncentivoFiscal=2
InscricaoEstadualPrestador=999999999999
TipoLogradouroPrestador=RUA
EnderecoPrestador=EXEMPLO
NumeroPrestador=100
ComplementoPrestador=
TipoBairroPrestador=
BairroPrestador=BAIRRO TESTE
CodigoCidadePrestador=3511102
DescricaoCidadePrestador=CATANDUVA
DDDPrestador=17
TelefonePrestador=30000000
;EmailPrestador=contato@empresaexemplo.com.br
CepPrestador=15800000
CpfCnpjTomador=22222222000188
RazaoSocialTomador=CLIENTE EXEMPLO SA
InscricaoEstadualTomador=888888888888
InscricaoMunicipalTomador=
TipoLogradouroTomador=RUA
EnderecoTomador=RODOVIA EXEMPLO KM 10
NumeroTomador=SN
ComplementoTomador=AREA RURAL
TipoBairroTomador=
BairroTomador=ZONA RURAL
CodigoCidadeTomador=3524303
DescricaoCidadeTomador=
UfTomador=SP
DocTomadorEstrangeiro=
CepTomador=14870000
DescricaoDocumentoTomador=
TipoDocumentoTomador=
NifTomador=123456781234567
CidadeEstrangeiraTomador=
CodigoPais=
PaisTomador=1058
DDDTomador=
TelefoneTomador=
;EmailTomador=cliente@exemplo.com
CpfCnpjIntermediario=
RazaoSocialIntermediario=
InscricaoMunicipalIntermediario=
CodigoCidadeIntermediario=
InscricaoEstadualIntermediario=
EnderecoIntermediario=
NumeroIntermediario=
ComplementoIntermediario=
BairroIntermediario=
CepIntermediario=
UFIntermediario=
PaisIntermediario=
EmailIntermediario=
TelefoneIntermediario=
CodigoItemListaServico=14.01
CodigoTributacaoMunicipio=21401
CodigoCnae=3314712
CodigoNbs=113022100
CodigoServicoNacional=
DiscriminacaoServico=SERVICO DE MANUTENCAO CONFORME ORDEM DE SERVICO EXEMPLO NR.123456 REFERENTE A EQUIPAMENTO MODELO TESTE
TipoTributacao=6
ExigibilidadeISS=1
Operacao=A
MunicipioIncidencia=3511102
ValorServicos=1
AliquotaPIS=
AliquotaCOFINS=
AliquotaINSS=
AliquotaIR=
AliquotaCSLL=
Art=
CodigoCEI=
CodigoObra=
EnderecoObra=
NumeroObra=
BairroObra=
ComplementoObra=
CodigoCidadeObra=
DescricaoCidadeObra=
UfObra=
CepObra=
PaisObra=
InscricaoImobiliariaObra=
NomeObra=
InfObra=
OpcaoObra=
IdentificacaoEvento=
DataInicioEvento=
DataFinalEvento=
DescricaoEvento=
AtividadeEvento=
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=3
ValorIss=0.03
IssRetido=2
ResponsavelRetencao=
ValorISSRetido=0
ValorLiquidoNfse=1
ValorCargaTributaria=
PercentualCargaTributaria=
FonteCargaTributaria=
OutrasInformacoes=
DescricaoRPS=
ValorRepasse=
ValorUnitarioServico=1
NCM=
FinalidadeNFSe=
OperacaoPessoal=
CodigoOperacao=
TipoOperacao=
TipoEnteGovernamental=
DescTipoEnteGovernamental=
IndicadorDestinatario=
CpfCnpjDestinatario=
NifDestinatario=
MotivoNaoNifDestinatario=
RazaoSocialDestinatario=
CodigoEstrangeiroDestinatario=
EnderecoDestinatario=
NumeroDestinatario=
ComplementoDestinatario=
BairroDestinatario=
CodigoCidadeDestinatario=
DescricaoCidadeDestinatario=
CepDestinatario=
PaisDestinatario=
CodigoPostalDestinatario=
EstadoProvinciaDestinatario=
EmailDestinatario=
TelefoneDestinatario=
InscricaoFiscalImovel=
CodigoCIB=
CodigoObraImovel=
LogradouroImovel=
NumeroImovel=
ComplementoImovel=
BairroImovel=
CepImovel=
DescricaoCidadeImovel=
UfImovel=
CodigoPaisImovel=
EstadoProvinciaImovel=
CodigoPostalImovel=
SituacaoTributariaIbsCbs=
ClassificacaoTributariaIbsCbs=
CodigoCreditoPresumidoIbsCbs=
SituacaoTributariaRegularIbsCbs=
MunicipioIncidenciaIbsCbs=
ClassifTributariaRegularIbsCbs=
ValorPercDiferimentoEstadual=
ValorPercDiferimentoMunicipal=
ValorPercDiferimentoCbs=
MotivoNaoNifTomador=
NifIntermediario=
MotivoNaoNifIntermediario=
DataPagamento=
CodigoModoPrestacao=
CodigoVinculoPrestacao=
TipoMoedaEstrangeira=
ValorServicosEstrangeiro=
TipoFomentoPrestador=
TipoFomentoTomador=
TipoMovimentacaoBens=
NumeroDeclaracaoImp=
NumeroRegistroExp=
TipoMDIC=
CategoriaServico=
TipoObjeto=
ExtensaoObjeto=
NumeroPostes=
SALVARRPS