Infodata

Resumo

Agregador de dados brasileiros e técnicos em uma única API, com cache inteligente, fallback multi-provedor, auditoria e rate-limit por usuário. Consultas de CEP, CNPJ, CPF, DDD, FIPE, IBGE, NCM, placa de veículo, feriados, bancos, chaves PIX, corretoras, domínios, IP, câmbio, cotações, ISBN, clima e mais. Widgets embedáveis de CEP e CNPJ para o seu site. Histórico completo de cada consulta com origem e status.

Para quem é

• E-commerces e marketplaces que precisam autocompletar cadastro (CEP, CNPJ, CPF).
• ERPs e backoffice que validam dados fiscais (CNPJ, NCM, chaves PIX).
• Aplicativos e sites que querem embedar consulta de CEP ou CNPJ sem backend próprio.
• Integradores e agências que revendem a camada de dados ao cliente final.

O que você pode fazer

Dados Cadastrais Brasileiros

• Aba cep — endereço por CEP.
• Aba cnpj — situação cadastral, CNAE, sócios.
• Aba cpf — validação de dígito + consulta.
• Aba ddd — localidades por DDD.

Veículos, Fiscal e Financeiro

• Aba fipe — tabela FIPE de veículos.
• Aba placa — dados técnicos a partir da placa.
• Aba ncm — classificação fiscal e alíquotas.
• Aba pix — validação de chaves PIX (CPF, CNPJ, e-mail, telefone, aleatória).
• Aba banks — instituições financeiras.
• Aba brokers — corretoras e investimentos.

Geografia, Calendário e Referências

• Aba ibge — municípios, estados, demografia.
• Aba holidays — feriados nacionais e municipais.
• Aba weather — clima por cidade/coordenada.
• Aba isbn — livros por ISBN.

Internacional e Técnico

• Aba domains — WHOIS e verificação.
• Aba ip — geolocalização e reputação.
• Aba exchange / rates — câmbio e cotações.
• Aba sol — consulta complementar.

Widgets Embedáveis

• cep-widget.php e cnpj-widget.php: snippets HTML/JS que rodam no site do cliente sem backend próprio.

Auditoria e Cotas

• QueryLogRepository: histórico com timestamp, origem (API/UI/widget) e status.
• Cotas configuráveis por usuário e tenant.

Como começar

1. Ative o plugin Infodata no painel admin.
2. Configure provedores e fallback em providers.
3. Defina cotas e rate-limit por usuário em settings.
4. Teste consultas direto em overview ou via API.
5. Copie o snippet de widget em widgets e cole no seu site.
6. Acompanhe uso e custo em usage e logs.

Tutoriais

• Integrar consulta de CEP no checkout do e-commerce — widget embedável.
• Validar CNPJ no cadastro de fornecedor — aba cnpj + webhooks.
• Consultar placa de veículo para seguradora — aba placa.
• Validar chaves PIX antes de pagar — aba pix.
• Monitorar cotas e auditar consultas — usage + logs.

Integrações com outros plugins

• iGaming — validação de CPF/PIX na abertura de conta.
• Marketplace / Business — autocompletar cadastro de loja e fornecedor.
• Directory — enriquecer perfil de empresas por CNPJ.
• Jobs — validar dados do candidato e empresa.
• BillingPortal — validação de chave PIX para recebimento.

Perguntas frequentes

Posso embarcar a consulta direto no meu site? Sim. Os widgets de CEP e CNPJ funcionam via snippet HTML/JS — ideais para formulários de cadastro e checkout.

Existe limite ou log de consultas? Sim. Cada consulta é registrada com timestamp, origem (API/UI/widget) e status. Cotas podem ser configuradas por usuário ou tenant.

Quais consultas estão disponíveis? CEP, CNPJ, CPF, DDD, FIPE, placa, NCM, PIX, bancos, corretoras, IBGE, feriados, clima, ISBN, domínios, IP, câmbio e cotações.

Como funciona o fallback multi-provedor? Cada consulta tenta o provedor principal e, em caso de erro ou indisponibilidade, cai automaticamente para o secundário. Tudo configurável em providers.

Há cache? Sim. Cache com TTL por tipo de consulta para reduzir chamadas externas e latência.

É possível consultar NFe ou frete real? Não no momento. NFe via SEFAZ e cálculo real de frete (Correios + transportadoras) estão no roadmap.

O histórico é isolado por tenant? Sim, isolamento completo multi-tenant em todas as consultas e logs.

Glossário

• NCM — Nomenclatura Comum do Mercosul, classificação fiscal.
• FIPE — Fundação Instituto de Pesquisas Econômicas, tabela de veículos.
• WHOIS — protocolo de consulta de registros de domínio.
• Fallback — provedor alternativo acionado em caso de falha.

Limitações e avisos

• Consulta de NFe real e cálculo de frete via Correios estão no roadmap.
• Consulta de CNH, score de crédito e antecedentes requerem provedores comerciais específicos ainda não integrados.
• Dados retornados dependem da disponibilidade dos provedores externos.

Relacionados

• Marketplace
• Directory
• Jobs