Aba Integrações — WhatsApp
Diretivas Comerciais
Fica entre Diretivas de uso de IA e Alertas, para quem tem Configurações — Visualizar. A aba só aparece quando a integração está liberada para a empresa. A conta de WhatsApp fica no nome da empresa. A Meta cobra as mensagens no cartão cadastrado lá. O Estoqfy não gera fatura deste uso e não recebe esse pagamento.
Para a Meta liberar o envio:
- Tenha um portfólio comercial na Meta com o CNPJ da empresa, em business.facebook.com.
- Separe um número de celular da empresa. Se ele já está no aplicativo WhatsApp Business, a Meta pede a coexistência com a API. Um número novo dispensa essa etapa.
- Nesta aba, clique em Conectar com a Meta e entre com o usuário do portfólio da empresa. Escolha a conta que já tem o número e conclua até o telefone aparecer. A autorização vale para o Estoqfy enviar e receber em nome da empresa. A conta e o pagamento continuam da empresa. O número que já está no aplicativo WhatsApp Business usa Conectar WhatsApp Business: o celular confirma, o aplicativo continua instalado, e esse caminho espera o acesso avançado da Meta. O WhatsApp pessoal não entra por esses botões. Se os botões não aparecerem, use Vincular número com o WABA ID, o Phone Number ID e o token temporário do API Setup. O token fica cifrado no servidor e não volta para a tela. Desconectar deste Estoqfy tira só a ligação local: a conta na Meta permanece. Atualizar situação relê na Meta se o número está registrado e se o envio está liberado. Se o número pedir registro, informe o PIN de 6 dígitos da verificação em duas etapas.
- No Gerenciador de Negócios da Meta, em WhatsApp, na área de cobrança, adicione a forma de pagamento da empresa. Sem esse cartão, a Meta conclui o cadastro e não entrega mensagem.
- Na primeira conexão, o Estoqfy cria o modelo de lembrete nesta conta. A Meta pode levar 1 ou 2 dias para aprovar. Enquanto espera, o envio manual e a régua não disparam. Fora das 24 horas em que o cliente falou com a empresa, a Meta só entrega modelo aprovado.
Prazo da Meta: na primeira conta, a aprovação do modelo de lembrete pode levar 1 ou 2 dias. Enquanto isso, o envio manual e a régua não disparam. Conectar de novo a mesma conta, com o modelo já aprovado, não espera outra vez. O aviso fica no topo da aba Integrações e no lembrete do título.
Faturas, troca de cartão e notas da Meta ficam nessa área de cobrança. O Estoqfy não acessa o cartão.
Lembrete de um título: no detalhe de um título pendente ou em atraso, só o administrador vê o lembrete quando o cliente aceitou naquele telefone. Enviar pela conta da empresa aparece quando a Meta libera o envio. Abrir no WhatsApp abre o aplicativo deste aparelho, no número que estiver logado nele, com o mesmo texto de nome, valor e vencimento. Esse atalho não passa pela API, não cobra a conta da empresa e não impede o envio por ela. O aceite fica no cadastro do cliente, na linha abaixo de telefone e e-mail. O botão não fica na lista de clientes. O celular pode estar só com DDD: o Estoqfy completa o 55. O envio usa sempre o modelo estoqfy_lembrete_pgto, a mesma cópia da biblioteca da Meta, em português, em todas as contas. Essa cópia fica na conta conectada e só sai depois que a Meta aprovar. A mensagem leva o nome do cliente, o valor e o vencimento. O modelo da Meta inclui o botão Pagar agora, que abre https://estoqfy.com. A Meta não aceita um link direto do WhatsApp nesse botão. Cada clique envia de verdade. Um segundo clique no mesmo título não dispara de novo, a menos que a Meta marque o anterior como falha. Título pago, cancelado, sem celular, sem aceite ou com a conta bloqueada na Meta não envia. A mesma ação está em POST /integrations/whatsapp/receivables/{id}/reminder.
Régua: na mesma aba Integrações, só o administrador vê a régua. O formulário aparece quando a conta da empresa está conectada. Enquanto a Meta não libera o envio, a tela mostra só o motivo da pausa. Informe os dias antes do vencimento e o teto do dia. A estimativa do mês usa a tarifa de lista e aparece antes de ligar. Simular sem enviar não dispara. Com a régua ligada, o servidor envia sozinho entre 8h e 18h, no fuso de Brasília, uma vez por dia, só para título em aberto de cliente que aceitou e que ainda não recebeu esse lembrete. Qualidade vermelha na Meta ou conta sem envio liberado pausam o disparo. A régua nasce desligada. A API é GET e PUT /integrations/whatsapp/ruler e POST /integrations/whatsapp/ruler/preview.
Mensagens: a aba lista as últimas recebidas e enviadas depois do vínculo. Uma mensagem que chegou antes de vincular o número não fica gravada. A situação começa em Aceita e passa a Entregue, Lida ou Falhou quando a Meta avisa. Na falha, a aba mostra o código e o detalhe. A mesma lista está em GET /integrations/whatsapp/messages. O vínculo manual está em POST /integrations/whatsapp/bind.
Previsão do mês: a aba mostra quantas mensagens foram entregues no mês (fuso de Brasília) e uma previsão em reais pela tarifa de lista do Brasil. Mensagem aceita e ainda não entregue, mensagem que falhou e mensagem recebida do cliente ficam de fora do valor. Quando a Meta informa o valor da entrega, a previsão usa esse valor. A coluna Confirmado pela Meta soma só o que a Meta marcou como cobrado. A fatura oficial continua sendo a da Meta. A mesma consulta está em GET /integrations/whatsapp/forecast (permissão de configurações). Com a integração desligada neste servidor, a rota responde 404.
Assistente IA — manual do usuário
Quando desmarcado: o modo Manual do assistente na barra some; POST /ai/manual-chat é rejeitado. O link para o manual em PDF/HTML continua disponível.
Assistente IA — operação (barra)
Quando desmarcado: o botão do assistente deixa de enviar perguntas operacionais (POST /ai/chat). Exige permissão intelligence_view quando ligado. Com a janela aberta, o campo de continuação reenvia a pergunta nova e as últimas trocas em history. Fechar encerra.
Central de Inteligência (página)
Quando desmarcado: o item de menu e a página Central de Inteligência ficam indisponíveis (redirecionamento ao dashboard). O resumo JSON (GET /intelligence/summary) sem narrativa pode ainda ser usado por outras telas se elas estiverem ligadas.
Faixa Inteligência no Dashboard
Quando desmarcado: remove o bloco Inteligência hoje na tela Dashboards.
Explicar indicadores (KPIs) em rotas
Quando desmarcado: os botões Explicar nos painéis Acompanhar rota somem; POST /ai/explain-route-kpi é rejeitado.
Explicar indicadores (KPIs) no Dashboard
Quando desmarcado: remove os botões Explicar nas abas Comercial, Financeiro e Fiscal do dashboard; POST /ai/explain-dashboard-kpi é rejeitado. Respostas ficam em cache enquanto os números do KPI não mudam (mesma lógica das rotas). Shift+clique em Explicar força nova geração. A aba Fiscal só aparece com o add-on de emissão; o Explicar usa os mesmos números do painel (NF-e e NFC-e).
Nova venda — insight contextual
Quando desmarcado: remove a faixa de sinais em Nova venda (atrasos e títulos a vencer do cliente, promoções ativas, estoque crítico). GET /intelligence/context-insight?surface=sale_new retorna 403. Não consome tokens de IA.
Receber título — insight contextual
Quando desmarcado: remove a faixa em Receber título (atraso do título, outros atrasos do cliente, atalhos). GET /intelligence/context-insight?surface=receivable_receive retorna 403. Não consome tokens de IA.
Mercadorias — análises com IA
Quando desmarcado: remove a faixa compacta de inteligência na listagem de Mercadorias (alertas de estoque baixo etc.).
Mercadorias — sugerir grupo, subgrupo e unidade
Quando desmarcado: remove o botão Sugerir classificação na aba Dados do cadastro e da edição da mercadoria. POST …/cadastros/mercadorias/sugerir-classificacao e POST /ai/product-classify respondem 403 (AI_FEATURE_DISABLED). Quando ligado, o clique consome tokens do plano e preenche unidade, grupo e subgrupo já cadastrados. Não grava a mercadoria.
Mercadorias — sugerir dados fiscais (NCM)
Quando desmarcado: remove o botão Sugerir com IA e o botão Consultar NCM na aba Fiscal do cadastro/edição da mercadoria; POST …/cadastros/mercadorias/sugerir-fiscal e POST …/consultar-ncm respondem 403 (AI_FEATURE_DISABLED). Quando ligado, cada clique em Sugerir consome a cota mensal de tokens do plano. Consultar NCM só consome tokens na primeira vez daquele código; depois a descrição fica em cache e reaparece ao abrir a mercadoria. A IA apenas preenche o formulário (NCM; CEST só se aplicável; CSOSN só se diferente do padrão da empresa). O aviso deixa claro que a sugestão pode estar errada e que o contador deve validar. Não chama a Focus nem a SEFAZ.
Vendas — faixa de inteligência
Quando desmarcado: remove a faixa em Listar Vendas (queda de faturamento, descontos). O botão IA na faixa só aparece se houver queda relevante — e só gasta tokens se o usuário clicar.
Compras — sugerir reposição
Quando desmarcado: remove o botão Sugerir reposição em Nova compra. POST …/compras/ai/sugerir-reposicao e POST /ai/purchase-replenish respondem 403. Quando ligado, monta linhas com mercadorias abaixo do mínimo ou cuja saída dos últimos 30 dias supera o saldo. Itens em campanha ativa ou pausada ficam de fora. Consome tokens. Não grava a compra.
Compras — faixa de inteligência
Quando desmarcado: remove a faixa em Listar Compras (ex.: contas a pagar vencidas). Sem botão de pergunta à IA na faixa.
Relatório financeiro — faixa de inteligência
Quando desmarcado: remove a faixa no Resumo Financeiro (atalhos a recebíveis/pagáveis em atraso e relatório de vendas). Dados do mesmo resumo em cache — sem narrativa automática.
Notas fiscais — explicar rejeição
Quando desmarcado: remove o botão O que corrigir na aba NF-e/NFC-e da venda e o atalho no Emissor. POST …/fiscal/ai/explicar-rejeicao e POST /ai/fiscal-rejection-explain respondem 403. Quando ligado, o botão aparece em nota rejeitada, denegada ou pendente com mensagem de pré-checagem. A IA explica a mensagem já gravada e aponta cadastro (mercadoria, cliente ou dados fiscais). Não chama a Focus nem a SEFAZ e não altera a nota. Consome tokens do plano.
Orçamentos — conferir antes de converter
Quando desmarcado: remove o botão Conferir orçamento no painel de conversão. POST …/orcamentos/{id}/ai/conferir e POST /ai/quotes/{id}/check respondem 403. Quando ligado, avisa preço abaixo do custo e desconto fora do histórico do cliente. A narrativa por modelo só consome tokens se houver algum achado. Não altera o orçamento.
Ordens de serviço — sugerir serviço e peça
Quando desmarcado: remove o botão Sugerir serviço e peça no formulário da ordem. POST …/ordens-servico/ai/sugerir e POST /ai/service-order-suggest respondem 403. Só aparece com o módulo de Serviços ligado. O relato nas observações precisa ter pelo menos algumas palavras. A sugestão preenche linhas do catálogo e de peças com estoque. Consome tokens. Não abre a ordem sozinha.
Narrativa IA no resumo operacional
Quando desmarcado: GET /intelligence/summary?narrative=1 retorna erro; o resumo sem narrative (contadores determinísticos) continua funcionando.
Promoções — sugerir estoque parado
Quando desmarcado: remove o botão Sugerir estoque parado em Nova campanha. POST …/promocoes/ai/sugerir-estoque-parado e POST /ai/promotion-dead-stock respondem 403. Quando ligado, sugere mercadorias com saldo e sem saída há 90 dias, com preço promocional acima do custo. Consome tokens. A campanha só existe depois de Criar campanha.
Promoções — análises com IA
Quando desmarcado: remove a faixa de inteligência na listagem de Promoções.
Recebíveis e financeiro — análises com IA
Quando desmarcado: remove a faixa de inteligência em Recebíveis (ex.: títulos em atraso).
Rotas — análises e resumo por IA
Quando desmarcado: remove faixas em rotas ativas, resumo IA de rotas finalizadas, chips contextuais no assistente em Acompanhar rota e o carregamento automático de contexto de rota no chat. Rotas canceladas já não exibem IA.
Aba Diretivas Comerciais
Seções: Clientes, Vendas, Orçamentos, Vendedores e rotas, Preços, Serviços.
Clientes
Exigir CEP no cadastro do cliente
Quando marcado (padrão): o CEP é obrigatório no cadastro, na edição e na importação XLSX de clientes (web e API). Se informado, precisa ter 8 dígitos.
Quando desmarcado: o cliente pode ser salvo sem CEP. Logradouro, número, bairro, cidade e UF continuam obrigatórios. Fornecedores não são afetados. A emissão de NF-e/NFC-e ainda exige endereço completo do destinatário na pré-checagem.
Exigir CPF/CNPJ no cadastro do cliente
Quando marcado (padrão): o documento é obrigatório no cadastro, na edição e na importação XLSX de clientes (web e API).
Quando desmarcado: o cliente pode ser salvo sem CPF/CNPJ; vários clientes sem documento são permitidos. Se o documento for informado, continua precisando ser único. Fornecedores não são afetados. A emissão de NF-e/NFC-e ainda exige CPF/CNPJ do destinatário na pré-checagem.
Vendas
Adicionar Observações em todas as vendas
Quando desmarcado (padrão): ao abrir Nova venda, o campo Observações permanece em branco (salvo texto que o próprio usuário digitar na ocasião).
Quando marcado: o texto configurado nesta diretiva é pré-preenchido ao abrir a nova venda; o usuário pode editar antes de salvar. Ao salvar as configurações com esta opção ativa é obrigatório informar o texto das observações; caso contrário, o sistema solicita texto ou pede para desmarcar a opção.
Exigir anexo de documento na venda (por forma de pagamento)
Quando desmarcado (padrão): Na Nova venda, o anexo de documento permanece opcional para todas as formas.
Quando marcado: Escolha uma ou mais formas de pagamento nas quais o arquivo será obrigatório. Isso vale para a forma principal da venda e, em vendas com entrada + parcelas, também para a forma da entrada quando ela for uma das marcadas. Na API REST, use GET /lookups/settings (campo saleDocumentRequiredPaymentMethodIds), envie o arquivo em POST /uploads/sale-document e inclua documentAttachment na criação da venda quando a regra se aplicar. Exige variáveis CLOUDINARY_* configuradas no servidor.
Exigir vendedor em todas as vendas
Quando desmarcado (padrão): O campo "Vendedor responsável" é opcional na tela de vendas. A venda pode ser registrada sem associar um vendedor.
Quando marcado: Toda venda precisa ter um vendedor responsável associado. O sistema bloqueia o registro da venda se nenhum vendedor for selecionado. O campo "Vendedor responsável" passa a ser obrigatório na tela de Nova venda.
Permitir a reabertura de uma venda
Quando desmarcado: não há fluxo para reabrir vendas já registradas (ajuste de mercadorias/observações na mesma venda dentro do prazo).
Quando marcado: usuários com permissão podem ajustar mercadorias e observações apenas em vendas a prazo em parcela única (uma parcela no plano e dias para o 1º vencimento maior que zero): não cobre vendas à vista nem parcelamentos em várias prestações. Exige que nenhuma parcela tenha sido quitada nem tenha recebimento parcial. O mesmo título a receber da venda é atualizado quanto ao valor e vencimento conforme as alterações permitidas pela tela. Venda com NF-e emitida não pode ser reaberta, mesmo com esta diretiva ativa.
Política de reabertura
Permitir reabertura somente no dia da venda: só é possível reabrir no mesmo dia civil em que a venda foi registrada.
Permitir reabertura em até X dias: prazo em dias corridos desde a data da venda entre 1 e 365; se o valor ficar inválido ao gravar diretivas, o sistema solicita correção antes de salvar.
Permitir adição de mercadorias como brinde nas vendas
Quando desmarcado (padrão): não é possível marcar linhas como brinde na nova venda; toda linha segue o preço cadastrado ou promocional e entra no total.
Quando marcado: na nova venda, a coluna Brinde permite registrar itens com preço zerado e sem impacto no total da venda, em linha separada. A mesma mercadoria ou variante pode aparecer como brinde mesmo que já exista linha paga. Vendedores e administradores com permissão de criar venda podem usar a opção. Venda apenas com brindes exige plano à vista.
Permitir apenas Administradores e Vendedores como responsáveis por uma venda
Quando marcado (padrão): na Nova venda e no orçamento, a lista de responsável mostra somente usuários ativos com perfil Administrador ou Vendedor. O app mobile usa a mesma lista em GET /lookups/sellers.
Quando desmarcado: todos os usuários ativos do tenant aparecem para designar o responsável (web, API e app). A diretiva não altera quem pode operar uma rota de venda (continua Administrador/Vendedor). Com uma rota selecionada na venda, a lista segue os operadores daquela rota.
Permitir desconto nas vendas
Quando desmarcado: O campo de desconto não é exibido na tela de vendas. Se houver tentativa de aplicar desconto, o sistema retorna erro.
Quando marcado: O usuário pode aplicar desconto conforme a forma de aplicação e o limite definidos nos itens seguintes.
Desconto máximo (%)
Percentual máximo permitido: sobre o total do pedido no modo fixo, ou sobre cada mercadoria no modo por linha. Ex.: se for 10%, no modo fixo não se aplica mais de 10% no pedido; no modo por linha, nenhuma linha pode ter mais de 10% de desconto. Tentativas acima do limite geram erro.
Forma de aplicação do desconto
Desconto fixo por valor do pedido: um único percentual sobre o total. O subtotal considera o preço já informado em cada linha (incluindo promoções); o sistema aplica o percentual apenas sobre a parte do pedido que não está em campanha promocional ativa, como na interface de Nova venda.
Desconto por mercadoria adicionada: cada linha pode ter um percentual próprio (coluna na tabela de itens), até o máximo configurado. Linhas em promoção não devem receber desconto adicional (a interface zera o campo nessas linhas).
Validação em tempo real: nos dois modos, o sistema valida o limite máximo durante a digitação e faz conferência final no salvamento. No modo por mercadoria, editar o valor unitário recalcula o percentual da linha e respeita duas regras: não ultrapassar o desconto máximo e não permitir unitário acima do preço-base da tabela (linha inválida até correção).
Quem pode aplicar o desconto
Apenas administradores: Somente usuários com perfil Administrador podem aplicar desconto. Vendedores que tentarem receberão: "Apenas administradores podem aplicar desconto nas vendas."
Administradores e vendedores: Tanto administradores quanto vendedores podem aplicar desconto, dentro do limite máximo configurado.
Permitir o cancelamento de uma venda
Quando desmarcado: O botão "Cancelar" não é exibido na listagem de vendas. O cancelamento fica indisponível.
Quando marcado: O usuário pode cancelar vendas conforme a política abaixo. Ao cancelar, os itens são devolvidos ao estoque e os títulos a receber vinculados são marcados como cancelados.
Política de cancelamento da venda
Permitir cancelamento somente no dia da venda: A venda só pode ser cancelada no mesmo dia em que foi registrada. No dia seguinte, o botão de cancelar não aparece ou a ação é bloqueada.
Permitir cancelamento em até X dias: A venda pode ser cancelada dentro do prazo informado (em dias) a partir da data da venda. O valor deve estar entre 1 e 365 dias. Ex.: se for 7 dias, uma venda do dia 1º pode ser cancelada até o dia 8. Após o prazo, o sistema retorna: "O prazo para cancelar esta venda já expirou." Se informar valor inválido ao salvar as diretivas, o sistema exibe: "Ao permitir cancelamento em até x dias, informe um valor entre 1 e 365." Exceção fiscal: com NF-e emitida, vale a janela de 24 horas da SEFAZ a partir da autorização (NFC-e: 30 minutos) — ela se sobrepõe à quantidade de dias desta diretiva. O cancelamento da venda só conclui se a SEFAZ aceitar o cancelamento da nota (justificativa). Fora do prazo a venda não é desfeita: o caminho é NF-e de devolução na aba NF-e da venda (não use devolução de mercadoria na baixa do título). Mercadoria convertida: se a venda tem mercadoria que era simples e passou a ser com variações, ela não cancela nem reabre, mesmo dentro do prazo e mesmo com nota no prazo da SEFAZ. A nota não é cancelada e a devolução dessa mercadoria fica recusada. Estoque e títulos permanecem como foram gravados.
Permitir vendas de mercadorias sem estoque
Quando desmarcado (padrão): O sistema bloqueia a finalização da venda se algum produto não tiver quantidade suficiente em estoque. Uma mensagem de erro informará qual produto está com estoque insuficiente (ex.: "Produto X: estoque insuficiente — saldo: 2, solicitado: 5").
Quando marcado: É possível registrar vendas mesmo quando o produto está com estoque zerado ou abaixo do solicitado. Útil para vendas sob encomenda ou quando o controle de estoque não é rígido.
Orçamentos
Permitir criação de orçamentos
Quando desmarcado (padrão): o toggle Venda/Orçamento na nova venda e o fluxo de novo orçamento ficam indisponíveis.
Quando marcado: usuários com permissão podem criar orçamentos (sem débito de estoque, títulos ou caixa até a conversão). Aparece o parâmetro filho abaixo.
Permitir adicionar mercadorias sem estoque no orçamento
Quando desmarcado (padrão): o orçamento segue a mesma regra de estoque da venda (não lista/aceita mercadorias sem saldo suficiente, salvo se Permitir vendas sem estoque estiver ativo).
Quando marcado: é possível incluir no orçamento mercadorias com estoque zerado ou insuficiente, desde que possuam preço de venda cadastrado (mercadoria já comprada ao menos uma vez). Na conversão em venda, o sistema valida o estoque novamente: sem saldo suficiente, a conversão fica bloqueada.
Vendedores e rotas
Limitar vendedores apenas aos clientes e mercadorias da sua rota de vendas
Quando desmarcado (padrão): O vendedor continua vendo os clientes e as mercadorias conforme suas permissões normais, sem restringir o catálogo e a carteira ao vínculo em rota.
Quando marcado: Em tenants com módulo de rotas de venda, o vendedor passa a enxergar apenas os clientes e as mercadorias vinculados às suas rotas ativas. Se ele não possuir rota de venda ativa, não verá clientes nem mercadorias e também não poderá cadastrar novos clientes. As vendas já realizadas por esse vendedor continuam acessíveis para consulta normalmente, mesmo sem rota ativa. No aplicativo, ao abrir Nova venda com uma única rota ativa, essa rota já vem selecionada. Se houver mais de uma rota ativa, ele escolhe qual usar. O que foi lançado sem internet fica no aparelho, mas o servidor não grava a sincronização de clientes, vendas e recebimentos enquanto o vendedor não estiver de novo em uma rota de venda ativa. Ao voltar para uma rota ativa, a próxima sincronização envia essas pendências. Uma venda feita numa rota da qual ele foi retirado continua recusada, mesmo que ele esteja em outra rota.
Clientes cadastrados pelo vendedor: Com a diretiva ativa, todo cliente cadastrado por um vendedor passa a fazer parte da carteira desse vendedor: ele continua visível e disponível para venda para quem o cadastrou (mesmo que a rota seja editada depois) e fica invisível para os demais vendedores, ainda que as rotas cubram a mesma UF/cidade. Administradores não são afetados: continuam vendo e vendendo para todos os clientes.
Preços
Tabelas de preço variáveis
Quando desmarcado (padrão): quem tem permissão de listagem vê a tela de tabelas com aviso para ativar a opção aqui; não é possível cadastrar ou editar até ligar o módulo.
Quando marcado: administradores com permissões Tabelas de preço — Listar/Cadastrar/Editar podem manter tabelas com nome, modo de cálculo e percentual de ajuste. A API expõe variablePriceTablesEnabled em GET /lookups/settings e a lista ativa em GET /lookups/price-tables (JWT com permissão de criar venda), incluindo markupDeltaPercent e adjustmentMode.
Serviços
Habilitar Serviços e Ordens de Serviço
Disponível nos planos Professional e Scale. No plano Starter a opção não aparece e o módulo fica desligado; ao mudar para Professional ou Scale, ela passa a ser oferecida aqui. Se o plano voltar para Starter, o módulo some, mas os cadastros, OS e a configuração ficam guardados.
Quando desmarcado (padrão): o tenant não exibe catálogo de serviços, profissionais, agenda nem ordens de serviço (menu, telas, manual e API). O perfil Profissional fica oculto em Usuários e Perfis e permissões — não é possível cadastrar novos usuários com esse perfil até a opção ser ligada. Permissões já concedidas ficam preservadas para quando a opção for ligada de novo.
Quando marcado: o módulo fica disponível neste tenant. Aparece o parâmetro filho abaixo e o perfil Profissional volta a ser oferecido no cadastro de usuários.
Permitir profissionais assumirem OS
Quando desmarcado (padrão): ordens de serviço pendentes sem profissional não entram na fila do balcão. Profissionais só veem OS em que já foram designados (em execução, concluída ou cancelada). Somente o administrador delega o profissional nos detalhes da OS ou ao Agendar Execução.
Quando marcado: OS pendentes sem profissional aparecem para todos os profissionais; qualquer profissional pode usar Assumir e iniciar (web/API) e passar a OS para Em execução. O administrador continua podendo designar a equipe nos detalhes ou na agenda. Só aparece com Habilitar Serviços e Ordens de Serviço ativo.
Documento de aprovação da OS
Validade da proposta (dias): prazo impresso no PDF de aprovação (padrão 7, de 1 a 365). Condições: uma por linha, impressas numeradas antes da assinatura; em branco, o sistema usa um texto padrão (serviços adicionais só com nova aprovação, garantia a partir da conclusão, peças substituídas à disposição, autorização de execução e faturamento).
Permitir execução simultânea pelo profissional
Quando desmarcado (padrão): o profissional não pode ter dois horários ocupando o mesmo momento. Com um horário em execução ou pausado, iniciar/assumir outra OS ou receber um novo despacho é recusado com o aviso do conflito.
Quando marcado: horário em execução ou pausado não bloqueia outro — o profissional pode iniciar, assumir ou receber a execução de outra agenda/OS e trabalhar nas duas ao mesmo tempo; o calendário mostra os horários lado a lado. Dois horários agendados sobrepostos continuam bloqueados. Cada OS conta o próprio tempo; nas horas do profissional (relatórios de Performance e de Agenda), o período em paralelo conta uma vez só. Só aparece com Habilitar Serviços e Ordens de Serviço ativo.
Ao salvar a aba Diretivas Comerciais: com Permitir desconto nas vendas ativo, é obrigatório informar o desconto máximo (entre 0 e 100%); com Adicionar Observações em todas as vendas ativo, é obrigatório informar o texto pré-preenchido; com Exigir anexo de documento na venda ativo, marque ao menos uma forma de pagamento na lista.
Aba Diretivas Financeiras
Seções: Títulos a receber, Títulos a pagar e despesas, Compras.
Títulos a receber
Exigir comprovante na baixa de título (por forma de pagamento)
Quando desmarcado (padrão): O comprovante na tela de recebimento é opcional para todas as formas.
Quando marcado: Marque as formas em que o comprovante é obrigatório; nas demais, o anexo continua opcional. Se alguma forma exigir comprovante, a baixa rápida sem escolher forma e anexo (rota alternativa) é rejeitada. Na API, use GET /lookups/receivable-pay (receivableProofRequiredPaymentMethodIds), POST /uploads/payment-proof e paymentProof em POST /receivables/{id}/receive quando a forma escolhida estiver na lista. Exige Cloudinary configurado.
Exigir responsável pelo recebimento
Quando desmarcado (padrão): O campo "Responsável pelo recebimento" é opcional na tela de recebimento de títulos.
Quando marcado: É obrigatório informar o usuário responsável pelo recebimento ao dar baixa em um título. Por padrão, os responsáveis disponíveis são administradores e cobradores; vendedores também podem aparecer quando a diretiva Permitir que vendedores baixem títulos a receber estiver habilitada.
Limitar cobradores apenas aos clientes e títulos da sua rota de cobrança
Quando desmarcado (padrão): O cobrador continua vendo os títulos e clientes conforme as permissões e filtros normais da aplicação.
Quando marcado: Em tenants com módulo de rotas de cobrança, o cobrador passa a enxergar apenas os clientes que possuam títulos cobertos por suas rotas ativas e os respectivos títulos. Se ele não possuir rota de cobrança ativa, não conseguirá consultar clientes nem títulos a receber do tenant. Os recebimentos já realizados pelo próprio cobrador continuam disponíveis nos relatórios e listagens de títulos recebidos quando ele tiver as permissões necessárias. No aplicativo, baixas feitas sem internet ficam no aparelho, mas o servidor não grava a sincronização enquanto o cobrador não estiver em uma rota de cobrança ativa que cubra aquele título. Quando voltar a ser operador de uma rota ativa que cubra o título, a próxima sincronização envia a baixa.
Permitir pagamento parcial de títulos
Quando desmarcado (padrão): Na tela de recebimento de títulos, o valor a receber fica fixo no total do título. Não é possível registrar pagamento parcial.
Quando marcado: O usuário pode informar um valor menor que o do título. Por padrão na tela, o saldo gera novo título com vencimento conforme os dias informados. Para manter o saldo no mesmo título (sem segunda parcela), é necessário também ativar a opção Recebimento parcial sem gerar novo título abaixo e escolher essa modalidade ao receber.
Desdobramento na baixa de títulos a receber
Quando desmarcado (padrão): A baixa segue o fluxo clássico (uma forma de pagamento por operação).
Quando marcado: Exige também Permitir pagamento parcial de títulos. Na tela de recebimento da web e do aplicativo, administrador, vendedor e cobrador podem marcar o desdobramento e informar várias linhas (formas, valores e vencimentos) que somam o total a receber; dinheiro e PIX entram como caixa imediato; demais formas geram novos títulos. Não pode ser combinado com recebimento parcial sem novo título na mesma baixa. O título original fica com status Desdobrado.
Permitir devolução de mercadorias (crediário + 1 parcela)
Quando desmarcado (padrão): Na baixa de título não há grid de devolução de produtos.
Quando marcado: Para vendas em crediário com plano de uma parcela, na tela de recebimento é possível informar quantidades devolvidas por produto (até o limite ainda não devolvido). O estoque é aumentado e o valor do título é ajustado conforme a regra do sistema.
Recebimento parcial sem gerar novo título
Quando desmarcado (padrão): Em recebimento parcial, o sistema sempre cria um novo título para o restante (além de exigir a diretiva Permitir pagamento parcial de títulos).
Quando marcado: Na tela de recebimento, o usuário pode optar por não gerar novo título: o valor restante permanece no mesmo registro (título em aberto). É obrigatório informar o motivo. O valor efetivamente recebido entra no caixa e nos relatórios de fluxo na data do recebimento.
Permitir que vendedores baixem títulos a receber
Quando desmarcado (padrão): quem tem apenas perfil vendedor não opera recebimentos pelas telas/API com as permissões concedidas automaticamente por esta diretiva.
Quando marcado: o perfil vendedor recebe as permissões Títulos a receber — Listar e Títulos a receber — Dar baixa; ao desativar, são revogadas. O responsável na baixa passa também a poder ser vendedor quando esta diretiva estiver ativa.
Permitir remarcar recebimentos
Quando desmarcado (padrão): Na baixa de títulos a receber, a tela mostra apenas formas à vista (Dinheiro, PIX e Cartão de débito), e o recebimento conclui no fluxo clássico.
Quando marcado: A tela passa a exibir todas as formas ativas. Se o usuário escolher forma não imediata (ex.: crediário, cheque, cartão de crédito), o sistema exige vencimento da parcela remarcada, marca o título atual como Remarcado e cria um novo título pendente com a data informada. Formas imediatas continuam sendo liquidadas no caixa no ato.
Títulos a pagar e despesas
Permitir pagamento parcial de títulos a pagar
Quando desmarcado (padrão): Na tela de pagamento de títulos a pagar, o valor a pagar fica fixo no total do título. Não é possível registrar pagamento parcial.
Quando marcado: O usuário pode informar um valor parcial na tela de pagamento. Será gerado novo título com o saldo restante e vencimento conforme os dias informados.
Permitir que cobradores lancem despesas manuais
Quando desmarcado (padrão): o perfil cobrador não recebe automaticamente a permissão de cadastrar despesas manuais (títulos a pagar manuais).
Quando marcado: o perfil cobrador passa a ter a permissão Títulos a pagar — Cadastro manual; ao desativar, ela é revogada do perfil.
Exigir comprovante (despesa manual — cobrador)
Visível quando a opção anterior está ativa. Quando marcado: cobradores precisam anexar comprovante (PDF ou imagem) ao lançar despesas manuais na web ou no app. Requer Cloudinary configurado no servidor.
Permitir que vendedores lancem despesas manuais
Quando desmarcado (padrão): o perfil vendedor não recebe automaticamente cadastro manual de despesas em títulos a pagar.
Quando marcado: o perfil vendedor recebe a permissão Títulos a pagar — Cadastro manual; ao desativar, é revogada.
Exigir comprovante (despesa manual — vendedor)
Visível quando a opção anterior está ativa. Quando marcado: vendedores precisam anexar comprovante ao lançar despesas manuais. Requer Cloudinary configurado no servidor.
Compras
Permitir ajuste do preço de custo das mercadorias
Quando desmarcado (padrão): em Financeiro → Ajuste de preço só existem as formas por preço de venda e por markup. O custo do cadastro continua mudando apenas quando uma compra é registrada.
Quando marcado: a tela de ajuste de preço ganha a forma Por preço de custo. O administrador informa o novo custo da mercadoria simples ou da variante. O sistema atualiza o custo no cadastro e recalcula o markup % para manter o preço de venda. A última compra da mercadoria, os títulos a pagar e o caixa gerado por essa compra permanecem como foram lançados. Quem não tem a permissão price_adjustment_create continua sem acesso à tela.
Permitir o cancelamento de uma compra
Quando desmarcado: O botão "Cancelar" não é exibido na listagem de compras. Este é o padrão.
Quando marcado: usuários com permissão Compras — Cancelar podem cancelar compras. O sistema valida estoque suficiente, reverte as quantidades compradas, cancela os títulos a pagar vinculados e mostra estorno no relatório de caixa quando existirem pagamentos ou entrada. Se a reversão deixaria estoque negativo, a ação é bloqueada com mensagem indicando a mercadoria ou variante sem saldo.
Usar markup global nas compras
Quando desmarcado: Ao adicionar itens em uma compra, o usuário deve informar manualmente o markup (%) ou o preço de venda de cada produto.
Quando marcado: O sistema sugere automaticamente o markup em cada item adicionado na compra, usando o percentual configurado em "Markup global (%)". O preço de venda sugerido é calculado a partir do custo: preço = custo × (1 + markup/100). O usuário pode alterar o valor sugerido se necessário.
Markup global (%)
Percentual usado quando "Usar markup global nas compras" está ativo. Ex.: se o markup for 30% e o custo for R$ 100, o preço de venda sugerido será R$ 130. Este valor é aplicado em cada item ao registrar uma compra.
Não permitir entrada de mercadorias com markup inferior
Quando desmarcado: O usuário pode concluir compras com qualquer markup nos itens, inclusive inferior ao markup global.
Quando marcado: O sistema bloqueia o registro da compra se algum item tiver markup inferior ao definido no "Markup global (%)". Uma mensagem de erro será exibida: "Não é permitido registrar compras com markup inferior a X%. Verifique as configurações." O usuário precisará ajustar o markup ou o preço de venda de cada item para conseguir concluir a compra. Esta opção só aparece quando "Usar markup global nas compras" está ativa.
Ao salvar a aba Diretivas Financeiras: com Usar markup global nas compras ativo, é obrigatório informar o percentual de markup; com Exigir comprovante na baixa de título ativo, marque ao menos uma forma de pagamento na lista.

