Skip to main content
Version: Latest

Generar pedido

Permite generar un pedido en AveCRM. Recuerde que los productos deben estar previamente registrados en el sistema. Si no pasa el operador logístico, se calcular el envío de manera automática.

Request 🚀​

url​

https://app.aveonline.co/avestock/api/createOrder.php

Method​

POST

Content-Type: application/json

Params JSON​

  • tipo* String Enrutador de la API, "authave"
  • token* String Token recibido en la Autenticación con vigencia de una hora
  • empresa* Number Identificador de la empresa dentro de AVEONLINE, se obtiene en la Autenticación
  • bodegaName Number Identificador de la bodega desde donde hará el pedido y se realizará el envío Listar Bodegas
  • idAgente* Number Identificador del canal de venta o agente Listado de canales de ventas o agentes
  • numeropedidoExterno String Numero de pedido asociado a una tienda, POS, ERP, etc. Se usa para las búsquedas en listar pedidos
  • items Array Object -> [{}]
  • productRef* String Codigo referencia del producto Listar productos
  • rateValue Number Valor unitario del producto. Si no se pasa se carga el que esta asociado en listarProductos
  • rateValue Number Valor unitario del producto. Si no se pasa se carga el que esta asociado en listarProductos
  • quantity* Number Cantidad del producto
  • peso Number Peso unitario (Kg) del producto. Si no se pasa se carga el que esta asociado en listarProductos
  • vol Number Volumen del producto. Si no se pasa se carga el que esta asociado en listarProductos
  • descuentoValue Number Valor descuento del producto.
  • descuento Float Porcentaje de descuento (00.00).
  • numerodescuento Number Descuento en valor.
  • declarado Number Valor declarado unitario del producto. Si no se pasa se carga el que esta asociado en listarProductos
  • totalValue Number Valor total del producto. Si no se pasa se carga el que esta asociado en listarProductos
  • subTotalValue Number Subtotal antes de impuestos. Si no se pasa se calcula en el sistema
  • vatValue Number subtotal de impuestos. Si no se pasa se calcula en el sistema
  • totalAmountValue Number valor total del pedido. Si no se pasa se calcula en el sistema
  • grandTotalValue Number valor total del pedido. Igual a totalAmountValue. Si no se pasa se calcula en el sistema
  • grandTotalVol Number total volumen. Si no se pasa se calcula en el sistema
  • grandTotalPeso Number total peso. Si no se pasa se calcula en el sistema
  • grandTotalUnit Number total unidades. Si no se pasa se calcula en el sistema
  • grandTotalDeclarado Number total valor declarado. Si no se pasa se calcula en el sistema
  • grandTotalDeclaradoValue Number total valor declarado. Igual a grandTotalDeclarado. Si no se pasa se calcula en el sistema
  • paymentCliente* Number Activar si el cliente del pedido pagará el pedido (1=SI,2=NO)
  • recaudo* Number Valor a recaudar del pedido
  • recaudoValue* Number Valor recaudar. Igual a recaudo
  • paymentAsumecosto* Number Activar si el cliente del pedido asumirá el costo del recaudo (1=SI,2=NO)
  • clientDestino* String Ciudad de destino correspondiente, se obtiene del Listado de ciudades
  • valorEnvio Number Valor del envio que generó la cotizacion del envio
  • valorEnvioValue Number Valor del envío que generó la cotización del envío. Igual a valorEnvioValue
  • cadenaEnvio String Pasar esta variable vacía
  • seloperadorEnvio Number Código del operador seleccionador en la cotización del envío. Si se pasa vacío, se calcula el envío sobre el operador más económico que tenga asociado
  • clientContact* String nombre del destinatario
  • clientId* String identificación del destinatario
  • clientDir String dirección del destinatario
  • clientTel Number teléfono del destinatario
  • clientEmail String correo del destinatario
  • nroFactura String número factura interno
  • plugin* String Identificador del metodo de acceso.Por defecto es aveonline
  • noGenerarEnvio Number Permite generar o no el envio asociado al pedido (1=SI)
  • revisarCE Number Permite no generar el envio porque hay que confirmarlo por ser contraentrega (1=SI)
  • obs String Permite agregar alguna observacion para el envio. Es el que comunmente se llama "dice Contener"
  • pagado Boolean Permite indicar si se hace el pago desde el ecommerce. Por defecto es false
  • enviopropio Boolean Permite indicar si el envio no necesita transporte con los operadores logisticos. Por defecto es false

Ejemplo​

{
  "empresa": "6077",
  "tipo": "authave",
  "token": "",
  "numeropedidoExterno": "",
  "bodegaName": "",
  "idAgente": "10961",
  "items": [
    {
      "productRef": "LI-10",
      "rateValue": "642667",
      "ivaValue": "0",
      "quantity": "1",
      "peso": "6",
      "vol": "0",
      "declarado": "10000",
      "totalValue": "642667"
    },
    {
      "productRef": "ref0004",
      "rateValue": "",
      "ivaValue": "0",
      "quantity": "1",
      "peso": "",
      "vol": "0",
      "declarado": "",
      "totalValue": ""
    }
  ],
  "subTotalValue": "1300334.00",
  "vatValue": "0.00",
  "totalAmountValue": "1300334.00",
  "grandTotalValue": "1300334.00",
  "grandTotalVol": "0.00",
  "grandTotalPeso": "12.00",
  "grandTotalUnit": "2.00",
  "grandTotalDeclarado": "20000.00",
  "grandTotalDeclaradoValue": "20000.00",
  "paymentCliente": "",
  "recaudo": "",
  "recaudoValue": "1300334.00",
  "paymentAsumecosto": "",
  "clientDestino": "BOGOTA(CUNDINAMARCA)",
  "valorEnvio": "39408",
  "valorEnvioValue": "39408",
  "cadenaEnvio": "",
  "seloperadorEnvio": "29",
  "clientContact": "nombre prueba",
  "clientId": "78000000",
  "clientDir": "DIRECCION DE PRUEBA DE CLIENTE",
  "clientTel": "2340000000",
  "clientEmail": "prueba@prueba.com",
  "nroFactura": "",
  "plugin": "avenline",
  "noGenerarEnvio": "",
  "revisarCE": "",
  "obs": "",
  "pagado": false,
  "enviopropio": false

}

Response 📄​

Success​

  • success Bolean Respuesta del servidor
  • order_id Number Numero de la orden de pedido generada en el sistema
  • message String Respuesta del servidor en modo texto
  • valortransporte Number Valor estimado de transportadora. Este valor puede cambiar si en confirmar pedido se cambia de operador
  • diasEntrega Number Días de entrega estimados por el operador seleccionado.
  • kilosenvios Number Peso (Kg) con el que se calcula los costos de transporte en el del pedido.
  • operador String Operador seleccionado. El operado puede cambiar si en confirmar pedido se cambia de operador. Si enviopropio esa en true, esta opcion aparece vacia.
  • bodegaContact String Nombre bodega seleccionada
  • bodegaId Number Nit bodega seleccionada
  • bodegaTel String Teléfono bodega seleccionada
  • bodegaDir String Dirección bodega seleccionada
  • bodegaEmail String Correo electrónico bodega seleccionada
  • bodega_usuario Number Codigo usuario asociado a bodega seleccionada
  • bodega_id Number Codigo bodega seleccionada
  • bodegaOrigen String Ciudad origen de bodega seleccionada
  • dataoperadores Array Object -> [{}]. Si enviopropio esta en true esta opcion se encuentra vacia
    • status Number Estado de respuesta
    • message String Respuesta del servidor en modo texto
    • flete Number Valor flete operador
    • variable Number Costo manejo operador
    • comision Number Costo recaudo operador
    • total Number Valor total del operador
    • campo Number Codigo del operador
    • transportadora String Nombre del operador
    • diasentrega Number Días de entrega estimados.
    • stringdata String Cadena de texto con respuesta
    • bodegaContact String Nombre bodega
    • bodegaId Number Nit bodega
    • bodegaTel String Teléfono bodega
    • bodegaDir String Dirección bodega
    • bodegaEmail String Correo electrónico bodega
    • bodega_usuario Number Codigo usuario asociado a bodega
    • bodega_id Number Codigo bodega
    • bodegaOrigen String Ciudad origen de bodega

Ejemplo​

{
  "success": true,
  "order_id": "0000000",
  "messages": "Pedido 0000000 Agregado exitosamente.",
  "valortransporte": 00000,
  "diasEntrega": 3,
  "kilosenvios": 1,
  "operador": "DOMINA",
  "bodegaContact": "",
  "bodegaId": "",
  "bodegaTel": "",
  "bodegaDir": "",
  "bodegaEmail": "",
  "bodega_usuario": "",
  "bodega_id": "",
  "bodegaOrigen": "",
  "databodegas": [
    {
      "bodega_id": "0000",
      "bodega_nombre": "BODEGA PRUEBA",
       "dataoperadores": [
        {
          "status": 1,
          "message": "Datos recibidos",
          "flete": 10820,
          "variable": 0,
          "comision": 1946,
          "total": 12766,
          "campo": 1026,
          "transportadora": "DOMINA",
          "diasentrega": 3,
          "stringdata": "numbererror=-0-|dataerror=|codigotransportadora=1026|transportadora=Domina|logotransportadora={ruta}|logotransportadora2={ruta}|origen=BOGOTA(CUNDINAMARCA)|destino=CALI(VALLE DEL CAUCA)|unidades=1|kilosacobrar=1|pesovolumen=0|valoracion=44950|porvaloracion=0.5|trayecto=Nacional|codtrayecto=96|tipoenvio=Mensajeria|fletexkilo=10820|fletexund=10820|fletetotal=10820|diasentrega=3|flete=10820|costomanejo=0|valortotal=10820|valorotros=1946|grantotal=12766|codmostrartransportadora=1026|topemaximo=0|dscontraentrega=0|alto=0|largo=0|ancho=0",
          "bodegaId": "",
          "bodegaTel": "",
          "bodegaDir": "",
          "bodegaEmail": "",
          "bodega_usuario": "",
          "bodega_id": "",
          "bodegaOrigen": ""
        }
      ],
    }
  ],  
}

Si esta pendiente de confirmar el pedido o no se genera guia de envio​

{
  {
    "success": true,
    "order_id": "0000000",
    "messages": "Pedido 0000000 Agregado exitosamente. No se genera el envío. Lo puede hacer de manera posterior en la opción '<strong>Gestionar pedidos<\/strong> y\/o confirmando el proceso de pedido cuando el cliente asume el costo o se debe recaudar el valor.",
    "valortransporte": 00000,
    "diasEntrega": 3,
    "operador": "DOMINA",
    "bodegaContact": "",
    "bodegaId": "",
    "bodegaTel": "",
    "bodegaDir": "",
    "bodegaEmail": "",
    "bodega_usuario": "",
    "bodega_id": "",
    "bodegaOrigen": "",
    "databodegas": [
        {
          "bodega_id": "0000",
          "bodega_nombre": "BODEGA PRUEBA",
          "dataoperadores": [
            {
                "status": 1,
                "message": "Datos recibidos",
                "flete": 10820,
                "variable": 0,
                "comision": 1946,
                "total": 12766,
                "campo": 1026,
                "transportadora": "DOMINA",
                "stringdata": "numbererror=-0-|dataerror=|codigotransportadora=1026|transportadora=Domina|logotransportadora={ruta}|logotransportadora2={ruta}|origen=BOGOTA(CUNDINAMARCA)|destino=CALI(VALLE DEL CAUCA)|unidades=1|kilosacobrar=1|pesovolumen=0|valoracion=44950|porvaloracion=0.5|trayecto=Nacional|codtrayecto=96|tipoenvio=Mensajeria|fletexkilo=10820|fletexund=10820|fletetotal=10820|diasentrega=3|flete=10820|costomanejo=0|valortotal=10820|valorotros=1946|grantotal=12766|codmostrartransportadora=1026|topemaximo=0|dscontraentrega=0|alto=0|largo=0|ancho=0",
                "bodegaContact": "",
                "bodegaId": "",
                "bodegaTel": "",
                "bodegaDir": "",
                "bodegaEmail": "",
                "bodega_usuario": "",
                "bodega_id": "",
                "bodegaOrigen": "",

            }
         ],
      }
    ],  
  }
}

No se encuentra la referencia del producto​

{
   {
    "success": false,
    "order_id": "",
    "messages": "El producto referencia 00000 no se encuentra en el inventario"
  }
}

Se encuentra la referencia del producto pero no tiene inventario​

{
   {
    "success": false,
    "order_id": "",
    "messages": "El producto referencia 0000000 no posee unidades disponibles en el inventario."
  }
}

Si el total de unidades solicitadas no estan disponibles en el inventario​

{
   {
    "success": false,
    "order_id": "",
    "messages": "El total de las unidades solicitadas no estan disponibles en los inventarios"
  }
}

La bodega no existe​

{
   {
    "success": false,
    "order_id": "",
    "messages": "La bodega codigo 000000 no corresponde a la empresa"
  }
}

El pedido ya fue registrado anteriormente con el mismo número de pedido externo​

{
   {
    "success": false,
    "messages": "Pedido generado previamente con el numero de pedido externo: Orden 16100"
  }
}