BigCommerce - Obtener Pedidos

Descripcion

Este modulo permite consultar los pedidos de una tienda BigCommerce. Puede obtener un pedido especifico por ID o listar pedidos con diversos filtros como estado, cliente, rango de fechas y totales.

Configuracion

Credenciales Requeridas

• Store Hash: Hash unico de tu tienda BigCommerce
• Access Token: Token de acceso de la API V2

Parametros

Parametro	Tipo	Requerido	Descripcion
credentials_id	credential	Si	Credenciales de BigCommerce
order_id	string	No	ID del pedido especifico
status_id	select	No	Estado del pedido
customer_id	string	No	ID del cliente
email	string	No	Email del cliente
min_date_created	string	No	Fecha creacion minima (RFC 2822 o ISO 8601)
max_date_created	string	No	Fecha creacion maxima
min_total	number	No	Total minimo
max_total	number	No	Total maximo
payment_method	string	No	Metodo de pago
include_products	boolean	No	Incluir productos del pedido
sort	select	No	Ordenamiento
limit	number	No	Limite de resultados (default: 50)
page	number	No	Pagina de resultados (default: 1)

Estados de Pedido

ID	Estado
0	Incompleto
1	Pendiente
2	Enviado
3	Parcialmente enviado
4	Reembolsado
5	Cancelado
6	Rechazado
7	Esperando pago
8	Esperando recogida
9	Esperando envio
10	Completado
11	En espera
12	Disputado

Salida

{
  "success": true,
  "orders": [...],
  "count": 25,
  "page": 1,
  "limit": 50,
  "message": "25 pedidos obtenidos"
}

Campos de Pedido

• id: ID del pedido
• status_id: ID del estado
• status: Nombre del estado
• customer_id: ID del cliente
• date_created: Fecha de creacion
• total_inc_tax: Total con impuestos
• total_ex_tax: Total sin impuestos
• items_total: Cantidad de items
• payment_method: Metodo de pago
• billing_address: Direccion de facturacion
• shipping_addresses: Direcciones de envio

Ejemplo de Uso

Obtener pedido por ID

{
  "order_id": "12345",
  "include_products": true
}

Pedidos pendientes

{
  "status_id": "1",
  "sort": "date_created:desc"
}

Pedidos de un cliente

{
  "customer_id": "789",
  "limit": 100
}

Pedidos por rango de fechas

{
  "min_date_created": "2024-01-01",
  "max_date_created": "2024-01-31",
  "min_total": 100
}

API Utilizada

• Endpoint: GET /stores/{store_hash}/v2/orders
• Documentacion: BigCommerce Orders API

Notas

• Utiliza la API V2 de BigCommerce para pedidos
• Los productos se obtienen con una llamada adicional si se solicitan
• La API V2 devuelve directamente un array (no wrapper data)
• Las fechas deben estar en formato RFC 2822 o ISO 8601

Nodos Relacionados

• BigcommerceUpdateOrder - Actualizar pedido
• BigcommerceGetCustomers - Obtener clientes
• BigcommerceGetProducts - Obtener productos