Detalles de Conexión del Punto de Venta de QuickBooks¶

Introducción¶

Versión del conector

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

Empezando¶

Compatibilidad con la versión POS de QuickBooks

El Jitterbit Connector para QuickBooks POS es compatible con las ediciones básica y profesional de punto de venta de QuickBooks. No se admite la edición QuickBooks Point of Sale Multi-Store.

Establecer una Conexión¶

Conexión a QuickBooks¶

El conector realiza solicitudes a QuickBooks POS a través de QuickBooks Gateway. QuickBooks Gateway se ejecuta en la misma máquina que QuickBooks POS y acepta conexiones a través de un servidor web ligero e integrado. El servidor admite SSL/TLS, lo que permite a los usuarios conectarse de forma segura desde máquinas remotas. La primera vez que se conecte, deberá autorizar el conector con QuickBooks POS. Para obtener más información, consulte nuestro Uso de QuickBooks Gateway guía.

Para trabajar con sus datos en el modo de práctica, configure QBPOSPractice. Además, establezca QBPOSVersion.

Conexión a un Archivo de Empresa Local¶

Siga los pasos a continuación para autorizar con QuickBooks POS y conectarse a un archivo de la empresa cuando tanto QuickBooks POS como el conector se estén ejecutando en su máquina local.

1. Abra QuickBooks POS como administrador y abra el archivo de la empresa al que desea conectarse.

2. Conéctese a QuickBooks POS. Aparecerá un cuadro de diálogo en QuickBooks POS que le pedirá que autorice el conector. Después de otorgar acceso al conector, ahora puede ejecutar comandos en QuickBooks POS.

3. Si desea conectarse al archivo de la empresa cuando QuickBooks POS está cerrado, configure CompanyFile opción de conexión cuando ejecutas comandos. QuickBooks POS se abrirá automáticamente en segundo plano con el archivo especificado.

   Tenga en cuenta que si QuickBooks POS está abierto a través de la interfaz de usuario de la aplicación, solo eso CompanyFile puede ser usado.

Solución de Problemas de Conexión¶

Si recibe un error de conexión (como "Error interno 160002"), es posible que deba cambiar QuickBooks POS al modo multiusuario. Esto se hace seleccionando la opción "Cambiar archivo de empresa a modo multiusuario" en el menú Archivo. A continuación, debería poder conectarse al archivo de la empresa.

Si un CompanyFile no se especifica en la cadena de conexión, QuickBooks POS puede presentar una ventana "Ingrese el nombre de la empresa" la primera vez que se conecte. En esta ventana debe especificar el archivo de la empresa y el nombre del equipo donde se encuentra el archivo de la empresa.

Uso del Conector Remoto¶

El conector remoto se puede usar para leer y escribir en QuickBooks POS en situaciones en las que el acceso COM directo a QuickBooks POS no está disponible (por ejemplo, ASP.NET, Java o QuickBooks POS en una máquina remota). Siga el procedimiento a continuación para conectarse a QuickBooks POS por primera vez a través del conector remoto:

1. Si aún no lo ha hecho, descargue Remote Connector desde aquí e instale el conector remoto en la máquina donde está instalado QuickBooks POS.

2. Abra el archivo de la empresa al que desea conectarse en QuickBooks POS utilizando una cuenta de administrador en modo de usuario único.

3. Abra Remote Connector desde la bandeja del sistema y agregue un usuario en la pestaña Usuarios. Introduzca un Usuario y una Contraseña y seleccione el nivel de acceso en el menú Acceso a datos.

   Nota: El conector remoto no utiliza las propiedades de usuario y contraseña para acceder a QuickBooks POS; las propiedades Usuario y Contraseña autentican al usuario en el conector remoto. La autenticación en QuickBooks POS se maneja en función de ApplicationName propiedad.

4. Cuando se conecte por primera vez, aparecerá un cuadro de diálogo en QuickBooks POS que le pedirá que autorice la aplicación. Después de autorizar la aplicación, puede ejecutar comandos en QuickBooks POS. Especifica el URL del Conector Remoto y el User y Password. De forma predeterminada, Remote Connector se conecta al archivo de la empresa actualmente abierto.

5. Si desea acceder a QuickBooks POS cuando QuickBooks POS no se está ejecutando, guarde la información del archivo de la empresa para el usuario. El conector remoto abrirá automáticamente QuickBooks POS en segundo plano con el archivo de la empresa para ese usuario.

Tenga en cuenta que si la interfaz de usuario de QuickBooks POS está abierta, solo puede conectarse al archivo de esa empresa. Además, tenga en cuenta que los permisos de usuario con los que ejecuta Remote Connector deben coincidir con los permisos de usuario con los que ejecuta QuickBooks POS. El proceso de instalación de Remote Connector instala Remote Connector como un servicio en la cuenta de usuario actual.

¿Cómo me conecto a QuickBooks POS a través de SSL/TLS?¶

Puede habilitar SSL/TLS en la pestaña Avanzado.

También deberá enviar su certificado de clave pública al conector. Puede hacerlo configurando SSLServerCert propiedad.

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.

Conector remoto¶

QuickBooks Gateway para QuickBooks POS es una aplicación sencilla que facilita las conexiones a los archivos de la empresa desde su aplicación. QuickBooks Gateway acepta conexiones a través de un servidor web integrado liviano que se ejecuta en la máquina donde está instalado QuickBooks POS. El servidor admite SSL/TLS, lo que permite a los usuarios conectarse de forma segura desde máquinas remotas.

La primera vez que se conecta a QuickBooks POS, debe autorizar su aplicación. Como complemento de la autenticación por aplicación de QuickBooks POS, QuickBooks Gateway tiene autenticación por usuario. Antes de conectarse a QuickBooks POS por primera vez, configure al menos un usuario de QuickBooks Gateway.

Puede configurar usuarios a través de la interfaz de usuario en Usuarios pestaña. A continuación, puede seguir el procedimiento de "Introducción" para conectar una aplicación a QuickBooks POS. Después de conectarse, puede monitorear las conexiones de QuickBooks POS en el Estado pestaña.

Se recomienda configurar QuickBooks Gateway en la interfaz de usuario, pero también puede ejecutar QuickBooks Gateway desde la línea de comandos. Esto puede simplificar la despliegue de QuickBooks Gateway en escenarios donde normalmente no hay un usuario conectado, como ejecutar un servidor web. Vea Avanzado para configurar QuickBooks Gateway cuando no esté utilizando la interfaz de usuario.

QuickBooks Gateway administra automáticamente la conexión a QuickBooks POS, pero puede configurar casi todos los aspectos de cómo los usuarios se conectan a QuickBooks POS a través de QuickBooks Gateway. Las siguientes páginas describen las capacidades de QuickBooks Gateway y cómo comenzar.

Usuarios¶

La pestaña Usuarios proporciona una interfaz para agregar, editar y eliminar usuarios. Se debe agregar al menos un usuario antes de comunicarse con QuickBooks POS.

Esta pestaña muestra una lista de usuarios existentes junto con información sobre la configuración del usuario.

Al agregar o editar un usuario, las siguientes opciones están disponibles:

• User: Establece el nombre de usuario. Esto es requerido.
• Password: Establece la contraseña para el usuario. Esto es necesario cuando se utiliza la autenticación básica (predeterminada).
• Company File: Especifica la ficha de empresa con la que se comunicará la aplicación. De forma predeterminada, este es el archivo de la empresa que está actualmente abierto en QuickBooks POS. Establézcalo en el nombre del archivo de la empresa (Nota: si especifica la ruta completa del archivo, aparecerá el error "No se puede conectar a la base de datos" de QuickBooks POS). Se debe especificar un archivo de empresa para acceder al archivo de empresa cuando se cierra QuickBooks POS.
• Authentication: Especifica el tipo de autenticación a realizar cuando el usuario se conecta. QuickBooks Gateway admite los siguientes métodos de autenticación: | | | |-----------------------------------------------------|------- -------------------------------------------------- -------------------------------------------------- -------------------------------------------------- -------------------------------------------------- ----------------------------------| | | | | Autenticación básica (predeterminada): | Autentica al usuario con un nombre de usuario y contraseña. | | Autenticación de Windows: | Autentica al usuario como usuario de Windows. En este caso, el campo Contraseña no es aplicable. Cuando QuickBooks Gateway recibe una solicitud de conexión, autenticará al usuario en Windows utilizando las credenciales proporcionadas en la solicitud. |
• Application Name: Establece opcionalmente el nombre de la aplicación como se ve en QuickBooks POS. La autenticación en QuickBooks POS se maneja en función del nombre de la aplicación proporcionada.
• Data Access: Especifica el acceso permitido para el usuario. | | | |----------------|-------------------------------------------- -------------------------------------------------- -------| | | | | Completo: | Permite acceso de lectura y escritura para el usuario. | | Solo lectura: | Restringe al usuario a operaciones de solo lectura. Los datos de QuickBooks POS no se pueden modificar. |

El botón Probar conexión proporciona una forma rápida de verificar que la aplicación pueda conectarse con QuickBooks POS.

Cuando se agrega un usuario, QuickBooks Gateway le pedirá que autorice la aplicación con QuickBooks POS si es necesario.

Estado¶

La pestaña Estado proporciona un registro de la actividad que ocurre con QuickBooks Gateway. Los registros se pueden borrar o copiar haciendo clic con el botón derecho en la ventana Actividad reciente.

Puede ajustar el detalle de los registros para incluir información útil al solucionar problemas: Seleccione la granularidad en el menú Modo de registro en la pestaña Avanzado. En la pestaña Avanzado, también puede configurar QuickBooks Gateway para escribir registros en un archivo y seleccionar el intervalo de rotación de registros.

Avanzado¶

La pestaña Avanzado permite un control granular sobre el servidor de QuickBooks Gateway. QuickBooks Gateway contiene un servidor web incorporado que se ejecuta como un servicio de Windows y escucha las solicitudes HTTP. Cada solicitud contiene los datos XML que se comunicarán a QuickBooks POS, así como los ajustes de configuración que especifican cómo se abrirá la conexión. QuickBooks Gateway luego se comunica con QuickBooks POS a través de COM y devuelve la respuesta de QuickBooks POS (o un mensaje de error) en la respuesta HTTP.

Este capítulo detalla cómo controlar cada uno de estos aspectos de la conexión a QuickBooks POS a través de la interfaz de usuario, la interfaz de línea de comandos y el registro. Las siguientes secciones detallan las opciones disponibles en la pestaña Avanzado.

Opciones de registro¶

• Write Logs to a Folder: Habilita o deshabilita la escritura de archivos de registro en la carpeta especificada además de la escritura de registros en la pestaña Estado.
• Folder: Especifica la carpeta donde se escriben los archivos de registro.
• Log Rotation: Determina cómo se organizan los registros en el disco. Crea un archivo para cada día, semana o mes, según los siguientes valores: | | | |--------------------------------------|------------------------------------- -------------------------------------------------- -------------------------------------------------- ----------------------------------| | | | | Diariamente (predeterminado): | Utiliza un nuevo archivo de registro todos los días. Los archivos se escriben con el formato "yyyy_MM_dd.txt". Por ejemplo, "2013_09_23.txt". | | Semanalmente: | Utiliza un nuevo archivo de registro cada semana. Los archivos se escriben con el formato "yyyy_ww.txt". Por ejemplo, "2013_34.txt", donde 34 significa que es la semana 34 de 2013. | | Mensual: | Utiliza un nuevo archivo de registro cada mes. Los archivos se escriben con el formato "yyyy_mm.txt". Por ejemplo, "2013_09.txt". |
• Log Mode: Establece la verbosidad de la salida del registro. En la mayoría de las situaciones, Info (el valor predeterminado) es suficiente. La opción Verbose es útil para fines de depuración.

Opciones IP¶

• Port: El puerto en el que escucha el servidor.
• Allowed Clients: Una lista separada por comas de nombres de alojar o direcciones IP que pueden acceder al servidor. Se admite el carácter comodín '*'. Si no se especifica (predeterminado), cualquier cliente puede conectarse.

Habilitación de conexiones persistentes¶

Todas las comunicaciones con los archivos de la empresa QuickBooks POS deben pasar primero por QuickBooks POS. Si QuickBooks POS está cerrado, esto significa que para cada intento de conectarse al archivo de la empresa, QuickBooks POS debe iniciarse y luego cerrarse nuevamente. De forma predeterminada, QuickBooks Gateway pone en cola las solicitudes de datos y realiza la autenticación necesaria para cada solicitud. Las siguientes opciones se pueden usar para anular este comportamiento y mantener activa la conexión con el archivo de la empresa después de que la consultar termine de ejecutarse, de modo que las solicitudes posteriores respondan más rápidamente.

Advertencia: si un usuario intenta abrir manualmente QuickBooks POS mientras se abre una conexión persistente, QuickBooks POS generará un error que indica que el archivo de la empresa ya está en uso.

• Enable Persistent Connection: Esto está deshabilitado de forma predeterminada: normalmente su código controla cuándo se abre y se cierra la conexión a QuickBooks POS llamando a los métodos Abrir y Cerrar; sin embargo, cuando esta configuración está habilitada, QuickBooks Gateway establece una conexión persistente con QuickBooks POS incluso cuando no se usan Abrir y Cerrar. Esto permite que varias aplicaciones compartan la conexión y accedan simultáneamente a QuickBooks Gateway.
• Idle Timeout: Establece el tiempo de espera inactivo para la conexión persistente en segundos. Esto solo es aplicable a la conexión persistente. Si no hay actividad dentro de esta ventana de tiempo, QuickBooks Gateway cierra la conexión.

Habilitación de TLS/SSL¶

Habilite TLS (1.x) para cifrar la comunicación entre su aplicación y QuickBooks Gateway. TLS/SSL utiliza certificados digitales para proteger la confidencialidad, integridad y autenticidad de sus datos: puede generar estos certificados en la pestaña Avanzado. Una vez que haya habilitado TLS, deberá enviar su certificado de clave pública a cualquier aplicación que se conecte.

Las siguientes opciones se utilizan para configurar TLS/SSL:

• Enable TLS: Habilita o deshabilita la comunicación TLS (1.x).
• Select Certificate: Carga un certificado existente.
• Generate Certificate: Crea un nuevo certificado.

Cargar un certificado muestra información sobre el certificado; las propiedades del certificado no se pueden establecer directamente. Nota: Habilitar TLS deshabilita las conexiones de texto sin formato.

Interfaz de línea de comandos¶

Además de la interfaz de usuario, QuickBooks Gateway tiene una interfaz de línea de comandos que facilita la desplegar en máquinas donde un usuario no siempre ha iniciado sesión, por ejemplo, un servidor web. Para facilitar la despliegue en estos ambientes, QuickBooks Gateway contiene dos ejecutables:

La sintaxis para administrar el servicio de Windows de QuickBooks Gateway desde la línea de comandos es la siguiente:

RemoteConnectorService.exe /Service <Command>

Están disponibles los siguientes comandos:

Puede iniciar el demonio MySQL desde la línea de comandos, como se muestra a continuación:

java -jar cdata.jdbc.quickbookspos.jar [options ]

Las siguientes opciones de línea de comandos están disponibles:

Las opciones especificadas en la línea de comando tienen prioridad sobre las opciones especificadas en el archivo de configuración. Puede pasar opciones de línea de comandos para especificar un subconjunto restringido de las opciones permitidas en el Archivo de configuración.

Claves de registro¶

Todos los datos de configuración se leen del registro en "HKEY_LOCAL_MACHINE\SOFTWARE\RemoteConnector". Cada usuario tendrá una subclave separada con configuraciones específicas del usuario. Por ejemplo, "HKEY_LOCAL_MACHINE\SOFTWARE\RemoteConnector\User1".

Configuración de nivel de aplicación¶

Configuración de nivel de usuario¶

Funciones avanzadas¶

Esta sección detalla una selección de características avanzadas del conector POS de QuickBooks.

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 Jitterbit Connector para QuickBooks POS 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 mediante 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 Customers 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.

Inserción de registros primarios y secundarios¶

Caso de uso¶

Al insertar registros, a menudo es necesario completar los detalles sobre los registros secundarios que dependen de un padre.

Por ejemplo, cuando se trata de un sistema CRM, las facturas a menudo no se pueden ingresar sin al menos una línea de pedido.

Las facturas pueden tener muchos elementos de línea, y cada elemento de línea se compone de varios campos. Esto presenta un desafío único al ofrecer los datos como tablas relacionales.

Al leer los datos, es bastante fácil modelar una factura y una tabla InvoiceLineItem con una clave externa que conecte las dos.
Pero durante las inserciones, el sistema de CRM requerirá que tanto la factura como los elementos de línea de factura se creen en un solo envío.

Para resolver este tipo de problema, nuestras herramientas ofrecen columnas de colección secundaria en el padre.
Estas columnas se pueden usar para enviar declaraciones de inserción que incluyen detalles de los registros principal y secundario.

A partir de nuestro ejemplo, la tabla Invoice puede tener una columna llamada InvoiceLineItems.
Durante la inserción, podemos pasar los detalles de los registros que deberían insertarse en la tabla InvoiceLineItems en la columna InvoiceLineItems del registro Invoice.
Esto se puede hacer usando los siguientes métodos:

Métodos para insertar registros padre/hijo¶

El conector facilita dos métodos para insertar registros primarios/secundarios: inserción de tablas temporales e inserción de agregados XML/JSON.

Tablas temporales (#TEMP)¶

La forma más sencilla de ingresar datos sería usar una tabla #TEMP, o una tabla temporal, que el conector almacenará en la memoria.

Haga referencia a la tabla #TEMP con la siguiente sintaxis:

NombreDeTabla#TEMP

#Las tablas TEMP se almacenan en la memoria durante la duración de una conexión.

Por lo tanto, para usarlos, no puede cerrar la conexión entre el envío de inserciones y no se pueden usar en ambientes donde se puede usar una conexión diferente para cada consultar.

Dentro de esa única conexión, la tabla permanece en la memoria hasta que la inserción masiva se realiza correctamente, momento en el que la tabla temporal se borrará de la memoria.

Por ejemplo:

INSERT INTO InvoiceLineItems#TEMP (ReferenceNumber, Item, Quantity, Amount) VALUES ('INV001', 'Basketball', 10, 9.99)
INSERT INTO InvoiceLineItems#TEMP (ReferenceNumber, Item, Quantity, Amount) VALUES ('INV001', 'Football', 5, 12.99)

Una vez que se completa la tabla InvoiceLineItems, se puede hacer referencia a la tabla #TEMP durante una inserción en la tabla Invoice:

INSERT INTO Invoices (ReferenceNumber, Customer, InvoiceLines) VALUES ('INV001', 'John Doe', 'InvoiceLineItems#TEMP')

Debajo del capó, el conector leerá los valores de la tabla #TEMP.

Tenga en cuenta que el número de referencia se utilizó para identificar a qué factura están vinculadas las líneas.
Esto se debe a que la tabla #TEMP se puede completar y usar con una inserción masiva, donde tendrá diferentes líneas para diferentes facturas.
Esto permite que las tablas #TEMP se utilicen con una inserción masiva. Por ejemplo:

INSERT INTO Invoices#TEMP (ReferenceNumber, Customer, InvoiceLines) VALUES ('INV001', 'John Doe', 'InvoiceLineItems#TEMP')
INSERT INTO Invoices#TEMP (ReferenceNumber, Customer, InvoiceLines) VALUES ('INV002', 'Jane Doe', 'InvoiceLineItems#TEMP')
INSERT INTO Invoices SELECT ReferenceNumber, Customer, InvoiceLines FROM Invoices#TEMP

En este caso, estamos insertando dos Facturas diferentes. El número de referencia es cómo determinamos qué líneas van con qué factura.

Note: Las tablas y columnas presentadas aquí son un ejemplo de cómo funciona el conector en general. Los nombres específicos de la tabla y la columna pueden ser diferentes en el conector.

Agregados XML/JSON¶

Como alternativa a las tablas #TEMP, se puede utilizar XML/JSON directo. Dado que las tablas #TEMP no se usan para construirlas, no importa si usa la misma conexión o si cierra la conexión después de la inserción.

Por ejemplo:

[
  {
    "Item", "Basketball",
    "Quantity": 10
    "Amount": 9.99
  },
  {
    "Item", "Football",
    "Quantity": 5
    "Amount": 12.99
  }
]

O

<Row>
  <Item>Basketball</Item>
  <Quantity>10</Quantity>
  <Amount>9.99</Amount>
</Row>
<Row>
  <Item>Football</Item>
  <Quantity>5</Quantity>
  <Amount>12.99</Amount>
</Row>

Tenga en cuenta que ReferenceNumber no está presente en estos ejemplos.

Esto se debe a que XML/JSON, por su naturaleza, no se pasa por referencia, sino que se pasa en su totalidad por inserción contra el registro principal.
No es necesario proporcionar algo para vincular al elemento secundario con el principal, ya que se debe construir y enviar el XML/JSON completo para cada fila.

Luego, inserte los valores:

INSERT INTO Invoices (ReferenceNumber, Customer, InvoiceLines) VALUES ('INV001', 'John Doe', '{...}')

O

INSERT INTO Invoices (ReferenceNumber, Customer, InvoiceLines) VALUES ('INV001', 'John Doe', '<Row>...</Row>')

Ejemplo para QuickBooks POS¶

Para ver un ejemplo práctico de cómo se pueden usar las tablas temporales para la inserción masiva en QuickBooks POS, consulte lo siguiente:

// Insert into Invoices table
INSERT INTO InvoiceLineItems#TEMP (ItemName, ItemQuantity) VALUES ('Repairs','1')
INSERT INTO InvoiceLineItems#TEMP (ItemName, ItemQuantity) VALUES ('Removal','2')

INSERT INTO Invoices (CustomerName, Memo, ItemAggregate) VALUES ('Abercrombie, Kristy', 'NUnit Memo', 'InvoiceLineItems#TEMP')


// Insert into InvoiceLineItems table
INSERT INTO InvoiceLineItems#TEMP (CustomerName, Date, ShipMethod, ShipDate, Memo, Message, DueDate, Other, ItemName, ItemQuantity, ItemRate) VALUES ('Abercrombie, Kristy', '2011-01-01', 'UPS', '2011-01-02', 'NUnit Memo', 'We appreciate your prompt payment.', '2011-01-03', 'Some other data', 'Repairs', '1', '3.50')
INSERT INTO InvoiceLineItems#TEMP (CustomerName, Date, ShipMethod, ShipDate, Memo, Message, DueDate, Other, ItemName, ItemQuantity, ItemRate) VALUES ('Abercrombie, Kristy', '2011-01-01', 'UPS', '2011-01-02', 'NUnit Memo', 'We appreciate your prompt payment.', '2011-01-03', 'Some other data', 'Removal', '2', '3.50')

INSERT INTO InvoiceLineItems (CustomerName, Date, ShipMethod, ShipDate, Memo, Message, DueDate, Other, ItemName, ItemQuantity, ItemRate) SELECT CustomerName, Date, ShipMethod, ShipDate, Memo, Message, DueDate, Other, ItemName, ItemQuantity, ItemRate InvoiceLineItems#TEMP

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¶

El modelo de datos tiene dos partes: tablas y vistas.

Mesas

Mesas permiten el acceso a los datos del origen de datos. Jitterbit Connector para QuickBooks POS modela los datos de la fuente de datos en tablas para que se puedan consultar y actualizar fácilmente.

Puntos de vista

Puntos de vista son tablas que no se pueden modificar. Normalmente, los datos de solo lectura se muestran como vistas.

Tablas¶

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

En general, consultar las tablas de POS de QuickBooks 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 de Jitterbit para tablas de POS de QuickBooks¶

Clientes¶

Cree, actualice, elimine y consultar clientes de QuickBooks POS.

Información específica de la tabla¶

La tabla Clientes le permite seleccionar, insertar, actualizar y eliminar Clientes dentro de QuickBooks POS.

Seleccionar¶

QuickBooks POS permite que muchas de las columnas se utilicen en la cláusula WHERE de una consultar SELECT. Estas columnas pueden crear filtros Single o Range, como se define en el esquema de la tabla.

SELECT * FROM Customers WHERE FirstName LIKE '%George%' AND TimeModified >= '1/1/2014' AND TimeModified < '2/1/2014' AND AccountBalance > 100.00

Insertar¶

Para crear un nuevo registro de Cliente, el campo Apellido es obligatorio.

Las direcciones de envío se especifican a través de un agregado XML dentro de la columna ShipAddressesAgregate. Las columnas que se pueden usar en estos agregados se definen en CustomerShipAddresses tabla como # columnas. Tenga en cuenta que se requiere ShipAddressAddressName al agregar una dirección de envío.

El siguiente ejemplo demuestra cómo insertar un nuevo Cliente con dos direcciones de envío:

INSERT INTO Customers (FirstName, LastName, ShipAddressesAggregate)
VALUES ('Kristy', 'Abercrombie', '<CustomerShipAddresses>
<Row><ShipAddressAddressName>Home</ShipAddressAddressName><ShipAddressStreet>123 Main Street</ShipAddressStreet><ShipAddressCity>Chapel Hill</ShipAddressCity><ShipAddressState>NC</ShipAddressState><ShipAddressPostalCode>12345</ShipAddressPostalCode></Row>
<Row><ShipAddressAddressName>Office</ShipAddressAddressName><ShipAddressStreet>456 Downtown Drive</ShipAddressStreet><ShipAddressCity>Raleigh</ShipAddressCity><ShipAddressState>NC</ShipAddressState><ShipAddressPostalCode>98765</ShipAddressPostalCode></Row>
</CustomerShipAddresses>')

Actualizar¶

Cualquier campo que no sea de solo lectura se puede actualizar.

Al actualizar un registro de Cliente, las direcciones de envío se pueden agregar o modificar a través de la columna ShipAddressesAgregate (como en un inserto). En tales casos, se requiere la columna ShipAddressAddressName para identificar la dirección de envío que se agrega o actualiza.

En el caso de actualizar una dirección de envío, los valores preexistentes permanecerán sin cambios a menos que se especifique explícitamente dentro de ShipAddressesAgregate. Por lo tanto, para eliminar un valor, el valor de la columna en el agregado debe establecerse en "" (cadena vacía).

UPDATE Customers SET ShipAddressesAggregate='<CustomerShipAddresses>
<Row><ShipAddressAddressName>Office</ShipAddressAddressName><ShipAddressCompany>MyCompany</ShipAddressCompany></Row>
</CustomerShipAddresses>' 
WHERE ListId='-1234567890123456789'

Columnas¶

Direcciones de envío del cliente¶

Cree, actualice, elimine y consultar las direcciones de envío del cliente de QuickBooks POS.

Información específica de la tabla¶

Seleccionar¶

QuickBooks POS permite que muchas de las columnas se utilicen en la cláusula WHERE de una consultar SELECT. Estas columnas pueden crear filtros Single o Range, como se define en el esquema de la tabla.

SELECT * FROM CustomerShipAddresses WHERE FirstName LIKE '%George%' AND TimeModified >= '1/1/2014' AND TimeModified < '2/1/2014'

Insertar¶

Insertar se puede utilizar para crear un nuevo registro de Cliente o para agregar una dirección de envío a un registro de Cliente existente. Para crear un nuevo registro de Cliente, el campo Apellido es obligatorio. Para agregar una dirección de envío a un registro existente, se requieren la columna ListId del registro del Cliente al que se agregará la dirección y ShipAddressAddressName.

Crear un nuevo cliente:

INSERT INTO CustomerShipAddresses (FirstName, LastName, ShipAddressAddressName, ShipAddressStreet, ShipAddressCity, ShipAddressState, ShipAddressPostalCode)
VALUES ('Kristy', 'Abercrombie', 'Home', '123 Main Street', 'Chapel Hill', 'NC', '12345')

Agregue una dirección de envío a un cliente existente:

INSERT INTO CustomerShipAddresses (ListId, ShipAddressAddressName, ShipAddressStreet, ShipAddressCity, ShipAddressState, ShipAddressPostalCode)
VALUES ('-1234567890123456789', 'Office', '456 Downtown Drive', 'Raleigh', 'NC', '98765')

Actualización¶

Cualquier campo que no sea de solo lectura se puede actualizar.

Para realizar una actualización, ListId y ShipAddressAddressName son campos obligatorios.

UPDATE CustomerShipAddresses SET ShipAddressCompanyName='MyCompany' WHERE ListId='-1234567890123456789' AND ShipAddressAddressName='Office'

Borrar¶

Eliminar se utiliza para eliminar una dirección de envío del registro de Cliente especificado (no eliminará el registro de Cliente en sí). Para realizar una eliminación, ListId y ShipAddressAddressName son campos obligatorios.

DELETE FROM CustomerShipAddresses WHERE ListId='-1234567890123456789' AND ShipAddressAddressName='Home'

Columnas¶

Departamentos¶

Cree, actualice, elimine y consultar los departamentos de POS de QuickBooks.

Información específica de la tabla¶

Seleccionar¶

QuickBooks POS permite que muchas de las columnas se utilicen en la cláusula WHERE de una consultar SELECT. Estas columnas pueden crear filtros Single o Range, como se define en el esquema de la tabla.

SELECT * FROM Departments WHERE DepartmentName LIKE '%WEAR%'

Insertar¶

Para crear un nuevo registro de departamento, se requiere el campo DepartmentName.

INSERT INTO Departments (DepartmentName, DepartmentCode, DefaultMarginPercent)
VALUES ('Sports Wear', 'SPW', '7.25')

Actualización¶

Cualquier campo que no sea de solo lectura se puede actualizar.

UPDATE Departments SET DefaultMarkupPercent='20.50' WHERE ListId='-1234567890123456789' 

Columnas¶

Empleados¶

Cree, actualice y consultar a los empleados de QuickBooks POS.

Información específica de la tabla¶

Seleccionar¶

QuickBooks POS permite que muchas de las columnas se utilicen en la cláusula WHERE de una consultar SELECT. Estas columnas pueden crear filtros Single o Range, como se define en el esquema de la tabla.

SELECT * FROM Employees WHERE LoginName LIKE '%test%'

Insertar¶

Para crear un nuevo registro de empleado, se requiere el campo LoginName.

INSERT INTO Employees (LoginName, FirstName, LastName)
VALUES ('japple', 'John', 'Apple')

Actualización¶

Cualquier campo que no sea de solo lectura se puede actualizar.

UPDATE Employees SET Phone='555-123-9876' WHERE ListId='-1234567890123456789' 

Eliminar¶

La eliminación de un empleado requiere privilegios de administrador del sistema, que solo están disponibles al iniciar sesión directamente en QuickBooks POS.

Columnas¶

Artículos de ajuste de costos de inventario¶

Cree y consultar elementos de ajuste de costos de inventario de QuickBooks POS.

Información específica de la tabla¶

Seleccionar¶

QuickBooks POS permite que muchas de las columnas se utilicen en la cláusula WHERE de una consultar SELECT. Estas columnas pueden crear filtros Single o Range, como se define en el esquema de la tabla.

SELECT * FROM InventoryCostAdjustmentItems WHERE Associate LIKE '%George%' AND TimeModified >= '1/1/2014' AND TimeModified < '2/1/2014'

Insertar¶

Insertar se puede usar para agregar un artículo a un registro existente de InventoryCostAdjustment. Para agregar un artículo a un registro existente, se requieren la columna TxnId del registro InventoryCostAdjustment al que se agregará el artículo, ItemListId y ItemNewCost.

INSERT INTO InventoryCostAdjustmentItems (TxnId, ItemListId, ItemNewCost)
VALUES ('-1234567890123456789', '-1000000000000000004', '2.00')

Columnas¶

Ajustes de costos de inventario¶

Cree, actualice y consultar los ajustes de costos de inventario de POS de QuickBooks.

Información específica de la tabla¶

Seleccionar¶

QuickBooks POS permite que muchas de las columnas se utilicen en la cláusula WHERE de una consultar SELECT. Estas columnas pueden crear filtros Single o Range, como se define en el esquema de la tabla.

SELECT * FROM InventoryCostAdjustments WHERE Associate LIKE '%George%' AND TimeModified >= '1/1/2014' AND TimeModified < '2/1/2014'

Insertar¶

Para crear un nuevo registro InventoryCostAdjustment, se requiere el campo Motivo. Los elementos se especifican a través de un agregado XML dentro de la columna ItemsAgregate. Las columnas que se pueden usar en estos agregados se definen en InventoryCostAdjustmentItems tabla como # columnas. Tenga en cuenta que ItemListId y ItemNewCost son obligatorios al agregar un artículo.

El siguiente ejemplo insertará un nuevo InventoryCostAdjustment con dos elementos:

INSERT INTO InventoryCostAdjustments (Reason, ItemsAggregate)
VALUES ('Discontinued', '<InventoryCostAdjustmentItems>
<Row><ItemListId>-1000000000000000001</ItemListId><ItemNewCost>4.99</ItemNewCost></Row>
<Row><ItemListId>-1000000000000000002</ItemListId><ItemNewCost>11.97</ItemNewCost></Row>
</InventoryCostAdjustmentItems>')

Actualización¶

Cualquier campo que no sea de solo lectura se puede actualizar.

Al actualizar un registro InventoryCostAdjustment, los costos de los artículos se pueden ajustar a través de la columna ItemsAgregate, al igual que en una inserción. En tales casos, se requiere la columna ItemListId para identificar el artículo que se está ajustando y ItemNewCost para especificar el nuevo costo.

Tenga en cuenta que los artículos no se pueden eliminar de un registro InventoryCostAdjustment, sino que solo se puede ajustar el costo, por lo que siempre se mantiene un registro de ajustes para un artículo.

UPDATE InventoryCostAdjustments SET ItemsAggregate='<InventoryCostAdjustmentItems>
<Row><ItemListId>-1000000000000000003</ItemListId><ItemNewCost>19.99</ItemNewCost></Row>
</InventoryCostAdjustmentItems>'
WHERE TxnId='-1234567890123456789'

Columnas¶

Elementos de ajuste de cantidad de inventario¶

Cree y consultar artículos de ajuste de cantidad de inventario de POS de QuickBooks.

Información específica de la tabla¶

Seleccionar¶

QuickBooks POS permite que muchas de las columnas se utilicen en la cláusula WHERE de una consultar SELECT. Estas columnas pueden crear filtros Single o Range, como se define en el esquema de la tabla.

SELECT * FROM InventoryQtyAdjustmentItems WHERE Associate LIKE '%George%' AND TimeModified >= '1/1/2014' AND TimeModified < '2/1/2014'

Insertar¶

Insertar se puede usar para agregar un artículo a un registro existente de InventoryQtyAdjustment. Para agregar un artículo a un registro existente, se requieren la columna TxnId del registro InventoryQtyAdjustment al que se agregará el artículo, ItemListId y ItemNewQuantity.

INSERT INTO InventoryQtyAdjustmentItems (TxnId, ItemListId, ItemNewQuantity)
VALUES ('-1234567890123456789', '-1000000000000000004', '10')

Columnas¶

Ajustes de cantidad de inventario¶

Cree, actualice y consultar los ajustes de cantidad de inventario de POS de QuickBooks.

Información específica de la tabla¶

Seleccionar¶

QuickBooks POS permite que muchas de las columnas se utilicen en la cláusula WHERE de una consultar SELECT. Estas columnas pueden crear filtros Single o Range, como se define en el esquema de la tabla.

SELECT * FROM InventoryCostAdjustments WHERE Associate LIKE '%George%' AND TimeModified >= '1/1/2014' AND TimeModified < '2/1/2014'

Insertar¶

Para crear un nuevo registro InventoryQtyAdjustment, se requiere el campo Motivo. Los elementos se especifican a través de un agregado XML dentro de la columna ItemsAgregate. Las columnas que se pueden usar en estos agregados se definen en InventoryQtyAdjustmentItems tabla como # columnas. Tenga en cuenta que ItemListId y ItemNewQuantity son obligatorios al agregar un artículo.

El siguiente ejemplo insertará un nuevo InventoryQtyAdjustment con dos elementos:

INSERT INTO InventoryQtyAdjustments (Reason, ItemsAggregate)
VALUES ('New Shipment', '<InventoryQtyAdjustmentItems>
<Row><ItemListId>-1000000000000000001</ItemListId><ItemNewQuantity>10</ItemNewQuantity></Row>
<Row><ItemListId>-1000000000000000002</ItemListId><ItemNewQuantity>20</ItemNewQuantity></Row>
</InventoryQtyAdjustmentItems>')

Actualización¶

Cualquier campo que no sea de solo lectura se puede actualizar.

Al actualizar un registro InventoryQtyAdjustment, las cantidades de artículos se pueden ajustar a través de la columna ItemsAgregate, al igual que en una inserción. En tales casos, se requiere la columna ItemListId para identificar el artículo que se está ajustando y ItemNewQuantity para especificar la nueva cantidad.

Tenga en cuenta que los artículos no se pueden eliminar de un registro InventoryQtyAdjustment, sino que solo se puede ajustar el costo, por lo que siempre se mantiene un registro de ajustes para un artículo.

UPDATE InventoryQtyAdjustments SET ItemsAggregate='<InventoryQtyAdjustmentItems>
<Row><ItemListId>-1000000000000000003</ItemListId><ItemNewQuantity>30</ItemNewQuantity></Row>
</InventoryQtyAdjustmentItems>' 
WHERE TxnId='-1234567890123456789'

Columnas¶

Imágenes de elementos¶

Cree, actualice y consultar imágenes de artículos de QuickBooks POS.

Columnas¶

Artículos¶

Cree, actualice, elimine y consultar artículos de QuickBooks POS.

Información específica de la tabla¶

Seleccionar¶

QuickBooks POS permite que muchas de las columnas se utilicen en la cláusula WHERE de una consultar SELECT. Estas columnas pueden crear filtros Single o Range, como se define en el esquema de la tabla.

SELECT * FROM Items WHERE QuantityOnHand < 5

Insertar¶

Para crear un nuevo registro de artículo, se requiere el campo DepartmentListId.

INSERT INTO Items (DepartmentListId, Desc1, Cost)
VALUES ('-1234567890123456789', 'T-Shirt', '9.99')

Actualización¶

Cualquier campo que no sea de solo lectura se puede actualizar.

UPDATE Items SET Size='L' WHERE ListId='-1000000000000000001' 

Columnas¶

Elementos de ajuste de precio¶

Cree, actualice, elimine y consultar artículos de ajuste de precio de POS de QuickBooks.

Información específica de la tabla¶

Seleccionar¶

QuickBooks POS permite que muchas de las columnas se utilicen en la cláusula WHERE de una consultar SELECT. Estas columnas pueden crear filtros Single o Range, como se define en el esquema de la tabla.

SELECT * FROM PriceAdjustmentItems WHERE Associate LIKE '%George%' AND TimeModified >= '1/1/2014' AND TimeModified < '2/1/2014'

Insertar¶

Insertar se puede usar para crear un nuevo registro de ajuste de precio o para agregar un artículo a un registro de ajuste de precio existente.

Para crear un nuevo registro PriceAdjustment, se requiere el campo PriceAdjustmentName.

INSERT INTO PriceAdjustmentItems (PriceAdjustmentName, ItemListId, ItemNewPrice)
VALUES ('New Adjustment', '-1000000000000000001', '10.00')

Para agregar un artículo a un registro existente, se requieren la columna TxnId del registro PriceAdjustment al que se agregará el artículo y el ItemListId.

INSERT INTO PriceAdjustmentItems (TxnId, ItemListId, ItemNewPrice)
VALUES ('-1234567890123456789', '-1000000000000000001', '10.00')

Actualización¶

Cualquier campo que no sea de solo lectura se puede actualizar.

Nota: las operaciones de actualización contarán como dos operaciones contra la API de POS de QuickBooks. Se requiere uno para recuperar el registro existente y otro para actualizar el registro con nuevos datos.

Para realizar una actualización, TxnId y ItemTxnLineId son campos obligatorios.

UPDATE PriceAdjustmentItems SET ItemNewPrice='30.00' WHERE TxnId='-1234567890123456789' AND ItemTxnLineId='1'

Eliminar¶

Eliminar se utiliza para eliminar un elemento del registro especificado (no eliminará todo el registro).

Nota: La eliminación de un artículo requiere que se envíen en la solicitud todos los artículos buscados que existen actualmente en el registro, eliminando así los que no están especificados. Por lo tanto, las operaciones de eliminación contarán como dos operaciones contra la API de POS de QuickBooks. Se requiere uno para recuperar el registro existente para obtener todos los ItemTxnLineIds existentes y otro para eliminar el elemento especificado.

Para realizar una eliminación, TxnId y ItemTxnLineId son campos obligatorios.

DELETE FROM PriceAdjustmentItems WHERE TxnId='-1234567890123456789' AND ItemTxnLineId='3'

Columnas¶

Ajustes de precios¶

Cree, actualice y consultar los ajustes de precios de POS de QuickBooks.

Información específica de la tabla¶

Seleccionar¶

QuickBooks POS permite que muchas de las columnas se utilicen en la cláusula WHERE de una consultar SELECT. Estas columnas pueden crear filtros Single o Range, como se define en el esquema de la tabla.

SELECT * FROM PriceAdjustments WHERE Associate LIKE '%George%' AND TimeModified >= '1/1/2014' AND TimeModified < '2/1/2014'

Insertar¶

Para crear un nuevo registro PriceAdjustment, se requiere el campo PriceAdjustmentName. Los elementos se especifican a través de un agregado XML dentro de la columna ItemsAgregate. Las columnas que se pueden usar en estos agregados se definen en PriceAdjustmentItems tabla como # columnas. Tenga en cuenta que se requiere ItemListId al agregar un artículo.

El siguiente ejemplo insertará un nuevo ajuste de precio con dos elementos:

INSERT INTO PriceAdjustments (PriceAdjustmentName, ItemsAggregate)
VALUES ('New Adjustment', '<PriceAdjustmentItems>
<Row><ItemListId>-1000000000000000001</ItemListId><ItemNewPrice>10.00</ItemNewPrice></Row>
<Row><ItemListId>-1000000000000000002</ItemListId><ItemNewPrice>20.00</ItemNewPrice></Row>
</PriceAdjustmentItems>')

Actualización¶

Cualquier campo que no sea de solo lectura se puede actualizar.

Al actualizar un registro de ajuste de precios, los precios de los artículos se pueden agregar o modificar a través de la columna ItemsAgregate.

Para modificar un artículo existente en un registro de ajuste de precio, se requiere la columna ItemTxnLineId para identificar el artículo. En una actualización que utilice ItemsAggregate, especifique todos los valores de ItemTxnLineId que se conservarán, ya que los valores no especificados se eliminarán.

Para agregar un nuevo elemento, se debe especificar el ItemListId que corresponde al elemento que se agregará (tal como en una inserción).

Tenga en cuenta que los elementos no se pueden modificar y agregar en la misma solicitud de ItemsAgregate. La modificación de un elemento mediante ItemTxnLineId tiene prioridad sobre los elementos agregados y, por lo tanto, QuickBooks POS ignora los elementos agregados y realiza la modificación de los elementos existentes.

Ejemplo de modificación de elementos: sume tres elementos con valores ItemTxnLineId de 1, 2 y 3. El elemento 1 se actualiza, el elemento 2 se deja solo y el elemento 3 se eliminará.

UPDATE PriceAdjustments SET ItemsAggregate='<PriceAdjustmentItems>
<Row><ItemTxnLineId>1</ItemTxnLineId><ItemNewPrice>30.00</ItemNewPrice></Row>
<Row><ItemTxnLineId>2</ItemTxnLineId></Row>
</PriceAdjustmentItems>'
WHERE TxnId='-1234567890123456789'

Agregar nuevo artículo Ejemplo: Los artículos existentes permanecen intactos cuando se agregan nuevos artículos.

UPDATE PriceAdjustments SET ItemsAggregate='<PriceAdjustmentItems>
<Row><ItemListId>-1000000000000000003</ItemListId><ItemNewPrice>30.00</ItemNewPrice></Row>
</PriceAdjustmentItems>' 
WHERE TxnId='-1234567890123456789'

Columnas¶

Artículos de descuento de precio¶

Cree, actualice, elimine y consultar artículos con descuento de precio de POS de QuickBooks.

Información específica de la tabla¶

Seleccionar¶

QuickBooks POS permite que muchas de las columnas se utilicen en la cláusula WHERE de una consultar SELECT. Estas columnas pueden crear filtros Single o Range, como se define en el esquema de la tabla.

SELECT * FROM PriceDiscountItems WHERE Associate LIKE '%George%' AND TimeModified >= '1/1/2014' AND TimeModified < '2/1/2014'

Insertar¶

La inserción se puede usar para crear un nuevo registro de PriceDiscount o para agregar un artículo a un registro de PriceDiscount existente.

Para crear un nuevo registro de PriceDiscount, se requieren los campos PriceDiscountName y PriceDiscountReason.

INSERT INTO PriceDiscountItems (PriceDiscountName, PriceDiscountReason, PriceDiscountXValue, ItemListId, ItemUnitOfMeasure)
VALUES ('New Discount', 'Sale', '10', '-1000000000000000001', 'lbs')

Para agregar un artículo a un registro existente, se requieren la columna TxnId del registro PriceDiscount al que se agregará el artículo y el ItemListId.

INSERT INTO PriceDiscountItems (TxnId, ItemListId, ItemUnitOfMeasure)
VALUES ('-1234567890123456789', '-1000000000000000001', 'lbs')

Actualización¶

Cualquier campo que no sea de solo lectura se puede actualizar.

Nota: las operaciones de actualización contarán como dos operaciones contra la API de POS de QuickBooks. Se requiere uno para recuperar el registro existente y otro para actualizar el registro con nuevos datos.

Para realizar una actualización, TxnId y ItemTxnLineId son campos obligatorios.

UPDATE PriceDiscountItems SET ItemUnitOfMeasure='lbs' WHERE TxnId='-1234567890123456789' AND ItemTxnLineId='1'

Eliminar¶

Eliminar se utiliza para eliminar un elemento del registro especificado (no eliminará todo el registro).

Nota: La eliminación de un artículo requiere que se envíen en la solicitud todos los artículos buscados que existen actualmente en el registro, eliminando así los que no están especificados. Por lo tanto, las operaciones de eliminación contarán como dos operaciones contra la API de POS de QuickBooks. Se requiere uno para recuperar el registro existente para obtener todos los ItemTxnLineIds existentes y otro para eliminar el elemento especificado.

Para realizar una eliminación, TxnId y ItemTxnLineId son campos obligatorios.

DELETE FROM PriceDiscountItems WHERE TxnId='-1234567890123456789' AND ItemTxnLineId='3'

Columnas¶

Descuentos de precios¶

Cree, actualice y consultar los descuentos de precios de POS de QuickBooks.

Información específica de la tabla¶

Seleccionar¶

QuickBooks POS permite que muchas de las columnas se utilicen en la cláusula WHERE de una consultar SELECT. Estas columnas pueden crear filtros Single o Range, como se define en el esquema de la tabla.

SELECT * FROM PriceDiscounts WHERE Associate LIKE '%George%' AND TimeModified >= '1/1/2014' AND TimeModified < '2/1/2014'

Insertar¶

Para crear un nuevo registro de PriceDiscount, se requieren los campos PriceDiscountName y PriceDiscountReason. Los elementos se especifican a través de un agregado XML dentro de la columna ItemsAgregate. Las columnas que se pueden usar en estos agregados se definen en PriceDiscountItems tabla como # columnas. Tenga en cuenta que se requiere ItemListId al agregar un artículo.

El siguiente ejemplo insertará un nuevo PriceDiscount con dos elementos:

INSERT INTO PriceDiscounts (PriceDiscountName, PriceDiscountReason, PriceDiscountXValue, ItemsAggregate)
VALUES ('New Discount', 'Sale', '10', '<PriceDiscountItems>
<Row><ItemListId>-1000000000000000001</ItemListId></Row>
<Row><ItemListId>-1000000000000000002</ItemListId></Row>
</PriceDiscountItems>')

Actualización¶

Cualquier campo que no sea de solo lectura se puede actualizar.

Al actualizar un registro de PriceDiscount, los artículos se pueden agregar o modificar a través de la columna ItemsAgregate.

Para modificar un artículo existente en un registro de PriceDiscount, se requiere la columna ItemTxnLineId para identificar el artículo. En una actualización que utilice ItemsAggregate, especifique todos los valores de ItemTxnLineId que se conservarán, ya que los valores no especificados se eliminarán.

Para agregar un nuevo elemento, se debe especificar el ItemListId que corresponde al elemento que se desea agregar, al igual que en una inserción.

Tenga en cuenta que los elementos no se pueden modificar y agregar en la misma solicitud de ItemsAgregate. La modificación de un artículo, usando ItemTxnLineId, tiene prioridad sobre los artículos agregados y, por lo tanto, QuickBooks POS ignora los artículos agregados y realiza la modificación solo de los artículos existentes.

Ejemplo de modificación de elementos: sume dos elementos con valores ItemTxnLineId de 1 y 2. El elemento 1 se actualiza y el elemento 2 se elimina.

UPDATE PriceDiscounts SET ItemsAggregate='<PriceDiscountItems>
<Row><ItemTxnLineId>1</ItemTxnLineId><ItemUnitOfMeasure>lbs</ItemUnitOfMeasure></Row>
</PriceDiscountItems>'
WHERE TxnId='-1234567890123456789'

Agregar nuevo artículo Ejemplo: Los artículos existentes permanecen intactos cuando se agregan nuevos artículos.

UPDATE PriceDiscounts SET ItemsAggregate='<PriceDiscountItems>
<Row><ItemListId>-1000000000000000003</ItemListId><ItemUnitOfMeasure>lbs</ItemUnitOfMeasure></Row>
</PriceDiscountItems>' 
WHERE TxnId='-1234567890123456789'

Columnas¶

Artículos de orden de compra¶

Cree, actualice, elimine y consultar elementos de pedidos de compra de QuickBooks POS.

Información específica de la tabla¶

Seleccionar¶

QuickBooks POS permite que muchas de las columnas se utilicen en la cláusula WHERE de una consultar SELECT. Estas columnas pueden crear filtros Single o Range, como se define en el esquema de la tabla.

SELECT * FROM PurchaseOrderItems WHERE Associate LIKE '%George%' AND TimeModified >= '1/1/2014' AND TimeModified < '2/1/2014'

Insertar¶

Insertar se puede usar para crear un nuevo registro de Orden de compra o para agregar un artículo a un registro de Orden de compra existente.

Para crear un nuevo registro de orden de compra, se requieren los campos Número de orden de compra y VendorListId.

INSERT INTO PurchaseOrderItems (PurchaseOrderNumber, VendorListId, ItemListId, ItemCost, ItemQty)
VALUES ('PO12345', '-9876543210987654321', '-1000000000000000001', 15.00, 10)

Para agregar un artículo a un registro existente, se requiere la columna TxnId del registro de Orden de Compra al que se agregará el artículo y el ItemListId.

INSERT INTO PurchaseOrderItems (TxnId, ItemListId, ItemCost, ItemQty)
VALUES ('-1234567890123456789', '-1000000000000000001', 15.00, 10)

Actualización¶

Cualquier campo que no sea de solo lectura se puede actualizar.

Nota: las operaciones de actualización contarán como dos operaciones contra la API de POS de QuickBooks. Se requiere uno para recuperar el registro existente y otro para actualizar el registro con nuevos datos.

Para realizar una actualización, TxnId y ItemTxnLineId son campos obligatorios.

UPDATE PurchaseOrderItems SET ItemSize='L' WHERE TxnId='-1234567890123456789' AND ItemTxnLineId='1'

Eliminar¶

Eliminar se utiliza para eliminar un elemento del registro especificado (no eliminará todo el registro).

Nota: La eliminación de un artículo requiere que se envíen en la solicitud todos los artículos buscados que existen actualmente en el registro, eliminando así los que no están especificados. Por lo tanto, las operaciones de eliminación contarán como dos operaciones contra la API de POS de QuickBooks. Se requiere uno para recuperar el registro existente para obtener todos los ItemTxnLineIds existentes y otro para eliminar el elemento especificado.

Para realizar una eliminación, TxnId y ItemTxnLineId son campos obligatorios.

DELETE FROM PurchaseOrderItems WHERE TxnId='-1234567890123456789' AND ItemTxnLineId='3'

Columnas¶

Pedidos de compra¶

Cree, actualice, elimine y consultar las órdenes de compra de QuickBooks POS.

Información específica de la tabla¶

La tabla de Pedidos de compra le permite SELECCIONAR, INSERTAR, ACTUALIZAR y ELIMINAR pedidos de compra dentro de QuickBooks POS.

Seleccionar¶

QuickBooks POS permite que muchas de las columnas se utilicen en la cláusula WHERE de una consultar SELECT. Estas columnas pueden crear filtros Single o Range, como se define en el esquema de la tabla.

SELECT * FROM PurchaseOrders WHERE Associate LIKE '%George%' AND TimeModified >= '1/1/2014' AND TimeModified < '2/1/2014'

Insertar¶

Para crear un nuevo registro de orden de compra, se requieren los campos Número de orden de compra y VendorListId. Los elementos se especifican a través de un agregado XML dentro de la columna ItemsAgregate. Las columnas que se pueden utilizar en estos agregados se definen en PurchaseOrderItems tabla como # columnas. Tenga en cuenta que se requiere ItemListId al agregar un elemento.

El siguiente ejemplo insertará una nueva Orden de Compra con dos artículos:

INSERT INTO PurchaseOrders (PurchaseOrderNumber, VendorListId, ItemsAggregate)
VALUES ('PO12345', '-9876543210987654321', '<PurchaseOrderItems>
<Row><ItemListId>-1000000000000000001</ItemListId><ItemCost>10.00</ItemCost><ItemQty>25</ItemQty></Row>
<Row><ItemListId>-1000000000000000002</ItemListId><ItemCost>20.00</ItemCost><ItemQty>25</ItemQty></Row>
</PurchaseOrderItems>')

Actualización¶

Cualquier campo que no sea de solo lectura se puede actualizar.

Al actualizar un registro de orden de compra, los artículos se pueden agregar o modificar a través de la columna ItemsAgregate.

Para modificar un artículo existente en un registro de orden de compra, se requiere la columna ItemTxnLineId para identificar el artículo. En una actualización que utilice ItemsAggregate, especifique todos los valores de ItemTxnLineId que se conservarán, ya que los valores no especificados se eliminarán.

Para agregar un nuevo elemento, se debe especificar el ItemListId que corresponde al elemento que se agregará, al igual que en una inserción.

Tenga en cuenta que los elementos no se pueden modificar y agregar en la misma solicitud de ItemsAgregate. La modificación de un artículo, usando ItemTxnLineId, tiene prioridad sobre los artículos agregados y, por lo tanto, QuickBooks POS ignora los artículos agregados y realiza la modificación solo de los artículos existentes.

Ejemplo de modificación de elementos: sume tres elementos con valores ItemTxnLineId de 1, 2 y 3. El elemento 1 se actualiza, el elemento 2 se deja solo y el elemento 3 se eliminará.

UPDATE PurchaseOrders SET ItemsAggregate='<PurchaseOrderItems>
<Row><ItemTxnLineId>1</ItemTxnLineId><ItemSize>L</ItemSize></Row>
<Row><ItemTxnLineId>2</ItemTxnLineId></Row>
</PurchaseOrderItems>'
WHERE TxnId='-1234567890123456789'

Agregar nuevo artículo Ejemplo: Los artículos existentes permanecen intactos cuando se agregan nuevos artículos.

UPDATE PurchaseOrders SET ItemsAggregate='<PurchaseOrderItems>
<Row><ItemListId>-1000000000000000003</ItemListId><ItemCost>30.00</ItemCost><ItemQty>10</ItemQty></Row>
</PurchaseOrderItems>' 
WHERE TxnId='-1234567890123456789'

Columnas¶

Artículos de pedido de ventas¶

Cree, actualice, elimine y consultar artículos de pedidos de venta de QuickBooks POS.

Información específica de la tabla¶

Seleccionar¶

QuickBooks POS permite que muchas de las columnas se utilicen en la cláusula WHERE de una consultar SELECT. Estas columnas pueden crear filtros Single o Range, como se define en el esquema de la tabla.

SELECT * FROM SalesOrderItems WHERE Associate LIKE '%George%' AND TimeModified >= '1/1/2014' AND TimeModified < '2/1/2014'

Insertar¶

Insertar se puede usar para crear un nuevo registro de Orden de venta o para agregar un artículo a un registro de Orden de venta existente.

Para crear un nuevo registro de Orden de venta, se requieren los campos Número de orden de compra y VendorListId.

INSERT INTO SalesOrderItems (CustomerListId, SalesOrderNumber, ItemListId, ItemCost, ItemQty)
VALUES ('-9876543210987654321', 'SO12345', '-1000000000000000001', 15.00, 1)

Para agregar un artículo a un registro existente, se requiere la columna TxnId del registro de Orden de Venta al que se agregará el artículo y el ItemListId.

INSERT INTO SalesOrderItems (TxnId, ItemListId, ItemCost, ItemQty)
VALUES ('-1234567890123456789', '-1000000000000000001', 15.00, 1)

Actualización¶

Cualquier campo que no sea de solo lectura se puede actualizar.

Nota: las operaciones de actualización contarán como dos operaciones contra la API de POS de QuickBooks. Se requiere uno para recuperar el registro existente y otro para actualizar el registro con nuevos datos.

Para realizar una actualización, TxnId y ItemTxnLineId son campos obligatorios.

UPDATE SalesOrderItems SET ItemSize='L' WHERE TxnId='-1234567890123456789' AND ItemTxnLineId='1'

Eliminar¶

Eliminar se utiliza para eliminar un elemento del registro especificado (no eliminará todo el registro).

Nota: La eliminación de un artículo requiere que se envíen en la solicitud todos los artículos buscados que existen actualmente en el registro, eliminando así los que no están especificados. Por lo tanto, las operaciones de eliminación contarán como dos operaciones contra la API de POS de QuickBooks. Se requiere uno para recuperar el registro existente para obtener todos los ItemTxnLineIds existentes y otro para eliminar el elemento especificado.

Para realizar una eliminación, TxnId y ItemTxnLineId son campos obligatorios.

DELETE FROM SalesOrderItems WHERE TxnId='-1234567890123456789' AND ItemTxnLineId='3'

Columnas¶

Pedidos de Venta¶

Cree, actualice, elimine y consultar los pedidos de venta de QuickBooks POS.

Información específica de la tabla¶

Seleccionar¶

QuickBooks POS permite que muchas de las columnas se utilicen en la cláusula WHERE de una consultar SELECT. Estas columnas pueden crear filtros Single o Range, como se define en el esquema de la tabla.

SELECT * FROM SalesOrders WHERE Associate LIKE '%George%' AND TimeModified >= '1/1/2014' AND TimeModified < '2/1/2014'

Insertar¶

Para crear un nuevo registro de Pedidos de ventas, se requiere el campo CustomerListId. Los elementos se especifican a través de un agregado XML dentro de la columna ItemsAgregate. Las columnas que se pueden usar en estos agregados se definen en SalesOrderItems tabla como # columnas. Tenga en cuenta que se requiere ItemListId al agregar un elemento.

El siguiente ejemplo insertará una nueva orden de venta con dos artículos:

INSERT INTO SalesOrders (CustomerListId, SalesOrderNumber, ItemsAggregate)
VALUES ('-9876543210987654321', 'SO12345', '<SalesOrderItems>
<Row><ItemListId>-1000000000000000001</ItemListId><ItemPrice>15.00</ItemPrice><ItemQty>1</ItemQty></Row>
<Row><ItemListId>-1000000000000000002</ItemListId><ItemPrice>25.00</ItemPrice><ItemQty>1</ItemQty></Row>
</SalesOrderItems>')

Actualización¶

Cualquier campo que no sea de solo lectura se puede actualizar.

Al actualizar un registro de pedido de ventas, los artículos se pueden agregar o modificar a través de la columna ItemsAgregate.

Para modificar un artículo existente en un registro de Orden de venta, se requiere la columna ItemTxnLineId para identificar el artículo. En una actualización que utilice ItemsAggregate, especifique todos los valores de ItemTxnLineId que se conservarán, ya que los valores no especificados se eliminarán.

Para agregar un nuevo elemento, se debe especificar el ItemListId que corresponde al elemento que se agregará, al igual que en una inserción.

Tenga en cuenta que los elementos no se pueden modificar y agregar en la misma solicitud de ItemsAgregate. La modificación de un artículo, usando ItemTxnLineId, tiene prioridad sobre los artículos agregados y, por lo tanto, QuickBooks POS ignora los artículos agregados y realiza la modificación solo de los artículos existentes.

Ejemplo de modificación de elementos: un total de tres elementos con valores ItemTxnLineId de 1, 2 y 3. El elemento 1 se actualiza, el elemento 2 se deja solo y el elemento 3 se eliminará.

UPDATE SalesOrders SET ItemsAggregate='<SalesOrderItems>
<Row><ItemTxnLineId>1</ItemTxnLineId><ItemSize>L</ItemSize></Row>
<Row><ItemTxnLineId>2</ItemTxnLineId></Row>
</SalesOrderItems>'
WHERE TxnId='-1234567890123456789'

Agregar nuevo artículo Ejemplo: Los artículos existentes permanecen intactos cuando se agregan nuevos artículos.

UPDATE SalesOrders SET ItemsAggregate='<SalesOrderItems>
<Row><ItemListId>-1000000000000000003</ItemListId><ItemCost>40.00</ItemCost><ItemQty>1</ItemQty></Row>
</SalesOrderItems>' 
WHERE TxnId='-1234567890123456789'

Columnas¶

Elementos de recibo de ventas¶

Cree, actualice y consultar artículos de pedidos de venta de QuickBooks POS.

Información específica de la tabla¶

Seleccionar¶

QuickBooks POS permite que muchas de las columnas se utilicen en la cláusula WHERE de una consultar SELECT. Estas columnas pueden crear filtros Single o Range, como se define en el esquema de la tabla.

SELECT * FROM SalesReceiptItems WHERE Associate LIKE '%George%' AND TimeModified >= '1/1/2014' AND TimeModified < '2/1/2014'

Insertar¶

Insertar se puede utilizar para crear un nuevo registro de recibo de venta o para agregar un artículo a un registro de recibo de venta existente.

Para crear un nuevo registro de recibo de venta, se requiere CustomerListId junto con un artículo.

INSERT INTO SalesReceiptItems (SalesReceiptType, CustomerListId, SalesReceiptNumber, CashTenderAmount, ItemListId, ItemPrice, ItemQty)
VALUES ('Sales', '-9876543210987654321', 'SR12345', 2.15, '-1000000000000000001', 2.00, 1)

Para agregar un artículo a un registro existente, se requieren la columna TxnId del registro del recibo de venta al que se agregará el artículo y el ItemListId.

INSERT INTO SalesReceiptItems (TxnId, CashTenderAmount, ItemListId, ItemPrice, ItemQty)
VALUES ('-1234567890123456789', 2.15, '-1000000000000000001', 2.00, 1)

Columnas¶

Recibos de Ventas¶

Cree, actualice y consultar los recibos de ventas de QuickBooks POS.

Información específica de la tabla¶

Seleccionar¶

QuickBooks POS permite que muchas de las columnas se utilicen en la cláusula WHERE de una consultar SELECT. Estas columnas pueden crear filtros Single o Range, como se define en el esquema de la tabla.

SELECT * FROM SalesReceipts WHERE Associate LIKE '%George%' AND TimeModified >= '1/1/2014' AND TimeModified < '2/1/2014'

Insertar¶

Para crear un nuevo registro de recibo de venta, se requiere el campo CustomerListId. Los elementos se especifican a través de un agregado XML dentro de la columna ItemsAgregate. Las columnas que se pueden usar en estos agregados se definen en SalesReceiptItems tabla como # columnas. Tenga en cuenta que se requiere ItemListId al agregar un artículo.

El siguiente ejemplo insertará un nuevo recibo de venta con dos artículos (nota: 7,5 % de impuesto sobre las ventas):