Integraciones de contabilidad

Conecte StockCraft directamente a su plataforma de contabilidad y aumente los ingresos, los gastos y los costos por ventas de productos de forma automática. Disponible en el plan Plus (5$ al mes).

Proveedores compatibles

Conectar a un proveedor

Cada proveedor utiliza el flujo de autorización de OAuth 2.0 estándar del sector. Nunca compartes tu contraseña de contabilidad con StockCraft; en su lugar, concedes el permiso directamente a través de la propia página de inicio de sesión del proveedor.

Paso a paso: conecte Xero

1. Navigate to Finances → API Connections in StockCraft
2. Find the Xero card and click "Connect"
3. Se le redirigirá a la página de inicio de sesión de Xero: inicie sesión con sus credenciales de Xero
4. Conceda permiso a StockCraft para acceder a su organización de Xero
5. Xero lo redirige de nuevo a StockCraft; la conexión ahora está activa

Paso a paso: conecte QuickBooks Online

1. Navigate to Finances → API Connections in StockCraft
2. Find the QuickBooks Online card and click "Connect"
3. Se te redirigirá a la página de inicio de sesión de Intuit: inicia sesión con tus credenciales de QuickBooks
4. Selecciona la empresa a la que quieres conectar y conceder acceso
5. QuickBooks lo redirige de nuevo a StockCraft; la conexión ahora está activa

Paso a paso: conecte MYOB Business

1. Navigate to Finances → API Connections in StockCraft
2. Find the MYOB Business card and click "Connect"
3. Serás redirigido a la página de inicio de sesión de MYOB: inicia sesión con tus credenciales de MYOB
4. Conceda permiso a StockCraft para acceder a los archivos de su empresa MYOB
5. Si tienes varios archivos de empresa, selecciona con cuál quieres sincronizar
6. MYOB lo redirige de nuevo a StockCraft; la conexión ahora está activa

Configuración del intervalo de fechas de sincronización

Antes de activar una sincronización, configure hasta qué punto StockCraft debe enviar los datos financieros. Esto evita la duplicación registros históricos que ya existen en su software de contabilidad.

1. On the connected provider card, locate the Sync Date Range section
2. Set a Start Date — only transactions on or after this date will be pushed
3. Optionally set an End Date — if left empty, StockCraft syncs up to the current date
4. Click "Save" to apply the date range

Activar una sincronización manual

Las sincronizaciones se activan manualmente: tú controlas cuándo se envían los datos a tu plataforma de contabilidad.

1. Navigate to Finances → API Connections
2. On the connected provider card, click "Sync Now"
3. StockCraft pone en cola el trabajo de sincronización y muestra una confirmación
4. La sincronización se ejecuta en segundo plano: los pedidos completados y los gastos dentro del intervalo de fechas configurado se transfieren al proveedor
5. Una vez completada, el estado de sincronización y el recuento de registros aparecen en la tarjeta del proveedor

Lo que se empuja

• Sales Revenue: Completed StockCraft orders are pushed as sales invoices (or equivalent) to your accounting platform
• Expenses & Cost of Goods: Material purchase expenses are pushed as bills or purchase entries

Fallos parciales

If some records fail to push (for example, due to a provider API error), StockCraft continues pushing the remaining records. The sync result will show as Partial Failure with a count of failed records and an error summary.

Historial de sincronización de lectura

Cada proveedor conectado muestra los 20 intentos de sincronización más recientes, ordenados primero los más recientes. Cada registro de sincronización incluye:

• Provider: Which accounting platform was synced
• Started / Completed: Timestamps for the sync run
• Records Succeeded: Number of transactions successfully pushed
• Records Failed: Number of transactions that failed to push
• Status: Overall outcome — Success, Partial Failure, or Failed
• Error Summary: Human-readable description when issues occur

Solución de problemas de reautorización

En ocasiones, una conexión puede requerir una nueva autorización. Esto ocurre cuando:

• El proveedor revoca o hace caducar tu token de actualización
• Cambias tu contraseña en la plataforma de contabilidad
• La política de seguridad del proveedor exige un nuevo consentimiento periódico
• El descifrado del token falla (poco frecuente: indica un problema de integridad de los datos)

Cómo volver a autorizar

1. Navigate to Finances → API Connections
2. The affected provider card will show a "Requires Re-authorisation" status badge
3. Click the "Re-connect" button
4. Vuelva a completar el flujo de OAuth (inicie sesión en el proveedor y conceda acceso)
5. Una vez que se haya vuelto a conectar, las sincronizaciones se reanudarán normalmente

Reautorización de MYOB

Para las conexiones de MYOB, la reautorización debe completarla un usuario con acceso de nivel de administrador de MYOB. Si usted ve un mensaje de reautorización, asegúrese de que el usuario administrador de MYOB correcto complete el paso de inicio de sesión.

Problemas comunes

Síntoma	Causa probable	Solución
Aparece la insignia «Requiere reautorización»	El token de actualización ha caducado o se ha revocado	Haz clic en «Reconectar» y completa el flujo de OAuth
La sincronización falla con un error 409	Ya hay una sincronización en curso	Espera a que finalice la sincronización actual e inténtalo de nuevo
Fallo parcial con errores en algunos registros	La API del proveedor rechazó registros individuales	Consulta el resumen del error para obtener más información, corrige los datos y vuelve a sincronizarlos
No se puede conectar: error 403	La cuenta está en el nivel gratuito	Actualice a Plus para acceder a las integraciones de contabilidad
La sincronización muestra 0 registros insertados	No hay transacciones en el intervalo de fechas configurado	Ajusta las fechas de inicio y finalización de la sincronización para cubrir el período deseado

Desconectar a un proveedor

Para eliminar una conexión:

1. Navigate to Finances → API Connections
2. On the connected provider card, click "Disconnect"
3. Confirme la desconexión en el cuadro de diálogo
4. StockCraft revoca el token de OAuth con el proveedor (si es compatible) y elimina la conexión

Seguridad

• Los tokens de OAuth se cifran en reposo mediante el cifrado de sobres KMS
• Los tokens nunca se muestran en la interfaz de usuario; solo un indicador enmascarado confirma que un token está configurado
• La devolución de llamada de OAuth utiliza la validación de parámetros de estado estándar del sector para evitar los ataques CSRF
• Las conexiones Xero utilizan PKCE para mayor seguridad durante el flujo de autorización
• Toda la comunicación de la API con los proveedores utiliza HTTPS

Soporte

¿Necesitas ayuda con las integraciones de contabilidad?

• Email: support@stockcraft.org
• Incluya su identificación de inquilino y el proveedor afectado al informar sobre problemas
• Los usuarios del plan Plus reciben respuestas prioritarias en un plazo de 24 horas