Este documento é material de especificação dos requisitos de manutenção, trata-se de conteúdo extremamente técnico. |
---|
Especificação | |||
Produto | TSS | Módulo | NF-e / NFC-ee |
Segmento Executor | Serviços | ||
Chamado/ISSUE | |||
País | ( X ) Brasil ( ) Argentina ( ) Mexico México ( ) Chile ( ) Paraguai ( ) Equador ( ) USA ( ) Colombia Colômbia ( ) Outro _____________. |
Demonstrar
o funcionamento do serviço de Status e distribuição de documentos por e-mail via Protheus.as implementações no Envio de DANFE do ERP por E_mail.
Este documento tem por objetivo a definição das especificações e critérios técnicos necessários para a implementação dos eventos "StatusDistribuicaoDeDocumentos" e "DistribuicaoDeDocumentos"
Atualmente estes eventos serão implementados inicialmente para a NF-e (modelo 55).
Regras de Negócio
O Evento de "StatusDistribuicaoDeDocumentos " foi criado para verificação do Status do Email de Distribuição de Documentos Eletrônicos (Modelo 55).
O serviço
Atualmente, várias UF's autorizadoras de documentos fiscais eletrônicos estão tendo seus serviços utilizados de forma indevida por alguns contribuintes. Esse uso indevido pode comprometer a estabilidade dos Web Services e resultar na saturação dos recursos, deixando o ambiente autorizador inoperante, podendo também ser interpretadas como ataques aos recursos de processamento, rede e armazenamento.
Portanto, para preservar os sistemas autorizadores, observado um comportamento indevido da aplicação de alguma empresa no consumo dos diversos Web Services, a SEFAZ autorizadora, a seu critério, poderá implantar as regras de validação de Consumo Indevido.
O contribuinte que estiver utilizando indevidamente os sistemas poderá sofrer as penalidades definidas na legislação de cada UF.
o No intuito de evitar o possível bloqueio do CNPJ do contribuinte na SEFAZ, o TSS realizará auxílio no controle de acessos aos serviços previstos pela Nota Técnica em questão.
o O limite máximo de número de tentativas permitidos pelo TSS será o mesmo definido pela SEFAZ, conforme tabela acima.
o O usuário será notificado via métodos WS de monitoramento do TSS e via console, com o número de tentativas realizadas e pendentes ( “X de N Tentativas”), por serviço e código de erro.
o Implementada a tabela TSS0011 para ser utilizada como “CACHE”, e controladora do consumo indevido de cada serviço executado, por documento e código de retorno da Sefaz.
o Afim de evitar perda de contagem real do número de tentativas de uso de um determinado serviço na SEFAZ, assim que o serviço for transmitido, um novo registro será criado na tabela TSS0011, e após retorno da SEFAZ, caso o código de retorno seja de erro, o registro será atualizado com o este código retornado passando assim a iniciar a contagem, senão o registro será eliminado.
Obs: Especificamente para o caso do serviço de Consulta Chave, a contagem de tentativas a serem incrementadas, deve levar em consideração todos os códigos de retorno, com erro ou não.
o Após o atingimento do limite de tentativas, o TSS penalizará execução idêntica de determinado serviço e erro retornado pela SEFAZ, no intervalo determinado para o serviço em questão contando a partir da primeira rejeição.
o Caso ocorra bloqueio por número de tentativas, e caso o serviço em questão envolva emissão de documentos ou eventos para este documento, o mesmo ficará aguardando até que o tempo de penalização seja cumprido.
o Criada uma rotina auxiliar responsável por sanear(apagar) os registros da tabela "CACHE" que já tenham ultrapassado o tempo de penalização, ou que não excederam o limite de consultas na SEFAZ no período permitido.
o Para todos os serviços será enviado um e-mail de notificação no momento do possível bloqueio por uso indevido no tocante a todos os serviços em questão.
A. Serviços
1 – Consulta Chave
- Deverá ser feito para todos os tipos de documentos (exceto NSFE)
- Impacta as seguintes rotinas do TSS
o Cancelamento
o Consulta protocolo (manual).
- Deverá ser observado o limite de 10 consultas iguais no limite de uma hora:
o Condição para bloqueio: Enviar mais de 10 consultas iguais dado o limite de uma hora.
o Condição para desbloqueio: Após 1 hora do envio da primeira consulta, deverão ser zerados os campos de contadores.
- Em caso de bloqueio, deverá ser enviado um e-mail para o usuário, e apresentar a informação em console e na tag do xml, para que seja visualizado na rotina de “MONITOR”.
2 – Eventos
- Deverá ser observado o limite de 20 consultas iguais no limite de uma hora:
o Condição para bloqueio: Enviar mais de 20 consultas iguais dado o limite de uma hora.
o Condição para desbloqueio: Após 1 hora do envio do primeiro código de retorno de erro, deverão ser zerados os campos de contadores.
- Serão tratados todos os eventos dos seguintes documentos:
Tipos de Documentos:
o CTe
o MDFe
o CTEOs
o NFe
o NFCE
3 – Cancelamento:
- Deverá ser observado o limite de 20 consultas iguais no limite de uma hora:
o Condição para bloqueio: Enviar mais de 20 consultas iguais dado o limite de uma hora.
o Condição para desbloqueio: Após 1 hora do envio do primeiro código de retorno de erro, deverão ser zerados os campos de contadores.
4 – Inutilização
- O tratamento deverá ser idêntico ao serviço de EVENTOS.Método CONSULTACHAVENFE:
Parâmetros de entrada do método são:
Parâmetros de saída do método é:
Método CONSULTADOCSEFAZ:
Parâmetros de entrada do método são:
Parâmetros de saída do método é:
Método CONSULTAPROTOCOLONFE:
Parâmetros de entrada do método são:
Parâmetros de saída do método é:
Método ESTATISTICAS:
Parâmetros de entrada do método são:
Parâmetros de saída do método é:
MétodoGETCODIFAUTH:
Parâmetros de entrada do método são:
Parâmetros de saída do método é:
MétodoGETDADOSNFEID:
Parâmetros de entrada do método são:
Parâmetros de saída do método é:
MétodoGETDADOSNFEID:
Parâmetros de entrada do método são:
Parâmetros de saída do método é:
MétodoMONITORFAIXA:
Parâmetros de entrada do método são:
Parâmetros de saída do método é:
MétodoMONITORFX:
Parâmetros de entrada do método são:
Parâmetros de saída do método é:
MétodoMONITORTEMPO:
Parâmetros de entrada do método são:
Parâmetros de saída do método é:
MétodoMONITORTMP:
Parâmetros de entrada do método são:
Parâmetros de saída do método é:
MétodoNFEMONITORLOTEEVENTO:
Parâmetros de entrada do método são:
Parâmetros de saída do método é:
MétodoNFERETORNAEVENTO:
Parâmetros de entrada do método são:
Parâmetros de saída do método é:
MétodoPRINTSERVICE:
Parâmetros de entrada do método são:
Parâmetros de saída do método é:
MétodoREMSESSA3:
Parâmetros de entrada do método são:
Parâmetros de saída do método é:
MétodoRETORNAFAIXA:
Parâmetros de entrada do método são:
Parâmetros de saída do método é:
MétodoRETORNAFX:
Parâmetros de entrada do método são:
Parâmetros de saída do método é:
MétodoRETORNANFESTATUS:
Parâmetros de entrada do método são:
Parâmetros de saída do método é:
MétodoRETORNANFESERVICOS:
Parâmetros de entrada do método são:
Parâmetros de saída do método é:
Método RETORNANOTAS:
Parâmetros de entrada do método são:
Parâmetros de saída do método é:
MétodoRETORNANOTASDEPECNX:
Parâmetros de entrada do método são:
Parâmetros de saída do método é:
MétodoRETORNANOTASNX:
Parâmetros de entrada do método são:
Parâmetros de saída do método é:
MétodoRETORNANX:
Parâmetros de entrada do método são:
Parâmetros de saída do método é:
Este documento é material de especificação dos requisitos de inovação, trata-se de conteúdo extremamente técnico. |
---|