Documento de entrada

Dúvida: como receber a NF de compra?

Ambiente: /apps/entry-document (também no menu Documentos). Origem MANUAL ou NFE_IMPORTADA. Chave de 44 dígitos única por filial. Tabela FAR01 / itens FAC011.

Pré-requisitos: fornecedor, SKU interno, armazém, fator de UM se uCom ≠ 1ª UM do produto. Recorte de saldo: entrada e o estoque.

Do XML ao saldo

1. Staging SEFAZ (FAR03 / /apps/nfe-entrada) ou upload POST /entry-document/nfe/stage-xml.
2. Vínculo fornecedor → produto (FAW02) — código do emitente vs SKU interno.
3. Conversão de UM (saldo sempre na 1ª UM do produto).
4. Revisão na tela /apps/entry-document (não importa estoque sem revisão).
5. POST /entry-document/confirm/:id — transação única.

Confirmado gera: movimento FAPOB origem ENTRY_DOCUMENT, camada FIFO FACL01, parcelas AP (FAR02 e/ou FAB012), flags financial_generated / accounted. Com lotControl e flag industrial.lot-enforcement, cria/incrementa FALOT01 e grava lot_id no razão.

Conversão de unidade

qtyEstoque = qCom × fator
custoUnitEstoque = vUnCom / fator

Prioridade do fator por item:

1. Override digitado (itemConversions[])
2. FAW02.conversionFactor ≠ 1
3. Fator do produto (M/D), se uCom = 2ª UM
4. Conversão física conhecida (TN → KG = 1000)
5. Fallback 1 + alerta

Aliases: TON/TONELADA → TN, UNID → UN, M² → M2.

Manifestação do destinatário

Fila MDE: ciência / confirmação. manifestStatus no FAR01: PENDENTE | CIENCIA | CONFIRMADA.

Lote na entrada

Campos de item: nLote / lotCode, dVal / expirationDate. Sem lotControl no SKU a flag industrial não altera a linha.

Quarentena na entrada só com industrial.quality.inbound-quarantine. Senão o lote nasce ACTIVE. Detalhe: operação industrial.

IP fiscal

IP.FISCAL.ENTRY.BEFORE_CLASSIFY (wired, canDeny=false) — observa classificação. Não substitui regra FAY006.

Exemplo de conferência (HML, caso pão)

NF 8102511432, 1 000 kg, lote FAR-260828-A, depósito 001. Depois da confirmação o FEFO enxergava 1 000 kg; o ATP, a partir da API 1.0.169, segue o mesmo critério de lote ACTIVE.