Conectores

Los conectores sincronizan datos desde las herramientas con las que ya funcionan tus ventures — procesadores de pago, bancos, proveedores en la nube, plataformas publicitarias, APIs de IA — para que los ingresos y los costos fluyan a Kordox automáticamente y se conviertan en beneficio real, por venture.

Todo lo que extrae un conector es de solo lectura. Kordox nunca mueve dinero, cambia ajustes ni escribe nada de vuelta en la cuenta conectada.

Cómo funcionan los conectores

El flujo es el mismo para cada proveedor:

1. Añadir — abre una venture → pestaña Conectores (o Finanzas → Fuentes de datos), haz clic en Conectar fuente y elige un proveedor.
2. Autorizar — ya sea con OAuth en un clic (apruebas el acceso de lectura en la propia pantalla del proveedor) o pegando una clave / token de API que creas en el panel del proveedor. El panel muestra los pasos exactos y enlaza directamente a la página correcta.
3. Verificar — Kordox comprueba la credencial de inmediato y te avisa si falta un scope o un permiso.
4. Sincronización inicial — la primera extracción se ejecuta automáticamente y rellena el historial reciente.
5. Mantener al día — Kordox vuelve a sincronizar según un horario (cada ~6 horas); también puedes Sincronizar manualmente cuando quieras.
6. Atribuir — las transacciones sincronizadas se dirigen a la venture a la que pertenecen (ver Atribuir dinero a las ventures).

Acotado a una venture

Los conectores están acotados a una venture, así que cada venture solo ve sus propias cuentas y datos conectados. Los costos de infraestructura e IA pueden luego repartirse entre ventures por atribución.

Seguridad — cómo se gestionan las credenciales

• Solo lectura por diseño. Cada conector pide únicamente scopes de lectura (facturación, cargos, pedidos, informes de costos). Nada de lo que guarda Kordox puede gastar, reembolsar ni reconfigurar tu cuenta.
• Cifrado en reposo. Las claves de API y los tokens de OAuth se cifran antes de almacenarse y nunca se devuelven al navegador después de guardarlos.
• Mínimo privilegio. Donde un proveedor admite credenciales acotadas (claves restringidas de Stripe, tokens acotados de Cloudflare, políticas IAM de AWS), la guía pide el permiso más estrecho que funcione — detallado por conector abajo.
• Revocar cuando quieras. Desconectar elimina el acceso de Kordox y detiene la sincronización. Los datos ya sincronizados permanecen en tu libro mayor.

Conectores disponibles

Categoría	Proveedores	Conectar vía
Ingresos	Stripe, Shopify, PayPal, Square	OAuth (Stripe/Shopify) o clave de API
Caja / banco	Plaid (los saldos alimentan el runway)	Clave de API + token de Link
Costo de infraestructura	Cloudflare, AWS Billing, GCP Billing	Clave de API u OAuth (GCP)
Gasto publicitario	Meta Ads, Google Ads	OAuth
IA y tokens	Anthropic (Claude), OpenAI	Clave de API de administrador
Correo	Reenvío/CCO + responder desde un registro	No es un conector — ver Correo

Sincronización, estado y frescura

• Horario. Kordox vuelve a sincronizar los conectores activos automáticamente cada ~6 horas.
• Sincronización manual. Lanza una actualización cuando quieras desde la fila de un conector (o Sincronizar todo para una categoría). La sincronización manual simplemente ejecuta antes la misma extracción.
• Estado. Cada conector muestra su última hora de sincronización, el importe y el número de transacciones de los últimos 30 días, y el porcentaje atribuido.
• Requiere atención. Un conector con fallos aparece arriba con el error exacto y un atajo Verificar / Sincronizar / Configurar. Los errores transitorios del proveedor se reintentan automáticamente y se resuelven solos en la siguiente sincronización programada.
• Historial. El botón Historial muestra las sincronizaciones recientes y sus resultados.

Qué necesita cada conector

Stripe — pagos

Sincroniza pagos, transferencias, reembolsos y comisiones al P&L por venture. Solo lectura.

• Permisos: una clave de API restringida con lectura en Balance, Charges, Refunds, Subscriptions. (Añade escritura en Checkout Sessions solo si activas la facturación a clientes — está desactivada por defecto y no se necesita para la sincronización.)
• Pasos: Stripe → Developers → API keys → crea una clave restringida con los scopes de arriba → pégala → Añadir cuenta. El dinero se liquida en tu Stripe; la clave no puede moverlo.

Shopify — pedidos

Sincroniza los pedidos y reembolsos de tu tienda como ingresos. Solo lectura.

• Permisos (OAuth): read_orders, read_products.
• Pasos: introduce tu dominio mystore.myshopify.com → Conectar con Shopify → aprueba el acceso de lectura → se te redirige de vuelta y los pedidos se sincronizan como ingresos.
• Necesitarás: una cuenta de staff con permiso para instalar apps.

PayPal — pagos

Sincroniza las transacciones de PayPal como ingresos.

• Permisos: una app REST de PayPal — su Client ID + Secret (Transaction Search es de solo lectura).
• Pasos: developer.paypal.com → Apps & Credentials → abre/crea una app REST → copia el Client ID + Secret → pega ambos → elige Live (o Sandbox) → guarda.

Square — pagos

Sincroniza los pagos y reembolsos de Square como ingresos.

• Permisos: un access token de Square (PAYMENTS_READ).
• Pasos: developer.squareup.com → tu app → Credentials → copia el access token → pégalo, opcionalmente añade un Location ID para limitar a una ubicación → elige el entorno → guarda.

Plaid — saldos bancarios

Conecta los saldos bancarios para que el runway se base en caja real.

• Permisos: Client ID + Secret de Plaid y un item access token de Plaid Link (producto Balance).
• Pasos: copia el Client ID + Secret del panel de Plaid → usa Plaid Link para conectar el banco y obtener un access token → pega los tres → elige el entorno (production/sandbox) → guarda.

Cloudflare — costo de infraestructura

Controla el uso y los costos de facturación de Cloudflare.

• Permisos: un token de API personalizado con un único permiso — Account → Billing → Read, acotado a tu cuenta.
• Pasos: Panel → Mi perfil → Tokens de API → Crear token (Billing Read) → cópialo → pégalo, junto con tu Account ID (barra lateral derecha de la vista general de cualquier dominio) → guarda. Kordox verifica al instante.

AWS Billing — costo de infraestructura

Trae el costo y uso de AWS al P&L de la venture correcta.

• Permisos: un usuario/clave IAM con permiso para llamar a ce:GetCostAndUsage (AWS Cost Explorer). La política gestionada AWSBillingReadOnlyAccess lo cubre.
• Pasos: IAM → adjunta la política a un usuario → crea una access key → pega el access key ID + secret → opcionalmente indica una región (por defecto us-east-1) → guarda.

GCP Billing — costo de infraestructura

Trae el gasto de Google Cloud para que los costos de infraestructura caigan en el P&L de la venture correcta — por proyecto GCP, por servicio, por día.

• Conectar (un clic): elige Conectar con tu cuenta de Google e inicia sesión con la identidad dueña de tu GCP. Kordox detecta automáticamente tu cuenta de facturación y la exportación a BigQuery — la mayoría de configuraciones no requieren escribir nada.
• Permisos (OAuth): cloud-billing.readonly + bigquery.readonly.
• El único paso manual en GCP: los datos de costos provienen de la exportación a BigQuery de Cloud Billing, que solo puede activarse en la consola — Billing → Billing export → Standard usage cost → elige un proyecto + dataset. Si aún no está activada, la lista de comprobación del conector te lleva directamente allí. Los primeros datos llegan ~24 h después de activarla (sin relleno histórico).
• Avanzado (sin OAuth): en su lugar, pega una clave JSON de cuenta de servicio con Billing Account Viewer + lectura de BigQuery — útil para cuentas de máquina.
• ¿Cambiaste algo en GCP? Usa Volver a detectar desde Google en la tarjeta para volver a ejecutar la detección automática y elegir la cuenta de facturación correcta.

Meta Ads — gasto publicitario

Importa el gasto en anuncios de Meta (Facebook/Instagram) como costo para que los márgenes y el CAC sean reales.

• Permisos (OAuth): ads_read.
• Pasos: Conectar vía OAuth → aprueba el acceso de lectura → elige la cuenta publicitaria a sincronizar → el gasto se importa como gastos.

Google Ads — gasto publicitario

Importa el gasto de Google Ads como costo para un margen y un CAC reales.

• Permisos (OAuth): acceso de lectura a tus datos de Google Ads; confirmarás el customer ID.
• Pasos: Conectar vía OAuth → aprueba el acceso de lectura → selecciona la cuenta / confirma el customer ID → el gasto se importa como gastos.

Anthropic (Claude) — IA y tokens

Registra el gasto de tu API de Claude y del workspace como costos de IA, por workspace — para que la factura de IA de cada venture sea real.

• Permisos: un rol de administrador de la organización y una clave de API de administrador (sk-ant-admin…). Una clave de API normal no puede leer el uso de la organización. Kordox lee únicamente el informe de costos diario.
• Pasos: console.anthropic.com → Settings → Admin keys (no la página normal de claves de API) → crea una clave Admin → pégala aquí.
• Atribución: cada workspace de Claude se asigna a una venture, exactamente como los proyectos de GCP.

OpenAI — IA y tokens

Registra el gasto de tu API de OpenAI como costos de IA, por proyecto.

• Permisos: un rol de owner/admin de la organización y una clave de API de administrador (sk-admin…). Kordox lee únicamente los costos diarios.
• Pasos: platform.openai.com → Settings → Organization → Admin keys → crea una clave admin → pégala aquí.
• Atribución: cada proyecto de OpenAI se asigna a una venture.

Atribuir dinero a las ventures

Kordox dirige cada transacción sincronizada a la venture a la que pertenece, para que el P&L por venture sea real en lugar de "lo que viniera de esa cuenta". Ambos mecanismos son retroactivos — Kordox vuelve a atribuir el historial existente cuando guardas y vuelves a sincronizar.

Mapeo de fuentes — para proveedores con subentidades limpias. Los costos de GCP se mapean por proyecto en la nube, Cloudflare por cuenta, Claude/OpenAI por workspace/proyecto. Edita en Finanzas → Costos en la nube → Atribución.

Reglas de atribución — para proveedores sin subentidades limpias (descriptores de Stripe, notas bancarias). Una regla dice "la descripción contiene X → venture Y": cualquier transacción cuya descripción contenga ese texto (sin distinguir mayúsculas) cae en esa venture; gana la primera regla que coincida. Edita en Finanzas → Explorador de dinero → Reglas de atribución, luego Guardar y volver a sincronizar.

Explorador de dinero

Finanzas → Explorador de dinero desglosa todo el dinero sincronizado — ingresos, infraestructura, anuncios, IA, comisiones — por categoría, proveedor, fuente, servicio, venture o tipo, en cualquier periodo. Alterna entre Dinero que entra, Dinero que sale y Neto, y exporta la vista actual como un libro de Excel, un informe PDF con tu marca o CSV.

Solución de problemas

• "Requiere atención" con un error de sincronización. Abre el texto del error — ahora incluye el estado HTTP del proveedor. 401/403 significa que la clave/token carece de un scope necesario (vuelve a crearla con los permisos listados arriba). Los errores transitorios 5xx/de límite de tasa se reintentan automáticamente y se resuelven en la siguiente sincronización programada.
• Conectado pero sin datos. Algunos proveedores tienen retraso: la exportación a BigQuery de GCP entrega los primeros datos ~24 h después de activarla; los informes de costos de IA se retrasan ~1–2 días. Dale un ciclo y luego Sincroniza.
• Costos en la venture equivocada. Configura la atribución y Guardar y volver a sincronizar — vuelve a atribuir el historial, no solo los datos nuevos.
• La verificación falla de inmediato. La credencial es incorrecta o le falta un scope; el panel indica qué falta. Vuelve a crear la clave y pégala de nuevo.