--- title: Cadastros gerais (parceiros e produtos) slug: cadastros-gerais-parceiros-e-produtos docTags: createdAt: 2026-08-14T12:47:29.831Z --- # Cadastros gerais (parceiros e produtos) :::BlockQuote Pré-requisitos: [Cadastro fiscal próprio](docId\:Q-zx6Qk4pMFD09yrhmsve) concluído (empresa e pelo menos a matriz). ::: ## Introdução *** Antes de registrar qualquer compra, venda ou nota fiscal, o sistema precisa conhecer com **quem** você opera (clientes e fornecedores) e **o que** você compra/vende (produtos). Esta página cobre, no menu **Cadastros**, todo o núcleo de cadastros gerais: parceiros (pessoa jurídica e física, papéis, endereços, dados fiscais, crédito, contas bancárias e PIX), o mapa geográfico dos parceiros, produtos (com NCM, unidade, método de custeio e códigos de barras), grupos de produto em árvore, tabelas de preço com vigência e faixas de quantidade, e as regras fiscais por produto. A mesma tela de parceiros aceita pessoa jurídica e pessoa física, e o mesmo registro pode acumular papéis (um parceiro pode ser cliente **e** fornecedor ao mesmo tempo). É um cadastro único: você não mantém "clientes" e "fornecedores" em telas separadas. Tudo o que você cadastrar aqui alimenta os módulos de Compras, Vendas, Estoque e Financeiro nas seções seguintes. ## Passo a passo *** ### Consultar e buscar parceiros 1. **Abra "Parceiros".** No menu lateral, em **Cadastros**, clique em "Parceiros". A tela abre com a lista "Parceiros cadastrados", trazendo as colunas **CNPJ / CPF**, **Nome / Razão social**, **Tipo de pessoa**, **Papéis** (Cliente, Fornecedor, Transportadora, Vendedor) e **Situação** (Ativo/Inativo).:inlineImage[]{src="https://itsm-labdev.cloud4biz.com/portal/docs-img/manual/012-partners.png" alt caption width="3200" height="2000"} 2. **Busque um parceiro.** Use o campo "Buscar por nome ou CNPJ/CPF..." acima da lista. A busca filtra pelo nome ou pelo documento. Clique nos cabeçalhos de coluna para ordenar (por documento ou por nome). 3. **Ações rápidas de cada linha.** À direita de cada parceiro há três ícones: o **lápis** abre a edição do parceiro; o ícone de **enriquecimento** consulta dados públicos do CNPJ; e o ícone de **bloqueio** inativa o parceiro (sem apagá-lo — o histórico é preservado). A seta **>** abre a ficha completa. ### Cadastrar um cliente (pessoa jurídica) 1. **Clique em "Novo parceiro".** No canto superior direito da lista. O formulário "Novo parceiro" abre em branco, dividido em blocos: **Dados gerais**, **Fiscal**, **Crédito** e **Comercial**.:inlineImage[]{src="https://itsm-labdev.cloud4biz.com/portal/docs-img/manual/07-partner-empty.png" alt caption width="3200" height="2000"} 2. **Tipo de pessoa.** No bloco **Dados gerais**, deixe "Jurídica" (opção padrão). 3. **CNPJ + Razão social.** Digite o CNPJ (no manual usamos o cliente Cliente Exemplo Ltda). Clique em **"Consultar CNPJ"** para trazer automaticamente a razão social, o nome fantasia, a natureza jurídica e **o endereço** a partir de fonte pública — dependendo do CNPJ, alguns campos são preenchidos sozinhos. Se a consulta não retornar, digite manualmente (não bloqueia o salvamento).**Se o CNPJ for de empresário individual (o caso do MEI), a consulta avisa.** Aparece o painel **"Este CNPJ é de empresário individual"**, e o motivo é importante: nesse tipo de empresa a razão social **é o nome civil do titular**, ou seja, dado pessoal de pessoa identificada — não um nome de empresa. O campo continua se chamando "Razão social" e o valor parece qualquer outro, então sem o aviso não há como perceber. Salvar registra esse dado sob a base legal do cadastro de fornecedores; qualquer outro uso (mala direta, divulgação de lista, envio a terceiro) precisa da sua própria base. Órgão público contrata MEI com frequência, então esse caso chega pelo caminho normal e não como exceção. Duas coisas o sistema faz sozinho: se a fonte pública devolver o **CPF colado ao fim do nome** — acontece —, ele é removido antes de o valor chegar ao formulário, porque documento não é parte de nome nenhum; e **a consulta fica registrada na trilha de auditoria**, com quem consultou, quando, e se a resposta continha dado pessoal. Quem precisa dessa trilha a lê na tela **Log de auditoria**, filtrando a ação **Consulta**.Quando a consulta traz endereço, aparece o painel **"Endereço encontrado na Receita Federal"** com o endereço em uma linha e a caixa **"Gravar este endereço como principal ao salvar"**, já marcada. **Duas coisas acontecem ao salvar com ela marcada**, e vale saber a segunda: o endereço é gravado como principal (é ele que alimenta o mapa de parceiros e o cálculo de rota), **e** os campos que continuarem em branco no formulário são completados com os dados da Receita. Se você apagou um campo de propósito — um nome fantasia que a empresa não usa mais, por exemplo — **desmarque a caixa**, senão ele volta. Desmarcada, o cadastro grava exatamente o que você digitou, e o endereço continua podendo ser incluído depois na aba **Endereços** da ficha do parceiro. 4. **Papel.** Marque **"Cliente"**. Você pode marcar mais de um papel na mesma linha de caixas — **Cliente**, **Fornecedor**, **Transportadora** ou **Vendedor** — se o parceiro acumular funções. 5. **Dados complementares.** Preencha o **e-mail** (é obrigatório — o sistema recusa o salvamento sem ele) e, opcionalmente, nome fantasia, telefone e os campos do bloco **Fiscal** (regime tributário / CRT, classificação fiscal, inscrição estadual e municipal) e do bloco **Crédito** (score, rating, observações). **Atenção ao limite de crédito deste bloco:** ele é apenas informativo e **não** participa do bloqueio de crédito das vendas — o limite que a venda respeita é o da tela **Crédito do cliente**, que é a fonte da verdade. Enquanto o cliente não tiver um registro lá, ele **não tem limite avaliado** — o que não é a mesma coisa que estar dentro do limite: a consulta de crédito devolve um **aviso**, e não um "ok", e a venda segue. Se você quiser que esse caso pare para aprovação, ligue **"Exigir ficha de crédito"** na política de crédito (tela **Crédito do cliente**) — com ela ligada, toda venda a cliente sem ficha vai para a fila de aprovações de vendas (documentada no capítulo de Vendas). Ela nasce desligada de propósito: nenhum cliente nasce com ficha de crédito, então ligá-la manda para aprovação todas as vendas a clientes ainda não avaliados. O CNPJ/CPF é **único por empresa**: se você tentar cadastrar um documento que já pertence a outro parceiro, o sistema bloqueia com o aviso de que o documento já existe. 6. **Salve.** Você é redirecionado para a edição do parceiro recém-criado e aparece um check verde **"Salvo às HH\:MM\:SS"** ao lado do botão. O parceiro também passa a aparecer na lista.:inlineImage[]{src="https://itsm-labdev.cloud4biz.com/portal/docs-img/manual/002-partners-detail.png" alt caption width="3200" height="2000"} ### Cadastrar um fornecedor 1. **Repita o processo** em "Novo parceiro" com outro CNPJ (no manual, Fornecedor Exemplo Ltda), marcando o papel **"Fornecedor"**. Ele aparece na lista com o papel "Fornecedor" na coluna **Papéis**. ### Cadastrar um cliente pessoa física 1. **Tipo de pessoa = Física.** No campo "Tipo de pessoa", troque para "Física". O rótulo do documento passa a aceitar CPF. Preencha nome completo e CPF. 2. **Endereço.** No bloco de endereço, informe o CEP (ex.: 01310-100) para autopreencher rua, bairro e cidade; complete número e complemento. O endereço é o que alimenta o mapa de parceiros (passo seguinte). **Confira a precisão da coordenada.** Depois de salvar, cada endereço da lista mostra ao lado do alfinete **até onde a busca conseguiu chegar**: endereço (achou o logradouro **com** o número — é o melhor nível), rua (achou a rua, sem o número), bairro ou município. Os três últimos aparecem em âmbar de propósito: **município significa que o ponto é o centro da cidade e pode estar a quilômetros do endereço real**. Isso importa quando a coordenada vai ser usada de verdade — roteirização, despacho de serviço em campo, coleta — porque um alfinete de município manda a equipe para o lugar errado sem nenhum aviso. Se a precisão não for a esperada, use o botão de **geocodificar de novo** (o ícone de alfinete ao lado do endereço). Ele fica disponível sempre, inclusive quando já existe coordenada — que é justamente o caso em que você precisa dele, porque a coordenada existente pode estar errada. Endereços cadastrados antes desta versão aparecem como precisão desconhecida: o sistema tem a coordenada, mas não registrou em que nível a obteve; geocodifique de novo para descobrir. ### Organizar parceiros em grupos 1. 💡 **Filiais da mesma raiz de CNPJ.** Na ficha de um parceiro pessoa jurídica, o cartão **"Filiais da mesma raiz de CNPJ"** lista os demais parceiros cadastrados sob os mesmos **oito primeiros dígitos** do documento — a matriz e suas filiais —, com link para abrir cada uma. O cartão **não aparece** quando o parceiro é o único sob aquela raiz, nem em pessoa física (um CPF não tem raiz). É a leitura complementar do grupo econômico: a raiz agrupa pelo documento, o grupo agrupa por decisão sua, e um cliente pode precisar dos dois. 💡 **E o caminho de volta: consultar por perfil.** Acima da lista de parceiros há quatro filtros que a percorrem no **servidor**, ou seja, respondem sobre a base inteira e não sobre a página que está na tela: **Porte**, **Potencial comercial**, **Grupo** e **Nº de funcionários (mínimo)**. Eles se combinam, e **Limpar filtros** zera todos de uma vez. O de porte é o que mais importa numa contratação pública: microempresa e empresa de pequeno porte têm tratamento favorecido por lei (LC 123/2006), e é por aqui que se responde "quais dos meus fornecedores são ME ou EPP". O de funcionários é **piso**, não igualdade — pedir 50 traz quem tem 50 ou mais; quem não tem o número preenchido fica de fora, porque não informado não é o mesmo que pequeno. **Grupos de parceiros.** Ainda na tela "Parceiros", role até o painel **"Grupos de parceiros"** no rodapé. Informe o **Nome**, escolha o **Tipo** (ex.: "Grupo econômico") e uma **Descrição**, depois clique em **"Adicionar grupo"**. Depois, no cadastro de cada parceiro, o campo **"Grupo"** (no bloco Dados gerais) permite vincular o parceiro ao grupo criado — útil para consolidar clientes/fornecedores da mesma holding. ### Ver o mapa de parceiros 1. **Abra "Mapa de parceiros".** No menu **Cadastros**. Os parceiros que têm endereço cadastrado aparecem como pinos no mapa, geocodificados a partir do endereço. Use o mapa para visualizar a distribuição geográfica da sua carteira de clientes e fornecedores. ![](https://itsm-labdev.cloud4biz.com/portal/docs-img/manual/013-partners-map.png) ### Contas bancárias e PIX do parceiro Na ficha do parceiro (edição), a página **"Contas bancárias / PIX"** lista as contas do parceiro, usadas por exemplo no roteamento de pagamentos. 1. **Adicionar conta.** Informe nome da conta, banco (no manual, banco 341), agência 0001, conta 12345-6 e dígito; clique em **"Adicionar"**. 2. **Editar conta.** Clique no ícone de **lápis** na linha da conta — os campos são carregados no formulário e o botão passa a ser **"Salvar"** (use "Cancelar" para desistir). Dados que a tela não mostra (titular, validade) são preservados ao salvar. 3. **PIX com preenchimento automático.** Ao escolher o **Tipo PIX**, a **Chave PIX** é preenchida a partir do cadastro do parceiro: **CPF/CNPJ** → documento; **E-mail** → e-mail; **Telefone** → telefone no formato +55 + DDD + número. Você pode editar a chave depois, se precisar (no manual, a chave fiscal\@acme-exemplo.com). 4. **Remover conta.** Clique no ícone de **lixeira** na linha da conta. ### Contatos, anexos e histórico do parceiro Ainda na ficha do parceiro (edição), abaixo dos dados principais, ficam três blocos usados no dia a dia do relacionamento: **Contatos**, **Anexos** e **Histórico de alterações**. ![](https://itsm-labdev.cloud4biz.com/portal/docs-img/manual/018-partner-contacts-history.png) 1. **Cadastre múltiplos contatos.** No bloco **"Contatos"** você mantém quantos contatos precisar para o mesmo cliente/fornecedor (comprador, financeiro, responsável técnico…). Informe **Nome**, **Cargo**, **E-mail** e **Telefone** e clique em **"Adicionar"**. Cada contato pode ser editado ou removido na própria linha — é o cadastro de múltiplos contatos por parceiro. 2. **Anexe documentos.** No bloco **"Anexos"**, clique em **"Enviar arquivo"** e selecione o documento — contrato, imagem, PDF, planilha ou documento digitalizado. O anexo passa a constar na lista, com download. Use para guardar contratos e papéis do cadastro junto do parceiro. 3. **Consulte o histórico de alterações.** O card **"Histórico de alterações"** lista os eventos de auditoria do cadastro (criação, alteração, inativação) por **ator** e **data**. Clique num evento para abrir o painel com o **diff campo a campo** — o que mudou, de qual valor para qual. O histórico exige perfil com permissão de auditoria; para os demais perfis o card **não aparece** — o controle de acesso esconde a página, sem tela de erro nem 403. ### Bloquear pagamentos ao fornecedor Na ficha de um parceiro que seja **fornecedor**, dois cartões travam pagamentos — e a diferença entre eles é o alcance. Ambos exigem a permissão de **aprovar documento**; sem ela os cartões aparecem só para leitura. 1. **Bloquear o pagamento de um fornecedor inteiro.** O cartão **"Bloqueio de pagamento"** trava a baixa de **todos** os títulos abertos daquele fornecedor de uma vez, inclusive os que ainda vão nascer. Informe o **motivo** e confirme; a ficha passa a exibir o selo de bloqueado e desde quando. **"Remover bloqueio"** libera. 2. **Bloquear só um fornecimento.** O cartão **"Bloqueio de um fornecimento específico"** trava apenas os títulos que carregam um determinado **documento de origem** — o contrato, o empenho ou o fornecimento em disputa. É o caso comum: você não quer parar o fornecedor inteiro, quer segurar uma entrega. - Informe o **documento de origem** exatamente como ele aparece no título (o sistema guarda em maiúsculas) e o **motivo**. Cada fornecimento bloqueado vira uma linha, com data e motivo, e **"Liberar o bloqueio"** desfaz. - Com o bloqueio ativo, tentar baixar um título daquele fornecimento é recusado com a mensagem apontando o documento de origem. Os demais títulos do mesmo fornecedor continuam pagáveis — é isso que separa este bloqueio do de cima. ### Personalizar a tela: esconder ou recolher seções A ficha do parceiro reúne muitos blocos — dados gerais, endereços, contatos, anexos, histórico, consentimentos, avaliações de fornecedor. O sistema já **esconde os blocos que o seu perfil não tem permissão de ver**; mas, mesmo entre os que você pode ver, nem todos fazem parte do seu dia a dia. O botão **"Personalizar"** (canto superior direito, com o ícone de controles) deixa **cada usuário arrumar a própria tela**, sem depender de TI e sem código. ![](https://itsm-labdev.cloud4biz.com/portal/docs-img/manual/020-partner-personalize-button.png) Ao clicar em **"Personalizar"**, abre um painel à direita — **"Personalizar tela"** — listando **apenas as seções que você tem permissão de ver**. Para cada uma há dois controles: - **Ocultar / Mostrar** — remove (ou traz de volta) a seção inteira da tela. - **Recolher / Expandir** (a seta) — mantém a seção, mas mostra só o título; um clique no título reabre o conteúdo. - **Restaurar padrão** (no rodapé do painel) — descarta as suas preferências desta tela e volta ao layout completo. ![](https://itsm-labdev.cloud4biz.com/portal/docs-img/manual/021-partner-personalize-drawer.png) As escolhas são **salvas por usuário** e valem nas próximas vezes que você abrir a tela — inclusive em outro computador. Elas **nunca revelam** uma seção que a sua permissão não libera: o controle de acesso continua acima da personalização, então uma seção que o seu perfil não pode ver não aparece nem na tela, nem nesta lista de personalização. :::BlockQuote A personalização por usuário está disponível na ficha de **parceiros** e nas demais telas de detalhe (produtos, contas bancárias, bens patrimoniais, títulos, processos jurídicos, orçamentos, imóveis, requisições de compra, grupos de produto e modelos de notificação). Além disso, um **administrador** pode definir o padrão de seções **por cargo ou para toda a organização** em **Administração → Padrões de seção** — e a escolha de cada usuário **sempre prevalece** sobre esse padrão. ::: O mesmo botão "Personalizar" aparece nas demais telas de detalhe. Abaixo, na ficha de **produto**, o painel lista as seções daquela tela (o histórico só aparece para quem tem permissão de auditoria): ![](https://itsm-labdev.cloud4biz.com/portal/docs-img/manual/023-product-personalize-drawer.png) Para o administrador, a tela **Administração → Padrões de seção** define, por tela e por **cargo** ou **toda a organização**, quais seções já vêm escondidas ou recolhidas por padrão: ![](https://itsm-labdev.cloud4biz.com/portal/docs-img/manual/022-admin-section-defaults.png) ### Unidades de Negócio e dados comerciais do parceiro 1. **Vincule Unidades de Negócio.** Quando a empresa opera com várias **Unidades de Negócio** (com regimes tributários, alíquotas e tratamentos contábeis próprios), o mesmo cliente pode ser atendido por mais de uma. No cadastro do parceiro, use o multi-select **"Unidades de Negócio"** para marcar quais unidades atendem esse cliente; nas vendas, o pedido resolve a unidade que atende e aplica o regime/alíquota dela. As unidades são cadastradas em **Administração → Unidades de Negócio**. 2. **Preencha o bloco Comercial.** O bloco **"Comercial"** guarda o **porte**, o **potencial de compra**, o **tipo** e o **nº de funcionários** (perfis de segmentação do parceiro) e a **Forma de pagamento** padrão — que é **sugerida automaticamente** nas movimentações de venda desse parceiro. Preencha e salve. ### Cadastrar grupos de produto 1. **Abra "Grupos de produto".** No menu **Cadastros**. A tela mostra a **árvore de grupos** — a hierarquia usada para classificar produtos e herdar configuração contábil. Se ainda não houver grupos, aparece "Nenhum grupo de produto cadastrado ainda". ![](https://itsm-labdev.cloud4biz.com/portal/docs-img/manual/015-product-groups.png) 1. **Novo grupo.** Clique em **"+ Novo grupo"**, informe o nome e a posição na hierarquia. Os grupos ficam disponíveis para escolha ao cadastrar produtos e servem para organizar os itens em famílias. ### Cadastrar um produto 1. **Abra "Produtos".** No menu **Cadastros**. A lista "Produtos" traz as colunas **Código (SKU)**, **Descrição**, **Grupo**, **Tipo** (Produto, Serviço, etc.), **Rastreio** (Lote/Série/Validade, quando aplicável) e **Situação**. Use o campo "Buscar..." para localizar um item. ![](https://itsm-labdev.cloud4biz.com/portal/docs-img/manual/014-products.png) 1. **Novo produto.** Clique em **"Novo produto"** e preencha: - **Código (SKU)** (ex.: PROD-001). - **Descrição** (ex.: Notebook ACME 14 polegadas). - **Grupo** — escolha um dos grupos cadastrados no passo anterior (opcional). - **Tipo** — Produto físico, Serviço, mercadoria revendida, etc. - **NCM** — **é obrigatório** e validado por formato: o produto não é salvo sem um NCM válido. Comece a digitar o código ou a descrição (ex.: notebook ou 8471). O campo abre uma busca que vai mostrando as opções conforme você digita; selecione a entrada certa da lista (ex.: 8471.30.12 — Máquinas automáticas para processamento de dados, portáteis). A lista é paginada; role para ver mais resultados. Suas últimas escolhas ficam no topo na próxima vez (atalho da sessão). - **CEST** — quando o NCM está sujeito a substituição tributária, escolha o CEST correspondente; caso contrário o campo indica "NCM não sujeito a ST". - **Unidade** — busque por sigla (UN, KG, M, L) ou descrição (Quilo, Litro). Selecione da lista. - **Rastreio** — marque **Lote**, **Série** e/ou **Validade** se o item precisa ser rastreado no estoque. ![](https://itsm-labdev.cloud4biz.com/portal/docs-img/manual/003-products-detail.png) 1. **Salve.** Ao salvar, a ficha ganha as seções complementares: - **Custeio** — mostra o **método de custeio resolvido** do produto (ex.: "Custo médio ponderado móvel"), herdado do padrão da empresa. É o que rege a valorização do estoque. - **Classificação STN** (setor público) — se o item for material de consumo com padrão STN, informe natureza da despesa, conta PCASP de estoque e conta PCASP de VPD, e clique em **"Salvar classificação"**. Órgãos privados podem ignorar. - **Códigos** — use **"+ Adicionar código"** para registrar códigos de barras / GTIN adicionais do produto. 2. **Duplicar (opcional).** Para cadastrar um item parecido, abra um produto existente e clique em **"Duplicar produto"** — abre um novo com os mesmos dados para você ajustar. 3. **Verifique.** O produto fica disponível para pedidos de compra, pedidos de venda e movimentos de estoque (testaremos isso nas seções 06 e 08). ### Criar e operar uma tabela de preço 1. **Abra "Tabelas de preço".** No menu **Cadastros**. A tela lista as "Tabelas de preço cadastradas" — listas de preço de venda e de fornecedor, com vigência e segmentação. Se ainda não houver nenhuma, aparece "Nenhuma tabela de preço cadastrada ainda". ![](https://itsm-labdev.cloud4biz.com/portal/docs-img/manual/016-price-tables.png) 1. **Nova tabela.** Clique em **"Nova tabela de preço"**, dê um nome, defina a **vigência** (data de início/fim) e o público-alvo (segmentação). Salve e abra a tabela para adicionar itens. 2. **Adicionar item e preço.** Na tabela aberta, adicione o produto e informe o **preço** (e o **piso**/preço mínimo, se aplicável). Cada produto aparece como uma linha da tabela. 3. **Reajustar preços.** No card **"Reajustar preços por percentual"**, informe o percentual e clique em **"Pré-visualizar reajuste"** — a prévia mostra, item a item, o preço atual e o novo, e só depois de conferir você aplica.**Reajuste por índice econômico.** Logo abaixo, em vez de calcular na mão, você pode **trazer o percentual de um índice** já cadastrado na Tesouraria (IPCA, SELIC, CDI, TR): escolha o **índice** e o **período**, clique em **"Buscar do índice"** e o percentual acumulado preenche o campo acima. Três coisas que vale saber: - A variação é **composta**, não somada: 1% seguido de 2% dá **3,02%** — é justamente o erro comum de quem faz a conta à mão. - Se o índice **não tiver cotação** no período informado, o sistema **avisa e não reajusta** — em vez de aplicar 0% em silêncio. - **Deflação** funciona: variação negativa reduz os preços. 4. **Importar planilha CSV (em massa).** Quando você precisa criar ou atualizar muitos preços de uma vez (onboarding com muitos SKUs, reajuste anual, sazonalidade preparada em planilha), use o card **"Importação em massa por CSV"** abaixo da lista de itens: - Clique em **"Baixar modelo"** para obter um CSV com cabeçalho internalCode,price,minPrice e uma linha de exemplo. - Edite no Excel/LibreOffice e salve como **CSV UTF-8**. - Selecione o arquivo e clique **"Pré-visualizar mudanças"**. O sistema mostra cada linha com a ação prevista (criar, atualizar ou erro) num painel com caixa de seleção por linha. Linhas com erro (produto não encontrado/inativo) vêm desabilitadas. - Desmarque o que não quer aplicar e clique **"Aplicar a N itens"**. Limite: 5000 linhas por arquivo. 5. **Cadastrar faixa de quantidade.** Para vendas de atacado ("a partir de X unidades, o preço cai"): - Na lista de itens, clique no triângulo **▸** ao lado do produto para expandir o subpainel "Faixas de quantidade". - Clique **"Adicionar faixa"** e digite Quantidade mínima + Preço (+ Piso opcional). - O sistema valida que cada item tem no máximo uma faixa por quantidade mínima e que o piso não pode passar do preço. - Quando uma versão da tabela é publicada, as faixas configuradas viram parte do registro histórico (o preço fica congelado para auditoria). ### Cadastrar rotas de venda e cobrar preço por rota Uma **rota** é o agrupamento comercial dos clientes que o vendedor ou a entrega percorre num mesmo circuito ("Litoral", "Serra", "Capital"). Ela serve para você definir um preço uma única vez **para a rota inteira**, em vez de repetir o mesmo preço cliente a cliente. É só um rótulo de agrupamento — não é roteirização de entrega (sequência de paradas, mapa, otimização). 1. **Abra "Rotas".** No menu **Cadastros**. A tela abre com o subtítulo "Rotas de venda para segmentar tabelas de preço" e lista as rotas nas colunas **Código**, **Nome** e **Situação** (Ativa/Inativa). Enquanto não houver nenhuma, aparece "Nenhuma rota cadastrada". 2. **Cadastre a rota.** Clique em **"Nova rota"**, informe o **Código** (no manual, LIT) e o **Nome** ("Litoral"), deixe **"Ativa"** marcada e salve. O código é convertido para maiúsculas e é **único**: se você repetir um código já usado, o sistema recusa o cadastro. Na lista, o **lápis** reabre a rota para edição e o ícone ao lado a **desativa** (com a confirmação "Desativar esta rota?"); rotas inativas continuam na lista, em cinza, e deixam de ser oferecidas nos próximos passos. 3. **Ligue o cliente à rota.** Abra o parceiro (ver "Cadastrar um cliente (pessoa jurídica)", acima) e, no bloco **Dados gerais**, use o campo **"Rota"** — logo abaixo de "Grupo". O combo lista as rotas ativas no formato CÓDIGO — Nome; o padrão é **"Sem rota"**. Cliente sem rota não é erro: a segmentação por rota simplesmente não se aplica a ele. 4. **Aponte a tabela de preço para a rota.** Abra a tabela de preço e, no card **"Segmentação"**, escolha a **Dimensão** = **"Rota"**. O campo **Referência** vira um seletor ("Selecione uma rota") que lista **apenas as rotas ativas** — você escolhe pelo nome, não digita código. Clique em **"Adicionar segmento"**. 5. **Entenda qual preço vence.** Ao montar um orçamento, o sistema sugere a tabela **mais específica** que se aplica ao cliente, nesta ordem: **cliente → rota → perfil → estado → região**. Ou seja: se o cliente tem uma tabela só dele, ela prevalece sobre a da rota; se não tem, ele herda o preço da rota. ### Definir regras fiscais por produto 1. **Abra "Regras fiscais por produto".** No menu **Cadastros**. A tela lista as "Regras cadastradas" com as colunas **Escopo**, **Operação** (Entrada/Saída), **UF orig.**, **UF dest.**, **CFOP** e as alíquotas de **ICMS**, **IPI**, **PIS** e **COFINS**. ![](https://itsm-labdev.cloud4biz.com/portal/docs-img/manual/017-product-fiscal-rules.png) 1. **Nova regra.** Clique em **"+ Nova regra"** e defina: - **Escopo** — a regra pode valer como padrão da operação ou ser filtrada por NCM específico (ex.: "Filtro por NCM: 84713012"). - **Operação** — Saída (venda) ou Entrada (compra). - **UF de origem e destino** — ex.: SP → RJ. - ***CFOP*** — ex.: 6102. - **Alíquotas** — ICMS, IPI, PIS e COFINS aplicáveis à combinação. 2. **Salve.** A regra passa a ser usada na apuração dos impostos ao emitir a nota fiscal (*NF-e*). Use o **lápis** para editar e a **lixeira** para remover uma regra da lista. ### Definir regras fiscais de serviço (ISS) Produto e serviço tributam por eixos diferentes: produto por NCM/CFOP (item anterior), serviço pelo **código da Lei Complementar 116/03**. Quem emite NFS-e cadastra a regra aqui. 1. **Abra "Regras fiscais de serviço (ISS)".** No menu **Cadastros**. A tela tem três blocos: o formulário da regra, o bloco **"Qual regra vale?"** e a lista **"Regras cadastradas"**. 2. **Preencha a regra.** - **Serviço (opcional)** — deixe em branco para a regra valer para **todo** serviço com aquele código da LC 116. Uma regra com serviço informado **vence** a genérica do mesmo código. - **Código do serviço (LC 116)** — ex.: 7.01 (consultoria), 1.05 (análises e testes). - **Código nacional da LC 116** — repita o de cima quando não houver diferença. - **Código de tributação municipal (CTM)** — o catálogo é de cada prefeitura; opcional. - **Alíquota de ISS (%)** — digite em **porcentagem**: 5 para 5%. - **ISS devido ao município** — do **prestador** ou do **tomador** (LC 116 art. 3). - **Retido pelo tomador** — marque ISS, PIS, COFINS, CSLL e IR conforme o contrato. 3. **Confira antes de emitir.** No bloco **"Qual regra vale?"**, digite o código do serviço e clique em **"Conferir"**. Ele consulta o **mesmo** resolvedor que a NFS-e usa, e responde a alíquota que sairia no documento. 4. **Salve.** Use o **lápis** de uma linha para trazê-la de volta ao formulário e a **lixeira** para encerrá-la. **Duas armadilhas que valem mais que o passo a passo:** - **A alíquota é limitada por lei a 2%–5%** (LC 116 art. 8). Fora dessa faixa o sistema recusa com "SERVICE\_FISCAL\_RULE.ALIQ\_ISS\_OUT\_OF\_RANGE" — não é defeito da tela. - **Sem nenhuma regra ativa, a NFS-e sai assim mesmo** — levando a alíquota **padrão do sistema**, não uma cadastrada por você. Não há aviso na emissão: a nota é transmitida normalmente. É por isso que o bloco "Qual regra vale?" existe, e é por isso que a lista vazia diz o que diz. ## Verificação *** Você sabe que funcionou quando: - O parceiro aparece na lista de "Parceiros" com o nome e CNPJ/CPF que você digitou e o(s) papel(is) certo(s) na coluna **Papéis**. - O check verde **"Salvo às HH\:MM\:SS"** apareceu após cada salvamento. - Ao buscar pelo nome ou documento, o parceiro recém-cadastrado aparece na lista filtrada; parceiros com endereço aparecem como pinos no **Mapa de parceiros**. - O produto aparece na lista de "Produtos" com o Código (SKU), a Descrição e o Tipo corretos, e pode ser selecionado em um pedido de compra ou venda. - A tabela de preço aparece na lista "Tabelas de preço cadastradas" com o item e o preço; a importação CSV mostra "Aplicar a N itens" com o número esperado de linhas. - A rota aparece na lista de "Rotas" com o código em maiúsculas e a situação **Ativa**; ela pode então ser escolhida no campo "Rota" do cliente e no seletor da dimensão "Rota" da segmentação da tabela de preço. - A regra fiscal aparece na lista "Regras cadastradas" com o CFOP e as alíquotas informadas. - A regra fiscal de serviço aparece na lista com o código da LC 116 e a alíquota em porcentagem; o bloco "Qual regra vale?" responde essa mesma alíquota para o código consultado. ## Erros comuns *** - **"Documento inválido"** (aparece abaixo do campo CNPJ/CPF) — o número digitado tem dígitos verificadores errados. Confira ou cole de uma fonte oficial. Enquanto estiver inválido, o botão "Consultar CNPJ" não traz dados. - **"Já existe um parceiro com o documento…"** — o CNPJ/CPF é único por empresa e já pertence a outro parceiro. Em vez de recriar, abra o parceiro existente e acrescente o papel que faltava (o mesmo cadastro pode ser cliente **e** fornecedor). - **E-mail obrigatório** — o salvamento do parceiro é recusado se o e-mail estiver em branco. Preencha um e-mail válido antes de confirmar. - **"Preencha os campos exigidos pelas declarações obrigatórias: … (exigido por: …)"** — sua empresa configurou, em **Administração → Campos obrigatórios por declaração**, campos que uma declaração (SPED, EFD, NF-e) exige. A mensagem diz **quais** campos e **qual** declaração os pede. Quando os campos listados são de endereço (street, number, district, city, zipCode, state), a exigência vale também para **existir** um endereço: salvar a **edição** de um parceiro que não tem nenhum endereço cadastrado é recusado, e o **último** endereço não pode ser removido — a aba **Endereços** recusa a exclusão com a mesma mensagem. Cadastre o endereço na aba **Endereços** e salve de novo. **A criação inicial não é barrada**, e isso é de propósito: o endereço é um cadastro filho, que só existe depois que o parceiro existe — então "Novo parceiro" salva normalmente e a exigência aparece no salvamento seguinte da ficha. Se a exigência não deveria valer, quem administra pode desligá-la naquela tela (a regra fica registrada, com histórico de quem ligou e quando). - **Razão social não autopreenche ao "Consultar CNPJ"** — a consulta pública pode estar indisponível ou o CNPJ é muito recente. Digite manualmente — não bloqueia o salvamento. - **NCM não aparece na busca** — refine o termo. Pode buscar por código completo (8471.30.12), por raiz (8471) ou por descrição (portátil, notebook). Se o catálogo NCM ainda não foi populado, peça ao administrador para rodar o seed de catálogos fiscais. - **Produto não salva por falta de NCM** — o NCM é obrigatório e validado por formato. Sem um NCM válido selecionado da lista, o cadastro é recusado. Selecione a classificação correta antes de salvar. - **SKU (código interno) já existe** — o código do produto é único; o sistema bloqueia o cadastro de um SKU repetido. Use outro código ou edite o produto já existente. - **Código de barras / GTIN recusado** — o sistema confere o dígito verificador (mod-10) do GTIN/EAN no momento do cadastro e rejeita códigos com dígito errado. Confira o número na embalagem ou em fonte oficial. - **Unidade de medida não aparece** — mesmo procedimento do NCM (busca por sigla ou descrição). Se faltar uma unidade específica, cadastre-a em **Administração → Catálogos fiscais → Unidades de medida**. - **Importação CSV com linhas em "erro"** — a linha referencia um produto que não existe ou está inativo pelo internalCode. Corrija o código na planilha ou cadastre/reative o produto antes de reimportar. - **Piso maior que o preço na faixa de quantidade** — o sistema recusa a faixa. Ajuste para que o piso (preço mínimo) seja menor ou igual ao preço. - **Código de rota já existe** — o código da rota é único e é gravado em maiúsculas (lit e LIT são o mesmo código). Use outro código ou edite a rota existente. - **A rota não aparece no combo do cliente ou na segmentação da tabela** — ela está **inativa**. Abra "Rotas", reative-a pelo ícone da linha e tente de novo.