Integration Guide

    Integração do NPLAN ao seu ecossistema de TI

    O NPLAN se conecta aos sistemas e fontes de dados que sua empresa já utiliza. Nossa camada de integração cuida da extração, transformação, validação e monitoramento das informações necessárias ao planejamento, reduzindo o esforço de desenvolvimento e manutenção para a área de TI.

    Interface de dados

    O NPLAN se conecta a fontes internas e externas de dados e assume o trabalho de extrair, limpar, transformar, validar e monitorar as informações. A TI disponibiliza os dados como eles já existem: a preparação para o planejamento acontece na camada de integração.

    DADOS INTERNOS

    DADOS EXTERNOS

    EXTRACT

    ORQUESTRAÇÃO DE DADOS

    NPLAN
    IT-friendly by design

    Sua TI disponibiliza os dados. A complexidade da integração fica com o NPLAN.

    Se sua empresa já possui APIs, Data Lake, middleware ou banco de dados acessível, o NPLAN pode consumir diretamente essas fontes. A partir daí, a Integration Layer assume conexão, mapeamento, transformação, validação, monitoramento e reprocessamento.

    Integração tradicional
    Com o NPLAN
    Preparar e transformar os dados no layout exigido pela solução
    Disponibilizar os dados na estrutura já existente
    Desenvolver e manter os fluxos de integração
    A Integration Layer conecta e mantém os fluxos
    Orquestrar jobs, sequências e dependências entre cargas
    O NPLAN gerencia a orquestração e as dependências
    Tratar autenticação, paginação, rate limits e particularidades das APIs
    A camada de integração absorve as particularidades de cada fonte
    Implementar transformações, validações e tratamento de erros
    O NPLAN transforma, valida e monitora os dados
    Criar mecanismos de retry e reprocessamento em caso de falha
    O NPLAN gerencia falhas, logs e reprocessamentos
    Ajustar frequência e janelas de atualização sempre que o processo muda
    Frequências e execuções são configuradas e administradas pela integração
    Acionar TI novamente para mudanças no processo de planejamento
    Quando os dados já existem na origem, muitas evoluções podem ser absorvidas pela própria camada de integração
    Sustentar internamente os processos de integração
    A sustentação da integração fica concentrada no NPLAN

    SUA TI

    ERP · Data Lake · Middleware

    DISPONIBILIZAÇÃO

    Endpoints + Credenciais

    NPLAN

    Integration Layer

    Não é necessário desenvolver uma integração específica para enviar dados ao NPLAN quando as informações necessárias já estão disponíveis através da arquitetura de integração do cliente. O esforço da TI se concentra em liberar o acesso, não em construir e sustentar pipelines.

    Opções de integração

    O NPLAN se adapta ao método de troca de dados mais simples para o ambiente do cliente, e diferentes métodos podem ser combinados no mesmo projeto.

    API / Webservices

    Consumo de APIs e serviços disponibilizados pelo ambiente do cliente, com suporte a diferentes métodos de autenticação.

    Conexão de banco de dados

    Conexão direta aos principais bancos relacionais e outras fontes estruturadas de dados.

    Arquivos e upload manual

    Integração através de CSV, TXT, XLS e XLSX, por processos automatizados ou upload manual quando aplicável.

    Camada de integração on-premise

    Camada instalada no ambiente do cliente quando requisitos de arquitetura ou segurança exigirem processamento local.

    Capacidades de integração

    Uma camada de integração preparada para operar de forma segura, automatizada e escalável em ambientes corporativos.

    Múltiplos métodos de autenticação

    Compatível com diferentes padrões de autenticação adotados pela área de TI do cliente.

    Cargas full e incrementais

    Carga completa para construção da base e cargas incrementais para atualizações recorrentes com menor volume.

    Execução agendada e sob demanda

    Jobs e workflows podem ser executados por agenda ou sob demanda.

    Logs e rastreabilidade

    Registro detalhado das execuções, com visibilidade de volumes, tempos e falhas.

    Grandes volumes de dados

    Processamento e divisão de cargas preparados para grandes volumes de dados.

    Segurança e criptografia

    Proteção dos dados em trânsito e em repouso alinhada às políticas de segurança do NPLAN.

    O que pode ser integrado?

    Explore os objetos e campos de integração utilizados por cada módulo do NPLAN.

    Os objetos abaixo representam estruturas típicas de integração. O escopo final depende dos módulos contratados e da arquitetura de dados existente no cliente.

    Módulos

    Prioridade

    Busca

    1 objeto · 4 campos

    O mapeamento final de tabelas, campos, nomenclaturas e fontes é validado durante o onboarding. Os dados não precisam existir no mesmo formato apresentado aqui: a Integration Layer do NPLAN realiza o mapeamento e as transformações necessárias entre a estrutura do cliente e o modelo NPLAN.

    Segurança, infraestrutura e proteção de dados

    Criptografia, hospedagem, controle de acesso, rastreabilidade e conformidade estão detalhados na página de Segurança do NPLAN.

    Esta página é agent-ready

    Agente compatível não detectado neste navegador

    O que é

    Esta página não expõe só o texto do contrato de integração: expõe o próprio contrato como um conjunto de ferramentas que um agente pode consultar. Um assistente com suporte a MCP lê, filtra e explica qualquer objeto ou campo direto daqui, sem copiar a tela nem pedir print. As respostas saem do mesmo contrato que você está lendo, então não há versão paralela para ficar desatualizada.

    Ferramentas disponíveis

    Todas são somente leitura. Nenhuma envia dados, preenche formulário, altera cadastro ou dispara requisição para o NPLAN. A única que muda algo muda apenas o que você está vendo: os filtros desta página.

    • list_modules — Lista os módulos de planejamento e quantos objetos cada um exige.
    • list_objects — Lista os objetos de um recorte, com endpoint, chave natural e contagem de campos.
    • get_object — Abre um objeto inteiro: metadados, propósito, impacto da ausência e todos os campos.
    • search_fields — Procura um campo em todos os objetos quando não se sabe onde ele entra.
    • explain_field — Explica um campo: significado, formato, valores aceitos e por que o planejamento usa.
    • get_integration_scope — Consolida o escopo: quantos objetos, quantos campos obrigatórios e com que cadência.
    • apply_page_filters — Move esta página para o recorte de que se está falando, na sua frente.

    Como usar

    Abra esta página no Claude in Chrome ou em outro cliente MCP que rode no navegador. As ferramentas aparecem sozinhas enquanto a página estiver aberta — não há instalação, chave nem cadastro.

    Sem um cliente compatível, o mesmo conteúdo está disponível em texto puro:

    /llms.txt/llms-full.txt

    Prompts de exemplo

    Discuta a arquitetura de integração com o NPLAN

    Nosso time técnico avalia as fontes de dados e a arquitetura existente para definir a abordagem de integração mais simples e adequada ao seu ambiente.