Incluir Condutor

POST/v1/mdfe/{id}/inclusao-condutor

Inclui um condutor adicional no MDF-e (evento 110114), além do(s) condutor(es) já informado(s) na emissão. Útil quando o motorista responsável pelo veículo muda ao longo do percurso.

Só se aplica a documentos com mod 58 (MDF-e) que já estejam AUTORIZADA e ainda não tenham sido encerrados.

Esse é um evento síncrono — a resposta HTTP já traz o resultado da SEFAZ, sem necessidade de polling.

Parâmetros do corpo

nomestringobrigatório

Nome completo do condutor.

cpfstringobrigatório

CPF do condutor (somente dígitos).

Resposta

200 OK

statusstring

Valores aceitos: incluido | erro_inclusao

Resultado da inclusão junto à SEFAZ.

status_sefazstring

Código de status retornado pela SEFAZ (cStat).

mensagem_sefazstring

Mensagem retornada pela SEFAZ (xMotivo).

caminho_xmlstring

URL pública do XML do evento, quando autorizado.

cURL

curl -X POST https://app.nfe.tenzanlabs.com/v1/mdfe/35f0a1b2-.../inclusao-condutor \
  -H "X-Access-Key: nfe_access_SUA_CHAVE_DE_ACESSO_AQUI" \
  -H "Authorization: Bearer nfe_test_SUA_CHAVE_AQUI" \
  -H "Content-Type: application/json" \
  -d '{
    "nome": "João da Silva",
    "cpf": "12345678900"
  }'

Node.js

const resposta = await client.mdfeAddDriver(invoiceId, {
  nome: 'João da Silva',
  cpf: '12345678900',
});
console.log(resposta.status); // 'incluido'

Python

resposta = client.mdfe_add_driver(invoice_id, {
    "nome": "João da Silva",
    "cpf": "12345678900",
})
print(resposta["status"])  # 'incluido'

Java

MdfeAddDriverData data = new MdfeAddDriverData();
data.nome = "João da Silva";
data.cpf = "12345678900";

SyncEventResponse resposta = client.mdfeAddDriver(invoiceId, data);
System.out.println(resposta.status); // "incluido"

Exemplo de resposta

{
  "status": "incluido",
  "status_sefaz": "135",
  "mensagem_sefaz": "Evento registrado e vinculado ao MDF-e",
  "caminho_xml": "https://storage.../evento-inclusao-condutor.xml"
}