# Produtos

Cadastre os produtos utilizados nas vendas, seus valores e suas associações organizacionais.

Versão 1.1.0

O catálogo de Produtos fornece opções para as vendas quando o módulo está habilitado. Ele registra nome e valor de referência; não gerencia estoque, tributos ou variantes de produto.

## Preparar e cadastrar

Abra **Gerenciador → Atribuições → Produtos**. O módulo começa desativado e o Master pode habilitar **Usar Produtos** nas configurações. Com o recurso ativo e permissão de cadastro, use **Produto** no cabeçalho ou preencha uma linha de cadastro rápido na tabela.

| Campo | Regra |
| --- | --- |
| Nome | Obrigatório; até 150 caracteres. |
| Valor | Obrigatório; número não negativo, até 9.999.999.999.999,99, com precisão monetária de duas casas decimais. |
| Organização | Opcional quando a separação está habilitada; deve estar disponível ao acesso. |
| Suborganização | Opcional, condicionada ao recurso; deve pertencer à organização selecionada. |
| Status | Ativo ou Inativo; um novo cadastro usa Ativo por padrão. |

Com associações organizacionais disponíveis, o formulário separa **Informações principais** e **Associações**. Sem elas, os campos aparecem sem essas abas. Salve e confira o produto na lista antes de usá-lo em outra tela.

Exemplo fictício: cadastre **Serviço mensal** com valor de R$ 150,00. Se o produto puder ser usado em toda a empresa, deixe as associações vazias; para restringi-lo a uma unidade, selecione a organização adequada, respeitando seu acesso.

## Valor e quantidade nas vendas

Ao selecionar um produto em uma venda, o item começa com **Quantidade = 1** e **Valor unitário** igual ao valor do catálogo. Os valores do item podem ser ajustados na venda. Alterar o valor desse item não edita o preço do catálogo. O total informado da venda é mantido separadamente; adicionar produtos não deve ser interpretado como recálculo automático desse total.

Quando as permissões permitem cadastrar ou editar produto pela venda, a ação mantém o próprio catálogo e precisa ser salva separadamente. Criar o produto não salva a venda nem registra recebimento. Confira os itens e o total antes de concluir a operação.

## Consultar e alterar

Use os filtros dos campos da tabela, inclusive situação e associações. Registros compartilhados podem continuar aparecendo ao filtrar uma organização; isso não significa que pertencem exclusivamente à unidade filtrada.

A tabela oferece seleção, edição, duplicação para novo cadastro e alteração em lote conforme as permissões. Revisar uma cópia não salva automaticamente o novo produto. Ao mudar a organização, confira novamente a suborganização antes de salvar.

Excluir exige confirmação e inativa o cadastro, preservando seu histórico. Uma lista vazia pode decorrer de filtro, situação, módulo desligado ou alcance de acesso; confira esses pontos antes de criar outro produto.

## Importar e exportar

A tabela exporta seus registros filtrados em arquivo JSON com os campos editáveis. A importação espera uma lista JSON e cria cadastros a partir desses campos, sem reutilizar o ID exportado como atualização automática. Para preparar um arquivo, utilize uma exportação como referência e revise Nome, Valor, associações e Status.

Cada lote enviado é validado em conjunto; um item inválido impede a gravação daquele lote. Uma seleção grande pode ser dividida em mais de um envio pela interface. Em caso de erro, confira os resultados já salvos antes de repetir toda a importação.

## Permissões e limitações

Cadastro, edição, inativação e exportação dependem das capacidades da página. Configurar o módulo exige Master. As organizações e suborganizações são configuradas em Organizações, não por um segundo interruptor dentro de Produtos.

Não use o valor do catálogo como prova de que uma venda foi gravada ou de que uma parcela foi paga: essas ações pertencem às respectivas operações. O catálogo não oferece controle de quantidade em estoque.

## Disponibilidade

O gerenciamento de Produtos está no web. No aplicativo, os produtos podem ser selecionados nas operações que os utilizam e que estão disponíveis ao acesso; não há tela de cadastro do Gerenciador.