Manual de integração com o webservice

Manual Tomé-Açu

Manual Balsas

Portais Disponíveis 

• Produção

Métodos Disponíveis 

• Envio.
  • Síncrono.
• Cancelar NFSe.

Observações

• Não possui envio em lote.
• Suporta múltiplos serviços.
• Padrão não faz uso de nenhum identificador, ou seja, não possuí os campos: NumeroLote, NumeroRPS, SerieRps e TipoRps.
• Padrão utiliza o parâmetro Senha=xxxxxxxxxx. A senha é o token fornecido pela prefeitura na  liberação do CNPJ para usar o Web Service. ex: Senha="C36D17ABC320D2054E91AD97B46C6CC".

• ATENÇÃO
  • O padrão D2TI não possui um número de identificação como número do RPS, série, tipo ou Numero de lote, por esse motivo ao emitir as notas, deve-se tomar muito cuidado para não duplicar nota na prefeitura uma vez que não existe identificador para esse padrão. Caso seja enviada duas vezes o mesmo xml para a prefeitura, no primeiro envio a nota AUTORIZARÁ, e no segundo ela REJEITARÁ pelo motivo:  "Um lote de RPS identico a este já foi processado." Ou seja, já existe uma NFSe idêntica a essa na prefeitura, nesse caso será preciso RESOLVER essa nota passando os parâmetros:
    
    • Na interface Web: NumeroNFSE_CodigoVerificacao onde o número da NFSe e o código de verificação poderão ser encontrados no PDF da nota no portal da prefeitura.
    • Por HTTP: ParametroExtra=NumeroNFSE_CodigoVerificacao onde o número da NFSe e o código de verificação poderão ser encontrados no PDF da nota no portal da prefeitura.
  • Ao DESCARTAR uma nota com a situação REJEITADA com o motivo: "Um lote de RPS identico a este já foi processado." será retornada uma exception de que já existe uma nota idêntica a essa na prefeitura com a situação AUTORIZADA e que se for feito o descarte da mesma, ficará divergente da prefeitura. Nesse caso será preciso RESOLVER essa nota passando os parâmetros:
    • Na interface Web: NumeroNFSE_CodigoVerificacao onde o número da NFSe e o código de verificação poderão ser encontrados no PDF da nota no portal da prefeitura.
    • Por HTTP: ParametroExtra=NumeroNFSE_CodigoVerificacao onde o número da NFSe e o código de verificação poderão ser encontrados no PDF da nota no portal da prefeitura.
  • Ao DESCARTAR uma nota com a situação REGISTRADA, será retornada uma exception dizendo que essa nota pode ter sido enviada ou não para a prefeitura e como não existe nenhuma consulta via WS, será preciso resolver essa nota para identificar sua real situação.

Geração do XML - Campos Importantes 

• O código do serviço segue o que está descrito na LC-116.
• O código CNAE pode possuir até 10 dígitos, consulta o portal de produção da prefeitura para saber quais códigos estão habilitados.
• Utilizando o tx2 padrão único, se necessário preencher a discriminação dos serviços em geral diferente da discriminação de cada serviço/item, o campo DescricaoRps terá o papel de popular a tag "descricaoNota" e o campo "DISCRIMINAÇÃO DOS SERVIÇOS" na impressão. Por exemplo:
  • No tx2 (Padrão Único):

    • 

  • Na impressão:
    • 
• Caso o campo DescricaoRps esteja vazio, a tag será preenchida com o conteúdo do campo DiscriminacaoServico.

Campos customizados para a impressão 

Impressão do RPS

• ValorPis=String[10]
• ValorCofins=String[10]
• ValorINSS=String[10]
• ValorIR=String[10]
• ValorCSLL=String[10]
• DescricaoNBS=String[265]

Impressão da NFSe

• ValorPis=String[10]
• ValorCofins=String[10]
• ValorINSS=String[10]
• ValorIR=String[10]
• ValorCSLL=String[10]
• DescricaoNBS=String[265]
• DataCancelamento=String=[20]

• Componente NFSe: Release 9.1.62.XXXX