Conectar Airtable - Karrito Docs

#Disponibilidad

La conexión está disponible para propietarios de tiendas con un plan Start o Pro, cuando Airtable esté habilitado en Karrito. Conectar tu cuenta no exporta datos: eliges la base y los módulos que quieres copiar antes de iniciar la exportación.

#Lo que puedes hacer

Elegir clientes, pedidos y productos para copiarlos a una base de Airtable. Productos incluye sus variantes. Karrito conserva las columnas que agregues por tu cuenta. La copia se actualiza cuando inicias una exportación desde Karrito; no es sincronización continua ni importa cambios de Airtable a tu tienda.

#Conectar

Abre Configuración → Conexiones → Airtable y pulsa Conectar Airtable.
Autoriza únicamente la base que quieras usar. Necesitas permiso Creator para preparar tablas. No hace falta conceder todas tus bases.
Selecciona la base por nombre y pulsa Preparar tablas de Karrito. Se crean cuatro tablas propias: Pedidos, Clientes, Productos y Variantes.
Cuando indique que están listas, selecciona los datos y pulsa Exportar selección.

Conectar/preparar/exportar requiere ser propietario y un plan habilitado según Karrito. No se cambia el plan de Airtable ni se compra capacidad automáticamente.

#Elegir qué exportar

Pedidos: pedidos reales, incluyendo su estado; no pedidos de prueba.
Clientes: identificadores, nombre, fecha y conteo de pedidos reales.
Productos y variantes: identificación, precio, moneda, SKU y stock de cada tipo. El precio/stock base se mantienen separados de los de variantes.
El teléfono está apagado inicialmente. No se exportan email, direcciones, notas de cliente ni información de pago.
La capacidad que declares es una estimación para las cuatro tablas, después de descontar lo ocupado por otras tablas. Karrito no verifica tu plan remoto.

#Progreso, pausa y repetición

La pantalla muestra registros revisados/actualizados y permite pausar o continuar el mismo intento. Mantén la pantalla abierta para que avance. Cerrar la pestaña conserva el progreso, pero no continúa en segundo plano. Pausar detiene el próximo lote; no revierte uno ya enviado.

Repetir actualiza por la clave de Karrito y conserva los identificadores de Airtable. Si los datos no cambiaron, no se vuelven a escribir. Una base con claves duplicadas detiene la operación para no elegir una fila al azar.

#Mensajes y siguiente acción

Cuota agotada: revisa el límite en Airtable; luego reanuda. No crees otra base para eludir la cuota ni repitas el botón continuamente.
Límite de velocidad: Karrito espera antes de continuar.
Permiso vencido: vuelve a conectar la misma base. No cambia tus tablas.
Resultado pendiente de comprobar: se perdió la respuesta del proveedor. Pulsa comprobar; Karrito consulta el resultado antes de enviar otra escritura. Si no puede demostrarlo, conserva el intento para revisión, sin reenviarlo.
Conflicto: alguien cambió un campo gestionado en Airtable. Se detiene y puedes decidir explícitamente sustituirlo por el valor actual de Karrito. Tus columnas adicionales no se sustituyen.
Destino cambiado: comprueba base/tablas/permisos e inicia un ciclo nuevo. No se reutiliza un intento antiguo para escribir en un destino diferente.

Airtable no permite bloquear una edición externa simultánea entre comprobación y escritura. Evita editar los campos gestionados durante la exportación.

#Qué queda al cambiar opciones

Desactivar teléfono lo limpia en el siguiente ciclo confirmado; no borra el historial de Airtable. Deseleccionar un módulo conserva la copia anterior y deja de actualizarla. Al faltar un registro en Karrito, se marca como retirado y se limpian sus valores gestionados tras comprobar la ausencia; la fila y las columnas propias permanecen, y siguen ocupando cupo. Desconectar conserva la base y sus datos.

No renombres la clave usando caracteres especiales como llaves o saltos de línea; si el nombre no se puede usar con seguridad, la operación se detiene. No elimines las tablas/campos gestionados sin revisar la conexión.