Flujo de integración

El orden recomendado para que tu sitio ofrezca solo lo que Redfloral puede despachar y arme pedidos válidos sin conocer ids internos de antemano.

1. Comunas

GET /zones, una vez y cada vez que cambien (webhook availability.changed con type: zone). Cada comuna trae id, name, name_cleaned (en minúsculas y sin acentos) y el precio de despacho. Con name_cleaned puedes mapear la comuna que escribió tu cliente a un zone_id y mandarlo en cada pedido.

2. Horarios

GET /schedules da la plantilla semanal. Para ofrecer horarios de una fecha concreta es mejor el paso 3, que ya aplica las reglas de ese día.

3. Disponibilidad de una fecha

Antes de dejar que tu cliente elija la fecha:

curl "$API/delivery-availability?date=2026-11-02&zone_id=12" \
  -H "Authorization: Bearer $KEY"

Acepta la comuna por zone_id o por texto (zone_text=Ñuñoa). Devuelve available, el reason si no hay despacho (día bloqueado, día no hábil, hora de corte pasada…), y los schedules del día con su id, que es el shipping_schedule_id del pedido, y su precio (comuna + horario), el valor que va en shipping_cost.

4. Productos y precios

• GET /products para armar el catálogo. Incluye los productos que tu florería revende de otras (shared: true). Usa updated_since para traer solo lo que cambió.
• GET /products/<id> para variantes, opciones, imágenes y stock.
• GET /products/prices?date=2026-11-02 para el precio de esa fecha de despacho, con la oferta vigente y el recargo de alta demanda: es el mismo precio que vería un cliente en Redfloral ese día.

Productos que revendes

Si Redfloral configuró una reventa para usar el precio y el stock del producto original, ves los del original, y el producto aparece inactivo mientras el original esté inactivo o sin stock. Tus pedidos descuentan el stock del original, que se comparte con las demás florerías que lo venden.

5. Crear el pedido

POST /orders. Detalle en Pedidos.

6. Seguir el estado

• Con webhooks (recomendado): suscríbete a order.status_changed y order.photo_uploaded. Ver Recibir webhooks.
• Sin webhooks, o como red de seguridad: consulta GET /orders?updated_since=<última consulta> cada 5 a 10 minutos y actualiza tu sitio con status.slug.
• Un pedido puntual: GET /orders/<id> o GET /orders/ext:<tu external_id>. La foto de entrega llega en photos y url_photo cuando existe.

status.slug	Significa
pending	Pendiente
processing	Aceptado (así nace un pedido creado por API)
in_transit	En camino
delivered	Entregado
problem	Con problema
rejected	Rechazado
cancelled	Cancelado

Solo Redfloral y la florería avanzan los estados; la API los lee.

Ejemplos

KEY="rf_live_xxxxxxxx_tu_secreto"
API="https://api.redfloral.cl/api/partner/v1"

curl "$API/zones" -H "Authorization: Bearer $KEY"

curl "$API/delivery-availability?date=2026-11-02&zone_text=%C3%91u%C3%B1oa" \
  -H "Authorization: Bearer $KEY"

curl "$API/products/prices?date=2026-11-02&ids=8891,8892" \
  -H "Authorization: Bearer $KEY"

curl "$API/orders?updated_since=2026-10-23T12:00:00-03:00&status=processing,in_transit,delivered" \
  -H "Authorization: Bearer $KEY"