API Reference: Plataforma Nacional

O modulo Nacional permite que o Super Admin gerencie recursos globais que atingem todos os nucleos. Possui Asaas separado (config propria), loja nacional, comunicados e enquetes globais. Base URL: /api/nacional. Todos os endpoints requerem cargo SUPER_ADMIN.

Config Nacional

Configuracao central da plataforma nacional. Possui API key Asaas separada dos nucleos, permitindo que a loja nacional processe pagamentos independentemente.

MetodoEndpointDescricao
GET/api/nacional/configObter configuracao nacional
PUT/api/nacional/configAtualizar configuracao (Asaas keys, etc)

Campos de config_nacional

  • asaas_api_key — API key Asaas separada da key de cada nucleo
  • asaas_wallet_id — Wallet ID Asaas nacional
  • config — JSONB com configuracoes gerais

Produtos Nacional

Loja nacional com CRUD completo de produtos. O checkout usa o Asaas nacional (nao o do nucleo). Qualquer membro de qualquer nucleo pode comprar produtos nacionais.

MetodoEndpointDescricao
GET/api/nacional/produtosListar produtos nacionais (publico para autenticados)
GET/api/nacional/produtos/:idDetalhe de um produto
POST/api/nacional/produtosCriar produto nacional
PUT/api/nacional/produtos/:idAtualizar produto
DELETE/api/nacional/produtos/:idRemover produto
POST/api/nacional/produtos/:id/checkoutCheckout de produto nacional (gera pagamento Asaas)

Tabelas envolvidas

  • produtos_nacional — Catalogo de produtos nacionais (sem nucleo_id)
  • produto_nacional_imagens — Galeria de imagens por produto
  • pedidos_nacional — Pedidos com asaas_payment_id proprio

Comunicados Nacional

Comunicados enviados pelo Super Admin para todos os nucleos. Aparecem no feed de todos os membros da plataforma, independente do nucleo.

MetodoEndpointDescricao
GET/api/nacional/comunicadosListar comunicados nacionais
POST/api/nacional/comunicadosCriar comunicado nacional
DELETE/api/nacional/comunicados/:idRemover comunicado

Enquetes Nacional

Enquetes/votacoes globais. Todos os membros da plataforma podem votar, independente do nucleo. Resultados agregados por nucleo nos relatorios.

MetodoEndpointDescricao
GET/api/nacional/enquetesListar enquetes nacionais
POST/api/nacional/enquetesCriar enquete nacional
POST/api/nacional/enquetes/:id/votarVotar em uma enquete
DELETE/api/nacional/enquetes/:idRemover enquete

Tabelas envolvidas

  • enquetes_nacional — Enquete principal (sem nucleo_id)
  • enquete_nacional_opcoes — Opcoes de voto
  • enquete_nacional_votos — Votos individuais (usuario_id unico por enquete)

Emails Nacional

Envio de emails para todos os membros da plataforma ou filtrados por nucleo/cargo. Usa o mesmo servico de email mas com escopo global.

MetodoEndpointDescricao
POST/api/nacional/emails/enviarEnviar email para todos ou filtro especifico

Resumo de Endpoints

#MetodoEndpointDescricao
1GET/api/nacional/configObter config
2PUT/api/nacional/configAtualizar config
3GET/api/nacional/produtosListar produtos
4GET/api/nacional/produtos/:idDetalhe produto
5POST/api/nacional/produtosCriar produto
6PUT/api/nacional/produtos/:idAtualizar produto
7DELETE/api/nacional/produtos/:idRemover produto
8POST/api/nacional/produtos/:id/checkoutCheckout produto
9GET/api/nacional/comunicadosListar comunicados
10POST/api/nacional/comunicadosCriar comunicado
11DELETE/api/nacional/comunicados/:idRemover comunicado
12GET/api/nacional/enquetesListar enquetes
13POST/api/nacional/enquetesCriar enquete
14POST/api/nacional/enquetes/:id/votarVotar enquete
15DELETE/api/nacional/enquetes/:idRemover enquete
16POST/api/nacional/emails/enviarEnviar email global