Conector de origem

Conector Square

Integração do Square com bancos de dados, warehouses e ferramentas de BI

Pagos e comércio para varejo e venda online. A Datrise captura entidades do Square como payments, orders, customers, catalog items, and locations, e entrega modelos normalizados e tipados para reporting em warehouse, atribuicao e fluxos de IA.

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

Dos 5 objetos, 4 sincronizam com upsert por chave primária e 1 como fluxos append-only, então cada execução incremental move só o que mudou desde a última marca d'água. Cada objeto chega na própria tabela (por exemplo `square_payments`) com esquema derivado da API do Square, não de um CSV, em qualquer um dos 43 destinos suportados.

A Datrise está em acesso antecipado: escolha um destino abaixo para ver o pipeline do Square e entre na lista de espera para receber o conector com onboarding guiado.

Sync incrementalMapeamento orientado a schema43 destinos disponíveis

Quais dados do Square a Datrise extrai

Cada objeto chega na própria tabela tipada. O modo de sync deriva do objeto: objetos de histórico fazem append, o restante faz upsert.

Objeto	Tabela de destino	Modo de sync
payments	square_payments	Append incremental por timestamp
orders	square_orders	Upsert por chave primária, incremental por updated-at
customers	square_customers	Upsert por chave primária, incremental por updated-at
catalog items	square_catalog_items	Upsert por chave primária, incremental por updated-at
locations	square_locations	Upsert por chave primária, incremental por updated-at

API do Square: fatos de configuração do conector

Verificado na documentação do fornecedor em 2026-09-02. Valores desconhecidos ficam em branco, não são inventados.

API	Square API v2 (Connect v2, dated versioning e.g. `Square-Version: 2025-01-23`)
Autenticação	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.
Paginação	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.
Limite de requisições	Não 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	Sim — Square Webhooks (event notifications, e.g. `payment.updated`, `customer.deleted`)
Exportação em massa	Não
Detecção de exclusões	Sim — 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.

Referência oficial da API

Compare isto com todas as outras APIs documentadas

Destinos populares para Square

Escolha um destino abaixo para abrir a pagina de pipeline pronta.

A
Airtable
Destino de planilha relacional para equipes de operações e go-to-market.
Ver pipeline
A
Amazon Athena
SQL serverless sobre tabelas do data lake no S3.
Ver pipeline
A
Amazon DynamoDB
Banco key-value e documental serverless na AWS.
Ver pipeline
A
Amazon QuickSight
BI serverless na AWS com SPICE e analytics embutido.
Ver pipeline
A
Amazon Redshift
Warehouse em escala petabyte na AWS com Spectrum.
Ver pipeline
A
Amazon S3 Data Lake
Zona de landing em object storage para parquet e snapshots.
Ver pipeline
A
Apache Superset
BI open source para exploração SQL, gráficos e publicação de dashboards.
Ver pipeline
A
Arquivos CSV
Destino de arquivos planos para exports e compartilhamento leve.
Ver pipeline
A
Azure Data Lake Storage
Armazenamento ADLS Gen2 para cargas analíticas.
Ver pipeline

Perguntas sobre o conector Square

Quais dados do Square o conector extrai?: 5 objetos: payments, orders, customers, catalog items e locations. Cada um vai para a própria tabela com tipos preservados; objetos com histórico (1: payments) são carregados como append-only.
A integração do Square é incremental?: Sim. Depois da carga inicial completa, cada execução lê só os registros alterados desde a última marca d'água (updated-at ou timestamp do evento) e aplica upsert ou append conforme o objeto.
Para onde posso carregar os dados do Square?: Para 43 destinos: bancos relacionais, warehouses, data lakes, planilhas e ferramentas de BI. Cada par Square → destino tem a própria página com o mapeamento de objetos para tabelas.

Outras fontes de ERP

Outras fontes da mesma categoria, cada uma com a própria página de conector.

Acesso antecipado

Lance seu pipeline de Square com onboarding guiado

Entre na lista de espera para ter acesso prioritário às integrações de Square com setup guiado, mapeamento orientado a schema e sync incremental de nível produção.