Integração de dados de entes federativos com a Plataforma CultBR

Q: O que é o Conecta Ente e como funciona a integração?

O Conecta Ente é a camada de integração que permite a estados, municípios e ao DF enviarem dados de seus sistemas de gestão cultural à Plataforma CultBR por meio de APIs RESTful em JSON, sem digitação manual ou envio de planilhas.

Q: Onde encontro a documentação da API e o Swagger?

Toda a documentação técnica está centralizada no Swagger / OpenAPI, com o detalhamento dos endpoints, os métodos suportados (GET, POST, PUT), os esquemas de dados exigidos pelo padrão SNIIC e exemplos de requisições e respostas, em https://ente.conecta.hmg.cultbr.cultura.gov.br/api/v1/docs

Q: Quais tipos de Tokens eu posso usar na integração?

O Service Account Token (integração M2M) é o token indicado para comunicação entre o sistema do ente e o CultBR. É vinculado ao CNPJ do órgão (e não a uma pessoa física) e destinado à comunicação máquina-a-máquina.

Q: Como faço para conseguir o Token de Integração (Service Account)?

Por segurança, o Token de Integração (M2M) deve ser emitido exclusivamente por um administrador do Ente Federativo (por exemplo, usuário com perfil Gestor Recebedor FaF Nível 1) diretamente pelo Módulo Rede do CultBR.

Q: Quem pode acessar o ambiente de Homologação (HMG) para testes?

O acesso ao ambiente HMG é controlado: somente usuários cadastrados por um Gestor com perfil FaF Nível 1, ou o próprio titular do perfil FaF Nível 1, podem acessar a homologação e realizar os testes da integração do Conecta Ente.

Q: Como funciona o isolamento de dados do ente na API?

A plataforma utiliza arquitetura de multitenancy. Cada token é vinculado ao tenant_id (CNPJ do ente), isolando logicamente os dados de cada ente na mesma API nacional.

Q: É obrigatório integrar via API (Conecta Ente)?

Não. A integração via API é indicada para entes com sistema próprio de gestão de editais. Sem equipe de tecnologia, os dados podem ser registrados pelo CultEditais ou diretamente na Plataforma CultBR.

Especificação e documentação da API Conecta Ente para envio de dados da Política Nacional Aldir Blanc de Fomento à Cultura (PNAB) ao Ministério da Cultura, conforme o padrão de dados do SNIIC.

Acessar sandbox (HMG) Passo a passo de integração

API REST

Requisições em JSON (HTTPS)

Padrão SNIIC

Esquema de dados da PNAB

Ambiente HMG

Testes antes da produção

Interoperabilidade

Conecta Ente no ecossistema Conecta CultBR

O Conecta CultBR reúne APIs e especificações para troca de dados entre atores da cultura. O Conecta Ente é o módulo destinado a estados, municípios e ao Distrito Federal.

Conecta MinC

Barramento interno que integra os sistemas do próprio Ministério da Cultura.

Página atual

Conecta Ente

API e especificação técnica para estados, municípios e DF integrarem seus sistemas locais à Plataforma CultBR.

Conecta Povo

API pública de consumo para a sociedade civil, pessoas desenvolvedoras e pesquisadoras.

O que é o Conecta Ente?

O Conecta Ente define a API para que estados e municípios com sistemas próprios, como Mapas Culturais, Prosas ou soluções customizadas, enviem dados de execução da Política Nacional Aldir Blanc de Fomento à Cultura (PNAB) à base nacional do Ministério da Cultura, operada pela Plataforma CultBR.

Envio de dados via API

Validação conforme padrão SNIIC

Autenticação por token (M2M)

Publicação de dados para transparência

Arquitetura de Conectores CultBR Esquema Operacional

Ente Federativo

Município / Estado (Sistema Local)

Origem

Conecta Ente API (HTTPS)

Conecta CultBR camada de interoperabilidade

Recebe os dados do ente, valida o padrão SNIIC e encaminha à base nacional CultBR.

Validação padrão SNIIC

Base nacional CultBR

Passo a passo para integração

Procedimento para equipes de TI e gestores culturais habilitarem o envio de dados pelo Conecta Ente.

Acesse a Rede CultBR

Acesse a Rede CultBR e autentique-se com Gov.br. O usuário deve estar vinculado ao ente no CultBR ou no TransfereGov (perfil FAF Nível 1).

Selecione o Ente

Após o login, escolha o ente federativo (estado ou município) que você deseja integrar.

Gere a chave de integração

No menu lateral, abra Integrações e clique em Gerar chave de integração.

Configure a integração

Adapte o sistema do ente ao padrão de dados do SNIIC e utilize a API do Conecta Ente com a chave gerada.

Ambiente de homologação

Sandbox da API Conecta Ente

Ferramenta para testar requisições no ambiente de homologação (HMG): edite o JSON, envie a requisição e verifique a resposta conforme o padrão SNIIC.

Ambiente de Homologação Documentação e endpoints da API Conecta Ente para o ente testar a integração

edital_oportunidade.json

POST /api/v1/integracao/oportunidades

Console de Depuração (Live Logs) READY

// Aguardando requisição...

// Selecione um modelo à esquerda ou modifique o JSON e clique em "Enviar Requisição".

Dicionários de Dados da API

O SNIIC (Sistema Nacional de Informações e Indicadores Culturais) padroniza dados do setor cultural. O CultBR adota o Padrão de Dados para a Política Nacional Aldir Blanc definido pelo SNIIC.

Consultar o Padrão de Dados do SNIIC (Ciclo 2)

Importante: os campos descritos abaixo representam o conjunto mínimo de dados exigido pelo padrão do SNIIC, e não a totalidade da oportunidade. Cada ente pode (e deve) transmitir campos adicionais conforme as regras do seu edital e da Política Nacional Aldir Blanc.

Dicionário de Dados

Oportunidades por Tipo, modelos para download

Modelos oficiais de oportunidade do Mapas Culturais, organizados por tipo. Cada arquivo (.txt) traz o conjunto mínimo de dados exigido, não a totalidade da oportunidade.

Perguntas Frequentes

Respostas sobre integração técnica e operacional do Conecta Ente.

O que é o Conecta Ente e como funciona a integração?

Onde encontro a documentação da API e o Swagger?

Quais tipos de Tokens eu posso usar na integração?

Como faço para conseguir o Token de Integração (Service Account)?

Quem pode acessar o ambiente de Homologação (HMG) para testes?

Como funciona o isolamento de dados do ente na API?

É obrigatório integrar via API (Conecta Ente)?

Atendimento

Suporte técnico do Conecta Ente

Dúvidas sobre integração ou uso da API? Utilize o chat ou os canais listados ao lado.

Canais de atendimento

E-mail

pnab@cultura.gov.br

Horário de atendimento

Dias úteis, horário comercial (BRT)

Chat ao vivo

Botão "Abrir chat de suporte" ou ícone no canto da tela