Configurar MDe na Api Rest

A Configuração do MDe através da API Rest será permitido para o usuário que já possuir o x-auth-token. No artigo Autenticação na API Rest damos mais detalhes sobre o x-auth-token. Existem alguns Endpoints para a configuração do serviço e para cada um, há uma URL específica.

 

Modulo de Consulta

Pela Api Rest o usuário poderá ativar o módulo de consulta que é responsável por fazer buscas periódicas no Webservice do Portal Nacional. Para isso há um Endpoint que permite realizar a consulta através do NSU (Número Sequencial Único).

 

Importante ressaltarmos que a consulta por NSU busca apenas DFes consultados diretamente na Sefaz e poderá importar os seguintes tipos de documentos:

  • Resumo do DF-e
  • Proc DF-e
  • Evento do Emitente
  • Evento do Fisco

 

Ativar consulta pelo NSU

Nesse Endpoint, é possível ativar a consulta de todos os documentos emitidos contra o CNPJ da empresa.

A URL é construída da seguinte forma:

http:// ou https:// + /endereço da API Rest + /api/mde/config/{empresa}/consultaNsu
  • {empresa} : CNPJ da Empresa


Exemplo:

http://teste.oobj.com.br/oobj-rest-service/api/mde/config/12945999/consultaNsu

 

A construção da URL para a desativação de algum CNPJ funciona da mesma forma, para mais detalhes do Endpoint acesse esse link.

 

Modulo de Download

O modulo de download irá acessar a URL configurada por SEFAZ e para cada "DF-e" consultado realizará o download do mesmo seguindo as seguintes regras:

  • A SEFAZ somente irá disponibilizar o XML caso o DF-e esteja AUTORIZADO;
  • A SEFAZ limita que somente os DF-e’s emitidos em até 90 dias anteriores à primeira consulta poderão ser disponibilizadas para consulta e download;
  • Quando o limite é excedido, a SEFAZ retorna o código "632" (SOLICITACAO_DOWNLOAD_FORA_PRAZO);
  • Deverá existir obrigatoriamente o registro de um evento de destinatário (CIÊNCIA DA OPERAÇÃO) para que a SEFAZ libere o download da NFe para o destinatário;
  • Este EVENTO poderá ser realizado de forma automática pela aplicação SE e somente SE o parâmetro "REGISTRAR_EVENTO_CIENCIA" estiver configurado com o valor "true";

Após o download dos documentos os mesmos poderão ser consultados e baixados através dos Endpoints de recebimentos. Para mais detalhes acesse nosso artigo:

 

Abaixo os dois principais Endpoints para download e registro de ciência automática.

 

1. Ativar download

 Nesse Endpoint, é possível ativar o download de todos os documentos disponibilizados pela Sefaz contra o CNPJ da empresa.

 A URL é construída da seguinte forma:

http:// ou https:// + /endereço da API Rest + /api/mde/config/{empresa}/consultaChave
  •  {empresa} : CNPJ da Empresa

 
Exemplo:

http://teste.oobj.com.br/oobj-rest-service/api/mde/config/1294599/consultaChave

 

A construção da URL para a desativação de algum CNPJ funciona da mesma forma, para mais detalhes do Endpoint acesse esse link.

 

2. Ativar Registro de Ciência

Nesse Endpoint, é possível ativar o registro de ciência automática para de todos os documentos recebidos para o CNPJ da empresa.

A URL é construída da seguinte forma:

http:// ou https:// + /endereço da API Rest + /api/mde/config/{empresa}/cienciaOperacao
  •  {empresa} : CNPJ da Empresa

 
Exemplo:

http://teste.oobj.com.br/oobj-rest-service/api/mde/config/1294599/cienciaOperacao

 

A construção da URL para a desativação de algum CNPJ funciona da mesma forma, para mais detalhes do Endpoint acesse esse link.

 

Os Endpoints listados nesse artigo são os essenciais e obrigatorios para realizar a consulta e download de documentos diretamente na Sefaz. Para saber ter acesso a todos os parametros de configuração do MDe, acesse o seguinte link: Configuração MDe.

0 (0)
Avaliação do Artigo (Nenhum voto)
Avaliar esse artigo
Anexos
Não há anexos para este artigo.
Artigos Relacionados RSS Feed
Geração de chave AC (Assinatura do Contribuinte) para SAT na API Rest
Visualizado 757 vezes desde 26/12/2019
Geração de DADFe sem valor fiscal na API Rest
Visualizado 101 vezes desde 25/05/2020
Autenticação na API Rest
Visualizado 4670 vezes desde 09/03/2018
Integração API Rest
Visualizado 6418 vezes desde 09/03/2018
Emissão de DFes na API Rest
Visualizado 2200 vezes desde 13/03/2018
Emissão de Eventos Fiscais na API Rest
Visualizado 1585 vezes desde 16/03/2018
Inutilização de Numeração na API Rest
Visualizado 1587 vezes desde 16/03/2018
Importação e Conciliação de DFes na API Rest
Visualizado 1062 vezes desde 16/03/2018
Recebimento de Documentos Fiscais via API Rest
Visualizado 2173 vezes desde 16/03/2018
Gerenciamento de Empresas na API Rest
Visualizado 759 vezes desde 16/03/2018
Comentários
Nome
Email
Código de Segurança Security Code
Não há comentários para este artigo. Seja o primeiro a postar um comentário.