Actividades de Actualización de QuickBooks Connector¶

Antes de poder actualizar los datos de QuickBooks desde Jitterbit, deberá haber creado un extremo de QuickBooks dentro de Jitterbit Studio (consulte QuickBooks Connector OAuth 1.0a - Create Extremo o QuickBooks Connector 2.0 - Crear Extremo). Ahora que Jitterbit tiene acceso a su instancia de QuickBooks Online, puede realizar cuatro actividades principales con sus datos de QuickBooks : consultar, crear, actualizar o eliminar.

Esta página se enfoca en actualizar los datos de QuickBooks, utilizando un ejemplo de actualización de un número de teléfono para un cliente de QuickBooks existente a través de un archivo XML a través de Jitterbit. Estos pasos se dividen en el comienzo de la actividad de actualización, la definición de los componentes de la operación y la despliegue y ejecución de la operación.

Creación de una Operación de Actualización de QuickBooks¶

1. Dentro de su proyecto dentro de Jitterbit Studio, hay varias formas de comenzar una nueva actividad de actualización de QuickBooks. Cada una de las siguientes opciones iniciará el Asistente de actualización de QuickBooks para guiarlo a través del proceso.

   • Vaya a Archivo > Nuevo > Conectores > Nueva actualización de QuickBooks.
   • En el árbol de la izquierda debajo de Conectores, haga clic con el botón derecho en la categoría QuickBooks y luego seleccione Nueva actualización de QuickBooks.
   • En el árbol de la izquierda debajo de Conectores, haga doble clic en la categoría QuickBooks, luego haga clic con el botón derecho en Actividades de actualización de QuickBooks y seleccione Nueva actualización de QuickBooks.
   • En la barra de herramientas superior, haga clic en el icono del conector (pieza de rompecabezas naranja) . En la ventana emergente, seleccione QuickBooks, luego seleccione Actualización de QuickBooks.

2. La pantalla Extremo del Asistente de actualización de QuickBooks le pide que seleccione el extremo en el que le gustaría actualizar los datos existentes. Ya debería haber configurado los extremos en QuickBooks Connector OAuth 1.0a - Crear Extremo o QuickBooks Connector 2.0 - Crear Extremo. Seleccione el extremo adecuado, por ejemplo, un ambiente aislado o un extremo de producción. Haga clic en Siguiente cuando termine.

   Nota

   El ejemplo utilizado en esta documentación actualiza los datos que se crearon en QuickBooks Connector - Create Activities utilizando un sandbox de QuickBooks. Para acceder a su sandbox, vaya a https://developer.intuit.com/ e inicie sesión en su cuenta de QuickBooks Online. Una vez que haya iniciado sesión, vaya a Documentos y herramientas > Sandbox > Ir a empresa para el sandbox que desea usar.

   

3. La pantalla Objeto del Asistente de actualización de QuickBooks le pide que seleccione el Objeto en el que le gustaría actualizar los datos existentes. En este ejemplo, usamos la API de contabilidad durante la creación de la aplicación QuickBooks Online y por lo tanto, solo tiene un Objeto para seleccionar: Contabilidad. Haga clic en el Objeto y luego haga clic en Siguiente para continuar.

4. La pantalla Componente del Asistente de actualización de QuickBooks muestra todos los componentes que están disponibles para que los datos existentes se actualicen dentro de su instancia de QuickBooks conectada. Para los fines de este tutorial, actualizaremos los datos existentes del Cliente (número de teléfono) y, por lo tanto, seleccionaremos el componente Cliente. Luego haga clic en el botón Finalizar.

5. Jitterbit Studio luego procederá a crear una estructura de solicitud y respuesta de API de QuickBooks que permitirá que los datos se actualicen dentro de su instancia conectada de QuickBooks Online. Debería aparecer una nueva pestaña en Studio llamada Actividades de actualización de QuickBooks. Puede cambiar el nombre de su actividad de creación aquí si lo desea; en el ejemplo, el nuestro se llama "Actualización de QuickBooks del cliente".

   Haga clic en el ícono + en el extremo derecho de las vistas de estructura de Solicitud y Respuesta para expandir todos los elementos dentro de cada estructura. Con cada lado ahora expandido, ahora debería ver una pantalla similar a la imagen que se muestra a continuación.

6. A continuación, en la misma pantalla, haga clic en el botón Crear operación ubicado debajo de Usar en una integración en la esquina superior derecha. Esto creará la operación Jitterbit que actualizará los datos existentes del Cliente en QuickBooks.

7. Debería abrirse una nueva pestaña en Studio llamada Operaciones, que contiene una representación gráfica de la actividad de actualización. Guarde su operación haciendo clic en el ícono de disco único para guardar solo esta operación o en el ícono de disco múltiple para guardar todos los cambios en su proyecto de integración. Debería ver el asterisco en la pestaña Operaciones y el título de la operación desaparecer a medida que su nueva actividad de actualización ahora se crea y se guarda en su proyecto.

Definición de los Componentes de Operación¶

Ahora necesitamos definir los otros componentes de la operación que aparecen dentro de la representación gráfica, incluidos el origen, la solicitud, la respuesta y el destino. A los fines de este tutorial, proporcionamos los siguientes ejemplos como referencia anterior: Jitterpak QuickBooksExample.jpk y los archivos adjuntos QuickBooksSampleRequestFiles.zip.

• Fuente: En el ejemplo, el siguiente XML es una solicitud de entrada para actualizar la información de un cliente existente. Este cliente específico se creó en el ejemplo utilizado en QuickBooks Connector - Crear actividades. El siguiente XML muestra que queremos actualizar el teléfono principal del cliente al valor proporcionado en el XML.

  Importante

  Tenga en cuenta que no todos los campos se enumeran en el archivo XML a continuación, solo los campos que queremos actualizar. Podemos actualizar solo campos específicos configurando:

  escaso="1"

  El valor de 1 indica un valor verdadero. Cuando sparse se establece en true, en el momento de la actualización, solo se actualizarán los valores proporcionados. Todos los demás valores no enumerados para el cliente dado siguen siendo los mismos.

  El valor de 0 indica un valor falso. Si sparse se estableciera en falso, todos los demás campos que no se enumeran se sobrescribirían con un valor nulo. Tenga mucho cuidado al configurar sparse="0" ya que esto eliminará efectivamente cualquier dato existente dentro de los campos que no están en la lista.

  Nota

  Es importante usar el Id y SyncToken que se usa en QuickBooks para asociar el cliente cuyo registro queremos actualizar. Si siguió el ejemplo utilizado en QuickBooks Connector - Create Activities, puede obtener el Id. y el SyncToken de su CustomerCreateResponse.xml.

  CustomerCreateRequest.xml

  <ns:INPUT xmlns:ns="urn:qboln-res:document:qboln:oln:functions">
      <Customer sparse="1">
          <Id>58</Id>
          <SyncToken>1</SyncToken>
          <GivenName>Peter1</GivenName>
      <PrimaryPhone>
        <FreeFormNumber>7678907699</FreeFormNumber>
        <Default>true</Default>
      </PrimaryPhone>
      </Customer>
  </ns:INPUT>
  

  Para usar el archivo XML, primero haga doble clic en el icono Fuente, luego seleccione un nuevo tipo de Fuente. Para este ejemplo, estamos usando un Agente Privado con archivos locales habilitados y, por lo tanto, seleccione un Tipo de "Archivo local" y luego Examinar hasta la ubicación. Si está utilizando los archivos de ejemplo, la Carpeta es 'C:\projects\quickbooks' y Obtener archivos es 'CustomerUpdateRequest.xml'.

• Objetivo: haga doble clic en el icono de destino. En el ejemplo, enviaremos los datos actualizados de QuickBooks a un archivo XML para asegurarnos de que se haya actualizado. Para hacer esto, volveremos a seleccionar un Tipo de "Archivo local" y Navegar a una ubicación en el Agente Privado donde queremos guardar los datos. En el ejemplo, la Carpeta es 'C:\projects\quickbooks' y el Nombre de archivo es 'CustomerUpdateResponse.xml'.

• Solicitud: Haga doble clic en el icono Solicitar y seleccione Crear nueva Transformación. O haga clic en el botón Crear solicitud de la pestaña Actividades de actualización de QuickBooks. Esto abrirá el Asistente de Transformación que lo guiará a través de la creación de la Solicitud.

  1. En la primera pantalla, Nombre, seleccione el tipo de fuente utilizado anteriormente. Para el ejemplo, elegimos XML. Deje el destino como predeterminado.
  2. En la siguiente pantalla, Fuente, elija el botón para Seleccionar una estructura XML existente. En el menú desplegable, seleccione "Esquemas de QuickBooks ". Luego seleccione 'QuickBooksUpdateRequest.xsd' para usarlo como su archivo de estructura. En la siguiente pantalla, haga clic en Finalizar.
  3. La pestaña Transformaciones debería abrirse donde puede completar su mapeo. Haga clic en el + en cada uno de los lados Origen y Destino para expandir los elementos en cada árbol. A continuación, haga clic en el icono Mapa automático que aparece debajo del lado de destino del árbol: Su pantalla de mapeo ahora debería verse similar a la siguiente:

• Respuesta: Haga doble clic en el ícono de Respuesta y seleccione Crear nueva Transformación. O haga clic en el botón Crear respuesta de la pestaña Actividades de actualización de QuickBooks. Esto abrirá el Asistente de Transformación que lo guiará a través de la creación de la Respuesta.

  1. En la primera pantalla, Nombre, seleccione el tipo de objetivo utilizado anteriormente. Para el ejemplo, elegimos XML. Deje la Fuente como predeterminada.
  2. En la siguiente pantalla, Fuente, elija el botón para Seleccionar una estructura XML existente. En el menú desplegable, seleccione "Esquemas de QuickBooks ". Luego seleccione 'QuickBooksUpdateResponse.xsd' para usarlo como su archivo de estructura. En la siguiente pantalla, haga clic en Finalizar.
  3. La pestaña Transformaciones debería abrirse donde puede completar su mapeo. Haga clic en el + en la parte inferior de cada uno de los lados Origen y Destino para expandir los elementos en cada árbol. Haga clic y arrastre la carpeta "SALIDA" desde el lado izquierdo (lado de origen) a la carpeta "SALIDA" en el lado derecho (lado de destino). Su pantalla de mapeo ahora debería verse similar a la que se muestra a continuación.

Despliegue y Ejecución de la Operación¶

Con la actividad de actualización de QuickBooks configurada, estamos listos para desplegar y ejecutar la operación.

En la pestaña Operaciones, haga clic en Desplegar icono. Luego haga clic en Ejecutar para colocar la operación en la cola de ejecución.

En la parte inferior de la pantalla, el monitor de operación debe indicar que su operación se ejecutó con éxito. De lo contrario, puede hacer doble clic en el icono Estado para ver los mensajes de registro.

Ahora también debería ver los datos actualizados de la salida de QuickBooks al destino que especificó. Para el ejemplo, el archivo ahora se crea en 'C:\projects\quickbooks\CustomerUpdateResponse.xml':

<ns:OUTPUT xmlns:ns="urn:qboln-res:document:qboln:oln:functions">
    <ns:Customer>
        <ns:Id>58</ns:Id>
        <ns:SyncToken>2</ns:SyncToken>
        <ns:MetaData>
            <ns:CreateTime>2016-11-21T10:31:59-07:00</ns:CreateTime>
            <ns:LastUpdatedTime>2016-11-21T10:36:35-07:00</ns:LastUpdatedTime>
        </ns:MetaData>
        <ns:GivenName>Peter1</ns:GivenName>
        <ns:FamilyName>Hynes1</ns:FamilyName>
        <ns:FullyQualifiedName>Soft Tech1</ns:FullyQualifiedName>
        <ns:CompanyName>Soft Tech1</ns:CompanyName>
        <ns:DisplayName>Soft Tech1</ns:DisplayName>
        <ns:PrintOnCheckName>SoftTech LLC</ns:PrintOnCheckName>
        <ns:Active>1</ns:Active>
        <ns:PrimaryPhone>
            <ns:FreeFormNumber>7678907699</ns:FreeFormNumber>
        </ns:PrimaryPhone>
        <ns:Mobile>
            <ns:FreeFormNumber>8678907676</ns:FreeFormNumber>
        </ns:Mobile>
        <ns:Fax>
            <ns:FreeFormNumber>9678907676</ns:FreeFormNumber>
        </ns:Fax>
        <ns:PrimaryEmailAddr>
            <ns:Address>softtech@test.com</ns:Address>
        </ns:PrimaryEmailAddr>
        <ns:WebAddr>
            <ns:URI>http://stech.com</ns:URI>
        </ns:WebAddr>
        <ns:DefaultTaxCodeRef>2</ns:DefaultTaxCodeRef>
        <ns:Taxable>1</ns:Taxable>
        <ns:BillAddr>
            <ns:Id>96</ns:Id>
            <ns:Line1>456 Chinna Street</ns:Line1>
            <ns:City>Tracy</ns:City>
            <ns:Country>USA</ns:Country>
            <ns:CountrySubDivisionCode>767</ns:CountrySubDivisionCode>
            <ns:PostalCode>95391</ns:PostalCode>
            <ns:Lat>37.7582199</ns:Lat>
            <ns:Long>-121.548418</ns:Long>
        </ns:BillAddr>
        <ns:ShipAddr>
            <ns:Id>97</ns:Id>
            <ns:Line1>456 Chinna Street</ns:Line1>
            <ns:City>Tracy</ns:City>
            <ns:Country>str1234</ns:Country>
            <ns:CountrySubDivisionCode>767</ns:CountrySubDivisionCode>
            <ns:PostalCode>95391</ns:PostalCode>
            <ns:Lat>INVALID</ns:Lat>
            <ns:Long>INVALID</ns:Long>
        </ns:ShipAddr>
        <ns:Job>0</ns:Job>
        <ns:BillWithParent>0</ns:BillWithParent>
        <ns:Balance>0</ns:Balance>
        <ns:BalanceWithJobs>0</ns:BalanceWithJobs>
        <ns:CurrencyRef name="United States Dollar">USD</ns:CurrencyRef>
        <ns:PreferredDeliveryMethod>Print</ns:PreferredDeliveryMethod>
    </ns:Customer>
</ns:OUTPUT>

Además, cuando revise su cuenta de QuickBooks, debería encontrar el número de teléfono del Cliente actualizado.