Consultas

A API do NDD Move disponibiliza endpoints para facilitar a integração e consulta de dados relacionados a viagens, entregas e coletas. Abaixo estão os endpoints disponíveis, suas funções e especificações:

Viagem

Endpoint	Método	Descrição
/api/Viagem	GET	Modificações parciais em um recurso existente
/api/Viagem/chave/chaveMDFe	GET	Cria recursos
/api/Viagem/numero/numeroManifesto	GET	Exclui recursos

Rastreamento

Endpoint	Método	Descrição
/api/Rastreios/chaveAcessoMdfe	GET	Retorna dados de rastreio do motorista a partir de uma chave de MDFe
/api/Viagem/chave/chaveMDFe	GET	Retorna dados de rastreio do motorista a partir de um numero de Romaneio

Emissões de CO²

Endpoint	Método	Descrição
/api/Viagem/emissoesCo2	GET	Retorna dados de rastreio do motorista a partir de uma chave de MDFe

Entregas

Endpoint	Método	Descrição
/api/NFes/Entrega/chaveNFe	GET	Retorna dados de entregas a partir de uma chave de NF-e
/api/Entrega/chaveMDFe/chaveCTe	GET	Retorna dados de entregas a partir de uma chave de MDF-e e CT-e
/api/Comprovantes/chaveMDFe/chaveCTe	GET	Retorna dados da prova de entrega (POD) através de uma chave de MDF-e e CT-e

A seguir, um exemplo de como realizar uma requisição utilizando o endpoint /api/Viagem para obter todas as viagens:

Exemplo de requisição

• Método: GET
• URL: [URL_BASE]/api/viagem

Cabeçalhos:

Content-Type: application/json
Authorization: Bearer <nosso_token_de_acesso>

Corpo

{
    "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "placaVeiculo": "string",
    "ultimaModificacao": "2025-01-29T12:42:05.145Z",
    "emitente": "string",
    "emitenteCnpj": "string",
    "numeroMDFe": "string",
    "chaveAcessoMDFe": "string",
    "qrCodeMDFe": "string",
    "tipoLogistico": 0,
    "statusViagem": 0,
    "documentos": [
      {
        "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "statusEntrega": 0,
        "numeroCTe": "string",
        "viagemId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "emitente": "string",
        "emitenteCnpj": "string",
        "chaveAcessoCTe": "string",
        "destinatario": "string",
        "remetente": "string",
        "documentosNFes": [
          {
            "chaveAcesso": "string",
            "numero": "string"
          }
        ]
      }
    ],
    "motoristas": [
      {
        "nome": "string",
        "cpf": "string",
        "tipoViagemMotorista": 0
      }
    ]
  } 

Resposta esperada (em caso de sucesso):

HTTP/1.1 200 OK

Resposta esperada (em caso de erro):

HTTP/1.1 400 Bad Request
Content-Type: application/json

{
  "error": "Invalid payload format"
}