Conector de Square en Jitterbit Studio
Resumen
El conector de Square proporciona una interfaz para ingresar datos proporcionados por el usuario, como credenciales, para crear una conexión autenticada a Square. Esa conexión proporciona la base para configurar actividades del conector de Square asociadas que interactúan con la conexión. En conjunto, una conexión específica de Square y sus actividades se denominan punto de conexión de Square.
Nota
Este conector admite el objeto Customers en la API de Square. Para interactuar con objetos adicionales, como Catalog, Customers, Inventory, Invoices, Orders, Payments, Subscriptions y Terminal, utiliza el conector de Square v2.
Consejo
Las recetas de integración están disponibles para este conector a través de Jitterbit Marketplace.
Requisitos previos y versiones de API compatibles
Este conector se puede utilizar con agentes en la nube y agentes privados.
Los agentes descargan automáticamente la versión más reciente de este conector cuando es necesario. En agentes privados, puedes suspender estas actualizaciones con la política de organización Disable Auto Connector Update.
El conector de Square utiliza la API REST de Square. Consulta la documentación de la API para obtener información sobre los campos de esquema.
Descripción general del conector
Este conector se utiliza primero para 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 origen o destino dentro de una operación:
-
Actividad de consulta: Recupera clientes de una conexión de Square y se utiliza como origen 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.
En conjunto, una conexión específica de Square y sus actividades se denominan punto de conexión de Square. Una vez que se configura una conexión, las actividades asociadas con el punto de conexión están disponibles en el filtro Endpoints:

Los puntos de conexión creados con este conector se incluyen en informes de uso de puntos de conexión y cuentan para tu licencia.
Registro de Square
Como la conexión será una aplicación que interactúa con Square, necesitarás un Token de acceso personal para acceder al servidor de Square. Consulta Registro de Square para obtener más detalles.
Acceso al conector
Se accede al conector de Square desde la pestaña Project endpoints and connectors de la paleta de componentes de diseño (consulta Paleta de componentes de diseño).

Solución de problemas
Si experimentas problemas con el conector de Square, se recomiendan estos pasos para la solución de problemas:
-
Haz clic en el botón Probar en la configuración de conexión para asegurar que la conexión sea exitosa y para descargar la versión más reciente del conector en el agente (a menos que se use la política de organización Deshabilitar actualización automática del conector).
-
Revisa los registros de operación para obtener cualquier información escrita durante la ejecución de la operación.
-
Habilita el registro de depuración de operación (para agentes en la nube o para agentes privados) para generar archivos de registro y datos adicionales.
-
Si usas agentes privados, puedes habilitar el registro detallado del conector para este conector agregando esta entrada de configuración de registrador al archivo
logback.xmlde tu agente privado:<logger name="org.jitterbit.connector.verbose.logging.square" level="DEBUG"/>Para obtener más información sobre el registro detallado del conector, consulta Registro detallado para conectores usando agentes privados de Jitterbit.
-
Si usas agentes privados, puedes revisar los registros del agente para obtener más información.
-
Para consideraciones adicionales sobre la solución de problemas, consulta Solución de problemas de operación.