Comparação de Páginas

...

Este webservice tem por finalidade o encerramento de um MDFe conforme seu Id. Ele realiza todo o processamento junto a SEFAZ e retorna um status 200 caso tenha conseguido realizar o encerramento ou status 403 400 com algum descritivo do erro.

Nota

Para que essa API funcione, o usuário do token obtido no passo 1 (obtenção do token) em Perfil de usuários / aba SispetroApp / grupo Papel Motorista deve ter o papel de motorista habilitado (usuários, aba SispetroApp, grupo Papel Motorista). e no campo Motorista Associado ao Usuário deve ser informado o cadastro de um motorista válido. Para mais informações, ver SispetroApp (Usuários)

Além disso, somente MDFes com o campo StatusProcessamento = 4 (pendente encerramento) serão válidos para encerramento.

...

Layout abaixo em formato JSON.

...

1

Chave	Conteudo	Pai	Obrigatório
id	Número do ID do MDFe na tabela MDFe	-	Sim
placa	placa do frota principal do MDFe		opcional. Caso seja passada, a placa deverá ser igual à do frota principal do MDFe.

Método

POST

Exemplo de chamada de WebService

Bloco de código

curl -H "Content-Type: application/json" -H "Accept: application/json" -X POST -H "Authorization: eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpZF91c3VhcmlvIjozMiwiY25waiI6IjAxLjgwNC4zNDUvMDAwMS02MCIsImV4cCI6MTUwMDA1MzYxN30.-ZvhWFYI8fyx66b3kZY1UVUrfaWUTioV3_M6K2wiPGM" http://localhost/mdfe/solicita_encerramento -d '{"id":"8383", "placa":"KLV-4127"}'

Retorno Bem Sucedido

Será retornado um objeto JSON com o registro do MDFe encerrado e o status 200. O status da resposta sempre será 200.

Bloco de código

{"MDFeID":5, 1,
    "CodEmpresa": 1,
    "ChaveAcesso": "1234567890123456789123456789123456789123456789",
    "Modelo": 1,
    "Serie": "1",
    "NumeroMDF": 11,
    "DataMDF": "2024-09-10",
    "HoraMDF": "2000-01-01T11:25:08.420-02:00",
    "SituacaoMDF": 1,
    "CodigoDNCCarrega": "410.180-4",
    "CodigoDNCDescarrega": "355.030-3",
    "SeqFrota": 10041,
    "SeqFrotaCarreta": null,
    "SeqFrotaTrem": null,
    "CodTranspMotorista": "00004",
    "CodTransp": "13328",
    "DataInclusao": "2024-09-10T11:25:10.000-03:00",
    "UsuarioInclusao": "ROOT",
    "DataEncerramento": null,
    "UsuarioEncerramento": null,
    "SeqMotivoCancto": null,
    "UsuarioCancelamento": null,
    "NumeroRecibo": null,
    "DataProcessamentoRecibo": null,
    "NumeroProtocolo": "","NumeroMDF":1,...}
    "XMLProtocolo": ,
    "DataProcessamentoProtocolo": "2024-09-10T11:25:13.000-03:00",
    "CodMsgSefaz": null,
    "MsgSefaz": null,
    "NumeroProtocoloCancelamento": null,
    "XMLAutorizacaoCancelamento": null,
    "DataProcessamentoCancelamento": null,
    "SeqEventoCancelamento": null,
    "Ambiente": 0,
    "XMLSolicitacaoCancelamento": null,
    "Cancelado": 0,
    "StatusProcessamento": 4,
    "CanceladoSefaz": 0,
    "QtdCTe": 0,
    "QtdCTRC": 0,
    "QtdNFe": 1,
    "QtdNF": 0,
    "XMLRecibo": ,
    "InfoAdic": null,
    "InfoCompl": null,
    "NumProtocoloEncerramento": null,
    "XMLEncerramento": null,
    "SeqEventoEncerramento": null,
    "ValorTotalCarga": "1515.0",
    "PesoBrutoCarga": "404.5",
    "CodigoDNCDescarregaEnc": "355.030-3",
    "XMLAutorizacaoEncerramento": null,
    "DataProcessamentoEncerramento": null,
    "DataIncEncerramento": null,
    "DataCancelamento": null,
    "ES": "S",
    "Tipo": 0,
    "MDFe_RegraRespTecnico": 1,
    "MDFe_RegraCSRT": 0,
    "MDFe_RegraQRCode": 1,
    "AssinaturaChaveAcesso": "",
    "CodProd": null,
    "CEP_Carrega": null,
    "CEP_Descarga": null,
    "Latitude_Carrega": null,
    "Longitude_Carrega": null,
    "Latitude_Descarga": null,
    "Longitude_Descarga": null,
    "MDFe_RegraProdPredominante": 0,
    "TipoNF": "NF",
    "EncerramentoAutomatico": 1,
    "StatusEncerramentoAutomatico": 0

Retorno Sem Sucesso

Será retornado um objeto JSON com o motivo do não processamento (poderá ser um erro de autenticação caso o token tenha expirado ou seja inválido ou alguma regra de negócio não atendida. O status da resposta sempre será diferente de 200 (normalmente entre 400 e 410 conforme o erro).

Bloco de código
{"error":"Erro Requisicao: MDFe não encontrado ou com status inválido para encerramento","status":400}

...

Versões comparadas

Versão antiga 2

Nova versão Atual

Chave

Método

Exemplo de chamada de WebService

Retorno Bem Sucedido

Retorno Sem Sucesso