Manual de integração com o webservice
Portais Disponíveis
- Produção
Métodos Disponíveis
- Envio.
- Síncrono.
- Consulta de NFSe.
- Cancelamento de NFSe.
- Consulta de NFSe por RPS.
Observações
-
Componente NFSe
- É obrigatório a informação de login e senha para todos os métodos de comunicação. Ex: _XML := ProxyNFSe.EnviarSincrono(mmXML.Text, 'Login=XXXXXXXXX;Senha=XXXXXX');
- No cancelamento, além de informar os parâmetros de login e senha, também é necessário informar o parâmetro extra 'Observacao';
- O servidor permite a emissão de várias notas com o mesmo RPS e, quando você realiza o cancelamento de um desses RPS's, o servidor cancela todos. Sendo assim, é extremamente importante o controle de emissão pelo número do RPS.
- O campo 'ctr' é equivalente ao Número do Rps, sendo utilizado para Consultas e Cancelamento;
- Impressão de Recibo Provisório de Serviços (RPS) não prevista em lei.
- O link de impressão da nota pode ser obtido utilizando os comandos do executar, através do método
- "ObterLinkImpressaoNFSe", Segue o exemplo abaixo:
procedure TfrmExemplo.ObterLinkImpressaoClick(Sender: TObject);
var resultado : String;
begin
NFSe.Comando('ObterLinkImpressaoNFSe').Parametros['XML'] = XmlRetornoNota;
resultado := NFSe.Executar('ObterLinkImpressaoNFSe');
end;
Manager EDoc
- Padrão FGMaiss não faz uso do Número de Lote, por isso não possui numeração automática de Lote no Manager Edoc.
- A numeração automática de RPS utilizando o tx2 da cidade foi retirado. Utilize o tx2 TecnoNFSe para usar este recurso.
- Para efetuar o cancelamento é necessário que o prestador solicite permissão junto a prefeitura.
- É muito importante que o cancelamento seja feito somente pelo Manager eDoc, pois a consulta do servidor não retorna qualquer informação que indique a situação da nota.
- Para o erro "Informamos que a partir do dia 01/01/2018, para os Contribuintes Optantes do Simples Nacional, o Consumo do Web Service e a Emissão de NFSe sofrerão uma Alteração. Foi acrescentado três novos campos no WebService e serão obrigatórios (Receita Bruta, Anexo, e Data Início de Atividade). " é preciso informar os seguintes campos no Tx2 de envio que podem ser identificados no portal da prefeitura: (Atentando-se ao '@' no inicio)
-
- @ssrecbr="Receita bruta"
- @ssanexo="Anexo Simples Nacional"
- @ssdtini="Data de inicio do contribuinte no simples nacional"
Exemplo de como informar os campos:
@ssrecbr=433539.64
@ssanexo=ANEXO III
@ssdtini=01/11/2023
-
Geração do XML - Campos Importantes
- O código do serviço segue o que está descrito na LC-116;
-
Campos código CNAE e código tributação município não são utilizados para esse padrão.
Novos campos disponibilizados para adequação da Reforma Tributária
| CodigoNbs * | OptanteSimplesNacional |
DataFinalEvento | TipoFomentoPrestador |
| ValorBCPisCofins | OpcaoObra | DescricaoEvento | TipoFomentoTomador |
| PaisTomador | CodigoObra |
IdentificacaoEvento | TipoMovimentacaoBens |
| CodigoNifTomador | InfObra | CepEvento | NumeroDeclaracaoImp |
MotivoNaoNifTomador |
CodigoCIB | CodigoCidadeEvento | NumeroRegistroExp |
| DocTomadorEstrangeiro | CepObra | UFEvento | TipoMDIC |
| RegiaoTomador | CodigoCidadeObra |
LogradouroEvento | |
| PaisPrestacao | UfObra | NumeroEvento | |
| ValorTotalTribFed | EnderecoObra |
ComplementoEvento | |
| ValorTotalTribEst | NumeroObra | BairroEvento | |
| ValorTotalTribMun | ComplementoObra | CodigoModoPrestacao | |
| ResponsavelRetencao | BairroObra | CodigoVinculoPrestacao | |
| ClassificacaoTributariaIbsCbs | AtividadeEvento | TipoMoedaEstrangeira | |
TipoCST |
DataInicioEvento | ValorServicosEstrangeiro |
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 mais informações sobre a forma de preenchimento destes campos novos, acesse nossa documentação do Padrão Unificado de TX2.
Tx2 Exemplo Campos Reforma Tributária
formato=tx2
padrao=TecnoNFSe
NomeCidade=CRAVINHOSSP
VersaoEsquema=RTC
INCLUIR
NumeroLote=0
CpfCnpjRemetente=11222333000199
InscricaoMunicipalRemetente=
RazaoSocialRemetente=EMPRESA REMETENTE TESTE LTDA
QuantidadeRps=1
DataInicio=2026-01-23
DataFim=2026-01-23
ValorTotalServicos=100.00
ValorTotalDeducoes=0
ValorTotalBaseCalculo=100.00
SALVAR
INCLUIRRPS
CpfCnpjPrestador=99888777000155
NumeroRps=1804
DataEmissao=2026-01-23T00:00:00
PaisTomador=BR
NifTomador=
MotivoNaoNifTomador=
CpfCnpjTomador=55444333000188
RazaoSocialTomador=EMPRESA TOMADORA TESTE SA
InscricaoMunicipalTomador=
InscricaoEstadualTomador=
EnderecoTomador=Rua Exemplo
NumeroTomador=100
ComplementoTomador=Sala 10
BairroTomador=CENTRO
CepTomador=00000000
CodigoMunicipioIncidencia=132
UfTomador=PR
DocTomadorEstrangeiro=
RegiaoTomador=
DDDTomador=
TelefoneTomador=
EmailTomador=
PaisPrestacao=BR
CodigoCidadePrestacao=5481
DiscriminacaoServico=PRESTACAO DE SERVICO DE INFORMATICA
ValorTotalTribFed=8.00
ValorTotalTribEst=9.00
ValorTotalTribMun=5.00
CodigoItemListaServico=14.01.01
AliquotaISS=3.00
ValorServicos=100.00
CodigoNbs=115021000
ClassificacaoTributariaIbsCbs=000001
TipoCST=00
TipoRetPisCofins=0
BaseCalculo=
AliquotaPIS=
ValorPIS=
AliquotaCOFINS=
ValorCOFINS=
AliquotaIR=
ValorIR=
AliquotaCSLL=
ValorCSLL=
AliquotaINSS=
ValorINSS=
DescontoIncondicionado=
DescontoCondicionado=1000.00
ValorPercDeducoes=
IncentivoFiscal=
ValorIss=2.53
ValorIssRetido=
ValorIssServico=2.53
IssRetido=SIM
ValorLiquidoNfse=100.00
OptanteSimplesNacional=1
AnexoSimplesNacional=
DataVigencia=
OpcaoObra=
CodigoObra=
InfObra=
CodigoCIB=
CepObra=
CodigoCidadeObra=
UfObra=
EnderecoObra=
NumeroObra=
ComplementoObra=
BairroObra=
AtividadeEvento=
DataInicioEvento=
DataFinalEvento=
DescricaoEvento=
IdentificacaoEvento=
CepEvento=
CodigoCidadeEvento=
UFEvento=
LogradouroEvento=
NumeroEvento=
ComplementoEvento=
BairroEvento=
CodigoModoPrestacao=
CodigoVinculoPrestacao=
TipoMoedaEstrangeira=
ValorServicosEstrangeiro=
TipoFomentoPrestador=
TipoFomentoTomador=
TipoMovimentacaoBens=
NumeroDeclaracaoImp=
NumeroRegistroExp=
TipoMDIC=
SALVARRPS
Exemplo XML envio campos Reforma Tributária
<EnvNfe>
<usuario>999999</usuario>
<pass>999999</pass>
<prf>11.222.333/0001-99</prf>
<usr>99.888.777/0001-55</usr>
<ctr>21916</ctr>
<dataemissao>29/01/2026</dataemissao>
<localestab>BR</localestab>
<nifinf/>
<nifmotivo/>
<cnpjcpfnif>55.444.333/0001-88</cnpjcpfnif>
<cnpjcpfnifnome>EMPRESA TOMADORA TESTE SA</cnpjcpfnifnome>
<im/>
<ie/>
<lgr>Rua Exemplo</lgr>
<num>100</num>
<cpl>Sala 10</cpl>
<bai>CENTRO</bai>
<cep>00000000</cep>
<cid>132</cid>
<est>PR</est>
<pais/>
<epr/>
<fone/>
<mail/>
<paisloc>BR</paisloc>
<loc>5481</loc>
<txt>PRESTACAO DE SERVICO DE INFORMATICA</txt>
<impfederal>8.00</impfederal>
<impestadual>9.00</impestadual>
<impmunicipal>5.00</impmunicipal>
<item1>14.01.01</item1>
<aliq1>3.00</aliq1>
<impret>NAO</impret>
<val1>100.00</val1>
<codnbs>115021000</codnbs>
<clatribscbs>000001</clatribscbs>
<sittribpiscofins>00</sittribpiscofins>
<tipretpiscofins>0</tipretpiscofins>
<bpis/>
<apis/>
<pis/>
<bcofins/>
<acofins/>
<cofins/>
<birrf/>
<airrf/>
<irrf/>
<bcsll/>
<acsll/>
<csll/>
<binss/>
<ainss/>
<inss/>
<desci/>
<desco>1000.00</desco>
<descoutros/>
<per/>
<per2/>
<valtrib>100.00</valtrib>
<iss>2.53</iss>
<issret/>
<issrec>2.53</issrec>
<liqpag>100.00</liqpag>
<ssusr>NAO</ssusr>
<ssanexo/>
<ssdtini/>
<infobrasopcao/>
<infobrascodobra/>
<infobrasim/>
<ccib/>
<infobrascep/>
<infobrasmunicipio/>
<infobrasufproviciaregiao/>
<infobraslogradouro/>
<infobrasnumero/>
<infobrascomplemento/>
<infobrasbairro/>
<infoatividadeeventoopcao/>
<infoatividadeeventodatainicial/>
<infoatividadeeventodatafinal/>
<infoatividadeeventodescricao/>
<infoatividadeeventoidentificacao/>
<infoatividadeeventocep/>
<infoatividadeeventomunicipio/>
<infoatividadeeventoufregiaoestado/>
<infoatividadeeventologradouro/>
<infoatividadeeventonumero/>
<infoatividadeeventocomplemento/>
<infoatividadeeventobairro/>
<infocomextmodoprest/>
<infocomextvinculo/>
<infocomextmoeda_codigo/>
<infocomextvlrmoeda/>
<infocomextmecprest/>
<infocomextmectomador/>
<vincopemovtempbens/>
<didsidadri/>
<reaverb/>
<compartdpsmdic/>
</EnvNfe>
Campos customizados para a impressão
Impressão do RPS e NFSe
- RazaoSocialPrestador=String[80]
- InscricaoMunicipalPrestador=String[40]
- InscricaoEstadualPrestador=String[40]
- TelefonePrestador=String[20]
- EnderecoPrestador=String[80]
- ComplementoEnderecoPrestador=String[20]
- BairroPrestador=String[40]
- NumeroEnderecoPrestador=String[10]
- CepPrestador=String[10]
- DescricaoCidadePrestador=String[10]
- UfPrestador=String[2]
- EmailPrestador=String[80]
- Competencia=String[30]
- ValorLiquidoNfse=String[30]
Soluções Tecnospeed
- Componente NFSe: Release 8.7.48.X.
- Manager eDoc: Release 3.0.82.X
Comentários
0 comentário
Por favor, entre para comentar.