Introducción

La API de socios de Redfloral conecta el sistema de tu florería (tu sitio, tu ecommerce o tu ERP) con Redfloral. Con ella puedes:

1. Mostrar el catálogo de Redfloral en tu sitio: productos, precios por fecha de despacho, comunas, horarios y disponibilidad.
2. Mandar tus pedidos a Redfloral para que los despachemos. El cobro lo hiciste tú en tu sistema: Redfloral no procesa ese pago. El pedido entra a tu panel como una venta local, igual que uno cargado a mano.
3. Enterarte de los cambios (estado, foto de entrega, catálogo, disponibilidad) por webhook, sin consultar cada pocos minutos.

Beta

La versión 1 está en beta durante el piloto: el contrato puede cambiar, y avisamos directamente a los socios que la usan antes de hacerlo. Ver Versionado y cambios.

Datos básicos

Base	https://api.redfloral.cl/api/partner/v1
Autenticación	Authorization: Bearer rf_live_<prefijo>_<secreto>
Formato	JSON (UTF-8). Solo la subida de boletas y facturas usa multipart/form-data
Fechas	YYYY-MM-DD. Fechas con hora en ISO 8601; sin zona se interpretan en hora de Chile (America/Santiago)
Montos	Pesos chilenos, enteros
Especificación	openapi.yaml (OpenAPI 3.1)

Forma de las respuestas

Toda respuesta trae error. Las listas son paginadas:

{ "error": false, "data": [ ... ], "count": 120, "has_more": true, "page": 1, "page_size": 50 }

Usa ?page= y ?page_size= (máximo 100, por defecto 50). zones, schedules y webhooks devuelven todo en una página.

Los errores traen un code estable: programa contra code, no contra message, que puede cambiar de redacción.

{ "error": true, "code": "validation_error", "message": "Hay campos inválidos.",
  "fields": { "products.0.price": "Asegúrese de que este valor es mayor o igual a 0." } }

La lista completa está en Errores.

Por dónde seguir

• Primeros pasos: habilitar la API, crear tu key y hacer la primera llamada.
• Flujo de integración: qué consultar y en qué orden para armar un pedido válido.
• Pedidos y Lo que sorprende: antes de mandar el primer pedido real.