Actividades de Eliminación de QuickBooks Connector¶

Antes de poder eliminar los datos de QuickBooks de 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 centra en la eliminación de datos de QuickBooks, usando un ejemplo de eliminación de un crédito de proveedor con una identificación específica dentro de QuickBooks a través de un archivo XML a través de Jitterbit. Estos pasos se dividen en el inicio de la actividad de eliminación, la definición de los componentes de la operación y la despliegue y ejecución de la operación.

Como solución alternativa, si desea eliminar los datos asociados con un componente en particular para el cual la actividad de eliminación no está permitida, puede realizar una actividad de actualización y establecer sparse="0" para establecer todos los campos en nulo. Ver más en QuickBooks Connector - Actualizar actividades.

Para referencia, consulte Jitterpak QuickBooksExample.jpk y los archivos adjuntos en QuickBooksSampleRequestFiles.zip necesarios para ejecutar las operaciones de Jitterpak. Descomprima QuickBooksSampleRequestFiles.zip en su unidad "C:\" o, si lo descomprime en otro directorio, asegúrese de editar los directorios de origen y de destino en las operaciones. Si es la primera vez que usa un Jitterpak, consulte Importación de un Jitterpak.

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

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

   • Vaya a Archivo > Nuevo > Conectores > Nueva eliminació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 eliminació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 QuickBooks Eliminar actividades y seleccione Nueva eliminació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 QuickBooks Delete.

2. La pantalla Extremo del Asistente de eliminación de QuickBooks le pide que seleccione el extremo del que desea eliminar los datos. Ya debería haber configurado extremos en QuickBooks Connector OAuth 1.0a - Create 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 elimina un crédito de proveedor para un cliente específico en una cuenta de espacio aislado de QuickBooks. Para obtener más información, también puede seguir los ejemplos de creación y actualización de crédito de proveedor proporcionados en el Jitterpak.

   

3. La pantalla Objeto del Asistente de eliminación de QuickBooks le pide que seleccione el objeto que desea eliminar. En este ejemplo, usamos la API de Contabilidad durante la creación de la aplicación QuickBooks Online y, por lo tanto, solo tenemos 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 eliminación de QuickBooks muestra todos los Componentes asociados con el objeto Contabilidad en su instancia conectada de QuickBooks. Para los fines de este tutorial, eliminaremos un Crédito de proveedor existente y, por lo tanto, seleccionaremos el componente Crédito de proveedor. Luego haga clic en el botón Finalizar.

   Nota

   No todos estos Componentes necesariamente se pueden eliminar de Jitterbit debido a las limitaciones impuestas por el software QuickBooks.

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 QuickBooks Delete Activities. Puede cambiar el nombre de su actividad de creación aquí si lo desea; en el ejemplo, el nuestro se llama "Eliminació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 eliminará los datos de crédito de proveedor existentes en QuickBooks.

7. Debería abrirse una nueva pestaña en Studio llamada Operaciones, que contiene una representación gráfica de la actividad Eliminar. 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 Eliminar 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 eliminar un crédito de proveedor existente con la identificación de QuickBooks especificada.

  Nota

  Es importante usar el Id y SyncToken que se usa en QuickBooks para asociar el registro que queremos eliminar. Tenga en cuenta que Sparse se establece en "0" porque queremos eliminar todos los datos de crédito del proveedor.

  VendorCreditDeleteRequest.xml

  <?xml version="1.0" encoding="utf-8"?>
  <ns:INPUT xmlns:ns="urn:qboln-res:document:qboln:oln:functions">
  <VendorCredit sparse="0">
      <Id>155</Id>
      <SyncToken>1</SyncToken>
  </VendorCredit>
  </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 'VendorCreditDeleteRequest.xml'.

• Objetivo: haga doble clic en el icono de destino. En el ejemplo, enviaremos los datos eliminados de QuickBooks a un archivo XML para asegurarnos de que se hayan eliminado. 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 'VendorCreditDeleteResponse.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 Eliminar actividades 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 'QuickBooksDeleteRequest.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. 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: Para este ejemplo, haga clic con el botón derecho en el ícono de Respuesta y seleccione Transferencia. En su lugar, podría crear una nueva Transformación y asignar sus campos como en las actividades de creación, consulta y actualización.

Despliegue y Ejecución de la Operación¶

Con la actividad de eliminació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 eliminados de la salida de QuickBooks al destino que especificó. Para el ejemplo, el archivo ahora se crea en 'C:\projects\quickbooks\VendorCreditDeleteResponse.xml':

Además, cuando revise su cuenta de QuickBooks, debería encontrar que el crédito de proveedor especificado ya no existe.