Informazioni di riferimento sul connettore quadrato

Important

Questa funzionalità è in versione beta. Gli amministratori dell'area di lavoro possono controllare l'accesso a questa funzionalità dalla pagina Anteprime . Vedere Gestire le anteprime di Azure Databricks.

Questa pagina contiene informazioni di riferimento per il connettore Square gestito, incluse le tabelle di origine supportate e gli schemi di tabella di destinazione.

Tabelle di origine supportate

Il connettore Square supporta le tabelle di origine seguenti, tutte nello schema di default origine:

Tabella di origine	Chiave primaria	Description	Modalità di sincronizzazione	Campo cursore
`locations`	`id`	Località aziendali configurate nell'account Square, tra cui valuta, fuso orario e funzionalità.	Solo aggiornamento completo
`customers`	`id`	Profili dei clienti nell'account Square, inclusi i dettagli di contatto e l'origine della creazione.	Solo aggiornamento completo
`team_member_wages`	`id`	Impostazioni del salario per i membri del team, inclusi il titolo di lavoro e l'idoneità alla mancia.	Solo aggiornamento completo
`bank_accounts`	`id`	Conti bancari collegati al conto Square, inclusi lo stato e il tipo di conto.	Solo aggiornamento completo
`shifts`	`id`	Turni di lavoro lavorati dai membri del team, inclusi orari e salari di inizio e fine.	Solo aggiornamento completo
`team_members`	`id`	Membri del team nell'account Square, inclusi lo stato, le posizioni assegnate e le impostazioni del salario.	Solo aggiornamento completo
`inventory`	`catalog_object_id`	Conteggi dell'inventario per gli oggetti catalogo in ogni posizione.	Solo aggiornamento completo
`loyalty`	`id`	Account del programma fedeltà, inclusi saldi punto e date di registrazione.	Solo aggiornamento completo
`payments`	`id`	Pagamenti effettuati tramite Square, inclusi importi, stato e ordini associati.	Incrementale	`created_at`
`refunds`	`id`	Rimborsi elaborati tramite Square, inclusi importi, stato e pagamenti associati.	Incrementale	`created_at`
`items`	`id`	Elementi del catalogo nell'account Square, inclusi i dettagli dell'elemento e il controllo delle versioni.	Incrementale	`updated_at`
`categories`	`id`	Categorie di catalogo utilizzate per organizzare gli elementi.	Incrementale	`updated_at`
`discounts`	`id`	Sconti del catalogo disponibili nel tuo account Square.	Incrementale	`updated_at`
`taxes`	`id`	Imposte di catalogo configurate nell'account Square.	Incrementale	`updated_at`
`modifier_lists`	`id`	Elenchi di modifica del catalogo applicati agli elementi.	Incrementale	`updated_at`
`cash_drawers`	`id`	Cassetto contanti turni per ogni posizione, inclusi gli importi di cassa di apertura e chiusura.	Solo aggiornamento completo
`orders`	`id`	Ordini effettuati tra le posizioni square, inclusi gli elementi di riga, i totali e gli adempimenti.	Incrementale	`updated_at`

Opzioni connettore

Vedi Esempi per l'uso.

Option	Tipo	Scope	Required	Si applica a	Description
`start_datetime`	Corda (`yyyy-MM-ddTHH:mm:ss.SSSSSSZ`)	Pipeline	No	Tutte le tabelle incrementali (`payments`, `refunds`, `items`, `categories`, `discounts`, `taxes`, `modifier_lists`, ) `orders`	Data e ora più antiche da cui ingerire dati. Di default è 365 giorni prima della prima sincronizzazione. Si applica solo alla prima sincronizzazione di ogni tabella; le sincronizzazioni successive riprendono dal cursore memorizzato.

Schemi di tabella di destinazione

`locations`

Chiave primaria:idModalità di sincronizzazione: Solo aggiornamento completo

Campo	Tipo di dati
`id`	`STRING`
`name`	`STRING`
`timezone`	`STRING`
`capabilities`	`STRING`
`status`	`STRING`
`created_at`	`STRING`
`merchant_id`	`STRING`
`country`	`STRING`
`language_code`	`STRING`
`currency`	`STRING`
`business_name`	`STRING`
`type`	`STRING`
`business_hours`	`STRING`
`mcc`	`STRING`

`customers`

Chiave primaria:idModalità di sincronizzazione: Solo aggiornamento completo

Campo	Tipo di dati
`id`	`STRING`
`created_at`	`STRING`
`updated_at`	`STRING`
`given_name`	`STRING`
`family_name`	`STRING`
`email_address`	`STRING`
`phone_number`	`STRING`
`company_name`	`STRING`
`reference_id`	`STRING`
`note`	`STRING`
`creation_source`	`STRING`
`version`	`BIGINT`

`team_member_wages`

Chiave primaria:idModalità di sincronizzazione: Solo aggiornamento completo

Campo	Tipo di dati
`id`	`STRING`
`team_member_id`	`STRING`
`title`	`STRING`
`job_id`	`STRING`
`tip_eligible`	`BOOLEAN`

`bank_accounts`

Chiave primaria:idModalità di sincronizzazione: Solo aggiornamento completo

Campo	Tipo di dati
`id`	`STRING`
`account_number_suffix`	`STRING`
`country`	`STRING`
`currency`	`STRING`
`account_type`	`STRING`
`holder_name`	`STRING`
`primary_bank_identification_number`	`STRING`
`status`	`STRING`
`creditable`	`BOOLEAN`
`debitable`	`BOOLEAN`
`location_id`	`STRING`

`shifts`

Chiave primaria:idModalità di sincronizzazione: Solo aggiornamento completo

Campo	Tipo di dati
`id`	`STRING`
`employee_id`	`STRING`
`team_member_id`	`STRING`
`location_id`	`STRING`
`timezone`	`STRING`
`start_at`	`STRING`
`end_at`	`STRING`
`wage`	`STRING`
`status`	`STRING`
`created_at`	`STRING`
`updated_at`	`STRING`

`team_members`

Chiave primaria:idModalità di sincronizzazione: Solo aggiornamento completo

Campo	Tipo di dati
`id`	`STRING`
`is_owner`	`BOOLEAN`
`status`	`STRING`
`given_name`	`STRING`
`family_name`	`STRING`
`email_address`	`STRING`
`created_at`	`STRING`
`updated_at`	`STRING`
`assigned_locations`	`STRING`
`merchant_id`	`STRING`
`wage_setting`	`STRING`

`inventory`

Chiave primaria:catalog_object_idModalità di sincronizzazione: Solo aggiornamento completo

Campo	Tipo di dati
`catalog_object_id`	`STRING`
`catalog_object_type`	`STRING`
`state`	`STRING`
`location_id`	`STRING`
`quantity`	`STRING`
`calculated_at`	`STRING`

`loyalty`

Chiave primaria:idModalità di sincronizzazione: Solo aggiornamento completo

Campo	Tipo di dati
`id`	`STRING`
`program_id`	`STRING`
`balance`	`BIGINT`
`lifetime_points`	`BIGINT`
`customer_id`	`STRING`
`enrolled_at`	`STRING`
`created_at`	`STRING`
`updated_at`	`STRING`

`payments`

Chiave primaria:idCampo cursore:created_at

Campo	Tipo di dati
`id`	`STRING`
`created_at`	`STRING`
`updated_at`	`STRING`
`amount_money`	`STRING`
`total_money`	`STRING`
`status`	`STRING`
`source_type`	`STRING`
`location_id`	`STRING`
`order_id`	`STRING`
`receipt_number`	`STRING`
`receipt_url`	`STRING`

`refunds`

Chiave primaria:idCampo cursore:created_at

Campo	Tipo di dati
`id`	`STRING`
`created_at`	`STRING`
`updated_at`	`STRING`
`amount_money`	`STRING`
`status`	`STRING`
`location_id`	`STRING`
`order_id`	`STRING`
`payment_id`	`STRING`
`reason`	`STRING`

`items`

Chiave primaria:idCampo cursore:updated_at

Campo	Tipo di dati
`id`	`STRING`
`type`	`STRING`
`updated_at`	`STRING`
`version`	`BIGINT`
`is_deleted`	`BOOLEAN`
`present_at_all_locations`	`BOOLEAN`
`item_data`	`STRING`

`categories`

Chiave primaria:idCampo cursore:updated_at

Campo	Tipo di dati
`id`	`STRING`
`type`	`STRING`
`updated_at`	`STRING`
`version`	`BIGINT`
`is_deleted`	`BOOLEAN`
`present_at_all_locations`	`BOOLEAN`
`category_data`	`STRING`

`discounts`

Chiave primaria:idCampo cursore:updated_at

Campo	Tipo di dati
`id`	`STRING`
`type`	`STRING`
`updated_at`	`STRING`
`version`	`BIGINT`
`is_deleted`	`BOOLEAN`
`present_at_all_locations`	`BOOLEAN`
`discount_data`	`STRING`

`taxes`

Chiave primaria:idCampo cursore:updated_at

Campo	Tipo di dati
`id`	`STRING`
`type`	`STRING`
`updated_at`	`STRING`
`version`	`BIGINT`
`is_deleted`	`BOOLEAN`
`present_at_all_locations`	`BOOLEAN`
`tax_data`	`STRING`

`modifier_lists`

Chiave primaria:idCampo cursore:updated_at

Campo	Tipo di dati
`id`	`STRING`
`type`	`STRING`
`updated_at`	`STRING`
`version`	`BIGINT`
`is_deleted`	`BOOLEAN`
`present_at_all_locations`	`BOOLEAN`
`modifier_list_data`	`STRING`

`cash_drawers`

Chiave primaria:idModalità di sincronizzazione: Solo aggiornamento completo

Campo	Tipo di dati
`id`	`STRING`
`location_id`	`STRING`
`opened_at`	`STRING`
`ended_at`	`STRING`
`closed_at`	`STRING`
`state`	`STRING`
`description`	`STRING`
`opened_cash_money`	`STRING`
`cash_payment_money`	`STRING`
`cash_refunds_money`	`STRING`
`cash_paid_in_money`	`STRING`
`cash_paid_out_money`	`STRING`
`expected_cash_money`	`STRING`
`closed_cash_money`	`STRING`
`opening_employee_id`	`STRING`
`ending_employee_id`	`STRING`
`closing_employee_id`	`STRING`
`device`	`STRING`

`orders`

Chiave primaria:idCampo cursore:updated_at

Campo	Tipo di dati
`id`	`STRING`
`location_id`	`STRING`
`created_at`	`STRING`
`updated_at`	`STRING`
`closed_at`	`STRING`
`state`	`STRING`
`version`	`BIGINT`
`total_money`	`STRING`
`total_tax_money`	`STRING`
`total_discount_money`	`STRING`
`total_tip_money`	`STRING`
`total_service_charge_money`	`STRING`
`net_amounts`	`STRING`
`source`	`STRING`
`line_items`	`STRING`
`fulfillments`	`STRING`
`returns`	`STRING`
`customer_id`	`STRING`
`reference_id`	`STRING`

Autorizzazioni OAuth necessarie

Il token di accesso Square deve avere le autorizzazioni OAuth seguenti. Il set di autorizzazioni richieste dal connettore dipende dalle tabelle che si inseriscono. Per altre informazioni, vedere le informazioni di riferimento sulle autorizzazioni OAuth quadrate.

Autorizzazione	Obbligatorio per
`MERCHANT_PROFILE_READ`	`locations`
`CUSTOMERS_READ`	`customers`
`EMPLOYEES_READ`	`team_members`, `team_member_wages`
`TIMECARDS_READ`	`shifts`
`BANK_ACCOUNTS_READ`	`bank_accounts`
`INVENTORY_READ`	`inventory`
`LOYALTY_READ`	`loyalty`
`PAYMENTS_READ`	`payments`, `refunds`
`ITEMS_READ`	`items`, `categories`, `discounts`, `taxesmodifier_lists`
`CASH_DRAWER_READ`	`cash_drawers`
`ORDERS_READ`	`orders`

Commenti e suggerimenti

Questa pagina è stata utile?

Last updated on 2026-08-24

Informazioni di riferimento sul connettore quadrato

Tabelle di origine supportate

Opzioni connettore

Schemi di tabella di destinazione

locations

customers

team_member_wages

bank_accounts

shifts

team_members

inventory

loyalty

payments

refunds

items

categories

discounts

taxes

modifier_lists

cash_drawers

orders

Autorizzazioni OAuth necessarie

Commenti e suggerimenti

Risorse aggiuntive

`locations`

`customers`

`team_member_wages`

`bank_accounts`

`shifts`

`team_members`

`inventory`

`loyalty`

`payments`

`refunds`

`items`

`categories`

`discounts`

`taxes`

`modifier_lists`

`cash_drawers`

`orders`