# Squarespace

:::tip Disponible
Esta integración está disponible en Frihet. Configúrala en **Settings → Integraciones → Squarespace**.
:::

Conecta tu tienda de Squarespace Commerce a Frihet para importar automáticamente pedidos, productos y datos de clientes. Squarespace es una plataforma de creación web con funcionalidades de e-commerce integradas. Con esta integración, cada venta realizada en tu tienda Squarespace se registra en Frihet como ingreso, manteniendo tu contabilidad sincronizada con tu actividad de ventas online sin intervención manual.

## ¿Para qué sirve?

- **Importar pedidos** — Las ventas de Squarespace Commerce se importan automáticamente como ingresos/facturas en Frihet
- **Productos sincronizados** — Tu catálogo de productos de Squarespace se refleja en el catálogo de Frihet
- **Clientes unificados** — Los compradores de tu tienda Squarespace se añaden como clientes en Frihet con sus datos de contacto
- **Informes consolidados** — Ve todas tus ventas de Squarespace junto con otros canales en los informes de Frihet
- **Comisiones como gastos** — Las comisiones de procesamiento de pago se registran automáticamente como gastos

## Requisitos

- Cuenta de Squarespace con un plan Commerce (Basic o Advanced)
- Plan Frihet Pro o Premium
- API Key de Squarespace

## Cómo conectar

### Paso 1: Obtener tu API Key en Squarespace

1. Inicia sesión en tu sitio de [Squarespace](https://www.squarespace.com)
2. Ve a **Settings → Advanced → Developer API Keys**
3. Haz clic en **Generate API Key**
4. Dale un nombre descriptivo, por ejemplo "Frihet ERP"
5. Selecciona los permisos de **Orders** (lectura) y **Inventory** (lectura)
6. Copia la API Key generada

### Paso 2: Configurar en Frihet

1. En Frihet, ve a **Settings → Integraciones**
2. Busca **Squarespace** y haz clic en el card
3. Pega tu **API Key** en el campo correspondiente
4. Haz clic en **Probar conexión** para verificar que las credenciales son correctas
5. Confirma el sitio web de Squarespace que quieres conectar
6. Haz clic en **Guardar**

## Datos que se sincronizan

| Dato               | Dirección            | Detalles                                                       |
| ------------------ | -------------------- | -------------------------------------------------------------- |
| Pedidos            | Squarespace → Frihet | ID de pedido, importe total, fecha, estado, líneas de producto |
| Productos          | Squarespace → Frihet | Nombre, precio, SKU, variantes                                 |
| Clientes           | Squarespace → Frihet | Nombre, email, dirección de envío                              |
| Estado de pedido   | Squarespace → Frihet | Pendiente, completado, reembolsado, cancelado                  |
| Comisiones de pago | Squarespace → Frihet | Registradas como gastos automáticamente                        |

## Casos de uso

### Diseñador con tienda online

Vendes prints, plantillas o productos digitales desde tu web de Squarespace. Cada venta se importa a Frihet automáticamente, y puedes generar facturas profesionales para tus clientes sin copiar datos manualmente. Al final del trimestre, tienes todos tus ingresos registrados para la declaración fiscal.

### Tienda de artesanía o productos handmade

Gestionas tu tienda de productos hechos a mano en Squarespace Commerce. Los pedidos se sincronizan con Frihet para que tengas un registro contable limpio. Las comisiones de procesamiento de pago aparecen como gastos, dándote visibilidad del margen real de cada venta.

### Consultor con venta de cursos online

Ofreces cursos o recursos descargables desde tu web de Squarespace. Cada compra genera un registro en Frihet con los datos del comprador, permitiéndote hacer seguimiento de ingresos por producto y emitir facturas cuando el cliente las solicite.

## Solución de problemas

### Error de conexión

- Verifica que la API Key es correcta y no ha expirado
- Comprueba que tu plan de Squarespace incluye Commerce (los planes Personal no incluyen API de Commerce)
- Si regeneraste la API Key, actualízala en Frihet

### No se importan pedidos

- Asegúrate de que tienes pedidos en Squarespace con estado **completado** o **pagado**
- Los pedidos en estado borrador o cancelado no se importan
- Verifica que la API Key tiene permisos de lectura de Orders

### Productos no aparecen en el catálogo

- Solo se importan productos que forman parte de pedidos importados
- Los productos archivados o eliminados en Squarespace no se sincronizan
- Ejecuta una sincronización manual desde la configuración de la integración

### Importes no coinciden

- Squarespace muestra precios con impuestos incluidos o excluidos según tu configuración — verifica que coincide con la configuración fiscal de Frihet
- Los descuentos aplicados en Squarespace se reflejan en el importe neto del pedido importado

## Siguientes pasos

- [Conecta Shopify si vendes en múltiples plataformas](./shopify)
- [Conecta Etsy para ventas en marketplace](./etsy)
- [Gestiona tu catálogo de productos en Frihet](../productos/catalogo)