Skip to main content
Version: Latest

Solicitud de recogida

Se realiza la solicitud de recogida

Request 🚀​

url​

https://app.aveonline.co/api/nal/v1.0/generarGuiaTransporteNacional.php

Method​

POST

Content-Type: application/json

Params JSON​

  • tipo* String Enrutador de la API, "generarRecogida2"
  • token* String Token recibido en la Autenticación con vigencia de una hora
  • idempresa* Number Identificador del usuario dentro de AVEONLINE, se obtiene en la Autenticación
  • idagente* String Agente asociado a la cuenta del usuario, se obtiene del Listado de agentes
  • guias* Array Object -> [{}] Numero identificador de la guia dado en la Generacion de guias
  • dscom* String Comentario sobre la solicitud

Ejemplo​

{
  "tipo": "generarRecogida2",
  "token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzZXNzaW9uIjo4NDExNCwiZXhwIjoxNjIxNTI5NzE5LCJhcHJvYmFkb3MiOls2MDc3XX0.x1Pt9-8UKhC9H3K8vG66bPHuhJtviwj9qZF5xu61JM3k",
  "idempresa": "15289",
  "idagente": "10535",
  "guias": ["532806107", "325529071"],
  "dscom": "ES UNA PRUEBA NO VENIR"
}

Response 📄​

Success​

  • respuestasRecogida String
    • horaInicial String Hora rango inicial en la que la transportadora realiza la recogida
    • horaFinal String Hora rango final en la que la transportadora realiza la recogida
    • status String Estado del resultado
    • message String Mensaje de respuesta sobre el estado de la solicitud
    • details Array Object -> [{}]
      • codigo String Identificador del estado
      • mensaje String Mensaje detallado sobre el proceso
      • codigoRecogida String
      • numeroRecogidaInterna String Identificador interno de la transportadora sobre la recogida
      • numeroRecogidaTransportadora String Aclaraciones de la tranportadora
    • guias Array Object -> [{}] Numero identificador de las guias

Ejemplo​

{
  "respuestasRecogida": [
    {
      "horaInicial": "1:00",
      "horaFinal": "3:00",
      "status": "ok",
      "message": "se genero correctamente",
      "details": {
        "codigo": "0",
        "mensaje": "Recogida Generada",
        "codigoRecogida": "0",
        "numeroRecogidaInterna": "6077180028",
        "numeroRecogidaTransportadora": "Mensaje: Debe haber mínimo una hora de diferencia entre la franja inicial y final. (Tipo: System.Exception) Stack Trace    at DALIntegracionSION.OracleDB.grabarSolicitudDeRecogida(SolicitudRecogida pSolicitudRecogida) in C:\\TCC_00\\Ktalogs_Dev\\WSNET\\2-Desarrollo\\3-Servicios\\DALIntegracionSION\\Sps.vb:line 364\n   at ClasesRecogida.clsServiciosRecogida.SolicitarRecogida(clsSolicitudRecogida& Solicitud, Int32& respuesta, String& mensaje) in C:\\TCC_00\\Ktalogs_Dev\\WSNET\\2-Desarrollo\\3-Servicios\\ClasesRecogida\\clsServiciosRecogida.vb:line 100"
      },
      "guias": ["325529071", "532806107"]
    }
  ]
}

Error​

No se encuentran datos asociados​

{

  "status": "error",
  "message": "ocurrio un error al devolver el resultado"
}

ID de agente no corresponde​

{

  "status": "error",
  "message": "no se encontró el agente"
}

Faltan campos requeridos​

{

  "status": "error",
  "message": "los campos no pueden estar vacios"
}

Credenciales incorrectas o token expirado​

{
  "status": "error",
  "message": "credenciales incorrectas"
}