Pular para o conteúdo principal

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

Roney Campos
Atualizado

Manual de Integração com o WebService

 

Download do manual

 

Portais Disponíveis 

 

 

Novos campos Reforma Triburária(RTC)

 

CodigoNbs=123456789
IbsFederal=0.00
IbsEstadual=0.00
IbsMunicipal=0.00

 

Alteração 

 

Campo CodigoItemListaServiço era com 4 digitos, agora são 6 obrigatóriamente.

CodigoItemListaServico= 100201

 

 

Modelo de Tx2 com campos da Reforma Tributária 

 

formato=tx2
padrao=TecnoNFSe
NomeCidade=PIRAJUSP
ModoEnvio=
VersaoEsquema=RTC
INCLUIR
IdLote=
NumeroLote=1234
CpfCnpjRemetente=11222333000199
InscricaoMunicipalRemetente=009615
RazaoSocialRemetente=EMPRESA TESTE ADMINISTRACAO LTDA
QuantidadeRps=1
DataInicio=2026-01-15
DataFim=2026-01-15
ValorTotalServicos=1
ValorTotalDeducoes=0
ValorTotalBaseCalculo=1
SALVAR
INCLUIRRPS
IdRps=
SituacaoNota=1
TipoRps=1
SerieRps=1
NumeroRps=13106
TipoCodificacao=83
;idintegracao=
DataEmissao=2026-01-15T10:50:41
DataVencimento=2026-01-15T10:50:41
Competencia=2026-01-15
CpfCnpjPrestador=99888777000166
InscricaoMunicipalPrestador=009615
RazaoSocialPrestador=EMPRESA PRESTADORA DE SERVICOS SA
CodigoCidadePrestacao=3538808
DescricaoCidadePrestacao=Piraju
OptanteSimplesNacional=2
IncentivadorCultural=2
RegimeEspecialTributacao=6
NaturezaTributacao=2
IncentivoFiscal=2
InscricaoEstadualPrestador=
TipoLogradouroPrestador=Rua
EnderecoPrestador=Rua Exemplo de Teste
NumeroPrestador=999
ComplementoPrestador=
TipoBairroPrestador=Bairro
BairroPrestador=Centro
CodigoCidadePrestador=3538808
DescricaoCidadePrestador=Piraju
DDDPrestador=14
TelefonePrestador=30000000
;EmailPrestador=teste@empresa.com
CepPrestador=18800057
CpfCnpjTomador=11222333000199
RazaoSocialTomador=EMPRESA TOMADORA DE SERVICOS LTDA
TipoLogradouroTomador=Rua
EnderecoTomador=Rua de Testes
NumeroTomador=195
ComplementoTomador=
TipoBairroTomador=Bairro
BairroTomador=Conjunto Habitacional Doutor José Maria Arbex
CodigoCidadeTomador=3538808
DescricaoCidadeTomador=PIRAJU
UfTomador=SP
DocTomadorEstrangeiro=
CepTomador=18808362
CodigoPais=
PaisTomador=1058
DDDTomador=14
TelefoneTomador=999999999

; CAMPOS RTC
CodigoNbs=123456789
IbsFederal=0.00
IbsEstadual=0.00
IbsMunicipal=0.00   
 
CodigoItemListaServico=100201
CodigoTributacaoMunicipio=402
CodigoCnae=8640202
CodigoServicoNacional=
DiscriminacaoServico=Referente a Exames Laboratoriais|
TipoTributacao=4
ExigibilidadeISS=1
Operacao=A
MunicipioIncidencia=3538808
ValorPIS=0
ValorCOFINS=0
ValorINSS=0
ValorIR=0
ValorCSLL=0
OutrasRetencoes=
DescontoIncondicionado=0
DescontoCondicionado=0
ValorDeducoes=0
BaseCalculo=1
AliquotaSimplesNacional=
AliquotaISS=3
ValorIss=0.03
IssRetido=2
ResponsavelRetencao=
ValorISSRetido=0
ValorLiquidoNfse=1
ValorCargaTributaria=
ValorUnitarioServico=1
QuantidadeServicos=1
SALVARRPS

 

 

Exemplo XML Envio

 

<rps>
    <pass>senhaExemplo123</pass>
    <key>9</key>
    <serie>9</serie>
    <numero>9999</numero>
    <dataHoraEmissao>23/01/2026 10:00:00</dataHoraEmissao>
    <descServico>Referente a Servicos Prestados|</descServico>
    <retidoNaFonte>N</retidoNaFonte>
    <localExecucao>3500000</localExecucao>
    <codigoServicoPrestado>999999</codigoServicoPrestado>
    <cNBS>999999999</cNBS>
    <valorIss>0.05</valorIss>
    <valorBaseCalculo>1.00</valorBaseCalculo>
    <valorDeducoes>0.00</valorDeducoes>
    <valorNota>1.00</valorNota>
    <aliquota>5.00</aliquota>
    <aliquotaMunicipal>0.00</aliquotaMunicipal>
    <aliquotaEstadual>0.00</aliquotaEstadual>
    <aliquotaFederal>0.00</aliquotaFederal>
    <cpfCnpjPrestador>11111111000199</cpfCnpjPrestador>
    <imPrestador>99999999</imPrestador>
    <nomeRazaoPrestador>EMPRESA PRESTADORA DE SERVICOS LTDA</nomeRazaoPrestador>
    <enderecoPrestador>AVENIDA EXEMPLO, 1000</enderecoPrestador>
    <cepPrestador>00000000</cepPrestador>
    <cidadePrestador>CIDADE EXEMPLO</cidadePrestador>
    <estadoPrestador>SP</estadoPrestador>
    <cpfCnpjTomador>22222222000188</cpfCnpjTomador>
    <nomeRazaoTomador>CLIENTE DE TESTE</nomeRazaoTomador>
    <enderecoTomador>RUA EXEMPLO</enderecoTomador>
    <cidadeTomador>CIDADE EXEMPLO</cidadeTomador>
    <cepTomador>00000000</cepTomador>
    <estadoTomador>SP</estadoTomador>
    <porcentagemCOFINS>0.00</porcentagemCOFINS>
    <porcentagemCSLL>0.00</porcentagemCSLL>
    <porcentagemINSS>0.00</porcentagemINSS>
    <porcentagemIRRF>0.00</porcentagemIRRF>
    <porcentagemPIS>0.00</porcentagemPIS>
    <valorIRRF>0.00</valorIRRF>
</rps>

 

Métodos Disponíveis 

  • Envio.
    • Síncrono.
  • Consulta de NFSe Por RPS.
  • Cancelamento de NFSe.

 

Observações

  • Não possui envio em Lote, sendo o mesmo limitado a uma nota por vez.
  • Para realizar um Envio deverá ser informado no parâmetro extra a Chave de Acesso (Código Hash de Autenticidade, obtido no portal da prefeitura) como "Login" e a Senha.
    • O parâmetro extra deve ser informado da seguinte forma:
      • Login=GpqP7ysDnwo3y61sd+AJtw==;Senha=XXXXXXX
  • Para realizar uma Consulta de NFSe por RPS deverá ser informado no parâmetro extra a Chave de Acesso (Código Hash de Autenticidade, obtido no portal da prefeitura) como "Login" e o CPF ou CNPJ do Tomado.
    • O parâmetro extra deve ser informado da seguinte forma:
      • Login=GpqP7ysDnwo3y61sd+AJtw==;CpfCnpjTomador=11111111111111
  • Para realizar um Cancelamento de NFSe deverá ser informado no parâmetro extra o Motivo do cancelamento, a Chave de Acesso (Código Hash de Autenticidade, obtido no portal da prefeitura) como "Login" e a Senha + Key (Código da Chave de Acesso) separado por underline "_" .
    • O parâmetro extra deve ser informado da seguinte forma:
      • MotivoCancelamento=Nota emitida para testes;Login=GpqP7ysDnwo3y61sd+AJtw==;Senha=XXXXXX_X
  • A impressão de RPS não está disponível no momento da homologação.
  • A impressão desse padrão não possui quebra de linha na discriminação do serviço.
  • Caracteres especiais como: ( !@#$%*()'"-=+/.,:?][{}\/;.|:& < > " ' ) e acentos não devem ser informados, pois, o padrão ISSMAPAPI não consegue ler esses valores, o que ocasiona em erros internos do WebService.
  • ATENÇÃO: No Manager eDoc/SaaS e PlugNotas os dados de autenticação devem ser passados da seguinte forma:
  • Login: Deve ser informada a Chave de Acesso obtida no portal da prefeitura.
    Senha: Deverá ser informada da seguinte maneira: XXXXXX_YY, onde "XXXXXX" refere-se a senha do portal da prefeitura do contribuinte , e "YY" refere-se a Key (Código da Chave de Acesso) (geralmente 2 dígitos), obtido também o portal da prefeitura.
  • Atenção, Chave de Acesso é diferente do Código da Chave de Acesso. 

  • No TX2 deve-se passar o campo "TipoCodificacao=YY", onde "YY" refere-se ao Código da Chave de Acesso.

     

 

Existe um campo deste padrão que não se encaixa em nenhum campo do padrão unificado da Tecnospeed. Trata-se do campo "porcentagemOutros", que diz respeito de Outros Impostos com
retenção na fonte. Para informar este campo no tx2 deve-se colocar o caracter "@" antes do nome do campo. Desta forma:

@porcentagemOutros=0.10

Artigos relacionados

Comentários

0 comentário

Por favor, entre para comentar.