Shopify

Por Que Shopify?

Shopify e a plataforma de e-commerce mais popular, usada por milhoes de lojas. Com a API, voce pode automatizar gestao de pedidos, sincronizar estoque, integrar com ERPs e muito mais.

Pedidos

Acompanhe e processe vendas automaticamente

Produtos

Crie e atualize catalogo via API

Clientes

Gerencie base de clientes e tags

Estoque

Sincronize inventario em tempo real

1

Criar Custom App

Apps privados para sua loja

Importante

Shopify descontinuou "Private Apps" em janeiro 2022. Use "Custom Apps" agora.

1. No admin da loja, va em Settings → Apps and sales channels
2. Clique em Develop apps (canto superior)
3. Se for a primeira vez, clique em Allow custom app development
4. Clique em Create an app
5. De um nome (ex: "N8N Integration")

2

Configurar Permissoes

Scopes da API Admin

1. Na aba Configuration, clique em Configure Admin API scopes
2. Selecione os scopes necessarios:

Scope	Permite
read_orders, write_orders	Ler e modificar pedidos
read_products, write_products	Ler e modificar produtos
read_customers, write_customers	Ler e modificar clientes
read_inventory, write_inventory	Gerenciar estoque
read_fulfillments, write_fulfillments	Envios e entregas

Dica: Selecione apenas os scopes que realmente precisa. Principio do menor privilegio.

3

Obter Access Token

Instalar app e copiar credenciais

1. Apos configurar scopes, clique em Save
2. Va na aba API credentials
3. Clique em Install app
4. Confirme a instalacao
5. Copie o Admin API access token (aparece apenas UMA vez!)

Atencao!

O Access Token so e mostrado UMA VEZ apos instalar. Se perder, tera que criar um novo app.

4

Configurar no N8N

Adicionar credencial Shopify

1. No N8N, va em Credentials → Add Credential
2. Busque por Shopify API
3. Preencha:

Shop Subdomain: sua-loja // De sua-loja.myshopify.com
Access Token: shpat_xxxxxxxxxxxxxxxxxxxx
API Version: 2024-01 // Use a versao mais recente

Pronto!

Clique em "Test Connection" para verificar. Deve retornar dados da loja.

Configurar Webhooks

Use webhooks para reagir a eventos em tempo real (novo pedido, atualizacao de estoque, etc).

No Shopify Admin

1. Va em Settings → Notifications
2. Role ate Webhooks
3. Clique em Create webhook
4. Selecione o evento e cole a URL do N8N Webhook

Evento	Dispara Quando
orders/create	Novo pedido criado
orders/paid	Pedido pago
orders/fulfilled	Pedido enviado/entregue
products/update	Produto atualizado
inventory_levels/update	Estoque alterado
customers/create	Novo cliente cadastrado

Exemplos Praticos

1. Notificar novo pedido no Slack

// Shopify Trigger: orders/create
// → Slack: Send Message

Channel: #vendas
Message: "Nova venda #{{ $json.order_number }}
Cliente: {{ $json.customer.first_name }} {{ $json.customer.last_name }}
Valor: R$ {{ $json.total_price }}
Produtos: {{ $json.line_items.length }} itens"

2. Sincronizar pedido com Airtable

// Shopify Trigger: orders/paid
// → Airtable: Create Record

Table: Pedidos
Fields:
{
  "Numero": "{{ $json.order_number }}",
  "Cliente": "{{ $json.customer.email }}",
  "Valor": {{ $json.total_price }},
  "Status": "Pago",
  "Data": "{{ $json.created_at }}"
}

3. Alerta de estoque baixo

// Schedule Trigger (1x por dia)
// → Shopify: Get Products
// → Filter: inventory_quantity < 10
// → Email: Send

To: estoque@empresa.com
Subject: "Alerta: {{ $json.length }} produtos com estoque baixo"
Body: "Produtos que precisam reposicao:
{{ $json.map(p => p.title + ': ' + p.variants[0].inventory_quantity).join('\n') }}"

4. Atualizar preco em massa

// Google Sheets Trigger: On row added
// → Shopify: Update Product

Product ID: {{ $json.product_id }}
Variants: [
  {
    "id": {{ $json.variant_id }},
    "price": "{{ $json.novo_preco }}"
  }
]

5. Fulfillment automatico

// HTTP Request: Recebe tracking da transportadora
// → Shopify: Create Fulfillment

Order ID: {{ $json.order_id }}
Tracking Number: {{ $json.tracking_code }}
Tracking Company: "Correios"
Notify Customer: true

Planos Shopify

Plano	Preco	API
Basic	R$ 150/mes	Full Admin API
Shopify	R$ 380/mes	Full Admin API + Relatorios
Advanced	R$ 1.500/mes	Full API + Calculos de frete avancados
Plus	~$2.000/mes	API ilimitada + Checkout customizavel

Limite de API: Todos os planos tem limite de 2 requests/segundo no bucket (40 creditos). Plano Plus tem limites maiores.

Rate Limits

Sistema de Bucket

40 creditos no bucket (limite maximo)
2 creditos/segundo de recuperacao
Cada request consome 1 credito
GraphQL requests podem consumir mais (baseado na query)

Dica: Use o header X-Shopify-Shop-Api-Call-Limit na resposta para monitorar uso do bucket.