SELLERP

Conceptos

Paginación y delta-sync

Toda la API v1 usa cursor pagination. Para clientes que pollean, el filtro updated_since te trae solo lo que cambió desde la última corrida — incluyendo pedidos viejos que se actualizaron.

Cursor pagination

Cada respuesta de listado incluye un objeto pagination:

{
  "data": [ /* ... orders ... */ ],
  "pagination": {
    "next_cursor": "eyJpZCI6IjIwMDAwMDEyMzQ1NiIsImNyZWF0ZWRBdCI6IjIwMjYtMDQtMjlUMTA6MjM6MTFaIn0=",
    "has_more": true
  },
  "meta": { "request_id": "req_..." }
}

Para traer la siguiente página, pasa el cursor en el query param:

curl "https://api.sellerp.com/v1/orders?cursor=eyJpZCI6...&limit=100" \
  -H "Authorization: Bearer sellk_..."

Cuando has_more es false, ya recorriste todo el set.

Tamaños de página

  • limit default: 50.
  • limit máximo: 100.
  • Pedir más de 100 te devuelve 400 invalid_request.

Delta-sync con updated_since

Para clientes que pollean (cron cada 15 min, etc.), from tiene un problema: no captura pedidos viejos que cambiaron de estado. Si un pedido del mes pasado pasa de shipped a delivered, un filtro por created_at nunca lo va a ver.

Para eso existe updated_since: filtra por el campo last_updated (que se actualiza cada vez que cualquier campo del pedido cambia, no solo en la creación).

# Trae todos los pedidos cuyo estado cambió desde hace 15 minutos
curl "https://api.sellerp.com/v1/orders?updated_since=2026-04-29T20:00:00Z&limit=100" \
  -H "Authorization: Bearer sellk_..."

Combinando filtros

Los filtros se aplican como AND. Por ejemplo, "pedidos de Mercado Libre del último mes que cambiaron de estado en la última hora":

curl "https://api.sellerp.com/v1/orders?from=2026-04-01T00:00:00Z&to=2026-04-30T23:59:59Z&updated_since=2026-04-30T20:00:00Z" \
  -H "Authorization: Bearer sellk_..."