PushSLogPushSLog

Oleada 5 · Documentación

Guías por plataforma

Shopify, WooCommerce, Tienda Nube, Mercado Libre, ecommerce propio (CUSTOM) y Falabella. Cada canal: panel, API, ejemplos curl y errores.

Base API: https://api.pushslog.com. Usa export PUSHSLOG_API_KEY=pk_… en terminal (ver Quick Start). Auth: Autenticación · Webhooks: Webhooks.

Disponible = conexión habitual en panel. Próximamente en panel = API documentada; UI puede mostrar «Conectar — próximamente». Roadmap = sin API pública estable.

  • Shopify
    Disponible
    Tienda Shopify vía OAuth desde el panel; PushSLog registra webhooks de pedidos tras conectar.

    Plan: Plan con feature stores_own (Tiendas propias).

    Abrir en el panel →

    Conexión: OAuth desde el panel (dominio myshopify.com).

    GET /api/v1/shopify/oauth/start · webhooks en /api/v1/webhook/shopify

    Pasos recomendados

    1. Panel. Tiendas → Tiendas propias → Shopify. Indica el dominio myshopify.com e inicia OAuth.
    2. OAuth (API). GET https://api.pushslog.com/api/v1/shopify/oauth/start?shop=tienda.myshopify.com — requiere sesión JWT del panel (no pk_).
    3. Webhooks. Tras autorizar, eventos en POST /api/v1/webhook/shopify.
    4. Operación. Pedidos y envíos en Envíos del panel.

    Ejemplos curl

    OAuth start (Bearer sesión del panel)

    curl -s "https://api.pushslog.com/api/v1/shopify/oauth/start?shop=mi-tienda.myshopify.com" \
  -H "Authorization: Bearer TU_ACCESS_TOKEN_PANEL"

    Respuesta típica (JSON)

    {
  "success": true,
  "data": {
    "authorizationUrl": "https://mi-tienda.myshopify.com/admin/oauth/authorize?...",
    "shop": "mi-tienda.myshopify.com"
  }
}

    Errores frecuentes

    HTTPerrorCuándo
    401SESSION_REQUIREDOAuth sin sesión de panel
    400SHOPIFY_INVALID_SHOPQuery shop inválido (usa *.myshopify.com)
    503SHOPIFY_OAUTH_NOT_CONFIGUREDFaltan credenciales Shopify en servidor

    Webhooks · Referencia API

  • WooCommerce
    Disponible
    WordPress + plugin oficial; sincroniza pedidos con API key pk_ del tenant.

    Plan: Plan con stores_own.

    Abrir en el panel →

    Conexión: Plugin WordPress + API key pk_ en el panel.

    POST /api/v1/woocommerce/shops/register · webhook /api/v1/webhook/woocommerce

    Pasos recomendados

    1. Plugin. Descarga pushslog-for-woocommerce desde Tiendas → WooCommerce e instálalo en WordPress.
    2. API key. Crea pk_ en Tiendas → Custom → API personalizada (o en la guía Woo del panel).
    3. Registro API. POST https://api.pushslog.com/api/v1/woocommerce/shops/register con shopUrl y opcional consumerKey/consumerSecret para sync de webhooks.
    4. Webhook. URL: POST /api/v1/webhook/woocommerce (plugin o sync REST).

    Ejemplos curl

    Registrar tienda Woo

    curl -s -X POST "https://api.pushslog.com/api/v1/woocommerce/shops/register" \
  -H "Content-Type: application/json" \
  -H "x-api-key: $PUSHSLOG_API_KEY" \
  -d '{
    "shopUrl": "https://mi-tienda.com",
    "name": "Mi WooCommerce"
  }'

    Respuesta típica (JSON)

    {
  "success": true,
  "data": {
    "shopId": "clx…",
    "shopUrl": "https://mi-tienda.com",
    "webhookEndpoint": "https://api.pushslog.com/api/v1/webhook/woocommerce",
    "webhookSecret": "whsec_…",
    "webhookSync": { "topics": ["order.created"], "deliveryUrl": "…", "secretStored": true }
  }
}

    Errores frecuentes

    HTTPerrorCuándo
    401API_KEY_REQUIREDFalta x-api-key pk_
    400BAD_REQUESTFalta shopUrl en el body
    400WOO_PARTIAL_REST_CREDENTIALSSolo consumerKey o solo consumerSecret
    500WOOCOMMERCE_REGISTER_FAILEDError al guardar tienda

    Quick Start (pk_)

  • Tienda Nube
    Próximamente en panel
    Tienda Nube: registro manual con storeId + accessToken u OAuth con pk_.

    Plan: Plan con stores_own; conexión en panel puede mostrar «próximamente».

    Abrir en el panel →

    Conexión: OAuth o registro con access token.

    POST …/tiendanube/shops/register · webhook /api/v1/webhook/tiendanube

    Pasos recomendados

    1. Panel. Tiendas → Tiendas propias → Tienda Nube (habilitación según plan y rollout).
    2. Registro API. POST https://api.pushslog.com/api/v1/tiendanube/shops/register con storeId y accessToken.
    3. OAuth. GET https://api.pushslog.com/api/v1/tiendanube/oauth/start con x-api-key (app TN en servidor).
    4. Webhooks. POST /api/v1/webhook/tiendanube — HMAC con TIENDANUBE_APP_SECRET.

    Ejemplos curl

    Registrar tienda (token manual)

    curl -s -X POST "https://api.pushslog.com/api/v1/tiendanube/shops/register" \
  -H "Content-Type: application/json" \
  -H "x-api-key: $PUSHSLOG_API_KEY" \
  -d '{
    "storeId": 123456,
    "accessToken": "TN_ACCESS_TOKEN",
    "name": "Mi Tienda Nube"
  }'

    Iniciar OAuth

    curl -s "https://api.pushslog.com/api/v1/tiendanube/oauth/start?name=Mi%20TN" \
  -H "x-api-key: $PUSHSLOG_API_KEY"

    Respuesta típica (JSON)

    {
  "success": true,
  "data": {
    "shopId": "clx…",
    "storeId": "123456",
    "notificationUrl": "https://api.pushslog.com/api/v1/webhook/tiendanube",
    "webhooks": { "created": ["order/created"], "skipped": [] }
  }
}

    Errores frecuentes

    HTTPerrorCuándo
    400BAD_REQUESTFalta storeId o accessToken
    400TN_INVALID_STORE_IDstoreId no numérico o inválido
    503TN_OAUTH_NOT_CONFIGUREDApp Tienda Nube no configurada en servidor

    Webhooks

  • Mercado Libre
    Próximamente en panel
    Seller Mercado Libre: registro con sellerUserId + token u OAuth Authorization Code.

    Plan: Plan con stores_marketplaces.

    Abrir en el panel →

    Conexión: Registro + OAuth ML (variables de app en servidor).

    POST …/mercadolibre/shops/register · GET …/mercadolibre/oauth/start

    Pasos recomendados

    1. Panel. Tiendas → Marketplaces → Mercado Libre (según plan).
    2. Registro API. POST https://api.pushslog.com/api/v1/mercadolibre/shops/register con sellerUserId y accessToken del vendedor.
    3. OAuth. GET https://api.pushslog.com/api/v1/mercadolibre/oauth/start con pk_ → authorizationUrl.
    4. Notificaciones. Configura notificationUrl en la app ML (orders / orders_v2).

    Ejemplos curl

    Registrar seller (token existente)

    curl -s -X POST "https://api.pushslog.com/api/v1/mercadolibre/shops/register" \
  -H "Content-Type: application/json" \
  -H "x-api-key: $PUSHSLOG_API_KEY" \
  -d '{
    "sellerUserId": 123456789,
    "accessToken": "ML_ACCESS_TOKEN",
    "name": "Mi ML"
  }'

    Iniciar OAuth

    curl -s "https://api.pushslog.com/api/v1/mercadolibre/oauth/start" \
  -H "x-api-key: $PUSHSLOG_API_KEY"

    Respuesta típica (JSON)

    {
  "success": true,
  "data": {
    "shopId": "clx…",
    "sellerUserId": "123456789",
    "notificationUrl": "https://api.pushslog.com/api/v1/webhook/mercadolibre",
    "hints": ["Configura esta URL en Mercado Libre", "Topics: orders / orders_v2"]
  }
}

    Errores frecuentes

    HTTPerrorCuándo
    400BAD_REQUESTFalta sellerUserId o accessToken
    400ML_INVALID_SELLER_USER_IDsellerUserId inválido
    503ML_OAUTH_NOT_CONFIGUREDApp ML no configurada en servidor

    Referencia API

  • Ecommerce propio (CUSTOM)
    Disponible
    Backend propio: REST con pk_, catálogo opcional y webhooks firmados.

    Plan: Plan con stores_custom.

    Abrir en el panel →

    Conexión: API REST con pk_ — sin marketplace.

    POST /api/v1/custom/* · ver Quick Start y Referencia API.

    Pasos recomendados

    1. API key. Tiendas → Custom → API personalizada → crear pk_.
    2. Registrar. POST /api/v1/custom/shops/register
    3. Pedidos. POST /api/v1/custom/orders
    4. Catálogo. Opcional: POST /api/v1/custom/catalog/products

    Ejemplos curl

    Registrar tienda CUSTOM

    curl -s -X POST "https://api.pushslog.com/api/v1/custom/shops/register" \
  -H "Content-Type: application/json" \
  -H "x-api-key: $PUSHSLOG_API_KEY" \
  -d '{"externalShopId":"demo.com","name":"Mi backend"}'

    Respuesta típica (JSON)

    {
  "success": true,
  "data": {
    "shopId": "clx…",
    "webhookEndpoint": "https://api.pushslog.com/api/v1/webhook/custom",
    "webhookSecret": "whsec_…"
  }
}

    Errores frecuentes

    HTTPerrorCuándo
    401API_KEY_REQUIREDSin pk_
    400CUSTOM_INVALID_SHOP_IDexternalShopId inválido
    404CUSTOM_SHOP_NOT_FOUNDshopId no del tenant

    Quick Start completo · Referencia CUSTOM

  • Falabella
    Roadmap
    Marketplace Falabella en roadmap; panel con bandeja demo de mensajes.

    Plan: Plan con stores_marketplaces (cuando la integración esté activa).

    Abrir en el panel →

    Conexión: Roadmap — mensajes y órdenes en fases posteriores.

    Sin endpoints públicos estables · guía de estado en esta página.

    Pasos recomendados

    1. Panel. Tiendas → Marketplaces → Falabella (https://app.pushslog.com/tiendas/marketplaces/falabella).
    2. Hoy. Vista operativa / datos demo según tenant.
    3. Próximo. OAuth, órdenes y webhooks se documentarán con API estable.

    Errores frecuentes

    HTTPerrorCuándo
    ——Sin endpoints públicos de integración aún

    Contactar soporte

Índice rápido

Matriz por tipo de integración

  • OAuth + webhooks — Shopify (panel); TN y ML (API + panel según rollout).
  • Plugin + pk_ — WooCommerce.
  • REST + pk_ — CUSTOM.
  • Roadmap — Falabella.

Planes · Soporte integración