Skip to main content
Se aplica a: Admin · Partner Admin ** · Módulo:** Management > IntegrationsProveedor: QuickBooks Online (Intuit)** ·** Tipo de integración: Bidireccional · Dirección de sincronización: Alvys a QBO (facturas y recibos); QBO a Alvys (estado de pago)Este artículo explica cómo autorizar el OAuth connect entre Alvys y QuickBooks Online, luego configura la sincronización configuración para ingresos, gastos, las facturas de los conductores, los requisitos de transportista factura y el mapeo de subsidiarias o flotas a QBO classes o locations.

Qué hace esta integración

Alvys conecta a QuickBooks Online (QBO, Intuit QuickBooks) a través de OAuth 2.0, lo que significa que usted se autentica (inicia sesión y autoriza) a través del portal inicio de sesión de Intuit y Alvys recibe un token seguro; no hay contraseña almacenados en Alvys. Una vez conectado, Alvys exporta, sincroniza y envía automáticamente facturas de clientes y transportista o facturas de proveedores cuando las cargas se procesan para facturación. Cuando los pagos se registran en QBO, QBO devuelve el estado del pago a Alvys.

Requisitos previos

Antes de conectar, complete todos los pasos en QuickBooks Online Prerequisites (Comience aquí):
  • Confirme que su suscripción QBO es Essentials, Plus o Advanced.
  • Verifique que su Chart of Accounts incluya cuentas para Accounts Receivable, Accounts Payable, ingresos y gastos.
  • Habilite Custom transacción numbers en QBO en configuración > Cuenta y configuración > Ventas > Contenido del formulario de ventas si desea que QBO las facturas utilicen Alvys números de carga.
  • Confirme que no haya períodos contables cerrados que cubran las fechas de las cargas que planea exportar.

Conectar / autenticar

  • Abra la página Integrations. Navegue a Management > Integrations en Alvys y ubique el mosaico QuickBooks Online.
Menú Management con Integrations resaltadoMenú Management con Integrations resaltadoQuickBooks Online Mosaico en la sección de contabilidad de la Lista Integrations.QuickBooks Online Mosaico en la sección de contabilidad de la Lista Integrations.
  • Inicie el connection. Haga clic en Connect en el mosaico QuickBooks Online. Alvys redite dirige al Intuit authorization page.
  • Inicie sesión y autorice. Inicie sesión con sus credenciales QBO y haga clic en Connect. Una vez autorizado, Intuit redilo redirige a Alvys y el estado de connect se muestra como conectado.
  • Seleccione el archivo de la empresa QBO. Si su cuenta Intuit tiene acceso a más de un archivo de la empresa QBO, seleccione el correcto en el menú desplegable. Solo se puede connect editar un archivo de empresa por Alvys entidad jurídica.
Intuit authorization page después de hacer clic en Connect.Intuit authorization page después de hacer clic en Connect.

Campo y mapeo de datos

Después de conectar, configure la sincronización configuración. Cada sección a continuación asigna datos Alvys al QBO field o comportamiento correspondiente.
QuickBooks Online Account configuración diálogo en la página Alvys integrationsQuickBooks Online Account configuración diálogo en la página Alvys integrations

Tipo de transacciones

Hay dos transacción types disponibles para sincronización:
  1. ingresos Esta opción determina si las transacciones ingresos se sincronizan con QBO. Cuando esté habilitado, los datos financieros relacionados con los ingresos, como las facturas de los clientes, se exportarán a QBO.
  2. gastos Esta opción determina si las transacciones gastos se sincronizan con QBO. Cuando esté habilitado, los datos financieros relacionados con los costos, como el pago del conductor y las facturas transportista, se exportarán a QBO.
💡 Tu selección aquí tiene prioridad sobre todas las demás configuration configuración. Estas opciones determinan el tipo de datos financieros que serán integrated. Habilite solo las opciones que desee export to QBO. Una vez seleccionado, hay configuración adicionales disponibles para controlar aún más cómo se exportan las transacciones.

Ignorar las facturas del conductor

Esta configuración permite a los usuarios evitar la exportación de todas las facturas de los conductores, incluidas las de la empresa conductor y los operadores propietarios, a QuickBooks Online (QBO). Cuando está habilitado, las facturas asociadas con conductor no se exportarán, lo que brinda a los usuarios un mayor control sobre qué transacciones se envían a los sistemas external accounting. Esta opción suele habilitarse cuando el pago del conductor se gestiona fuera de QBO, como a través de un sistema de nómina o una solución de liquidación de conductores independiente. Tenga en cuenta que incluso cuando esta configuración está habilitada, las facturas externas transportista, las facturas subsidiarias transportista y las de la compañía gastos, como combustible y peajes, aún se pueden exportar si las opciones hos están configuradas.

Declaración de factura única para conductor

Esta configuración controla cómo se exportan las facturas de los conductores para la empresa conductor y los operadores propietarios a QuickBooks Online (QBO). Se utiliza para consolidar todos los cargos y transacciones relacionados con un conductor, incluidos viajes, combustible, peajes y otros gastos, en una sola factura por extracto del conductor. Cuando esta configuración está habilitada y se genera un controlador paystub o un extracto, se exporta una factura única a QuickBooks Online por el monto neto total del paystub. Todos los componentes del pago al conductor están consolidados en esta factura, incluido el pago de viaje, accessorials, deducciones, credits, reembolsos y cualquier otro ajuste. Cada componente aparece como una línea separada en la factura, lo que proporciona etailed visibility y mantiene la exportación contable agrupada en una sola transacción. Esta opción se usa comúnmente cuando el pago del conductor se procesa de forma programada, como ciclos de nómina semanales o quincenales. Cuando esta configuración está deshabilitada, al generar una factura de cliente también se exportará la factura del conductor para el viaje individual. Cada viaje o entrega se exporta como una factura separada. Cuando se genera un paystub, se exportan varias facturas para cada tipo de transacción en el paystub, incluidas facturas separadas para credits, deducciones/reembolsos.

Generar factura de transportista por separado

Esta configuración se aplica a viajes de tipo brokerage donde un transportista externo y su assets están asignados a una carga. Cuando está habilitado, el sistema busca un transportista factura cargado antes de exportar el billete transportista a QuickBooks Online (QBO). En concreto, cuando un viaje brokerage es delivered o released y el usuario sube un documento del tipo transportista factura, el sistema exportará la factura transportista a QBO. Esto también se puede activar cuando un usuario genera la factura del cliente para una carga; el sistema verificará que se haya subido un transportista factura, y si no se encuentra ningún transportista factura, el billete transportista no se exportará al QBO. Esta configuración solo debe habilitarse cuando se requieren transportista factura como parte del flujo de trabajo antes de exportar facturas transportista externas para pago. Si esta configuración está deshabilitada, generar la factura del cliente para un viaje con un transportista externo exportará automáticamente la factura transportista a QuickBooks Online, incluso si el transportista factura no se ha subido.
💡 Si esta configuración estaba habilitada anteriormente pero no se cargó ningún documento transportista factura, la factura transportista no se creó y, por lo tanto, no se exportó a QuickBooks Online. Para resolver esto, cargue un documento de tipo transportista factura al viaje, luego seleccione Regenerate factura. Esto creará el billete transportista e iniciará su exportación a QuickBooks Online.

Declaración de proceso por categoría de impuesto

Cuando está habilitado, solo las facturas de 1099 conductor se exportan a QuickBooks Online (QBO). Se excluyen las facturas de W-2 conductor, lo que permite a los usuarios gestionar los pagos de W-2 conductores en un sistema de nómina separado. Cuando está deshabilitado, las facturas de W-2 y 1099 conductor se exportan a QBO. Esta configuración generalmente la habilitan los inquilinos que manejan la compensación de W-2 conductores fuera de QBO y desean evitar que las facturas de 2⟧ se envíen a QBO mientras aún exportan 1099 conductores gastos.
Imagen que muestra el Tax Category en el perfil del conductor.Imagen que muestra el Tax Category en el perfil del conductor.
⚠️ Algunos configuración deben usarse juntos, mientras que otros no deben habilitarse al mismo tiempo. Consulte la sección Configuration Dependencies and Incompatible configuración para obtener orientación.

Pagar transportista subsidiaria

Esta configuración se aplica a viajes que involucran una subsidiaria transportista (es decir, una transportista que opera bajo una subsidiaria de la compañía principal) que está asignada junto con la assets interna del inquilino. De forma predeterminada, cuando se genera un extracto del conductor y suponiendo que la configuración Single Bill for conductor Statement esté habilitada, se exporta una factura para el conductor del inquilino en el viaje. Cuando se habilita Pay Subsidiary transportista, este comportamiento cambia: en lugar de exportar una factura para el conductor cuando se genera un paystub, el sistema exporta una factura para la filial transportista cuando se genera la factura de carga.
⚠️ Ciertos configuración son mutuamente excluyentes y no deben habilitarse al mismo tiempo. La configuración Pay Subsidiary transportista no debe configurarse junto con la configuración Single Bill for conductor Statement. Consulte la sección **Configuration Dependencies and Incompatible configuración **para obtener orientación.

Ignorar transacción de valor cero

Cuando está habilitada, esta configuración excluye facturas y recibos con un valor financiero total de cero, lo que significa que las transacciones que no tengan un impacto general en las cuentas no se exportarán.
Imagen que muestra una muestra Alvys Factura con un total facturable de $0Imagen que muestra una muestra Alvys Factura con un total facturable de $0

Crear proveedor utilizando 1099 Tax Company

La configuración “Create Vendor Using 1099 Tax Company” permite a los usuarios determinar si los proveedores deben crearse en QuickBooks Online (QBO) utilizando el impuesto company details (Tax Company Name y dirección) especificado en la sección Tax Information del perfil de conductor Alvys (ya sea para la empresa conductor o para operadores propietarios con el tax category de 1099). Cuando esta configuración está habilitada: Si el proveedor no existe en QBO, se creará automáticamente un proveedor cuando se genere la declaración del conductor, utilizando Tax Company Name como el nombre del proveedor y Tax Company Address como la dirección del proveedor. Si el proveedor ya existe en QBO, el usuario debe asegurarse de que el nombre del proveedor coincida con el Tax Company Name especificado en el perfil del controlador Alvys para evitar conflictos y crear duplicados.
Imagen que muestra el Tax Company Name y la dirección de la empresaImagen que muestra el Tax Company Name y la dirección de la empresa

Declaraciones transportistas

Esta configuración debe habilitarse para export transportista statements como facturas al generar una declaración transportista del transportista liquidación module. Si utiliza transportista liquidación module para generar declaraciones para transportista externos y desea que estas declaraciones se exporten automáticamente a QuickBooks Online (QBO) al generarlas, esta configuración debe estar habilitada. Este es el único escenario en el que esta opción debe estar activada. Si no utiliza el transportista liquidación module y desea que transportista statements se exporte solo cuando el transportista factura se carga manualmente para un viaje, esta configuración debe estar deshabilitada y la opción de generar transportista factura por separado debe estar habilitada. Alternativamente, si prefiere que transportista statements se exporte solo cuando la factura del cliente se genera en una carga, esta configuración también debe estar deshabilitada y la opción de generar transportista factura por separado debe permanecer deshabilitada.

Gasto en combustible de la empresa exportadora

El TMS permite a los usuarios registrar transacciones de combustible, ya sea manualmente o importadas directamente desde el proveedor de combustible. Estas transacciones se pueden ver en** **Alvys combustible Report. En combustible report, si una transacción está marcada como “Deduct transacción” como verdadera, el costo se deducirá del conductor vinculado durante la nómina (generación de extracto). Si no se deduce, Deduct combustible falso (-), la transacción se trata como una empresa gastos.
Imagen que muestra el Alvys combustible Report con el Deduct transacción resaltadoImagen que muestra el Alvys combustible Report con el Deduct transacción resaltado
Cuando la configuración “Export Company combustible gastos” está habilitada, las transacciones de combustible donde Deduct combustible se establece en falso (-) (es decir, los costos de combustible no deducidos de conductor) se exportan a QuickBooks Online como facturas. Esto permite a la empresa track y gestionar el combustible expenses no cargado a conductor, como el those para los vehículos de propiedad de la empresa. Las exportaciones están programadas diariamente a las 6:30 a. m. UTC
⚠️ Tenga en cuenta: si un usuario no estaba configurado previamente para exportar transacciones de combustible de la empresa y luego habilita esta configuración, las transacciones pasadas no se exportarán automáticamente. Además, si una exportación falla por algún motivo, comuníquese con** **Alvys Support para exportar las 4⟧e transacciones.

Gasto de pico de empresa exportadora

El TMS permite a los usuarios registrar transacciones de peaje, ya sea manualmente o importadas directamente desde el proveedor de peaje. Estas transacciones se pueden ver en el Alvys peaje Report. Si una transacción está marcada como “Deduct peaje” como verdadera, el costo se deducirá del conductor vinculado durante la nómina. Si no se deduce, Deduct peaje falso (-), la transacción se trata como una empresa gastos.
Imagen que muestra el Alvys peaje Report con el Deduct transacción resaltadoImagen que muestra el Alvys peaje Report con el Deduct transacción resaltado
Cuando la configuración “Export Company peaje gastos” está habilitada, las transacciones de peaje donde Deduct peaje se establece en falso (es decir, los costos de peaje no deducidos de conductor) se exportan al sistema external accounting como facturas. Esto permite a la empresa track y gestionar los peajes gastos que no se cobran a conductor, como los those que soportan los vehículos propios de la empresa. Las exportaciones están programadas diariamente a las 7:30 a. m. UTC.

Prefijo del número de referencia

Esta configuración permite aplicar prefijos predefinidos Alvys’ a los números de referencia de las transacciones, alterando la forma en que se identifican las transacciones cuando se envían de Alvys a QuickBooks Online (QBO). Diferentes transacción types, como Cargar facturas, Facturas de viajes y Facturas de Paystub, tienen prefijos específicos. Por ejemplo, una factura podría aparecer como ALD-100000. Alvys Prefijos predefinidos:
  • ALD – Carga
  • ATP – Viaje
  • APS – Paystub
  • AEK – E-Check
  • AFL – Combustible
  • IMD – Deducción
  • ATL – Peaje
  • CAA – Accessorial
Los usuarios deben habilitar esta configuración solo si los números de referencia ayudarán a organizar e identificar las transacciones que se originan en Alvys. Para localizar transacciones con prefijos, simplemente ingrese el número de referencia, incluido el prefijo, en el campo de búsqueda QuickBooks field.
Imagen que muestra la búsqueda global QuickBooks Online con la factura exportada con el prefijo Alvys predefinidoImagen que muestra la búsqueda global QuickBooks Online con la factura exportada con el prefijo Alvys predefinido
Además de reference number prefix, los usuarios pueden configurar un fleet prefix, que se aplica solo a las facturas de clientes exportadas a QBO. Agregar un prefijo específico de la flota permite diferenciar fácilmente las facturas entre varios fleets. Consulta el siguiente artículo del centro de ayuda para configurar** **fleet prefixes Prioridad de prefijos (Reference Number Prefix vs Fleet Prefix): Si tanto la configuración external accounting para reference number prefix como la fleet prefix están habilitadas, el fleet prefix tiene prioridad para las facturas y se antepondrá al número de factura. Otros transacción types, como los billetes, seguirán utilizando el estándar reference number prefix.

Campo personalizado

QuickBooks Online (QBO) Los Custom Field son field definidos por el usuario que permiten capturar datos adicionales sobre transacciones, como facturas, para support informes, tracking u otras necesidades operativas. En Alvys, la opción Custom Field actualmente support asigna solo el número de orden de carga de una carga a un QBO custom field en facturas de clientes. Cuando está habilitado, esto garantiza que cada factura exportada desde Alvys con el número de orden de carga establecido se asigne al custom field. La asignación custom field se aplica solo a facturas; no afecta otras transacciones como facturas, de paystubs, u otras transacción types. Para utilizar esta función, primero se debe crear un custom field en QBO y habilitarlo para facturas. **pasos para crear y habilitar un custom field en QBO: **Crear y edit custom fields
💡 En QuickBooks Online, la cantidad máxima de caracteres que puedes ingresar en custom field es 30 caracteres.

Subsidiarias

Alvys subsidiaries se puede asignar a QuickBooks Online (QBO) Classes (también llamado departments) o Locations. Este mapeo le permite track transacciones y generar reports para cada subsidiaria en QBO.
  • Classes (Departments): Utilice classes si desea track ingresos, expenses y transacciones a un nivel departamental más detallado dentro de una subsidiaria. Classes se puede asignar por línea de pedido de transacción o a toda la transacción.
  • Locations: Utilice locations si desea track la actividad financiera a un nivel global más amplio para toda la filial. Locations se aplican a toda la transacción, no por línea de pedido.
⚠️ Una subsidiaria solo puede asignarse a Classes o Locations, no a ambos.
Prerequisites Antes del mapeo Subsidiaries en Alvys: Antes de asignar fleets en Alvys, debe configurar el Classes o Locations correspondiente en QuickBooks Online:
  1. Decide cómo quieres track subsidiaries en QBO
  2. Habilitar Classes o Locations en QBO
  3. Crea Classes o Locations en QBO
Utilice los enlaces proporcionados a continuación para obtener más información sobre cómo configurar QBO classes y locations en QBO

Flotas

Alvys fleets también se puede asignar a Classes o Locations en QBO. Esto le permite a su empresa track ingresos, costos y otras actividades financieras asociadas con cada flota individualmente.
  • Classes (Departments/Fleets): Ideal si desea asignar cada flota a un departamento o categoría independiente. Classes se puede aplicar por línea de pedido o por transacción, lo que brinda información granular sobre el rendimiento y la rentabilidad.
  • Locations: Puede usarse si desea track las transacciones de la flota a un nivel global más amplio, pero esto es menos común para fleets ya que generalmente se prefiere la granularidad de partidas individuales.
Fleets solo se puede asignar a Classes o Locations, no a ambos. Prerequisites Antes del mapeo Fleets en Alvys: Antes de asignar fleets en Alvys, debe configurar el Classes o Locations correspondiente en QuickBooks Online:
  1. Decide cómo quieres track fleets en QBO
  2. Habilite Classes o Locations en QBO
  3. Crea Classes o Locations en QBO

Exportar pagos de clientes

Cuando está habilitado, los pagos de los clientes registrados manualmente contra una carga o cargados a través de un informe factoring se exportan a QuickBooks Online cada cinco minutos. Los siguientes pagos de clientes están incluidos en la exportación:
  • Pagos agregados manualmente en cargas
  • Pagos agregados a través de factoring cargas de informes para factoring cargas
Tenga en cuenta:
  • Cargar un purchase report en la página factoring no afecta los pagos enviados al sistema external accounting. Además, las tarifas de factoring aplicadas a las cargas durante la carga de purchase report no se exportan a QuickBooks Online.
  • Solo el monto del pago final se exporta a QBO. Si se registran pagos múltiples para una carga, los pagos parciales no se exportan. El pago se envía únicamente cuando el monto total pagado es igual al monto total facturable.
Después de habilitar esta opción, se le pedirá que seleccione deposit account en la configuración donde se deben registrar los pagos de los clientes. Cuentas como Accounts Receivable no son válidas deposit accounts y no deben usarse para la configuración de pagos del cliente.
Imagen que muestra el mapeo Deposit Account en la configuración Alvys QBO.Imagen que muestra el mapeo Deposit Account en la configuración Alvys QBO.
Aunque exportar pagos a QBO es support, se recomienda registrar los pagos de los clientes directamente en QuickBooks Online y permitir que se sincronicen nuevamente con Alvys. Si una exportación de pago no se realiza o falla por cualquier motivo y el pago no se refleja en QuickBooks Online, comuníquese con Alvys Support para solicitar una reexportación.

Facturación compartida/facturación entre empresas

Shared Billing se utiliza cuando una carga es invoiced por una subsidiaria (factura As) y ofertada por otra subsidiaria (Tender As), y ambas subsidiaries tienen contabilidad separada integrations. Esta configuración garantiza que todas las transacciones financieras se registren correctamente en los dos subsidiaries. factura As Subsidiaria (p. ej., Alvys Inc)
Imagen que muestra el Alvys factura Cliente As field.Imagen que muestra el Alvys factura Cliente As field.
Crea una factura de cliente para la carga Crea una factura intercompany a la Tender As filial (Alvys Brokerage) por el costo transportista/conductor Tender As Subsidiaria (p. ej., Alvys Brokerage)
Imagen que muestra el Tendering As field.Imagen que muestra el Tendering As field.
Crea una factura intercompany a la subsidiaria factura As Crea una factura de proveedor al transportista o conductor para la carga
⚠️ Shared Billing debe estar habilitado en ambos subsidiaries. Sin él, las intercompany transacciones o transportista/facturas de proveedor no se exportarán correctamente.

Límites / no compatible

  • Solo se puede connect editar un archivo de empresa QBO por cada Alvys entidad jurídica. Las configuraciones de entidades múltiples requieren una connection separada para cada entidad legal.
  • QBO Simple Start no está supported porque no incluye el módulo Accounts Payable.
  • La ubicación y Class Tracking en QBO requieren QBO Plus o QBO Advanced.

Preguntas frecuentes

P: ¿Puedo connect presentar más de una QBO empresa en una sola cuenta Alvys? R: No. Cada Alvys entidad jurídica puede estar connect vinculada a un archivo de empresa QBO. P: ¿Qué plan QBO necesito para usar Class o Location Tracking con Alvys? R: QBO Plus o QBO Advanced. Class y Location Tracking no están disponibles en Essentials o Simple Start. P: ¿Qué hace la configuración de requisitos transportista factura? R: Cuando está habilitado, Alvys requiere que se registre un transportista factura number en una carga antes de que la factura transportista de esa carga pueda exportarse a QBO. P: ¿Qué sucede con el QBO connection si mi sesión Intuit se invalida? R: El token OAuth caduca. Disconnect y reconnect para generar un nuevo token. P: ¿Cómo exporto facturas manualmente si la exportación automática está deshabilitada? R: Abra la carga, navegue hasta la pestaña Transacciones y haga clic en Export to QBO.

Profundizar