Conector de Square en Jitterbit Studio
Resumen
El conector de Square proporciona una interfaz para ingresar la entrada 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 del 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 Clientes en la API de Square. Para interactuar con objetos adicionales, como el Catálogo, Clientes, Inventario, Facturas, Órdenes, Pagos, Suscripciones y objetos de 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 a Square, estableciendo acceso a Square, y luego se usa 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 a Square y se utiliza como fuente en una operación.
-
Actividad de Creación: Crea nuevos clientes en una conexión a Square y se utiliza como destino en una operación.
-
Actividad de Actualización: Actualiza clientes existentes en una conexión a Square y se utiliza como destino en una operación.
-
Actividad de Eliminación: Elimina clientes existentes de una conexión a 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 a 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:

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 su licencia.
Registro en 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 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).

Solución de problemas
Si experimentas problemas con el conector de Square, se recomiendan los siguientes pasos de solución de problemas:
-
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 haya descargado al agente (a menos que se esté utilizando la política de organización Deshabilitar actualización automática del conector).
-
Revisa los registros de operaciones para cualquier información escrita durante la ejecución de la operación.
-
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.
-
Si utilizas 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 más información sobre el registro detallado del conector, consulta Registro detallado para conectores que utilizan agentes privados de Jitterbit.
-
Si utilizas agentes privados, puedes revisar los registros del agente para más información.
-
Para consideraciones adicionales de solución de problemas, consulta Solución de problemas de operaciones.