Listar Pedidos

Listado de los pedidos en aveCRM. Si no se pasa parámetros de busqueda se filtran los ultimos 50 pedidos

Request 🚀

url

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

Method

POST

Header

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
• fechaini Date Fecha inicial de consulta. Formato AAAA-MM-DD
• fechafin Date Fecha final de consulta. Formato AAAA-MM-DD
• param String Parametro para buscar por numero de pedido o numero de pedido Externo
• trazabilidad String Parametro que activa la trazabilidad de la ultima guia asociada al pedido. (1)SI,2=NO). Por defecto no viene activado

Ejemplo

{
  "tipo": "authave",
  "token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJzZXNzaW9uIjoxMTY5MDYsImV4cCI6MTYyNTYwMzA2MCwiYXByb2JhZG9zIjpbMTUyODldfQ.QjLQUri4XrArwIDFL1dTr2aQdKv6WgKiTBj25qJkaLM",
  "empresa": 6077,
  "fechaini": "2023-09-25",
  "fechafin": "2023-09-25",
  "param": "",
  "trazabilidad": "1"
}

Response 📄

Success

• status Number Respuesta del servidor numérica
• message String Respuesta del servidor en modo texto
• items Array Object -> [{}]
  • pedido Number Código de pedido AveCRM
  • numeropedidoexterno String Codigo de pedido externo
  • fechacreacion Date Fecha de creación del pedido
  • cliente String Nombre del cliente
  • identificacioncliente String Identificación del cliente
  • direccioncliente String Dirección del cliente
  • telefonocliente String Teléfono del cliente
  • correocliente String Correo del cliente
  • ciudaddestinocliente String Ciudad destino del pedido
  • descuentos String Valor descuentos de la compra
  • valor String Valor compra
  • valortransporte String Valor transporte
  • valorrecaudo String Valor del recaudo
  • pagaclientetransporte String El cliente paga el transporte
  • asumecostorecaudo String El cliente asume el costo de recaudo
  • tipopedido String Tipo de pedido generado. Propio o DP
  • vendedor_bodega String Vendedor Externo o bodega
  • estadopedido String Estado del pedido
  • estadopagado String Estado del pedido pagado
  • numeroenvio String Numero de guía del envío del pedido
  • estadoenvio String Estado actual del envío
  • operadorenvio String Operador logistico asociado al envío
  • fechaconsultaenvio String Fecha última del estado del envío
  • impresionguiaenvio String Ruta para imprimir la guía del pedido
  • rotuloguiaenvio String Ruta para imprimir el rótulo de envío del pedido
  • detalle_pedido Array Object -> [{}]
    • referencia String Referencia del producto
    • productId Number Codigo interno del producto
    • producto String Nombre del producto
    • cantidad String Unidades solicitadas del producto
    • valor Number Valor del producto
    • iva Number Porcentaje de impuesto
    • total Number Total del detalle del producto
    • peso Number Peso del producto
    • volumen Number Volumen del producto
  • novedades Array Object -> [{}]
    • guia Array Object -> [{}]
      • guia String Guia con novedad
      • estadonovedad Number Codigo de la novedad
      • fechanovedad String Fecha de la novedad
      • obsnovedad String Descripcion de la novedad
  • trazabilidad Array Object -> [{}]
    • guia String Guia
    • fecha String Fecha del estado
    • estado String Estado
    • observacion String Descripcion adicional del movimiento de estado

Ejemplo

{
  "status": "ok",
  "mensaje": "registros encontrados",
  "items": [
      {
        "pedido": "607725336812",
        "numeropedidoexterno": "",
        "fechacreacion": "2023-09-25 14:48:25",
        "cliente": "nombre prueba",
        "identificacioncliente": "78000000",
        "direccioncliente": "DIRECCION DE PRUEBA DE CLIENTE",
        "telefonocliente": "2340000000",
        "correocliente": "prueba@prueba.com",
        "ciudaddestinocliente": "BOGOTA(CUNDINAMARCA)",
        "valor": "1300334",
        "valortransporte": "39408",
        "valorrecaudo": "0",
        "pagaclientetransporte": "NO",
        "asumecostorecaudo": "NO",
        "tipopedido": "DP",
        "vendedor_bodega": "Vendedor",
        "estadopedido": "Solicitada",
        "numeroenvio": null,
        "estadoenvio": null,
        "estadopagado": null,
        "operadorenvio": null,
        "fechaconsultaenvio": null,
        "impresionguiaenvio": null,
        "rotuloguiaenvio": null   ,
         "detalle_pedido": [
                {
                    "referencia": "44182147563670",
                    "productId": "43417",
                    "producto": "AMAZONAS MADERA Negro",
                    "cantidad": "1",
                    "valor": "115000",
                    "iva": "0",
                    "total": "115000",
                    "peso": "0.5",
                    "volumen": "0"
                }
            ],
           "novedades": {
                "240044525686": {
                    "guia": "240044525686",
                    "estadonovedad": null,
                    "idestadonovedad": null,
                    "fechanovedad": null,
                    "obsnovedad": null
                }
            },  
          "trazabilidad": [
                {
                    "guia": "240044525686",
                    "fecha": "21/01/2026 11:16:05",
                    "estado": "Reparto",
                    "observacion": "Reparto"
                },
                {
                    "guia": "240044525686",
                    "fecha": "20/01/2026 22:33:26",
                    "estado": "Centro acopio",
                    "observacion": "Centro acopio"
                },
                {
                    "guia": "240044525686",
                    "fecha": "20/01/2026 18:48:38",
                    "estado": "Admitida",
                    "observacion": "Admitida"
                }
            ]   
      }
  ]
}

No se encuentran datos asociados

{
  "estatus": "Datos no encontrados",
  "mensaje": "registros no encontrados",
  "items": []
}

Credenciales incorrectas o token expirado

{
  "status": "error",
  "mensaje": "Credenciales invalidas o el cliente se encuentra inactivo"
}