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;
• Cancelamento de NFSe.

Observações

  Métodos Disponíveis

• Para realizar todas os métodos disponíveis pelo WebService, é necessário informar o Login e a Senha como parâmetro extra, levando em conta de que o padrão não utiliza certificado. Caso não possua as credenciais, basta acessar o portal da prefeitura e realizar o cadastro.  
• Caso o login do portal não funcione, tentar o Cnpj sem máscara. 
  • Os parâmetros extras serão informados da seguinte forma: Login=12341234123412;Senha=123senha

   Envio de RPS

• Não é possível realizar o envio em Lote, sendo necessário enviar um RPS de cada vez;
• O padrão aceita envio de múltiplos serviços, e devem ser informados da seguinte forma, pelo tx2 de padrão único TecnoNFSe:

INCLUIRRPS                                      
...
DiscriminacaoServico=Discriminacao 1            { Primeiro Serviço }
ValorUnitarioServico=0.00
QuantidadeServicos=1
...
SALVARRPS

INCLUIRSERVICO
DiscriminacaoServico=Discriminacao 2            { Segundo Serviço }
ValorUnitarioServico=0.00
QuantidadeServicos=1
SALVARSERVICO

INCLUIRSERVICO
DiscriminacaoServico=Discriminacao 3            { Terceiro Serviço }
ValorUnitarioServico=0.00
QuantidadeServicos=1
SALVARSERVICO

Obs: O primeiro serviço deve ser informado dentro do Dataset "INCLUIRRPS" e a partir do segundo serviço em diante (caso haja), devem ser informados em um Dataset "INCLUIRSERVICO".

Consultar NFSe por RPS

• Para realizar uma consulta de NFSe por RPS, alem das credenciais, é necessário informar o Número do Lote do RPS em questão como parâmetro extra:
  • Login=12341234123412;Senha=123senha;Lote=1

Cancelamento de uma NSFe 

• Para realizar o cancelamento de uma NFSe, é necessário informar a Chave de Cancelamento do padrão, que será constituída do Número do RPS e o Número do Lote da NFSe. Por exemplo:
  • NumeroRPS_NumeroLote: 1_1 

Impressão

• Para realizar a impressão da NFSe pelo componente, deverá ser informado o XML de envio do RPS, pois no retorno do Envio (autorizado) e da consulta de NFSe por RPS, não retornam todos os dados necessários para a impressão ser compatível com a da prefeitura.
• Além do XML de envio do RPS, deverá ser informado os campos Customizados informados na seção "Campos customizados para a impressão". 
  • ATENÇÃO ao informar o XML do RPS referente a NFSe autorizada, para que não haja diferenças.

Geração do XML - Campos Importantes

• O padrão utiliza número de RPS sequencial e não faz uso da série do RPS e do Tipo RPS. Os campos poderão ser informados, mas o webservice ignora os mesmos.
• Padrão não utiliza o campo ItemListaServico. No TecnoNFSe, mesmo informando, o mesmo será desconsiderado na geração. Isso também se aplica ao campo CodigoTributacaoMunicipio.
• O campo CodigoCnae é obrigatório e segue a lista nacional.
• O campo DescricaoRPS será referente a tag OBSERVACAO do XML.
• No momento da homologação do padrão, não havia como informar quebra de linha para a impressão.

Campos customizados para a impressão

Impressão do RPS

• CpfCnpjPrestador=String[20]
• NomeFantasiaPrestador=String[80]
• RazaoSocialPrestador=String[80]
• InscricaoMunicipalPrestador=String[20]
• EnderecoPrestador=String[80]
• CodigoCidadePrestador=String[10]
• NumeroPrestador=String[7]
• ComplementoPrestador=String[20]
• BairroPrestador=String[40]
• CepPrestador=String[8]
• OptanteSimplesNacional=String[30]
  • Preencher com '1' - Sim ou '2' - Não.
• ValorServicos=String[30]
  • Preencher com o valor total (bruto) da NFSe.
• ValorLiquidoNfse=String[30]
  • Preencher com o valor total (bruto) e subtrair os impostos.
• OutrasInformacoes=String[255]

Impressão da NFSe

• CpfCnpjPrestador=String[20]
• NomeFantasiaPrestador=String[80]
• RazaoSocialPrestador=String[80]
• InscricaoMunicipalPrestador=String[20]
• EnderecoPrestador=String[80]
• CodigoCidadePrestador=String[10]
• NumeroPrestador=String[7]
• ComplementoPrestador=String[20]
• BairroPrestador=String[40]
• CepPrestador=String[8]
• OptanteSimplesNacional=String[30]
  • Preencher com '1' - Sim ou '2' - Não.
• ValorServicos=String[30]
  • Preencher com o valor total (bruto) da NFSe.
• ValorLiquidoNfse=String[30]
  • Preencher com o valor total (bruto) e subtrair os impostos.
• OutrasInformacoes=String[255]

Soluções Tecnospeed

• Componente NFSe:    Release 9.1.60.X.
• Manager eDoc:  Release 4.1.X.X