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

Manual de integração com o webservice

Download do manual

Portais Disponíveis

• Produção
• Homologação (Indisponível no momento)

Métodos Disponíveis

• Envio
  -  Síncrono.

• Consulta de Lote.
  Observação: Especificamente para o padrão SIM, a consulta de lote deve ser utilizado no parâmetro o valor do Id DPS "431000922906260900017700123000000000111331". O padrão SIM não retorna esse valor, é necessário monta-lo, seguindo as regras do ADN com os dados do xml de envio.
  O Retorno da consulta de lote será a Chave da NFSe, que deve ser utilizada para consultar a NFSe posteriormente, e assim obter o resultado final da nota.

  Como montar ID DPS, utilizar os campos da sessão "infDPS" do XML de envio:

  cLocEmi + TipoInscricao + CNPJ + Serie + Numero
  4310009 2 29062609000177 00123 000000000111331

   

• Consulta da NFSe.
• Cancelamento.

Observações

• Novo formato de XML agora é NFSe+DPS.
• Só imprime no formato de impressão NFSe (printNFSe).
• Não possui assinatura, porém é necessário certificado para comunicação com o Web Service.
• Os campos Id NFSe e Id DPS, são enviados como vazio e em caso da nota autorizada, retorna os id's correspondentes.
• Componente: É necessário adicionar o campo customizado DataHoraCancelamento, para que seja impresso com a tarja de cancelamento.
• Manager/Plugnotas:  Para atualizar a situação de uma nota cancelada no portal da prefeitura no manager ou PlugNotas é necessário enviar o cancelamento novamente, para obter os logs com a informação. 

Geração do XML - Campos Importantes

• O código do serviço segue o que está descrito na LCP-116.

• O campo código CNAE segue o que foi definido na tabela nacional. A lista de CNAEs pode ser consultada neste link:https://cnae.ibge.gov.br

   

Exemplo campos componente

formato=tx2
padrao=TecnoNFSe
VersaoEsquema=RTC
NomeCidade=IBIRUBARS

Ambiente=1

INCLUIR
IdLote=1
NumeroLote=1
CPFCNPJRemetente=12345678000199
InscricaoMunicipalRemetente=7145
ValorTotalServicos=0.10
ValorTotalDeducoes=0.00
ValorTotalBaseCalculo=0.10
SALVAR
INCLUIRRPS
NumeroRps=111332
NumeroNfse=1270
SerieRps=123
TipoRps=1
DataEmissao=2026-03-04T10:55:33
Competencia=2026-03-04
OptanteSimplesNacional=2
IncentivadorCultural=2
SituacaoNota=1
MunicipioIncidencia=4310009
TipoTributacao=6
ValorServicos=0.10
ValorUnitarioServico=0.10
ValorDeducoes=0.00
ValorCsll=0.00
ValorIss=0.00
ValorInss=0.00
ValorIr=0.00
IssRetido=2
ValorIssRetido=0.00
BaseCalculo=0.10
ValorCofins=0.00
ValorPis=0.00
TipoCST=1
TipoRetPisCofins=2
ValorBCPisCofins=0.10
DescontoIncondicionado=0.00
DescontoCondicionado=0.00
AliquotaISS=0.00
AliquotaINSS=0.00000
AliquotaIR=0.00000
AliquotaCSLL=0.00000
CodigoItemListaServico=08.01.01
CodigoNbs=122012000
CodigoCnae=9602502
CodigoTributacaoMunicipio=
DiscriminacaoServico=Discriminacao teste RTC SIM
CodigoCidadePrestacao=4314902
DescricaoCidadePrestacao=Ibiruba
quantidadeservicos=1
CpfCnpjPrestador=12345678000199
InscricaoMunicipalPrestador=
InscricaoEstadualPrestador=9035648
EnderecoPrestador=RUA EXEMPLO
NumeroPrestador=100
ExigibilidadeISS=1
ComplementoPrestador=
BairroPrestador=CENTRO
EmailPrestador=contato@empresaexemplo.com.br
CodigoCidadePrestador=4310009
CepPrestador=98200000
RazaoSocialPrestador=EMPRESA EXEMPLO LTDA
DDDPrestador=11
TelefonePrestador=33334444
TipoDocumentoTomador=1
CpfCnpjTomador=98765432000155
InscricaoMunicipalTomador=
RazaoSocialTomador=CLIENTE EXEMPLO LTDA
TipoLogradouroTomador=AV
EnderecoTomador=AV CENTRAL
NumeroTomador=500
ComplementoTomador=
TipoBairroTomador=BAIRRO
BairroTomador=CENTRO
CodigoCidadeTomador=4212908
DescricaoCidadeTomador=Ibiruba
UfTomador=RS
PaisTomador=Brasil
CepTomador=89870000
DDDTomador=21
TipoTelefoneTomador=1
TelefoneTomador=988887777
EmailTomador=financeiro@clienteexemplo.com.br
SituacaoTomador=0
IncentivoFiscal=2
Operacao=A
ValorLiquidoNfse=0.10
outrasinformacoes=
Tributavel=1
OutrasRetencoes=0.00
ValorPercTotalTribFed=0.00
ValorPercTotalTribEst=0.00
ValorPercTotalTribMun=0.00
SALVARRPS

Exemplo PlugNotas

[
 {
   "versaoEsquema": "RTC",
   "rps": {
     "serie": "123",
     "numero": 83
   },
   "prestador": {
     "cpfCnpj": "12345678000199",
     "regimeTributarioEspecial": 0,
     "simplesNacional": false
   },
   "tomador": {
     "cpfCnpj": "98765432000155",
     "razaoSocial": "EMPRESA CLIENTE EXEMPLO LTDA",
     "email": "financeiro@clienteexemplo.com.br",
     "endereco": {
       "tipoLogradouro": "AVENIDA",
       "logradouro": "AV CENTRAL",
       "tipoBairro": "Bairro",
       "bairro": "CENTRO",
       "codigoCidade": "4115200",
       "descricaoCidade": "CidadeExemploPR",
       "codigoPais": "1058",
       "descricaoPais": "Brasil",
       "estado": "PR",
       "cep": "87020025",
       "numero": "100"
     }
   },
   "servico": [
     {
       "codigo": "080101",
       "discriminacao": "TESTE EMISSAO",
       "codigoNbs": "122012000",
       "cnae": "9602502",
       "codigoCidadeIncidencia": "4310009",
       "descricaoCidadeIncidencia": "4310009",
       "iss": {
         "tipoTributacao": 6,
         "exigibilidade": 1,
         "retido": false,
         "aliquota": 0,
         "valor": 0,
         "valorRetido": 0,
         "tipoRetencao": 1
       },
       "valor": {
         "servico": 0.1,
         "baseCalculo": 0.1,
         "deducoes": 0,
         "descontoCondicionado": 0,
         "descontoIncondicionado": 0,
         "liquido": 0.1,
         "unitario": 0.1
       },
       "retencao": {
         "pis": {
           "cst": "00",
           "aliquota": 0,
           "valor": 0,
           "retido": false
         },
         "cofins": {
           "aliquota": 0,
           "valor": 0,
           "retido": false
         }
       },
       "tributosFederaisRetidos": true
     }
   ],
   "cidadePrestacao": {
     "codigo": "4314902",
     "descricao": "Ibiruba"
   }
 }
]

Campos customizados para a impressão

Impressão da NFSe

• RazaoSocialPrestador=String[60]
• NomeFantasiaPrestador=String[60]
• TelefonePrestador=String[20]
• EmailPrestador=String[100]
• AtividadeMunicipio=String[10]
• InscricaoEstadualPrestador=String[20]
• DataHoraCancelamento=String[20]