v1

latestOpenAPI 3.0.3Proprietary2026-07-26125148541.3 KB
MDFe

Emitir

Quando um MDF-e é enviado para processamento, é realizada uma pré-validação, caso ocorra algum problema como: ausência de campos essenciais, formato de dados incorreto ou problemas com o cadastro do emitente em nossa base, o MDF-e não será aceito e você receberá uma mensagem de erro de forma síncrona.

Caso o MDF-e seja aceito para processamento, ele será enviado para uma fila e será processado de forma assíncrona. Com isto, o MDF-e poderá ser autorizado ou retornar um erro, de acordo com a validação da SEFAZ.

Para verificar se o MDF-e já foi autorizado, você terá que efetuar uma consulta ou se utilizar de webhooks (gatilhos).

Se você desejar, é possível configurar a empresa para emissão em modo síncrono.

Abaixo você poderá verificar uma listagem dos principais campos disponíveis. Para verificar a listagem completa de campos veja o link a seguir.

Documentação completa de campos do MDF-e

Além dos campos básicos todo CT-e deverá possuir um modal, que indica a forma de transporte da carga. Veja a seguir os modais existentes e seus respectivos campos:

post/mdfe

Query parameters

refstring required
Example:mdfe-ref-001

Referência única da MDFe

Request body

data_emissaostring date-time required
cnpj_emitentestring required

CNPJ do emitente da MDFe.

Example request

{
  "data_emissao": "2024-07-30T14:00:00-03:00",
  "cnpj_emitente": "12345678000123",
  "veiculo_tracao": {
    "placa": "ABC1234"
  }
}

Response

Requisição aceita para processamento

statusstring

Status do processamento.

refstring

Referência do DPS.

protocolostring

Protocolo de recebimento do DPS.

Example response

{
  "status": "processando_autorizacao"
}