Saltar al contenido

Conector de Square para Jitterbit Studio

Resumen

El conector de Square proporciona una interfaz para ingresar la información proporcionada por el usuario, como credenciales, para crear una conexión autenticada con Square. Esa conexión proporciona la base para configurar las actividades asociadas al conector de Square que interactúan con la conexión. Juntos, una conexión específica de Square y sus actividades se denominan un punto final de Square.

Nota

Este conector admite el objeto Customers en la API de Square. Para interactuar con objetos adicionales, como el Catalog, Customers, Inventory, Invoices, Orders, Payments, Subscriptions y Terminal, utiliza el conector de Square v2.

Consejo

Recetas de integración están disponibles para este conector a través de Jitterbit Marketplace.

Versiones de API soportadas y requisitos previos

El conector de Square utiliza la API REST de Square. Consulta la documentación de la API para obtener información sobre los campos del esquema.

El conector de Square requiere el uso de una versión de agente 10.1 o posterior. Estas versiones de agente descargan automáticamente la última versión del conector cuando es necesario.

Descripción general del conector

Este conector se utiliza para primero configurar una conexión de Square, estableciendo acceso a Square, y luego se utiliza para configurar una o más actividades de Square asociadas con esa conexión como fuente o destino dentro de una operación:

  • Actividad de Consulta: Recupera clientes de una conexión de Square y se utiliza como fuente en una operación.

  • Actividad de Creación: Crea nuevos clientes en una conexión de Square y se utiliza como destino en una operación.

  • Actividad de Actualización: Actualiza clientes existentes en una conexión de Square y se utiliza como destino en una operación.

  • Actividad de Eliminación: Elimina clientes existentes de una conexión de Square y se utiliza como destino en una operación.

El conector de Square utiliza la API REST de Square. Consulta la documentación de la API para obtener información sobre los campos del esquema.

El conector de Square requiere el uso de una versión de agente 10.1 o superior.

Juntos, una conexión específica de Square y sus actividades se denominan un punto final de Square. Una vez que se configura una conexión, las actividades asociadas con el punto final están disponibles desde el filtro Puntos finales:

Pestaña de Conexiones

Nota

Este conector es un conector basado en Connector SDK, que puede ser mencionado por Jitterbit al comunicar cambios realizados en conectores construidos con el Connector SDK.

Los puntos finales creados con este conector están incluidos en informes de uso de puntos finales y cuentan para tu licencia.

Registro en Square

Como la conexión será una aplicación que se comunica con Square, necesitarás un Token de Acceso Personal para acceder al servidor de Square. Consulta Registro en Square para más detalles.

Accediendo al conector

El conector de Square se accede desde la pestaña Puntos finales y conectores del proyecto en la paleta de componentes de diseño (ver Paleta de componentes de diseño).

Actividades

Solución de problemas

Si experimentas problemas con el conector de Square, se recomiendan los siguientes pasos de solución de problemas:

  1. Haz clic en el botón Probar en la configuración de conexión para asegurarte de que la conexión sea exitosa y de que la última versión del conector se descargue al agente (a menos que estés utilizando la política de organización Deshabilitar actualización automática del conector).

  2. Revisa los registros de operaciones para obtener información escrita durante la ejecución de la operación.

  3. Habilita el registro de depuración de operaciones (para agentes en la nube o para agentes privados) para generar archivos de registro y datos adicionales.

  4. Si utilizas agentes privados, puedes habilitar el registro detallado del conector para este conector agregando esta entrada de configuración de registro al archivo logback.xml de tu agente privado:

    <logger name="org.jitterbit.connector.verbose.logging.square" level="DEBUG"/>
    

    Para más información sobre el registro detallado del conector, consulta Registro detallado para conectores que utilizan agentes privados de Jitterbit.

  5. Si utilizas agentes privados, puedes revisar los registros del agente para obtener más información.

  6. Para consideraciones adicionales de solución de problemas, consulta Solución de problemas de operaciones.