1. Inicio
  2. Documentos
  3. NS MDFe
  4. Eventos de MDFe
  5. Encerramento de MDFe

Encerramento de MDFe

Através do serviço de encerramento de MDF-e é possível encerrar um manifesto previamente autorizado através da API.

Obs.: O encerramento de MDF-e possui regras e prazos definidos pela Secretaria da Fazenda que devem ser consideradas e respeitadas. Para maiores informações clique aqui e verifique a versão mais atualizada o Manual de Orientações do Contribuinte da Sefaz.

URL

Produção: POST https://mdfe.ns.eti.br/mdfe/closure

Dados de entrada
CampoDescriçãoOcorrênciaPaiTipoObservação
X-AUTH-TOKENToken de acesso do usuário1-1A
chMDFeChave de acesso da MDF-e1-1N
nProtNúmero do protocolo de autorização do MDF-e1-1N
tpAmbTipo do ambiente de autorização do MDF-e 1 - Produção 2 - Homologação1-1N1 - Produção 2 - Homologação
dhEventoData e hora da ocorrência do evento1-1DPadrão Sefaz AAAA-MM-DDTHH:MM:SS + UTC Ex.: 2016-06-13T15:04:10-02:00
dtEncData em que o manifesto foi encerrado1-1DAAAA-MM-DD Ex.: 2016-06-13
cUFInformar a UF de encerramento do manifesto 1-1N
cMunInformar o código do município do encerramento do manifesto 1-1NCódigo do IBGE
Exemplo de requisição

Requisição de encerramento de MDF-e

curl -X POST \
-H "Content-Type: application/json" \
-d '{
      "chMDFe": "43170507364618000135580000000003461000033457", 
      "nProt": "999999999999999", 
      "tpAmb": 2, 
      "dhEvento": "2017-05-25T18:58:24-03:00", 
      "dtEnc": "2017-05-25", 
      "cUF": "43", 
      "cMun": "4303509"
     }'\
https://mdfe.ns.eti.br/mdfe/closure
Dados retornados
CampoDescriçãoTipoPaiObservação
statusCódigo de status do processamentoN
motivoDescrição literal do status de processamentoA
retEventoObjeto contendo os dados de processamento do cancelamento na SefazOSomente em status = 200
cStatCódigo de situação do processamentoCretEvento
xMotivoDescrição literal da situação do processamento na SefazAretEvento
chMDFeChave de acesso do MDF-eNretEventoSomente em cStat = 135
dhRegEventoData e hora de registro do evento na SefazDretEventoPadrão Sefaz AAAA-MM-DDTHH:MM:SS + UTC Ex.: 2016-06-13T15:04:10-03:00 Somente em cStat = 135
nProtNúmero do protocolo de autorização do eventoNretEventoSomente em cStat = 135
xmlXML de distribuição do eventoSretEventoSomente em cStat = 135
erroObjeto contendo as informações de erro caso o encerramento não possa ser realizado com sucessoOSomente em status diferente de 200
cStatCódigo de status do erroNerro
xMotivoDescrição literal do erroAerro
Exemplos de retorno

Retorno com sucesso

{
    "status": 200,
    "motivo": "MDF-e encerrado com sucesso",
    "retEvento": {
        "cStat": "135",
        "xMotivo": "Evento registrado e vinculado ao MDF-e",
        "chMDFe": "43170507364617000135580000000003431000003367",
        "dhRegEvento": "2017-05-15T12:01:00-03:00"
    }
}
Códigos de retorno
CódigoDescrição
200MDF-e encerrado com sucesso
-2Chave de acesso inválida
-3Não foi possível encerrar o MDF-e Verifique o objeto erro para maiores informações
-4Problema com certificado digital Verifique o objeto erro para maiores informações
Download do Encerramento do MDF-e

Você pode fazer o download das informações completas de distribuição do encerramento em XML ou JSON e também de uma representação gráfica do mesmo em formato PDF. Para isso confira o método Download de Evento na NS MDF-e API.

Como podemos ajudar?