SELLERP

Empieza aquí

Introducción

La API de SELLERP da acceso programático a tus pedidos, items, ventas, saldos y CFDIs de los 10 marketplaces y servicios que centralizamos. Está diseñada para humanos (curl, scripts, ETL) y para agentes AI (vía MCP).

Tres formas de integrarte

Dependiendo de cómo trabajes, tienes tres puertas de entrada y todas comparten el mismo modelo de permisos por plan.

  • API REST v1 en https://api.sellerp.com/v1. Bearer auth, paginación por cursor, filtros por fecha y delta-sync. Pensada para scripts, ETL y dashboards externos.
  • Servidor MCP en https://mcp.sellerp.com/mcp. OAuth 2.1. Pensada para Claude.ai, Claude Desktop, Cursor y cualquier agente que hable el protocolo MCP.
  • Apps Script para Google Sheets. Plantilla copy-paste si lo único que quieres es que tus pedidos lleguen a una hoja.

Qué planes incluyen acceso

El acceso a la API y al MCP arranca en el plan Intermedio:

PlanAPIMCPWebhooks
Demo (gratis 14 días)———
Básico ($499 / mes)———
Intermedio ($999 / mes)Read-onlySí—
Avanzado ($2,999 / mes)FullSí—
Experto (custom)FullSíSí

Detalle completo en sellerp.com/precios. El gating es server-side: si tu plan no incluye API, las claves devuelven 403 con un mensaje claro.

Tu primer request

Si tu plan ya incluye API, genera una clave en /dashboard/settings/api y pega:

curl https://api.sellerp.com/v1/me \
  -H "Authorization: Bearer sellk_..."

Si todo está bien, recibes:

{
  "data": {
    "organization_id": "org_xyz",
    "plan": "intermedio",
    "trial_ends_at": null,
    "marketplaces_connected": 3
  },
  "meta": { "request_id": "req_..." }
}

Qué expone la API hoy

v1 es deliberadamente pequeña. Preferimos mantener pocos endpoints estables que añadir cien que cambien cada mes. Los que faltan se irán agregando sin romper compatibilidad — versionamos por path (/v1/, /v2/) cuando un cambio sí rompe.

  • GET /v1/orders — Pedidos con filtros por fecha, status y delta-sync.
  • GET /v1/orders/{id} — Detalle de un pedido.
  • GET /v1/me — Metadatos de tu organización y la clave que estás usando.

El MCP cubre más superficie hoy (8 tools incluyendo ventas, inventario, CFDIs, saldos) porque es read-only por contrato — no necesita el mismo nivel de versionado estricto. Roadmap de la REST en Changelog.

Convenciones globales

  • Idioma del producto: español. Mensajes de error y mensajes UI vienen en español aunque los códigos sean en inglés.
  • Husos horarios: internamente todo es UTC; los timestamps siempre son ISO 8601 con Z. La UI los renderiza en America/Mexico_City.
  • Moneda: MXN por defecto. Cuando un marketplace devuelve otra moneda, los campos currency lo reflejan.
  • IDs: los IDs externos se conservan tal cual los entrega el marketplace (no los normalizamos).