> ## Documentation Index
> Fetch the complete documentation index at: https://docs.riqra.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Introducción

> La API pública de Riqra para integrar pedidos, preparación y stock.

La API pública permite a tus sistemas leer y actualizar datos de comercio de tu organización
de forma programática: consultar pedidos, avanzar su preparación y entrega, y sincronizar stock.

Es una API **REST** sobre HTTPS. Las respuestas son JSON. Cada llamada se autentica con una
**API key** y opera siempre dentro de una sola organización.

## URL base

Todas las rutas cuelgan de:

```
https://api-v2.riqra.com/public/v1
```

## Qué puedes hacer hoy

* **Pedidos**: listar y consultar pedidos.
* **Preparación**: avanzar la preparación, marcar como despachado o entregado, registrar guía de
  seguimiento y cancelar pedidos.
* **Stock**: listar sucursales activas y fijar el stock disponible por SKU y sucursal.

<Note>
  La API está en crecimiento. Algunas capacidades (productos, precios, promociones, envíos)
  todavía no están disponibles y responden con un código `501`.
</Note>

## Por dónde empezar

<CardGroup cols={2}>
  <Card title="Inicio rápido" href="/new-api/quickstart" icon="rocket">
    Tu primera llamada autenticada en minutos.
  </Card>

  <Card title="Autenticación" href="/new-api/authentication" icon="key">
    Cómo obtener y usar tu API key.
  </Card>

  <Card title="Permisos" href="/new-api/scopes" icon="lock">
    Los scopes que controlan qué puede hacer cada key.
  </Card>
</CardGroup>