O serviço de emissão em contingência de MDF-e é responsável por realizar a validação dos dados do MDF-e enviado de acordo com os tipos de dados definidos pelos schemas XMLs da Sefaz e realizar a geração do DAMDFE de contingencia, juntamente com o XML que deve ser enviado posteriormente para autorização na Secretaria da Fazenda.
O retorno deste serviço contém o pdf para visualização da nota em contingencia e o xml completo para emissão posterior na NS MDF-e API.
URL
Produção: POST https://mdfe.ns.eti.br/mdfe/cont/issue
Dados de entrada
Os dados do MDF-e para o método de emissão podem ser enviados em JSON ou XML.
Envio de dados em formato JSON
Para envio dos dados em JSON o Content-Type da requisição deverá ser definido como application/json.
Campo | Ocorrência | Tipo | Pai | Descrição |
---|---|---|---|---|
X-AUTH-TOKEN | 1-1 | A | Token de acesso do usuário. Pode ser enviado também via Header ou QueryString na URL. | |
MDFe | 1-1 | O | Dados do MDF-e (conforme Manual de Orientações do Contribuinte da Sefaz) |
Clicando no arquivo abaixo é possível fazer o download de um exemplo completo de MDF-e no formato JSON:
Envio de dados em formato XML
Para envio dos dados em XML o Content-Type da requisição deverá ser definido como application/xml e o X-AUTH-TOKEN deverá ser enviado no cabeçalho HTTP.
No envio em formato XML o corpo da requisição deverá conter o conteúdo do XML com as informações do MDF-e. Esse conteúdo deverá ser gerado a partir do layout do Manual de Orientações do Contribuinte da Sefaz.
Clicando no arquivo abaixo é possível fazer o download de um exemplo completo de MDF-e no formato XML:
Exemplo de requisição
Requisição de emissão de MDF-e em JSON
curl -X POST \
-H "Content-Type: application/json" \
-d '{"X-AUTH-TOKEN":"...","MDFe":{...}}' \
https://mdfe.ns.eti.br/mdfe/cont/issue
Requisição de emissão de MDF-e em XML
curl -X POST \
-H "X-AUTH-TOKEN: SEU_TOKEN" \
-H "Content-Type: application/xml" \-d '<MDFe xmlns="http://www.portalfiscal.inf.br/mdfe"><infMDFe versao="3.00"><ide><cUF>43</cUF><tpAmb>2</tpAmb><tpEmit>2</tpEmit></MDFe>' \
https://mdfe.ns.eti.br/mdfe/issue
Dados retornados
Campo | Descrição | Observação |
---|---|---|
status | Código de status do processamento | |
motivo | Descrição literal do status de processamento | |
chMDFe | Chave da Nota emitida em Contingencia Offline | Somente em status = 200 |
DAMDFE com layout de contingencia em Base64 | Somente em status = 200 | |
xml | XML com ajustes para tentativa de emissão posterior | Somente em status = 200 |
Exemplos de retorno
Retorno com sucesso
{
"status": 200,
"motivo": "MDF-e enviado para Sefaz",
"chMDFe": "1234",
"xml": "<?xml version=\"1.0\" encoding=\"utf-8\"?><MDFe>...</MDFe>",
"pdf: "JVBERi0xLjQKJeLjz..."}
Autorização do MDFe Emitido em Contingencia Offline
Você deve fazer a emissão do seu documento emitido em contingencia num período de 168horas(Uma semana) para que o MDF-e seja autorizado na Sefaz, utilizando do XML retornado da API neste endpoint. Para autorizar o manifesto confira o método Emissão na NS MDF-e API.