Cuando gestionas una tienda en BigCommerce, es vital tener control sobre errores, integraciones y eventos. Aunque BigCommerce no ofrece un sistema de logs tradicional, puedes aprovechar su API para exportar actividad clave y detectar problemas.

Índice

• Acceso a la API de BigCommerce
• Eventos y registros que puedes auditar
• Ejemplo: obtener logs de pedidos con errores
• Exportar actividad a CSV o Google Sheets
• Automatización con cron o n8n

Acceso a la API de BigCommerce

Necesitarás crear un API Account desde el panel de control:

1. Settings → API → Create API Account
2. Permisos: Read-Only en Orders, Products, Logs
3. Guardar client_id, access_token y store_hash

Eventos auditables

• Pedidos fallidos o rechazados
• Eventos de integración (apps, webhooks)
• Cambios en stock o precios
• Errores 400/500 al consumir la API

Muchos de estos se pueden inferir desde endpoints como:

GET /v2/orders?status_id=5
GET /v3/catalog/products?include=modifiers

Ejemplo de consulta con errores de pedido

curl -X GET \
  'https://api.bigcommerce.com/stores/STORE_HASH/v2/orders?status_id=5' \
  -H 'X-Auth-Token: ACCESS_TOKEN' \
  -H 'Accept: application/json'

Filtra pedidos con estado «cancelado» o «declinado» (status_id = 5, 6).

Exportar a CSV o Google Sheets

Puedes usar Python o n8n para volcar los datos:

import csv, requests
r = requests.get('https://api...', headers={...})
with open('logs.csv', 'w') as f:
    writer = csv.writer(f)
    writer.writerow(['id', 'status', 'total'])
    for order in r.json():
        writer.writerow([order['id'], order['status'], order['total_inc_tax']])

Desde n8n puedes usar HTTP Request → Google Sheets (append).

Automatizar y alertar

• Consulta cada 10 min con cron
• Filtra por nuevos errores
• Envía aviso por email o Telegram
• Archiva el JSON en Google Drive o FTP

Conclusión

Aunque BigCommerce no ofrece un sistema de logs directo, puedes auditar actividad y errores de forma eficaz usando su API. Esto te permite ganar control, detectar fallos y automatizar alertas clave.

¿Quieres que conectemos tu BigCommerce a un sistema de alertas personalizado? Hablemos.

Introducción

En tiendas grandes en BigCommerce, es habitual tener productos huérfanos: sin categoría asignada o sin imágenes. Esto afecta el SEO, la experiencia de usuario y puede generar productos invisibles en el catálogo.

En este artículo aprenderás cómo detectar productos sin categoría o sin imágenes usando la API de BigCommerce, con ejemplos de llamadas API y tips prácticos.

Índice

• 1. Por qué buscar productos huérfanos
• 2. Conexión a la API de BigCommerce
• 3. Detectar productos sin categoría
• 4. Detectar productos sin imágenes
• 5. Buenas prácticas y SEO
• 6. Conclusión

1. Por qué buscar productos huérfanos

• ⚠️ Productos sin categoría no aparecen en la navegación ni en búsquedas.
• 🖼️ Productos sin imagen reducen la confianza del cliente.
• 📉 Puede afectar el SEO y generar errores de rastreo.

2. Conexión a la API de BigCommerce

Para acceder a la API necesitas:

• 🔑 Client ID
• 🔐 Access Token
• 🌐 Store Hash

Ejemplo de conexión básica con PHP:

<?php
$store_hash = 'tu_store_hash';
$token = 'tu_token';

$url = "https://api.bigcommerce.com/stores/$store_hash/v3/catalog/products";

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
  "X-Auth-Token: $token",
  "Accept: application/json"
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);

$data = json_decode($response, true);
print_r($data);
?>

3. Detectar productos sin categoría

Usa el endpoint /v3/catalog/products. Cada producto tiene un array categories:

foreach ($data['data'] as $product) {
  if (empty($product['categories'])) {
    echo "Producto sin categoría: " . $product['name'] . "\n";
  }
}

Esto te listará productos huérfanos sin ninguna categoría asignada.

4. Detectar productos sin imágenes

Para detectar productos sin imágenes, consulta /v3/catalog/products/{product_id}/images:

$product_id = 123;
$url_img = "https://api.bigcommerce.com/stores/$store_hash/v3/catalog/products/$product_id/images";

$ch = curl_init($url_img);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
  "X-Auth-Token: $token",
  "Accept: application/json"
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);

$images = json_decode($response, true);

if (empty($images['data'])) {
  echo "Producto sin imágenes: ID $product_id\n";
}

✅ Esto detecta si el producto no tiene imágenes asignadas.

5. Buenas prácticas y SEO

• 🔎 Revisa estos datos regularmente para mantener el catálogo limpio.
• 📈 Completa siempre títulos, descripciones y categorías para SEO.
• 🖼️ Usa imágenes optimizadas y con atributo alt para accesibilidad.

6. Conclusión

La API de BigCommerce permite mantener tu catálogo optimizado y libre de productos huérfanos. Esto mejora el SEO y la experiencia de compra de tus clientes.

📩 ¿Quieres integrar esta verificación de forma automática? ¡Contáctanos!