Um guia para cada perfil

O que você pode fazer

Cadastrar empresas, usuários, participantes, pessoas PF/PJ, carteiras de demonstração e subcontas de demonstração. Definir a empresa aprovadora para novas operações. Consultar operações, extrato e auditoria.

O perfil Administrador não pode criar, conciliar, aprovar, rejeitar nem liberar operações. Essas atividades exigem usuários com os perfis operacionais correspondentes.

Preparar empresas e usuários

1. Abra Empresas e cadastre Nome e Referência fictícia; clique em Salvar.

2. Abra Usuários e perfis. Informe nome, empresa, email fictício, senha inicial e perfil; clique em Salvar. A senha deve atender à regra de pelo menos 12 caracteres; senhas muito longas, especialmente com acentos e emojis, podem exigir redução.

3. Crie um Lançador na empresa de origem e um Aprovador ou Interveniente na empresa que fará a aprovação. Envie as credenciais individualmente por canal privado.

4. Um email já cadastrado não pode ser anexado automaticamente a outra área de trabalho. A tela atual cria usuários; não oferece edição de perfil nem redefinição de senha.

Cadastrar PF e PJ como titulares e participantes

1. Abra Pessoas PF e PJ. Escolha Pessoa física ou Pessoa jurídica.

2. Preencha Nome completo ou razão social, CPF ou CNPJ fictício válido e Email fictício. Clique em Cadastrar pessoa e aguarde a pessoa aparecer na lista.

3. Para usar a pessoa numa operação, no formulário Participante ou beneficiário selecione Pessoa cadastrada, Empresa da operação e Papel na operação. Clique em Vincular como participante e aguarde o contador de participações atualizar.

4. Esse vínculo cria também a carteira de demonstração usada nos splits. Confirme o resultado em Participantes e Contas de demonstração. Cadastrar uma pessoa não cria usuário de login.

5. Alternativa para participantes sem titular PF/PJ: cadastre em Participantes e depois crie sua carteira em Contas de demonstração, usando Participante sem conta e Criar conta de demonstração. Evite duplicar um vínculo que já existe.

Criar uma subconta simulada

1. Abra Subcontas de demonstração.

2. Escolha um Titular PF ou PJ previamente cadastrado e ainda sem subconta de demonstração.

3. Em Vinculação a escrow, escolha Sem escrow ou Com escrow (simulado). Clique em Criar subconta de demonstração e confira a linha na tabela.

4. Cada titular tem uma subconta de demonstração por área de trabalho. A opção de escrow é um atributo simulado: não muda os splits nem o fluxo de aprovação das operações.

5. Titular e beneficiário são vínculos diferentes. Criar subconta não vincula automaticamente a pessoa a uma operação. A tela não altera escrow de subcontas já existentes e não cadastra contas no Asaas.

Definir a aprovadora e validar o ambiente

1. Abra Configurações e localize Política de aprovação.

2. Selecione Empresa que aprova novas operações e clique em Salvar.

3. A mudança vale somente para operações criadas depois dela. As anteriores mantêm sua empresa aprovadora original.

4. Peça ao Lançador para criar uma operação de teste. Entre com outro usuário habilitado da empresa aprovadora para testar a decisão. A mesma pessoa não pode lançar e depois decidir sua própria operação, mesmo se o perfil mudar.

5. Confira Extrato e movimentações e Auditoria. No cenário demonstrativo AV1/ARZ, AV1 lança e ARZ é a aprovadora inicial.

Credenciais e limites administrativos

Para a instalação demonstrativa, as credenciais geradas podem ser consultadas pelo responsável com acesso ao terminal privado da VPS executando /opt/av1-deploy/credentials. O administrador da aplicação não recebe acesso à VPS automaticamente.

Não publique a saída desse comando e não compartilhe a conta administrativa entre operadores. Os cadastros novos não oferecem exclusão ou edição nesta versão; confira os dados antes de salvar.

As listas de pessoas e subcontas mostram até os 100 registros mais recentes. O manual não orienta ativação de Sandbox, manutenção de servidor ou movimentação financeira real.

Analisar solicitações de Escrow

1. Crie o acesso em Usuários e perfis, escolhendo Cliente. Entregue as credenciais por canal privado.

2. Abra Solicitações de Escrow e selecione um pedido Em análise. Confira titular, finalidade e participantes previstos.

3. Escolha Aprovar solicitação, Solicitar ajustes ou Recusar solicitação. Ajustes e recusa exigem justificativa. Não é permitido analisar sua própria solicitação.

4. Após aprovar, clique em Criar Escrow de demonstração. Essa etapa cria um titular e uma subconta local com escrow. Não cria participantes de operação automaticamente.

5. Se o documento já estiver cadastrado, a criação é bloqueada para conferência manual; não há vinculação automática a um titular existente. Atualize a página se outra sessão tiver alterado o pedido.

Cadastro automático no Asaas Sandbox

Quando a área estiver configurada para cadastro Sandbox, novos pedidos mostram Asaas Sandbox. O cliente preenche também nascimento PF ou tipo empresarial PJ, renda mensal, endereço e autorização de envio dos dados fictícios.

Ao aprovar esse pedido, o cadastro da subconta é agendado automaticamente. Não use a ação Criar Escrow de demonstração dos pedidos Mock para esse fluxo.

Confira Análise cadastral no Asaas: aprovação geral, dados comerciais, dados bancários, dados do boleto quando disponíveis e documentos. A data da consulta indica a atualização dos dados. Aprovação interna e aprovação do Asaas são independentes.

Se houver documentos com link, o titular deve concluir o envio pelo Asaas. Sem link, confira o fluxo documental habilitado para a conta. BaaS deve estar habilitado pelo Asaas para o onboarding correspondente.

Resultado incerto exige conferência administrativa antes de qualquer nova criação. Não repita o cadastro para tentar resolver um timeout. A abertura de subconta não ativa o produto Escrow do Asaas.

Pedidos antigos Mock não são enviados retroativamente. A configuração e as chaves ficam somente no servidor, sob responsabilidade do operador; não são inseridas na interface.

Antes de começar

Peça ao administrador os participantes com carteira de demonstração e a configuração da empresa aprovadora. Seu usuário deve pertencer à empresa que lança a operação.

Você consulta a área de trabalho, mas só concilia e solicita aprovação das operações que criou com sua empresa. Não cadastra usuários, pessoas, carteiras nem políticas; não aprova, rejeita ou libera operações.

Criar uma operação

1. Abra Operações escrow e clique em Nova operação.

2. Informe Descrição da operação, Valor total em centavos e Cenário.

3. Em Distribuição entre beneficiários, selecione um beneficiário que já tenha carteira de demonstração. Escolha a Regra: Percentual, Valor fixo ou Híbrida.

4. Use + Beneficiário para incluir os demais, sem repetir uma mesma pessoa na operação. Há limite de 30 beneficiários.

5. Na regra Percentual, o fixo deve ser zero. Na regra Valor fixo, as unidades de percentual devem ser zero. Na regra Híbrida, o valor é fixo + percentual do total, não do saldo restante.

6. Confira se a soma distribui exatamente o total, com valores positivos. Ajuste eventuais resíduos de centavos. Clique em Criar operação e confira Rascunho.

Exemplo: total 100000 centavos (R$ 1.000,00), beneficiário A com 9500 unidades de percentual e B com 500 unidades de percentual, ambos com fixo zero. Resultado: R$ 950,00 e R$ 50,00.

Conciliar e solicitar aprovação

1. Abra o rascunho que você criou e confira beneficiários, valor e Empresa aprovadora.

2. No formulário de conciliação, informe Referência única fictícia, por exemplo DEMO-20261020-001. Ela não pode ser reutilizada em outra operação dessa área de trabalho.

3. Informe Recebido em centavos com o valor exato do total e clique em Confirmar recebimento simulado. Isso registra uma simulação, não comprova recebimento bancário.

4. Confira Conciliada. Clique em Solicitar aprovação e aguarde Aguardando aprovação.

5. Acompanhe a decisão na lista ou no detalhe. A distribuição só aparece como Liberada · Simulação depois da liberação explícita por um decisor habilitado.

Erros e limites do seu fluxo

Beneficiário não aparece: peça ao administrador para criar ou conferir a carteira de demonstração na área de trabalho correta.

Soma diferente do total: revise centavos e unidades de percentual; 100 unidades de percentual significa 1%, e não 100%. O cálculo de percentuais descarta frações menores que um centavo, exigindo ajuste da distribuição.

Não é possível editar splits após a criação, reabrir rejeições ou cancelar/excluir operações pela interface atual. Se houver erro, interrompa a sequência e informe o administrador; não simule uma liberação para corrigir cadastro.

A própria operação não pode ser aprovada por você, mesmo após mudança de perfil. Acompanhe os registros em Auditoria e os lançamentos em Extrato e movimentações.

Condições para decidir

Seu usuário deve ser Aprovador, pertencer à Empresa aprovadora registrada na operação e ser diferente do criador. Poder consultar uma operação não significa poder decidi-la.

Você não cria nem concilia operações e não gerencia cadastros. Também não altera valor, beneficiários ou política de aprovação.

Conferir e aprovar

1. Abra Operações escrow e filtre Aguardando aprovação.

2. Abra o título e confira valor, cenário, empresa de origem, Empresa aprovadora, referência conciliada e Regras de distribuição.

3. Confirme que os beneficiários e valores correspondem ao pedido. Se a análise estiver concluída e favorável, clique em Aprovar operação.

4. Confira Aprovada. A aprovação, sozinha, não libera valores nem cria uma transferência.

Rejeitar uma pendência

1. Com a operação em Aguardando aprovação, preencha Justificativa (mínimo 5 caracteres).

2. Registre o motivo específico e clique em Rejeitar operação.

3. Confira Rejeitada e o motivo exibido no detalhe. A rejeição é terminal nesta versão; não há botão para reabrir.

4. A reclassificação para devolução é interna e simulada. Não representa estorno ou devolução externa no Asaas.

Liberar distribuição simulada

1. Abra uma operação Aprovada para a qual você continua habilitado como decisor.

2. Confira novamente os dados e clique em Liberar distribuição simulada.

3. Aguarde Liberada · Simulação e o identificador de liberação fictícia.

4. Consulte os lançamentos no detalhe e em Extrato e movimentações, e a ação em Auditoria. Nenhuma transferência bancária é feita.

O usuário que libera pode ser um decisor habilitado diferente de quem aprovou; a regra obrigatória é ser diferente do criador e pertencer à empresa aprovadora da operação.

Quando não há botão de ação

Confira o estado: aprovação/rejeição exigem pendência; liberação exige aprovação. Confira também sua empresa e se você criou a operação.

Uma alteração administrativa da política vale para operações futuras. Consulte a Empresa aprovadora do próprio detalhe, não apenas a política atual. Peça orientação ao administrador se houver divergência.

Seu alcance

Você consulta os dados da área de trabalho. Pode aprovar, rejeitar e liberar distribuição simulação somente se pertencer à empresa aprovadora da operação e não for o criador.

Ter papel de INTERVENIENTE em Participantes não concede esse acesso. Participante é um cadastro de negócio; Interveniente é o perfil do usuário de login. O administrador precisa configurar os dois vínculos quando aplicáveis.

Não cria/concilia operações nem gerencia usuários, titulares, subcontas ou políticas.

Rotina de acompanhamento

1. Abra Visão geral para acompanhar o resumo da área de trabalho.

2. Em Operações escrow, filtre a situação e abra o título para ver origem, aprovadora e distribuição.

3. Confira se sua empresa está indicada como Empresa aprovadora. Se não estiver, sua atuação nessa operação é de consulta.

4. Consulte Extrato e movimentações e Auditoria para acompanhar os registros simulados e as decisões.

Decidir quando sua empresa estiver habilitada

1. Em Aguardando aprovação, confira valor, referência conciliada, empresas e beneficiários.

2. Para autorizar, clique em Aprovar operação e confira Aprovada.

3. Para recusar uma pendência, escreva uma justificativa de pelo menos cinco caracteres e clique em Rejeitar operação. A rejeição é terminal.

4. Para concluir uma operação Aprovada, confira os dados e clique em Liberar distribuição simulada. Verifique Liberada · Simulação e os lançamentos internos.

5. Aprovação e liberação são passos separados. Nenhuma dessas ações movimenta dinheiro real.

Exemplo e dúvidas

No cenário inicial AV1/ARZ, um Interveniente da ARZ pode decidir uma operação cuja empresa aprovadora seja ARZ. Um Interveniente de outra empresa apenas consulta essa operação.

Se os botões não aparecerem, confira perfil de login, empresa, autoria e situação. A política atual não muda a empresa aprovadora das operações que já existiam.

Permissões e limites

Você consulta cadastros, operações, extrato e auditoria da área de trabalho ativa. Pode rejeitar uma operação em Aguardando aprovação desde que não seja seu criador, mesmo sem pertencer à empresa aprovadora.

Não aprova, não libera, não cria ou concilia operações e não altera cadastros, perfis ou políticas. Não há bloqueio global de usuário ou de área de trabalho nesta interface.

Revisar uma operação

1. Abra Operações escrow e filtre Aguardando aprovação.

2. Confira empresas, valor, referência conciliada, beneficiários, regras de distribuição e histórico disponível.

3. Consulte Auditoria para identificar os atores e as ações já realizadas. Consulte Extrato e movimentações para acompanhar os lançamentos simulados.

4. Se não houver motivo para rejeição, mantenha a operação como está e encaminhe sua análise pelo canal interno da organização. A interface atual não oferece aprovação ou parecer de compliance separado.

Rejeitar com justificativa

1. Abra a pendência e preencha Justificativa (mínimo 5 caracteres) com o motivo objetivo.

2. Clique em Rejeitar operação e confira Rejeitada e o motivo no detalhe.

3. Verifique a ação em Auditoria. A decisão é terminal; não há reabertura.

4. A rejeição trata a demonstração interna. Ela não executa estorno, devolução ou encerramento de garantia remoto.

Se a operação já estiver Aprovada ou Liberada · Simulação, este perfil não dispõe de reversão ou rejeição posterior. Informe o responsável sem tentar contornar o estado.

Seu acesso

O perfil é de consulta dos dados da área de trabalho ativa, incluindo cadastros, operações, extrato e auditoria. A interface não restringe o auditor apenas às operações de sua própria empresa dentro da área de trabalho.

Não cadastra, edita, concilia, solicita, aprova, rejeita ou libera operações. Não altera políticas nem apaga registros.

Roteiro de auditoria

1. Confirme a área de trabalho no topo e abra Visão geral para contextualizar volumes e situações.

2. Em Operações escrow, escolha uma situação e abra o título. A lista mostra até 100 operações por filtro.

3. Confira valor, empresa de origem, Empresa aprovadora, referência conciliada, distribuição e eventuais motivo de rejeição e identificador fictício de liberação.

4. No detalhe, examine Histórico de movimentações. Em Extrato e movimentações, acompanhe conta, operação, valor e lote; use Anterior e Próxima para percorrer páginas de 50 registros.

5. Em Auditoria, examine data, ator, ação, entidade e metadados; também há paginação de 50 registros.

6. Compare autoria e decisões para observar segregação de funções. Consulte a empresa aprovadora da operação: ela é preservada desde a criação, mesmo se a política atual mudar.

Como registrar uma constatação

Anote o identificador da operação, área de trabalho, horário de São Paulo, situação e ação observada. Encaminhe a constatação pelo canal da sua organização; não há formulário de relatório ou parecer de auditoria nesta versão.

O sistema protege histórico de movimentações e auditoria contra alteração pela aplicação, mas isso não equivale a certificação de auditoria ou prova de custódia bancária. Os dados são demonstrativos.

Não há exportação CSV/PDF embutida nas telas atuais. Não interprete ausência na primeira página ou em um filtro como ausência em todo o histórico.

O que está disponível

Você consulta as telas da área de trabalho: Visão geral, Operações escrow, Participantes, Pessoas PF e PJ, Subcontas de demonstração, Empresas, Usuários e perfis, Contas de demonstração, Extrato e movimentações, Auditoria e Configurações.

O acesso é à área de trabalho ativa; não é um portal individual restrito aos valores de um beneficiário. Cadastro de titular ou participante não gera automaticamente um usuário desse perfil.

Não cria nem altera cadastros, políticas ou operações. Não concilia, solicita aprovação, aprova, rejeita ou libera. Pode trocar entre seus ambientes autorizados e encerrar a própria sessão.

Consultar no dia a dia

1. Em Visão geral, acompanhe volume, pendências e valores simulados.

2. Em Operações escrow, filtre a situação e abra o título para consultar valor, origem, aprovadora e beneficiários.

3. Em Participantes e Contas de demonstração, consulte os vínculos e carteiras locais. Em Pessoas PF e PJ, os documentos são exibidos mascarados.

4. Em Subcontas de demonstração, confira o titular e o atributo Com escrow · simulado ou Sem escrow. Esses registros não provam abertura de conta no Asaas.

5. Se precisar acompanhar os eventos, use Extrato e movimentações e Auditoria. Percorra Anterior e Próxima quando disponíveis.

6. Ao terminar, abra Configurações e clique em Sair com segurança.

Como pedir uma alteração

Informe ao administrador ou operador responsável a área de trabalho, a tela, a operação ou cadastro e o ajuste necessário. Não é possível liberar sua própria permissão pela interface.

Se você precisa lançar operações, decidir pendências ou cadastrar pessoas, solicite uma avaliação do perfil adequado. Não compartilhe a senha de um usuário com maior acesso.

Acesso do cliente

Peça ao administrador um usuário com perfil Cliente. Cadastrar uma pessoa PF/PJ não cria acesso de login.

Seu menu contém Minhas solicitações, Minhas Escrows e Minha conta. Você vê somente seus próprios pedidos e as Escrows geradas a partir deles, dentro da área de trabalho ativa. Não consulta cadastros, operações ou pedidos de outros clientes.

Preencher uma solicitação

1. Abra Minhas solicitações e clique em Solicitar Escrow.

2. Escolha PF ou PJ e informe titular, CPF/CNPJ fictício válido, email e telefone. Descreva a finalidade e os participantes previstos.

3. Use Salvar rascunho para continuar depois. Use Enviar para análise quando os campos estiverem completos.

4. Acompanhe Em análise. Se aparecer Ajustes solicitados, leia a mensagem, corrija os dados e envie novamente. Um pedido recusado não pode ser reaberto nesta versão.

Depois da análise

Aprovada significa que o administrador aceitou o pedido internamente. A Escrow ainda depende da ação Criar Escrow de demonstração.

Quando aparecer Escrow criada · Demonstração, consulte Minhas Escrows. O registro é local e simulado; não abre conta no Asaas nem movimenta dinheiro.

O histórico apresenta envios, decisões e justificativas. Para trocar de área de trabalho autorizada ou sair, abra Minha conta.

Se o pedido indicar Asaas Sandbox

Confira o ambiente no formulário. Preencha os dados complementares e autorize o envio dos dados fictícios ao ambiente de testes do Asaas. Use apenas informações de demonstração.

Após a aprovação do administrador, o AV1 inicia o cadastro automaticamente. Acompanhe Análise cadastral no Asaas no detalhe do pedido. A criação não significa aprovação cadastral nem abertura de conta de produção.

Se aparecer Enviar documentos pelo Asaas, abra o link e conclua o fluxo externo. Links vencidos precisam de nova consulta. Se não houver link, solicite orientação ao administrador.

A tela mostra a última consulta e atualiza a leitura local automaticamente. Consultar situação e documentos no Asaas solicita uma consulta pontual, com intervalo mínimo de 30 segundos. Categoria não retornada aparece como Ainda não informado pelo Asaas.

Pedidos identificados como Mock preservam o fluxo de demonstração descrito anteriormente e não abrem contas no Asaas.