Detalles de Conexión de Sage Intacct¶

Introducción¶

Versión del conector

Esta documentación se basa en la versión 21.0.8257 del conector.

Empezando¶

Compatibilidad con la versión Sage Intacct

El conector Jitterbit para Sage Intacct se conecta con la API de servicios web de Sage Intacct.

Establecer una Conexión¶

Conexión a Sage Intacct¶

Para conectarse a los servicios web, primero deberá habilitar la suscripción a los servicios web. Navegar a Company > Admin Tab > Subscriptions y habilitar Web Services.

Intacct también recomienda crear un usuario solo de servicios web, lo que se puede hacer navegando a Company > Admin Tab, y haciendo clic en + firmar al lado Web Services users.

Puede establecer una conexión con Sage Intacct usando las credenciales incrustadas o con sus propias credenciales.

Autenticación a Sage Intacct¶

Para autenticarse, configure CompanyID y establecer User y Password a las credenciales que utiliza para iniciar sesión en Sage Intacct. Además, deberá configurar su propio SenderID y SenderPassword, o use las credenciales integradas en Jitterbit Connector para Sage Intacct.

Autenticarse con las Credenciales Integradas¶

El conector tiene credenciales de servicios web integradas que se utilizarán al leer datos de Intacct.

Puede conectarse usando credenciales incrustadas de la siguiente manera:

• Asegúrese de que have not especificó un SenderID o SenderPassword.
• En su panel de control de servicios web, navegue hasta Company > Company Info > Security tab.
• Agregue "" a sus autorizaciones de Servicios Web. Esto distingue entre mayúsculas y minúsculas. Esto se puede hacer navegando a Company -> Company Info (Configuration -> Company in new UI) -> Security -> Web Services Authorizations / Edit.

Nota: A diferencia de usar credenciales personalizadas, las credenciales incrustadas son read-only.

Conéctese Usando Credenciales Personalizadas¶

Puede usar sus propias credenciales de servicios web para escribir datos en Intacct. Configure lo siguiente para conectarse a los datos:

• SenderID: establezca esto en el ID de remitente de servicios web que le asignó Sage Intacct.
• SenderPassword: establezca esto en su contraseña de servicios web registrada.

Autenticación con Okta¶

Selecciona el AuthScheme a Okta. Las siguientes propiedades de conexión se utilizan para conectarse a Okta:

• User: Configure esto para el usuario de Okta.
• Password: establezca esto en la contraseña de Okta para el usuario.
• SSOLoginURL: establezca esto en la URL de inicio de sesión utilizada por el proveedor de SSO.

La siguiente SSOProperties son necesarios para autenticarse en Okta:

• IntacctUserID: establezca este valor en el ID de usuario de Intacct que está asignado al usuario de Okta que configuró en la propiedad de conexión de usuario.
• APIToken (opcional): establezca esto en el token de API que el cliente creó a partir de la organización de Okta. Debe usarse al autenticar a un usuario a través de una aplicación confiable o un proxy que anula el contexto de solicitud del cliente de Okta.

La siguiente es una cadena de conexión de ejemplo: AuthScheme= Okta; SSOLoginURL='https://example.okta.com/home/appType/0bg4ivz6cJRZgCz5d6/46'; Usuario=oktaUserName; Contraseña=oktaContraseña; SSOProperties='IntacctUserID=intacct_user';

Ajuste Fino del Acceso a los Datos¶

Ajuste Fino del Acceso a Datos¶

Puede usar las siguientes propiedades para obtener más control sobre los datos devueltos por Sage Intacct:

• LocationsID: Para conectarse a una empresa secundaria compartida, especifique su ID de ubicación.
• ClientID: Para conectarse a una empresa secundaria distribuida, especifique su ID de cliente.

LocationsID y ClientID no se puede especificar al mismo tiempo.

Nueva API Sage Intacct¶

Se ha agregado soporte para la nueva API de Sage Intacct.

La nueva API agrega soporte para el filtrado del lado del servidor, ORDERBY, compensación y funciones agregadas que incluyen conteo, promedio, mínimo, máximo y suma.

Habilite este soporte configurando UseLegacy a False.

La nueva API también admite la visualización de atributos relacionados con objetos usando IncludeRelatedAttributes.

Notas Importantes¶

Procedimientos Almacenados¶

• Las funciones de procedimientos almacenados descritas en esta documentación no se admiten actualmente.
• Debido a que los procedimientos almacenados no se admiten actualmente, cualquier característica que dependa de los procedimientos almacenados tampoco se admite actualmente.

Archivos de Configuración y Sus Rutas¶

• Todas las referencias a la adición de archivos de configuración y sus rutas se refieren a archivos y ubicaciones en Harmony Agente donde está instalado el conector. Estas rutas deben ajustarse según corresponda según el agente y el sistema operativo. Si se utilizan varios agentes en un grupo de agentes, se requerirán archivos idénticos en cada agente.

Características Avanzadas¶

Esta sección detalla una selección de funciones avanzadas del conector Sage Intacct.

Vistas definidas por el usuario

El conector le permite definir tablas virtuales, llamadas vistas definidas por el usuario, cuyo contenido se decide mediante una consultar preconfigurada. Estas vistas son útiles cuando no puede controlar directamente las consultas que se envían a los controladores. Consulte Vistas definidas por el usuario para obtener una descripción general de la creación y configuración de vistas personalizadas.

Configuración SSL

Usar Configuración SSL para ajustar cómo el conector maneja las negociaciones de certificados TLS/SSL. Puede elegir entre varios formatos de certificado; ver el SSLServerCert propiedad en "Opciones de cadena de conexión" para obtener más información.

Apoderado

Para configurar el conector mediante Configuración de proxy de Agente Privado, Selecciona el Use Proxy Settings casilla de verificación en la pantalla de configuración de la conexión.

Vistas Definidas por el Usuario¶

El conector Jitterbit para Sage Intacct le permite definir una tabla virtual cuyos contenidos se deciden mediante una consultar preconfigurada. Estas se denominan Vistas definidas por el usuario, que son útiles en situaciones en las que no puede controlar directamente la consultar que se envía al controlador, por ejemplo, cuando se utiliza el controlador de Jitterbit. Las vistas definidas por el usuario se pueden utilizar para definir predicados que siempre se aplican. Si especifica predicados adicionales en la consultar a la vista, se combinan con la consultar ya definida como parte de la vista.

Hay dos formas de crear vistas definidas por el usuario:

• Cree un archivo de configuración con formato JSON que defina las vistas que desea.
• Declaraciones DDL.

Definición de Vistas Usando un Archivo de Configuración¶

Las vistas definidas por el usuario se definen en un archivo de configuración con formato JSON llamado UserDefinedViews.json. El conector detecta automáticamente las vistas especificadas en este archivo.

También puede tener múltiples definiciones de vista y controlarlas usando UserDefinedViews propiedad de conexión. Cuando utiliza esta propiedad, el conector solo ve las vistas especificadas.

Este archivo de configuración de vista definida por el usuario tiene el siguiente formato:

• Cada elemento raíz define el nombre de una vista.
• Cada elemento raíz contiene un elemento hijo, llamado query, que contiene la consultar SQL personalizada para la vista.

Por ejemplo:

{
    "MyView": {
        "query": "SELECT * FROM Customer WHERE MyColumn = 'value'"
    },
    "MyView2": {
        "query": "SELECT * FROM MyTable WHERE Id IN (1,2,3)"
    }
}

Utilizar el UserDefinedViews propiedad de conexión para especificar la ubicación de su archivo de configuración JSON. Por ejemplo:

"UserDefinedViews", "C:\Users\yourusername\Desktop\tmp\UserDefinedViews.json"

Esquema para Vistas Definidas por el Usuario¶

Las vistas definidas por el usuario se exponen en UserViews esquema por defecto. Esto se hace para evitar que el nombre de la vista entre en conflicto con una entidad real en el modelo de datos. Puede cambiar el nombre del esquema utilizado para UserViews configurando UserViewsSchemaName propiedad.

Trabajar con Vistas Definidas por el Usuario¶

Por ejemplo, una instrucción SQL con una vista definida por el usuario llamada UserViews.RCustomers solo enumera clientes en Raleigh:

SELECT * FROM Customers WHERE City = 'Raleigh';

Un ejemplo de una consultar al controlador:

SELECT * FROM UserViews.RCustomers WHERE Status = 'Active';

Dando como resultado la consultar efectiva a la fuente:

SELECT * FROM Customers WHERE City = 'Raleigh' AND Status = 'Active';

Ese es un ejemplo muy simple de una consultar a una vista definida por el usuario que es efectivamente una combinación de la consultar de vista y la definición de vista. Es posible componer estas consultas en patrones mucho más complejos. Todas las operaciones de SQL están permitidas en ambas consultas y se combinan cuando corresponde.

Configuración SSL¶

Personalización de la Configuración SSL¶

De forma predeterminada, el conector intenta negociar SSL/TLS comparando el certificado del servidor con el almacén de certificados de confianza del sistema.

Para especificar otro certificado, consulte SSLServerCert propiedad de los formatos disponibles para hacerlo.

Modelo de Datos¶

Jitterbit Connector para Sage Intacct modela entidades de Sage Intacct en tablas relacionales.

Las definiciones de tabla se recuperan dinámicamente. Cualquier cambio que realice, como agregar una nueva tabla, agregar nuevas columnas o cambiar el tipo de datos de una columna, se reflejará inmediatamente cuando se conecte mediante el conector.

De forma predeterminada, solo la lista de las tablas a continuación admite la instrucción GETDELETED. Puede agregar soporte de declaración GETDELETED para otras tablas a través de GetdeletedTables propiedad de conexión, simplemente especificando la lista separada por comas de las tablas y sus correspondientes columnas clave.

La lista de tablas predeterminadas que admiten la declaración GETDELETED son: Contacto, Departamento, Glacctgrppurpose, Glbatch, Apaccountlabel, Aadjustment, Appymt, Apbill, Aradjustment, Arinvoice, Podocumentparams, Warehouse, Obspctcompleted, Task, Timesheet, Contractitempricelist, Contractdetail.

Las mesas y Vistas enumerados en la documentación son ejemplos de lo que puede tener acceso en su cuenta de Intacct.

Tenga en cuenta que hay varias tablas que tienen claves primarias requeridas separadas para INSERTAR y ELIMINAR. Dichas tablas (y sus claves primarias compuestas) se enumeran a continuación:

Procesamiento colaborativo de consultas

El conector descarga la mayor parte posible del procesamiento de la declaración SELECT a Sage Intacct y luego procesa el resto de la consultar en la memoria. Las limitaciones y los requisitos de la API también se documentan en esta sección.

Ver SupportEnhancedSQL para obtener más información sobre cómo el conector elude las limitaciones de la API con el procesamiento del lado del cliente en memoria.

Mesas¶

El conector modela los datos en Sage Intacct en una lista de tablas que se pueden consultar mediante instrucciones SQL estándar.

Generalmente, consultar tablas de Sage Intacct es lo mismo que consultar una tabla en una base de datos relacional. A veces hay casos especiales, por ejemplo, incluir una determinada columna en la cláusula WHERE puede ser necesario para obtener datos para ciertas columnas de la tabla. Esto suele ser necesario para situaciones en las que se debe realizar una solicitud separada para cada fila para obtener ciertas columnas. Estos tipos de situaciones están claramente documentados en la parte superior de la página de la tabla vinculada a continuación.

Conector Jitterbit para Tablas Sage Intacct¶

AcctLabelTaxGroupAcctLabelTaxGroup¶

Recupera datos del informe AcctLabelTaxGroup.

Columnas¶

Rango de Cuenta¶

Recupera datos del informe de rango de cuenta.

Columnas¶

Registro de Actividades¶

Recupera los datos del informe de ActivityLog.

Columnas¶

Pasillo¶

Recupera datos del informe de pasillo.

Columnas¶

Asignación¶

Recupera datos del informe de asignación.

Columnas¶

Etiqueta de Cuenta APA¶

Recupera datos del informe APAccountLabel.

Columnas¶

Ajuste APA¶

Recupera datos del informe de ajuste de APA.

Columnas¶

APBill¶

Recupera datos del informe APBill.

Columnas¶

APBillLote¶

Recupera datos del informe APBillBatch.

Columnas¶

APPymt¶

Recupera datos del informe de APPymt.

Columnas¶

APRecurBill¶

Recupera datos del informe APRecurBill.

Columnas¶

Término AP¶

Recupera datos del informe APTerm.

Columnas¶

Etiqueta de Cuenta AR¶

Recupera datos del informe ARAccountLabel.

Columnas¶

ARajuste¶

Recupera datos del informe ARAdjustment.

Columnas¶

ARIfactura¶

Recupera datos del informe ARInvoice.

Columnas¶

ARInvoiceBatch¶

Recupera datos del informe ARInvoiceBatch.

Columnas¶

Lote ARPago¶

Recupera datos del informe ARPaymentBatch.

Columnas¶

ARTérmino¶

Recupera datos del informe ARTerm.

Columnas¶

Asistente¶

Recupera datos de informes de asistentes.

Columnas¶

Contacto de Facturación¶

Recupera datos del informe Billing_Contact.

Columnas¶

Papelera¶

Recupera datos del informe Bin.

Columnas¶

PresupuestoEncabezado¶

Recupera datos del informe BudgetHeader.

Columnas¶

Cuenta Corriente¶

Recupera los datos del informe de cuenta de cheques.

Columnas¶

Clase¶

Recupera datos del informe de clase.

Columnas¶

Comentarios¶

Recupera datos del informe de comentarios.

Columnas¶

Contacto¶

Recupera datos del informe de contacto.

Columnas¶

Contrato¶

Una colección de elementos de contrato.

Columnas¶

Tarjeta de Crédito¶

Recupera datos de informes de tarjetas de crédito.

Columnas¶

Cliente¶

Recupera datos del informe del cliente.

Columnas¶