Guia de Início Rápido
Comece a usar o NumiSync Wizard em 5 minutos. Este guia apresenta o fluxo básico de trabalho para enriquecer sua coleção de moedas.
Nota sobre plataformas: Este guia funciona para Windows, macOS e Linux. Os atalhos de teclado são mostrados para todas as plataformas onde diferem.
Pré-requisitos
Antes de começar, certifique-se de ter:
- NumiSync Wizard instalado (Guia de Instalação)
- Coleção do OpenNumismat (arquivo .db com algumas moedas)
- Chave de API do Numista (gratuita em numista.com)
Passo 1: Iniciar e Configurar
Abrir o NumiSync Wizard
- Inicie o NumiSync Wizard:
- Windows: Menu Iniciar ou atalho na área de trabalho
- macOS: Pasta Aplicativos ou Launchpad
- Linux: Menu de aplicativos ou execute
numisync-wizard(se instalado via .deb/.rpm)
- A primeira inicialização criará um diretório de cache automaticamente
Adicionar sua Chave de API
- Clique em Settings (ícone de engrenagem) ou pressione:
- Windows/Linux:
Ctrl+, - macOS:
Cmd+,
- Windows/Linux:
- Vá para a aba API Settings
- Cole sua chave de API do Numista
- Clique em Save
Não tem uma chave de API? Obtenha uma gratuitamente em numista.com → Perfil → Acesso à API
Passo 2: Abrir sua Coleção
- Clique em File → Open Collection ou pressione:
- Windows/Linux:
Ctrl+O - macOS:
Cmd+O
- Windows/Linux:
- Navegue até seu arquivo
.dbdo OpenNumismat - Clique em Open
- Suas moedas serão carregadas na janela principal
Dica: O NumiSync lembra as coleções recentes. Use File → Recent Collections para acesso rápido.
Passo 3: Buscar Correspondências
Selecionar Moedas para Enriquecer
Você pode enriquecer moedas individualmente ou em lotes:
- Moeda única: Clique em uma linha de moeda para selecioná-la
- Múltiplas moedas: Segure a tecla modificadora e clique em várias linhas
- Windows/Linux:
Ctrl+Clique - macOS:
Cmd+Clique
- Windows/Linux:
- Intervalo: Clique na primeira moeda, segure
Shift, clique na última moeda - Todas as moedas: Selecionar todas
- Windows/Linux:
Ctrl+A - macOS:
Cmd+A
- Windows/Linux:
Iniciar a Busca
- Clique no botão Search & Enrich (ou pressione
F2) - O NumiSync buscará no Numista por cada moeda selecionada
- O indicador de progresso mostra o status atual
O que acontece:
- Busca por denominação, país, ano e marca de cunhagem
- Lida com variações (por exemplo, “Cent” vs “Cents”, “EUA” vs “United States”)
- Suporta calendários não gregorianos (anos Meiji, anos Hijri, etc.)
- Usa resultados em cache quando disponíveis (mais rápido!)
Passo 4: Revisar Correspondências
Entendendo os Resultados da Busca
Após a busca, cada moeda exibe um de três status:
- Match Found - Entrada do catálogo Numista encontrada
- Multiple Matches - Várias possibilidades (seleção manual necessária)
- No Match - Nenhuma entrada no catálogo encontrada (tente a busca manual)
Ver a Comparação de Campos
- Clique em uma moeda com correspondência
- O Field Comparison Panel mostra:
- Coluna esquerda: Seus dados existentes
- Coluna direita: Dados do catálogo Numista
- Diferenças destacadas em cor
- Revise o que será alterado
Passo 5: Aceitar ou Refinar Correspondências
Aceitar Todas as Alterações
Se a correspondência parecer correta:
- Clique no botão Accept Match (ou pressione
Enter) - Todos os dados do Numista atualizam sua moeda imediatamente
- A moeda é marcada como enriquecida
Selecionar Campos Individualmente
Para atualizar apenas campos específicos:
- No Field Comparison Panel, desmarque os campos que não deseja atualizar
- Clique em Accept Match
- Apenas os campos marcados serão atualizados
Escolher uma Emissão Diferente
Muitas moedas têm múltiplas emissões (anos, marcas de cunhagem, tipos):
- Clique no botão Choose Issue
- O Issue Picker Dialog mostra todas as variantes
- Selecione a emissão correta para sua moeda
- A comparação de campos se atualiza com os dados dessa emissão
- Clique em Accept Match
Busca Manual
Se nenhuma correspondência for encontrada automaticamente:
- Clique no botão Manual Search ou pressione:
- Windows/Linux:
Ctrl+F - macOS:
Cmd+F
- Windows/Linux:
- Modifique os parâmetros de busca (denominação, ano, país)
- Clique em Search
- Navegue pelos resultados e selecione a entrada correta
- Clique em Accept Match
Passo 6: Baixar Imagens (Opcional)
Download Automático de Imagens
Se Data Settings → Images estiver habilitado:
- As imagens são baixadas automaticamente quando você aceita uma correspondência
- Imagens do anverso, reverso e borda (se disponíveis)
- Armazenadas no diretório de imagens do OpenNumismat
Download Manual de Imagens
- Selecione uma moeda enriquecida
- Clique no botão Download Images
- Escolha quais imagens baixar (anverso, reverso, borda)
- Clique em Download
Dica: Use Image Comparison para visualizar antes de aceitar
Fluxos de Trabalho Comuns
Fluxo 1: Enriquecer uma Nova Coleção
- Abra a coleção com muitas moedas não enriquecidas
- Selecione todas as moedas (
Ctrl+A) - Clique em Search & Enrich (ou pressione
F2) - Revise as correspondências uma a uma
- Aceite as correspondências conforme avança
- Use a busca manual para moedas sem correspondência
Economia de tempo: 2-3 minutos por moeda → 10-15 segundos por moeda
Fluxo 2: Atualizar Apenas os Preços
- Vá para Settings → Data Settings
- Desmarque Basic e Issue (deixe Pricing marcado)
- Selecione as moedas a atualizar
- Clique em Search & Enrich
- Aceite as correspondências (apenas os preços são atualizados)
Dica Pro: Adquira uma Licença de Apoiador para usar o Fast Pricing Mode — atualiza todas as moedas identificadas instantaneamente!
Fluxo 3: Corrigir Correspondências Incorretas
- Selecione uma moeda com dados incorretos
- Clique em Manual Search
- Encontre a entrada correta no catálogo
- Aceite a correspondência
- Os dados antigos são sobrescritos
Dica: Use Field Comparison para verificar antes de aceitar
Dicas para Melhores Resultados
Dicas de Busca
Boas Práticas:
- Comece com moedas que têm informações completas (ano, país, denominação)
- Use abreviações de denominação padrão (“1 Cent” e não “1c”)
- Deixe o NumiSync normalizar as denominações automaticamente
Evite:
- Buscar moedas com campos essenciais faltando (país, denominação)
- Editar manualmente os parâmetros de busca sem necessidade
- Presumir que a primeira correspondência é a correta — sempre verifique!
Qualidade dos Dados
Boas Práticas:
- Revise a comparação de campos antes de aceitar
- Use o Issue Picker quando existirem múltiplas variantes
- Verifique se as imagens correspondem à sua moeda física
Evite:
- Aceitar todas as correspondências sem revisar
- Sobrescrever bons dados com dados incompletos do catálogo
- Esquecer de fazer backup da sua coleção primeiro!
Desempenho
Boas Práticas:
- Habilite o cache (Settings → General → Cache)
- Trabalhe em lotes de 10-20 moedas
- Use o Fast Pricing Mode para grandes atualizações (Licença de Apoiador)
Evite:
- Buscar mais de 1.000 moedas de uma vez (respeita os limites de taxa, mas é lento)
- Desabilitar o cache (desperdiça chamadas à API)
- Buscar a mesma moeda repetidamente (use o cache)
Atalhos de Teclado
Windows/Linux:
Ctrl+O- Abrir coleçãoF2- Search & Enrich nas moedas selecionadasCtrl+F- Busca manualEnter- Aceitar correspondênciaEscape- Cancelar/Fechar diálogoCtrl+A- Selecionar todas as moedasCtrl+,- Abrir configuraçõesF1- Abrir ajuda
macOS:
Cmd+O- Abrir coleçãoF2- Search & Enrich nas moedas selecionadasCmd+F- Busca manualEnter- Aceitar correspondênciaEscape- Cancelar/Fechar diálogoCmd+A- Selecionar todas as moedasCmd+,- Abrir configuraçõesF1- Abrir ajuda
Próximos Passos
Explorar Recursos Premium
Adquira uma Licença de Apoiador ($10) para desbloquear:
- Fast Pricing Mode - Atualize os preços de todas as moedas identificadas em lote
- Auto-Propagate - Aplique dados de tipo a moedas correspondentes automaticamente
- Sem avisos repetitivos!
Recursos Avançados
- Field Mapping - Personalize como os dados do Numista se mapeiam para seus campos
- Operações em Lote - Processe centenas de moedas de forma eficiente
- Suporte Multi-Computador - Compartilhe cache entre dispositivos
- Localização de Cache Personalizada - Armazene o cache em uma unidade de rede
Saiba Mais
- Manual do Usuário - Documentação completa de funcionalidades
- FAQ - Perguntas frequentes respondidas
- Tutoriais em Vídeo - Em breve!
Precisa de Ajuda?
Problemas Comuns
P: Por que minha moeda não foi identificada?
- R: O país ou a denominação pode precisar de normalização. Tente a busca manual com variações.
P: Por que alguns campos não estão sendo atualizados?
- R: Verifique as Data Settings — algumas categorias de dados podem estar desabilitadas.
P: Posso desfazer uma correspondência aceita?
- R: Não automaticamente. Restaure a partir de um backup ou reverta os dados manualmente.
P: Como atualizo apenas os preços sem alterar outros campos?
- R: Settings → Data Settings → Desmarque Basic e Issue, deixe Pricing marcado.
P: O que acontece se eu buscar a mesma moeda duas vezes?
- R: O NumiSync usa os resultados em cache (instantâneo), a menos que você clique em “Refresh from API”.
Obter Suporte
- Problemas: Reporte no GitHub
- Discussões: Pergunte à comunidade
- Documentação: Documentação completa