Configurações
As telas de Configurações definem como o MIDDAG Account se comporta. As configurações são organizadas em abas, cada uma cobrindo uma área específica do sistema. Apenas administradores WordPress com permissões completas do MIDDAG Account podem acessar a página de Configurações.
Navegue até MIDDAG Account > Configurações para abrir o painel de configurações.
Configurações gerais
A aba padrão ao abrir Configurações.
| Configuração | O que controla |
|---|---|
| Modo do Plugin | Produção ou Desenvolvimento. O modo Desenvolvimento habilita log de debug e desabilita cron jobs. |
| Moeda Padrão | A moeda padrão para novos orçamentos e faturas (BRL ou USD) |
| Idioma Padrão | Idioma da interface admin |
| Formato de Data | Como as datas são exibidas em todo o admin (Y-m-d, d/m/Y, etc.) |
| Itens por Página | Tamanho padrão de paginação para visualizações de lista (25, 50 ou 100) |
| Migração Completa | Toggle que alterna repositórios de CCT (JetEngine) para wp_posts. Não habilite a menos que a migração de dados tenha sido verificada. |
Configuração de entidades
Configure a estrutura de dupla entidade.
| Configuração | O que controla |
|---|---|
| Nome MIDDAG BR | Nome de exibição da entidade brasileira |
| CNPJ MIDDAG BR | CNPJ da entidade brasileira |
| Endereço MIDDAG BR | Endereço registrado |
| Nome MIDDAG GLOBAL | Nome de exibição da entidade internacional (LLC) |
| EIN MIDDAG GLOBAL | EIN da entidade americana |
| Endereço MIDDAG GLOBAL | Endereço registrado |
| Entidade de Cobrança Padrão | Qual entidade é pré-selecionada ao criar novos registros |
Estes valores aparecem em faturas, contratos e outros documentos voltados ao cliente.
Entitlement Classes
Gerencie as definições de Entitlement Class que determinam quais recursos downstream são provisionados quando um entitlement é criado.
Lista de classes
Uma tabela exibindo todas as classes configuradas:
| Coluna | O que exibe |
|---|---|
| Prefixo | O código de 3 letras usado nos códigos de entitlement (PLG, ENV, SVC, ORD, AFL, EDU) |
| Nome | Nome legível da classe |
| Descrição | O que esta classe provisiona |
| Downstream | Recursos criados quando um entitlement desta classe é provisionado |
| Status | Ativa ou Desabilitada |
Editando uma classe
Clique em qualquer classe para editar sua configuração:
- Prefixo -- somente leitura após criação (alterar quebraria códigos de entitlement existentes)
- Nome e Descrição -- valores de exibição
- Provisionamento downstream -- quais recursos criar automaticamente (Licença, Ambiente, Serviço, etc.)
- Período padrão -- duração padrão do entitlement (ex.: 12 meses)
- Status -- Ativa ou Desabilitada (classes desabilitadas não podem ser usadas para novos entitlements)
Criando uma nova classe
Clique em + Criar Classe para definir uma nova Entitlement Class. Você deve especificar o prefixo (3 letras maiúsculas), nome, descrição e regras de provisionamento downstream.
Padrões de políticas
Configure os valores padrão de políticas que se aplicam a todos os entitlements, a menos que sejam sobrescritos no nível da organização ou do entitlement individual. As políticas seguem uma hierarquia de 5 níveis: Sistema > Entidade de Cobrança > Entitlement Class > Organização > Individual.
| Configuração | O que controla |
|---|---|
| Período de Carência (dias) | Dias após expiração antes do cancelamento |
| Renovação Automática | Se os entitlements renovam automaticamente |
| Lembrete de Renovação (dias) | Quantos dias antes da expiração enviar lembretes de renovação |
| Suspensão por Inadimplência | Se deve suspender automaticamente por falta de pagamento |
| Transferência de Créditos | Se créditos não utilizados transitam para o próximo período |
| Janela de Recuperação (dias) | Dias após cancelamento durante os quais a reativação é permitida |
Cada política exibe seu valor atual e o nível no qual está definida. Os padrões em nível de Sistema são configurados aqui; valores de sobrescrita em níveis inferiores são gerenciados nas páginas de detalhes da Organização ou do Entitlement correspondente.
Para uma explicação completa da hierarquia de políticas, consulte Políticas.
Credenciais de integração
Configure chaves de API e credenciais para serviços externos. Cada integração possui sua própria seção.
HubSpot
| Campo | O que inserir |
|---|---|
| Portal ID BR | ID do portal HubSpot para MIDDAG BR |
| Chave de API BR | Token de acesso do app privado para portal BR |
| Portal ID GLOBAL | ID do portal HubSpot para MIDDAG GLOBAL |
| Chave de API GLOBAL | Token de acesso do app privado para portal GLOBAL |
| Segredo do Webhook (BR) | Segredo para validar assinaturas de webhook BR |
| Segredo do Webhook (GLOBAL) | Segredo para validar assinaturas de webhook GLOBAL |
Stripe
| Campo | O que inserir |
|---|---|
| Chave Secreta BR | Chave secreta Stripe para conta MIDDAG BR |
| Chave Publicável BR | Chave publicável Stripe para conta BR |
| Segredo do Webhook BR | Segredo de assinatura do endpoint para webhooks BR |
| Chave Secreta GLOBAL | Chave secreta Stripe para conta MIDDAG GLOBAL |
| Chave Publicável GLOBAL | Chave publicável Stripe para conta GLOBAL |
| Segredo do Webhook GLOBAL | Segredo de assinatura do endpoint para webhooks GLOBAL |
ISSNet (NFSe)
| Campo | O que inserir |
|---|---|
| CNPJ | CNPJ da MIDDAG BR para emissão de NFSe |
| Código Municipal | Código de inscrição municipal |
| Caminho do Certificado | Caminho para o arquivo de certificado digital (.pfx) |
| Senha do Certificado | Senha do certificado digital |
Jira
| Campo | O que inserir |
|---|---|
| URL Base | URL da instância Jira |
| E-mail da API | E-mail da conta de serviço |
| Token da API | Token de API do Jira |
| Chave do Projeto | Chave do projeto padrão para novos tickets |
Cloudflare
| Campo | O que inserir |
|---|---|
| Token da API | Token de API do Cloudflare |
| Account ID | Identificador da conta Cloudflare |
| ID do Banco D1 | Identificador do banco de dados D1 |
| Bucket R2 | Nome do bucket de armazenamento R2 |
As credenciais são armazenadas como opções do WordPress e nunca são expostas em respostas da API. A página de Configurações mascara valores sensíveis (exibindo apenas os últimos 4 caracteres) após serem salvos.
Configurações da API
Configure a API REST e a autenticação JWT.
| Configuração | O que controla |
|---|---|
| Algoritmo JWT | RS256 (somente leitura -- HS256 não é permitido) |
| Caminho da Chave Privada JWT | Caminho para o arquivo de chave privada RSA (deve estar fora do webroot) |
| Caminho da Chave Pública JWT | Caminho para o arquivo de chave pública RSA |
| Tempo de Vida do Token JWT | Expiração do token em segundos (padrão: 3600) |
| Limite de Taxa da API | Máximo de requisições por minuto por cliente |
| Origens CORS Permitidas | Lista separada por vírgulas de origens permitidas para o portal App |
Importação / Exportação
Ferramentas para operações em lote de dados.
Importação
- Importar Organizações -- envie um CSV para criar ou atualizar organizações em lote. O CSV deve incluir colunas para nome, razão social, CNPJ/EIN, país e e-mail. CPF/CNPJs duplicados são detectados e reportados.
- Importar Entitlements -- envie um CSV para criar entitlements em lote. Requer ID da organização, classe, nome do produto, data de início e data de expiração.
Exportação
- Exportar Organizações -- baixar todas as organizações como CSV
- Exportar Entitlements -- baixar todos os entitlements como CSV
- Exportar Faturas -- baixar todas as faturas como CSV
- Exportar Backup Completo -- baixar uma exportação JSON de todos os dados do MIDDAG Account (organizações, entitlements, orçamentos, faturas, contratos, ambientes, serviços e solicitações de serviço)
A exportação de backup completo é útil para recuperação de desastres e para migração de dados entre ambientes.
Páginas relacionadas
- Integrações -- status ao vivo dos serviços conectados
- Entitlements -- comportamento das Entitlement Classes na prática
- Organizações -- atribuição de entidade de cobrança por cliente
- Políticas -- a hierarquia de 5 níveis de políticas explicada
- Entitlement Classes -- definições de classes e provisionamento downstream