Cadastros
Os cadastros são a base do Sialia: sem eles não há contrato nem cobrança. Esta página explica, aba por aba e campo por campo, como cadastrar clientes, fornecedores, colaboradores e parceiros — incluindo as validações que o sistema faz de verdade e os erros que travam o salvamento.
Um cadastro, vários papéis
No Sialia, Cliente, Fornecedor, Colaborador e Parceiro são o mesmo tipo de cadastro. O formulário é praticamente igual para todos — muda só o tipo que você marca e a lista do menu em que ele aparece. Aprendeu a cadastrar um, sabe cadastrar todos.
flowchart LR
P["Cadastro:
Alpha Tecnologia Ltda"] --> T1["Tipo: Cliente"]
P --> T2["Tipo: Fornecedor"]
T1 --> L1["Aparece em
Cadastros → Cliente"]
T2 --> L2["Aparece em
Cadastros → Fornecedor"]
L1 --> C["Pode assinar
contrato"]
L2 --> D["Pode receber
conta a pagar"]
style P fill:#EFF6FF,stroke:#1D4ED8,color:#1E3A8A
style T1 fill:#ECFDF5,stroke:#047857,color:#064E3B
style T2 fill:#E0F2FE,stroke:#0284C7,color:#0C4A6E
style C fill:#D1FAE5,stroke:#059669,color:#064E3B
style D fill:#DBEAFE,stroke:#2563EB,color:#1E3A8A
O campo que define o papel
É o Tipo de parceiro, na aba Geral. Pelo menos um tipo é obrigatório. Uma empresa que compra de você e também te fornece serviço tem um único cadastro com dois tipos — e não dois cadastros repetidos.
“Excluir cliente” pode não excluir o cadastro — e isso é intencional
Se o cadastro tem outros tipos além do que você está vendo, a exclusão remove apenas aquele tipo: o registro continua existindo como fornecedor, por exemplo. A exclusão de verdade só acontece quando aquele era o único tipo. É a regra que evita apagar, de dentro da tela de Clientes, um fornecedor que tem contas a pagar em aberto.
As abas do formulário
Ao abrir Novo Cliente (ou Fornecedor, Colaborador, Parceiro), o formulário se divide em abas. Preencha a Geral e navegue pelas demais conforme a necessidade.
| Aba | O que contém | Obrigatória? |
|---|---|---|
| Geral | Nome, contato e tipo do parceiro. | Sim |
| Documentos | CPF/CNPJ e inscrições. | Recomendada |
| Endereço | Um ou mais endereços. | Opcional |
| Contato e Responsável | Contatos adicionais (comercial, financeiro, pessoal). | Opcional |
| Financeiro | Chave PIX e conta bancária do parceiro. | Opcional, com regras |
| Comercial / Usuário | Canais de venda e vínculo de login. | Conforme o tipo |
Opcional não quer dizer dispensável
O Nome é o único campo realmente exigido para salvar. Mas um cadastro só com nome serve para pouco: sem documento você não emite nota corretamente, sem contato não consegue cobrar. Preencha o essencial de uma vez para não gerar retrabalho depois.
Aba Geral
| Campo | Para que serve | Regra |
|---|---|---|
| Nome / Razão social | Nome da pessoa ou razão social da empresa. | Obrigatório · até 255 caracteres |
| Nome fantasia | Como a empresa é conhecida no mercado. | Opcional · até 255 |
| E-mail principal do parceiro. | Opcional · precisa ter formato válido | |
| Telefone fixo | Telefone de linha fixa. | Opcional |
| Celular | Telefone móvel / WhatsApp. | Opcional |
| Origem | Por onde esse cadastro entrou no sistema. | Preenchida pelo sistema — veja abaixo |
| Tipo de parceiro | Define o papel: Cliente, Fornecedor, Colaborador… | Pelo menos 1 |
Origem: de onde o cadastro veio
A origem é um rastro de auditoria: ela conta como aquele registro nasceu. Serve para explicar diferença de qualidade entre lotes de dados — o que veio de importação costuma exigir mais revisão do que o que foi digitado por alguém.
Aba Documentos
Aqui o Sialia valida de verdade — não aceita número inválido.
| Campo | Detalhe |
|---|---|
| CPF / CNPJ | O sistema detecta automaticamente: 11 dígitos é CPF, 14 é CNPJ. E confere o dígito verificador. Número inválido não salva. |
| Inscrição estadual | Para empresas contribuintes de ICMS. |
| Isento de IE | Marque quando o parceiro é isento de inscrição estadual. |
| Inscrição municipal | Para prestadores de serviço (ISS). Até 100 caracteres. |
| Produtor rural | Marca cadastros de produtor rural, que têm tratamento fiscal próprio. |
Erro comum: “CPF ou CNPJ inválido”
Não é falha do sistema. O número digitado não passa na verificação matemática do dígito verificador. Confira se não faltou ou sobrou um dígito. Você pode digitar com ou sem pontos e traços — a formatação é ignorada.
Aba Endereço
Você pode cadastrar vários endereços (sede, cobrança, entrega) e marcar um como padrão.
| Campo | Regra |
|---|---|
| Nome do endereço (ex.: “Sede”, “Cobrança”) | Obrigatório |
| Logradouro (rua / avenida) | Obrigatório |
| CEP | Obrigatório · até 9 caracteres |
| Número, Complemento, Bairro, Cidade | Opcionais |
| UF | Sigla de 2 letras (SP, RJ…) |
| Padrão | Marca o endereço principal, usado por padrão nos documentos. |
Aba Contato e Responsável
Além do contato principal (aba Geral), aqui você adiciona contatos extras e classifica cada um. Útil para falar com a pessoa certa: quem resolve cobrança normalmente não é quem fecha a compra.
| Campo do contato | Detalhe |
|---|---|
| Nome | Nome da pessoa de contato. |
| Tipo | Comercial Financeiro Pessoal — define o papel do contato. |
| Validado se preenchido. | |
| Telefone fixo / Celular | Contatos diretos. |
Por que classificar importa
Os avisos automáticos de cobrança podem ser direcionados ao contato Financeiro. Classificar certo evita mandar boleto para o vendedor da empresa cliente — e evita que a cobrança se perca. Veja Regras de Notificação.
Aba Financeiro
São os dados para pagar o parceiro — comissão de parceiro, pagamento a fornecedor. Esta aba tem duas regras que o sistema cobra e que travam o salvamento.
| Campo | Regra |
|---|---|
| Tipo de chave PIX | Nenhum · CPF · CNPJ · Telefone · E-mail · Chave Aleatória |
| Chave PIX | Se o tipo for diferente de “Nenhum”, a chave passa a ser obrigatória. Se o tipo for “Nenhum”, a chave deve ficar vazia. |
| Banco, Agência (+ dígito), Conta (+ dígito) | Se você preencher qualquer dado bancário, então banco, agência e conta passam a ser obrigatórios juntos. Não dá para informar só a agência. |
Os dois erros que travam o salvamento aqui
(1) escolher um tipo de PIX e deixar a chave vazia. (2) preencher só parte dos dados bancários. Ou preenche o conjunto completo, ou deixa tudo em branco.
Aba Comercial e Usuário (colaboradores)
Para colaboradores e parceiros que vendem, aparecem dois campos extras.
Canais de venda
Em quais canais aquele colaborador atua. É o que alimenta o desempenho de venda por canal nos relatórios.
Usuário vinculado
Liga o cadastro a um login no sistema. É assim que um vendedor passa a também acessar o Sialia. Você pode vincular um usuário existente ou criar um novo.
Colaborador não é Usuário (e isso confunde todo mundo na implantação)
O cadastro de colaborador é comercial: ele aparece em contratos e comissões. O usuário é o acesso de login. A aba Usuário é a ponte entre os dois — só preencha se aquele colaborador também precisa entrar no sistema. Alguém do financeiro que não vende precisa de usuário, mas não precisa de colaborador.
Passo a passo: cliente novo
Cadastros → Cliente → Novo Cliente
Aba Geral
Nome, e-mail, celular e marque o tipo “Cliente”.
Aba Documentos
Informe CPF ou CNPJ — a validação acontece na hora.
Aba Endereço
Adicione ao menos o endereço de cobrança (nome, logradouro, CEP).
Aba Contato
Cadastre o contato Financeiro, para as cobranças chegarem a quem paga.
Salve
Se algo estiver errado, a aba com problema fica marcada e o campo aparece em vermelho. Pronto: o cliente já pode ser usado em Contratos e no Financeiro.
Parceiros e o fluxo de aprovação
O grupo Cadastros → Parceiro tem quatro itens, e o segundo é um fluxo, não um cadastro.
| Item | Para que serve |
|---|---|
| Todos os Parceiros | A lista geral. |
| Aprovação fluxo | Parceiros que se cadastraram sozinhos pelo Portal do Parceiro e aguardam sua liberação. Você revisa os dados e aprova ou rejeita. |
| Comissões | Os valores devidos a cada parceiro pelas vendas que ele originou. |
| Tipos de Parceiro | As categorias (revenda, indicador…) com cor e ícone. |
O que acontece na aprovação
flowchart LR
A["Parceiro se cadastra
no Portal"] --> B["Situação:
Pendente"]
B --> C{"Sua equipe
revisa"}
C -->|"Aprovar"| D["Situação: Ativo
acesso liberado"]
C -->|"Rejeitar"| E["Situação: Rejeitado
com motivo"]
D --> F["Indica clientes
e acompanha ganhos"]
D -.->|"depois"| G["Situação: Suspenso
acesso pausado"]
style A fill:#F5F3FF,stroke:#7C3AED,color:#4C1D95
style B fill:#FEF3C7,stroke:#D97706,color:#78350F
style C fill:#F1F5F9,stroke:#94A3B8,color:#475569
style D fill:#D1FAE5,stroke:#059669,color:#064E3B
style E fill:#FEE2E2,stroke:#DC2626,color:#7F1D1D
style F fill:#ECFDF5,stroke:#047857,color:#064E3B
style G fill:#FEF3C7,stroke:#D97706,color:#78350F
| Situação | Significa | O parceiro consegue… |
|---|---|---|
| Pendente | Cadastrou-se e aguarda revisão. | Nada ainda — o acesso não está liberado. |
| Ativo | Aprovado pela sua equipe. | Entrar no portal, ver planos, indicar clientes, acompanhar ganhos. |
| Rejeitado | Recusado, com motivo registrado. | Nada. O motivo fica no histórico. |
| Suspenso | Acesso pausado depois de ter sido ativo. | Nada, temporariamente. As comissões antigas permanecem. |
A rejeição exige um motivo da sua lista padronizada
Os motivos vêm de Configurações → Motivos, que tem uma lista específica para rejeição de parceiro. Padronizar aqui é o que permite, depois, responder “por que perdemos parceiros?” com dado em vez de impressão.
Tipos de parceiro
O que é: as categorias de parceiro (Cliente, Fornecedor, Colaborador, Revenda…), em Cadastros → Parceiro → Tipos.
| Campo | Detalhe | Regra |
|---|---|---|
| Nome | Como o tipo aparece nas telas. | Obrigatório |
| Slug | Identificador curto e sem espaços, usado internamente. | Obrigatório |
| Grupo | A família a que pertence: Cliente, Fornecedor ou Colaborador. | Define o comportamento |
| Cor e Ícone | Identidade visual do tipo em todas as telas. | Obrigatórios |
| Ativo | Tipos inativos não aparecem para novos cadastros. | — |
Onde isso implica
O grupo é o que faz o cadastro aparecer na lista de Clientes, Fornecedores ou Colaboradores — e mudar cor ou ícone muda a aparência do parceiro em todas as telas onde ele aparece. Tipos com selo de semente são padrão do sistema e não podem ser alterados.
Comissões de parceiro
O que é: o valor devido a um parceiro por uma venda que ele originou (Cadastros → Parceiro → Comissões). Contratos ativados geram comissão automaticamente, e você também pode lançar uma à mão.
| Campo | Detalhe | Regra |
|---|---|---|
| Parceiro | Quem recebe. | Obrigatório |
| Contrato | A venda que originou a comissão. | Opcional |
| Valor | Quanto será pago. | Zero ou mais |
| Percentual | A base do cálculo, quando aplicável. | 0 a 100 |
| Mês / Ano de competência | A que período a comissão pertence. | Usado no fechamento |
| Descrição | Contexto do lançamento. | Opcional |
Situação da comissão: cenário por valor
| Situação | Cenário que leva a ela | Onde implica |
|---|---|---|
| Pendente | Comissão gerada por um contrato ativado. | Aparece como “prevista” em Meus Ganhos, no portal do parceiro. |
| Aprovada | Você conferiu e liberou. | Fica pronta para pagamento. |
| Paga | Repassada ao parceiro. | Entra no realizado; some da previsão. |
| Cancelada | O contrato caiu, ou houve erro no lançamento. | Não é paga e sai da previsão do parceiro. |
flowchart LR
CT["Contrato
ativado"] --> P["Pendente"]
P --> A["Aprovada"]
A --> G["Paga"]
P -. "cancelar" .-> C["Cancelada"]
A -. "cancelar" .-> C
style CT fill:#DBEAFE,stroke:#2563EB,color:#1E3A8A
style P fill:#FEF3C7,stroke:#D97706,color:#78350F
style A fill:#EFF6FF,stroke:#1D4ED8,color:#1E3A8A
style G fill:#ECFDF5,stroke:#059669,color:#064E3B
style C fill:#F1F5F9,stroke:#94A3B8,color:#475569
Comissão aprovada não é comissão paga
Aprovar significa “conferi, é devido”. Pagar é o repasse efetivo. Manter os dois estados separados é o que permite fechar a competência do mês sem que o dinheiro tenha saído ainda — e o parceiro vê exatamente essa distinção no portal dele.
Extrato do cliente / fornecedor
Dentro de Clientes e de Fornecedores existe a opção Extrato: o resumo financeiro consolidado daquela pessoa — tudo que ela deve a você e tudo que você deve a ela, no mesmo lugar.
Antes de vender
Confira se o cliente tem título vencido antes de aprovar um contrato novo. Evita ampliar risco com quem já está em atraso.
Na hora de cobrar
Você fala com o cliente com a posição completa na tela, em vez de abrir um título por vez.
Com fornecedor
Se a mesma empresa compra e fornece, o extrato mostra os dois lados — base para negociar encontro de contas.
Importação por planilha
Em vez de digitar cliente por cliente, o Sialia importa cadastros em massa a partir de
uma planilha .xls, .xlsx ou .csv. A importação é
sempre por tipo: você escolhe se está importando Clientes, Fornecedores ou Colaboradores
e envia o arquivo daquele tipo.
flowchart LR
A["Escolher o tipo
e enviar a planilha"] --> B{"Pré-visualização
nada é gravado"}
B -->|"confere o resultado"| C["Efetivar
importação"]
C --> D["Cadastros criados
+ lote registrado"]
D --> E["Validação de CEP e CNPJ
em segundo plano"]
D -. "desfazer" .-> F["Cancelar o lote"]
style A fill:#EFF6FF,stroke:#1D4ED8,color:#1E3A8A
style B fill:#DBEAFE,stroke:#3B82F6,color:#1E3A8A
style C fill:#ECFDF5,stroke:#059669,color:#064E3B
style D fill:#D1FAE5,stroke:#047857,color:#064E3B
style E fill:#F5F3FF,stroke:#7C3AED,color:#4C1D95
style F fill:#FEF2F2,stroke:#DC2626,color:#7F1D1D
O que cada linha vira (situação na prévia)
Na pré-visualização, cada linha do arquivo recebe uma situação. É isso que evita duplicar sua base.
| Situação | Significa | Efeito ao efetivar |
|---|---|---|
| Ok | Parceiro novo. | Cria um cadastro novo. |
| Vinculado | O CPF/CNPJ já existe, mas sem esse tipo. | Não cria de novo: acrescenta o tipo ao cadastro existente — quem já era cliente passa a ser também fornecedor. |
| Duplicado | Já existe cadastro com esse documento e esse tipo. | Ignora — não duplica. |
| Inválido | Falhou na validação (documento inválido, por exemplo). | Não importa; a mensagem explica o motivo. |
O pulo do gato: “Vinculado”
Se você importa uma lista de fornecedores e alguns já eram seus clientes, o Sialia não cria cadastros duplicados — apenas acrescenta o tipo “Fornecedor” a quem já existe. Um cadastro, vários papéis, como no topo desta página.
Selo de validação (CEP / CNPJ)
Depois de efetivar, uma validação roda em segundo plano conferindo endereço e documento, e marca cada cadastro. Você não fica esperando.
| Selo | O que quer dizer | O que fazer |
|---|---|---|
| Pendente | Ainda aguardando a validação. | Nada — aguarde. |
| Validado | CEP e CNPJ conferidos. | Nada. |
| CNPJ Inativo | O CNPJ existe, mas está com situação cadastral inativa. | Confirme com o cliente antes de faturar. |
| Endereço Divergente | O endereço informado difere do que o CEP retornou. | Corrija o endereço no cadastro. |
| Erro | Falha ao validar — documento inválido ou erro na consulta. | Revise o documento. |
Na lista de cadastros dá para filtrar por esse selo — assim você trata só os problemáticos, sem revisar a base inteira.
Desfazer uma importação
Cada efetivação vira um lote, com nome do arquivo, tipo, quantidade criada, autor e data. No histórico de lotes você pode cancelar um lote inteiro:
- Os cadastros criados por aquele lote são removidos.
- Os que foram apenas vinculados (já existiam) são desvinculados do tipo — não são apagados.
- Cadastros que já ganharam vínculos que impedem a remoção (já têm contrato, por exemplo) são pulados, e o sistema informa o motivo.
O “desfazer” é seguro, mas não apaga o que já foi usado
Cancelar um lote é ótimo logo após uma importação errada. Mas se um cadastro importado já entrou num contrato ou num título, ele não é removido — fica listado como “não cancelado”, com o motivo. Isso protege seu histórico financeiro.
Fluxo recomendado na implantação
Importe → confira a prévia, olhando principalmente os Inválidos → efetive → filtre pelo selo de validação para corrigir CNPJ inativo e endereço divergente. Se saiu muito errado, desfaça o lote e reimporte. Faça isso com um arquivo pequeno primeiro — dez linhas — antes de subir a base inteira.
“Vou ter que digitar minha base toda de novo?”
É a objeção que mais atrasa assinatura de contrato. E aqui a resposta é demonstrável em cinco minutos.
Importa e mostra antes de gravar
A prévia diz linha por linha o que vai ser criado, vinculado, ignorado ou recusado. Ninguém arrisca a base às cegas.
Não duplica cadastro
Quem já existe recebe o novo papel em vez de virar um segundo registro. Base limpa desde o dia um.
Errou? Desfaz o lote
Importação ruim se cancela inteira, preservando o que já foi usado em contrato.