2.4 KiB
2.4 KiB
NEXT_FISCAL_FIELD_IMPLEMENTATION_V1
Mechanical ordering: (1) ERP mapping confirmed, (2) required context available, (3) official rule available, (4) potential products, (5) history validation exists. Source: docs/ERP_FISCAL_FIELD_MAP_V1.json, docs/FISCAL_CONTEXT_REQUIREMENTS_V1.json, docs/FISCAL_CONTEXT_COVERAGE_V1.json.
| FIELD | ERP_MAPPING | CONTEXT_AVAILABLE | RULE_AVAILABLE | POTENTIAL_PRODUCTS | HISTORICAL_VALIDATION | NEXT_ACTION |
|---|---|---|---|---|---|---|
| IPI | CONFIRMED | YES | YES | 107 | n/a in NFC-e items (no IPI column) | Maintain; add NT/blank policy decision. |
| EX_TIPI | CONFIRMED | YES | YES | 71 | none | Description-evidence rule already in engine; review queue only. |
| NCM | CONFIRMED | YES | YES | 26 | identity drift: 57% of NFC-e NCMs differ from current product NCM | Investigate product-code reuse before trusting history; keep review-only. |
| CEST | CONFIRMED | YES | YES | 15 | 1231/1240 product==emitted; 1/15 candidates history-supported | Use NFC-e history as EVIDENCE to narrow candidates; write only single defensible matches. |
| CFOP | CONFIRMED | NO | NO | 521 | 1231/1241 product default==emitted | Model NFC-e sale context (saída, intra-UF, consumidor final) and define an official-table-backed rule; validate vs NFCE_ITENS. |
| CSOSN | CONFIRMED | NO | NO | 521 | 1179/1241 product default==emitted | Need ST-retention context; build shadow rule (CRT=1 + ST applicability) and score against NFCE_ITENS. |
| CST_ICMS | CONFIRMED | NO | NO | 521 | 1241/1241 product==emitted | Not needed while CRT=1; keep as validated default. |
| MVA | NO_PRODUCT_FIELD | NO | YES | 31 | none (MARGEM_AGREGADA unused) | Decide with vendor whether MARGEM_AGREGADA is honoured by the emitter before any write. |
| PIS_COFINS_CST | UNCONFIRMED | NO | NO | 521 | NFC-e always '01'/blank, rates 0 | Needs vendor confirmation of which field feeds CST_PIS_COFINS (not C000025.COD_SAIDA_*). |
| ORIGEM | UNCONFIRMED | NO | NO | 521 | CST digit 1 consistent (0) | Vendor confirmation of COD_ORIGEM_MERCADORIA usage; obtain objective origin. |
| FCP | n/a (no product field) | NO | NO | 521 | none | Needs FCP item list per UF; document-level only. |
| RTC | n/a (no ERP field) | NO | NO | 521 | none | Needs NCM→LC 214 annex mapping dataset; then document-level. |
Caveat: NFC-e history joins by CODPRODUTO show identity drift (item NCM != product NCM on 57% of items); trust only identity-consistent joins.