Integraciones de contabilidad

Conecte StockCraft directamente a su plataforma de contabilidad y aumente automáticamente los ingresos por ventas, los gastos y el costo de los bienes. Disponible en el plan Plus (5 USD 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 la contraseña de tu cuenta con StockCraft; en su lugar, concedes el permiso directamente a través de la página de inicio de sesión del proveedor.

Paso a paso: conecte Xero

1. Navega hasta Finanzas → Conexiones API en StockCraft
2. Encuentra el Xero tarjeta y clic «Conectar»
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. Navega hasta Finanzas → Conexiones API en StockCraft
2. Encuentra el QuickBooks en línea tarjeta y clic «Conectar»
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. Navega hasta Finanzas → Conexiones API en StockCraft
2. Encuentra el Negocio MYOB tarjeta y clic «Conectar»
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 de los registros históricos que ya existen en su software de contabilidad.

1. En la tarjeta del proveedor conectada, localice el Intervalo de fechas de sincronización sección
2. Establece un Fecha de inicio — solo se aplazarán las transacciones a partir de esta fecha
3. Si lo desea, defina un Fecha de finalización — si se deja vacío, StockCraft se sincroniza con la fecha actual
4. Haga clic «Guardar» para aplicar el intervalo de fechas

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. Navega hasta Finanzas → Conexiones API
2. En la tarjeta del proveedor conectada, haga clic en «Sincronizar ahora»
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 envían 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

• Ingresos por ventas: Los pedidos StockCraft completados se envían como facturas de venta (o equivalentes) a tu plataforma de contabilidad
• Gastos y costo de los bienes: Los gastos de compra de material se registran como facturas o entradas de compra

Fallos parciales

Si algunos registros no se insertan (por ejemplo, debido a un error de la API del proveedor), StockCraft continúa enviando los registros restantes. El resultado de la sincronización se mostrará como Fallo parcial con un recuento de los registros fallidos y un resumen de los errores.

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:

• Proveedor: Qué plataforma de contabilidad se sincronizó
• Iniciado/completado: Marcas de tiempo para la ejecución de la sincronización
• Registros realizados correctamente: Número de transacciones enviadas correctamente
• Fallo en los registros: Número de transacciones que no se pudieron enviar
• Estado: Resultado general: éxito, fracaso parcial o fracaso
• Resumen del error: Descripción legible por humanos cuando se producen problemas

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. Navega hasta Finanzas → Conexiones API
2. La tarjeta del proveedor afectado mostrará un «Requiere una nueva autorización» insignia de estado
3. Haga clic en el «Volver a conectar» botón
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 aparece un mensaje de reautorización, asegúrate 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. Navega hasta Finanzas → Conexiones API
2. En la tarjeta del proveedor conectada, haga clic en «Desconectar»
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?

• Correo electrónico: 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