Obtener Órdenes Canceladas

curl -X GET "https://beta.api-iobot-desarrollo.com/estadisticas/obtener/ordersCanceled/92?startDate=2026-08-01&endDate=2026-08-31&type=wa&cancelReason=inactividad&page=1&limit=10" \
  -H "x-api-key: TU_APP_KEY"

Método:  GET
URL:     https://beta.api-iobot-desarrollo.com/estadisticas/obtener/ordersCanceled/92

Query Params
  startDate     2026-08-01
  endDate       2026-08-31
  type          wa
  cancelReason  inactividad
  page          1
  limit         10

Headers
  x-api-key     TU_APP_KEY

{
  "success": true,
  "data": [
    {
      "id": 272992,
      "status": 5,
      "shipment_method": "delivery",
      "payment_method": null,
      "empresa_id": 92,
      "chat_id": 252037,
      "cancel_reason": "(BOT) Cancelada por inactividad en el chat",
      "type": "wa",
      "createdAt": "2026-08-28T23:32:55.000Z",
      "updatedAt": "2026-08-28T23:55:04.000Z",
      "chat": {
        "id": 252037,
        "contacto": {
          "id": 139458,
          "nombre": "Juan Pérez",
          "numero": "50494898989",
          "meta_id": "50494898989"
        }
      }
    }
  ],
  "pagination": {
    "currentPage": 1,
    "totalPages": 6,
    "totalCount": 57,
    "limit": 10,
    "hasNextPage": true,
    "hasPrevPage": false
  }
}

{
  "success": true,
  "data": [],
  "pagination": {
    "currentPage": 1,
    "totalPages": 0,
    "totalCount": 0,
    "limit": 10,
    "hasNextPage": false,
    "hasPrevPage": false
  }
}

{
  "message": "Invalid API key"
}

{
  "success": false,
  "message": "Hubo un error en el servidor",
  "error": "..."
}

GET

estadisticas

obtener

ordersCanceled

{empresa_id}

curl -X GET "https://beta.api-iobot-desarrollo.com/estadisticas/obtener/ordersCanceled/92?startDate=2026-08-01&endDate=2026-08-31&type=wa&cancelReason=inactividad&page=1&limit=10" \
  -H "x-api-key: TU_APP_KEY"

Método:  GET
URL:     https://beta.api-iobot-desarrollo.com/estadisticas/obtener/ordersCanceled/92

Query Params
  startDate     2026-08-01
  endDate       2026-08-31
  type          wa
  cancelReason  inactividad
  page          1
  limit         10

Headers
  x-api-key     TU_APP_KEY

{
  "success": true,
  "data": [
    {
      "id": 272992,
      "status": 5,
      "shipment_method": "delivery",
      "payment_method": null,
      "empresa_id": 92,
      "chat_id": 252037,
      "cancel_reason": "(BOT) Cancelada por inactividad en el chat",
      "type": "wa",
      "createdAt": "2026-08-28T23:32:55.000Z",
      "updatedAt": "2026-08-28T23:55:04.000Z",
      "chat": {
        "id": 252037,
        "contacto": {
          "id": 139458,
          "nombre": "Juan Pérez",
          "numero": "50494898989",
          "meta_id": "50494898989"
        }
      }
    }
  ],
  "pagination": {
    "currentPage": 1,
    "totalPages": 6,
    "totalCount": 57,
    "limit": 10,
    "hasNextPage": true,
    "hasPrevPage": false
  }
}

{
  "success": true,
  "data": [],
  "pagination": {
    "currentPage": 1,
    "totalPages": 0,
    "totalCount": 0,
    "limit": 10,
    "hasNextPage": false,
    "hasPrevPage": false
  }
}

{
  "message": "Invalid API key"
}

{
  "success": false,
  "message": "Hubo un error en el servidor",
  "error": "..."
}

Retorna el listado paginado de órdenes con status cancelado (5) de un negocio. Útil para identificar carritos abandonados: filtrando por cancelReason se aíslan las órdenes que el bot canceló por inactividad en el chat, en lugar de cancelaciones manuales o de otro origen.

Autenticación

Requiere el encabezado x-api-key con el App Key del negocio. Consulta Autenticación.

Parámetros de ruta

number

required

ID del negocio cuyas órdenes canceladas se desean obtener.

Parámetros de consulta

string

required

Fecha inicial del rango de creación de la orden, en formato ISO 8601 (2026-08-01 o 2026-08-01T00:00:00Z).

string

required

Fecha final del rango de creación de la orden, en formato ISO 8601.

string

Canal de la orden, por ejemplo wa para WhatsApp.

string

Filtra por coincidencia parcial en el motivo de cancelación (cancel_reason). Usa inactividad para obtener solo los carritos abandonados que el bot cancela automáticamente por falta de respuesta del cliente (cancel_reason: (BOT) Cancelada por inactividad en el chat). Si se omite, se incluyen las órdenes canceladas por cualquier motivo.

number

default:"1"

Página de resultados, empezando en 1.

number

default:"10"

Registros por página.

Comportamiento

Una orden se considera cancelada cuando status es 5, sin importar el motivo — ese es siempre el filtro base.
cancelReason es un filtro adicional opcional (LIKE %valor% sobre cancel_reason); no reemplaza el filtro de status.
Los resultados se ordenan por fecha de creación descendente (la orden más reciente primero).
data retorna el registro completo de la orden (todas las columnas de orders), con el chat y el contacto de WhatsApp incluidos. No incluye el detalle de productos ni un total calculado.
La tabla orders no tiene una columna dedicada a la fecha de cancelación: como toda orden en esta respuesta tiene status 5, updatedAt es el momento en que se canceló (la última escritura sobre la orden es justo el cambio de estado a cancelada).

Respuesta

boolean

true cuando la solicitud se procesó correctamente.

object[]

Listado de órdenes canceladas.

Show Propiedades de cada orden

number

ID de la orden.

number

Estado de la orden. Siempre 5 (cancelada) en esta respuesta.

string

Motivo de cancelación registrado.

string

Canal de origen de la orden, por ejemplo wa.

string

Método de entrega elegido (delivery, pickup) o null.

string

Método de pago elegido o null.

number

ID del chat en el que se armó la orden.

string

Fecha de creación de la orden, en formato ISO 8601.

string

Fecha y hora en que la orden fue cancelada, en formato ISO 8601. La tabla orders no guarda un campo dedicado para esto: como toda orden de esta respuesta tiene status 5, updatedAt refleja el momento del cambio a cancelada.

object

Chat asociado a la orden.

Show Propiedades de chat

number

ID del chat.

object

Contacto de WhatsApp del chat: incluye id, nombre, numero y meta_id.

object

Show Propiedades de pagination

number

Página actual.

number

Total de páginas disponibles.

number

Total de órdenes que cumplen el filtro, sin paginar.

number

Registros por página aplicados.

boolean

Si existe una página siguiente.

boolean

Si existe una página anterior.

curl -X GET "https://beta.api-iobot-desarrollo.com/estadisticas/obtener/ordersCanceled/92?startDate=2026-08-01&endDate=2026-08-31&type=wa&cancelReason=inactividad&page=1&limit=10" \
  -H "x-api-key: TU_APP_KEY"

Método:  GET
URL:     https://beta.api-iobot-desarrollo.com/estadisticas/obtener/ordersCanceled/92

Query Params
  startDate     2026-08-01
  endDate       2026-08-31
  type          wa
  cancelReason  inactividad
  page          1
  limit         10

Headers
  x-api-key     TU_APP_KEY

updatedAt es la fecha de cancelación de la orden (2026-08-28T23:55:04.000Z en el ejemplo).

{
  "success": true,
  "data": [
    {
      "id": 272992,
      "status": 5,
      "shipment_method": "delivery",
      "payment_method": null,
      "empresa_id": 92,
      "chat_id": 252037,
      "cancel_reason": "(BOT) Cancelada por inactividad en el chat",
      "type": "wa",
      "createdAt": "2026-08-28T23:32:55.000Z",
      "updatedAt": "2026-08-28T23:55:04.000Z",
      "chat": {
        "id": 252037,
        "contacto": {
          "id": 139458,
          "nombre": "Juan Pérez",
          "numero": "50494898989",
          "meta_id": "50494898989"
        }
      }
    }
  ],
  "pagination": {
    "currentPage": 1,
    "totalPages": 6,
    "totalCount": 57,
    "limit": 10,
    "hasNextPage": true,
    "hasPrevPage": false
  }
}

{
  "success": true,
  "data": [],
  "pagination": {
    "currentPage": 1,
    "totalPages": 0,
    "totalCount": 0,
    "limit": 10,
    "hasNextPage": false,
    "hasPrevPage": false
  }
}

{
  "message": "Invalid API key"
}

{
  "success": false,
  "message": "Hubo un error en el servidor",
  "error": "..."
}

Plantillas de Mensajes

Chats

Campañas

Reporte Compartido

Ordenes

Autenticación

Parámetros de ruta

Parámetros de consulta

Comportamiento

Respuesta

​Autenticación

​Parámetros de ruta

​Parámetros de consulta

​Comportamiento

​Respuesta

Autenticación

Parámetros de ruta

Parámetros de consulta

Comportamiento

Respuesta