Cadastros mestres
Pessoas, produtos, condições de pagamento e tipos de movimento — a base que compras, estoque, venda e financeiro leem.
Sem cadastro mestre o ciclo não fecha. Pedido, NF e título apontam para estas entidades; não as recriam.
Pessoas
Cliente e fornecedor são cadastros distintos. O mesmo CNPJ pode existir nos dois papéis.
| Papel | Tabela | Tela típica | Usado em |
|---|---|---|---|
| Cliente | cadastro de customers | vendas / pessoas | pedido, NF-e 55, CR |
| Fornecedor | FAW01 | compras / pessoas | pedido de compra, NF entrada, CP |
| Vendedor | FAT000 | cadastro de vendedores | pedido, comissão, dashboards |
Código de fornecedor é sequência por filial, gerado no create. Documento (CPF/CNPJ) é único entre ativos; soft-deleted não bloqueia reuso.
Destinatário da NF-e 55 precisa de cadastro fiscal com IBGE. Consumidor / sem CPF-CNPJ / sem município → a API recusa assinar (NEED_FISCAL_CUSTOMER). NFC-e 65 omite destinatário.
Produto (FAPOA)
A 1ª unidade de medida é a unidade do saldo. Entrada de NF converte qCom da nota para essa UM.
| Campo | Função |
|---|---|
code | único por empresa |
type | MP PI PA ME BN SC MC |
unitOfMeasurement | UM do razão |
ncm / cfop / cest | matching da regra fiscal |
salePrice | preço de cadastro (PDV / pedido) |
lastPrice | última compra — não usar para vender |
lotControl / serialControl / expirationControl | rastreio; ver Produção e lotes |
conversionFactor + conversionType | M multiplica, D divide na entrada |
Tela: cadastro de produtos. Categoria via GET /product-categories/:filialId.
Condição de pagamento
Determina quantas parcelas o título terá no faturamento (sobre o valor após crédito de carteira) e no contas a pagar da NF de entrada. Também carrega snapshot de juros/multa/carência para o título.
Tipo de movimento
Liga a natureza do estoque (entrada/saída) ao fiscal e ao financeiro. O faturamento aceita movimentTypeCode no DTO; a OP e a NF de entrada usam origens próprias (PRODUCTION, ENTRY_DOCUMENT).
Configuração da filial
Parâmetros em Configurações (módulo 99): validar estoque na conversão de orçamento, numeração de documentos, certificado A1 por filial (FACE01 — CNPJ do certificado deve bater com a filial).