ADD-NFS-e/ADDTAX

Produto: NFS-e

Manual operacional
 TRUST ADDVISOR CONSULTORIA EM TECNOLOGIA DA INFORMAÇÃO LTDA
JANEIRO 2018

Sumário
1. PROPÓSITO DO DOCUMENTO. ............................................................... 3
2. CONCEITUAL. ........................................................................................ 4
2.1. WEBSERVICE. ....................................................................................... 4
2.2. TXT. ...................................................................................................... 4
2.3. FLUXO SÍNCRONO. ................................................................................ 4
2.4. FLUXO ASSÍNCRONO. ............................................................................ 4
3. FLUXO GERAL DA SOLUÇÃO ADD-NFS-E/ADDTAX. ................................ 5
4. MENU PRINCIPAL: ADDTAX. ................................................................. 6
4.1. OPERAÇÃO ADDNFS-E/ADDTAX. ........................................................... 6
4.2. FUNCIONALIDADES MONITOR ADDTAX. ............................................... 6
4.3. DETALHAMENTOS DAS FUNCIONALIDADES. ......................................... 7
4.3.1. MONITOR DE PROCESSOS. ............................................................... 7
4.3.2. NAVEGAÇÕES EXTERNAS. ................................................................ 8
4.3.3. LOG DE EVENTOS. .......................................................................... 10
4.3.4. REPROCESSAMENTO DE DOCUMENTOS COM ERROS. ...................... 11
4.3.5. CANCELAMENTOS NFS-E. ............................................................... 12
4.3.6. ENVIO DE E-MAILS. ....................................................................... 13
4.4. EXPORTAR RPS MANUALMENTE. ......................................................... 14
4.5. IMPORTAR LOTE MANUALMENTE. ....................................................... 16

2
1. Propósito do Documento.

Instruir os usuários a utilizar a Solução ADDNFS-e/ADDTAX no processo operacional SAP,

envolvendo a conversão de RPS para Notas Fiscais de Serviço.

A operação baseia-se em três etapas:

• Exportação
• Importação
• Cancelamento

Todas as operações serão detalhadas neste documento.

As informações aqui apresentadas referem-se exclusivamente a Solução ADDNFS-

e/ADDTAX, não abordando nenhuma particularidade de Prefeituras, Prestadores de
Serviços e Tomadores.

Somente funcionalidades pertencentes a Solução ADDNFS-e/ADDTAX serão destacadas.

Procedimentos básicos de navegação e processos standard SAP, bem como transações
de venda e faturamento, não farão parte do conteúdo deste documento.

3
2. Conceitual.

A Solução ADDNFS-e/ADDTAX realiza troca de informações com as Prefeituras de

duas maneiras (Webservice ou arquivo TXT). A escolha dessas tecnologias tem total
dependência das Prefeituras, sendo as Prefeituras quem determinam qual tecnologia
utilizar.
O processo de comunicação poderá ocorrer de forma síncrona ou assíncrona.

2.1. Webservice.
Comunicação automática com a Prefeitura, não necessariamente precisa existir ação
do usuário. Esse meio de troca de informações poderá ser programado para execução
automática.

2.2. TXT.
Troca de arquivos com a Prefeitura exigindo total dependência do usuário.

2.3. Fluxo Síncrono.

As solicitações de serviços de implementação síncrona são processadas

imediatamente e o resultado do processamento é obtido em uma única conexão.
Durante a primeira comunicação com a Prefeitura, o RPS é convertido no mesmo
momento, gerando o número da Nota Fiscal correspondente e encerra-se o processo.

2.4. Fluxo Assíncrono.

As solicitações de serviços de implementação assíncrona são processadas de forma

distribuída por vários processos e o resultado do processamento somente é obtido na
segunda conexão.

Durante a primeira comunicação com a Prefeitura, o RPS não é convertido, um

número de protocolo é gerado. Em posse deste, uma segunda comunicação é feita na
tentativa de obter o número da Nota Fiscal ou qualquer outra ocorrência de erros.

4
3. Fluxo Geral da Solução ADD-NFS-e/ADDTAX.

5
4. Menu principal: ADDTAX.

Transação: ZADDTAX.

4.1. Operação ADDNFS-e/ADDTAX.

A Solução ADDNFS-e/ADDTAX irá processar automaticamente todos os documentos de

serviços faturados pela transação VF01. Após processados pelo standard SAP, os
documentos poderão ser acessados e visualizados pela transação ZADDTAXP (Monitor
de Processos SAP) ou navegando conforme detalhado na imagem acima (Menu principal
ADDTAX).

Documentos com pendência de preenchimento, não serão processados

automaticamente e não aparecerão no monitor ZADDTAXP, cabendo a área de negócios
realizar as devidas correções cadastrais e reprocessa-los manualmente pela transação
ZADDNFSE00E (Exportar RPS), exemplificado no tópico 4.4.

Obs.: Somente Prefeituras que disponibilizam integração sistêmica utilizando webservice

poderão ser programadas para execução automática.

4.2. Funcionalidades Monitor ADDTAX.

• Monitor de processos.
• Navegação J1B3N e link NFS-e Prefeitura.
• Reprocessamento de documentos com erro.
• Log de eventos.
• Cancelamento NFS-e.
• Envio de e-mails.

6
 4.3. Detalhamentos das funcionalidades.

4.3.1. Monitor de processos.

Entrar na transação ZADDTAXP e preencher a tela de seleção com os dados conforme

exemplo abaixo, pressionar a tecla Enter (o campo “Processo” irá preencher
automaticamente), em seguida executar com F8 ou clicar na opção .

Tela de seleção (Exemplo de preenchimento):

• Empresa SAP.
• Local de negócio SAP.
• Data de processamento SAP: Criação do documento no SAP.
• Processo (Classificação): Padrão NFS-e Outbound.
• Considerar proc. SAP concluídos: Campo opcional, quando marcado, exibe
somente documentos que teve seu processo finalizado na Prefeitura, ou
seja, convertido ou cancelado com sucesso.
• Nº documento: Campo opcional.
• Layout: Campo opcional, customização para gravação de estruturas de
colunas, critérios de ordenação e condições de filtros para o Monitor de
Processos.

7
Visão geral do monitor de processos:

4.3.2. Navegações externas.

J1B3N:
Clicar no número do documento na coluna Nº documento:

8
Link NFS-e:
Clicar no número da fiscal na coluna Nº da NFS-e:

Obs.: Nem todas as Prefeituras disponibilizam um link acessível para a exibição da nota
fiscal, neste caso uma mensagem informando que não foi encontrar o link da Prefeitura
será exibida.

9
 4.3.3. Log de eventos.

Para acessar os logs de tentativas de comunicação coma a Prefeitura e visualizar

detalhadamente as ocorrências de sucesso ou erro, deve-se acessar o monitor de
processos conforme orientado no passo 4.3.1, marcar a linha a ser executada e clicar na
opção .

Log cronológico de eventos. Todos os eventos relacionados ao documento serão

exibidos:

Registros contendo o ícone disponibilizam a informação trafegada durante a

comunicação com a Prefeitura. Ao clicar, dependendo do fluxo e operação as
informações serão exibidas da seguinte forma:

10
 4.3.4. Reprocessamento de documentos com erros.

Para reprocessamento de um documento com erro, deve-se acessar o monitor de

processos conforme orientado no passo 4.3.1, marcar a linha a ser executada em seguida
executar com F8 ou clicar na opção .

Obs.: Para visualizar somente documentos com erros, neste caso não é necessário marcar
a opção “Considerar proc SAP concluídos”.

11
 4.3.5. Cancelamento NFS-e.

Somente documento com status “Processo Concluído – Execução” poderão ser

cancelados, pois entende-se que é uma nota convertida com sucesso e está apta para a
realização do seu cancelamento.

Para cancelamento de um documento deve-se acessar o monitor de processos conforme

orientado no passo 4.3.1, marcar a linha a ser executada em seguida clicar na opção .

12
 4.3.6. Envio de E-mails.

O envio de e-mail é realizado automaticamente assim que o documento é convertido

com sucesso na Prefeitura. Caso haja a necessidade de um reenvio de e-mail, deve-se
acessar o monitor de processos conforme orientado no passo 4.3.1, marcar a linha a ser
executada em seguida clicar na opção .

Tela para envio de e-mail (no pop-up clicar novamente em ):

Obs.: Os e-mails do destinatário são carregados automaticamente a partir da lista de e-

mails do cadastro do cliente da transação XD03.

13
 4.4. Exportar RPS manualmente.

Transação: ZADDNFSE01E (Exportar RPS).

O processo de exportação consiste no envio do RPS para a prefeitura.

Tela de seleção:

• Empresa SAP.
• Local de negócio SAP.
• Data de criação do documento SAP.
• Nº documento: Campo opcional.
• Meio de comunicação: Webservice ou Arquivo TXT.
• Cancelar: Se marcado, documentos gerados no período serão cancelados junto a
Prefeitura.

Executar com o F8 ou clicar no botão .

Ao processar os documentos SAP serão exibidos conforme abaixo:

14
Para realizar a exportação deste documento, pressionar

Confirmar ou não a operação de exportação (Sim para continuar e exportar):

Processo assíncrono após exportar:

Neste ponto não é necessário a realização da importação manual, pois será feito
automaticamente e os resultados a partir deste ponto já estarão disponíveis no monitor
ZADDTAXP.
A importação manual será informada neste manual somente para fins de documentação.

15
 4.5. Importar Lote manualmente.

Transação: ZADDNFSE01I (Importar RPS).

O processo de importação consiste na obtenção dos resultados pós exportação junto as

Prefeituras.

Tela de seleção:

• Empresa SAP.
• Local de negócio SAP.
• Data de criação do documento SAP.
• Nº do Lote: Número gerado no processo de exportação.
• Meio de comunicação: Webservice ou Arquivo TXT.

Executar com o F8 ou clicar no botão .

Ao processar os documentos SAP serão exibidos conforme abaixo:

Pressionar

16
Confirmar ou não a operação de importação (Sim para continuar e importar):

Quando bem sucedido obtém-se o número da nota fiscal gerada:

Exemplo de Nota fiscal convertida com sucesso:

17