Conector de origen

Conector de Square

Integración de Square con bases de datos, warehouses y herramientas de BI

Pagos y comercio para retail y venta online. Datrise captura entidades de Square como payments, orders, customers, catalog items, and locations, y luego entrega modelos normalizados y tipados para reporting en warehouse, atribución y flujos de IA.

La Square API v2 (Connect v2, dated versioning e.g. `Square-Version: 2025-01-23`) se autentica con OAuth 2.0, personal access token, las cargas incrementales usan updated_at (via the `updated_at_begin_time` query parameter on List/Search endpoints such as List Payments).

De los 5 objetos, 4 se sincronizan con upsert por clave primaria y 1 como flujos append-only, de modo que cada ejecución incremental solo mueve lo que cambió desde la última marca de agua. Cada objeto llega a su propia tabla (por ejemplo `square_payments`) con el esquema derivado de la API de Square, no de un CSV, en cualquiera de los 43 destinos soportados.

Datrise está en acceso anticipado: elige un destino abajo para ver el pipeline de Square y únete a la lista de espera para recibir el conector con onboarding guiado.

Sincronización incrementalMapeo consciente del esquema43 destinos disponibles

Qué datos de Square extrae Datrise

Cada objeto llega a su propia tabla tipada. El modo de sync se deriva del objeto: los objetos de historial se anexan, el resto se actualiza con upsert.

Objeto	Tabla de destino	Modo de sync
payments	square_payments	Append incremental por marca de tiempo
orders	square_orders	Upsert por clave primaria, incremental por updated-at
customers	square_customers	Upsert por clave primaria, incremental por updated-at
catalog items	square_catalog_items	Upsert por clave primaria, incremental por updated-at
locations	square_locations	Upsert por clave primaria, incremental por updated-at

API de Square: datos de configuración del conector

Verificado contra la documentación del proveedor el 2026-09-02. Los valores desconocidos se dejan en blanco, no se inventan.

API	Square API v2 (Connect v2, dated versioning e.g. `Square-Version: 2025-01-23`)
Autenticación	OAuth 2.0, personal access token — Production apps use OAuth 2.0 with seller-authorized access and refresh tokens; development typically uses a personal access token from the Developer Dashboard.
Paginación	cursor — List/Search endpoints return a `cursor` field when results are truncated; pass it back on the next call, it expires after 5 minutes, and default/max `limit` (e.g. 100 for List Payments) varies per endpoint.
Límite de peticiones	No publicado
Cursor incremental	updated_at (via the `updated_at_begin_time` query parameter on List/Search endpoints such as List Payments) — `begin_time` filters on `created_at` and defaults to one year back if omitted, so incremental jobs must explicitly pass `updated_at_begin_time` to also capture edited (not just new) records.
Webhooks	Sí — Square Webhooks (event notifications, e.g. `payment.updated`, `customer.deleted`)
Exportación masiva	No
Detección de borrados	Sí — Entity-specific `.deleted` webhook events (e.g. `customer.deleted`, `invoice.deleted`) carry a `deleted: true` flag; Catalog objects are soft-deleted and can be retrieved with `include_deleted_objects` on Batch Retrieve Catalog Objects.

Referencia oficial de la API

Compara esto con todas las demás APIs documentadas

Destinos populares para Square

Elige un destino abajo para abrir la página de pipeline lista para usar.

A
Airtable
Destino de hoja relacional para equipos de operaciones y go-to-market.
Ver pipeline
A
Amazon Athena
SQL serverless sobre tablas del data lake en S3.
Ver pipeline
A
Amazon DynamoDB
Base key-value y documental serverless en AWS.
Ver pipeline
A
Amazon QuickSight
BI serverless en AWS con SPICE y analítica embebida.
Ver pipeline
A
Amazon Redshift
Almacén a escala petabyte en AWS con Spectrum.
Ver pipeline
A
Amazon S3 Data Lake
Zona de aterrizaje en object storage para parquet y snapshots.
Ver pipeline
A
Apache Superset
BI open source para exploración SQL, gráficos y publicación de dashboards.
Ver pipeline
A
Archivos CSV
Destino de archivos planos para exportaciones y compartición ligera.
Ver pipeline
A
Azure Data Lake Storage
Almacenamiento ADLS Gen2 para cargas analíticas.
Ver pipeline

Preguntas sobre el conector de Square

¿Qué datos de Square extrae el conector?: 5 objetos: payments, orders, customers, catalog items y locations. Cada uno se carga en su propia tabla con tipos preservados; los objetos con historial (1: payments) se cargan como append-only.
¿La integración de Square es incremental?: Sí. Tras la carga inicial completa, cada ejecución lee solo los registros cambiados desde la última marca de agua (updated-at o timestamp del evento) y aplica upsert o append según el objeto.
¿A dónde puedo cargar los datos de Square?: A 43 destinos: bases de datos relacionales, warehouses, data lakes, hojas de cálculo y herramientas de BI. Cada par Square → destino tiene su propia página con el mapeo de objetos a tablas.

Otras fuentes de ERP

Otras fuentes de la misma categoría, cada una con su propia página de conector.

Acceso anticipado

Lanza tu pipeline de Square con onboarding guiado

Únete a la lista de espera para obtener acceso prioritario a integraciones de Square con setup guiado, mapeo consciente del esquema y sincronización incremental de nivel producción.