Primeros pasos

1. Habilitar la API

La API es parte del plan de la florería. Si tu plan no la incluye, pídesela al equipo de Redfloral. Sin ella, cualquier key responde 403 api_access_disabled.

Para crear pedidos tu florería también necesita tener habilitado el ingreso de ventas locales. Sin eso, las lecturas funcionan pero POST /orders responde 403 orders_write_disabled.

2. Crear una key

En el panel de Redfloral, entra a Integraciones (la ven los administradores de la florería) y crea una API key:

• Ponle un nombre que diga dónde la vas a usar (Tienda WooCommerce, ERP). Si tienes varias integraciones, crea una key para cada una: así puedes revocar una sin cortar las demás y ver qué integración creó cada pedido.
• Elige los scopes (permisos):

Scope	Permite
catalog:read	Productos, precios por fecha, comunas, horarios y disponibilidad
orders:read	Leer pedidos y GET /me
orders:write	Crear y cancelar pedidos, subir boletas y facturas

• La key (rf_live_<prefijo>_<secreto>) se muestra una sola vez. Cópiala y guárdala en un lugar seguro, por ejemplo una variable de entorno de tu servidor. Redfloral solo guarda una huella, así que no podemos mostrártela de nuevo.

Usa la key solo desde tu servidor

Nunca la pongas en el código que corre en el navegador ni en una app móvil. Quien la tenga puede leer tus pedidos y crear pedidos a nombre de tu florería. Si se filtra, revócala en Integraciones y crea otra.

En la misma pantalla ves el prefijo de cada key y cuándo se usó por última vez, y puedes revocarlas.

3. Primera llamada

curl https://api.redfloral.cl/api/partner/v1/ping \
  -H "Authorization: Bearer rf_live_xxxxxxxx_tu_secreto"

{ "error": false, "company_id": 15, "company_name": "Mi Florería",
  "key": { "name": "Tienda WooCommerce", "prefix": "a1b2c3d4" },
  "scopes": ["orders:read", "orders:write", "catalog:read"],
  "server_time": "2026-10-23T15:04:05.123456Z" }

• Cada key pertenece a una florería. Nunca mandes un company_id: todo lo que consultes o crees es de la florería de la key.
• GET /me te dice si puedes crear pedidos (orders_write_enabled), cuántas ventas locales gratis te quedan y si estás bloqueado. Ver Cupo y excedente.

4. Probar sin afectar la operación

No hay un ambiente de pruebas separado: la API trabaja sobre los datos reales de tu florería. Para probar:

• Las lecturas (/products, /zones, /delivery-availability, /orders) no cambian nada.
• Para probar la creación, usa pedidos que puedas cancelar enseguida (POST /orders/<id>/cancel) y avísale a tu equipo para que no los despache. Recuerda que cada pedido cuenta como venta local (Cupo y excedente).
• Para los webhooks, POST /webhooks/<id>/test manda un evento ping a tu URL.

Siguiente: Flujo de integración.