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

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.

Tipo de impressão

Selecione uma opção e explique os impactos nos produtos.

• (x) Impressão via link da prefeitura
  • Nossos produtos fazem download do PDF gerado pela prefeitura.
• ( ) Impressão via layout Tecnospeed
  • Nossos produtos geram o PDF, aproximando ao máximo o layout da prefeitura.

Observações sobre a impressão de contingencia (RTM).

• O XML retornado pela prefeitura não traz todos os dados necessários para gerar o PDF no layout Nacional. Por isso, quando a contingência é acionada, o RTM é montado combinando o XML de envio com o XML de retorno, reunindo o máximo de informação disponível entre os dois.

IMPORTANTE - CHAVE DE ACESSO DA NFS-e (ChaveNFSe)

A chave de acesso NÃO vem no retorno da prefeitura e não temos outro meio de obtê-la. Por isso o campo "Chave de Acesso da NFS-e" e a chave no canhoto ficam em branco na impressão. Ela só existe no sistema da prefeitura (aparece no PDF gerado pelo link).

Não estão disponíveis em nenhuma fonte (nem no retorno da NFSe, nem no RPS, nem no TX2):

• Tipo de ambiente (Produção/Homologação): fica em branco
• Ambiente gerador: exibido fixo como "Sistema Municipal"
• Situação da NFS-e: deduzida ("Gerada" ou "Substituição Gerada")
• Alíquotas efetivas de IBS UF, IBS Municipal e CBS: saem como "-"
• Redução de alíquota de IBS UF, IBS Municipal e CBS: saem como "-"
• Valor total do IBS: calculado (IBS UF + IBS Municipal)
• Total das retenções: calculado a partir das retenções individuais
• Reembolso, repasse e ressarcimento (IBS/CBS): não considerado
• Base de cálculo do IBS/CBS após exclusões: exibe a base enviada no RPS 
• Benefício municipal (tipo, número e valor da redução) e percentual de deduções: saem como "-"
• Tipo de imunidade e tipo de suspensão do ISSQN: saem como "-"

Enviados no RPS, mas não devolvidos pela prefeitura (só aparecem se o RPS for informado na impressão):

• Código de tributação nacional e a descrição do serviço nacional
• Código NBS
• Alíquotas e valores de IBS UF, IBS Municipal e CBS, e a base de cálculo do IBS/CBS
• Indicador de operação (IBS/CBS)
• Tipo de retenção de PIS/COFINS
• NIF do tomador
• Destinatário (identificação, endereço e contato) e o indicador de destinatário
• Inscrição imobiliária do imóvel e código do evento

Existem apenas no TX2 (só aparecem se o TX2 for informado na impressão):

• CST e classificação tributária (cClassTrib) do IBS/CBS
• Município de incidência do IBS/CBS
• Finalidade da NFS-e
• Regime de apuração tributária do Simples Nacional
• Endereço e contato do intermediário
• Inscrição estadual do tomador e nome fantasia do prestador
• Documento de referência, número do pedido e informações complementares
   

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.
• É necessário informar o motivo do cancelamento para cancelar uma nota como parâmetro extra, exemplo: MotivoCancelamento=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]

   

Novos campos disponibilizados para adequação da Reforma Tributária

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 maiores informações sobre a forma de preenchimento destes campos novos, acesse as nossas documentações do Padrão Unificado de TX2 e TX2 do Padrão Nacional.
 

Exemplos:

• XML Envio
• XML Autorizado
• TX2

Soluções Tecnospeed

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

Exemplos de arquivos de integração