Detalles de Conexión de Zoho Books

Introducción

Versión del conector

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

Empezando

Compatibilidad con la versión de Zoho Books

El conector aprovecha la API de Zoho Books para habilitar el acceso bidireccional a Zoho Books.

Establecer una Conexión

Autenticación en Zoho Books

Zoho Books usa el estándar de autenticación OAuth. Para autenticarse mediante OAuth, deberá crear una aplicación para obtener el OAuthClientId, OAuthClientSecret, y CallbackURL propiedades de conexión. Consulte Uso de la autenticación OAuth para obtener una guía de autenticación.

Uso de la Autenticación OAuth

Utilice el estándar de autenticación OAuth para conectarse a Zoho Books. OAuth requiere que el usuario que se autentica interactúe con Zoho Books mediante el navegador.

Credenciales Personalizadas

Deberá registrar una aplicación para obtener el OAuthClientId, OAuthClientSecret. Consulte Credenciales personalizadas para un procedimiento.

Creación de una Aplicación OAuth Personalizada

Es posible que desee crear una aplicación OAuth personalizada para cambiar la información que se muestra cuando los usuarios inician sesión en Zoho Books. Puede registrar una aplicación para obtener el OAuthClientId, OAuthClientSecret, y OrganizationId.

Consulte Crear una aplicación OAuth personalizada para un procedimiento.

Credenciales Integradas

Autenticarse con las Credenciales de OAuth Integradas

Autenticación de Escritorio con la Aplicación OAuth Integrada

Puede conectarse sin configurar ninguna propiedad de conexión para sus credenciales de usuario. Después de configurar lo siguiente, está listo para conectarse:

• InitiateOAuth: Establézcalo en GETANDREFRESH. Puede usar InitiateOAuth para evitar repetir el intercambio de OAuth y configurar manualmente OAuthAccessToken.

Cuando se conecta, el conector abre el extremo de OAuth en su navegador predeterminado. Inicie sesión y otorgue permisos a la aplicación. Luego, el conector completa el proceso de OAuth.

1. Extrae el token de acceso de la URL de devolución de llamada y autentica las solicitudes.
2. Obtiene un nuevo token de acceso cuando caduca el antiguo.
3. Guarda los valores de OAuth en OAuthSettingsLocation para persistir a través de las conexiones.

Credenciales Personalizadas

Esta sección describe la autenticación de escritorio usando las credenciales para su aplicación OAuth personalizada. Consulte Crear una aplicación OAuth personalizada para más información.

Autenticación de Escritorio con Su Aplicación OAuth

Siga los pasos a continuación para autenticarse con las credenciales de una aplicación OAuth personalizada. Consulte Crear una aplicación OAuth personalizada.

Obtenga un Token de Acceso OAuth

Después de configurar lo siguiente, está listo para conectarse:

• OAuthClientId: establezca esto en la ID del cliente en la configuración de su aplicación.
• OAuthClientSecret: establezca esto en el secreto del cliente en la configuración de su aplicación.
• CallbackURL: establezca esto en la URL de redireccionamiento en la configuración de su aplicación.
• InitiateOAuth: Establézcalo en GETANDREFRESH. Puede usar InitiateOAuth para evitar repetir el intercambio de OAuth y configurar manualmente OAuthAccessToken.

Cuando se conecta, el conector abre el extremo de OAuth en su navegador predeterminado. Inicie sesión y otorgue permisos a la aplicación. Luego, el conector completa el proceso de OAuth:

1. Extrae el token de acceso de la URL de devolución de llamada y autentica las solicitudes.
2. Guarda los valores de OAuth en OAuthSettingsLocation para persistir a través de las conexiones.

Máquinas Sin Cabeza

Uso de OAuth en una Máquina Sin Cabeza

Para crear fuentes de datos de Zoho Books en servidores sin periféricos u otras máquinas en las que el conector no puede abrir un navegador, debe autenticarse desde otra máquina. La autenticación es un proceso de dos pasos.

1. En lugar de instalar el conector en otra máquina, puede seguir los pasos a continuación para obtener el OAuthVerifier valor. O bien, puede instalar el conector en otra máquina y transferir los valores de autenticación de OAuth, después de autenticarse a través del flujo habitual basado en el navegador.
2. A continuación, puede configurar el conector para actualizar automáticamente el token de acceso desde la máquina sin periféricos.

Uso de las Credenciales para una Aplicación OAuth Personalizada

Cree una aplicación OAuth personalizada

Consulte Crear una aplicación OAuth personalizada para un procedimiento. Luego puede seguir los procedimientos a continuación para autenticarse y conectarse a los datos.

Obtenga un código verificador

Establezca las siguientes propiedades en la máquina sin periféricos:

• InitiateOAuth: Ajústelo a APAGADO.
• OAuthClientId: establezca esto en la ID de la aplicación en la configuración de su aplicación.
• OAuthClientSecret: establezca esto en el secreto de la aplicación en la configuración de su aplicación.

Luego puede seguir los pasos a continuación para autenticarse desde otra máquina y obtener el OAuthVerifier propiedad de conexión.

1. Llame a GetOAuthAuthorizationURL procedimiento almacenado* con el parámetro de entrada CallbackURL establecido en el URI de redirección exacto que especificó en la configuración de su aplicación.
2. Abra la URL devuelta en un navegador. Inicie sesión y otorgue permisos al conector. A continuación, se le redirige a la URL de devolución de llamada, que contiene el código verificador.
3. Guarde el valor del código verificador. Establecerá esto en el OAuthVerifier propiedad de conexión.

En la máquina sin periféricos, establezca las siguientes propiedades de conexión para obtener los valores de autenticación de OAuth:

• OAuthClientId: establezca esto en la clave de consumidor en la configuración de su aplicación.
• OAuthClientSecret: establezca esto en el secreto del consumidor en la configuración de su aplicación.
• OAuthVerifier: Establézcalo en el código del verificador.
• OAuthSettingsLocation: configure esto para conservar los valores de autenticación OAuth cifrados en el archivo especificado.
• InitiateOAuth: Establézcalo en ACTUALIZAR.

Conectarse a datos

Después de generar el archivo de configuración de OAuth, configure las siguientes propiedades para conectarse a los datos:

• OAuthSettingsLocation: Establézcalo en el archivo que contiene los valores de autenticación de OAuth cifrados. Asegúrese de que este archivo otorgue permisos de lectura y escritura al proveedor para habilitar la actualización automática del token de acceso.
• InitiateOAuth: Establézcalo en ACTUALIZAR.

Transferir configuración de OAuth

Siga los pasos a continuación para instalar el conector en otra máquina, autenticar y luego transferir los valores de OAuth resultantes.

En una segunda máquina, instale el conector y conéctese con el siguiente conjunto de propiedades:

• OAuthSettingsLocation: establezca esto en un archivo de texto grabable.
• InitiateOAuth: Establézcalo en GETANDREFRESH.
• OAuthClientId: establezca esto en la ID del cliente en la configuración de su aplicación.
• OAuthClientSecret: establezca esto en el secreto del cliente en la configuración de su aplicación.
• CallbackURL: establezca esto en la URL de devolución de llamada en la configuración de su aplicación.

Pruebe la conexión para autenticarse. Los valores de autenticación resultantes se escriben, se cifran, en la ruta especificada por OAuthSettingsLocation. Una vez que haya probado con éxito la conexión, copie el archivo de configuración de OAuth en su máquina sin periféricos. En la máquina sin periféricos, configure las siguientes propiedades de conexión para conectarse a los datos:

• InitiateOAuth: Establézcalo en ACTUALIZAR.
• OAuthSettingsLocation: establezca esto en la ruta a su archivo de configuración de OAuth. Asegúrese de que este archivo otorgue permisos de lectura y escritura al conector para habilitar la actualización automática del token de acceso.

Creación de una Aplicación OAuth Personalizada

Para obtener un OAuthClientId, OAuthClientSecret, CallbackURL, y OrganizationId primero debe crear una aplicación vinculada a su cuenta de Zoho Books.

Crear y Configurar una Aplicación OAuth Personalizada

Primero deberá registrar su aplicación con la consola de desarrollador de Zoho para obtener su ID de cliente y Secreto de cliente. Puede crear una aplicación vinculada a su cuenta de Zoho Books de la siguiente manera:

1. Para registrar su aplicación, vaya a <https://accounts.zoho.com/developerconsole>.
2. Haga clic en Add Client ID, especifique un dominio de cliente de nombre de cliente.
3. Complete los detalles requeridos en el formulario.
   • Establecer el Auth Callback URL a https://localhost:33333 o un puerto diferente de su elección.
   • Puede elegir Tipo de cliente como Basado en WEB/Javascript/Móvil, luego haga clic en Create.
4. En Zoho Books, su empresa se denomina organización. Si tiene varias empresas, simplemente configure cada una de ellas como una organización individual. Cada organización es una organización independiente de Zoho Books con su propio ID de organización, moneda base, huso horario, idioma, contactos, informes, etc.
   • El parámetro organization_id junto con el ID de la organización debe enviarse con cada solicitud de API para identificar la organización.
   • Haga clic en Organization Name, en la sección superior derecha. Dentro de eso puede elegir el ID de la organización.
   • Si el valor de la ID de la organización no se especifica en la cadena de conexión, haremos una llamada para obtener todas las organizaciones disponibles y seleccionaremos la primera ID de la organización como la predeterminada.
5. Después de completar los cambios, el navegador le pedirá que guarde.

Una vez que haya terminado de crear un nuevo cliente, se mostrará en su pantalla. Desde allí, puede hacer clic en More Options > Edit para revelar el ID de cliente y el secreto de cliente de su aplicación recién creada. Ahora puede usar estas credenciales para conectarse a Zoho Books configurándolas como las siguientes propiedades de conexión:

• OAuthClientId = Identificación del cliente
• OAuthClientSecret = secreto del cliente
• CallbackURL = URL de devolución de llamada de autenticación

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 Zoho Books:

• OrganizationId: la identificación asociada con la organización específica de Zoho Books a la que desea conectarse. En Zoho Books, su empresa se denomina organización.
  Si tiene varios negocios, simplemente configure cada uno de ellos como una organización individual.
  Cada organización es una organización independiente de Zoho Books con su propio ID de organización, divisa base, huso horario, idioma, contactos, informes, etc.
  Si el valor de la ID de la organización no se especifica en la cadena de conexión, haremos una llamada para obtener todas las organizaciones disponibles y seleccionaremos la primera ID de la organización como la predeterminada.
  
• AccountsServer: La URL completa del servidor de la cuenta. La mayoría de las veces, el valor de esta propiedad será https://books.zoho.com, pero si su cuenta reside en una ubicación diferente, entonces el dominio debería cambiar en consecuencia (.eu, .in, .com.au, ...).

Características Avanzadas

Esta sección detalla una selección de características avanzadas del conector de Zoho Books.

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 Zoho Books 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 Utilizando 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 INVOICES 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

Descripción general

Esta sección muestra los objetos de API disponibles y proporciona más información sobre cómo ejecutar SQL en las APIs de Zoho Books.

Características clave

• El conector modela entidades de Zoho Books como facturas, cuentas y gastos como vistas relacionales, lo que le permite escribir SQL para consultar datos de Zoho Books.
• Procedimientos almacenados* le permiten ejecutar operaciones en Zoho Books, incluido el recibo de gastos, el archivo adjunto de la factura de anticipo y los archivos adjuntos.
• La conectividad en vivo con estos objetos significa que cualquier cambio en su cuenta de Zoho Books se refleja de inmediato al usar el conector.
• IncludeCustomFields la propiedad de conexión le permite recuperar campos personalizados para las vistas admitidas. Establezca esta propiedad en True para habilitar esta función.

Puntos de vista

Puntos de vista describe las vistas disponibles. Las vistas se definen estáticamente para modelar facturas, facturas, gastos y más.

Procedimientos almacenados

NOTE: Los procedimientos almacenados no se admiten actualmente. Consulte la nota anterior para detalles.

Procedimientos almacenados son interfaces similares a funciones para Zoho Books. Procedimientos almacenados* le permiten ejecutar operaciones en Zoho Books, incluido el recibo de gastos, el archivo adjunto de la factura de anticipo y los archivos adjuntos.

Procesamiento colaborativo de consultas

El conector descarga la mayor parte posible del procesamiento de la instrucción SELECT en Zoho Books 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.

Puntos de Vista

Las vistas se componen de columnas y pseudocolumnas. Las vistas son similares a las tablas en la forma en que se representan los datos; sin embargo, las vistas no admiten actualizaciones. Las entidades que se representan como vistas suelen ser entidades de solo lectura. A menudo, un procedimiento almacenado* está disponible para actualizar los datos si dicha funcionalidad es aplicable a la fuente de datos.

Las consultas se pueden ejecutar contra una vista como si fuera una tabla normal, y los datos que regresan son similares en ese sentido. Para obtener más información sobre las tablas y los procedimientos almacenados, vaya a sus entradas correspondientes en este documento de ayuda.

Conector Jitterbit para Vistas de Zoho Books

Cuentas Bancarias

Recupera la lista de todas las cuentas bancarias y de tarjetas de crédito de su organización.

Información Específica de la Tabla

Seleccionar

El conector utilizará la API de Zoho Books para procesar las condiciones de la cláusula WHERE creadas con la siguiente columna y operador. El resto del filtro se ejecuta del lado del cliente dentro del conector.

• AccountId admite la comparación '='.
• AccountCodeAccountName admite la comparación '='.
• AccountType admite la comparación '='.
• Status admite la comparación '='.

Por ejemplo:

SELECT * FROM BankAccounts WHERE Status = 'All'

SELECT * FROM BankAccounts WHERE AccountId = '1894343000000085314'

Columnas

Pseudo-Columnas

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

BankMatchingTransactions

Recupera la lista de transacciones que incluye facturas/facturas/notas de crédito.

Información Específica de la Tabla

Seleccionar

El conector utilizará la API de Zoho Books para procesar las condiciones de la cláusula WHERE creadas con la siguiente columna y operador. El resto del filtro se ejecuta del lado del cliente dentro del conector. Incluso puede proporcionar criterios para buscar transacciones coincidentes sin categorizar.

• TransactionId admite la comparación '='.
• TransactionType admite la comparación '='.
• ReferenceNumber admite la comparación '='.
• Date admite '=,<,>' comparaciones
• Contact admite la comparación '='.
• ShowAllTransactions. admite la comparación '='.

Por ejemplo:

SELECT * FROM BankMatchingTransactions WHERE TransactionId = '1894578000000087001

Columnas

Pseudo-Columnas

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

BancoReglaCriterios

Obtener criterios de una regla bancaria específica.

Información Específica de la Tabla

Seleccionar

El conector utilizará la API de Zoho Books para procesar las condiciones de la cláusula WHERE creadas con la siguiente columna y operador. El resto del filtro se ejecuta del lado del cliente dentro del conector.

• RuleAccountId admite la comparación '='.

Por ejemplo:

SELECT * FROM BankRuleCriterions WHERE RuleAccountId = '1894553000000085382

Columnas

Reglas Bancarias

Obtenga todas las reglas o una regla específica creada para un ID de cuenta de tarjeta de crédito o banco específico.

Información Específica de la Tabla

Seleccionar

El conector utilizará la API de Zoho Books para procesar las condiciones de la cláusula WHERE creadas con la siguiente columna y operador. El resto del filtro se ejecuta del lado del cliente dentro del conector.

• RuleAccountId admite la comparación '='.
• RuleId admite la comparación '='.

Por ejemplo:

SELECT * FROM BankRules WHERE RuleAccountId = '1894553000000085382' AND RuleId = '1894553000000085386'

Columnas

BankTransactionLineItems

Obtenga detalles de las líneas de transacciones bancarias.

Información Específica de la Tabla

Seleccionar

El conector utilizará la API de Zoho Books para procesar las condiciones de la cláusula WHERE creadas con la siguiente columna y operador. El resto del filtro se ejecuta del lado del cliente dentro del conector.
Nota: Se requiere TransactionId para consultar BankTransactionLineItems.

• TransactionId admite la comparación '='.

Por ejemplo:

SELECT * FROM BankTransactionLineItems WHERE TransactionId = '1894553000000098001'

Columnas

Transacciones Bancarias

Obtenga todos los detalles de las transacciones involucradas en una cuenta.

Información Específica de la Tabla

Seleccionar

El conector utilizará la API de Zoho Books para procesar las condiciones de la cláusula WHERE creadas con la siguiente columna y operador. El resto del filtro se ejecuta del lado del cliente dentro del conector.

• AccountId admite la comparación '='.
• TransactionType admite la comparación '='.
• Amount admite la comparación '='.
• Date admite la comparación '='.
• ReferenceNumber admite la comparación '='.
• Status admite la comparación '='.
• BankTransactionFilter admite la comparación '='.

Por ejemplo:

SELECT * FROM BankTransactions WHERE Status = 'All'

SELECT * FROM BankTransactions LIMIT 5

Columnas

Pseudo-Columnas

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

Cuentas de Ajuste de Moneda Base

Recupera listas de cuentas de ajuste de moneda base.

Información Específica de la Tabla

Seleccionar

El conector utilizará la API de Zoho Books para procesar las condiciones de la cláusula WHERE creadas con la siguiente columna y operador. El resto del filtro se ejecuta del lado del cliente dentro del conector.

• BaseCurrencyAdjustmentId admite la comparación '='.

Por ejemplo:

SELECT * FROM BaseCurrencyAdjustmentAccounts WHERE BaseCurrencyAdjustmentId = '1894553000000000065'

Columnas

Ajustes de Moneda Base

Recupera la lista de ajuste de moneda base.

Información Específica de la Tabla

Seleccionar

El conector utilizará la API de Zoho Books para procesar las condiciones de la cláusula WHERE creadas con la siguiente columna y operador. El resto del filtro se ejecuta del lado del cliente dentro del conector. De forma predeterminada, la respuesta mostrará los ajustes de moneda base del mes actual únicamente.

• BaseCurrencyAdjustmentId admite la comparación '='.
• BaseCurrencyAdjustmentsFilter admite la comparación '='.

Por ejemplo:

SELECT * FROM BaseCurrencyAdjustments WHERE BaseCurrencyAdjustmentsFilter = 'Date.All'

Columnas

Pseudo-Columnas

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

FacturaDetalles

Obtener los detalles de una factura.

Información Específica de la Tabla

Seleccionar

El conector utilizará la API de Zoho Books para procesar las condiciones de la cláusula WHERE creadas con la siguiente columna y operador. El resto del filtro se ejecuta del lado del cliente dentro del conector.
Nota: Se requiere BillId para consultar BillDetails.

• BillId admite la comparación '='.

Por ejemplo:

SELECT * FROM BillDetails WHERE BillId = '1894553000000085259'

Columnas

BillLineItems

Obtener los detalles de una partida de facturas.

Información Específica de la Tabla

Seleccionar

El conector utilizará la API de Zoho Books para procesar las condiciones de la cláusula WHERE creadas con la siguiente columna y operador. El resto del filtro se ejecuta del lado del cliente dentro del conector.
Nota: Se requiere BillId para consultar BillLineItems.

• BillId admite la comparación '='.

Por ejemplo:

SELECT * FROM BillLineItems WHERE BillId = '1894253000000085259'

Columnas

Pagos de Facturas

Obtener la lista de pagos realizados para una factura.

Información Específica de la Tabla

Seleccionar

El conector utilizará la API de Zoho Books para procesar las condiciones de la cláusula WHERE creadas con la siguiente columna y operador. El resto del filtro se ejecuta del lado del cliente dentro del conector.

• BillId admite la comparación '='.

Por ejemplo:

SELECT * FROM BillPayments WHERE BillId = '1894253000000085259'

Columnas

Facturas

Recupera lista de facturas.

Información Específica de la Tabla

Seleccionar

El conector utilizará la API de Zoho Books para procesar las condiciones de la cláusula WHERE creadas con la siguiente columna y operador. El resto del filtro se ejecuta del lado del cliente dentro del conector.

• BillNumber admite la comparación '='.
• Date admite '=,<,>' comparaciones
• LastModifiedTime admite la comparación '='.
• ReferenceNumber admite la comparación '='.
• Status admite la comparación '='.
• Total admite las comparaciones '=,<,<=,>,>='.
• VendorId admite la comparación '='.
• VendorName admite la comparación '='.
• PurchaseOrderId admite la comparación '='.
• RecurringBillId admite la comparación '='.
• BillFilter admite la comparación '='.
• ItemId admite la comparación '='.
• ItemDescription. admite la comparación '='.

Por ejemplo:

SELECT * FROM Bills WHERE Total < 100 AND Total <= 98

SELECT * FROM Bills WHERE Date < '2018-07-03'

SELECT * FROM Bills WHERE CONTAINS(BillNumber,'Bi')

Columnas

Pseudo-Columnas

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

ChartOfAccountInlineTransactions

Recupera la lista de transacciones en línea.

Información Específica de la Tabla

Seleccionar

El conector utilizará la API de Zoho Books para procesar las condiciones de la cláusula WHERE creadas con la siguiente columna y operador. El resto del filtro se ejecuta del lado del cliente dentro del conector.

• ChartAccountId admite la comparación '='.

Por ejemplo:

SELECT * FROM ChartOfAccountInlineTransactions WHERE ChartAccountId = '1894553000000003003'

Columnas

Catálogo de Cuentas

Recupera la lista de todos los planes de cuentas.

Información Específica de la Tabla

Seleccionar

El conector utilizará la API de Zoho Books para procesar las condiciones de la cláusula WHERE creadas con la siguiente columna y operador. El resto del filtro se ejecuta del lado del cliente dentro del conector. Incluso puede proporcionar criterios para buscar transacciones coincidentes sin categorizar.

• LastModifiedTime admite la comparación '='.
• ShowBalance admite la comparación '='.
• AccountType admite la comparación '='.

Por ejemplo:

SELECT * FROM ChartOfAccounts WHERE AccountType = 'All' AND ShowBalance = true

Columnas

Pseudo-Columnas

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

ChartOfAccountTransactions

Recupera la lista de todas las transacciones involucradas para la cuenta dada.

Información Específica de la Tabla

Seleccionar

El conector utilizará la API de Zoho Books para procesar las condiciones de la cláusula WHERE creadas con la siguiente columna y operador. El resto del filtro se ejecuta del lado del cliente dentro del conector. Incluso puede proporcionar criterios para buscar transacciones coincidentes sin categorizar.

• ChartAccountId admite la comparación '='.
• TransactionType admite la comparación '='.
• Date admite '=,<,>' comparaciones
• Amount admite las comparaciones '=,<,<=,>,>='.

Por ejemplo:

SELECT * FROM ChartOfAccountTransactions WHERE ChartAccountId = '1894553000000003001' AND TransactionType = 'opening_balance'

Columnas

Pseudo-Columnas

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

Direcciones de Contacto

Obtenga las direcciones de un contacto, incluida su dirección de envío, dirección de facturación.

Información Específica de la Tabla

Seleccionar

El conector utilizará la API de Zoho Books para procesar las condiciones de la cláusula WHERE creadas con la siguiente columna y operador. El resto del filtro se ejecuta del lado del cliente dentro del conector.

• ContactId admite la comparación '='.

Por ejemplo:

SELECT * FROM ContactAddresses WHERE ContactId = '1894952000000071009'

Columnas

Detalles de Contacto

Obtener detalles de un contacto.

Información Específica de la Tabla

Seleccionar

El conector utilizará la API de Zoho Books para procesar las condiciones de la cláusula WHERE creadas con la siguiente columna y operador. El resto del filtro se ejecuta del lado del cliente dentro del conector.
Nota: Se requiere ContactId para consultar ContactDetails.

• ContactId admite la comparación '='.

Por ejemplo:

SELECT * FROM ContactDetails WHERE ContactId = '1894952000000071009'

Columnas

Contactos

Recupera la lista de todos los contactos.

Información Específica de la Tabla

Seleccionar

El conector utilizará la API de Zoho Books para procesar las condiciones de la cláusula WHERE creadas con la siguiente columna y operador. El resto del filtro se ejecuta del lado del cliente dentro del conector.

• ContactName admite la comparación '='.
• CompanyName admite la comparación '='.
• Status admite la comparación '='.
• FirstName admite la comparación '='.
• LastName admite la comparación '='.
• Email admite la comparación '='.
• Phone admite la comparación '='.
• Address admite la comparación '='.
• PlaceOfContact admite la comparación '='.

Por ejemplo:

SELECT * FROM Contacts WHERE CONTAINS(LastName,'D')

SELECT * FROM Contacts WHERE FirstName = 'John' AND Status = 'Active'

SELECT * FROM Contacts LIMIT 5

Columnas

Pseudo-Columnas

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

Detalles de la Nota de Crédito

Recupera detalles de una nota de crédito existente.

Información Específica de la Tabla

Seleccionar

El conector utilizará la API de Zoho Books para procesar las condiciones de la cláusula WHERE creadas con la siguiente columna y operador. El resto del filtro se ejecuta del lado del cliente dentro del conector.
Nota: Se requiere CreditnoteId para consultar CreditNoteDetails.

• CreditnoteId admite la comparación '='.

Por ejemplo:

SELECT * FROM CreditNoteDetails WHERE CreditnoteId = '1895452000000083136'

Columnas

Nota de Créditofacturas

Recupera detalles de facturas de una nota de crédito existente.

Información Específica de la Tabla

Seleccionar

El conector utilizará la API de Zoho Books para procesar las condiciones de la cláusula WHERE creadas con la siguiente columna y operador. El resto del filtro se ejecuta del lado del cliente dentro del conector.
Nota: Se requiere CreditnoteId para consultar CreditNoteInvoices.

• CreditnoteId admite la comparación '='.

Por ejemplo:

SELECT * FROM CreditNoteInvoices WHERE CreditnoteId = '1895452000000083136'

Columnas

CreditNoteLineItems

Recupera detalles de elementos de línea de notas de crédito existentes.

Información Específica de la Tabla

Seleccionar

El conector utilizará la API de Zoho Books para procesar las condiciones de la cláusula WHERE creadas con la siguiente columna y operador. El resto del filtro se ejecuta del lado del cliente dentro del conector.
Nota: Se requiere CreditnoteId para consultar CreditNoteLineItems.

• CreditnoteId admite la comparación '='.

Por ejemplo:

SELECT * FROM CreditNoteLineItems WHERE CreditnoteId = '1895452000000083136'

Columnas

Notas de Crédito

Recupera la lista de todas las Notas de Crédito.

Información Específica de la Tabla

Seleccionar

El conector utilizará la API de Zoho Books para procesar las condiciones de la cláusula WHERE creadas con la siguiente columna y operador. El resto del filtro se ejecuta del lado del cliente dentro del conector.

• CreditnoteNumber admite la comparación '='.
• CustomerId admite la comparación '='.
• CustomerName admite la comparación '='.
• Date admite la comparación '='.
• ReferenceNumber admite la comparación '='.
• Status admite la comparación '='.
• Total admite la comparación '='.
• CreditNoteFilter admite la comparación '='.
• LineItemId admite la comparación '='.
• TaxId admite la comparación '='.
• ItemId admite la comparación '='.
• ItemName admite la comparación '='.
• ItemDescription admite la comparación '='.

Por ejemplo:

SELECT * FROM CreditNotes WHERE CreditnoteNumber = 'CN-00006' AND ReferenceNumber = 'Ref-0075' AND CustomerName = 'AWS Stores'

SELECT * FROM CreditNotes WHERE CreditNoteFilter = 'Status.All'

Columnas

Pseudo-Columnas

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

Monedas

Obtenga la lista de monedas configuradas. Además, obtenga los detalles de una moneda.

Información Específica de la Tabla

Seleccionar

El conector utilizará la API de Zoho Books para procesar las condiciones de la cláusula WHERE creadas con la siguiente columna y operador. El resto del filtro se ejecuta del lado del cliente dentro del conector.

• CurrencyFilter admite la comparación '='.
• CurrencyId admite la comparación '='.

Por ejemplo:

SELECT * FROM Currencies WHERE CurrencyId = '1894553000000000099'

SELECT * FROM Currencies WHERE CurrencyFilter = 'Currencies.ExcludeBaseCurrency'

Columnas

Pseudo-Columnas

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

Los Tipos de Cambio

Recupera la lista de tipos de cambio configurados para la moneda.

Información Específica de la Tabla

Seleccionar

El conector utilizará la API de Zoho Books para procesar las condiciones de la cláusula WHERE creadas con la siguiente columna y operador. El resto del filtro se ejecuta del lado del cliente dentro del conector.

• FromDate admite la comparación '='.
• IsCurrentDate admite la comparación '='.
• CurrencyId admite la comparación '='.

Por ejemplo:

SELECT * FROM CurrencyExchangeRates WHERE CurrencyId = '1894553000000000089'

SELECT * FROM CurrencyExchangeRates WHERE CurrencyId = '1894553000000000087' AND IsCurrentDate = true

Columnas

Pseudo-Columnas

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

ClienteContactos

Recupera la lista de todas las personas de contacto. Además, obtenga los datos de la persona de contacto.

Información Específica de la Tabla

Seleccionar

El conector utilizará la API de Zoho Books para procesar las condiciones de la cláusula WHERE creadas con la siguiente columna y operador. El resto del filtro se ejecuta del lado del cliente dentro del conector.

• ContactId admite la comparación '='.
• CustomerContactId admite la comparación '='.

Por ejemplo:

SELECT * FROM CustomerContacts WHERE ContactId = '1864553000000072009' AND CustomerContactId = '1896253000000071011'

Columnas

Detalles del Pago del Cliente

Recupera detalles de un pago existente.

Información Específica de la Tabla

Seleccionar

El conector utilizará la API de Zoho Books para procesar las condiciones de la cláusula WHERE creadas con la siguiente columna y operador. El resto del filtro se ejecuta del lado del cliente dentro del conector.
Nota: Se requiere PaymentId para consultar CustomerPaymentDetails.

• PaymentId admite la comparación '='.

Por ejemplo:

SELECT * FROM CustomerPaymentDetails WHERE PaymentId = '1894553000000083001'

Columnas

ClientePagos

Recupera la lista de todos los pagos realizados por su cliente.

Información Específica de la Tabla

Seleccionar

El conector utilizará la API de Zoho Books para procesar las condiciones de la cláusula WHERE creadas con la siguiente columna y operador. El resto del filtro se ejecuta del lado del cliente dentro del conector.

• PaymentMode admite la comparación '='.
• Amount admite las comparaciones '=,<,<=,>,>='.
• CustomerName admite la comparación '='.
• Date admite la comparación '='.
• ReferenceNumber admite la comparación '='.
• PaymentModeFilter admite la comparación '='.
• Notes admite la comparación '='.

Por ejemplo:

SELECT * FROM CustomerPayments WHERE Amount < 900 AND Amount > 50 AND ReferenceNumber = '1894553000000079879'

SELECT * FROM CustomerPayments WHERE CustomerName = 'Harry'

SELECT * FROM CustomerPayments WHERE CONTAINS(ReferenceNumber,'455')

Columnas

Pseudo-Columnas

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

Empleados

Recupera lista de empleados. Además, obtenga los detalles de un empleado.

Información Específica de la Tabla

Seleccionar

El conector utilizará la API de Zoho Books para procesar las condiciones de la cláusula WHERE creadas con la siguiente columna y operador. El resto del filtro se ejecuta del lado del cliente dentro del conector.

• EmployeeId admite la comparación '='.
• Status admite la comparación '='.