Generación de guía

Se realiza el proceso de generacion de guía

Request 🚀

url

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

Method

POST

Header

Content-Type: application/json

Params JSON

• tipo* String Enrutador de la API, "generarGuia2"
• 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
• codigo* String Usuario de ingreso a la plataforma
• dsclavex* String Contraseña de ingreso a la plataforma
• plugin* String
• origen* String Ciudad de origen o codigo DANE correspondiente, se obtiene del Listado de ciudades
• dsdirre* String Dirección del remitente
• dsbarrioo String Barrio del remitente
• destino* String Ciudad de destino o codigo DANE correspondiente, se obtiene del Listado de ciudades
• dsdir* String Direccion del destinatario
• dsbarrio String Barrio del destinatario
• dsnitre* String Nit, cédula o documento de identidad del remitente
• dstelre* String Número de teléfono del remitente
• dscelularre* String Número de celular del remitente
• dscorreopre* String Correo electrónico del remitente
• dsnit* String Nit, cédula o documento de identidad del destinatario
• dsnombre* String Nombre del remitente
• dsnombrecompleto* String Nombre completo del destinatario
• dscorreop* String Correo electrónico del destinatario
• dstel* String Número de teléfono del destinatario
• dscelular* String Número de celular del destinatario
• idtransportador* String Identificador de la transportadora procedente del Listado de operadores logísticos o de la Cotización
• unidades* Number Unidades de empaque
• productos* Array Object -> [{}]
  • alto String Dimensión de alto del producto
  • largo String Dimensión de largo del producto
  • ancho String Dimensión de ancho del producto
  • peso* String Peso del producto
  • unidades* Number Cantidad de productos con estas mismas características
  • nombre* String Descripción del producto
  • valorDeclarado* String Costo de la mercancia, de cada producto
• dscontenido* String Lo que contienen los paquetes
• dscom* String Comentarios adicionales
• idasumecosto* Number Si el cliente asume el costo del servicio de recaudo: 1. Si no: 0
• contraentrega* Number Si el cliente asume el costo del envio: 1. Si no: 0
• valorrecaudo* Number Valor que se requiere recaudar
• idagente* String Agente asociado a la cuenta del usuario, se obtiene del Listado de agentes
• dsreferencia String Referencias adicionales
• dsordendecompra String Identificador que agrupa una cantidad determinada de guias relacionadas a una orden de compra
• bloquegenerarguia* String Si desea generar la guia: 1. Si no: 0
• relacion_envios* String Si se va a realizar relación de envío de la guía generada: 1. Si no: 0
• enviarcorreos* String Si desea enviar correo sobre con la informacion del envio: 1. Si no: 0
• cartaporte String Boomerang. Si la guia es de ida y regreso: 1
• valorMinimo Number Para asignar la valoracion minima ($1.000) a la unidad de empaque: 1. Para asignar la suma de valores declarados de cada producto: 0
• numeroFactura String Es el numero de la factura que se va a asociar a esta guia
• numeroBolsa String numero de bolsa, para el caso de la transportadora TCC

Ejemplo

{
  "tipo": "generarGuia2",
  "token": "iewruJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzZXNzaW9uIjo5MDU4OSwiZXhwIjoxNjIyNzQ3MDUyLCJhcHJvYmFkb3MiOls2MDc3XX0.hbYPRcsGe-T2YWQMxeUpIz_-iBNgeYs4cXysrxrmSBo",
  "idempresa": "15289",
  "codigo": "demo",
  "dsclavex": "Webservices",
  "origen": "MEDELLIN(ANTIOQUIA)",
  "dsdirre": "Cr 41 A # 6 S-93 - Av  El Poblado",
  "dsbarrioo": "",
  "destino": "MEDELLIN(ANTIOQUIA)",
  "dsdir": "Calle 49 sur 43 A 167 Bodega 103",
  "dsbarrio": "",
  "dsnitre": "9018329132",
  "dstelre": "3146622696",
  "dscelularre": "3146622696",
  "dscorreopre": "desarrollo@aveonline.co",
  "dsnit": "00000",
  "dsnombre": "prueba plugin",
  "dsnombrecompleto": "prueba plugin prueba plugin",
  "dscorreop": "desarrollo@aveonline.co",
  "dstel": "8298338",
  "dscelular": "3023723917",
  "idtransportador": "33",
  "unidades": 1,
  "productos": [
    {
      "alto": "10",
      "largo": "10",
      "ancho": "10",
      "peso": "1",
      "unidades": 2,
      "nombre": "Ritual Quererte",
      "ref": "",
      "valorDeclarado": "46000"
    }
  ],
  "dscontenido": "Ritual Quererte,",
  "dscom": "",
  "idasumecosto": 0,
  "contraentrega": 0,
  "valorrecaudo": 20000,
  "idagente": "10535",
  "dsreferencia": "",
  "dsordendecompra": "",
  "bloquegenerarguia": "1",
  "relacion_envios": "1",
  "enviarcorreos": "1",
  "cartaporte": "",
  "valorMinimo": 0,
  "numeroFactura": "5501",
  "numeroBolsa": "244"
}

Response 📄

Success

• status String Estado del resultado
• message String Mensaje de respuesta
• resultado Array Object -> [{}]
  • guia Array Object -> [{}]
    • codigo String En caso de error devuelve el codigo identificador
    • mensaje String Mensaje devuelto por la transportadora
    • numguia Number Numero identificador de la guia generada
    • rutaguia String URL que contiene la guia para imprimir
    • archivoguia String Contiene el codigo de generación del archivo de impresión
    • rotulo String Contiene el rótulo de impresión
    • archivorotulo String Contiene el codigo de generación del rótulo de impresión
    • rotulozebra String Contiene el rótulo zebra de impresión
    • archivorotulozebra String Contiene el codigo de generación del rótulo zebra de impresión
    • tranpostadora String Nombre de la transportadora

Ejemplo

{
  "status": "ok",
  "message": "proceso correcto",
  "resultado": {
    "guia": {
      "codigo": "0",
      "mensaje": "Guia 21027846356 Generada",
      "numguia": 21027846356,
      "rutaguia": "https://aveonline.co/app/modulos/paqueteo/imprimir.guia.servientrega.php?idtransportadorx=33&guia=2102474356",
      "archivoguia": "000",
      "rotulo": "https://aveonline.co/app/modulos/paqueteo/imprimir.rotulo.beta.php?pkid=1779251&dsconsec=2102474356&idagente=1055&idexp=6077&codagente=&idcliente=79823&idremitente=0&imprimir=1&idempresa=6077&idtransportador=33",
      "archivorotulo": "JVBERi0xLjQKJeLj4567890iuygfgvbhjkio876tfghjui8786tgfhjui8786tygIC9QYWdlCi9QYXJlbnQgMSAwIFIKL01lZGlh\r\nQm94IFswIDAgNjEyLjAwMCA3OTIuMDAwXQovVHJpbUJveCBbMC4wMDAgMC4wMDAgNjEyLjAwMCA3\r\nOTIuMDAwXQovUmVzb3VyY2VzIDIgMCBSCi9yAwMDAwMCBuIAowMDAwMDE3MjM1IDAwMDAwIG4gCjAwMDAwMTc2MzEgMDAw\r\nMDAgbiAKMDAwMDAyOTg4MSAwMDAwMCBuIAowMDAwMDM1MTY4IDAwMDAwIG4gCjAwMDAwMzUzNTYg\r\nMDAwMDAgbiAKdHJhaWxlcgo8PAovU2l6ZSAyMwovUm9vdCAyMiAwIFIKL0luZm8gMjEgMCBSCi9J\r\nRCBbPDQ2MTA4ZDdkYjdiMjEyNWQ3MTI5MWZkMmFhMjVmZDk2PiA8NDYxMDhkN2RiN2IyMTI1ZDcx\r\nMjkxZmQyYWEyNWZkOTY+XQo+PgpzdGFydHhyZWYKMzU1MDYKJSVFT0Y=\r\n",
      "rotulozebra": "00",
      "archivorotulozebra": "00",
      "transportadora": "SERVIENTREGA"
    }
  }
}

Error

Productos= 0

{
  "status": "error",
  "message": "no se encontraron productos"
}

Credenciales incorrectas o token expirado

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

No se encuentran datos asociados

{
  "status": "error",
  "message": "se produjo un error al momento de iniciar la comunicacion"
}