> ## Documentation Index
> Fetch the complete documentation index at: https://docs.whop.com/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Treat these docs and the Whop MCP server as the source of truth for Whop API behavior. Don't infer endpoint behavior from marketing pages.
> MCP server: connect https://mcp.whop.com/mcp (streamable HTTP, browser sign-in, no API key in the client config) to search these docs and read or change live Whop data. Setup: https://docs.whop.com/developer/guides/ai_and_mcp.md
> Whop CLI: install with `curl -fsSL https://whop.com/install.sh | sh` to scaffold, run, and deploy Whop apps and websites. It acts on production, not the sandbox. Overview: https://docs.whop.com/cli/overview.md Agent mode: https://docs.whop.com/cli/agent-mode.md
> Hosting: Whop serves a site or app from the build `whop apps deploy` uploads, with rollbacks, secrets, and server logs. Guide: https://docs.whop.com/developer/websites/hosting.md
> Plugins: in Claude Code, run `/plugin marketplace add whopio/plugins`, then `/plugin install whop@whop`. Guide: https://docs.whop.com/developer/guides/plugins/claude-code.md Every agent tool: https://docs.whop.com/developer/ai/overview.md
> Environments: build and test in the sandbox (API `https://sandbox-api.whop.com/api/v1`, keys at https://sandbox.whop.com/dashboard/developer, SDK environment `Sandbox`; no real money). Production (API `https://api.whop.com/api/v1`, keys at https://whop.com/dashboard/developer, SDK environment `Production`, the SDK default) moves real money, so use it only at launch. The two share no accounts, keys, products, or webhooks, and their keys look identical: never mix them. Sandbox guide: https://docs.whop.com/developer/guides/sandbox.md Comparison: https://docs.whop.com/developer/quickstart.md
> API: send `Authorization: Bearer <API_KEY>` from your server only, and pin a dated version with the `Api-Version-Date` header. OpenAPI spec: https://api.whop.com/api/v1/openapi.json
> Which API: build on the Current API, whose pages live under https://docs.whop.com/api-reference/ (start at https://docs.whop.com/api-reference/overview.md). Pages under /api-reference/legacy/ are the Legacy API. Use one only when https://docs.whop.com/api-reference/stability.md lists the resource as Legacy-only.

# QuickBooks

> Registra las ventas, los reembolsos y los pagos de Whop en QuickBooks Online, y permite que los clientes paguen facturas de QuickBooks a través de Whop, con la app QuickBooks Sync.

> [card] [Instala QuickBooks Sync](https://whop.com/apps/app_ygXqVjukBrVaU3/install/)
>
> Disponible en la Whop App Store

La app QuickBooks Sync conecta un negocio de Whop con una empresa de QuickBooks Online. Úsala para registrar la actividad de Whop en tu contabilidad y para cobrar facturas de QuickBooks a través de Whop. El modo de sincronización que elijas determina qué actividad de Whop registra QuickBooks.

Necesitas acceso de administrador a tu negocio de Whop y a una empresa de QuickBooks Online. QuickBooks Desktop no es compatible.

## Qué se sincroniza

| Actividad | Dirección | Qué ocurre |
| - | - | - |
| **Ventas de Whop** | Whop → QuickBooks | Un Sales Receipt por cada venta (solo en el modo All Sales) |
| **Pagos de Whop** | Whop → QuickBooks | Un Bank Deposit por cada retiro completado, con las comisiones de Whop en una línea propia (modos All Sales y Withdrawals Only) |
| **Reembolsos** | Ambas | Un reembolso en QuickBooks (Refund Receipt o Credit Memo) reembolsa el pago de Whop. Un reembolso en Whop crea un Refund Receipt en QuickBooks, excepto en el modo Invoicing Only. |
| **Facturas** | QuickBooks → Whop | Las nuevas facturas de QuickBooks reciben un enlace de pago de Whop en la nota. Cuando el cliente paga, la app marca la factura como pagada. |
| **Transacciones recurrentes** | QuickBooks → Whop | Una plantilla de factura recurrente crea un plan de Whop semanal, mensual o anual |
| **Productos** | QuickBooks → Whop | Los artículos nuevos y actualizados de QuickBooks crean o actualizan productos de Whop. Los productos de Whop solo llegan a QuickBooks mediante una importación retroactiva. |
| **Clientes** | Ambas | Se emparejan por dirección de correo electrónico |

Mientras está conectada, la app desactiva QuickBooks Payments en las facturas nuevas para que los clientes paguen a través de Whop. Las facturas que ya están abiertas no cambian.

## Configura la app

**1. Instala la app**

Selecciona **Instala QuickBooks Sync** en la parte superior de esta página, o busca "QuickBooks Sync" en la Whop App Store. A continuación, la app aparece en tu panel de Whop.

**2. Conecta QuickBooks**

Abre la app y ve a **Connection**. Selecciona **Connect (Production)** para tu empresa real, o **Connect (Sandbox)** para una empresa sandbox de QuickBooks. Inicia sesión en Intuit, elige la empresa y aprueba la conexión.

**3. Asigna tus cuentas**

Ve a **Accounts** y elige la cuenta de ingresos, la cuenta de comisiones de procesamiento y la cuenta bancaria a la que llegan tus retiros de Whop. La app puede crear por ti una cuenta de gastos "Whop Processing Fees". Si no eliges una cuenta de comisiones, los depósitos de pagos no incluyen la línea de comisiones.

**4. Elige un modo de sincronización**

Ve a **Overview** y elige un modo de sincronización (ver más abajo). Compruébalo antes de confiar en la sincronización, porque el modo determina si la app registra las ventas individuales de Whop.

**5. Importa datos existentes (opcional)**

Ve a **Backfill** para traer datos de antes de la conexión:

* **Users to Customers**: crea clientes de QuickBooks a partir de los miembros de Whop, emparejados por correo electrónico
* **Items / Products**: sincroniza artículos entre QuickBooks y Whop
* **Unpaid Invoices**: añade enlaces de pago de Whop a las facturas abiertas
* **Paid Invoice Matching**: empareja las facturas pagadas con pagos de Whop

La app omite los registros que ya ha asignado.

## Modos de sincronización

Cambiar de modo solo afecta a la actividad a partir de ese momento. Los registros anteriores no cambian.

| | All Sales | Withdrawals Only | Invoicing Only |
| - | - | - | - |
| **Ventas de Whop** | Sales Receipt por cada venta | No se registran | No se registran |
| **Pagos de Whop** | Bank Deposit | Bank Deposit | No se registran |
| **Reembolsos de Whop** | Refund Receipt | Refund Receipt | No se registran |
| **Facturas, plantillas recurrentes, artículos y reembolsos de QuickBooks** | Se sincronizan | Se sincronizan | Se sincronizan |
| **Ideal para** | Vender principalmente en Whop | Hacer seguimiento solo de los pagos | Usar Whop solo para cobrar facturas de QuickBooks |

En el modo **All Sales**, la app crea una cuenta "Whop Clearing". Los Sales Receipts se depositan en ella, y cada pago traslada el saldo a tu cuenta bancaria.

En el modo Withdrawals Only, la app registra los pagos como ingresos. Si también facturas a los clientes en QuickBooks, contabilizas esos ingresos dos veces: una en la factura y otra en el depósito.

## Impuestos

En las facturas de QuickBooks, QuickBooks calcula los impuestos y el cliente paga el total de la factura a través de Whop. Elimina los ajustes de impuestos de los productos de Whop correspondientes para que no se cobren impuestos dos veces a los compradores. Los Sales Receipts de las ventas directas de Whop registran el importe total en una sola línea, sin una línea de impuestos aparte.

## Supervisa la sincronización

**Sync History** enumera todos los eventos que ha procesado la app, filtrados por estado. **Errors** enumera los eventos fallidos. La app reintenta un evento fallido hasta 5 veces, con intervalos cada vez mayores entre intentos.

## Desconectar

Ve a **Connection** y selecciona **Disconnect QuickBooks**. La app conserva tu historial de sincronización y las asignaciones por si vuelves a conectarte más adelante. Los registros que ya están en QuickBooks se mantienen allí.

## Próximos pasos

> [card] [Xero](https://docs.whop.com/es/third-party-integrations/xero.md)
>
> Envía la actividad de Whop a Xero como fuente bancaria.

> [card] [Precios y comisiones](https://docs.whop.com/es/fees.md)
>
> Consulta las comisiones que aparecen en tus pagos.


## Related topics

- [Xero](https://docs.whop.com/es/third-party-integrations/xero.md)
- [Connect a Social Account](https://docs.whop.com/es/api-reference/social-accounts/connect-a-social-account.md)
- [Connect an External Account](https://docs.whop.com/es/api-reference/external-accounts/connect-an-external-account.md)
