Skip to main content
Version: Latest

Editar pedido

Permite editar un pedido en AveCRM. Si no pasa el operador logístico, se calcular el envío de manera automática.

Request 🚀​

url​

https://app.aveonline.co/avestock/api/editOrder.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
  • orderId* Number Identificador de la orden
  • 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
    • ivaValue Number Valor IVA 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
    • 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 costo del transporte (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
  • noEditarEnvio Number Permite editar o no el envio asociado al pedido (1=SI)
  • revisarCE Number Permite no editar 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

Ejemplo​

{
  "empresa": "6077",
  "tipo": "authave",
  "token": "",
  "numeropedidoExterno": "",
  "bodegaName": null,
  "orderId": "6077276267451",
  "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",
  "noEditarEnvio": "",
  "revisarCE": "",
  "obs": "",
  "pagado": false
}

Response 📄​

Success​

  • success Bolean Respuesta del servidor
  • message String Respuesta del servidor en modo texto
  • data Object -> {}
    • 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
    • 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 -> [{}]
      • 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,
  "messages": "Orden actualizada correctamente.",
  "status": 200,
  "data": {
    "valortransporte": 19782,
    "diasEntrega": 3,
    "operador": "DOMINA",
    "kilosenvios": 2,
    "bodegaContact": "Bodega principal Centro",
    "bodegaId": "89000000",
    "bodegaTel": "234000000",
    "bodegaDir": "Calle 49 sur 43A 167 Bodega 103 Tolentino",
    "bodegaEmail": "desarrollo2@aveonline.co",
    "bodega_usuario": null,
    "bodega_id": "5",
    "bodegaOrigen": "BARRANQUILLA(ATLANTICO)",
    "dataoperadores": [
      [
        {
          "status": 1,
          "message": "Datos recibidos",
          "flete": 13500,
          "variable": 0,
          "comision": 6282,
          "total": 19782,
          "campo": 1026,
          "transportadora": "DOMINA",
          "diasentrega": 3,
          "stringdata": "numbererror=-0-|dataerror=|codigotransportadora=1026|transportadora=Domina|logotransportadora=https://app.aveonline.co/app/temas/imagen_transpo/095828-1-LogoDomina.png|logotransportadora2=https://app.aveonline.co/app/temas/imagen_transpo/024725-2-095828-1-LogoDomina.png|origen=BARRANQUILLA(ATLANTICO)|destino=ENVIGADO(ANTIOQUIA)|unidades=1|kilosacobrar=2|pesovolumen=0|valoracion=20000|porvaloracion=0.5|trayecto=Nacional|codtrayecto=96|tipoenvio=Mensajeria|fletexkilo=13500|fletexund=13500|fletetotal=13500|diasentrega=3|flete=13500|costomanejo=0|valortotal=13500|valorotros=6282|grantotal=19782|codmostrartransportadora=1026|topemaximo=2000000|dscontraentrega=0|alto=0|largo=0|ancho=0",
          "bodegaContact": "Bodega principal Centro",
          "bodegaId": "89000000",
          "bodegaTel": "234000000",
          "bodegaDir": "Calle 49 sur 43A 167 Bodega 103 Tolentino",
          "bodegaEmail": "desarrollo2@aveonline.co",
          "bodega_usuario": "2",
          "bodega_id": "5",
          "bodegaOrigen": "BARRANQUILLA(ATLANTICO)"
        }
      ]
    ]
  }
}

Validaciones de los campos de la orden.​

{
  "success": false,
  "messages": "El campo identificador del pedido es requerido. y (2) errores en total.",
  "status": 422,
  "errors": [
    {
      "title": "El campo orderId no es válido.",
      "detail": "El campo identificador del pedido es requerido.",
      "source": {
        "pointer": "/orderId"
      }
    },
    {
      "title": "El campo idAgente no es válido.",
      "detail": "El campo identificador del agente o canal de venta es requerido.",
      "source": {
        "pointer": "/idAgente"
      }
    }
  ]
}

No se encuentra el pedido​

{
  "success": false,
  "messages": "El pedido con el identificador: 0000 no se ha encontrado.",
  "status": 404
}

Ya existe una guía asociada al pedido.​

{
  "success": false,
  "messages": "No es posible modificar el pedido, ya existe una guia asociada",
  "status": 400
}

No se encuentra la referencia del producto​

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

Se encuentra la referencia del producto pero no tiene inventario​

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

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

{
  "success": false,
  "messages": "El producto con referencia: {0000000 no tiene suficiente inventario.",
  "status": 400
}

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"
}