Sincronizar Encomendas do Squarespace com uma Folha de Cálculo Google Sheets - Fluxo de trabalho n8n

• Proprietários de lojas de e-commerce que usam Squarespace e necessitam de relatórios de dados centralizados.


• Analistas de dados que necessitam de dados de encomendas em tempo real sincronizados no Google Sheets.


• Utilizadores que procuram replicação de dados fiável e programada através de um fluxo de trabalho n8n robusto.


• Programadores ou especialistas em automação à procura de modelos práticos de n8n para paginação de APIs.

Gerir dados de e-commerce por entre diferentes plataformas pode ser um desafio. Este modelo de fluxo de trabalho n8n robusto resolve o problema das exportações manuais de dados ao estabelecer uma ligação direta e automatizada entre o Squarespace e o Google Sheets.

Utiliza a API do Squarespace para ir buscar as encomendas, gerindo requisitos complexos como a paginação dinâmica para garantir que todas as encomendas históricas e recentes são capturadas. Ao usar a funcionalidade 'append or update' (adicionar ou atualizar) do nó n8n do Google Sheets, a automação garante a integridade dos dados — atualiza as encomendas existentes (com correspondência pelo ID da Encomenda) e adiciona as novas. Este fluxo de trabalho n8n específico foi concebido para máxima eficiência, quer o execute manualmente através do gatilho n8n ou com uma cadência regular.

Esta automação segue um caminho preciso de recuperação e sincronização de dados:

1. Gatilho (Trigger): O fluxo de trabalho n8n é iniciado manualmente (ao clicar em 'Execute') ou automaticamente através do gatilho n8n programado.


2. Configuração (Globals): O nó n8n Globals define a versão da API e parâmetros críticos de filtragem, como modifiedAfter, modifiedBefore e maxPage (permitindo paginação infinita).


3. Consulta à API: O nó n8n Query Orders envia um pedido paginado para a API do Squarespace Commerce. Busca iterativamente páginas de encomendas, utilizando o cursor da resposta anterior até que todos os dados sejam recuperados.


4. Separação de Itens: O nó n8n Split Out Order pega no array consolidado de encomendas e separa-as, garantindo que cada encomenda individual se torna um item único para processamento subsequente.


5. Sincronização de Dados: Por fim, o nó n8n Squarespace Orders Spreadsheet conecta-se ao Google Sheets. Executa uma operação appendOrUpdate (adicionarOuAtualizar), usando o 'Order ID' como chave única para evitar duplicação, garantindo ao mesmo tempo que a folha de cálculo reflete sempre os detalhes mais recentes da encomenda, incluindo moradas de faturação/entrega e estado de processamento. Este fluxo de trabalho n8n altamente eficaz mantém os seus dados atualizados.

Para implementar este potente modelo de fluxo de trabalho n8n, siga estes passos:

1. Importar: Copie o JSON fornecido e importe-o para a sua instância n8n.


2. Configuração de Credenciais:

1. Configurar Globais: Abra o nó Set Globals do n8n. Ajuste os seguintes parâmetros de acordo com as suas necessidades:

1. Folha de Cálculo de Destino: No nó n8n Squarespace Orders Spreadsheet, selecione o ID do Documento do Google Sheet desejado e o Nome da Folha onde os dados da encomenda serão armazenados. Certifique-se de que os cabeçalhos das colunas na sua folha correspondem ao mapeamento definido neste nó n8n (ex: 'Order ID', 'Email', 'Total').


2. Ativação: Defina o fluxo de trabalho n8n como 'Active' (Ativo) para permitir execuções programadas através do gatilho n8n, ou execute-o manualmente para testes.

Ao clicar em 'execute' (gatilho n8n): Um gatilho n8n de execução manual usado para desenvolvimento e execuções pontuais (ad-hoc).
Schedule Trigger (Gatilho de Programação n8n): Permite que o fluxo de trabalho n8n seja executado automaticamente numa cadência definida (ex: diária ou horária).
Globals (nó Set n8n): Ponto de configuração centralizado. Injeta variáveis como api-version, filtros de data (modifiedAfter/modifiedBefore) e maxPage no fluxo de trabalho, controlando o comportamento do pedido HTTP subsequente.
Query Orders (nó HTTP Request n8n): O componente central de extração. Executa um pedido GET para o endpoint de Encomendas do Squarespace. Crucialmente, gere a paginação automática, iterando pelas páginas usando o nextPageCursor até que todos os dados correspondentes aos filtros definidos no nó Globals do n8n sejam obtidos.
Split Out Order (nó Split Out n8n): Prepara os dados para inserção em lote. Divide o array de encomendas (result) em itens n8n individuais, garantindo que cada linha é processada separadamente.
Squarespace Orders Spreadsheet (nó Google Sheets n8n): O nó de destino n8n. Configurado para executar appendOrUpdate (adicionarOuAtualizar) dados, usando expressões complexas para mapear campos JSON profundos (como componentes da morada de faturação e totais) do payload do Squarespace diretamente para as colunas correspondentes do Google Sheets, com correspondência pelo 'Order ID'.