# Especificação dos Módulos

## Plataforma e Organizações

### Objetivo

Administrar grupo, empresas, estabelecimentos, depósitos, módulos, sequências e parâmetros.

### Regras

- CNPJ único por empresa ativa dentro da instalação, ressalvados ambientes de teste.
- Alteração de regime mantém histórico com vigência.
- Toda empresa possui moeda, timezone e estabelecimento principal.
- Módulos são habilitados individualmente e dependências são validadas.
- Configurações fiscais e credenciais exigem permissão sensível e auditoria.

## Pessoas

- cadastro unificado com papéis múltiplos;
- validação de CPF/CNPJ sem impedir estrangeiros;
- endereços tipados e vigentes;
- limite de crédito e condições por empresa;
- bloqueio comercial não remove histórico;
- duplicidade detectada por documento e sugestões, nunca fusão automática.

## Catálogo

### Estados

Rascunho, ativo, suspenso e descontinuado.

### Regras

- variante é a unidade operacional de SKU/estoque;
- SKU único por grupo ou por empresa conforme configuração imutável inicial;
- fotos ordenadas, com principal e derivados;
- conversão de unidade requer fator positivo e histórico;
- tipo determina permissões: serviço não gera saldo; item estocável exige unidade de estoque;
- dados fiscais variam por empresa;
- atributos de marketplace são separados do núcleo do catálogo.

## Estoque e Almoxarifado

### Operações

- entrada, saída, transferência, reserva, liberação, bloqueio, desbloqueio, ajuste, inventário, consumo e produção;
- lote/série/validade;
- endereçamento;
- estoque de terceiros e em terceiros;
- consulta de genealogia.

### Regras

- saldo negativo bloqueado por padrão; exceção explícita por empresa e permissão;
- confirmação de movimento é atômica e idempotente;
- transferência possui saída, trânsito e recebimento, não uma troca instantânea de depósito;
- divergência no recebimento abre ocorrência;
- ajuste exige motivo; acima de limite exige aprovação;
- inventário congela ou registra corte lógico para os itens contados;
- custo e quantidade seguem precisão definida.

## Comercial

### Orçamento

- validade, versões e aprovação;
- conversão preserva referência e snapshot;
- alteração após envio cria versão.

### Pedido

- valida crédito, preço, desconto e estoque;
- permite atendimento parcial;
- reserva conforme política da empresa;
- cancelamento libera saldo e reverte efeitos ainda reversíveis;
- alteração após confirmação usa comando controlado e histórico.

### Venda/Expedição

- separação por onda ou pedido;
- leitura de SKU/lote/série;
- impedir item/lote incorreto;
- embalagem em volumes;
- dupla conferência configurável;
- expedição efetiva saída e publica eventos financeiro/fiscal/marketplace.

## Compras

- pedido aprovado não pode ser sobrescrito sem revisão;
- recebimento parcial mantém saldo pendente;
- quantidade excedente exige tolerância/aprovação;
- lote/validade capturados no recebimento;
- entrada pode ficar em qualidade antes de disponível;
- divergências não são resolvidas silenciosamente.

## Financeiro

- competência e caixa coexistem;
- título confirmado gera parcelas;
- baixa parcial e múltiplas contas;
- estorno gera lançamento inverso;
- alteração de vencimento auditada;
- nenhuma exclusão de baixa conciliada;
- consolidação sempre identifica empresa origem;
- fechamento de período bloqueia alterações sem reabertura autorizada.

## Produção e PCP

### BOM

- versão com validade e status rascunho/aprovada/obsoleta;
- componentes com quantidade, perda prevista e substitutos previstos;
- saída(s) com rendimento esperado;
- unidade e fatores congelados na OP.

### Ordem de Produção

Estados: planejada, liberada, em separação, em produção, pausada, concluída, encerrada e cancelada.

Regras:

- liberar calcula necessidade e tenta reservar;
- falta de material fica explícita;
- consumo pode ser por requisição, backflush configurado ou apontamento;
- resultado parcial permitido;
- perda exige causa;
- fechamento reconcilia materiais, resultados e custos;
- OP encerrada só muda por reabertura autorizada ou ajuste referenciado.

## Industrialização por Terceiros

### Ordem

Define terceiro, operação, insumos, resultados esperados, prazo, preço do serviço e tolerâncias.

### Remessa

- reserva e separa os lotes;
- leitura/confirmação;
- move depósito de origem para trânsito;
- confirmação de entrega move para estoque com terceiro;
- mantém propriedade da empresa remetente;
- permite remessas parciais.

### Retorno

- seleciona remessas abertas;
- informa insumos efetivamente consumidos;
- recebe produto transformado em novo SKU/lote;
- recebe sobras sem transformação;
- registra perdas e diferenças;
- mantém saldo pendente com terceiro;
- agrega serviço, frete e outros custos conforme política;
- gera genealogia completa.

Exemplo: 1.000 m de tecido cru enviados; 970 m retornam tingidos, 20 m crus retornam, 8 m são perda aceita e 2 m permanecem pendentes. A ordem não encerra enquanto os 2 m não forem resolvidos.

## Logística e Expedição

- etiqueta de unidade, lote, caixa e volume;
- layouts versionados por impressora/tipo;
- códigos GS1 quando aplicável;
- fila de impressão com reimpressão auditada;
- separação, conferência, embalagem, despacho e comprovante;
- leitura via teclado HID inicialmente;
- impressão ZPL/RAW por agente local prevista para fase posterior;
- uma etiqueta não pode baixar estoque sozinha: a leitura executa um comando autorizado no contexto.

## Marketplace

- conexão pertence a uma empresa e conta externa;
- anúncio mapeia uma ou mais variantes;
- preço e estoque podem ter política própria;
- pedido externo é armazenado e convertido uma vez;
- venda local dispara sincronização dos canais;
- cancelamento externo não estorna automaticamente operação irreversível; abre tratamento quando necessário;
- reconciliação periódica corrige eventos perdidos;
- falhas aparecem em central com reprocessamento seguro.

## Fiscal

- emissão somente a partir de documento confirmado e snapshot;
- validação prévia separa erro cadastral, tributário, certificado, schema e SEFAZ;
- autorização é assíncrona;
- chave, protocolo e XML autorizados imutáveis;
- contingência somente em fase e regra aprovadas;
- ambiente de homologação visualmente destacado;
- cancelamento exige justificativa, permissão e prazo válido.

## Relatórios

Consultas operacionais podem ser síncronas. Relatórios grandes são jobs, geram arquivo privado e expiram. Todo relatório mostra filtros, empresa(s), data/hora e usuário. Valores consolidados permitem detalhar até a origem.