Manual de integração com o webservice

Download do manual

Portais Disponíveis

• Produção
• Homologação

Métodos Disponíveis

• Envio.
  • Assíncrono.
• Consulta de lote.
• Consulta de NFSe por RPS.
• Consulta de NFSe.
• Cancelamento de NFSe.

Observações

• Autenticação do padrão é feita com assinatura e certificado digital, utilizados na comunicação.
• Aceita envio em lote.
• Caso não sejam informados no tx2, os campos IdLote e IdRps são gerados automaticamente pelo componente, visto que eles não podem se repetir de uma emissão para outra.
• A cada nota autorizada, os campos NumeroLote e NumeroRps devem ser incrementados.
  • Ambos devem ser sequenciais.
• A resposta do Webservice para um envio em lote demora consideravelmente. Aparentemente, antes de devolver o protocolo o Webservice já processa todas as notas do lote.
• É necessário informar a razão social do prestador na consulta de Lote como parâmetro extra, exemplo: RazaoSocial=XXXX.
• Ao utilizar o Manager Edoc, por favor configure corretamente a razão social no cadastro da empresa, pois a mesma será utilizada como parâmetro na consulta de lote automaticamente, como explicado acima.
• Os dados de faturas/parcelas devem ser informados no tx2 padrão único da seguinte forma:
  • Exemplo.

INCLUIRFORMAPAGAMENTO
Parcela=3
DataVencimentoParcela=2020-01-30
ValorParcela=4.50
SALVARFORMAPAGAMENTO

Geração do XML - Campos Importantes

• O código do serviço segue o que está descrito na LC-116.
• Nos testes realizados no ambiente de homologação, o campo CodigoTributacaoMunicipio foi informado com o valor do código IBGE do respectivo município.
• Apesar de constar no esquema, o campo CodigoCNAE não é obrigatório para a autorização de notas.
• Caso não esteja utilizando o padrão único, a alíquota deve ser informada com o valor inteiro. Ex: Aliquota=1.00

• A partir da versão 10.1.63 o componente NFSe está compatibilizado com múltiplos serviços para TecnoSistemas.
  O padrão não possui os totalizadores dos impostos federais, nesse caso, quando se tratar de uma nota com múltiplos serviços, as retenções federais de cada serviço deveram ser somadas e passadas como campos customizados na impressão de NFSe/RPS. Campos customizados dos totalizadores:
  • TotalOutrasRetencoes=String[10]
  • ValorTotalInss=String[10]
  • ValorTotalIr=String[10]
  • ValorTotalCsll=String[10]
  • ValorTotalCofins=String[10]
  • ValorTotalPis=String[10]
  • TotalDescontos=String[10]
  • ValorTotalDeducoes=String[10]
• O campo IDLote tem um preenchimento determinado pelo padrão na seguinte estrutura
  <LoteRps Id="12013915933760001020000000000000001">
        <!--identificador do Lote de Rps, por padrão é esperado a composição-->
        <!--1                              - identificação de envio de lote sincrono-->
        <!--0000                         - ano do lote enviado no formato AAAA-->
        <!--00000000000009       - numero do CPF/CNPJ do contribuinte formatado com 14 posições->
        <!--0000000000000009   - número sequencial do lote formatado com 16 posições-->

Campos customizados para a impressão

Impressão do RPS

• DataVencimentoNFSe=String[80]
• NomeFantasiaPrestador=String[80]
• EnderecoPrestador=String[80]
• CodigoMunicipioPrestador=String[10]
• UfPrestador=String[2]
• NumeroEnderecoPrestador=String[7]
• ComplementoEnderecoPrestador=String[20]
• BairroPrestador=String[40]
• CepPrestador=String[8]
• TelefonePrestador=String[20]
• EmailPrestador=String[80]
• TotalOutrasRetencoes=String[10]
• ValorTotalInss=String[10]
• ValorTotalIr=String[10]
• ValorTotalCsll=String[10]
• ValorTotalCofins=String[10]
• ValorTotalPis=String[10]
• TotalDescontos=String[10]
• ValorTotalDeducoes=String[10]

Impressão da NFSe

• DataVencimentoNFSe=String[80]
• ValorIssRetido=String[10]
• NomeFantasiaPrestador=String[80]
• TotalOutrasRetencoes=String[10]
• ValorTotalInss=String[10]
• ValorTotalIr=String[10]
• ValorTotalCsll=String[10]
• ValorTotalCofins=String[10]
• ValorTotalPis=String[10]
• TotalDescontos=String[10]
• ValorTotalDeducoes=String[10]

Soluções Tecnospeed

• Componente NFSe:   Release 8.7.48.XXXX
• Manager eDoc:   Release 3.0.83.X