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 automotiva 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
Autenticação na API Rest
Visualizado 1163 vezes desde 09/03/2018
Integração API Rest
Visualizado 659 vezes desde 09/03/2018
Emissão de DFes na API Rest
Visualizado 535 vezes desde 13/03/2018
Emissão de Eventos Fiscais na API Rest
Visualizado 397 vezes desde 16/03/2018
Inutilização de Numeração na API Rest
Visualizado 400 vezes desde 16/03/2018
Importação e Conciliação de DFes na API Rest
Visualizado 318 vezes desde 16/03/2018
Recebimento de Documentos Fiscais via API Rest
Visualizado 279 vezes desde 16/03/2018
Gerenciamento de Empresas na API Rest
Visualizado 256 vezes desde 16/03/2018
Manutenção de CSC (Código de Segurança do Contribuinte) na API Rest
Visualizado 773 vezes desde 16/03/2018
Criar Aplicativo no Monitor Oobj
Visualizado 197 vezes desde 12/04/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.