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

Ejemplo

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

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 -> [{}]
    • 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

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": [
                {
                    "producto": "rosa azul",
                    "cantidad": "1",
                    "valor": "50000",
                    "iva": "0",
                    "total": "50000"
                }
            ]
      }
  ]
}

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