Criar uma viagem por MDF-e

A criação de uma viagem é o ponto central de toda a integração, consolidando todos os dados necessários para o processo logístico em um único fluxo.

Necessáriamente a integração com os documentos fiscais são realizadas em duas etapas, onde:

• Primeiro ocorre o envio da viagem (MDF-e);
• Segundo ocorre o envio das entregas ( CT-es ou NF-es) vinculadas ao MDF-e;

informação

Necessáriamente deve ser integrados todos os documentos relacionados no MDF-e, caso falte um, a viagem não será disponibilizada.

Envio do MDF-e

Exemplo de requisição

• Método: POST
• URL: [URL_BASE]/api/Recepcoes/MDFe

Cabeçalhos

Content-Type: application/json
Authorization: Bearer {accessToken}

Corpo

informação

o XML utilizado precisa necessáriamente ser o <mdfeProc> - autorizado pela SEFAZ

{
  "documento": "string"
}

informação

Após o envio do MDF-e, o sistema irá aguardar o envio dos XML's dos documentos (CT-es ou NF-es) vinculados ao MDF-e.

Retorno do envio da viagem

Sucesso: Caso o status seja success, o MDF-e irá aguardar o envio dos XML's (CT-es ou NF-es) dos documentos vinculados para disponibilizar a viagem no portal web e no aplicativo do motorista.

Erros: O status error indica que o MDF-e não foi registrado. Nesse caso, você deve corrigir os erros listados e reenviar os dados.

​

Envio de CT-e

Exemplo de requisição

• Método: POST
• URL: [URL_BASE]/api/Recepcoes/CTe

Cabeçalhos

Content-Type: application/json
Authorization: Bearer {accessToken}

Corpo

{
  "documento": "string",
  "token": "string"
}

Envio de NF-e

Exemplo de requisição

• Método: POST
• URL: [URL_BASE]/api/Recepcoes/NFe

Cabeçalhos

Content-Type: application/json
Authorization: Bearer {accessToken}

Corpo

{
  "documento": "string",
  "token": "string"
}

Retorno do envio da viagem

Sucesso: Caso o status seja success, e se foi enviados todos os documentos vinculados ao MDF-e a viagem será disponibilizada no portal web e no aplicativo do motorista. Erros: O status error indica que o documento não foi registrado. Nesse caso, você deve corrigir os erros listados e reenviar os dados.

Boas Práticas

Dica

Validar os dados antes do envio: Utilize a documentação para garantir que todos os campos obrigatórios estejam preenchidos.