Habilidades square-automation
💳

square-automation

Seguro

Automatizar Pagamentos e Pedidos do Square

Simplifique o processamento de pagamentos e gerenciamento de pedidos do Square sem chamadas manuais de API. Automatize faturamento, acompanhamento de pagamentos e gerenciamento de locais através do Claude Code.

Suporta: Claude Codex Code(CC)
📊 71 Adequado
1

Baixar o ZIP da skill

2

Upload no Claude

Vá em Configurações → Capacidades → Skills → Upload skill

3

Ative e comece a usar

Testar

A utilizar "square-automation". Listar todos os pagamentos de ontem

Resultado esperado:

Encontrados 23 pagamentos de 2024-01-15:
- Pagamento #1A2B3C: $145,00 (CONCLUÍDO)
- Pagamento #4D5E6F: $89,50 (CONCLUÍDO)
- Pagamento #7G8H9I: $210,00 (PENDENTE)

Total: $444,50

A utilizar "square-automation". Encontrar pedidos no local Downtown

Resultado esperado:

Recuperados 47 pedidos do local Downtown:
- Pedido #ORD-001: $350,00 (CONCLUÍDO)
- Pedido #ORD-002: $125,00 (ABERTO)
- Pedido #ORD-003: $75,00 (CONCLUÍDO)

ID do Local: L1234ABCD

A utilizar "square-automation". Mostrar todos os locais de negócios

Resultado esperado:

3 locais encontrados:
1. Downtown Store (L1234ABCD) - ATIVO
2. Uptown Branch (L5678EFGH) - ATIVO
3. Warehouse (L9012IJKL) - INATIVO

Auditoria de Segurança

Seguro
v1 • 2/25/2026

All static findings are false positives. The detected 'external_commands' patterns (57 instances) are Ruby/shell backtick syntax examples in markdown documentation, not executable code. The network detection is a documentation URL (https://rube.app/mcp) showing where to obtain the Rube MCP server. This skill is legitimate documentation for automating Square payment tasks with no executable code or security risks.

1
Arquivos analisados
182
Linhas analisadas
0
achados
1
Total de auditorias
Nenhum problema de segurança encontrado
Auditado por: claude

Pontuação de qualidade

38
Arquitetura
100
Manutenibilidade
87
Conteúdo
30
Comunidade
100
Segurança
91
Conformidade com especificações

O Que Você Pode Construir

Conciliação de Pagamentos

Proprietários de negócios podem listar e analisar automaticamente pagamentos diários em todos os locais do Square para conciliar contas e identificar discrepâncias.

Acompanhamento de Status de Pedidos

Equipes de suporte podem pesquisar e recuperar detalhes do pedido por nome do cliente ou data para fornecer atualizações de status de pedidos em tempo real sem acessar o painel do Square.

Automação de Fluxo de Faturamento

Equipes financeiras podem listar faturas agendadas e não pagas, cancelar faturas inválidas e exportar dados de faturas para sistemas contábeis.

Tente Estes Prompts

Listar Pagamentos Recentes 
Listar todos os pagamentos do Square dos últimos 7 dias. Mostrar IDs de pagamentos, valores e status.
Encontrar Pedidos por Data 
Pesquisar todos os pedidos concluídos no local 'Main Street' entre 1 de janeiro e 31 de janeiro. Mostrar IDs de pedidos e valores totais.
Cancelar Fatura Pendente 
Encontrar a fatura não paga do cliente 'John Doe' enviada neste mês e cancelá-la usando o número de versão correto.
Relatório de Pagamentos Multi-Locais 
Recuperar pagamentos dos três locais para o Q1 de 2024. Agrupar por local e calcular totais. Tratar paginação automaticamente.

Melhores Práticas

  • Sempre chame RUBE_SEARCH_TOOLS primeiro para obter os esquemas de ferramentas atuais antes de executar fluxos de trabalho
  • Cache IDs de local após a recuperação inicial para evitar chamadas de API redundantes
  • Use o formato de timestamp RFC 3339 para todos os filtros de intervalo de datas (ex: 2024-01-01T00:00:00Z)
  • Trate a paginação seguindo os valores do cursor até que estejam ausentes para grandes conjuntos de resultados

Evitar

  • Não tente cancelar pagamentos concluídos - use fluxos de trabalho de reembolso em vez disso
  • Evite chamar UPDATE_ORDER sem primeiro recuperar o número da versão atual
  • Nunca codifique IDs de local - sempre resolva-os dinamicamente via LIST_LOCATIONS
  • Não pule o tratamento de paginação - grandes conjuntos de dados retornarão resultados incompletos

Perguntas Frequentes

Preciso de uma chave de API do Square?
Não. Esta skill usa Rube MCP que trata a autenticação OAuth do Square. Basta adicionar https://rube.app/mcp como seu servidor MCP e completar o fluxo OAuth.
Posso processar novos pagamentos através desta skill?
Não. Esta skill pode listar, cancelar e monitorar pagamentos existentes, mas não pode criar novas transações de pagamento. Use os fluxos de checkout do Square para novos pagamentos.
Por que recebo erros de 'incompatibilidade de versão' ao atualizar pedidos?
UPDATE_ORDER requer o campo de versão. Sempre recupere o pedido primeiro com SQUARE_RETRIEVE_ORDER para obter o número da versão mais recente antes de atualizar.
Como encontro meus IDs de local?
Chame SQUARE_LIST_LOCATIONS para recuperar todos os locais. Cada local tem um campo 'id' (ex: 'L1234ABCD') que você usa para filtrar pedidos e pagamentos.
Posso cancelar pagamentos concluídos?
Não. Apenas pagamentos pendentes podem ser cancelados. Para pagamentos concluídos que precisam ser revertidos, use o processo de reembolso do Square em vez disso.
O que acontece quando tenho mais de 100 resultados?
O Square pagina os resultados. Verifique o campo 'cursor' da resposta e passe-o para a próxima requisição. Continue até que o cursor esteja ausente para obter todos os resultados.

Detalhes do Desenvolvedor

Autor

sickn33

Licença

MIT

Repositório

https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/square-automation

Referência

main

Estrutura de arquivos

📄 SKILL.md