chore: establish project baseline

docs/AGENT_COMPANY_CONTEXT_RULES_V1.md

@@ -0,0 +1,32 @@
+# Agent company context rules V1
+
+Goal: identify ACTIVE_COMPANY, COMPANY_UF and COMPANY_CRT for each Agent installation deterministically and auditably. Read-only; no fiscal rule is created.
+
+## What the evidence proved (4 SGV databases, `docs/COMPANY_CONTEXT_RESOLUTION_V1.json`)
+- **Company identity:** `EMISSOR.EMITENTE_CNPJ` equals exactly one `C000004.CNPJ` in every database, and 100% of the emitted NFC-e access keys (model 65, cUF 29) carry that CNPJ. In RINCAO the other two C000004 rows (SP agro company, refrigeration company) have no emitted documents.
+- **Emission authority for CRT/UF/CNPJ = `EMISSOR`:** the emission programs (`GtiVendas_NFCe.exe`, `Envio NF-e.exe`) bind `QrEmissor.EMITENTE_CRT/EMITENTE_UF/EMITENTE_CNPJ` and never reference `C000004.CRT` or `OPTANTE_SIMPLES`. The ERP (`SGV`) binds `C000004.CRT` (`qrFilialCRT`, `QrSPEDFilialCRT`) and `OPTANTE_SIMPLES` for the filial registry/SPED. The CRT tag inside issued XML could not be read: `C000061.NFE_XML` and `XML_MES.XML` store file paths, not content.
+- **UF:** EMISSOR.EMITENTE_UF, C000004.UF and the cUF of emitted keys agree everywhere (`UF_SOURCE_CONFIRMED`).
+- **CRT:** agrees in CONSTRUCAO only. MMMODAS (EMISSOR 1 / C000004 2), RINCAO (3 / 1), UNIAO (1 / 3) are `CRT_SOURCE_CONFLICT`. OPTANTE_SIMPLES also disagrees with CRT in MMMODAS and UNIAO.
+
+## Resolution algorithm (`agent/src/gti_fiscal_agent/company_context.py`)
+1. **Company.** Configured `COMPANY_CODE`/`COMPANY_CNPJ` must identify exactly one C000004 row. Otherwise: one C000004 row → it; several rows → the single row whose CNPJ equals the single EMISSOR CNPJ; anything else → `CONFIG_REQUIRED`. First row / lowest code / latest row are never used.
+2. **Emitter cross-check.** EMISSOR must describe the selected company, else `CONFLICT` (also covers a configured company that is not the emitter).
+3. **Documents.** If NFC-e keys exist, some must carry the selected CNPJ (none → `CONFLICT`); other CNPJs are only a warning (`HISTORICAL_NFCE_KEYS_FROM_OTHER_CNPJ`, e.g. the test database).
+4. **UF.** EMISSOR, C000004 and document-key sources must agree; disagreement → `CONFLICT`, none → `UNRESOLVED`.
+5. **CRT.** EMISSOR and C000004 agree → `CRT_SOURCE_CONFIRMED`. They disagree → `CONFLICT` unless `COMPANY_CRT_SOURCE=EMISSOR|C000004` is configured (resolved, `CONFIGURED`, confidence MEDIUM, warning recorded). Single source → accepted with warning. None/invalid → `UNRESOLVED`. Recommendation from the evidence: `EMISSOR`.
+6. `OPTANTE_SIMPLES` incoherent with the CRT is reported as a warning, never used to decide.
+
+## Preflight
+`python agent/scripts/preflight_company_context.py [--database <FDB>]` prints `COMPANY_CONTEXT=PASS|FAIL`, company_code, masked CNPJ (first/last 2 digits), UF, CRT, source_of_truth, confidence, warnings, reasons; exit code 2 on FAIL. `run_agent_service.py` runs it at startup and aborts on FAIL. `read_company_context()` raises `CompanyContextError` on FAIL. It fails on: several companies without selection, configured CNPJ/code not found, CRT or UF undeterminable, emitter/selection divergence, unresolved CRT conflict.
+
+## Results without configuration
+| database | class | reason |
+|---|---|---|
+| CONSTRUCAO | AUTO_RESOLVED | single row, all sources agree |
+| MMMODAS | CONFLICT | CRT EMISSOR=1 vs C000004=2 |
+| RINCAO | CONFLICT | company resolved through EMISSOR CNPJ; CRT EMISSOR=3 vs C000004(row)=1 |
+| UNIAO | CONFLICT | CRT EMISSOR=1 vs C000004=3 |
+With `COMPANY_CRT_SOURCE=EMISSOR` the three resolve (`CONFIGURED`); a configured non-emitting company or an unknown CNPJ still fails (tested on RINCAO).
+
+## Minimal generic Agent requirement
+C000004 + C000025; `supports_ncm`, `supports_ipi`, `supports_cest`; a resolvable company context (this preflight PASS); the executor's live column type/length guard. Everything else is capability-based (`scripts/sgv_capabilities.py`); schema fingerprint equality is NOT required.

docs/AI_PROJECT_STATE.md

@@ -0,0 +1,375 @@
+# AI Project State
+
+## Current status
+
+`FISCAL_DATA_FOUNDATION_MOSTLY_COMPLETE`. Deploy/pilot work remains paused
+per the current mission's scope. The operator manually placed the 6 official
+files that were blocked by the Portal NF-e/SPED session gate into
+`sources/raw/bootstrap_v1/`; all 6 were identified by content (never by
+filename), hashed, parsed, validated, and promoted `ACTIVE` — no internet
+access was attempted or needed this pass. **15 fiscal domains are now
+`ACTIVE`**: NCM, TIPI_IPI, CEST, BA_ST_MVA, ORIGEM_MERCADORIA, CST_ICMS,
+CSOSN, CST_PIS, CST_COFINS (from the prior pass), plus **CFOP, FCP, ANP,
+NCM_UTRIB, RTC_BIOFUEL_INDEX, RTC_CCREDPRES** (new this pass) —
+**42,593 fiscal records persisted total**. 11 domains remain
+`MISSING_BOOTSTRAP_FILE` (ICMS monofásico, RTC cClassTrib, RTC alíquotas
+CBS, and all 8 PIS/COFINS Tabela 4.3.10–4.3.17 files) — no file for them
+exists locally; internet access was deliberately not attempted this
+session. See `docs/SOURCE_REGISTRY_V2.md`. Read-only coverage over all 521
+`TESTESOFICIAIS.FDB` products is in `docs/FISCAL_COVERAGE_FULL_V2.json`
+(supersedes `_V1.json`, kept for history). Zero Firebird writes this
+session (confirmed independently: `000026.IPI` still `3.25`, 109 non-null
+`IPI` rows unchanged).
+
+`PILOT_DEPLOYMENT_READY` (previous mission's state, unchanged this pass). The
+Hub (central/) + Agent (agent/) system is
+operational end-to-end via a real Job queue, deploy-ready via Docker
+Compose, and the Agent is installable as a Windows Service. Formal Agent
+registration exists (`central/scripts/register_agent.py`), each Agent has
+its own token, and write authorization for a real client installation now
+requires two explicit, independently-configured layers (path + schema
+fingerprint) rather than the dev-only hardcoded path alone. See
+`docs/OPERATIONS.md` for day-to-day commands and `docs/PILOT_DEPLOYMENT.md`
+for standing up a new environment end to end.
+
+Firebird discovery (Mission 00/01) remains read-only and unchanged; its
+sanitized evidence lives in `docs/SAMPLE_PRODUCTS_V1.json` and
+`docs/MISSION_01_REPORT.md`.
+
+## Architecture
+
+- **Hub** (`central/app`): FastAPI + PostgreSQL. Classifies NCM/CEST/TIPI/
+  BA_ST_MVA (`classification.py`), owns the Agent registry and Job queue
+  (`models.py`, `jobs.py`, `api.py`). Never touches Firebird, never stores
+  Firebird credentials.
+- **Agent** (`agent/src/gti_fiscal_agent`, `agent/scripts`): reads Firebird
+  read-only, calls the Hub's `/v1/classify/batch`, runs the IPI auto-apply
+  decision (`ipi_auto_apply.py`) through the shared pipeline
+  (`pipeline.py`), and — only when `FIREBIRD_WRITES=1` and the database
+  path is exactly the authorized disposable test file — writes via the
+  guarded executor (`scripts/firebird_write_executor.py`). Long-running
+  entrypoint: `agent/scripts/run_agent_service.py` (heartbeat + Job poll
+  loop). One-shot CLI variant kept for manual use:
+  `agent/scripts/run_agent_auto_apply.py`.
+- Local per-product audit: Agent's SQLite (`agent/agent_state.sqlite`,
+  table `ipi_write_log`). Central per-Job audit: Postgres `jobs.result_summary`.
+
+## Firebird write policy
+
+`TESTESOFICIAIS.FDB` is the only Firebird database ever authorized for
+writes in development (see `CLAUDE.md`). For a real pilot installation, two
+independent, explicitly-configured layers are both required before any
+write connection opens — never inferred from a filename or `.FDB` extension:
+`AUTHORIZED_WRITE_DATABASE_PATH` (must equal that installation's own
+`FIREBIRD_DATABASE_PATH`) and `EXPECTED_SCHEMA_FINGERPRINT` (must equal the
+live schema fingerprint that installation reports). Leaving either unset
+falls back to the dev-only constant, so a real client database is refused
+by default (`scripts/firebird_write_executor.py::assert_authorized_write_path`
+/ `assert_schema_fingerprint_authorized`, wired into
+`agent/scripts/run_agent_service.py::execute_job`). All other Firebird
+databases (including `Banco/GTI.FDB`, found but never opened) remain
+read-only. No real client database has been written to in any mission —
+every write so far targeted `TESTESOFICIAIS.FDB`.
+
+## Auto-apply scope
+
+Only `C000025.IPI`, only when the Hub's TIPI match is `rate_kind=NUMERIC`
+and unambiguous. Never CEST, EX_TIPI, CFOP, CST/CSOSN, PIS/COFINS, MVA, or
+non-numeric/blank/legacy-NCM cases — those remain measurement-only
+(`docs/DRY_RUN_PLAN_V4.json`, `docs/FULL_DATABASE_DRY_RUN_V1.json`).
+
+## E2E proof (2026-09-18)
+
+Real Job created via `POST /v1/jobs` (`REPROCESS_PRODUCTS`), claimed and
+executed by `run_agent_service.py` (not the manual batch script):
+manually-induced drift (`C000025.IPI` forced to NULL on product `000026`)
+was detected and auto-restored to `3.25`, verified independently in
+Firebird, `jobs.result_summary` on the Hub, and the Agent's local
+`ipi_write_log`. A second run against the same now-correct product
+produced `writes_attempted=0` (idempotent no-op). `REPROCESS_ALL` over all
+521 products completed with `writes_attempted=0` (everything already
+correct from the prior full-database batch). A job created with
+`FIREBIRD_WRITES=0` against a genuinely eligible drifted product completed
+with `writes_attempted=0` and the ERP value left untouched, with the
+would-be write logged locally. The database was left in its correct state.
+
+During this session Docker Desktop itself restarted mid-mission (external
+event, not induced); the Hub came back healthy on its own once Docker
+recovered, and all prior Job history was intact (Postgres volume
+persisted) — an incidental real-world confirmation of "Hub temporarily
+unavailable, Agent/data survive."
+
+## Pilot readiness proof (2026-09-18)
+
+Registered a real Agent via `central/scripts/register_agent.py` (found and
+fixed a `DetachedInstanceError` bug in the process: the script read ORM
+attributes after the session closed — fixed to capture plain values before
+closing, with a regression test that mirrors the real CLI's usage pattern).
+Ran the Agent under that fresh, individually-hashed token end to end:
+startup validation, heartbeat (visible via `GET /v1/agents/me`, correctly
+derives `ONLINE`), job creation → claim → `COMPLETED` with a real product,
+restart with SQLite/central history intact, and a live path-guard test
+(fake client path, `FIREBIRD_WRITES=1`, no explicit authorization) that
+failed closed before any Firebird connection attempt and reported the job
+`FAILED` with a sanitized error while the Agent kept running. Also
+restarted the Hub and Postgres containers independently mid-session and
+confirmed the Agent/Hub recovered and history persisted through both.
+
+Also fixed a Docker Compose bug introduced while making the Hub
+deploy-configurable: passing `DATABASE_URL` through from the shared root
+`.env` leaked the host-side (`localhost`-pointing) value into the
+container's network namespace, where `localhost` means the container
+itself, breaking Postgres connectivity. Removed that passthrough; the
+Hub's own `postgres:5432` default (from `central/app/config.py`) is used
+instead.
+
+## Fiscal data foundation (2026-09-18)
+
+`docs/SOURCE_REGISTRY_V2.md` is now the current source registry (`V1` kept
+for history). Summary:
+
+- **Preserved, re-verified**: NCM (15,156 entries, hash-verified as
+  unchanged — no internet available to re-fetch, so this is "verified
+  against local record" not "re-fetched"), TIPI_IPI (11,103 entries,
+  hash-verified byte-identical against the local xlsx), CEST (1,051
+  entries, preserved — no internet to re-fetch, no local raw copy to
+  hash-check against).
+- **Re-imported with updated provenance**: BA_ST_MVA — the local PDF's bytes
+  changed (new `raw_sha256`) but the parsed content is identical (303/303
+  records match exactly what was previously `ACTIVE`); promoted a new
+  dataset row pointing at the current file rather than leaving provenance
+  referencing a stale path.
+- **New this session**: `fiscal_code_entries` table (migration `0007`)
+  holding ORIGEM_MERCADORIA (9), CST_ICMS (11), CSOSN (10), CST_PIS (33),
+  CST_COFINS (33) — extracted directly from the official
+  `moc7-anexo-i-leiaute-e-rv.pdf` (Receita Federal/ENCAT), one shared
+  `Dataset` row (`kind=NFE_MOC_TABLES`). Parser:
+  `central/app/datasets/nfe_moc_tables.py`. Nothing invented: entries built
+  from a combined official phrase (CST ICMS 40/41/50; CSOSN
+  102/103/300/400) keep that phrasing rather than being split further than
+  the source itself supports; the 6 CST_COFINS codes not separately
+  captured from the PDF's COFINS section (a page-boundary text-extraction
+  artifact, not a semantic gap) are filled from the CST_PIS wording after
+  confirming character-for-character identical wording for every code both
+  extractors did capture — each such row is labeled
+  `metadata_json.mirrored_from = "CST_PIS"`.
+- **Second pass (bootstrap_v1 operator-supplied files, migrations `0008`/`0009`)**:
+  the operator placed 6 previously-blocked official files directly into
+  `sources/raw/bootstrap_v1/`. Each was identified by actual sheet
+  names/header rows (never by filename) and promoted `ACTIVE`:
+  **CFOP** (619 codes, Informe Técnico 2023.002, new dedicated
+  `cfop_entries` table with all 14 official columns including the RTC-era
+  `indExcIBSCBS`), **FCP** (27 UFs, `fcp_rates`), **ANP** (1031 `cProdANP`
+  codes — confirmed the official NF-e portal table genuinely has no
+  description column, not an omission — `anp_product_codes`),
+  **NCM_UTRIB** (10,516 rows, `ncm_utrib_entries`), **RTC_BIOFUEL_INDEX**
+  (23 rows, current + historical `pBioObrigatorio`, `rtc_biofuel_index_entries`),
+  **RTC_CCREDPRES** (13 codes, all 18 official LC 214/2025 fields preserved
+  — legal basis, CBS/IBS indicators, rates, vigências —
+  `rtc_cred_pres_entries`). Bug found mid-import: `cclass_nota_referenciada`
+  was `VARCHAR(16)` but some official rows carry free text there; widened
+  to `Text` in migration `0009` after a clean rollback (no orphan row, no
+  data loss). New read-only endpoints:
+  `GET /v1/reference/{cfop,ncm_utrib,anp,fcp}/{code}`.
+- **Still `MISSING_BOOTSTRAP_FILE`** (not `FAILED` — simply no file
+  provided, internet deliberately not attempted this session): ICMS
+  monofásico (combustíveis), RTC cClassTrib, RTC alíquotas CBS, and all 8
+  PIS/COFINS Tabela 4.3.10–4.3.17 files.
+- **Coverage matrix**: `docs/FISCAL_COVERAGE_FULL_V2.json` (supersedes
+  `_V1.json`), all 521 products in `TESTESOFICIAIS.FDB`, read-only (zero
+  Firebird writes). NCM 495 valid / 3 legacy / 23 invalid / 0 missing. IPI
+  107 numeric / 20 non-numeric / 297 source-blank / 71 ambiguous / 23
+  no-match. CEST: 462 matches, 0 confirmed (structural ambiguity,
+  unchanged), 15 candidates. BA_ST_MVA: 268 matches, 31 resolved, 237
+  candidates. **New**: CFOP match_found=498/521 (this product's own
+  `C000025.CFOP` value is an officially valid code); NCM_UTRIB
+  match_found=495/521 (tracks `ncm_valid` exactly, as expected). ANP/FCP/
+  RTC_CCREDPRES/RTC_BIOFUEL_INDEX are `DATA_AVAILABLE=true` but
+  `match_found=0` — stated explicitly as a data-shape fact (this grocery/
+  restaurant ERP has no ANP/fuel-product/UF join key on `C000025`), not a
+  gap or a bug. PIS/COFINS CST domain remains `DATA_AVAILABLE`,
+  `RULE_RESOLVED=0` for all products (same reason as before: no NCM-linked
+  determination table exists to acquire yet).
+
+## Safety counters (cumulative across missions)
+
+- `APPLICATION_DDL_DML_WRITES` against Firebird: only ever against
+  `TESTESOFICIAIS.FDB`, only `UPDATE C000025.IPI` / `UPDATE C000025.CEST`-class
+  statements via the guarded executor (CEST never actually written — no
+  `CEST_CONFIRMED` case existed with enough evidence).
+- `OTHER_DATABASES_ACCESSED = 0` (including `Banco/GTI.FDB`, never opened).
+- Postgres migrations: `0001`..`0009` applied (`0006` adds `jobs` table and
+  `agents` status/heartbeat columns; `0007` adds `fiscal_code_entries`;
+  `0008` adds `cfop_entries`/`fcp_rates`/`anp_product_codes`/
+  `ncm_utrib_entries`/`rtc_biofuel_index_entries`/`rtc_cred_pres_entries`;
+  `0009` widens `rtc_cred_pres_entries.cclass_nota_referenciada` to `Text`).
+- This session: `FIREBIRD_WRITES=0` throughout — zero writes, zero DML/DDL
+  against any Firebird database (only read-only SELECTs to build the
+  coverage matrix); independently re-verified after the session (`000026.IPI`
+  still `3.25`, 109 non-null `IPI` rows unchanged).
+- Total fiscal records persisted in Postgres across all domains: 42,593.
+
+## Threat model (Firebird discovery boundary, unchanged since Mission 00)
+
+The structured boundary protects normal callers against implementation mistakes,
+accidental unauthorized operations, arbitrary SQL exposed to normal
+callers, the wrong database, writes, procedures/UDFs, injection, and
+dependency shadowing. `TRUSTED_PROCESS = TRUE`: arbitrary Python already
+running in the same process, including deliberate introspection or monkey
+patching, is outside scope. No artificial cryptographic controls are added.
+
+## Known gaps / next steps
+
+- No "list all agents" or "disable agent" HTTP endpoint yet — disabling an
+  agent is a direct `agents.enabled` update via `DATABASE_URL` access (see
+  `docs/PILOT_DEPLOYMENT.md`'s "Rollback"). Fine for pilot scale; a small
+  admin surface is a natural follow-up once there's more than a couple of
+  installations.
+- The Windows Service wrapper (`agent/service/gti_agent_windows_service.py`)
+  was written and unit-verified (module imports cleanly, stop-flag mechanism
+  tested against `run_agent_service.run()`), but was **not** registered with
+  the Windows Service Control Manager on this machine — `sc.exe`/pywin32
+  `install` modifies system-wide service state, which this session treats as
+  outside what it does unprompted. An operator runs the documented
+  `install`/`start` commands themselves.
+- No auto-update mechanism (deliberately out of scope this round) — updates
+  are a manual stop/replace/start, documented in `docs/PILOT_DEPLOYMENT.md`.
+- CEST matching still cannot confirm any of the 5 known-ambiguous products
+  (structural NCM→multiple-CEST ambiguity in CONFAZ data, not a matcher bug
+  — see `docs/DRY_RUN_PLAN_V4.json`).
+- `NT_STATUS_FIELD` (how a TIPI "NT" marker should map to `C000025.CST_IPI`)
+  remains unmapped — no reliable ERP evidence found for it.
+- 11 fiscal domains are `MISSING_BOOTSTRAP_FILE` (not `FAILED` — no file was
+  ever provided for them): ICMS monofásico, RTC cClassTrib, RTC alíquotas
+  CBS, and all 8 PIS/COFINS Tabela 4.3.10–4.3.17 files. CFOP, FCP, ANP,
+  NCM×uTrib, RTC_CCREDPRES, RTC_BIOFUEL_INDEX — all previously `FAILED` —
+  are now `ACTIVE` (operator supplied the official files). See
+  `docs/SOURCE_REGISTRY_V2.md` for exact evidence and next steps.
+- PIS/COFINS: only the CST code domain (Tabela 4.3.3/4.3.4-equivalent) is
+  `ACTIVE`. The NCM-linked determination tables (SPED Guia Prático
+  EFD-Contribuições Tabelas 4.3.10–4.3.17: alíquotas diferenciadas,
+  monofásicas, ST, zero, isenção, sem incidência, suspensão) were not
+  acquired — no file provided, internet deliberately not attempted.
+- CST_ICMS/CSOSN/ORIGEM_MERCADORIA/CST_PIS/CST_COFINS are consultable
+  (`DatasetService.fiscal_codes(domain, code=None)`) but not yet wired into
+  `Classifier` — no per-product automatic determination exists for these
+  domains, by design (mission explicitly forbade inventing fiscal rules).
+
+## Git State
+
+No Git identity was configured and no Git configuration was modified this
+session.
+
+## Business scope (2026-09-19)
+Clients: restaurants, markets, clothing/retail, workshops, commerce. No fuel
+stations, no EFD-Contribuicoes. CORE_MVP still missing only RTC_CCLASSTRIB and
+RTC_CBS_RATES (`MISSING_BOOTSTRAP_FILE`, awaiting operator files; see
+SOURCE_REGISTRY_V2.md). ICMS_MONOPHASIC = OUT_OF_SCOPE_MVP; ANP and
+RTC_BIOFUEL_INDEX = ACTIVE_REFERENCE_ONLY; PIS_COFINS_4_3_10..17 =
+DEFERRED_BY_BUSINESS_SCOPE (not deploy blockers; existing support kept).
+FISCAL_COVERAGE_FULL_V3 to be generated once the two core domains are ACTIVE.
+
+## CORE MVP fiscal foundation COMPLETE (2026-09-19)
+RTC_CCLASSTRIB (164 cClassTrib + 18 CST) and RTC_CBS_RATES (2 rows) are ACTIVE
+(migration 0010, endpoints `/v1/reference/rtc_cclasstrib/{code}`,
+`/v1/reference/rtc_cbs_rate/{year}`). All 14 CORE domains ACTIVE; nothing CORE
+is missing. Total fiscal records 42,777. Coverage: `docs/FISCAL_COVERAGE_FULL_V3.json`
+(V2 kept for history). cClassTrib/cCredPres have no ERP join key → DATA_AVAILABLE
+only; no rule invented. Zero Firebird writes.
+
+## Fiscal Decision Engine V1 (2026-09-19)
+`central/app/fiscal_decision.py` (pure, `DECISION_ENGINE_VERSION=fiscal-decision-v1`, carried in every
+provenance) + `scripts/run_fiscal_decision_v1.py` (read-only over the 521 products; `--apply` writes only
+AUTO_APPLY_SAFE via the guarded executor). Artifacts: `docs/FISCAL_DECISION_MATRIX_V1.json` (per product/domain:
+current/proposed/status/reason/confidence/provenance/write_eligible + ERP field map),
+`docs/FISCAL_DECISION_COVERAGE_V1.json`, `docs/NEXT_FISCAL_AUTOMATION_PRIORITIES_V1.md`.
+Company context read live: UF=BA, CRT=1 (C000004). ERP mappings: 11 confirmed, 10 MAPPING_UNCONFIRMED
+(CFOP_ENTRADA, CST_ENTRADA, COD_*_PIS/COFINS, ALIQ_PIS/COFINS, CST_IPI, ORIGEM). Result: AUTO_APPLY_SAFE = 0
+(IPI already correct on all 107 numeric rows; CEST never single-confirmed; a lone EX row per NCM is NOT
+evidence for a product — needs description match). CFOP/CSOSN/CST/PIS/COFINS/FCP/RTC = OPERATION_CONTEXT_REQUIRED
+or unresolved; CBS 0.009 kept as reference only, never applied universally. No Hub classify change, so no
+classification_cache bump needed. Helper `scripts/audit_erp_fields.py` (read-only). New endpoint
+`GET /v1/reference/fiscal_codes/{domain}`. Zero Firebird writes this mission.
+
+## ERP Fiscal Context Discovery V1 (2026-09-19, read-only)
+Artifacts: `docs/ERP_FISCAL_FIELD_MAP_V1.json`, `FISCAL_CONTEXT_REQUIREMENTS_V1.json`, `FISCAL_CONTEXT_COVERAGE_V1.json`,
+`NEXT_FISCAL_FIELD_IMPLEMENTATION_V1.md`; raw evidence in `docs/runs/erp_*`. Scripts (all read-only):
+`discover_erp_schema.py`, `inspect_erp_table.py`, `analyze_erp_fiscal_history*.py`, `generate_erp_context_docs.py`.
+Key facts: NFCE_ITENS (34,946 emitted NFC-e items 2018-2026) + NFCE (1,502) are real fiscal history; C000030 = 590 naturezas
+(CFOP/TIPO 1 entrada,2 saída); C000001.IND_CFOP_* company defaults; C000004: UF=BA, CRT=1, OPTANTE_SIMPLES=S, ICMS_CSOSN=102.
+Vendor DDL/scripts under D:/PROJETOS/GTISISTEMAS/Diretorios (C000083 confirms CST = origem+CST 3 digits). C000025 CFOP/CST/CSOSN/CEST
+are product defaults (99%/100%/95%/99% equal to emitted on identity-consistent joins). CFOP_ENTRADA/CST_ENTRADA/ORIGEM/PIS/COFINS
+product fields are unused/legacy. MVA: NO_PRODUCT_FIELD proven (MARGEM_AGREGADA 0/521, unused in C000062). WARNING: NFC-e items
+show product identity drift (57% item NCM != current product NCM for same CODPRODUTO) — validate history only on consistent joins.
+GTI.FDB (Banco) was NOT opened. Zero Firebird writes.
+
+## Product Fiscal Defaults Engine V1 (2026-09-19)
+`central/app/product_defaults.py` (`product-defaults-v1`, pure) + `scripts/run_product_defaults_v1.py`,
+`reconcile_ncm_history.py`, `profile_erp_operations.py`. Findings: of 1,676 NFC-e NCM mismatches 1,661 are BAD_JOIN
+(97% of mismatches sit in 2022-12; CODPRODUTO does not identify the product there; 1,751 items have no product at all),
+4 TRUE_HISTORICAL_DIFFERENCE, 11 UNKNOWN, 0 technical bugs. Trusted corpus = 1,146 identity-proven items. All 1,499 keyed
+NFC-e are model 65 / UF 29 (BA): saída, intra-UF, consumidor final. CFOP: 222 consistent with ST status (already correct),
+29 ST conflicts (review; 15 of them the ERP actually emitted the current CFOP), 244 context required, 26 unresolved.
+CSOSN: never resolved (no ICMS-treatment or ST-retention source); blank CSOSN does NOT default to company 102 in emission
+(history emitted 101). CST = reference only (CRT=1). AUTO_APPLY_SAFE=0, writes 0, no auto-repair proof (no safe rule).
+Artifacts: PRODUCT_FISCAL_DEFAULTS_{MATRIX,DRY_RUN}_V1.json, NCM_HISTORICAL_RECONCILIATION_V1.json, ERP_OPERATION_PROFILES_V1.json,
+FISCAL_CONTEXT_REQUIREMENTS_V2.json, NEXT_FISCAL_FIELD_IMPLEMENTATION_V2.md. No Hub classify change => no cache bump.
+
+## ICMS Context Engine V1 (2026-09-19, read-only)
+`central/app/icms_context.py` (`icms-context-v1`, pure) + `scripts/run_icms_context_v1.py`. Purchase-side evidence is thin:
+only C000088 (12 items, ICMS_RETIDO='N', ST values 0 → 11 products WITHHELD_NOT_CONFIRMED, 0 CONFIRMED). Role evidence:
+C000025.TIPO (7 MATERIA-PRIMA=INPUT), PROD_COZINHA/RECEITA_INGREDIENTES/C000032.TIPO=COMPOSICAO (own production), purchase docs
+(resale); TIPO_ITEM/PRODUTO_SERVICO unused. ST: 0 confirmed (ERP CEST blank for 490/521 so no corroboration), 28 not applicable,
+268 candidates, 225 unknown. CSOSN V2: 0 resolved, 5 candidates, 490 context required, 26 unresolved (NCM); nothing auto-appliable.
+ST conflict audit (29): ERP_HISTORY_CONFLICT 14, DESCRIPTION_MISMATCH 8, MULTIPLE_CEST 4, BA_ST_RULE_CONFLICT 1, NO_EVIDENCE 2.
+Artifacts: ICMS_PRODUCT_CONTEXT_V1, ICMS_CONTEXT_COVERAGE_V1, CSOSN_DRY_RUN_V2, FISCAL_CONTEXT_REQUIREMENTS_V3, NEXT_FISCAL_FIELD_IMPLEMENTATION_V3.
+No Hub change => no cache bump. Zero Firebird writes.
+
+## SGV product-screen mapping (2026-09-19)
+Architecture rule (also in CLAUDE.md): GTI Fiscal writes ONLY the canonical product record C000025; transactional tables are
+evidence only (executor allowlist is C000025-only; tests enforce refusal for NFCE/NFCE_ITENS/C000032/C000061/C000062/C000088/INVENTARIO).
+Map: `docs/SGV_PRODUCT_FISCAL_UI_MAP_V1.json` (25 UI fields; 0 confirmed by UI diff yet; write_target=true for 6 by equivalent
+strong evidence: CLASSIFICACAO_FISCAL, CFOP, CST, CEST, IPI, EX_TIPI). UI oracle tooling: `scripts/sgv_product_snapshot.py before|diff`
+(read-only, ledger in docs/runs/sgv_ui_diff_ledger.json) + operator sheet `docs/SGV_UI_MAPPING_SESSION_V1.md`; regenerate the map with
+`scripts/generate_sgv_ui_map.py` after diffs. Company UF/CRT now read via `gti_fiscal_agent.firebird_reader.read_company_context`
+(fail-closed; runners no longer hardcode BA). Multi-DB read-only auditor: `python audit_firebird_database.py <FDB>`.
+
+## SGV UI mapping session tool (2026-09-19)
+`python scripts/map_product_ui_fields.py --product 001434` — interactive, read-only oracle: operator changes one field at a time in the
+SGV, tool diffs the full C000025 row, classifies DIRECT_BINDING / DERIVED/COUPLED_FIELD / AUTOMATIC_METADATA / AMBIGUOUS (never picks among
+several changed columns), persists `docs/SGV_PRODUCT_FISCAL_UI_DIFF_SESSION_V1.json` step by step (resumable, `--restart`), prints the
+original values to restore at the end. `python scripts/generate_sgv_ui_map.py` then rebuilds `docs/SGV_PRODUCT_FISCAL_UI_MAP_V1.json`
+(confirmed_by_ui_diff only for DIRECT_BINDING; a control bound to an unexpected column replaces the hypothesised one). Session pending.
+
+## SGV product screen mapped from the executable's DFM (2026-09-19)
+`scripts/extract_sgv_dfm_bindings.py <SGV.exe>` parses the Delphi binary DFM of `Tfrmproduto` (read-only): every fiscal control on
+the Config. Impostos / Estoque tabs is a data-aware control on `dsproduto2` -> `qrproduto` (`select * from c000025`) with an explicit
+DataField; label/control positions match the screenshots. Result in `docs/SGV_PRODUCT_FISCAL_UI_MAP_V1.json`: 23 UI controls,
+21 CONFIRMED_STRONG, 1 PROBABLE (origem: RadioGroup + hidden edit bound to COD_ORIGEM_MERCADORIA), 1 NO_MATCH (CSOSN description
+combo is not data-aware). Screen writes CFOP_ENTRADA/CST_ENTRADA/ORIGEM-code even though they are empty in the data. The T/I/N/S
+selector next to CEST is SITUACAO_TRIBUTARIA (S = Substituição Tributária = the ERP's own product ST flag; 0/521 products use S).
+Cálculo Preço tab controls (IPI/PIS/COFINS) bind to C000026 (price calc), not C000025. write_target = binding proven; the executor
+allowlist and the fiscal rule engines still decide what may actually be written (executor: C000025.IPI only).
+
+## Multi-database validation (2026-09-19, read-only, `Banco/*.FDB` git-ignored)
+4 copies audited: CONSTRUCAO (construction, 3,712 products, BA/CRT1), MMMODAS (apparel, 20,997, BA/CRT2), RINCAO (restaurant, 894, C000004 has 3 company rows -> ambiguous), UNIAO (market, 8,942, BA/CRT3). All expose C000004/C000025 with the 21 write-target columns and no type variation except UNIAO CEST VARCHAR(10) vs (7). One generic Agent is viable; needs company selector + CRT source of truth (C000004.CRT disagrees with EMISSOR.EMITENTE_CRT in 3 of 4) and capability detection (`scripts/sgv_capabilities.py`). Tools: `scripts/audit_multi_databases.py`, `run_multi_db_coverage.py` (in-container bulk classifier `bulk_classify_in_container.py`), `generate_multi_db_findings.py`. Artifacts: MULTI_DATABASE_{SCHEMA_AUDIT,FISCAL_COVERAGE,FIELD_COMPATIBILITY}_V1.json, MULTI_DATABASE_FINDINGS_V1.md. No auto-repair DB provided. Zero writes.
+
+## Company context resolution + cache fix (2026-09-19)
+`agent/src/gti_fiscal_agent/company_context.py`: deterministic ACTIVE_COMPANY/UF/CRT resolver (EMISSOR CNPJ ↔ C000004 CNPJ ↔ emitted NFC-e key CNPJ; CRT authority for emission = EMISSOR because the emitter executables bind QrEmissor.EMITENTE_*; C000004.CRT is the ERP/SPED filial registry). Never uses first row; config `COMPANY_CODE`/`COMPANY_CNPJ`/`COMPANY_CRT_SOURCE`; preflight `agent/scripts/preflight_company_context.py`, enforced at Agent startup; `read_company_context` fails closed. 4 databases: CONSTRUCAO AUTO_RESOLVED; MMMODAS/RINCAO/UNIAO CRT_SOURCE_CONFLICT (need COMPANY_CRT_SOURCE). Rules: `docs/AGENT_COMPANY_CONTEXT_RULES_V1.md`; evidence: COMPANY_CONTEXT_RESOLUTION_V1.json, MULTI_DATABASE_COMPANY_CONTEXT_V1.json.
+Hub `classification_cache` fixed: fingerprint (tenant + input + ENGINE_VERSION + dataset_versions()) is computed first and a HIT returns without running the Classifier (test: `central/tests/test_classification_cache.py`). Live benchmark (100 products): MISS 337 ms/product, HIT 15 ms/product, 100/100 hits, identical results. Fingerprint inputs unchanged, so existing cache entries stay valid and version bumps still invalidate naturally.
+
+## Release Candidate 1.0.0-rc1 (2026-09-19) — COMPLETE_LOCAL_RC
+Frozen: `release/VERSION`, `central/app/version.py` (`GET /version`), `release/RELEASE_MANIFEST.json` (versions + ACTIVE dataset hashes + migrations 0001..0010). See `docs/RELEASE_CANDIDATE_V1.md`.
+Architecture: Hub central (Docker Hub+PostgreSQL, `deploy/hub`) <-HTTPS- Agent Windows (`deploy/agent-windows`, service GTIFiscalAgent) -local read-only-> SGV Firebird. The Hub never accesses Firebird.
+Agent: `FISCAL_MODE` DRY_RUN|AUTO_APPLY (DRY_RUN = technically no writes), `COMPANY_CODE/COMPANY_CNPJ/COMPANY_CRT_SOURCE(AUTO|EMISSOR|C000004)`, `COMPANY_UF` explicit override only; single preflight `agent/scripts/preflight.py` (also enforced at service start); REPROCESS_ALL job result includes the coverage report + company context (`gti_fiscal_agent/coverage.py`, shared with multi-db tooling); `scripts/prove_zero_write.py` (DML counters + table digests). Packaging: `scripts/build_agent_package.py` (secret-scanned zip). Hub prod: `deploy/hub/docker-compose.prod.yml` (Postgres internal only), backup/restore, dataset seed export/import; `APP_ENV=production` refuses AGENT_DEV_TOKEN.
+Pilot profile: CONSTRUCAO (`pilot-construcao.env.example`); planned, not installed: MMMODAS/RINCAO/UNIAO with `COMPANY_CRT_SOURCE=EMISSOR`. No real host was accessed: a local simulation ran the Agent (registered agent, DRY_RUN) end-to-end on the CONSTRUCAO copy. Follow-up: memoize `dataset_versions()`.
+
+## Local Completion V1 (2026-09)
+- Contrato: `docs/FISCAL_FIELD_CONTRACT_V1.json` (23 campos, gerado por `scripts/generate_field_contract.py`); resolvedor puro `central/app/field_contract.py`.
+- Contexto do operador (fatos que o ERP não conhece): tabela `fiscal_context_entries` (migration 0011), `POST /v1/context/import`, `scripts/import_fiscal_context.py` (CSV/JSON). Hierarquia PRODUCT > GROUP > NCM > COMPANY.
+- Escrita: somente as 5 cópias descartáveis em `docs/LOCAL_WRITE_ALLOWLIST_V1.json` (caminho exato), só C000025, via `execute_guarded_product_update`.
+- Runner: `scripts/local_completion.py` (estado em `docs/runs/local_completion/`, git-ignored); relatórios: `scripts/local_completion_report.py`.
+- Resultado: 41.354 células corrigidas, 100% verificadas, 2ª passada 0 escritas; 255.643 células aguardam resposta (`docs/LOCAL_FISCAL_CONTEXT_QUESTIONS_V1.*`, 1.054 perguntas). Fontes externas pendentes: `docs/LOCAL_COMPLETION_MANUAL_FILES_V1.md`.
+
+## Local Completion V2 (2026-09-20)
+Audit outcome in `docs/LOCAL_COMPLETION_V2_REPORT.md`: origin rule invalid → rolled back (35,048); CFOP/IPPT weak-evidence writes rolled back; role no longer inferred from PROD_COZINHA alone; SPED 4.3.x dataset in `docs/sources/`; PIS/COFINS Simples rule from ERP emission evidence; questionnaire V2 (`docs/LOCAL_FISCAL_CONTEXT_QUESTIONS_V2.*`). Rollback tool: `scripts/rollback_field.py`; audit: `scripts/audit_local_writes.py`.

docs/BA_ST_MVA_REFRESH_DIFF_V1.json

@@ -0,0 +1,242 @@
+{
+ "old_records": 303,
+ "new_records": 302,
+ "items_added": [],
+ "items_removed": [
+  [
+   "11.5",
+   ""
+  ]
+ ],
+ "items_changed": [
+  {
+   "key": [
+    "1.0",
+    ""
+   ],
+   "old": [
+    [
+     "01.015.00",
+     "01.019.00",
+     "01.062.01",
+     "01.112.00",
+     "01.127.00",
+     "01.128.00",
+     "01.999.00",
+     "2018",
+     "24.540"
+    ],
+    "71,78%",
+    "64,90%"
+   ],
+   "new": [
+    [
+     "01.015.00",
+     "01.019.00",
+     "01.062.01",
+     "01.112.00",
+     "01.127.00",
+     "01.128.00",
+     "01.999.00",
+     "2018"
+    ],
+    "71,78%",
+    "64,90%"
+   ]
+  },
+  {
+   "key": [
+    "10.7",
+    "16.008.00"
+   ],
+   "old": [
+    [
+     "10.7",
+     "10.7",
+     "16.009.00",
+     "4013"
+    ],
+    "45%",
+    "75,09%"
+   ],
+   "new": [
+    [
+     "10.7",
+     "16.009.00",
+     "4013"
+    ],
+    "45%",
+    "75,09%"
+   ]
+  },
+  {
+   "key": [
+    "15.1",
+    "23.001.00"
+   ],
+   "old": [
+    [
+     "15.1",
+     "15.1",
+     "2105",
+     "2105",
+     "23.001.00"
+    ],
+    "70%",
+    "105,28%"
+   ],
+   "new": [
+    [
+     "15.1",
+     "15.1",
+     "15.1",
+     "15.1",
+     "2105"
+    ],
+    "70%",
+    "105,28%"
+   ]
+  },
+  {
+   "key": [
+    "17.046.10",
+    ""
+   ],
+   "old": [
+    [
+     "17.046.15"
+    ],
+    "77,37%",
+    "77,37%"
+   ],
+   "new": [
+    [
+     "1001",
+     "11.5",
+     "17.046.15"
+    ],
+    "95,12%",
+    "77,37%"
+   ]
+  },
+  {
+   "key": [
+    "8.34",
+    "10.034.00"
+   ],
+   "old": [
+    [
+     "10.034.00",
+     "24.540",
+     "7004",
+     "7004"
+    ],
+    "101%",
+    "142,72%"
+   ],
+   "new": [
+    [
+     "7004"
+    ],
+    "101%",
+    "142,72%"
+   ]
+  },
+  {
+   "key": [
+    "8.37",
+    "10.037.00"
+   ],
+   "old": [
+    [
+     "7007.29"
+    ],
+    "45%",
+    "75,09%"
+   ],
+   "new": [
+    [
+     "10.037.00",
+     "24.540",
+     "7007.29",
+     "7007.29"
+    ],
+    "45%",
+    "75,09%"
+   ]
+  },
+  {
+   "key": [
+    "8.38",
+    "10.038.00"
+   ],
+   "old": [
+    [
+     "10.038.00",
+     "24.540",
+     "7008",
+     "7008"
+    ],
+    "45%",
+    "75,09%"
+   ],
+   "new": [
+    [
+     "7008"
+    ],
+    "45%",
+    "75,09%"
+   ]
+  },
+  {
+   "key": [
+    "8.80",
+    "10.080.00"
+   ],
+   "old": [
+    [
+     "24.540",
+     "7009"
+    ],
+    "45%",
+    "75,09%"
+   ],
+   "new": [
+    [
+     "10.080.00",
+     "24.540",
+     "7009",
+     "7009"
+    ],
+    "45%",
+    "75,09%"
+   ]
+  }
+ ],
+ "items_changed_count": 8,
+ "ncm_prefixes_no_longer_listed": [],
+ "ncm_prefixes_newly_listed": [],
+ "affected_products_by_database": {
+  "CONSTRUCAO": {
+   "products": 0,
+   "examples": []
+  },
+  "MMMODAS": {
+   "products": 0,
+   "examples": []
+  },
+  "RINCAO": {
+   "products": 0,
+   "examples": []
+  },
+  "UNIAO": {
+   "products": 0,
+   "examples": []
+  },
+  "TESTESOFICIAIS": {
+   "products": 0,
+   "examples": []
+  }
+ },
+ "note": "No dataset was modified; the Hub still serves the ACTIVE BA_ST_MVA (sha e07e9085...). The candidate PDF is versioned under sources/raw/bootstrap_v1/."
+}

docs/COMPANY_CONTEXT_RESOLUTION_V1.json

@@ -0,0 +1,217 @@
+{
+ "artifact": "COMPANY_CONTEXT_RESOLUTION_V1",
+ "firebird_writes": 0,
+ "authority": {
+  "CRT": {
+   "emission_authority": "EMISSOR.EMITENTE_CRT",
+   "evidence": [
+    "GtiVendas_NFCe.exe (NFC-e) and Envio NF-e.exe (NF-e) bind QrEmissor.EMITENTE_CRT/EMITENTE_UF/EMITENTE_CNPJ and never reference C000004.CRT or OPTANTE_SIMPLES",
+    "SGV_5.0.6.124.exe (ERP) binds C000004.CRT (qrFilialCRT/QrSPEDFilialCRT) and OPTANTE_SIMPLES for the filial registry/SPED and has no EMITENTE_* binding",
+    "emitted XML is not stored in the database (C000061.NFE_XML and XML_MES.XML hold file paths), so the CRT tag of issued documents could not be read directly"
+   ],
+   "status": "CRT_SOURCE_CONFLICT where the two values differ; the resolver refuses to choose without COMPANY_CRT_SOURCE"
+  },
+  "UF": {
+   "status": "UF_SOURCE_CONFIRMED",
+   "evidence": "EMISSOR.EMITENTE_UF, C000004.UF and the cUF of 100% of emitted NFC-e keys agree in all 4 databases"
+  },
+  "COMPANY": {
+   "status": "confirmed",
+   "evidence": "EMISSOR.EMITENTE_CNPJ equals exactly one C000004 CNPJ in every database and 100% of emitted NFC-e keys carry that CNPJ; other C000004 rows (RINCAO) have no documents"
+  }
+ },
+ "databases": {
+  "CONSTRUCAO": {
+   "c000004_rows": 1,
+   "emissor_rows": 1,
+   "companies": [
+    {
+     "C000004_CODE": "000001",
+     "CNPJ": "45**********90",
+     "CNPJ_FINGERPRINT": "2d8e45d5",
+     "UF_C000004": "BA",
+     "CRT_C000004": "1",
+     "OPTANTE_SIMPLES": "S",
+     "EMISSOR_ID": 1,
+     "UF_EMISSOR": "BA",
+     "CRT_EMISSOR": "1",
+     "DOCUMENT_COUNT": {
+      "nfce_keys_with_this_cnpj": 24414,
+      "nf_C000061_with_this_CODFILIAL": 115
+     },
+     "IS_ACTIVE_CANDIDATE": true,
+     "EVIDENCE": [
+      "EMISSOR.EMITENTE_CNPJ equals this CNPJ",
+      "24414 emitted NFC-e keys carry this CNPJ",
+      "115 NF-e rows use CODFILIAL=000001"
+     ]
+    }
+   ],
+   "nfce_key_groups": [
+    {
+     "cUF": "29",
+     "cnpj": "45**********90",
+     "model": "65",
+     "n": 24414
+    }
+   ],
+   "nf_by_filial": {
+    "000001": 115
+   }
+  },
+  "MMMODAS": {
+   "c000004_rows": 1,
+   "emissor_rows": 1,
+   "companies": [
+    {
+     "C000004_CODE": "000001",
+     "CNPJ": "01**********19",
+     "CNPJ_FINGERPRINT": "b89a9205",
+     "UF_C000004": "BA",
+     "CRT_C000004": "2",
+     "OPTANTE_SIMPLES": "N",
+     "EMISSOR_ID": 1,
+     "UF_EMISSOR": "BA",
+     "CRT_EMISSOR": "1",
+     "DOCUMENT_COUNT": {
+      "nfce_keys_with_this_cnpj": 36287,
+      "nf_C000061_with_this_CODFILIAL": 26
+     },
+     "IS_ACTIVE_CANDIDATE": true,
+     "EVIDENCE": [
+      "EMISSOR.EMITENTE_CNPJ equals this CNPJ",
+      "36287 emitted NFC-e keys carry this CNPJ",
+      "26 NF-e rows use CODFILIAL=000001"
+     ]
+    }
+   ],
+   "nfce_key_groups": [
+    {
+     "cUF": "29",
+     "cnpj": "01**********19",
+     "model": "65",
+     "n": 36287
+    }
+   ],
+   "nf_by_filial": {
+    "000001": 26
+   }
+  },
+  "RINCAO": {
+   "c000004_rows": 3,
+   "emissor_rows": 1,
+   "companies": [
+    {
+     "C000004_CODE": "000001",
+     "CNPJ": "09**********54",
+     "CNPJ_FINGERPRINT": "df6060d6",
+     "UF_C000004": "BA",
+     "CRT_C000004": "1",
+     "OPTANTE_SIMPLES": "S",
+     "EMISSOR_ID": 1,
+     "UF_EMISSOR": "BA",
+     "CRT_EMISSOR": "3",
+     "DOCUMENT_COUNT": {
+      "nfce_keys_with_this_cnpj": 173448,
+      "nf_C000061_with_this_CODFILIAL": 278
+     },
+     "IS_ACTIVE_CANDIDATE": true,
+     "EVIDENCE": [
+      "EMISSOR.EMITENTE_CNPJ equals this CNPJ",
+      "173448 emitted NFC-e keys carry this CNPJ",
+      "278 NF-e rows use CODFILIAL=000001"
+     ]
+    },
+    {
+     "C000004_CODE": "000005",
+     "CNPJ": "13**********35",
+     "CNPJ_FINGERPRINT": "1bdef593",
+     "UF_C000004": "SP",
+     "CRT_C000004": null,
+     "OPTANTE_SIMPLES": "N",
+     "EMISSOR_ID": null,
+     "UF_EMISSOR": null,
+     "CRT_EMISSOR": null,
+     "DOCUMENT_COUNT": {
+      "nfce_keys_with_this_cnpj": 0,
+      "nf_C000061_with_this_CODFILIAL": 0
+     },
+     "IS_ACTIVE_CANDIDATE": false,
+     "EVIDENCE": [
+      "no EMISSOR row with this CNPJ",
+      "no emitted NFC-e key carries this CNPJ"
+     ]
+    },
+    {
+     "C000004_CODE": "000007",
+     "CNPJ": "15**********87",
+     "CNPJ_FINGERPRINT": "862a9c31",
+     "UF_C000004": "BA",
+     "CRT_C000004": null,
+     "OPTANTE_SIMPLES": "N",
+     "EMISSOR_ID": null,
+     "UF_EMISSOR": null,
+     "CRT_EMISSOR": null,
+     "DOCUMENT_COUNT": {
+      "nfce_keys_with_this_cnpj": 0,
+      "nf_C000061_with_this_CODFILIAL": 0
+     },
+     "IS_ACTIVE_CANDIDATE": false,
+     "EVIDENCE": [
+      "no EMISSOR row with this CNPJ",
+      "no emitted NFC-e key carries this CNPJ"
+     ]
+    }
+   ],
+   "nfce_key_groups": [
+    {
+     "cUF": "29",
+     "cnpj": "09**********54",
+     "model": "65",
+     "n": 173448
+    }
+   ],
+   "nf_by_filial": {
+    "000001": 278
+   }
+  },
+  "UNIAO": {
+   "c000004_rows": 1,
+   "emissor_rows": 1,
+   "companies": [
+    {
+     "C000004_CODE": "000001",
+     "CNPJ": "09**********05",
+     "CNPJ_FINGERPRINT": "ded0967a",
+     "UF_C000004": "BA",
+     "CRT_C000004": "3",
+     "OPTANTE_SIMPLES": "S",
+     "EMISSOR_ID": 1,
+     "UF_EMISSOR": "BA",
+     "CRT_EMISSOR": "1",
+     "DOCUMENT_COUNT": {
+      "nfce_keys_with_this_cnpj": 48826,
+      "nf_C000061_with_this_CODFILIAL": 82
+     },
+     "IS_ACTIVE_CANDIDATE": true,
+     "EVIDENCE": [
+      "EMISSOR.EMITENTE_CNPJ equals this CNPJ",
+      "48826 emitted NFC-e keys carry this CNPJ",
+      "82 NF-e rows use CODFILIAL=000001"
+     ]
+    }
+   ],
+   "nfce_key_groups": [
+    {
+     "cUF": "29",
+     "cnpj": "09**********05",
+     "model": "65",
+     "n": 48826
+    }
+   ],
+   "nf_by_filial": {
+    "000001": 82
+   }
+  }
+ }
+}

docs/CSOSN_DRY_RUN_V2.json

@@ -0,0 +1,14 @@
+{
+ "artifact": "CSOSN_DRY_RUN_V2",
+ "firebird_writes": 0,
+ "CSOSN_AUTO_APPLY_SAFE": 0,
+ "CSOSN_ALREADY_CORRECT": 0,
+ "CSOSN_CHANGE_REQUIRED": 0,
+ "would_change": [],
+ "states": {
+  "CSOSN_CONTEXT_REQUIRED": 490,
+  "CSOSN_CANDIDATE": 5,
+  "CSOSN_UNRESOLVED": 26
+ },
+ "note": "No CSOSN proposal is write-eligible; readiness requires proven ST, withholding, role and ICMS treatment."
+}

docs/DATABASE_DISCOVERY.md

@@ -0,0 +1,44 @@
+# Firebird Database Discovery
+
+## Status and evidence boundary
+
+**Status:** `MISSION_00_BLOCKED`.
+
+Mission 00F passed the provenance gate, connected read-only with operator-
+provided process credentials, and collected live catalog metadata. Optional
+Firebird 2.5 catalogs for packages, procedure parameters, and monitoring were
+unavailable; no write query was made.
+
+The only authorized target is identified by the authorized-database label. No
+other database was accessed. No live engine facts or schema findings are
+available from this run.
+
+## Required safety counters
+
+- `APPLICATION_DDL_DML_WRITES = 0`
+- `OTHER_DATABASES_ACCESSED = 0`
+- `ERP_FILES_MODIFIED = 0`
+- `CONNECTION_ATTEMPTS = 2`
+
+The credentials were not logged, stored, or obtained from external ERP files.
+No ERP file, service, or configuration was modified.
+
+## Offline boundary
+
+The project contains a closed, named-operation `FirebirdCatalog` boundary with
+driver-level read-only proof and catalog-issued bounded sampling. Its metadata
+collector redacts sensitive and binary values, and procedures are metadata-only.
+These properties are covered by offline tests; they are not live database
+evidence.
+
+## Blocker and next step
+
+`MISSION_00_BLOCKED: discovery_incomplete`. Complete product correlation and
+reference fingerprint validation before declaring the mission complete.
+Do not guess credentials or use another database. Until complete collection
+succeeds, the schema classification is `SCHEMA_UNKNOWN`.
+
+## Git State
+
+`GIT_IDENTITY_NOT_CONFIGURED`. No Git identity was configured and no Git
+configuration was modified.

docs/DRY_RUN_PLAN_V1.json

@@ -0,0 +1,744 @@
+{
+  "artifact": "DRY_RUN_PLAN_V1",
+  "firebird_writes": 0,
+  "products_planned": 20,
+  "field_proposals": [
+    {
+      "product_code": "000004",
+      "field": "ALIQ_IPI",
+      "current_value": null,
+      "proposed_value": "NT",
+      "status": "CURRENT_UNKNOWN",
+      "reason_code": "ERP_CURRENT_VALUE_UNKNOWN",
+      "source_dataset": "TIPI_IPI",
+      "source_version": "d155f1baafb4039dcb74f97bb5abc1aec69f6760da9bd3f94a90bd40b33a2e9a",
+      "provenance": {
+        "engine_version": "0.1.0",
+        "decision_version": "mission-02",
+        "request_fingerprint": "cb43da41b09827085e6e045664a1d221aeb3c5d7a9a667c3bbf47b6b91cd034e"
+      },
+      "write_eligible": false
+    },
+    {
+      "product_code": "000004",
+      "field": "CEST",
+      "current_value": "",
+      "proposed_value": null,
+      "status": "UNRESOLVED",
+      "reason_code": "NO_CEST_MAPPING_FOUND_FOR_NCM",
+      "source_dataset": "CEST",
+      "source_version": "d7fb7e8da0ace05123d35c13d04486b70440cfa7323f983d8fc2f2fcfd1d54d3",
+      "provenance": {
+        "engine_version": "0.1.0",
+        "decision_version": "mission-02",
+        "request_fingerprint": "cb43da41b09827085e6e045664a1d221aeb3c5d7a9a667c3bbf47b6b91cd034e"
+      },
+      "write_eligible": false
+    },
+    {
+      "product_code": "000005",
+      "field": "ALIQ_IPI",
+      "current_value": null,
+      "proposed_value": "NT",
+      "status": "CURRENT_UNKNOWN",
+      "reason_code": "ERP_CURRENT_VALUE_UNKNOWN",
+      "source_dataset": "TIPI_IPI",
+      "source_version": "d155f1baafb4039dcb74f97bb5abc1aec69f6760da9bd3f94a90bd40b33a2e9a",
+      "provenance": {
+        "engine_version": "0.1.0",
+        "decision_version": "mission-02",
+        "request_fingerprint": "3fc33193c2826d43a207bb87b9c3ddb4c74053910954e52932c82428f6c6fb0b"
+      },
+      "write_eligible": false
+    },
+    {
+      "product_code": "000005",
+      "field": "CEST",
+      "current_value": "",
+      "proposed_value": null,
+      "status": "UNRESOLVED",
+      "reason_code": "NO_CEST_MAPPING_FOUND_FOR_NCM",
+      "source_dataset": "CEST",
+      "source_version": "d7fb7e8da0ace05123d35c13d04486b70440cfa7323f983d8fc2f2fcfd1d54d3",
+      "provenance": {
+        "engine_version": "0.1.0",
+        "decision_version": "mission-02",
+        "request_fingerprint": "3fc33193c2826d43a207bb87b9c3ddb4c74053910954e52932c82428f6c6fb0b"
+      },
+      "write_eligible": false
+    },
+    {
+      "product_code": "000006",
+      "field": "ALIQ_IPI",
+      "current_value": null,
+      "proposed_value": "NT",
+      "status": "CURRENT_UNKNOWN",
+      "reason_code": "ERP_CURRENT_VALUE_UNKNOWN",
+      "source_dataset": "TIPI_IPI",
+      "source_version": "d155f1baafb4039dcb74f97bb5abc1aec69f6760da9bd3f94a90bd40b33a2e9a",
+      "provenance": {
+        "engine_version": "0.1.0",
+        "decision_version": "mission-02",
+        "request_fingerprint": "b1cde9a0fe5414d0f9a4cbedaf353809e449978b0766c584eeeeb9ba2acf7fbb"
+      },
+      "write_eligible": false
+    },
+    {
+      "product_code": "000006",
+      "field": "CEST",
+      "current_value": "",
+      "proposed_value": null,
+      "status": "UNRESOLVED",
+      "reason_code": "NO_CEST_MAPPING_FOUND_FOR_NCM",
+      "source_dataset": "CEST",
+      "source_version": "d7fb7e8da0ace05123d35c13d04486b70440cfa7323f983d8fc2f2fcfd1d54d3",
+      "provenance": {
+        "engine_version": "0.1.0",
+        "decision_version": "mission-02",
+        "request_fingerprint": "b1cde9a0fe5414d0f9a4cbedaf353809e449978b0766c584eeeeb9ba2acf7fbb"
+      },
+      "write_eligible": false
+    },
+    {
+      "product_code": "000008",
+      "field": "ALIQ_IPI",
+      "current_value": null,
+      "proposed_value": "NT",
+      "status": "CURRENT_UNKNOWN",
+      "reason_code": "ERP_CURRENT_VALUE_UNKNOWN",
+      "source_dataset": "TIPI_IPI",
+      "source_version": "d155f1baafb4039dcb74f97bb5abc1aec69f6760da9bd3f94a90bd40b33a2e9a",
+      "provenance": {
+        "engine_version": "0.1.0",
+        "decision_version": "mission-02",
+        "request_fingerprint": "e61590990546f3df1682cbdcbc63284a349077d509c19f27360bed8b0731d652"
+      },
+      "write_eligible": false
+    },
+    {
+      "product_code": "000008",
+      "field": "CEST",
+      "current_value": "",
+      "proposed_value": null,
+      "status": "UNRESOLVED",
+      "reason_code": "NO_CEST_MAPPING_FOUND_FOR_NCM",
+      "source_dataset": "CEST",
+      "source_version": "d7fb7e8da0ace05123d35c13d04486b70440cfa7323f983d8fc2f2fcfd1d54d3",
+      "provenance": {
+        "engine_version": "0.1.0",
+        "decision_version": "mission-02",
+        "request_fingerprint": "e61590990546f3df1682cbdcbc63284a349077d509c19f27360bed8b0731d652"
+      },
+      "write_eligible": false
+    },
+    {
+      "product_code": "000009",
+      "field": "ALIQ_IPI",
+      "current_value": null,
+      "proposed_value": "NT",
+      "status": "CURRENT_UNKNOWN",
+      "reason_code": "ERP_CURRENT_VALUE_UNKNOWN",
+      "source_dataset": "TIPI_IPI",
+      "source_version": "d155f1baafb4039dcb74f97bb5abc1aec69f6760da9bd3f94a90bd40b33a2e9a",
+      "provenance": {
+        "engine_version": "0.1.0",
+        "decision_version": "mission-02",
+        "request_fingerprint": "8f59f11aa591883ca082670a193e4abb935eb313f6a813d1d349d9255eb0ef3e"
+      },
+      "write_eligible": false
+    },
+    {
+      "product_code": "000009",
+      "field": "CEST",
+      "current_value": "",
+      "proposed_value": null,
+      "status": "UNRESOLVED",
+      "reason_code": "NO_CEST_MAPPING_FOUND_FOR_NCM",
+      "source_dataset": "CEST",
+      "source_version": "d7fb7e8da0ace05123d35c13d04486b70440cfa7323f983d8fc2f2fcfd1d54d3",
+      "provenance": {
+        "engine_version": "0.1.0",
+        "decision_version": "mission-02",
+        "request_fingerprint": "8f59f11aa591883ca082670a193e4abb935eb313f6a813d1d349d9255eb0ef3e"
+      },
+      "write_eligible": false
+    },
+    {
+      "product_code": "000010",
+      "field": "ALIQ_IPI",
+      "current_value": null,
+      "proposed_value": "NT",
+      "status": "CURRENT_UNKNOWN",
+      "reason_code": "ERP_CURRENT_VALUE_UNKNOWN",
+      "source_dataset": "TIPI_IPI",
+      "source_version": "d155f1baafb4039dcb74f97bb5abc1aec69f6760da9bd3f94a90bd40b33a2e9a",
+      "provenance": {
+        "engine_version": "0.1.0",
+        "decision_version": "mission-02",
+        "request_fingerprint": "08865c44ebc9b09141ee8fec4e3ebbb37144af22356dff383abea0a6d7229177"
+      },
+      "write_eligible": false
+    },
+    {
+      "product_code": "000010",
+      "field": "CEST",
+      "current_value": "",
+      "proposed_value": null,
+      "status": "UNRESOLVED",
+      "reason_code": "NO_CEST_MAPPING_FOUND_FOR_NCM",
+      "source_dataset": "CEST",
+      "source_version": "d7fb7e8da0ace05123d35c13d04486b70440cfa7323f983d8fc2f2fcfd1d54d3",
+      "provenance": {
+        "engine_version": "0.1.0",
+        "decision_version": "mission-02",
+        "request_fingerprint": "08865c44ebc9b09141ee8fec4e3ebbb37144af22356dff383abea0a6d7229177"
+      },
+      "write_eligible": false
+    },
+    {
+      "product_code": "000011",
+      "field": "ALIQ_IPI",
+      "current_value": null,
+      "proposed_value": "NT",
+      "status": "CURRENT_UNKNOWN",
+      "reason_code": "ERP_CURRENT_VALUE_UNKNOWN",
+      "source_dataset": "TIPI_IPI",
+      "source_version": "d155f1baafb4039dcb74f97bb5abc1aec69f6760da9bd3f94a90bd40b33a2e9a",
+      "provenance": {
+        "engine_version": "0.1.0",
+        "decision_version": "mission-02",
+        "request_fingerprint": "ec2513128224e31f969063ad1d32625ff8f0994e55a7192b14cf1d39acb136e6"
+      },
+      "write_eligible": false
+    },
+    {
+      "product_code": "000011",
+      "field": "CEST",
+      "current_value": "",
+      "proposed_value": null,
+      "status": "UNRESOLVED",
+      "reason_code": "NO_CEST_MAPPING_FOUND_FOR_NCM",
+      "source_dataset": "CEST",
+      "source_version": "d7fb7e8da0ace05123d35c13d04486b70440cfa7323f983d8fc2f2fcfd1d54d3",
+      "provenance": {
+        "engine_version": "0.1.0",
+        "decision_version": "mission-02",
+        "request_fingerprint": "ec2513128224e31f969063ad1d32625ff8f0994e55a7192b14cf1d39acb136e6"
+      },
+      "write_eligible": false
+    },
+    {
+      "product_code": "000013",
+      "field": "ALIQ_IPI",
+      "current_value": null,
+      "proposed_value": "NT",
+      "status": "CURRENT_UNKNOWN",
+      "reason_code": "ERP_CURRENT_VALUE_UNKNOWN",
+      "source_dataset": "TIPI_IPI",
+      "source_version": "d155f1baafb4039dcb74f97bb5abc1aec69f6760da9bd3f94a90bd40b33a2e9a",
+      "provenance": {
+        "engine_version": "0.1.0",
+        "decision_version": "mission-02",
+        "request_fingerprint": "d4b4da1deeab1f18411f7881c858b56b930f3c1035c4a27a7e8ef2870774e2bb"
+      },
+      "write_eligible": false
+    },
+    {
+      "product_code": "000013",
+      "field": "CEST",
+      "current_value": "",
+      "proposed_value": null,
+      "status": "UNRESOLVED",
+      "reason_code": "NO_CEST_MAPPING_FOUND_FOR_NCM",
+      "source_dataset": "CEST",
+      "source_version": "d7fb7e8da0ace05123d35c13d04486b70440cfa7323f983d8fc2f2fcfd1d54d3",
+      "provenance": {
+        "engine_version": "0.1.0",
+        "decision_version": "mission-02",
+        "request_fingerprint": "d4b4da1deeab1f18411f7881c858b56b930f3c1035c4a27a7e8ef2870774e2bb"
+      },
+      "write_eligible": false
+    },
+    {
+      "product_code": "000015",
+      "field": "ALIQ_IPI",
+      "current_value": null,
+      "proposed_value": "NT",
+      "status": "CURRENT_UNKNOWN",
+      "reason_code": "ERP_CURRENT_VALUE_UNKNOWN",
+      "source_dataset": "TIPI_IPI",
+      "source_version": "d155f1baafb4039dcb74f97bb5abc1aec69f6760da9bd3f94a90bd40b33a2e9a",
+      "provenance": {
+        "engine_version": "0.1.0",
+        "decision_version": "mission-02",
+        "request_fingerprint": "ba57a075cffa8b343c147518fe03e9a2721d067299991664ed63238aebbc26ed"
+      },
+      "write_eligible": false
+    },
+    {
+      "product_code": "000015",
+      "field": "CEST",
+      "current_value": "",
+      "proposed_value": null,
+      "status": "UNRESOLVED",
+      "reason_code": "NO_CEST_MAPPING_FOUND_FOR_NCM",
+      "source_dataset": "CEST",
+      "source_version": "d7fb7e8da0ace05123d35c13d04486b70440cfa7323f983d8fc2f2fcfd1d54d3",
+      "provenance": {
+        "engine_version": "0.1.0",
+        "decision_version": "mission-02",
+        "request_fingerprint": "ba57a075cffa8b343c147518fe03e9a2721d067299991664ed63238aebbc26ed"
+      },
+      "write_eligible": false
+    },
+    {
+      "product_code": "000016",
+      "field": "CLASSIFICACAO_FISCAL",
+      "current_value": "02071400",
+      "proposed_value": null,
+      "status": "LEGACY_NCM_REVIEW",
+      "reason_code": "LEGACY_NCM_NO_AUTOMATIC_SUCCESSOR",
+      "source_dataset": "NCM",
+      "source_version": "3abc0d2eb2501bbd0cc3f5e0ee3774d33f091ea305e8127ee020e4009878987e",
+      "provenance": {
+        "engine_version": "0.1.0",
+        "decision_version": "mission-02",
+        "request_fingerprint": "4d7c735bd3d78e902cd44679b3db445d1effe8f27a029b5379e743260cd5dfe3"
+      },
+      "write_eligible": false
+    },
+    {
+      "product_code": "000017",
+      "field": "CEST",
+      "current_value": "",
+      "proposed_value": null,
+      "status": "UNRESOLVED",
+      "reason_code": "NO_CEST_MAPPING_FOUND_FOR_NCM",
+      "source_dataset": "CEST",
+      "source_version": "d7fb7e8da0ace05123d35c13d04486b70440cfa7323f983d8fc2f2fcfd1d54d3",
+      "provenance": {
+        "engine_version": "0.1.0",
+        "decision_version": "mission-02",
+        "request_fingerprint": "21ca73685772908125fdb3e189d0bfcd51a77f3eed4e9a1bb7b2f6433881d379"
+      },
+      "write_eligible": false
+    },
+    {
+      "product_code": "000018",
+      "field": "CEST",
+      "current_value": "",
+      "proposed_value": null,
+      "status": "UNRESOLVED",
+      "reason_code": "CEST_DESCRIPTION_SCORE_BELOW_THRESHOLD",
+      "source_dataset": "CEST",
+      "source_version": "d7fb7e8da0ace05123d35c13d04486b70440cfa7323f983d8fc2f2fcfd1d54d3",
+      "provenance": {
+        "engine_version": "0.1.0",
+        "decision_version": "mission-02",
+        "request_fingerprint": "c00a786e4b3ce4aacbb1e47204292567af3dc49be4f497354607c66a8e1c7ad8"
+      },
+      "write_eligible": false
+    },
+    {
+      "product_code": "000019",
+      "field": "ALIQ_IPI",
+      "current_value": null,
+      "proposed_value": "NT",
+      "status": "CURRENT_UNKNOWN",
+      "reason_code": "ERP_CURRENT_VALUE_UNKNOWN",
+      "source_dataset": "TIPI_IPI",
+      "source_version": "d155f1baafb4039dcb74f97bb5abc1aec69f6760da9bd3f94a90bd40b33a2e9a",
+      "provenance": {
+        "engine_version": "0.1.0",
+        "decision_version": "mission-02",
+        "request_fingerprint": "ff26dfa9954d7a3fdccd8033d973ab01724498c1d59b735facdfdbf169a476a8"
+      },
+      "write_eligible": false
+    },
+    {
+      "product_code": "000019",
+      "field": "CEST",
+      "current_value": "",
+      "proposed_value": null,
+      "status": "UNRESOLVED",
+      "reason_code": "NO_CEST_MAPPING_FOUND_FOR_NCM",
+      "source_dataset": "CEST",
+      "source_version": "d7fb7e8da0ace05123d35c13d04486b70440cfa7323f983d8fc2f2fcfd1d54d3",
+      "provenance": {
+        "engine_version": "0.1.0",
+        "decision_version": "mission-02",
+        "request_fingerprint": "ff26dfa9954d7a3fdccd8033d973ab01724498c1d59b735facdfdbf169a476a8"
+      },
+      "write_eligible": false
+    },
+    {
+      "product_code": "000021",
+      "field": "ALIQ_IPI",
+      "current_value": null,
+      "proposed_value": "NT",
+      "status": "CURRENT_UNKNOWN",
+      "reason_code": "ERP_CURRENT_VALUE_UNKNOWN",
+      "source_dataset": "TIPI_IPI",
+      "source_version": "d155f1baafb4039dcb74f97bb5abc1aec69f6760da9bd3f94a90bd40b33a2e9a",
+      "provenance": {
+        "engine_version": "0.1.0",
+        "decision_version": "mission-02",
+        "request_fingerprint": "7611a454105cac1d31692c1d049da55a7a855871e021de7daf96385d45632d3b"
+      },
+      "write_eligible": false
+    },
+    {
+      "product_code": "000021",
+      "field": "CEST",
+      "current_value": "",
+      "proposed_value": null,
+      "status": "UNRESOLVED",
+      "reason_code": "NO_CEST_MAPPING_FOUND_FOR_NCM",
+      "source_dataset": "CEST",
+      "source_version": "d7fb7e8da0ace05123d35c13d04486b70440cfa7323f983d8fc2f2fcfd1d54d3",
+      "provenance": {
+        "engine_version": "0.1.0",
+        "decision_version": "mission-02",
+        "request_fingerprint": "7611a454105cac1d31692c1d049da55a7a855871e021de7daf96385d45632d3b"
+      },
+      "write_eligible": false
+    },
+    {
+      "product_code": "000022",
+      "field": "ALIQ_IPI",
+      "current_value": null,
+      "proposed_value": "NT",
+      "status": "CURRENT_UNKNOWN",
+      "reason_code": "ERP_CURRENT_VALUE_UNKNOWN",
+      "source_dataset": "TIPI_IPI",
+      "source_version": "d155f1baafb4039dcb74f97bb5abc1aec69f6760da9bd3f94a90bd40b33a2e9a",
+      "provenance": {
+        "engine_version": "0.1.0",
+        "decision_version": "mission-02",
+        "request_fingerprint": "50fb43fdcc45474cdebe44a317c7e8bd3a1695389774e13185d98c51311ab3e2"
+      },
+      "write_eligible": false
+    },
+    {
+      "product_code": "000022",
+      "field": "CEST",
+      "current_value": "",
+      "proposed_value": null,
+      "status": "UNRESOLVED",
+      "reason_code": "NO_CEST_MAPPING_FOUND_FOR_NCM",
+      "source_dataset": "CEST",
+      "source_version": "d7fb7e8da0ace05123d35c13d04486b70440cfa7323f983d8fc2f2fcfd1d54d3",
+      "provenance": {
+        "engine_version": "0.1.0",
+        "decision_version": "mission-02",
+        "request_fingerprint": "50fb43fdcc45474cdebe44a317c7e8bd3a1695389774e13185d98c51311ab3e2"
+      },
+      "write_eligible": false
+    },
+    {
+      "product_code": "000023",
+      "field": "CEST",
+      "current_value": "",
+      "proposed_value": null,
+      "status": "UNRESOLVED",
+      "reason_code": "CEST_DESCRIPTION_SCORE_BELOW_THRESHOLD",
+      "source_dataset": "CEST",
+      "source_version": "d7fb7e8da0ace05123d35c13d04486b70440cfa7323f983d8fc2f2fcfd1d54d3",
+      "provenance": {
+        "engine_version": "0.1.0",
+        "decision_version": "mission-02",
+        "request_fingerprint": "13af6da7090e28ade50bc1944469fcb3fdf03f298f78db905ecc234fdf7845c3"
+      },
+      "write_eligible": false
+    },
+    {
+      "product_code": "000024",
+      "field": "CEST",
+      "current_value": "",
+      "proposed_value": null,
+      "status": "UNRESOLVED",
+      "reason_code": "CEST_DESCRIPTION_SCORE_BELOW_THRESHOLD",
+      "source_dataset": "CEST",
+      "source_version": "d7fb7e8da0ace05123d35c13d04486b70440cfa7323f983d8fc2f2fcfd1d54d3",
+      "provenance": {
+        "engine_version": "0.1.0",
+        "decision_version": "mission-02",
+        "request_fingerprint": "0a8e6bedd4154e647b4e392dfb9138a6692e81d4f3d85495715c60a06644c0d5"
+      },
+      "write_eligible": false
+    },
+    {
+      "product_code": "000025",
+      "field": "CEST",
+      "current_value": "",
+      "proposed_value": null,
+      "status": "UNRESOLVED",
+      "reason_code": "CEST_DESCRIPTION_SCORE_BELOW_THRESHOLD",
+      "source_dataset": "CEST",
+      "source_version": "d7fb7e8da0ace05123d35c13d04486b70440cfa7323f983d8fc2f2fcfd1d54d3",
+      "provenance": {
+        "engine_version": "0.1.0",
+        "decision_version": "mission-02",
+        "request_fingerprint": "a0b43b77137825496b3032f2f8ee288b02cc854055beb59305ebc7b781f54e16"
+      },
+      "write_eligible": false
+    },
+    {
+      "product_code": "000026",
+      "field": "ALIQ_IPI",
+      "current_value": null,
+      "proposed_value": "3.25",
+      "status": "CURRENT_UNKNOWN",
+      "reason_code": "ERP_CURRENT_VALUE_UNKNOWN",
+      "source_dataset": "TIPI_IPI",
+      "source_version": "d155f1baafb4039dcb74f97bb5abc1aec69f6760da9bd3f94a90bd40b33a2e9a",
+      "provenance": {
+        "engine_version": "0.1.0",
+        "decision_version": "mission-02",
+        "request_fingerprint": "e401bf0f42be227a61f0121333707644b3e46f7f968c712dd6a2f040525e1e1a"
+      },
+      "write_eligible": false
+    },
+    {
+      "product_code": "000026",
+      "field": "CEST",
+      "current_value": "",
+      "proposed_value": null,
+      "status": "UNRESOLVED",
+      "reason_code": "NO_CEST_MAPPING_FOUND_FOR_NCM",
+      "source_dataset": "CEST",
+      "source_version": "d7fb7e8da0ace05123d35c13d04486b70440cfa7323f983d8fc2f2fcfd1d54d3",
+      "provenance": {
+        "engine_version": "0.1.0",
+        "decision_version": "mission-02",
+        "request_fingerprint": "e401bf0f42be227a61f0121333707644b3e46f7f968c712dd6a2f040525e1e1a"
+      },
+      "write_eligible": false
+    },
+    {
+      "product_code": "000027",
+      "field": "CEST",
+      "current_value": "",
+      "proposed_value": null,
+      "status": "UNRESOLVED",
+      "reason_code": "CEST_DESCRIPTION_SCORE_BELOW_THRESHOLD",
+      "source_dataset": "CEST",
+      "source_version": "d7fb7e8da0ace05123d35c13d04486b70440cfa7323f983d8fc2f2fcfd1d54d3",
+      "provenance": {
+        "engine_version": "0.1.0",
+        "decision_version": "mission-02",
+        "request_fingerprint": "f54f8cb9c5a9f118c1db4c2e91537a5b81c7c50b67698ad4776add27e2ce707a"
+      },
+      "write_eligible": false
+    }
+  ],
+  "mva_evidence": [
+    {
+      "product_code": "000004",
+      "ncm": "07069000",
+      "status": "NO_MVA_MAPPING_FOUND",
+      "resolved": null,
+      "candidates": [],
+      "source_version": "d85b9328a5532a55a9105c9ba419d14005a2f9cd79b65d40964e07d636b6ce7e"
+    },
+    {
+      "product_code": "000005",
+      "ncm": "07069000",
+      "status": "NO_MVA_MAPPING_FOUND",
+      "resolved": null,
+      "candidates": [],
+      "source_version": "d85b9328a5532a55a9105c9ba419d14005a2f9cd79b65d40964e07d636b6ce7e"
+    },
+    {
+      "product_code": "000006",
+      "ncm": "07069000",
+      "status": "NO_MVA_MAPPING_FOUND",
+      "resolved": null,
+      "candidates": [],
+      "source_version": "d85b9328a5532a55a9105c9ba419d14005a2f9cd79b65d40964e07d636b6ce7e"
+    },
+    {
+      "product_code": "000008",
+      "ncm": "07069000",
+      "status": "NO_MVA_MAPPING_FOUND",
+      "resolved": null,
+      "candidates": [],
+      "source_version": "d85b9328a5532a55a9105c9ba419d14005a2f9cd79b65d40964e07d636b6ce7e"
+    },
+    {
+      "product_code": "000009",
+      "ncm": "07069000",
+      "status": "NO_MVA_MAPPING_FOUND",
+      "resolved": null,
+      "candidates": [],
+      "source_version": "d85b9328a5532a55a9105c9ba419d14005a2f9cd79b65d40964e07d636b6ce7e"
+    },
+    {
+      "product_code": "000010",
+      "ncm": "07069000",
+      "status": "NO_MVA_MAPPING_FOUND",
+      "resolved": null,
+      "candidates": [],
+      "source_version": "d85b9328a5532a55a9105c9ba419d14005a2f9cd79b65d40964e07d636b6ce7e"
+    },
+    {
+      "product_code": "000011",
+      "ncm": "07069000",
+      "status": "NO_MVA_MAPPING_FOUND",
+      "resolved": null,
+      "candidates": [],
+      "source_version": "d85b9328a5532a55a9105c9ba419d14005a2f9cd79b65d40964e07d636b6ce7e"
+    },
+    {
+      "product_code": "000013",
+      "ncm": "07069000",
+      "status": "NO_MVA_MAPPING_FOUND",
+      "resolved": null,
+      "candidates": [],
+      "source_version": "d85b9328a5532a55a9105c9ba419d14005a2f9cd79b65d40964e07d636b6ce7e"
+    },
+    {
+      "product_code": "000015",
+      "ncm": "07133321",
+      "status": "NO_MVA_MAPPING_FOUND",
+      "resolved": null,
+      "candidates": [],
+      "source_version": "d85b9328a5532a55a9105c9ba419d14005a2f9cd79b65d40964e07d636b6ce7e"
+    },
+    {
+      "product_code": "000016",
+      "ncm": "02071400",
+      "status": "LEGACY_NCM",
+      "resolved": null,
+      "candidates": [],
+      "source_version": "d85b9328a5532a55a9105c9ba419d14005a2f9cd79b65d40964e07d636b6ce7e"
+    },
+    {
+      "product_code": "000017",
+      "ncm": "03061790",
+      "status": "NO_MVA_MAPPING_FOUND",
+      "resolved": null,
+      "candidates": [],
+      "source_version": "d85b9328a5532a55a9105c9ba419d14005a2f9cd79b65d40964e07d636b6ce7e"
+    },
+    {
+      "product_code": "000018",
+      "ncm": "02071100",
+      "status": "MVA_CANDIDATES",
+      "resolved": null,
+      "candidates": [
+        {
+          "item": "11.25.0",
+          "cest": "17.087.00",
+          "mva_original": "25%",
+          "mva_adjusted": "50,94%",
+          "description": ", , e Carnes e demais produtos comestíveis frescos, resfriados, congelados, salgados, em salmoura, simplesmente temperados, secos ou defumados, resultantes do abate de aves, exceto os descritos no CEST Não tem (Alíq. ) (Alíq. ) (Alíq. )"
+        },
+        {
+          "item": "11.25.2",
+          "cest": "17.087.02",
+          "mva_original": "25%",
+          "mva_adjusted": "50,94%",
+          "description": "e Carnes de aves inteiras com peso unitário superior a 3Kg, temperadas Não tem (Alíq. ) (Alíq. ) (Alíq. )"
+        }
+      ],
+      "source_version": "d85b9328a5532a55a9105c9ba419d14005a2f9cd79b65d40964e07d636b6ce7e"
+    },
+    {
+      "product_code": "000019",
+      "ncm": "07133321",
+      "status": "NO_MVA_MAPPING_FOUND",
+      "resolved": null,
+      "candidates": [],
+      "source_version": "d85b9328a5532a55a9105c9ba419d14005a2f9cd79b65d40964e07d636b6ce7e"
+    },
+    {
+      "product_code": "000021",
+      "ncm": "07089000",
+      "status": "NO_MVA_MAPPING_FOUND",
+      "resolved": null,
+      "candidates": [],
+      "source_version": "d85b9328a5532a55a9105c9ba419d14005a2f9cd79b65d40964e07d636b6ce7e"
+    },
+    {
+      "product_code": "000022",
+      "ncm": "07089000",
+      "status": "NO_MVA_MAPPING_FOUND",
+      "resolved": null,
+      "candidates": [],
+      "source_version": "d85b9328a5532a55a9105c9ba419d14005a2f9cd79b65d40964e07d636b6ce7e"
+    },
+    {
+      "product_code": "000023",
+      "ncm": "16025000",
+      "status": "NO_MVA_MAPPING_FOUND",
+      "resolved": null,
+      "candidates": [],
+      "source_version": "d85b9328a5532a55a9105c9ba419d14005a2f9cd79b65d40964e07d636b6ce7e"
+    },
+    {
+      "product_code": "000024",
+      "ncm": "19022000",
+      "status": "MVA_CANDIDATES",
+      "resolved": null,
+      "candidates": [
+        {
+          "item": "11.6.1",
+          "cest": "17.048.00",
+          "mva_original": "20%",
+          "mva_adjusted": "44,91%",
+          "description": "Massas alimentícias, cozidas ou recheadas (de carne ou de outras substâncias) ou preparadas de outro modo, exceto as descritas nos CEST , e Prot. ICMS 53/17 - AL, BA, CE, PB, PE, PI, RN e SE (Alíq. ) (Alíq. ) (Alíq. ) ”"
+        },
+        {
+          "item": "11.6.2",
+          "cest": "17.048.02",
+          "mva_original": "20%",
+          "mva_adjusted": "44,91%",
+          "description": "Massas alimentícias recheadas (mesmo cozidas ou preparadas de outro modo) Prot. ICMS 53/17 - AL, BA, CE, PB, PE, PI, RN e SE (Alíq. ) (Alíq. ) (Alíq. )"
+        }
+      ],
+      "source_version": "d85b9328a5532a55a9105c9ba419d14005a2f9cd79b65d40964e07d636b6ce7e"
+    },
+    {
+      "product_code": "000025",
+      "ncm": "04061010",
+      "status": "NO_MVA_MAPPING_FOUND",
+      "resolved": null,
+      "candidates": [],
+      "source_version": "d85b9328a5532a55a9105c9ba419d14005a2f9cd79b65d40964e07d636b6ce7e"
+    },
+    {
+      "product_code": "000026",
+      "ncm": "03055100",
+      "status": "NO_MVA_MAPPING_FOUND",
+      "resolved": null,
+      "candidates": [],
+      "source_version": "d85b9328a5532a55a9105c9ba419d14005a2f9cd79b65d40964e07d636b6ce7e"
+    },
+    {
+      "product_code": "000027",
+      "ncm": "19022000",
+      "status": "MVA_CANDIDATES",
+      "resolved": null,
+      "candidates": [
+        {
+          "item": "11.6.1",
+          "cest": "17.048.00",
+          "mva_original": "20%",
+          "mva_adjusted": "44,91%",
+          "description": "Massas alimentícias, cozidas ou recheadas (de carne ou de outras substâncias) ou preparadas de outro modo, exceto as descritas nos CEST , e Prot. ICMS 53/17 - AL, BA, CE, PB, PE, PI, RN e SE (Alíq. ) (Alíq. ) (Alíq. ) ”"
+        },
+        {
+          "item": "11.6.2",
+          "cest": "17.048.02",
+          "mva_original": "20%",
+          "mva_adjusted": "44,91%",
+          "description": "Massas alimentícias recheadas (mesmo cozidas ou preparadas de outro modo) Prot. ICMS 53/17 - AL, BA, CE, PB, PE, PI, RN e SE (Alíq. ) (Alíq. ) (Alíq. )"
+        }
+      ],
+      "source_version": "d85b9328a5532a55a9105c9ba419d14005a2f9cd79b65d40964e07d636b6ce7e"
+    }
+  ],
+  "write_eligible_count": 0,
+  "write_blocked_count": 33
+}

docs/DRY_RUN_PLAN_V2.json

@@ -0,0 +1,845 @@
+{
+  "artifact": "DRY_RUN_PLAN_V2",
+  "firebird_read": "BLOCKED_EXTERNAL_MISSING_CREDENTIALS",
+  "firebird_writes": 0,
+  "products_planned": 20,
+  "current_value_source": "docs/SAMPLE_PRODUCTS_V1.json (CEST) — ALIQ_IPI has no authorized offline source; FB_USER/FB_PASSWORD unavailable in this environment",
+  "field_proposals": [
+    {
+      "product_code": "000004",
+      "field": "ALIQ_IPI",
+      "current_value": null,
+      "proposed_value": "NT",
+      "status": "CURRENT_UNKNOWN",
+      "reason_code": "ERP_CURRENT_VALUE_UNKNOWN",
+      "source_dataset": "TIPI_IPI",
+      "source_version": "d155f1baafb4039dcb74f97bb5abc1aec69f6760da9bd3f94a90bd40b33a2e9a",
+      "provenance": {
+        "engine_version": "0.1.0",
+        "decision_version": "mission-02",
+        "request_fingerprint": "cb43da41b09827085e6e045664a1d221aeb3c5d7a9a667c3bbf47b6b91cd034e"
+      },
+      "write_eligible": false
+    },
+    {
+      "product_code": "000004",
+      "field": "CEST",
+      "current_value": "",
+      "proposed_value": null,
+      "status": "UNRESOLVED",
+      "reason_code": "NO_CEST_MAPPING_FOUND_FOR_NCM",
+      "source_dataset": "CEST",
+      "source_version": "d7fb7e8da0ace05123d35c13d04486b70440cfa7323f983d8fc2f2fcfd1d54d3",
+      "provenance": {
+        "engine_version": "0.1.0",
+        "decision_version": "mission-02",
+        "request_fingerprint": "cb43da41b09827085e6e045664a1d221aeb3c5d7a9a667c3bbf47b6b91cd034e"
+      },
+      "write_eligible": false
+    },
+    {
+      "product_code": "000005",
+      "field": "ALIQ_IPI",
+      "current_value": null,
+      "proposed_value": "NT",
+      "status": "CURRENT_UNKNOWN",
+      "reason_code": "ERP_CURRENT_VALUE_UNKNOWN",
+      "source_dataset": "TIPI_IPI",
+      "source_version": "d155f1baafb4039dcb74f97bb5abc1aec69f6760da9bd3f94a90bd40b33a2e9a",
+      "provenance": {
+        "engine_version": "0.1.0",
+        "decision_version": "mission-02",
+        "request_fingerprint": "3fc33193c2826d43a207bb87b9c3ddb4c74053910954e52932c82428f6c6fb0b"
+      },
+      "write_eligible": false
+    },
+    {
+      "product_code": "000005",
+      "field": "CEST",
+      "current_value": "",
+      "proposed_value": null,
+      "status": "UNRESOLVED",
+      "reason_code": "NO_CEST_MAPPING_FOUND_FOR_NCM",
+      "source_dataset": "CEST",
+      "source_version": "d7fb7e8da0ace05123d35c13d04486b70440cfa7323f983d8fc2f2fcfd1d54d3",
+      "provenance": {
+        "engine_version": "0.1.0",
+        "decision_version": "mission-02",
+        "request_fingerprint": "3fc33193c2826d43a207bb87b9c3ddb4c74053910954e52932c82428f6c6fb0b"
+      },
+      "write_eligible": false
+    },
+    {
+      "product_code": "000006",
+      "field": "ALIQ_IPI",
+      "current_value": null,
+      "proposed_value": "NT",
+      "status": "CURRENT_UNKNOWN",
+      "reason_code": "ERP_CURRENT_VALUE_UNKNOWN",
+      "source_dataset": "TIPI_IPI",
+      "source_version": "d155f1baafb4039dcb74f97bb5abc1aec69f6760da9bd3f94a90bd40b33a2e9a",
+      "provenance": {
+        "engine_version": "0.1.0",
+        "decision_version": "mission-02",
+        "request_fingerprint": "b1cde9a0fe5414d0f9a4cbedaf353809e449978b0766c584eeeeb9ba2acf7fbb"
+      },
+      "write_eligible": false
+    },
+    {
+      "product_code": "000006",
+      "field": "CEST",
+      "current_value": "",
+      "proposed_value": null,
+      "status": "UNRESOLVED",
+      "reason_code": "NO_CEST_MAPPING_FOUND_FOR_NCM",
+      "source_dataset": "CEST",
+      "source_version": "d7fb7e8da0ace05123d35c13d04486b70440cfa7323f983d8fc2f2fcfd1d54d3",
+      "provenance": {
+        "engine_version": "0.1.0",
+        "decision_version": "mission-02",
+        "request_fingerprint": "b1cde9a0fe5414d0f9a4cbedaf353809e449978b0766c584eeeeb9ba2acf7fbb"
+      },
+      "write_eligible": false
+    },
+    {
+      "product_code": "000008",
+      "field": "ALIQ_IPI",
+      "current_value": null,
+      "proposed_value": "NT",
+      "status": "CURRENT_UNKNOWN",
+      "reason_code": "ERP_CURRENT_VALUE_UNKNOWN",
+      "source_dataset": "TIPI_IPI",
+      "source_version": "d155f1baafb4039dcb74f97bb5abc1aec69f6760da9bd3f94a90bd40b33a2e9a",
+      "provenance": {
+        "engine_version": "0.1.0",
+        "decision_version": "mission-02",
+        "request_fingerprint": "e61590990546f3df1682cbdcbc63284a349077d509c19f27360bed8b0731d652"
+      },
+      "write_eligible": false
+    },
+    {
+      "product_code": "000008",
+      "field": "CEST",
+      "current_value": "",
+      "proposed_value": null,
+      "status": "UNRESOLVED",
+      "reason_code": "NO_CEST_MAPPING_FOUND_FOR_NCM",
+      "source_dataset": "CEST",
+      "source_version": "d7fb7e8da0ace05123d35c13d04486b70440cfa7323f983d8fc2f2fcfd1d54d3",
+      "provenance": {
+        "engine_version": "0.1.0",
+        "decision_version": "mission-02",
+        "request_fingerprint": "e61590990546f3df1682cbdcbc63284a349077d509c19f27360bed8b0731d652"
+      },
+      "write_eligible": false
+    },
+    {
+      "product_code": "000009",
+      "field": "ALIQ_IPI",
+      "current_value": null,
+      "proposed_value": "NT",
+      "status": "CURRENT_UNKNOWN",
+      "reason_code": "ERP_CURRENT_VALUE_UNKNOWN",
+      "source_dataset": "TIPI_IPI",
+      "source_version": "d155f1baafb4039dcb74f97bb5abc1aec69f6760da9bd3f94a90bd40b33a2e9a",
+      "provenance": {
+        "engine_version": "0.1.0",
+        "decision_version": "mission-02",
+        "request_fingerprint": "8f59f11aa591883ca082670a193e4abb935eb313f6a813d1d349d9255eb0ef3e"
+      },
+      "write_eligible": false
+    },
+    {
+      "product_code": "000009",
+      "field": "CEST",
+      "current_value": "",
+      "proposed_value": null,
+      "status": "UNRESOLVED",
+      "reason_code": "NO_CEST_MAPPING_FOUND_FOR_NCM",
+      "source_dataset": "CEST",
+      "source_version": "d7fb7e8da0ace05123d35c13d04486b70440cfa7323f983d8fc2f2fcfd1d54d3",
+      "provenance": {
+        "engine_version": "0.1.0",
+        "decision_version": "mission-02",
+        "request_fingerprint": "8f59f11aa591883ca082670a193e4abb935eb313f6a813d1d349d9255eb0ef3e"
+      },
+      "write_eligible": false
+    },
+    {
+      "product_code": "000010",
+      "field": "ALIQ_IPI",
+      "current_value": null,
+      "proposed_value": "NT",
+      "status": "CURRENT_UNKNOWN",
+      "reason_code": "ERP_CURRENT_VALUE_UNKNOWN",
+      "source_dataset": "TIPI_IPI",
+      "source_version": "d155f1baafb4039dcb74f97bb5abc1aec69f6760da9bd3f94a90bd40b33a2e9a",
+      "provenance": {
+        "engine_version": "0.1.0",
+        "decision_version": "mission-02",
+        "request_fingerprint": "08865c44ebc9b09141ee8fec4e3ebbb37144af22356dff383abea0a6d7229177"
+      },
+      "write_eligible": false
+    },
+    {
+      "product_code": "000010",
+      "field": "CEST",
+      "current_value": "",
+      "proposed_value": null,
+      "status": "UNRESOLVED",
+      "reason_code": "NO_CEST_MAPPING_FOUND_FOR_NCM",
+      "source_dataset": "CEST",
+      "source_version": "d7fb7e8da0ace05123d35c13d04486b70440cfa7323f983d8fc2f2fcfd1d54d3",
+      "provenance": {
+        "engine_version": "0.1.0",
+        "decision_version": "mission-02",
+        "request_fingerprint": "08865c44ebc9b09141ee8fec4e3ebbb37144af22356dff383abea0a6d7229177"
+      },
+      "write_eligible": false
+    },
+    {
+      "product_code": "000011",
+      "field": "ALIQ_IPI",
+      "current_value": null,
+      "proposed_value": "NT",
+      "status": "CURRENT_UNKNOWN",
+      "reason_code": "ERP_CURRENT_VALUE_UNKNOWN",
+      "source_dataset": "TIPI_IPI",
+      "source_version": "d155f1baafb4039dcb74f97bb5abc1aec69f6760da9bd3f94a90bd40b33a2e9a",
+      "provenance": {
+        "engine_version": "0.1.0",
+        "decision_version": "mission-02",
+        "request_fingerprint": "ec2513128224e31f969063ad1d32625ff8f0994e55a7192b14cf1d39acb136e6"
+      },
+      "write_eligible": false
+    },
+    {
+      "product_code": "000011",
+      "field": "CEST",
+      "current_value": "",
+      "proposed_value": null,
+      "status": "UNRESOLVED",
+      "reason_code": "NO_CEST_MAPPING_FOUND_FOR_NCM",
+      "source_dataset": "CEST",
+      "source_version": "d7fb7e8da0ace05123d35c13d04486b70440cfa7323f983d8fc2f2fcfd1d54d3",
+      "provenance": {
+        "engine_version": "0.1.0",
+        "decision_version": "mission-02",
+        "request_fingerprint": "ec2513128224e31f969063ad1d32625ff8f0994e55a7192b14cf1d39acb136e6"
+      },
+      "write_eligible": false
+    },
+    {
+      "product_code": "000013",
+      "field": "ALIQ_IPI",
+      "current_value": null,
+      "proposed_value": "NT",
+      "status": "CURRENT_UNKNOWN",
+      "reason_code": "ERP_CURRENT_VALUE_UNKNOWN",
+      "source_dataset": "TIPI_IPI",
+      "source_version": "d155f1baafb4039dcb74f97bb5abc1aec69f6760da9bd3f94a90bd40b33a2e9a",
+      "provenance": {
+        "engine_version": "0.1.0",
+        "decision_version": "mission-02",
+        "request_fingerprint": "d4b4da1deeab1f18411f7881c858b56b930f3c1035c4a27a7e8ef2870774e2bb"
+      },
+      "write_eligible": false
+    },
+    {
+      "product_code": "000013",
+      "field": "CEST",
+      "current_value": "",
+      "proposed_value": null,
+      "status": "UNRESOLVED",
+      "reason_code": "NO_CEST_MAPPING_FOUND_FOR_NCM",
+      "source_dataset": "CEST",
+      "source_version": "d7fb7e8da0ace05123d35c13d04486b70440cfa7323f983d8fc2f2fcfd1d54d3",
+      "provenance": {
+        "engine_version": "0.1.0",
+        "decision_version": "mission-02",
+        "request_fingerprint": "d4b4da1deeab1f18411f7881c858b56b930f3c1035c4a27a7e8ef2870774e2bb"
+      },
+      "write_eligible": false
+    },
+    {
+      "product_code": "000015",
+      "field": "ALIQ_IPI",
+      "current_value": null,
+      "proposed_value": "NT",
+      "status": "CURRENT_UNKNOWN",
+      "reason_code": "ERP_CURRENT_VALUE_UNKNOWN",
+      "source_dataset": "TIPI_IPI",
+      "source_version": "d155f1baafb4039dcb74f97bb5abc1aec69f6760da9bd3f94a90bd40b33a2e9a",
+      "provenance": {
+        "engine_version": "0.1.0",
+        "decision_version": "mission-02",
+        "request_fingerprint": "ba57a075cffa8b343c147518fe03e9a2721d067299991664ed63238aebbc26ed"
+      },
+      "write_eligible": false
+    },
+    {
+      "product_code": "000015",
+      "field": "CEST",
+      "current_value": "",
+      "proposed_value": null,
+      "status": "UNRESOLVED",
+      "reason_code": "NO_CEST_MAPPING_FOUND_FOR_NCM",
+      "source_dataset": "CEST",
+      "source_version": "d7fb7e8da0ace05123d35c13d04486b70440cfa7323f983d8fc2f2fcfd1d54d3",
+      "provenance": {
+        "engine_version": "0.1.0",
+        "decision_version": "mission-02",
+        "request_fingerprint": "ba57a075cffa8b343c147518fe03e9a2721d067299991664ed63238aebbc26ed"
+      },
+      "write_eligible": false
+    },
+    {
+      "product_code": "000016",
+      "field": "CLASSIFICACAO_FISCAL",
+      "current_value": "02071400",
+      "proposed_value": null,
+      "status": "LEGACY_NCM_REVIEW",
+      "reason_code": "LEGACY_NCM_NO_AUTOMATIC_SUCCESSOR",
+      "source_dataset": "NCM",
+      "source_version": "3abc0d2eb2501bbd0cc3f5e0ee3774d33f091ea305e8127ee020e4009878987e",
+      "provenance": {
+        "engine_version": "0.1.0",
+        "decision_version": "mission-02",
+        "request_fingerprint": "4d7c735bd3d78e902cd44679b3db445d1effe8f27a029b5379e743260cd5dfe3"
+      },
+      "write_eligible": false
+    },
+    {
+      "product_code": "000017",
+      "field": "ALIQ_IPI",
+      "current_value": null,
+      "proposed_value": null,
+      "status": "SOURCE_BLANK",
+      "reason_code": "TIPI_RATE_SOURCE_BLANK",
+      "source_dataset": "TIPI_IPI",
+      "source_version": "d155f1baafb4039dcb74f97bb5abc1aec69f6760da9bd3f94a90bd40b33a2e9a",
+      "provenance": {
+        "engine_version": "0.1.0",
+        "decision_version": "mission-02",
+        "request_fingerprint": "21ca73685772908125fdb3e189d0bfcd51a77f3eed4e9a1bb7b2f6433881d379"
+      },
+      "write_eligible": false
+    },
+    {
+      "product_code": "000017",
+      "field": "CEST",
+      "current_value": "",
+      "proposed_value": null,
+      "status": "UNRESOLVED",
+      "reason_code": "NO_CEST_MAPPING_FOUND_FOR_NCM",
+      "source_dataset": "CEST",
+      "source_version": "d7fb7e8da0ace05123d35c13d04486b70440cfa7323f983d8fc2f2fcfd1d54d3",
+      "provenance": {
+        "engine_version": "0.1.0",
+        "decision_version": "mission-02",
+        "request_fingerprint": "21ca73685772908125fdb3e189d0bfcd51a77f3eed4e9a1bb7b2f6433881d379"
+      },
+      "write_eligible": false
+    },
+    {
+      "product_code": "000018",
+      "field": "ALIQ_IPI",
+      "current_value": null,
+      "proposed_value": null,
+      "status": "SOURCE_BLANK",
+      "reason_code": "TIPI_RATE_SOURCE_BLANK",
+      "source_dataset": "TIPI_IPI",
+      "source_version": "d155f1baafb4039dcb74f97bb5abc1aec69f6760da9bd3f94a90bd40b33a2e9a",
+      "provenance": {
+        "engine_version": "0.1.0",
+        "decision_version": "mission-02",
+        "request_fingerprint": "c00a786e4b3ce4aacbb1e47204292567af3dc49be4f497354607c66a8e1c7ad8"
+      },
+      "write_eligible": false
+    },
+    {
+      "product_code": "000018",
+      "field": "CEST",
+      "current_value": "",
+      "proposed_value": null,
+      "status": "UNRESOLVED",
+      "reason_code": "CEST_DESCRIPTION_SCORE_BELOW_THRESHOLD",
+      "source_dataset": "CEST",
+      "source_version": "d7fb7e8da0ace05123d35c13d04486b70440cfa7323f983d8fc2f2fcfd1d54d3",
+      "provenance": {
+        "engine_version": "0.1.0",
+        "decision_version": "mission-02",
+        "request_fingerprint": "c00a786e4b3ce4aacbb1e47204292567af3dc49be4f497354607c66a8e1c7ad8"
+      },
+      "write_eligible": false
+    },
+    {
+      "product_code": "000019",
+      "field": "ALIQ_IPI",
+      "current_value": null,
+      "proposed_value": "NT",
+      "status": "CURRENT_UNKNOWN",
+      "reason_code": "ERP_CURRENT_VALUE_UNKNOWN",
+      "source_dataset": "TIPI_IPI",
+      "source_version": "d155f1baafb4039dcb74f97bb5abc1aec69f6760da9bd3f94a90bd40b33a2e9a",
+      "provenance": {
+        "engine_version": "0.1.0",
+        "decision_version": "mission-02",
+        "request_fingerprint": "ff26dfa9954d7a3fdccd8033d973ab01724498c1d59b735facdfdbf169a476a8"
+      },
+      "write_eligible": false
+    },
+    {
+      "product_code": "000019",
+      "field": "CEST",
+      "current_value": "",
+      "proposed_value": null,
+      "status": "UNRESOLVED",
+      "reason_code": "NO_CEST_MAPPING_FOUND_FOR_NCM",
+      "source_dataset": "CEST",
+      "source_version": "d7fb7e8da0ace05123d35c13d04486b70440cfa7323f983d8fc2f2fcfd1d54d3",
+      "provenance": {
+        "engine_version": "0.1.0",
+        "decision_version": "mission-02",
+        "request_fingerprint": "ff26dfa9954d7a3fdccd8033d973ab01724498c1d59b735facdfdbf169a476a8"
+      },
+      "write_eligible": false
+    },
+    {
+      "product_code": "000021",
+      "field": "ALIQ_IPI",
+      "current_value": null,
+      "proposed_value": "NT",
+      "status": "CURRENT_UNKNOWN",
+      "reason_code": "ERP_CURRENT_VALUE_UNKNOWN",
+      "source_dataset": "TIPI_IPI",
+      "source_version": "d155f1baafb4039dcb74f97bb5abc1aec69f6760da9bd3f94a90bd40b33a2e9a",
+      "provenance": {
+        "engine_version": "0.1.0",
+        "decision_version": "mission-02",
+        "request_fingerprint": "7611a454105cac1d31692c1d049da55a7a855871e021de7daf96385d45632d3b"
+      },
+      "write_eligible": false
+    },
+    {
+      "product_code": "000021",
+      "field": "CEST",
+      "current_value": "",
+      "proposed_value": null,
+      "status": "UNRESOLVED",
+      "reason_code": "NO_CEST_MAPPING_FOUND_FOR_NCM",
+      "source_dataset": "CEST",
+      "source_version": "d7fb7e8da0ace05123d35c13d04486b70440cfa7323f983d8fc2f2fcfd1d54d3",
+      "provenance": {
+        "engine_version": "0.1.0",
+        "decision_version": "mission-02",
+        "request_fingerprint": "7611a454105cac1d31692c1d049da55a7a855871e021de7daf96385d45632d3b"
+      },
+      "write_eligible": false
+    },
+    {
+      "product_code": "000022",
+      "field": "ALIQ_IPI",
+      "current_value": null,
+      "proposed_value": "NT",
+      "status": "CURRENT_UNKNOWN",
+      "reason_code": "ERP_CURRENT_VALUE_UNKNOWN",
+      "source_dataset": "TIPI_IPI",
+      "source_version": "d155f1baafb4039dcb74f97bb5abc1aec69f6760da9bd3f94a90bd40b33a2e9a",
+      "provenance": {
+        "engine_version": "0.1.0",
+        "decision_version": "mission-02",
+        "request_fingerprint": "50fb43fdcc45474cdebe44a317c7e8bd3a1695389774e13185d98c51311ab3e2"
+      },
+      "write_eligible": false
+    },
+    {
+      "product_code": "000022",
+      "field": "CEST",
+      "current_value": "",
+      "proposed_value": null,
+      "status": "UNRESOLVED",
+      "reason_code": "NO_CEST_MAPPING_FOUND_FOR_NCM",
+      "source_dataset": "CEST",
+      "source_version": "d7fb7e8da0ace05123d35c13d04486b70440cfa7323f983d8fc2f2fcfd1d54d3",
+      "provenance": {
+        "engine_version": "0.1.0",
+        "decision_version": "mission-02",
+        "request_fingerprint": "50fb43fdcc45474cdebe44a317c7e8bd3a1695389774e13185d98c51311ab3e2"
+      },
+      "write_eligible": false
+    },
+    {
+      "product_code": "000023",
+      "field": "ALIQ_IPI",
+      "current_value": null,
+      "proposed_value": null,
+      "status": "SOURCE_BLANK",
+      "reason_code": "TIPI_RATE_SOURCE_BLANK",
+      "source_dataset": "TIPI_IPI",
+      "source_version": "d155f1baafb4039dcb74f97bb5abc1aec69f6760da9bd3f94a90bd40b33a2e9a",
+      "provenance": {
+        "engine_version": "0.1.0",
+        "decision_version": "mission-02",
+        "request_fingerprint": "13af6da7090e28ade50bc1944469fcb3fdf03f298f78db905ecc234fdf7845c3"
+      },
+      "write_eligible": false
+    },
+    {
+      "product_code": "000023",
+      "field": "CEST",
+      "current_value": "",
+      "proposed_value": null,
+      "status": "UNRESOLVED",
+      "reason_code": "CEST_DESCRIPTION_SCORE_BELOW_THRESHOLD",
+      "source_dataset": "CEST",
+      "source_version": "d7fb7e8da0ace05123d35c13d04486b70440cfa7323f983d8fc2f2fcfd1d54d3",
+      "provenance": {
+        "engine_version": "0.1.0",
+        "decision_version": "mission-02",
+        "request_fingerprint": "13af6da7090e28ade50bc1944469fcb3fdf03f298f78db905ecc234fdf7845c3"
+      },
+      "write_eligible": false
+    },
+    {
+      "product_code": "000024",
+      "field": "ALIQ_IPI",
+      "current_value": null,
+      "proposed_value": null,
+      "status": "SOURCE_BLANK",
+      "reason_code": "TIPI_RATE_SOURCE_BLANK",
+      "source_dataset": "TIPI_IPI",
+      "source_version": "d155f1baafb4039dcb74f97bb5abc1aec69f6760da9bd3f94a90bd40b33a2e9a",
+      "provenance": {
+        "engine_version": "0.1.0",
+        "decision_version": "mission-02",
+        "request_fingerprint": "0a8e6bedd4154e647b4e392dfb9138a6692e81d4f3d85495715c60a06644c0d5"
+      },
+      "write_eligible": false
+    },
+    {
+      "product_code": "000024",
+      "field": "CEST",
+      "current_value": "",
+      "proposed_value": null,
+      "status": "UNRESOLVED",
+      "reason_code": "CEST_DESCRIPTION_SCORE_BELOW_THRESHOLD",
+      "source_dataset": "CEST",
+      "source_version": "d7fb7e8da0ace05123d35c13d04486b70440cfa7323f983d8fc2f2fcfd1d54d3",
+      "provenance": {
+        "engine_version": "0.1.0",
+        "decision_version": "mission-02",
+        "request_fingerprint": "0a8e6bedd4154e647b4e392dfb9138a6692e81d4f3d85495715c60a06644c0d5"
+      },
+      "write_eligible": false
+    },
+    {
+      "product_code": "000025",
+      "field": "ALIQ_IPI",
+      "current_value": null,
+      "proposed_value": null,
+      "status": "SOURCE_BLANK",
+      "reason_code": "TIPI_RATE_SOURCE_BLANK",
+      "source_dataset": "TIPI_IPI",
+      "source_version": "d155f1baafb4039dcb74f97bb5abc1aec69f6760da9bd3f94a90bd40b33a2e9a",
+      "provenance": {
+        "engine_version": "0.1.0",
+        "decision_version": "mission-02",
+        "request_fingerprint": "a0b43b77137825496b3032f2f8ee288b02cc854055beb59305ebc7b781f54e16"
+      },
+      "write_eligible": false
+    },
+    {
+      "product_code": "000025",
+      "field": "CEST",
+      "current_value": "",
+      "proposed_value": null,
+      "status": "UNRESOLVED",
+      "reason_code": "CEST_DESCRIPTION_SCORE_BELOW_THRESHOLD",
+      "source_dataset": "CEST",
+      "source_version": "d7fb7e8da0ace05123d35c13d04486b70440cfa7323f983d8fc2f2fcfd1d54d3",
+      "provenance": {
+        "engine_version": "0.1.0",
+        "decision_version": "mission-02",
+        "request_fingerprint": "a0b43b77137825496b3032f2f8ee288b02cc854055beb59305ebc7b781f54e16"
+      },
+      "write_eligible": false
+    },
+    {
+      "product_code": "000026",
+      "field": "ALIQ_IPI",
+      "current_value": null,
+      "proposed_value": "3.25",
+      "status": "CURRENT_UNKNOWN",
+      "reason_code": "ERP_CURRENT_VALUE_UNKNOWN",
+      "source_dataset": "TIPI_IPI",
+      "source_version": "d155f1baafb4039dcb74f97bb5abc1aec69f6760da9bd3f94a90bd40b33a2e9a",
+      "provenance": {
+        "engine_version": "0.1.0",
+        "decision_version": "mission-02",
+        "request_fingerprint": "e401bf0f42be227a61f0121333707644b3e46f7f968c712dd6a2f040525e1e1a"
+      },
+      "write_eligible": false
+    },
+    {
+      "product_code": "000026",
+      "field": "CEST",
+      "current_value": "",
+      "proposed_value": null,
+      "status": "UNRESOLVED",
+      "reason_code": "NO_CEST_MAPPING_FOUND_FOR_NCM",
+      "source_dataset": "CEST",
+      "source_version": "d7fb7e8da0ace05123d35c13d04486b70440cfa7323f983d8fc2f2fcfd1d54d3",
+      "provenance": {
+        "engine_version": "0.1.0",
+        "decision_version": "mission-02",
+        "request_fingerprint": "e401bf0f42be227a61f0121333707644b3e46f7f968c712dd6a2f040525e1e1a"
+      },
+      "write_eligible": false
+    },
+    {
+      "product_code": "000027",
+      "field": "ALIQ_IPI",
+      "current_value": null,
+      "proposed_value": null,
+      "status": "SOURCE_BLANK",
+      "reason_code": "TIPI_RATE_SOURCE_BLANK",
+      "source_dataset": "TIPI_IPI",
+      "source_version": "d155f1baafb4039dcb74f97bb5abc1aec69f6760da9bd3f94a90bd40b33a2e9a",
+      "provenance": {
+        "engine_version": "0.1.0",
+        "decision_version": "mission-02",
+        "request_fingerprint": "f54f8cb9c5a9f118c1db4c2e91537a5b81c7c50b67698ad4776add27e2ce707a"
+      },
+      "write_eligible": false
+    },
+    {
+      "product_code": "000027",
+      "field": "CEST",
+      "current_value": "",
+      "proposed_value": null,
+      "status": "UNRESOLVED",
+      "reason_code": "CEST_DESCRIPTION_SCORE_BELOW_THRESHOLD",
+      "source_dataset": "CEST",
+      "source_version": "d7fb7e8da0ace05123d35c13d04486b70440cfa7323f983d8fc2f2fcfd1d54d3",
+      "provenance": {
+        "engine_version": "0.1.0",
+        "decision_version": "mission-02",
+        "request_fingerprint": "f54f8cb9c5a9f118c1db4c2e91537a5b81c7c50b67698ad4776add27e2ce707a"
+      },
+      "write_eligible": false
+    }
+  ],
+  "mva_evidence": [
+    {
+      "product_code": "000004",
+      "ncm": "07069000",
+      "status": "NO_MVA_MAPPING_FOUND",
+      "resolved": null,
+      "candidates": [],
+      "source_version": "d85b9328a5532a55a9105c9ba419d14005a2f9cd79b65d40964e07d636b6ce7e"
+    },
+    {
+      "product_code": "000005",
+      "ncm": "07069000",
+      "status": "NO_MVA_MAPPING_FOUND",
+      "resolved": null,
+      "candidates": [],
+      "source_version": "d85b9328a5532a55a9105c9ba419d14005a2f9cd79b65d40964e07d636b6ce7e"
+    },
+    {
+      "product_code": "000006",
+      "ncm": "07069000",
+      "status": "NO_MVA_MAPPING_FOUND",
+      "resolved": null,
+      "candidates": [],
+      "source_version": "d85b9328a5532a55a9105c9ba419d14005a2f9cd79b65d40964e07d636b6ce7e"
+    },
+    {
+      "product_code": "000008",
+      "ncm": "07069000",
+      "status": "NO_MVA_MAPPING_FOUND",
+      "resolved": null,
+      "candidates": [],
+      "source_version": "d85b9328a5532a55a9105c9ba419d14005a2f9cd79b65d40964e07d636b6ce7e"
+    },
+    {
+      "product_code": "000009",
+      "ncm": "07069000",
+      "status": "NO_MVA_MAPPING_FOUND",
+      "resolved": null,
+      "candidates": [],
+      "source_version": "d85b9328a5532a55a9105c9ba419d14005a2f9cd79b65d40964e07d636b6ce7e"
+    },
+    {
+      "product_code": "000010",
+      "ncm": "07069000",
+      "status": "NO_MVA_MAPPING_FOUND",
+      "resolved": null,
+      "candidates": [],
+      "source_version": "d85b9328a5532a55a9105c9ba419d14005a2f9cd79b65d40964e07d636b6ce7e"
+    },
+    {
+      "product_code": "000011",
+      "ncm": "07069000",
+      "status": "NO_MVA_MAPPING_FOUND",
+      "resolved": null,
+      "candidates": [],
+      "source_version": "d85b9328a5532a55a9105c9ba419d14005a2f9cd79b65d40964e07d636b6ce7e"
+    },
+    {
+      "product_code": "000013",
+      "ncm": "07069000",
+      "status": "NO_MVA_MAPPING_FOUND",
+      "resolved": null,
+      "candidates": [],
+      "source_version": "d85b9328a5532a55a9105c9ba419d14005a2f9cd79b65d40964e07d636b6ce7e"
+    },
+    {
+      "product_code": "000015",
+      "ncm": "07133321",
+      "status": "NO_MVA_MAPPING_FOUND",
+      "resolved": null,
+      "candidates": [],
+      "source_version": "d85b9328a5532a55a9105c9ba419d14005a2f9cd79b65d40964e07d636b6ce7e"
+    },
+    {
+      "product_code": "000016",
+      "ncm": "02071400",
+      "status": "LEGACY_NCM",
+      "resolved": null,
+      "candidates": [],
+      "source_version": "d85b9328a5532a55a9105c9ba419d14005a2f9cd79b65d40964e07d636b6ce7e"
+    },
+    {
+      "product_code": "000017",
+      "ncm": "03061790",
+      "status": "NO_MVA_MAPPING_FOUND",
+      "resolved": null,
+      "candidates": [],
+      "source_version": "d85b9328a5532a55a9105c9ba419d14005a2f9cd79b65d40964e07d636b6ce7e"
+    },
+    {
+      "product_code": "000018",
+      "ncm": "02071100",
+      "status": "MVA_CANDIDATES",
+      "resolved": null,
+      "candidates": [
+        {
+          "item": "11.25.0",
+          "cest": "17.087.00",
+          "mva_original": "25%",
+          "mva_adjusted": "50,94%",
+          "description": ", , e Carnes e demais produtos comestíveis frescos, resfriados, congelados, salgados, em salmoura, simplesmente temperados, secos ou defumados, resultantes do abate de aves, exceto os descritos no CEST Não tem (Alíq. ) (Alíq. ) (Alíq. )"
+        },
+        {
+          "item": "11.25.2",
+          "cest": "17.087.02",
+          "mva_original": "25%",
+          "mva_adjusted": "50,94%",
+          "description": "e Carnes de aves inteiras com peso unitário superior a 3Kg, temperadas Não tem (Alíq. ) (Alíq. ) (Alíq. )"
+        }
+      ],
+      "source_version": "d85b9328a5532a55a9105c9ba419d14005a2f9cd79b65d40964e07d636b6ce7e"
+    },
+    {
+      "product_code": "000019",
+      "ncm": "07133321",
+      "status": "NO_MVA_MAPPING_FOUND",
+      "resolved": null,
+      "candidates": [],
+      "source_version": "d85b9328a5532a55a9105c9ba419d14005a2f9cd79b65d40964e07d636b6ce7e"
+    },
+    {
+      "product_code": "000021",
+      "ncm": "07089000",
+      "status": "NO_MVA_MAPPING_FOUND",
+      "resolved": null,
+      "candidates": [],
+      "source_version": "d85b9328a5532a55a9105c9ba419d14005a2f9cd79b65d40964e07d636b6ce7e"
+    },
+    {
+      "product_code": "000022",
+      "ncm": "07089000",
+      "status": "NO_MVA_MAPPING_FOUND",
+      "resolved": null,
+      "candidates": [],
+      "source_version": "d85b9328a5532a55a9105c9ba419d14005a2f9cd79b65d40964e07d636b6ce7e"
+    },
+    {
+      "product_code": "000023",
+      "ncm": "16025000",
+      "status": "NO_MVA_MAPPING_FOUND",
+      "resolved": null,
+      "candidates": [],
+      "source_version": "d85b9328a5532a55a9105c9ba419d14005a2f9cd79b65d40964e07d636b6ce7e"
+    },
+    {
+      "product_code": "000024",
+      "ncm": "19022000",
+      "status": "MVA_CANDIDATES",
+      "resolved": null,
+      "candidates": [
+        {
+          "item": "11.6.1",
+          "cest": "17.048.00",
+          "mva_original": "20%",
+          "mva_adjusted": "44,91%",
+          "description": "Massas alimentícias, cozidas ou recheadas (de carne ou de outras substâncias) ou preparadas de outro modo, exceto as descritas nos CEST , e Prot. ICMS 53/17 - AL, BA, CE, PB, PE, PI, RN e SE (Alíq. ) (Alíq. ) (Alíq. ) ”"
+        },
+        {
+          "item": "11.6.2",
+          "cest": "17.048.02",
+          "mva_original": "20%",
+          "mva_adjusted": "44,91%",
+          "description": "Massas alimentícias recheadas (mesmo cozidas ou preparadas de outro modo) Prot. ICMS 53/17 - AL, BA, CE, PB, PE, PI, RN e SE (Alíq. ) (Alíq. ) (Alíq. )"
+        }
+      ],
+      "source_version": "d85b9328a5532a55a9105c9ba419d14005a2f9cd79b65d40964e07d636b6ce7e"
+    },
+    {
+      "product_code": "000025",
+      "ncm": "04061010",
+      "status": "NO_MVA_MAPPING_FOUND",
+      "resolved": null,
+      "candidates": [],
+      "source_version": "d85b9328a5532a55a9105c9ba419d14005a2f9cd79b65d40964e07d636b6ce7e"
+    },
+    {
+      "product_code": "000026",
+      "ncm": "03055100",
+      "status": "NO_MVA_MAPPING_FOUND",
+      "resolved": null,
+      "candidates": [],
+      "source_version": "d85b9328a5532a55a9105c9ba419d14005a2f9cd79b65d40964e07d636b6ce7e"
+    },
+    {
+      "product_code": "000027",
+      "ncm": "19022000",
+      "status": "MVA_CANDIDATES",
+      "resolved": null,
+      "candidates": [
+        {
+          "item": "11.6.1",
+          "cest": "17.048.00",
+          "mva_original": "20%",
+          "mva_adjusted": "44,91%",
+          "description": "Massas alimentícias, cozidas ou recheadas (de carne ou de outras substâncias) ou preparadas de outro modo, exceto as descritas nos CEST , e Prot. ICMS 53/17 - AL, BA, CE, PB, PE, PI, RN e SE (Alíq. ) (Alíq. ) (Alíq. ) ”"
+        },
+        {
+          "item": "11.6.2",
+          "cest": "17.048.02",
+          "mva_original": "20%",
+          "mva_adjusted": "44,91%",
+          "description": "Massas alimentícias recheadas (mesmo cozidas ou preparadas de outro modo) Prot. ICMS 53/17 - AL, BA, CE, PB, PE, PI, RN e SE (Alíq. ) (Alíq. ) (Alíq. )"
+        }
+      ],
+      "source_version": "d85b9328a5532a55a9105c9ba419d14005a2f9cd79b65d40964e07d636b6ce7e"
+    }
+  ],
+  "tipi_empty_rate_breakdown": {
+    "SOURCE_BLANK": 6
+  },
+  "write_eligible_count": 0,
+  "write_blocked_count": 39
+}

docs/DRY_RUN_PLAN_V3.json

@@ -0,0 +1,845 @@
+{
+  "artifact": "DRY_RUN_PLAN_V3",
+  "firebird_read": "OK",
+  "firebird_writes": 0,
+  "products_planned": 20,
+  "current_value_source": "live read-only SELECT from C000025 via firebird_live_20.json",
+  "field_proposals": [
+    {
+      "product_code": "000004",
+      "field": "ALIQ_IPI",
+      "current_value": null,
+      "proposed_value": "NT",
+      "status": "CHANGE_REQUIRED",
+      "reason_code": "TIPI_RATE_DIVERGES_FROM_ERP",
+      "source_dataset": "TIPI_IPI",
+      "source_version": "d155f1baafb4039dcb74f97bb5abc1aec69f6760da9bd3f94a90bd40b33a2e9a",
+      "provenance": {
+        "engine_version": "0.1.0",
+        "decision_version": "mission-02",
+        "request_fingerprint": "cb43da41b09827085e6e045664a1d221aeb3c5d7a9a667c3bbf47b6b91cd034e"
+      },
+      "write_eligible": true
+    },
+    {
+      "product_code": "000004",
+      "field": "CEST",
+      "current_value": "",
+      "proposed_value": null,
+      "status": "UNRESOLVED",
+      "reason_code": "NO_CEST_MAPPING_FOUND_FOR_NCM",
+      "source_dataset": "CEST",
+      "source_version": "d7fb7e8da0ace05123d35c13d04486b70440cfa7323f983d8fc2f2fcfd1d54d3",
+      "provenance": {
+        "engine_version": "0.1.0",
+        "decision_version": "mission-02",
+        "request_fingerprint": "cb43da41b09827085e6e045664a1d221aeb3c5d7a9a667c3bbf47b6b91cd034e"
+      },
+      "write_eligible": false
+    },
+    {
+      "product_code": "000005",
+      "field": "ALIQ_IPI",
+      "current_value": null,
+      "proposed_value": "NT",
+      "status": "CHANGE_REQUIRED",
+      "reason_code": "TIPI_RATE_DIVERGES_FROM_ERP",
+      "source_dataset": "TIPI_IPI",
+      "source_version": "d155f1baafb4039dcb74f97bb5abc1aec69f6760da9bd3f94a90bd40b33a2e9a",
+      "provenance": {
+        "engine_version": "0.1.0",
+        "decision_version": "mission-02",
+        "request_fingerprint": "3fc33193c2826d43a207bb87b9c3ddb4c74053910954e52932c82428f6c6fb0b"
+      },
+      "write_eligible": true
+    },
+    {
+      "product_code": "000005",
+      "field": "CEST",
+      "current_value": "",
+      "proposed_value": null,
+      "status": "UNRESOLVED",
+      "reason_code": "NO_CEST_MAPPING_FOUND_FOR_NCM",
+      "source_dataset": "CEST",
+      "source_version": "d7fb7e8da0ace05123d35c13d04486b70440cfa7323f983d8fc2f2fcfd1d54d3",
+      "provenance": {
+        "engine_version": "0.1.0",
+        "decision_version": "mission-02",
+        "request_fingerprint": "3fc33193c2826d43a207bb87b9c3ddb4c74053910954e52932c82428f6c6fb0b"
+      },
+      "write_eligible": false
+    },
+    {
+      "product_code": "000006",
+      "field": "ALIQ_IPI",
+      "current_value": null,
+      "proposed_value": "NT",
+      "status": "CHANGE_REQUIRED",
+      "reason_code": "TIPI_RATE_DIVERGES_FROM_ERP",
+      "source_dataset": "TIPI_IPI",
+      "source_version": "d155f1baafb4039dcb74f97bb5abc1aec69f6760da9bd3f94a90bd40b33a2e9a",
+      "provenance": {
+        "engine_version": "0.1.0",
+        "decision_version": "mission-02",
+        "request_fingerprint": "b1cde9a0fe5414d0f9a4cbedaf353809e449978b0766c584eeeeb9ba2acf7fbb"
+      },
+      "write_eligible": true
+    },
+    {
+      "product_code": "000006",
+      "field": "CEST",
+      "current_value": "",
+      "proposed_value": null,
+      "status": "UNRESOLVED",
+      "reason_code": "NO_CEST_MAPPING_FOUND_FOR_NCM",
+      "source_dataset": "CEST",
+      "source_version": "d7fb7e8da0ace05123d35c13d04486b70440cfa7323f983d8fc2f2fcfd1d54d3",
+      "provenance": {
+        "engine_version": "0.1.0",
+        "decision_version": "mission-02",
+        "request_fingerprint": "b1cde9a0fe5414d0f9a4cbedaf353809e449978b0766c584eeeeb9ba2acf7fbb"
+      },
+      "write_eligible": false
+    },
+    {
+      "product_code": "000008",
+      "field": "ALIQ_IPI",
+      "current_value": null,
+      "proposed_value": "NT",
+      "status": "CHANGE_REQUIRED",
+      "reason_code": "TIPI_RATE_DIVERGES_FROM_ERP",
+      "source_dataset": "TIPI_IPI",
+      "source_version": "d155f1baafb4039dcb74f97bb5abc1aec69f6760da9bd3f94a90bd40b33a2e9a",
+      "provenance": {
+        "engine_version": "0.1.0",
+        "decision_version": "mission-02",
+        "request_fingerprint": "e61590990546f3df1682cbdcbc63284a349077d509c19f27360bed8b0731d652"
+      },
+      "write_eligible": true
+    },
+    {
+      "product_code": "000008",
+      "field": "CEST",
+      "current_value": "",
+      "proposed_value": null,
+      "status": "UNRESOLVED",
+      "reason_code": "NO_CEST_MAPPING_FOUND_FOR_NCM",
+      "source_dataset": "CEST",
+      "source_version": "d7fb7e8da0ace05123d35c13d04486b70440cfa7323f983d8fc2f2fcfd1d54d3",
+      "provenance": {
+        "engine_version": "0.1.0",
+        "decision_version": "mission-02",
+        "request_fingerprint": "e61590990546f3df1682cbdcbc63284a349077d509c19f27360bed8b0731d652"
+      },
+      "write_eligible": false
+    },
+    {
+      "product_code": "000009",
+      "field": "ALIQ_IPI",
+      "current_value": null,
+      "proposed_value": "NT",
+      "status": "CHANGE_REQUIRED",
+      "reason_code": "TIPI_RATE_DIVERGES_FROM_ERP",
+      "source_dataset": "TIPI_IPI",
+      "source_version": "d155f1baafb4039dcb74f97bb5abc1aec69f6760da9bd3f94a90bd40b33a2e9a",
+      "provenance": {
+        "engine_version": "0.1.0",
+        "decision_version": "mission-02",
+        "request_fingerprint": "8f59f11aa591883ca082670a193e4abb935eb313f6a813d1d349d9255eb0ef3e"
+      },
+      "write_eligible": true
+    },
+    {
+      "product_code": "000009",
+      "field": "CEST",
+      "current_value": "",
+      "proposed_value": null,
+      "status": "UNRESOLVED",
+      "reason_code": "NO_CEST_MAPPING_FOUND_FOR_NCM",
+      "source_dataset": "CEST",
+      "source_version": "d7fb7e8da0ace05123d35c13d04486b70440cfa7323f983d8fc2f2fcfd1d54d3",
+      "provenance": {
+        "engine_version": "0.1.0",
+        "decision_version": "mission-02",
+        "request_fingerprint": "8f59f11aa591883ca082670a193e4abb935eb313f6a813d1d349d9255eb0ef3e"
+      },
+      "write_eligible": false
+    },
+    {
+      "product_code": "000010",
+      "field": "ALIQ_IPI",
+      "current_value": null,
+      "proposed_value": "NT",
+      "status": "CHANGE_REQUIRED",
+      "reason_code": "TIPI_RATE_DIVERGES_FROM_ERP",
+      "source_dataset": "TIPI_IPI",
+      "source_version": "d155f1baafb4039dcb74f97bb5abc1aec69f6760da9bd3f94a90bd40b33a2e9a",
+      "provenance": {
+        "engine_version": "0.1.0",
+        "decision_version": "mission-02",
+        "request_fingerprint": "08865c44ebc9b09141ee8fec4e3ebbb37144af22356dff383abea0a6d7229177"
+      },
+      "write_eligible": true
+    },
+    {
+      "product_code": "000010",
+      "field": "CEST",
+      "current_value": "",
+      "proposed_value": null,
+      "status": "UNRESOLVED",
+      "reason_code": "NO_CEST_MAPPING_FOUND_FOR_NCM",
+      "source_dataset": "CEST",
+      "source_version": "d7fb7e8da0ace05123d35c13d04486b70440cfa7323f983d8fc2f2fcfd1d54d3",
+      "provenance": {
+        "engine_version": "0.1.0",
+        "decision_version": "mission-02",
+        "request_fingerprint": "08865c44ebc9b09141ee8fec4e3ebbb37144af22356dff383abea0a6d7229177"
+      },
+      "write_eligible": false
+    },
+    {
+      "product_code": "000011",
+      "field": "ALIQ_IPI",
+      "current_value": null,
+      "proposed_value": "NT",
+      "status": "CHANGE_REQUIRED",
+      "reason_code": "TIPI_RATE_DIVERGES_FROM_ERP",
+      "source_dataset": "TIPI_IPI",
+      "source_version": "d155f1baafb4039dcb74f97bb5abc1aec69f6760da9bd3f94a90bd40b33a2e9a",
+      "provenance": {
+        "engine_version": "0.1.0",
+        "decision_version": "mission-02",
+        "request_fingerprint": "ec2513128224e31f969063ad1d32625ff8f0994e55a7192b14cf1d39acb136e6"
+      },
+      "write_eligible": true
+    },
+    {
+      "product_code": "000011",
+      "field": "CEST",
+      "current_value": "",
+      "proposed_value": null,
+      "status": "UNRESOLVED",
+      "reason_code": "NO_CEST_MAPPING_FOUND_FOR_NCM",
+      "source_dataset": "CEST",
+      "source_version": "d7fb7e8da0ace05123d35c13d04486b70440cfa7323f983d8fc2f2fcfd1d54d3",
+      "provenance": {
+        "engine_version": "0.1.0",
+        "decision_version": "mission-02",
+        "request_fingerprint": "ec2513128224e31f969063ad1d32625ff8f0994e55a7192b14cf1d39acb136e6"
+      },
+      "write_eligible": false
+    },
+    {
+      "product_code": "000013",
+      "field": "ALIQ_IPI",
+      "current_value": null,
+      "proposed_value": "NT",
+      "status": "CHANGE_REQUIRED",
+      "reason_code": "TIPI_RATE_DIVERGES_FROM_ERP",
+      "source_dataset": "TIPI_IPI",
+      "source_version": "d155f1baafb4039dcb74f97bb5abc1aec69f6760da9bd3f94a90bd40b33a2e9a",
+      "provenance": {
+        "engine_version": "0.1.0",
+        "decision_version": "mission-02",
+        "request_fingerprint": "d4b4da1deeab1f18411f7881c858b56b930f3c1035c4a27a7e8ef2870774e2bb"
+      },
+      "write_eligible": true
+    },
+    {
+      "product_code": "000013",
+      "field": "CEST",
+      "current_value": "",
+      "proposed_value": null,
+      "status": "UNRESOLVED",
+      "reason_code": "NO_CEST_MAPPING_FOUND_FOR_NCM",
+      "source_dataset": "CEST",
+      "source_version": "d7fb7e8da0ace05123d35c13d04486b70440cfa7323f983d8fc2f2fcfd1d54d3",
+      "provenance": {
+        "engine_version": "0.1.0",
+        "decision_version": "mission-02",
+        "request_fingerprint": "d4b4da1deeab1f18411f7881c858b56b930f3c1035c4a27a7e8ef2870774e2bb"
+      },
+      "write_eligible": false
+    },
+    {
+      "product_code": "000015",
+      "field": "ALIQ_IPI",
+      "current_value": null,
+      "proposed_value": "NT",
+      "status": "CHANGE_REQUIRED",
+      "reason_code": "TIPI_RATE_DIVERGES_FROM_ERP",
+      "source_dataset": "TIPI_IPI",
+      "source_version": "d155f1baafb4039dcb74f97bb5abc1aec69f6760da9bd3f94a90bd40b33a2e9a",
+      "provenance": {
+        "engine_version": "0.1.0",
+        "decision_version": "mission-02",
+        "request_fingerprint": "ba57a075cffa8b343c147518fe03e9a2721d067299991664ed63238aebbc26ed"
+      },
+      "write_eligible": true
+    },
+    {
+      "product_code": "000015",
+      "field": "CEST",
+      "current_value": "",
+      "proposed_value": null,
+      "status": "UNRESOLVED",
+      "reason_code": "NO_CEST_MAPPING_FOUND_FOR_NCM",
+      "source_dataset": "CEST",
+      "source_version": "d7fb7e8da0ace05123d35c13d04486b70440cfa7323f983d8fc2f2fcfd1d54d3",
+      "provenance": {
+        "engine_version": "0.1.0",
+        "decision_version": "mission-02",
+        "request_fingerprint": "ba57a075cffa8b343c147518fe03e9a2721d067299991664ed63238aebbc26ed"
+      },
+      "write_eligible": false
+    },
+    {
+      "product_code": "000016",
+      "field": "CLASSIFICACAO_FISCAL",
+      "current_value": "02071400",
+      "proposed_value": null,
+      "status": "LEGACY_NCM_REVIEW",
+      "reason_code": "LEGACY_NCM_NO_AUTOMATIC_SUCCESSOR",
+      "source_dataset": "NCM",
+      "source_version": "3abc0d2eb2501bbd0cc3f5e0ee3774d33f091ea305e8127ee020e4009878987e",
+      "provenance": {
+        "engine_version": "0.1.0",
+        "decision_version": "mission-02",
+        "request_fingerprint": "4d7c735bd3d78e902cd44679b3db445d1effe8f27a029b5379e743260cd5dfe3"
+      },
+      "write_eligible": false
+    },
+    {
+      "product_code": "000017",
+      "field": "ALIQ_IPI",
+      "current_value": null,
+      "proposed_value": null,
+      "status": "SOURCE_BLANK",
+      "reason_code": "TIPI_RATE_SOURCE_BLANK",
+      "source_dataset": "TIPI_IPI",
+      "source_version": "d155f1baafb4039dcb74f97bb5abc1aec69f6760da9bd3f94a90bd40b33a2e9a",
+      "provenance": {
+        "engine_version": "0.1.0",
+        "decision_version": "mission-02",
+        "request_fingerprint": "21ca73685772908125fdb3e189d0bfcd51a77f3eed4e9a1bb7b2f6433881d379"
+      },
+      "write_eligible": false
+    },
+    {
+      "product_code": "000017",
+      "field": "CEST",
+      "current_value": "",
+      "proposed_value": null,
+      "status": "UNRESOLVED",
+      "reason_code": "NO_CEST_MAPPING_FOUND_FOR_NCM",
+      "source_dataset": "CEST",
+      "source_version": "d7fb7e8da0ace05123d35c13d04486b70440cfa7323f983d8fc2f2fcfd1d54d3",
+      "provenance": {
+        "engine_version": "0.1.0",
+        "decision_version": "mission-02",
+        "request_fingerprint": "21ca73685772908125fdb3e189d0bfcd51a77f3eed4e9a1bb7b2f6433881d379"
+      },
+      "write_eligible": false
+    },
+    {
+      "product_code": "000018",
+      "field": "ALIQ_IPI",
+      "current_value": null,
+      "proposed_value": null,
+      "status": "SOURCE_BLANK",
+      "reason_code": "TIPI_RATE_SOURCE_BLANK",
+      "source_dataset": "TIPI_IPI",
+      "source_version": "d155f1baafb4039dcb74f97bb5abc1aec69f6760da9bd3f94a90bd40b33a2e9a",
+      "provenance": {
+        "engine_version": "0.1.0",
+        "decision_version": "mission-02",
+        "request_fingerprint": "c00a786e4b3ce4aacbb1e47204292567af3dc49be4f497354607c66a8e1c7ad8"
+      },
+      "write_eligible": false
+    },
+    {
+      "product_code": "000018",
+      "field": "CEST",
+      "current_value": "",
+      "proposed_value": null,
+      "status": "UNRESOLVED",
+      "reason_code": "CEST_DESCRIPTION_SCORE_BELOW_THRESHOLD",
+      "source_dataset": "CEST",
+      "source_version": "d7fb7e8da0ace05123d35c13d04486b70440cfa7323f983d8fc2f2fcfd1d54d3",
+      "provenance": {
+        "engine_version": "0.1.0",
+        "decision_version": "mission-02",
+        "request_fingerprint": "c00a786e4b3ce4aacbb1e47204292567af3dc49be4f497354607c66a8e1c7ad8"
+      },
+      "write_eligible": false
+    },
+    {
+      "product_code": "000019",
+      "field": "ALIQ_IPI",
+      "current_value": null,
+      "proposed_value": "NT",
+      "status": "CHANGE_REQUIRED",
+      "reason_code": "TIPI_RATE_DIVERGES_FROM_ERP",
+      "source_dataset": "TIPI_IPI",
+      "source_version": "d155f1baafb4039dcb74f97bb5abc1aec69f6760da9bd3f94a90bd40b33a2e9a",
+      "provenance": {
+        "engine_version": "0.1.0",
+        "decision_version": "mission-02",
+        "request_fingerprint": "ff26dfa9954d7a3fdccd8033d973ab01724498c1d59b735facdfdbf169a476a8"
+      },
+      "write_eligible": true
+    },
+    {
+      "product_code": "000019",
+      "field": "CEST",
+      "current_value": "",
+      "proposed_value": null,
+      "status": "UNRESOLVED",
+      "reason_code": "NO_CEST_MAPPING_FOUND_FOR_NCM",
+      "source_dataset": "CEST",
+      "source_version": "d7fb7e8da0ace05123d35c13d04486b70440cfa7323f983d8fc2f2fcfd1d54d3",
+      "provenance": {
+        "engine_version": "0.1.0",
+        "decision_version": "mission-02",
+        "request_fingerprint": "ff26dfa9954d7a3fdccd8033d973ab01724498c1d59b735facdfdbf169a476a8"
+      },
+      "write_eligible": false
+    },
+    {
+      "product_code": "000021",
+      "field": "ALIQ_IPI",
+      "current_value": null,
+      "proposed_value": "NT",
+      "status": "CHANGE_REQUIRED",
+      "reason_code": "TIPI_RATE_DIVERGES_FROM_ERP",
+      "source_dataset": "TIPI_IPI",
+      "source_version": "d155f1baafb4039dcb74f97bb5abc1aec69f6760da9bd3f94a90bd40b33a2e9a",
+      "provenance": {
+        "engine_version": "0.1.0",
+        "decision_version": "mission-02",
+        "request_fingerprint": "7611a454105cac1d31692c1d049da55a7a855871e021de7daf96385d45632d3b"
+      },
+      "write_eligible": true
+    },
+    {
+      "product_code": "000021",
+      "field": "CEST",
+      "current_value": "",
+      "proposed_value": null,
+      "status": "UNRESOLVED",
+      "reason_code": "NO_CEST_MAPPING_FOUND_FOR_NCM",
+      "source_dataset": "CEST",
+      "source_version": "d7fb7e8da0ace05123d35c13d04486b70440cfa7323f983d8fc2f2fcfd1d54d3",
+      "provenance": {
+        "engine_version": "0.1.0",
+        "decision_version": "mission-02",
+        "request_fingerprint": "7611a454105cac1d31692c1d049da55a7a855871e021de7daf96385d45632d3b"
+      },
+      "write_eligible": false
+    },
+    {
+      "product_code": "000022",
+      "field": "ALIQ_IPI",
+      "current_value": null,
+      "proposed_value": "NT",
+      "status": "CHANGE_REQUIRED",
+      "reason_code": "TIPI_RATE_DIVERGES_FROM_ERP",
+      "source_dataset": "TIPI_IPI",
+      "source_version": "d155f1baafb4039dcb74f97bb5abc1aec69f6760da9bd3f94a90bd40b33a2e9a",
+      "provenance": {
+        "engine_version": "0.1.0",
+        "decision_version": "mission-02",
+        "request_fingerprint": "50fb43fdcc45474cdebe44a317c7e8bd3a1695389774e13185d98c51311ab3e2"
+      },
+      "write_eligible": true
+    },
+    {
+      "product_code": "000022",
+      "field": "CEST",
+      "current_value": "",
+      "proposed_value": null,
+      "status": "UNRESOLVED",
+      "reason_code": "NO_CEST_MAPPING_FOUND_FOR_NCM",
+      "source_dataset": "CEST",
+      "source_version": "d7fb7e8da0ace05123d35c13d04486b70440cfa7323f983d8fc2f2fcfd1d54d3",
+      "provenance": {
+        "engine_version": "0.1.0",
+        "decision_version": "mission-02",
+        "request_fingerprint": "50fb43fdcc45474cdebe44a317c7e8bd3a1695389774e13185d98c51311ab3e2"
+      },
+      "write_eligible": false
+    },
+    {
+      "product_code": "000023",
+      "field": "ALIQ_IPI",
+      "current_value": null,
+      "proposed_value": null,
+      "status": "SOURCE_BLANK",
+      "reason_code": "TIPI_RATE_SOURCE_BLANK",
+      "source_dataset": "TIPI_IPI",
+      "source_version": "d155f1baafb4039dcb74f97bb5abc1aec69f6760da9bd3f94a90bd40b33a2e9a",
+      "provenance": {
+        "engine_version": "0.1.0",
+        "decision_version": "mission-02",
+        "request_fingerprint": "13af6da7090e28ade50bc1944469fcb3fdf03f298f78db905ecc234fdf7845c3"
+      },
+      "write_eligible": false
+    },
+    {
+      "product_code": "000023",
+      "field": "CEST",
+      "current_value": "",
+      "proposed_value": null,
+      "status": "UNRESOLVED",
+      "reason_code": "CEST_DESCRIPTION_SCORE_BELOW_THRESHOLD",
+      "source_dataset": "CEST",
+      "source_version": "d7fb7e8da0ace05123d35c13d04486b70440cfa7323f983d8fc2f2fcfd1d54d3",
+      "provenance": {
+        "engine_version": "0.1.0",
+        "decision_version": "mission-02",
+        "request_fingerprint": "13af6da7090e28ade50bc1944469fcb3fdf03f298f78db905ecc234fdf7845c3"
+      },
+      "write_eligible": false
+    },
+    {
+      "product_code": "000024",
+      "field": "ALIQ_IPI",
+      "current_value": null,
+      "proposed_value": null,
+      "status": "SOURCE_BLANK",
+      "reason_code": "TIPI_RATE_SOURCE_BLANK",
+      "source_dataset": "TIPI_IPI",
+      "source_version": "d155f1baafb4039dcb74f97bb5abc1aec69f6760da9bd3f94a90bd40b33a2e9a",
+      "provenance": {
+        "engine_version": "0.1.0",
+        "decision_version": "mission-02",
+        "request_fingerprint": "0a8e6bedd4154e647b4e392dfb9138a6692e81d4f3d85495715c60a06644c0d5"
+      },
+      "write_eligible": false
+    },
+    {
+      "product_code": "000024",
+      "field": "CEST",
+      "current_value": "",
+      "proposed_value": null,
+      "status": "UNRESOLVED",
+      "reason_code": "CEST_DESCRIPTION_SCORE_BELOW_THRESHOLD",
+      "source_dataset": "CEST",
+      "source_version": "d7fb7e8da0ace05123d35c13d04486b70440cfa7323f983d8fc2f2fcfd1d54d3",
+      "provenance": {
+        "engine_version": "0.1.0",
+        "decision_version": "mission-02",
+        "request_fingerprint": "0a8e6bedd4154e647b4e392dfb9138a6692e81d4f3d85495715c60a06644c0d5"
+      },
+      "write_eligible": false
+    },
+    {
+      "product_code": "000025",
+      "field": "ALIQ_IPI",
+      "current_value": null,
+      "proposed_value": null,
+      "status": "SOURCE_BLANK",
+      "reason_code": "TIPI_RATE_SOURCE_BLANK",
+      "source_dataset": "TIPI_IPI",
+      "source_version": "d155f1baafb4039dcb74f97bb5abc1aec69f6760da9bd3f94a90bd40b33a2e9a",
+      "provenance": {
+        "engine_version": "0.1.0",
+        "decision_version": "mission-02",
+        "request_fingerprint": "a0b43b77137825496b3032f2f8ee288b02cc854055beb59305ebc7b781f54e16"
+      },
+      "write_eligible": false
+    },
+    {
+      "product_code": "000025",
+      "field": "CEST",
+      "current_value": "",
+      "proposed_value": null,
+      "status": "UNRESOLVED",
+      "reason_code": "CEST_DESCRIPTION_SCORE_BELOW_THRESHOLD",
+      "source_dataset": "CEST",
+      "source_version": "d7fb7e8da0ace05123d35c13d04486b70440cfa7323f983d8fc2f2fcfd1d54d3",
+      "provenance": {
+        "engine_version": "0.1.0",
+        "decision_version": "mission-02",
+        "request_fingerprint": "a0b43b77137825496b3032f2f8ee288b02cc854055beb59305ebc7b781f54e16"
+      },
+      "write_eligible": false
+    },
+    {
+      "product_code": "000026",
+      "field": "ALIQ_IPI",
+      "current_value": null,
+      "proposed_value": "3.25",
+      "status": "CHANGE_REQUIRED",
+      "reason_code": "TIPI_RATE_DIVERGES_FROM_ERP",
+      "source_dataset": "TIPI_IPI",
+      "source_version": "d155f1baafb4039dcb74f97bb5abc1aec69f6760da9bd3f94a90bd40b33a2e9a",
+      "provenance": {
+        "engine_version": "0.1.0",
+        "decision_version": "mission-02",
+        "request_fingerprint": "e401bf0f42be227a61f0121333707644b3e46f7f968c712dd6a2f040525e1e1a"
+      },
+      "write_eligible": true
+    },
+    {
+      "product_code": "000026",
+      "field": "CEST",
+      "current_value": "",
+      "proposed_value": null,
+      "status": "UNRESOLVED",
+      "reason_code": "NO_CEST_MAPPING_FOUND_FOR_NCM",
+      "source_dataset": "CEST",
+      "source_version": "d7fb7e8da0ace05123d35c13d04486b70440cfa7323f983d8fc2f2fcfd1d54d3",
+      "provenance": {
+        "engine_version": "0.1.0",
+        "decision_version": "mission-02",
+        "request_fingerprint": "e401bf0f42be227a61f0121333707644b3e46f7f968c712dd6a2f040525e1e1a"
+      },
+      "write_eligible": false
+    },
+    {
+      "product_code": "000027",
+      "field": "ALIQ_IPI",
+      "current_value": null,
+      "proposed_value": null,
+      "status": "SOURCE_BLANK",
+      "reason_code": "TIPI_RATE_SOURCE_BLANK",
+      "source_dataset": "TIPI_IPI",
+      "source_version": "d155f1baafb4039dcb74f97bb5abc1aec69f6760da9bd3f94a90bd40b33a2e9a",
+      "provenance": {
+        "engine_version": "0.1.0",
+        "decision_version": "mission-02",
+        "request_fingerprint": "f54f8cb9c5a9f118c1db4c2e91537a5b81c7c50b67698ad4776add27e2ce707a"
+      },
+      "write_eligible": false
+    },
+    {
+      "product_code": "000027",
+      "field": "CEST",
+      "current_value": "",
+      "proposed_value": null,
+      "status": "UNRESOLVED",
+      "reason_code": "CEST_DESCRIPTION_SCORE_BELOW_THRESHOLD",
+      "source_dataset": "CEST",
+      "source_version": "d7fb7e8da0ace05123d35c13d04486b70440cfa7323f983d8fc2f2fcfd1d54d3",
+      "provenance": {
+        "engine_version": "0.1.0",
+        "decision_version": "mission-02",
+        "request_fingerprint": "f54f8cb9c5a9f118c1db4c2e91537a5b81c7c50b67698ad4776add27e2ce707a"
+      },
+      "write_eligible": false
+    }
+  ],
+  "mva_evidence": [
+    {
+      "product_code": "000004",
+      "ncm": "07069000",
+      "status": "NO_MVA_MAPPING_FOUND",
+      "resolved": null,
+      "candidates": [],
+      "source_version": "d85b9328a5532a55a9105c9ba419d14005a2f9cd79b65d40964e07d636b6ce7e"
+    },
+    {
+      "product_code": "000005",
+      "ncm": "07069000",
+      "status": "NO_MVA_MAPPING_FOUND",
+      "resolved": null,
+      "candidates": [],
+      "source_version": "d85b9328a5532a55a9105c9ba419d14005a2f9cd79b65d40964e07d636b6ce7e"
+    },
+    {
+      "product_code": "000006",
+      "ncm": "07069000",
+      "status": "NO_MVA_MAPPING_FOUND",
+      "resolved": null,
+      "candidates": [],
+      "source_version": "d85b9328a5532a55a9105c9ba419d14005a2f9cd79b65d40964e07d636b6ce7e"
+    },
+    {
+      "product_code": "000008",
+      "ncm": "07069000",
+      "status": "NO_MVA_MAPPING_FOUND",
+      "resolved": null,
+      "candidates": [],
+      "source_version": "d85b9328a5532a55a9105c9ba419d14005a2f9cd79b65d40964e07d636b6ce7e"
+    },
+    {
+      "product_code": "000009",
+      "ncm": "07069000",
+      "status": "NO_MVA_MAPPING_FOUND",
+      "resolved": null,
+      "candidates": [],
+      "source_version": "d85b9328a5532a55a9105c9ba419d14005a2f9cd79b65d40964e07d636b6ce7e"
+    },
+    {
+      "product_code": "000010",
+      "ncm": "07069000",
+      "status": "NO_MVA_MAPPING_FOUND",
+      "resolved": null,
+      "candidates": [],
+      "source_version": "d85b9328a5532a55a9105c9ba419d14005a2f9cd79b65d40964e07d636b6ce7e"
+    },
+    {
+      "product_code": "000011",
+      "ncm": "07069000",
+      "status": "NO_MVA_MAPPING_FOUND",
+      "resolved": null,
+      "candidates": [],
+      "source_version": "d85b9328a5532a55a9105c9ba419d14005a2f9cd79b65d40964e07d636b6ce7e"
+    },
+    {
+      "product_code": "000013",
+      "ncm": "07069000",
+      "status": "NO_MVA_MAPPING_FOUND",
+      "resolved": null,
+      "candidates": [],
+      "source_version": "d85b9328a5532a55a9105c9ba419d14005a2f9cd79b65d40964e07d636b6ce7e"
+    },
+    {
+      "product_code": "000015",
+      "ncm": "07133321",
+      "status": "NO_MVA_MAPPING_FOUND",
+      "resolved": null,
+      "candidates": [],
+      "source_version": "d85b9328a5532a55a9105c9ba419d14005a2f9cd79b65d40964e07d636b6ce7e"
+    },
+    {
+      "product_code": "000016",
+      "ncm": "02071400",
+      "status": "LEGACY_NCM",
+      "resolved": null,
+      "candidates": [],
+      "source_version": "d85b9328a5532a55a9105c9ba419d14005a2f9cd79b65d40964e07d636b6ce7e"
+    },
+    {
+      "product_code": "000017",
+      "ncm": "03061790",
+      "status": "NO_MVA_MAPPING_FOUND",
+      "resolved": null,
+      "candidates": [],
+      "source_version": "d85b9328a5532a55a9105c9ba419d14005a2f9cd79b65d40964e07d636b6ce7e"
+    },
+    {
+      "product_code": "000018",
+      "ncm": "02071100",
+      "status": "MVA_CANDIDATES",
+      "resolved": null,
+      "candidates": [
+        {
+          "item": "11.25.0",
+          "cest": "17.087.00",
+          "mva_original": "25%",
+          "mva_adjusted": "50,94%",
+          "description": ", , e Carnes e demais produtos comestíveis frescos, resfriados, congelados, salgados, em salmoura, simplesmente temperados, secos ou defumados, resultantes do abate de aves, exceto os descritos no CEST Não tem (Alíq. ) (Alíq. ) (Alíq. )"
+        },
+        {
+          "item": "11.25.2",
+          "cest": "17.087.02",
+          "mva_original": "25%",
+          "mva_adjusted": "50,94%",
+          "description": "e Carnes de aves inteiras com peso unitário superior a 3Kg, temperadas Não tem (Alíq. ) (Alíq. ) (Alíq. )"
+        }
+      ],
+      "source_version": "d85b9328a5532a55a9105c9ba419d14005a2f9cd79b65d40964e07d636b6ce7e"
+    },
+    {
+      "product_code": "000019",
+      "ncm": "07133321",
+      "status": "NO_MVA_MAPPING_FOUND",
+      "resolved": null,
+      "candidates": [],
+      "source_version": "d85b9328a5532a55a9105c9ba419d14005a2f9cd79b65d40964e07d636b6ce7e"
+    },
+    {
+      "product_code": "000021",
+      "ncm": "07089000",
+      "status": "NO_MVA_MAPPING_FOUND",
+      "resolved": null,
+      "candidates": [],
+      "source_version": "d85b9328a5532a55a9105c9ba419d14005a2f9cd79b65d40964e07d636b6ce7e"
+    },
+    {
+      "product_code": "000022",
+      "ncm": "07089000",
+      "status": "NO_MVA_MAPPING_FOUND",
+      "resolved": null,
+      "candidates": [],
+      "source_version": "d85b9328a5532a55a9105c9ba419d14005a2f9cd79b65d40964e07d636b6ce7e"
+    },
+    {
+      "product_code": "000023",
+      "ncm": "16025000",
+      "status": "NO_MVA_MAPPING_FOUND",
+      "resolved": null,
+      "candidates": [],
+      "source_version": "d85b9328a5532a55a9105c9ba419d14005a2f9cd79b65d40964e07d636b6ce7e"
+    },
+    {
+      "product_code": "000024",
+      "ncm": "19022000",
+      "status": "MVA_CANDIDATES",
+      "resolved": null,
+      "candidates": [
+        {
+          "item": "11.6.1",
+          "cest": "17.048.00",
+          "mva_original": "20%",
+          "mva_adjusted": "44,91%",
+          "description": "Massas alimentícias, cozidas ou recheadas (de carne ou de outras substâncias) ou preparadas de outro modo, exceto as descritas nos CEST , e Prot. ICMS 53/17 - AL, BA, CE, PB, PE, PI, RN e SE (Alíq. ) (Alíq. ) (Alíq. ) ”"
+        },
+        {
+          "item": "11.6.2",
+          "cest": "17.048.02",
+          "mva_original": "20%",
+          "mva_adjusted": "44,91%",
+          "description": "Massas alimentícias recheadas (mesmo cozidas ou preparadas de outro modo) Prot. ICMS 53/17 - AL, BA, CE, PB, PE, PI, RN e SE (Alíq. ) (Alíq. ) (Alíq. )"
+        }
+      ],
+      "source_version": "d85b9328a5532a55a9105c9ba419d14005a2f9cd79b65d40964e07d636b6ce7e"
+    },
+    {
+      "product_code": "000025",
+      "ncm": "04061010",
+      "status": "NO_MVA_MAPPING_FOUND",
+      "resolved": null,
+      "candidates": [],
+      "source_version": "d85b9328a5532a55a9105c9ba419d14005a2f9cd79b65d40964e07d636b6ce7e"
+    },
+    {
+      "product_code": "000026",
+      "ncm": "03055100",
+      "status": "NO_MVA_MAPPING_FOUND",
+      "resolved": null,
+      "candidates": [],
+      "source_version": "d85b9328a5532a55a9105c9ba419d14005a2f9cd79b65d40964e07d636b6ce7e"
+    },
+    {
+      "product_code": "000027",
+      "ncm": "19022000",
+      "status": "MVA_CANDIDATES",
+      "resolved": null,
+      "candidates": [
+        {
+          "item": "11.6.1",
+          "cest": "17.048.00",
+          "mva_original": "20%",
+          "mva_adjusted": "44,91%",
+          "description": "Massas alimentícias, cozidas ou recheadas (de carne ou de outras substâncias) ou preparadas de outro modo, exceto as descritas nos CEST , e Prot. ICMS 53/17 - AL, BA, CE, PB, PE, PI, RN e SE (Alíq. ) (Alíq. ) (Alíq. ) ”"
+        },
+        {
+          "item": "11.6.2",
+          "cest": "17.048.02",
+          "mva_original": "20%",
+          "mva_adjusted": "44,91%",
+          "description": "Massas alimentícias recheadas (mesmo cozidas ou preparadas de outro modo) Prot. ICMS 53/17 - AL, BA, CE, PB, PE, PI, RN e SE (Alíq. ) (Alíq. ) (Alíq. )"
+        }
+      ],
+      "source_version": "d85b9328a5532a55a9105c9ba419d14005a2f9cd79b65d40964e07d636b6ce7e"
+    }
+  ],
+  "tipi_empty_rate_breakdown": {
+    "SOURCE_BLANK": 6
+  },
+  "write_eligible_count": 13,
+  "write_blocked_count": 26
+}

docs/DRY_RUN_PLAN_V4.json

@@ -0,0 +1,861 @@
+{
+  "artifact": "DRY_RUN_PLAN_V4",
+  "firebird_read": "OK",
+  "firebird_writes": 0,
+  "products_planned": 20,
+  "current_value_source": "live read-only SELECT from C000025 via docs/FIREBIRD_LIVE_20_V3.json",
+  "field_proposals": [
+    {
+      "product_code": "000004",
+      "field": "IPI",
+      "current_value": null,
+      "proposed_value": null,
+      "status": "NON_NUMERIC_IPI_STATUS",
+      "reason_code": "TIPI_RATE_NT_OR_NON_TAXED",
+      "source_dataset": "TIPI_IPI",
+      "source_version": "d155f1baafb4039dcb74f97bb5abc1aec69f6760da9bd3f94a90bd40b33a2e9a",
+      "provenance": {
+        "engine_version": "0.3.0",
+        "decision_version": "mission-04c-ipi-ex-split",
+        "request_fingerprint": "6707fcfe2ed6950f6bf56c5754c162ec5f7d5da63e7a01dda56f1de70b15f43e"
+      },
+      "write_eligible": false
+    },
+    {
+      "product_code": "000004",
+      "field": "CEST",
+      "current_value": "",
+      "proposed_value": null,
+      "status": "UNRESOLVED",
+      "reason_code": "NO_CEST_MAPPING_FOUND_FOR_NCM",
+      "source_dataset": "CEST",
+      "source_version": "d7fb7e8da0ace05123d35c13d04486b70440cfa7323f983d8fc2f2fcfd1d54d3",
+      "provenance": {
+        "engine_version": "0.3.0",
+        "decision_version": "mission-04c-ipi-ex-split",
+        "request_fingerprint": "6707fcfe2ed6950f6bf56c5754c162ec5f7d5da63e7a01dda56f1de70b15f43e"
+      },
+      "write_eligible": false
+    },
+    {
+      "product_code": "000005",
+      "field": "IPI",
+      "current_value": null,
+      "proposed_value": null,
+      "status": "NON_NUMERIC_IPI_STATUS",
+      "reason_code": "TIPI_RATE_NT_OR_NON_TAXED",
+      "source_dataset": "TIPI_IPI",
+      "source_version": "d155f1baafb4039dcb74f97bb5abc1aec69f6760da9bd3f94a90bd40b33a2e9a",
+      "provenance": {
+        "engine_version": "0.3.0",
+        "decision_version": "mission-04c-ipi-ex-split",
+        "request_fingerprint": "b1d43436a8d89dbdf27c24a6f7579c85a957c2a1eeacb58503e28f87aa4b8878"
+      },
+      "write_eligible": false
+    },
+    {
+      "product_code": "000005",
+      "field": "CEST",
+      "current_value": "",
+      "proposed_value": null,
+      "status": "UNRESOLVED",
+      "reason_code": "NO_CEST_MAPPING_FOUND_FOR_NCM",
+      "source_dataset": "CEST",
+      "source_version": "d7fb7e8da0ace05123d35c13d04486b70440cfa7323f983d8fc2f2fcfd1d54d3",
+      "provenance": {
+        "engine_version": "0.3.0",
+        "decision_version": "mission-04c-ipi-ex-split",
+        "request_fingerprint": "b1d43436a8d89dbdf27c24a6f7579c85a957c2a1eeacb58503e28f87aa4b8878"
+      },
+      "write_eligible": false
+    },
+    {
+      "product_code": "000006",
+      "field": "IPI",
+      "current_value": null,
+      "proposed_value": null,
+      "status": "NON_NUMERIC_IPI_STATUS",
+      "reason_code": "TIPI_RATE_NT_OR_NON_TAXED",
+      "source_dataset": "TIPI_IPI",
+      "source_version": "d155f1baafb4039dcb74f97bb5abc1aec69f6760da9bd3f94a90bd40b33a2e9a",
+      "provenance": {
+        "engine_version": "0.3.0",
+        "decision_version": "mission-04c-ipi-ex-split",
+        "request_fingerprint": "220b03204f2edeca7bb221bba101ff36c1d7bac09e633b53282784ac96c0eb7b"
+      },
+      "write_eligible": false
+    },
+    {
+      "product_code": "000006",
+      "field": "CEST",
+      "current_value": "",
+      "proposed_value": null,
+      "status": "UNRESOLVED",
+      "reason_code": "NO_CEST_MAPPING_FOUND_FOR_NCM",
+      "source_dataset": "CEST",
+      "source_version": "d7fb7e8da0ace05123d35c13d04486b70440cfa7323f983d8fc2f2fcfd1d54d3",
+      "provenance": {
+        "engine_version": "0.3.0",
+        "decision_version": "mission-04c-ipi-ex-split",
+        "request_fingerprint": "220b03204f2edeca7bb221bba101ff36c1d7bac09e633b53282784ac96c0eb7b"
+      },
+      "write_eligible": false
+    },
+    {
+      "product_code": "000008",
+      "field": "IPI",
+      "current_value": null,
+      "proposed_value": null,
+      "status": "NON_NUMERIC_IPI_STATUS",
+      "reason_code": "TIPI_RATE_NT_OR_NON_TAXED",
+      "source_dataset": "TIPI_IPI",
+      "source_version": "d155f1baafb4039dcb74f97bb5abc1aec69f6760da9bd3f94a90bd40b33a2e9a",
+      "provenance": {
+        "engine_version": "0.3.0",
+        "decision_version": "mission-04c-ipi-ex-split",
+        "request_fingerprint": "b1b40a1a80c25dfdeee8d34aedff6d4d4eee62b1f4f24ef44bc2ecc124f08b5b"
+      },
+      "write_eligible": false
+    },
+    {
+      "product_code": "000008",
+      "field": "CEST",
+      "current_value": "",
+      "proposed_value": null,
+      "status": "UNRESOLVED",
+      "reason_code": "NO_CEST_MAPPING_FOUND_FOR_NCM",
+      "source_dataset": "CEST",
+      "source_version": "d7fb7e8da0ace05123d35c13d04486b70440cfa7323f983d8fc2f2fcfd1d54d3",
+      "provenance": {
+        "engine_version": "0.3.0",
+        "decision_version": "mission-04c-ipi-ex-split",
+        "request_fingerprint": "b1b40a1a80c25dfdeee8d34aedff6d4d4eee62b1f4f24ef44bc2ecc124f08b5b"
+      },
+      "write_eligible": false
+    },
+    {
+      "product_code": "000009",
+      "field": "IPI",
+      "current_value": null,
+      "proposed_value": null,
+      "status": "NON_NUMERIC_IPI_STATUS",
+      "reason_code": "TIPI_RATE_NT_OR_NON_TAXED",
+      "source_dataset": "TIPI_IPI",
+      "source_version": "d155f1baafb4039dcb74f97bb5abc1aec69f6760da9bd3f94a90bd40b33a2e9a",
+      "provenance": {
+        "engine_version": "0.3.0",
+        "decision_version": "mission-04c-ipi-ex-split",
+        "request_fingerprint": "7ca20303a7265983b8757fb5379fd3ac1085fb183df159cabbb77c3ac4b006ae"
+      },
+      "write_eligible": false
+    },
+    {
+      "product_code": "000009",
+      "field": "CEST",
+      "current_value": "",
+      "proposed_value": null,
+      "status": "UNRESOLVED",
+      "reason_code": "NO_CEST_MAPPING_FOUND_FOR_NCM",
+      "source_dataset": "CEST",
+      "source_version": "d7fb7e8da0ace05123d35c13d04486b70440cfa7323f983d8fc2f2fcfd1d54d3",
+      "provenance": {
+        "engine_version": "0.3.0",
+        "decision_version": "mission-04c-ipi-ex-split",
+        "request_fingerprint": "7ca20303a7265983b8757fb5379fd3ac1085fb183df159cabbb77c3ac4b006ae"
+      },
+      "write_eligible": false
+    },
+    {
+      "product_code": "000010",
+      "field": "IPI",
+      "current_value": null,
+      "proposed_value": null,
+      "status": "NON_NUMERIC_IPI_STATUS",
+      "reason_code": "TIPI_RATE_NT_OR_NON_TAXED",
+      "source_dataset": "TIPI_IPI",
+      "source_version": "d155f1baafb4039dcb74f97bb5abc1aec69f6760da9bd3f94a90bd40b33a2e9a",
+      "provenance": {
+        "engine_version": "0.3.0",
+        "decision_version": "mission-04c-ipi-ex-split",
+        "request_fingerprint": "3e43d285e7462a74bbf5ec8cc63467233415ebf742d60589179ae6ba797ede10"
+      },
+      "write_eligible": false
+    },
+    {
+      "product_code": "000010",
+      "field": "CEST",
+      "current_value": "",
+      "proposed_value": null,
+      "status": "UNRESOLVED",
+      "reason_code": "NO_CEST_MAPPING_FOUND_FOR_NCM",
+      "source_dataset": "CEST",
+      "source_version": "d7fb7e8da0ace05123d35c13d04486b70440cfa7323f983d8fc2f2fcfd1d54d3",
+      "provenance": {
+        "engine_version": "0.3.0",
+        "decision_version": "mission-04c-ipi-ex-split",
+        "request_fingerprint": "3e43d285e7462a74bbf5ec8cc63467233415ebf742d60589179ae6ba797ede10"
+      },
+      "write_eligible": false
+    },
+    {
+      "product_code": "000011",
+      "field": "IPI",
+      "current_value": null,
+      "proposed_value": null,
+      "status": "NON_NUMERIC_IPI_STATUS",
+      "reason_code": "TIPI_RATE_NT_OR_NON_TAXED",
+      "source_dataset": "TIPI_IPI",
+      "source_version": "d155f1baafb4039dcb74f97bb5abc1aec69f6760da9bd3f94a90bd40b33a2e9a",
+      "provenance": {
+        "engine_version": "0.3.0",
+        "decision_version": "mission-04c-ipi-ex-split",
+        "request_fingerprint": "f495ba98a7a20065c1e467def10e0af9c2646c4797a274155d005b4db573be9a"
+      },
+      "write_eligible": false
+    },
+    {
+      "product_code": "000011",
+      "field": "CEST",
+      "current_value": "",
+      "proposed_value": null,
+      "status": "UNRESOLVED",
+      "reason_code": "NO_CEST_MAPPING_FOUND_FOR_NCM",
+      "source_dataset": "CEST",
+      "source_version": "d7fb7e8da0ace05123d35c13d04486b70440cfa7323f983d8fc2f2fcfd1d54d3",
+      "provenance": {
+        "engine_version": "0.3.0",
+        "decision_version": "mission-04c-ipi-ex-split",
+        "request_fingerprint": "f495ba98a7a20065c1e467def10e0af9c2646c4797a274155d005b4db573be9a"
+      },
+      "write_eligible": false
+    },
+    {
+      "product_code": "000013",
+      "field": "IPI",
+      "current_value": null,
+      "proposed_value": null,
+      "status": "NON_NUMERIC_IPI_STATUS",
+      "reason_code": "TIPI_RATE_NT_OR_NON_TAXED",
+      "source_dataset": "TIPI_IPI",
+      "source_version": "d155f1baafb4039dcb74f97bb5abc1aec69f6760da9bd3f94a90bd40b33a2e9a",
+      "provenance": {
+        "engine_version": "0.3.0",
+        "decision_version": "mission-04c-ipi-ex-split",
+        "request_fingerprint": "1cbd9c22447524e6ce8258a37e880add3f4332e67b538805836e41a99e2ce3b1"
+      },
+      "write_eligible": false
+    },
+    {
+      "product_code": "000013",
+      "field": "CEST",
+      "current_value": "",
+      "proposed_value": null,
+      "status": "UNRESOLVED",
+      "reason_code": "NO_CEST_MAPPING_FOUND_FOR_NCM",
+      "source_dataset": "CEST",
+      "source_version": "d7fb7e8da0ace05123d35c13d04486b70440cfa7323f983d8fc2f2fcfd1d54d3",
+      "provenance": {
+        "engine_version": "0.3.0",
+        "decision_version": "mission-04c-ipi-ex-split",
+        "request_fingerprint": "1cbd9c22447524e6ce8258a37e880add3f4332e67b538805836e41a99e2ce3b1"
+      },
+      "write_eligible": false
+    },
+    {
+      "product_code": "000015",
+      "field": "IPI",
+      "current_value": null,
+      "proposed_value": null,
+      "status": "NON_NUMERIC_IPI_STATUS",
+      "reason_code": "TIPI_RATE_NT_OR_NON_TAXED",
+      "source_dataset": "TIPI_IPI",
+      "source_version": "d155f1baafb4039dcb74f97bb5abc1aec69f6760da9bd3f94a90bd40b33a2e9a",
+      "provenance": {
+        "engine_version": "0.3.0",
+        "decision_version": "mission-04c-ipi-ex-split",
+        "request_fingerprint": "c14dbcfe9cd8e387b539aaba788f528e7ff5b41fe3d3cad76197d454e82a3ce9"
+      },
+      "write_eligible": false
+    },
+    {
+      "product_code": "000015",
+      "field": "CEST",
+      "current_value": "",
+      "proposed_value": null,
+      "status": "UNRESOLVED",
+      "reason_code": "NO_CEST_MAPPING_FOUND_FOR_NCM",
+      "source_dataset": "CEST",
+      "source_version": "d7fb7e8da0ace05123d35c13d04486b70440cfa7323f983d8fc2f2fcfd1d54d3",
+      "provenance": {
+        "engine_version": "0.3.0",
+        "decision_version": "mission-04c-ipi-ex-split",
+        "request_fingerprint": "c14dbcfe9cd8e387b539aaba788f528e7ff5b41fe3d3cad76197d454e82a3ce9"
+      },
+      "write_eligible": false
+    },
+    {
+      "product_code": "000016",
+      "field": "CLASSIFICACAO_FISCAL",
+      "current_value": "02071400",
+      "proposed_value": null,
+      "status": "LEGACY_NCM_REVIEW",
+      "reason_code": "LEGACY_NCM_NO_AUTOMATIC_SUCCESSOR",
+      "source_dataset": "NCM",
+      "source_version": "3abc0d2eb2501bbd0cc3f5e0ee3774d33f091ea305e8127ee020e4009878987e",
+      "provenance": {
+        "engine_version": "0.3.0",
+        "decision_version": "mission-04c-ipi-ex-split",
+        "request_fingerprint": "dd6ce4af90f1fdc69b5476f956c3444abff87b69d6ab2620a3937d5bf1728e7b"
+      },
+      "write_eligible": false
+    },
+    {
+      "product_code": "000017",
+      "field": "IPI",
+      "current_value": null,
+      "proposed_value": null,
+      "status": "SOURCE_BLANK",
+      "reason_code": "TIPI_RATE_SOURCE_BLANK",
+      "source_dataset": "TIPI_IPI",
+      "source_version": "d155f1baafb4039dcb74f97bb5abc1aec69f6760da9bd3f94a90bd40b33a2e9a",
+      "provenance": {
+        "engine_version": "0.3.0",
+        "decision_version": "mission-04c-ipi-ex-split",
+        "request_fingerprint": "f01257e3c86907b709c32c35ca9ab5d24760c1daf963baa4b8c3b57a2bb0d69b"
+      },
+      "write_eligible": false
+    },
+    {
+      "product_code": "000017",
+      "field": "CEST",
+      "current_value": "",
+      "proposed_value": null,
+      "status": "UNRESOLVED",
+      "reason_code": "NO_CEST_MAPPING_FOUND_FOR_NCM",
+      "source_dataset": "CEST",
+      "source_version": "d7fb7e8da0ace05123d35c13d04486b70440cfa7323f983d8fc2f2fcfd1d54d3",
+      "provenance": {
+        "engine_version": "0.3.0",
+        "decision_version": "mission-04c-ipi-ex-split",
+        "request_fingerprint": "f01257e3c86907b709c32c35ca9ab5d24760c1daf963baa4b8c3b57a2bb0d69b"
+      },
+      "write_eligible": false
+    },
+    {
+      "product_code": "000018",
+      "field": "IPI",
+      "current_value": null,
+      "proposed_value": null,
+      "status": "SOURCE_BLANK",
+      "reason_code": "TIPI_RATE_SOURCE_BLANK",
+      "source_dataset": "TIPI_IPI",
+      "source_version": "d155f1baafb4039dcb74f97bb5abc1aec69f6760da9bd3f94a90bd40b33a2e9a",
+      "provenance": {
+        "engine_version": "0.3.0",
+        "decision_version": "mission-04c-ipi-ex-split",
+        "request_fingerprint": "b2e5a8304a5c537e8fa5d9930613e6962bb434f429eb15e0a36fa08c2e13ae23"
+      },
+      "write_eligible": false
+    },
+    {
+      "product_code": "000018",
+      "field": "CEST",
+      "current_value": "",
+      "proposed_value": null,
+      "status": "UNRESOLVED",
+      "reason_code": "CEST_DESCRIPTION_SCORE_BELOW_THRESHOLD",
+      "source_dataset": "CEST",
+      "source_version": "d7fb7e8da0ace05123d35c13d04486b70440cfa7323f983d8fc2f2fcfd1d54d3",
+      "provenance": {
+        "engine_version": "0.3.0",
+        "decision_version": "mission-04c-ipi-ex-split",
+        "request_fingerprint": "b2e5a8304a5c537e8fa5d9930613e6962bb434f429eb15e0a36fa08c2e13ae23"
+      },
+      "write_eligible": false
+    },
+    {
+      "product_code": "000019",
+      "field": "IPI",
+      "current_value": null,
+      "proposed_value": null,
+      "status": "NON_NUMERIC_IPI_STATUS",
+      "reason_code": "TIPI_RATE_NT_OR_NON_TAXED",
+      "source_dataset": "TIPI_IPI",
+      "source_version": "d155f1baafb4039dcb74f97bb5abc1aec69f6760da9bd3f94a90bd40b33a2e9a",
+      "provenance": {
+        "engine_version": "0.3.0",
+        "decision_version": "mission-04c-ipi-ex-split",
+        "request_fingerprint": "46bba9c5f0f2479082105ba594a9bb806a468e4fada0e66f40dbcc249c3734ef"
+      },
+      "write_eligible": false
+    },
+    {
+      "product_code": "000019",
+      "field": "CEST",
+      "current_value": "",
+      "proposed_value": null,
+      "status": "UNRESOLVED",
+      "reason_code": "NO_CEST_MAPPING_FOUND_FOR_NCM",
+      "source_dataset": "CEST",
+      "source_version": "d7fb7e8da0ace05123d35c13d04486b70440cfa7323f983d8fc2f2fcfd1d54d3",
+      "provenance": {
+        "engine_version": "0.3.0",
+        "decision_version": "mission-04c-ipi-ex-split",
+        "request_fingerprint": "46bba9c5f0f2479082105ba594a9bb806a468e4fada0e66f40dbcc249c3734ef"
+      },
+      "write_eligible": false
+    },
+    {
+      "product_code": "000021",
+      "field": "IPI",
+      "current_value": null,
+      "proposed_value": null,
+      "status": "NON_NUMERIC_IPI_STATUS",
+      "reason_code": "TIPI_RATE_NT_OR_NON_TAXED",
+      "source_dataset": "TIPI_IPI",
+      "source_version": "d155f1baafb4039dcb74f97bb5abc1aec69f6760da9bd3f94a90bd40b33a2e9a",
+      "provenance": {
+        "engine_version": "0.3.0",
+        "decision_version": "mission-04c-ipi-ex-split",
+        "request_fingerprint": "2a70f4ef63cfb2fd3c06d61b9df0e8aee40f5ceba91afe7c0bb15048f0e50fda"
+      },
+      "write_eligible": false
+    },
+    {
+      "product_code": "000021",
+      "field": "CEST",
+      "current_value": "",
+      "proposed_value": null,
+      "status": "UNRESOLVED",
+      "reason_code": "NO_CEST_MAPPING_FOUND_FOR_NCM",
+      "source_dataset": "CEST",
+      "source_version": "d7fb7e8da0ace05123d35c13d04486b70440cfa7323f983d8fc2f2fcfd1d54d3",
+      "provenance": {
+        "engine_version": "0.3.0",
+        "decision_version": "mission-04c-ipi-ex-split",
+        "request_fingerprint": "2a70f4ef63cfb2fd3c06d61b9df0e8aee40f5ceba91afe7c0bb15048f0e50fda"
+      },
+      "write_eligible": false
+    },
+    {
+      "product_code": "000022",
+      "field": "IPI",
+      "current_value": null,
+      "proposed_value": null,
+      "status": "NON_NUMERIC_IPI_STATUS",
+      "reason_code": "TIPI_RATE_NT_OR_NON_TAXED",
+      "source_dataset": "TIPI_IPI",
+      "source_version": "d155f1baafb4039dcb74f97bb5abc1aec69f6760da9bd3f94a90bd40b33a2e9a",
+      "provenance": {
+        "engine_version": "0.3.0",
+        "decision_version": "mission-04c-ipi-ex-split",
+        "request_fingerprint": "3bb424889724ced30ec333419c1f6adeac79da5bc4c805716cdcffb862f3f4b4"
+      },
+      "write_eligible": false
+    },
+    {
+      "product_code": "000022",
+      "field": "CEST",
+      "current_value": "",
+      "proposed_value": null,
+      "status": "UNRESOLVED",
+      "reason_code": "NO_CEST_MAPPING_FOUND_FOR_NCM",
+      "source_dataset": "CEST",
+      "source_version": "d7fb7e8da0ace05123d35c13d04486b70440cfa7323f983d8fc2f2fcfd1d54d3",
+      "provenance": {
+        "engine_version": "0.3.0",
+        "decision_version": "mission-04c-ipi-ex-split",
+        "request_fingerprint": "3bb424889724ced30ec333419c1f6adeac79da5bc4c805716cdcffb862f3f4b4"
+      },
+      "write_eligible": false
+    },
+    {
+      "product_code": "000023",
+      "field": "IPI",
+      "current_value": null,
+      "proposed_value": null,
+      "status": "SOURCE_BLANK",
+      "reason_code": "TIPI_RATE_SOURCE_BLANK",
+      "source_dataset": "TIPI_IPI",
+      "source_version": "d155f1baafb4039dcb74f97bb5abc1aec69f6760da9bd3f94a90bd40b33a2e9a",
+      "provenance": {
+        "engine_version": "0.3.0",
+        "decision_version": "mission-04c-ipi-ex-split",
+        "request_fingerprint": "85ed15f56b496e558c03d9c1c820c9313df6e1f8cfc96d8ae8c8ef85d958f986"
+      },
+      "write_eligible": false
+    },
+    {
+      "product_code": "000023",
+      "field": "CEST",
+      "current_value": "",
+      "proposed_value": null,
+      "status": "UNRESOLVED",
+      "reason_code": "CEST_DESCRIPTION_SCORE_BELOW_THRESHOLD",
+      "source_dataset": "CEST",
+      "source_version": "d7fb7e8da0ace05123d35c13d04486b70440cfa7323f983d8fc2f2fcfd1d54d3",
+      "provenance": {
+        "engine_version": "0.3.0",
+        "decision_version": "mission-04c-ipi-ex-split",
+        "request_fingerprint": "85ed15f56b496e558c03d9c1c820c9313df6e1f8cfc96d8ae8c8ef85d958f986"
+      },
+      "write_eligible": false
+    },
+    {
+      "product_code": "000024",
+      "field": "IPI",
+      "current_value": null,
+      "proposed_value": null,
+      "status": "SOURCE_BLANK",
+      "reason_code": "TIPI_RATE_SOURCE_BLANK",
+      "source_dataset": "TIPI_IPI",
+      "source_version": "d155f1baafb4039dcb74f97bb5abc1aec69f6760da9bd3f94a90bd40b33a2e9a",
+      "provenance": {
+        "engine_version": "0.3.0",
+        "decision_version": "mission-04c-ipi-ex-split",
+        "request_fingerprint": "3839e7be0f7b2ab95386b971bb1da3700a03d4d5dccd388a4f648788ee7fbf1b"
+      },
+      "write_eligible": false
+    },
+    {
+      "product_code": "000024",
+      "field": "CEST",
+      "current_value": "",
+      "proposed_value": null,
+      "status": "UNRESOLVED",
+      "reason_code": "CEST_DESCRIPTION_SCORE_BELOW_THRESHOLD",
+      "source_dataset": "CEST",
+      "source_version": "d7fb7e8da0ace05123d35c13d04486b70440cfa7323f983d8fc2f2fcfd1d54d3",
+      "provenance": {
+        "engine_version": "0.3.0",
+        "decision_version": "mission-04c-ipi-ex-split",
+        "request_fingerprint": "3839e7be0f7b2ab95386b971bb1da3700a03d4d5dccd388a4f648788ee7fbf1b"
+      },
+      "write_eligible": false
+    },
+    {
+      "product_code": "000025",
+      "field": "IPI",
+      "current_value": null,
+      "proposed_value": null,
+      "status": "SOURCE_BLANK",
+      "reason_code": "TIPI_RATE_SOURCE_BLANK",
+      "source_dataset": "TIPI_IPI",
+      "source_version": "d155f1baafb4039dcb74f97bb5abc1aec69f6760da9bd3f94a90bd40b33a2e9a",
+      "provenance": {
+        "engine_version": "0.3.0",
+        "decision_version": "mission-04c-ipi-ex-split",
+        "request_fingerprint": "a71bc6eef21313d3e0ee44ac6e234154bc5433937e50026b5f4ceb6d49a05e73"
+      },
+      "write_eligible": false
+    },
+    {
+      "product_code": "000025",
+      "field": "CEST",
+      "current_value": "",
+      "proposed_value": null,
+      "status": "CANDIDATE",
+      "reason_code": "MULTIPLE_CEST_CANDIDATES_NO_SINGLE_EVIDENCE",
+      "source_dataset": "CEST",
+      "source_version": "d7fb7e8da0ace05123d35c13d04486b70440cfa7323f983d8fc2f2fcfd1d54d3",
+      "provenance": {
+        "engine_version": "0.3.0",
+        "decision_version": "mission-04c-ipi-ex-split",
+        "request_fingerprint": "a71bc6eef21313d3e0ee44ac6e234154bc5433937e50026b5f4ceb6d49a05e73"
+      },
+      "write_eligible": false
+    },
+    {
+      "product_code": "000026",
+      "field": "IPI",
+      "current_value": 3.25,
+      "proposed_value": 3.25,
+      "status": "SAME_VALUE",
+      "reason_code": "TIPI_MATCHES_CURRENT_ERP",
+      "source_dataset": "TIPI_IPI",
+      "source_version": "d155f1baafb4039dcb74f97bb5abc1aec69f6760da9bd3f94a90bd40b33a2e9a",
+      "provenance": {
+        "engine_version": "0.3.0",
+        "decision_version": "mission-04c-ipi-ex-split",
+        "request_fingerprint": "7a7a306fa25231819abfbec7bcf906012fe14d00adf56942224519701c09918d"
+      },
+      "write_eligible": false
+    },
+    {
+      "product_code": "000026",
+      "field": "CEST",
+      "current_value": "",
+      "proposed_value": null,
+      "status": "UNRESOLVED",
+      "reason_code": "NO_CEST_MAPPING_FOUND_FOR_NCM",
+      "source_dataset": "CEST",
+      "source_version": "d7fb7e8da0ace05123d35c13d04486b70440cfa7323f983d8fc2f2fcfd1d54d3",
+      "provenance": {
+        "engine_version": "0.3.0",
+        "decision_version": "mission-04c-ipi-ex-split",
+        "request_fingerprint": "7a7a306fa25231819abfbec7bcf906012fe14d00adf56942224519701c09918d"
+      },
+      "write_eligible": false
+    },
+    {
+      "product_code": "000027",
+      "field": "IPI",
+      "current_value": null,
+      "proposed_value": null,
+      "status": "SOURCE_BLANK",
+      "reason_code": "TIPI_RATE_SOURCE_BLANK",
+      "source_dataset": "TIPI_IPI",
+      "source_version": "d155f1baafb4039dcb74f97bb5abc1aec69f6760da9bd3f94a90bd40b33a2e9a",
+      "provenance": {
+        "engine_version": "0.3.0",
+        "decision_version": "mission-04c-ipi-ex-split",
+        "request_fingerprint": "4e9edf72de1f8168c1aa0fd191572e32516bd61803bdd6c030bc4372bad81ba4"
+      },
+      "write_eligible": false
+    },
+    {
+      "product_code": "000027",
+      "field": "CEST",
+      "current_value": "",
+      "proposed_value": null,
+      "status": "UNRESOLVED",
+      "reason_code": "CEST_DESCRIPTION_SCORE_BELOW_THRESHOLD",
+      "source_dataset": "CEST",
+      "source_version": "d7fb7e8da0ace05123d35c13d04486b70440cfa7323f983d8fc2f2fcfd1d54d3",
+      "provenance": {
+        "engine_version": "0.3.0",
+        "decision_version": "mission-04c-ipi-ex-split",
+        "request_fingerprint": "4e9edf72de1f8168c1aa0fd191572e32516bd61803bdd6c030bc4372bad81ba4"
+      },
+      "write_eligible": false
+    }
+  ],
+  "mva_evidence": [
+    {
+      "product_code": "000004",
+      "ncm": "07069000",
+      "status": "NO_MVA_MAPPING_FOUND",
+      "resolved": null,
+      "candidates": [],
+      "source_version": "d85b9328a5532a55a9105c9ba419d14005a2f9cd79b65d40964e07d636b6ce7e"
+    },
+    {
+      "product_code": "000005",
+      "ncm": "07069000",
+      "status": "NO_MVA_MAPPING_FOUND",
+      "resolved": null,
+      "candidates": [],
+      "source_version": "d85b9328a5532a55a9105c9ba419d14005a2f9cd79b65d40964e07d636b6ce7e"
+    },
+    {
+      "product_code": "000006",
+      "ncm": "07069000",
+      "status": "NO_MVA_MAPPING_FOUND",
+      "resolved": null,
+      "candidates": [],
+      "source_version": "d85b9328a5532a55a9105c9ba419d14005a2f9cd79b65d40964e07d636b6ce7e"
+    },
+    {
+      "product_code": "000008",
+      "ncm": "07069000",
+      "status": "NO_MVA_MAPPING_FOUND",
+      "resolved": null,
+      "candidates": [],
+      "source_version": "d85b9328a5532a55a9105c9ba419d14005a2f9cd79b65d40964e07d636b6ce7e"
+    },
+    {
+      "product_code": "000009",
+      "ncm": "07069000",
+      "status": "NO_MVA_MAPPING_FOUND",
+      "resolved": null,
+      "candidates": [],
+      "source_version": "d85b9328a5532a55a9105c9ba419d14005a2f9cd79b65d40964e07d636b6ce7e"
+    },
+    {
+      "product_code": "000010",
+      "ncm": "07069000",
+      "status": "NO_MVA_MAPPING_FOUND",
+      "resolved": null,
+      "candidates": [],
+      "source_version": "d85b9328a5532a55a9105c9ba419d14005a2f9cd79b65d40964e07d636b6ce7e"
+    },
+    {
+      "product_code": "000011",
+      "ncm": "07069000",
+      "status": "NO_MVA_MAPPING_FOUND",
+      "resolved": null,
+      "candidates": [],
+      "source_version": "d85b9328a5532a55a9105c9ba419d14005a2f9cd79b65d40964e07d636b6ce7e"
+    },
+    {
+      "product_code": "000013",
+      "ncm": "07069000",
+      "status": "NO_MVA_MAPPING_FOUND",
+      "resolved": null,
+      "candidates": [],
+      "source_version": "d85b9328a5532a55a9105c9ba419d14005a2f9cd79b65d40964e07d636b6ce7e"
+    },
+    {
+      "product_code": "000015",
+      "ncm": "07133321",
+      "status": "NO_MVA_MAPPING_FOUND",
+      "resolved": null,
+      "candidates": [],
+      "source_version": "d85b9328a5532a55a9105c9ba419d14005a2f9cd79b65d40964e07d636b6ce7e"
+    },
+    {
+      "product_code": "000016",
+      "ncm": "02071400",
+      "status": "LEGACY_NCM",
+      "resolved": null,
+      "candidates": [],
+      "source_version": "d85b9328a5532a55a9105c9ba419d14005a2f9cd79b65d40964e07d636b6ce7e"
+    },
+    {
+      "product_code": "000017",
+      "ncm": "03061790",
+      "status": "NO_MVA_MAPPING_FOUND",
+      "resolved": null,
+      "candidates": [],
+      "source_version": "d85b9328a5532a55a9105c9ba419d14005a2f9cd79b65d40964e07d636b6ce7e"
+    },
+    {
+      "product_code": "000018",
+      "ncm": "02071100",
+      "status": "MVA_CANDIDATES",
+      "resolved": null,
+      "candidates": [
+        {
+          "item": "11.25.0",
+          "cest": "17.087.00",
+          "mva_original": "25%",
+          "mva_adjusted": "50,94%",
+          "description": ", , e Carnes e demais produtos comestíveis frescos, resfriados, congelados, salgados, em salmoura, simplesmente temperados, secos ou defumados, resultantes do abate de aves, exceto os descritos no CEST Não tem (Alíq. ) (Alíq. ) (Alíq. )"
+        },
+        {
+          "item": "11.25.2",
+          "cest": "17.087.02",
+          "mva_original": "25%",
+          "mva_adjusted": "50,94%",
+          "description": "e Carnes de aves inteiras com peso unitário superior a 3Kg, temperadas Não tem (Alíq. ) (Alíq. ) (Alíq. )"
+        }
+      ],
+      "source_version": "d85b9328a5532a55a9105c9ba419d14005a2f9cd79b65d40964e07d636b6ce7e"
+    },
+    {
+      "product_code": "000019",
+      "ncm": "07133321",
+      "status": "NO_MVA_MAPPING_FOUND",
+      "resolved": null,
+      "candidates": [],
+      "source_version": "d85b9328a5532a55a9105c9ba419d14005a2f9cd79b65d40964e07d636b6ce7e"
+    },
+    {
+      "product_code": "000021",
+      "ncm": "07089000",
+      "status": "NO_MVA_MAPPING_FOUND",
+      "resolved": null,
+      "candidates": [],
+      "source_version": "d85b9328a5532a55a9105c9ba419d14005a2f9cd79b65d40964e07d636b6ce7e"
+    },
+    {
+      "product_code": "000022",
+      "ncm": "07089000",
+      "status": "NO_MVA_MAPPING_FOUND",
+      "resolved": null,
+      "candidates": [],
+      "source_version": "d85b9328a5532a55a9105c9ba419d14005a2f9cd79b65d40964e07d636b6ce7e"
+    },
+    {
+      "product_code": "000023",
+      "ncm": "16025000",
+      "status": "NO_MVA_MAPPING_FOUND",
+      "resolved": null,
+      "candidates": [],
+      "source_version": "d85b9328a5532a55a9105c9ba419d14005a2f9cd79b65d40964e07d636b6ce7e"
+    },
+    {
+      "product_code": "000024",
+      "ncm": "19022000",
+      "status": "MVA_CANDIDATES",
+      "resolved": null,
+      "candidates": [
+        {
+          "item": "11.6.1",
+          "cest": "17.048.00",
+          "mva_original": "20%",
+          "mva_adjusted": "44,91%",
+          "description": "Massas alimentícias, cozidas ou recheadas (de carne ou de outras substâncias) ou preparadas de outro modo, exceto as descritas nos CEST , e Prot. ICMS 53/17 - AL, BA, CE, PB, PE, PI, RN e SE (Alíq. ) (Alíq. ) (Alíq. ) ”"
+        },
+        {
+          "item": "11.6.2",
+          "cest": "17.048.02",
+          "mva_original": "20%",
+          "mva_adjusted": "44,91%",
+          "description": "Massas alimentícias recheadas (mesmo cozidas ou preparadas de outro modo) Prot. ICMS 53/17 - AL, BA, CE, PB, PE, PI, RN e SE (Alíq. ) (Alíq. ) (Alíq. )"
+        }
+      ],
+      "source_version": "d85b9328a5532a55a9105c9ba419d14005a2f9cd79b65d40964e07d636b6ce7e"
+    },
+    {
+      "product_code": "000025",
+      "ncm": "04061010",
+      "status": "NO_MVA_MAPPING_FOUND",
+      "resolved": null,
+      "candidates": [],
+      "source_version": "d85b9328a5532a55a9105c9ba419d14005a2f9cd79b65d40964e07d636b6ce7e"
+    },
+    {
+      "product_code": "000026",
+      "ncm": "03055100",
+      "status": "NO_MVA_MAPPING_FOUND",
+      "resolved": null,
+      "candidates": [],
+      "source_version": "d85b9328a5532a55a9105c9ba419d14005a2f9cd79b65d40964e07d636b6ce7e"
+    },
+    {
+      "product_code": "000027",
+      "ncm": "19022000",
+      "status": "MVA_CANDIDATES",
+      "resolved": null,
+      "candidates": [
+        {
+          "item": "11.6.1",
+          "cest": "17.048.00",
+          "mva_original": "20%",
+          "mva_adjusted": "44,91%",
+          "description": "Massas alimentícias, cozidas ou recheadas (de carne ou de outras substâncias) ou preparadas de outro modo, exceto as descritas nos CEST , e Prot. ICMS 53/17 - AL, BA, CE, PB, PE, PI, RN e SE (Alíq. ) (Alíq. ) (Alíq. ) ”"
+        },
+        {
+          "item": "11.6.2",
+          "cest": "17.048.02",
+          "mva_original": "20%",
+          "mva_adjusted": "44,91%",
+          "description": "Massas alimentícias recheadas (mesmo cozidas ou preparadas de outro modo) Prot. ICMS 53/17 - AL, BA, CE, PB, PE, PI, RN e SE (Alíq. ) (Alíq. ) (Alíq. )"
+        }
+      ],
+      "source_version": "d85b9328a5532a55a9105c9ba419d14005a2f9cd79b65d40964e07d636b6ce7e"
+    }
+  ],
+  "ipi_metrics": {
+    "ipi_numeric_proposals": 1,
+    "ipi_non_numeric_status": 12,
+    "ipi_source_blank": 6,
+    "ipi_same_value": 1,
+    "ipi_change_required": 0,
+    "ipi_write_eligible": 0,
+    "ex_tipi_db_match_products": 0,
+    "ex_tipi_concrete_proposals": 0,
+    "ex_tipi_candidates": 0,
+    "ex_tipi_write_eligible": 0
+  },
+  "cest_metrics": {
+    "cest_db_match_products": 5,
+    "cest_confirmed": 0,
+    "cest_candidates": 1,
+    "cest_unresolved": 18,
+    "cest_write_eligible": 0
+  },
+  "write_eligible_count": 0,
+  "write_blocked_count": 39
+}

docs/DUPLICATE_KEY_MMMODAS_V1.md

@@ -0,0 +1,9 @@
+# MMMODAS — CODIGO 017421 duplicado (investigação)
+
+- `gfix -v -n` (validação somente leitura) em `Banco\MMMODAS.FDB`: exit 0, sem erros (`docs/runs/dupkey/gfix_validate_readonly.txt`). **Não é corrupção.**
+- Causa: o índice `PK_C000025` está **INATIVO** (`RDB$INDEX_INACTIVE=1`). Com a PK inativa o Firebird não impõe unicidade; toda consulta por CODIGO faz varredura natural (`PLAN (C000025 NATURAL)`).
+- As duas linhas são **produtos diferentes** (`CAM POLO ANIBAL NICO`, grupo 000036, NCM 61051000 × `CHINELO MASC NEW MHL`, grupo 000068, NCM 64022000). Duplicata física legítima, não artefato de índice.
+- Histórico referencia o código sem distinguir: C000100 (2 linhas), C000032 (14), C000088 (4). Não dá para dizer a qual produto cada movimento pertence.
+- Índices inativos são sistêmicos nas cópias (CONSTRUCAO 20, MMMODAS 27, RINCAO 91, TESTESOFICIAIS 68, UNIAO 0; `docs/runs/dupkey/inactive_indexes.json`): característica de como as cópias foram geradas.
+- Identificador físico alternativo existe (`RDB$DB_KEY`), mas seria usar uma chave que muda em backup/restore para escrever em duas linhas de identidade ambígua. Reativar a PK falha enquanto houver duplicata; recodificar exige decisão de negócio (qual produto fica com 017421 e como tratar os 20 movimentos).
+- **Decisão técnica:** nenhum UPDATE. As 46 células (2 linhas × 23 campos) permanecem `MANUAL_INPUT_REQUIRED (DUPLICATE_KEY_BLOCKED)`. Remédio para o operador: escolher qual produto recebe novo código, recodificar (com histórico) e então `ALTER INDEX PK_C000025 ACTIVE`.

docs/ERP_FISCAL_FIELD_MAP_V1.json

@@ -0,0 +1,537 @@
+{
+ "artifact": "ERP_FISCAL_FIELD_MAP_V1",
+ "database": "TESTESOFICIAIS.FDB (read-only)",
+ "firebird_writes": 0,
+ "evidence_sources": [
+  "live RDB$ catalog (334 tables)",
+  "value distributions",
+  "NFCE_ITENS history join",
+  "vendor scripts D:/PROJETOS/GTISISTEMAS/Diretorios/rel/Novo_Script_Banco.sql + atualiza/v3.5.5.NFCe/script/*"
+ ],
+ "caveat": "57% of NFC-e items with an NCM carry a different NCM than the product currently has for the same CODPRODUTO (identity drift); history comparisons are therefore reported on identity-consistent joins.",
+ "fields": [
+  {
+   "table": "C000025",
+   "field": "CFOP",
+   "db_type": "VARCHAR(4)",
+   "semantic_name": "CFOP padrão de saída do produto",
+   "usage_class": "PRODUCT_DEFAULT",
+   "confidence": "HIGH",
+   "evidence": "NFC-e item CFOP equals product default in 29570/30785 joined items (identity-consistent: 1231/1241); values are official 5xxx CFOPs; item CFOP is the emitted value. Still operation-dependent (C000030 naturezas carry 5102/5405/6102...).",
+   "source_objects": [
+    "C000025",
+    "NFCE_ITENS",
+    "C000030"
+   ],
+   "sample_values": [
+    "5102",
+    "5405",
+    "5656"
+   ],
+   "write_candidate": false
+  },
+  {
+   "table": "C000025",
+   "field": "CFOP_ENTRADA",
+   "db_type": "CHAR(4)",
+   "semantic_name": "CFOP padrão de entrada (campo existe no DDL do fornecedor)",
+   "usage_class": "LEGACY_UNUSED",
+   "confidence": "MEDIUM",
+   "evidence": "0/521 populated; DDL exists (vendor scripts D:/PROJETOS/GTISISTEMAS/Diretorios/rel/Novo_Script_Banco.sql + atualiza/v3.5.5.NFCe/script/*); company-level default lives in C000001.IND_CFOP_ENTRADA=1949",
+   "source_objects": [
+    "C000025",
+    "C000001"
+   ],
+   "sample_values": [
+    null
+   ],
+   "write_candidate": false
+  },
+  {
+   "table": "C000025",
+   "field": "CST",
+   "db_type": "VARCHAR(10)",
+   "semantic_name": "CST ICMS de saída = origem(1)+CST(2)",
+   "usage_class": "PRODUCT_DEFAULT",
+   "confidence": "HIGH",
+   "evidence": "vendor table C000083 (11 rows 000..090 'NACIONAL ...') defines CST as 3-digit origin+CST; NFC-e item CST matches product default in 1241/1241 identity-consistent joins",
+   "source_objects": [
+    "C000025",
+    "C000083",
+    "NFCE_ITENS"
+   ],
+   "sample_values": [
+    "040",
+    "000",
+    "060"
+   ],
+   "write_candidate": false
+  },
+  {
+   "table": "C000025",
+   "field": "CST_ENTRADA",
+   "db_type": "CHAR(4)",
+   "semantic_name": "CST padrão de entrada",
+   "usage_class": "LEGACY_UNUSED",
+   "confidence": "MEDIUM",
+   "evidence": "0/521 populated; DDL exists in vendor scripts",
+   "source_objects": [
+    "C000025"
+   ],
+   "sample_values": [
+    null
+   ],
+   "write_candidate": false
+  },
+  {
+   "table": "C000025",
+   "field": "CSOSN",
+   "db_type": "VARCHAR(60)",
+   "semantic_name": "CSOSN de saída (Simples Nacional)",
+   "usage_class": "PRODUCT_DEFAULT",
+   "confidence": "HIGH",
+   "evidence": "NFC-e item CSOSN equals product default in 1179/1241 identity-consistent joins; company default C000004.ICMS_CSOSN=102; values 101/102/103/500 in CSOSN dataset",
+   "source_objects": [
+    "C000025",
+    "C000004",
+    "NFCE_ITENS"
+   ],
+   "sample_values": [
+    "102",
+    "500",
+    "101"
+   ],
+   "write_candidate": false
+  },
+  {
+   "table": "C000025",
+   "field": "GRUPO_ICMS",
+   "db_type": "VARCHAR(9)",
+   "semantic_name": "grupo ICMS do produto (espelha CSOSN/ST nas NFC-e)",
+   "usage_class": "PRODUCT_DEFAULT",
+   "confidence": "MEDIUM",
+   "evidence": "487 '102', 2 '90'; NFCE_ITENS.GRUPO_ICMS carries 102/500/blank; exact semantics not documented",
+   "source_objects": [
+    "C000025",
+    "NFCE_ITENS"
+   ],
+   "sample_values": [
+    "102",
+    "90"
+   ],
+   "write_candidate": false
+  },
+  {
+   "table": "C000025",
+   "field": "ORIGEM",
+   "db_type": "VARCHAR(1)",
+   "semantic_name": "origem (campo textual legado)",
+   "usage_class": "LEGACY_UNUSED",
+   "confidence": "HIGH",
+   "evidence": "0/521 and 0/4905 (C000032.ORIGEM) populated",
+   "source_objects": [
+    "C000025",
+    "C000032"
+   ],
+   "sample_values": [
+    null
+   ],
+   "write_candidate": false
+  },
+  {
+   "table": "C000025",
+   "field": "COD_ORIGEM_MERCADORIA",
+   "db_type": "INTEGER",
+   "semantic_name": "código de origem da mercadoria (0-8)",
+   "usage_class": "PRODUCT_DEFAULT",
+   "confidence": "LOW",
+   "evidence": "exists in vendor DDL as INTEGER; only 1/521 populated (value 2); origin is otherwise embedded in CST digit 1; not used in any emitted NFC-e column",
+   "source_objects": [
+    "C000025"
+   ],
+   "sample_values": [
+    2
+   ],
+   "write_candidate": false
+  },
+  {
+   "table": "C000025",
+   "field": "COD_ENTRADA_PIS",
+   "db_type": "VARCHAR(3)",
+   "semantic_name": "CST PIS de entrada",
+   "usage_class": "LEGACY_UNUSED",
+   "confidence": "LOW",
+   "evidence": "2/521 populated with inconsistent formatting ('2','73')",
+   "source_objects": [
+    "C000025"
+   ],
+   "sample_values": [
+    "2",
+    "73"
+   ],
+   "write_candidate": false
+  },
+  {
+   "table": "C000025",
+   "field": "COD_SAIDA_PIS",
+   "db_type": "VARCHAR(3)",
+   "semantic_name": "CST PIS de saída",
+   "usage_class": "LEGACY_UNUSED",
+   "confidence": "LOW",
+   "evidence": "3/521 populated ('01','04','2'); NFC-e items carry CST_PIS_COFINS '01' regardless, so the product field is not the source",
+   "source_objects": [
+    "C000025",
+    "NFCE_ITENS"
+   ],
+   "sample_values": [
+    "01",
+    "04",
+    "2"
+   ],
+   "write_candidate": false
+  },
+  {
+   "table": "C000025",
+   "field": "COD_ENTRADA_COFINS",
+   "db_type": "VARCHAR(3)",
+   "semantic_name": "CST COFINS de entrada",
+   "usage_class": "LEGACY_UNUSED",
+   "confidence": "LOW",
+   "evidence": "2/521 populated",
+   "source_objects": [
+    "C000025"
+   ],
+   "sample_values": [
+    "2",
+    "73"
+   ],
+   "write_candidate": false
+  },
+  {
+   "table": "C000025",
+   "field": "COD_SAIDA_COFINS",
+   "db_type": "VARCHAR(3)",
+   "semantic_name": "CST COFINS de saída",
+   "usage_class": "LEGACY_UNUSED",
+   "confidence": "LOW",
+   "evidence": "3/521 populated",
+   "source_objects": [
+    "C000025"
+   ],
+   "sample_values": [
+    "01",
+    "04",
+    "2"
+   ],
+   "write_candidate": false
+  },
+  {
+   "table": "C000025",
+   "field": "ALIQ_PIS",
+   "db_type": "VARCHAR(8)",
+   "semantic_name": "alíquota PIS (texto)",
+   "usage_class": "LEGACY_UNUSED",
+   "confidence": "LOW",
+   "evidence": "3/521 populated; NFC-e ALIQUOTA_PIS is always 0 (Simples)",
+   "source_objects": [
+    "C000025",
+    "NFCE_ITENS"
+   ],
+   "sample_values": [
+    "0,65",
+    "2"
+   ],
+   "write_candidate": false
+  },
+  {
+   "table": "C000025",
+   "field": "ALIQ_COFINS",
+   "db_type": "VARCHAR(8)",
+   "semantic_name": "alíquota COFINS (texto)",
+   "usage_class": "LEGACY_UNUSED",
+   "confidence": "LOW",
+   "evidence": "3/521 populated; NFC-e ALIQUOTA_COFINS is always 0",
+   "source_objects": [
+    "C000025",
+    "NFCE_ITENS"
+   ],
+   "sample_values": [
+    "2",
+    "3"
+   ],
+   "write_candidate": false
+  },
+  {
+   "table": "C000025",
+   "field": "CST_IPI",
+   "db_type": "SMALLINT",
+   "semantic_name": "CST do IPI",
+   "usage_class": "LEGACY_UNUSED",
+   "confidence": "LOW",
+   "evidence": "1/521 populated ('040', 3 digits although IPI CST has 2)",
+   "source_objects": [
+    "C000025"
+   ],
+   "sample_values": [
+    "040"
+   ],
+   "write_candidate": false
+  },
+  {
+   "table": "C000025",
+   "field": "INCIDENCIA_PISCOFINS",
+   "db_type": "VARCHAR(30)",
+   "semantic_name": "tipo de incidência PIS/COFINS do produto",
+   "usage_class": "PRODUCT_DEFAULT",
+   "confidence": "HIGH",
+   "evidence": "NENHUMA 519, MONOFÁSICA 1, SUBST.TRIBUTÁRIA 1; ties to C000025.PISCOFINS flag (N/S)",
+   "source_objects": [
+    "C000025"
+   ],
+   "sample_values": [
+    "NENHUMA",
+    "MONOFÁSICA"
+   ],
+   "write_candidate": false
+  },
+  {
+   "table": "C000025",
+   "field": "CEST",
+   "db_type": "VARCHAR(7)",
+   "semantic_name": "CEST do produto (7 dígitos sem pontuação)",
+   "usage_class": "PRODUCT_DEFAULT",
+   "confidence": "HIGH",
+   "evidence": "NFC-e item CEST digits equal product CEST in 1231/1240 identity-consistent joins",
+   "source_objects": [
+    "C000025",
+    "NFCE_ITENS"
+   ],
+   "sample_values": [
+    "0601100",
+    "1708400"
+   ],
+   "write_candidate": true
+  },
+  {
+   "table": "C000025",
+   "field": "IPI",
+   "db_type": "DOUBLE PRECISION",
+   "semantic_name": "alíquota de IPI %",
+   "usage_class": "PRODUCT_DEFAULT",
+   "confidence": "HIGH",
+   "evidence": "confirmed in earlier missions and post-write verified; 109 populated",
+   "source_objects": [
+    "C000025"
+   ],
+   "sample_values": [
+    19.5,
+    3.25
+   ],
+   "write_candidate": true
+  },
+  {
+   "table": "C000025",
+   "field": "EX_TIPI",
+   "db_type": "VARCHAR(3)",
+   "semantic_name": "código EX da TIPI",
+   "usage_class": "PRODUCT_DEFAULT",
+   "confidence": "HIGH",
+   "evidence": "confirmed in earlier missions; 0 populated",
+   "source_objects": [
+    "C000025"
+   ],
+   "sample_values": [
+    null
+   ],
+   "write_candidate": true
+  },
+  {
+   "table": "C000025",
+   "field": "ALIQUOTA",
+   "db_type": "NUMERIC(15,2)",
+   "semantic_name": "alíquota ICMS % do produto",
+   "usage_class": "UNKNOWN",
+   "confidence": "LOW",
+   "evidence": "product default 20.5 (492 rows) but NFC-e items use ALIQUOTA 18 (29825 rows) — product value is not what is emitted",
+   "source_objects": [
+    "C000025",
+    "NFCE_ITENS"
+   ],
+   "sample_values": [
+    20.5,
+    17
+   ],
+   "write_candidate": false
+  },
+  {
+   "table": "C000025",
+   "field": "MARGEM_AGREGADA",
+   "db_type": "NUMERIC(15,2)",
+   "semantic_name": "candidato a MVA/margem de ST",
+   "usage_class": "LEGACY_UNUSED",
+   "confidence": "LOW",
+   "evidence": "0/521 populated; C000062.MARGEM_AGREGADA is 0.0 in all 693 rows even though ICMS_SUB<>0 in 2 rows (no calculation use evidenced); group-level PRODUTOS_MARGEM_AGREGADA(MVA_INDUSTRIA/MVA_DISTRIBUIDOR) has 0 rows and no link to C000025",
+   "source_objects": [
+    "C000025",
+    "C000062",
+    "PRODUTOS_MARGEM_AGREGADA"
+   ],
+   "sample_values": [
+    null
+   ],
+   "write_candidate": false
+  },
+  {
+   "table": "C000004",
+   "field": "CRT",
+   "db_type": "VARCHAR(1)",
+   "semantic_name": "código de regime tributário da empresa",
+   "usage_class": "COMPANY_DEPENDENT",
+   "confidence": "HIGH",
+   "evidence": "value 1; EMISSOR.EMITENTE_CRT=1 agrees; OPTANTE_SIMPLES=S",
+   "source_objects": [
+    "C000004",
+    "EMISSOR"
+   ],
+   "sample_values": [
+    "1"
+   ],
+   "write_candidate": false
+  },
+  {
+   "table": "C000004",
+   "field": "UF",
+   "db_type": "VARCHAR(2)",
+   "semantic_name": "UF do emitente",
+   "usage_class": "COMPANY_DEPENDENT",
+   "confidence": "HIGH",
+   "evidence": "BA; matches IBGE 2928703 (Bahia)",
+   "source_objects": [
+    "C000004"
+   ],
+   "sample_values": [
+    "BA"
+   ],
+   "write_candidate": false
+  },
+  {
+   "table": "C000004",
+   "field": "ICMS_CSOSN",
+   "db_type": "VARCHAR(150)",
+   "semantic_name": "CSOSN padrão da empresa",
+   "usage_class": "COMPANY_DEPENDENT",
+   "confidence": "MEDIUM",
+   "evidence": "value 102; equals 487/521 product defaults",
+   "source_objects": [
+    "C000004"
+   ],
+   "sample_values": [
+    "102"
+   ],
+   "write_candidate": false
+  },
+  {
+   "table": "C000004",
+   "field": "SUBSTITUTO_TRIBUTARIO / CONTRIBUINTE_IPI / OPTANTE_SIMPLES",
+   "db_type": "VARCHAR(1)",
+   "semantic_name": "flags fiscais da empresa",
+   "usage_class": "COMPANY_DEPENDENT",
+   "confidence": "HIGH",
+   "evidence": "N / N / S",
+   "source_objects": [
+    "C000004"
+   ],
+   "sample_values": [
+    "N",
+    "N",
+    "S"
+   ],
+   "write_candidate": false
+  },
+  {
+   "table": "C000030",
+   "field": "CFOP,NATUREZA,TIPO",
+   "db_type": "VARCHAR/INTEGER",
+   "semantic_name": "cadastro de naturezas de operação (TIPO 1=entrada 272, 2=saída 318)",
+   "usage_class": "OPERATION_DEFAULT",
+   "confidence": "HIGH",
+   "evidence": "590 rows loaded by vendor script 'Script CFOP C000030.txt'; CFOP first digit distribution {'1': 124, '2': 116, '3': 32, '5': 148, '6': 142, '7': 28}; contains 5102/5405/5656/6102/1102",
+   "source_objects": [
+    "C000030"
+   ],
+   "sample_values": [
+    "1102 Compra p/ comercialização",
+    "5102"
+   ],
+   "write_candidate": false
+  },
+  {
+   "table": "C000001",
+   "field": "IND_CFOP_ENTRADA/SAIDA/PERDA",
+   "db_type": "VARCHAR(5)",
+   "semantic_name": "CFOP padrão da empresa por finalidade",
+   "usage_class": "OPERATION_DEFAULT",
+   "confidence": "HIGH",
+   "evidence": "values ['1949', '5949', '5927'] (1949/5949/5927)",
+   "source_objects": [
+    "C000001"
+   ],
+   "sample_values": [
+    "1949",
+    "5949",
+    "5927"
+   ],
+   "write_candidate": false
+  },
+  {
+   "table": "NFCE_ITENS",
+   "field": "CFOP,CST,GRUPO_ICMS,CSOSN,NCM,CEST,CST_PIS_COFINS",
+   "db_type": "mixed",
+   "semantic_name": "valores efetivamente emitidos em NFC-e (34,946 itens 2018-03..2026-08)",
+   "usage_class": "DOCUMENT_CALCULATED",
+   "confidence": "HIGH",
+   "evidence": "item-level emitted fiscal values; NCM/CEST/CSOSN/CST_PIS_COFINS populated only on 4,668 newer items (2022-06+)",
+   "source_objects": [
+    "NFCE_ITENS",
+    "NFCE"
+   ],
+   "sample_values": [
+    "5102",
+    "040",
+    "102",
+    "01"
+   ],
+   "write_candidate": false
+  },
+  {
+   "table": "NFCE_ITENS",
+   "field": "ALIQUOTA_PIS/ALIQUOTA_COFINS/BASE_CALCULO_*",
+   "db_type": "DOUBLE/NUMERIC",
+   "semantic_name": "PIS/COFINS emitido",
+   "usage_class": "DOCUMENT_CALCULATED",
+   "confidence": "HIGH",
+   "evidence": "always 0 on 4,668 items (Simples Nacional: no PIS/COFINS calculation in NFC-e)",
+   "source_objects": [
+    "NFCE_ITENS"
+   ],
+   "sample_values": [
+    0
+   ],
+   "write_candidate": false
+  },
+  {
+   "table": "NFE_ALIQUOTA_INTERESTADUAL",
+   "field": "ICMS,ORIGEM,...",
+   "db_type": "mixed",
+   "semantic_name": "tabela de alíquotas interestaduais (729 linhas)",
+   "usage_class": "OPERATION_DEFAULT",
+   "confidence": "MEDIUM",
+   "evidence": "reference table keyed by UF pair/origin; relevant only for interstate operations",
+   "source_objects": [
+    "NFE_ALIQUOTA_INTERESTADUAL"
+   ],
+   "sample_values": [],
+   "write_candidate": false
+  }
+ ]
+}

docs/ERP_OPERATION_PROFILES_V1.json

@@ -0,0 +1,255 @@
+{
+ "artifact": "ERP_OPERATION_PROFILES_V1",
+ "firebird_writes": 0,
+ "trusted_items": 1146,
+ "nfce_document_keys": {
+  "analyzed": 1499,
+  "model_positions_20_22": {
+   "65": 1499
+  },
+  "uf_code_positions_0_2": {
+   "29": 1499
+  },
+  "reading": "chave de acesso: cUF (29=BA) + modelo (65=NFC-e, official: consumidor final, operação interna) — proven for the keyed subset"
+ },
+ "trusted_cfop": {
+  "5102": 1094,
+  "5656": 40,
+  "5405": 4,
+  "": 8
+ },
+ "trusted_csosn": {
+  "102": 1039,
+  "500": 44,
+  "103": 1,
+  "101": 62
+ },
+ "trusted_cfop_csosn_cst": {
+  "5102|102|040": 1037,
+  "5102|101|000": 54,
+  "5656|500|060": 40,
+  "|101|000": 8,
+  "5405|500|060": 4,
+  "5102|102|051": 2,
+  "5102|103|040": 1
+ },
+ "trusted_cest_present_by_cfop": {
+  "5102|cest_present=False": 1094,
+  "5656|cest_present=True": 40,
+  "5405|cest_present=True": 4,
+  "|cest_present=False": 8
+ },
+ "cfop_natureza_C000030": {
+  "5102": {
+   "in_C000030": true,
+   "tipo_values": [
+    "2"
+   ],
+   "meaning": "saída"
+  },
+  "5202": {
+   "in_C000030": true,
+   "tipo_values": [
+    "2"
+   ],
+   "meaning": "saída"
+  },
+  "5405": {
+   "in_C000030": true,
+   "tipo_values": [
+    "2"
+   ],
+   "meaning": "saída"
+  },
+  "5656": {
+   "in_C000030": true,
+   "tipo_values": [
+    "2"
+   ],
+   "meaning": "saída"
+  },
+  "5916": {
+   "in_C000030": true,
+   "tipo_values": [
+    "2"
+   ],
+   "meaning": "saída"
+  },
+  "5920": {
+   "in_C000030": true,
+   "tipo_values": [
+    "2"
+   ],
+   "meaning": "saída"
+  },
+  "5929": {
+   "in_C000030": true,
+   "tipo_values": [
+    "2"
+   ],
+   "meaning": "saída"
+  },
+  "6949": {
+   "in_C000030": true,
+   "tipo_values": [
+    "2"
+   ],
+   "meaning": "saída"
+  },
+  "7205": {
+   "in_C000030": true,
+   "tipo_values": [
+    "2"
+   ],
+   "meaning": "saída"
+  }
+ },
+ "all_nfce_items_cfop": {
+  "null": 2411,
+  "": 17,
+  "5102": 31527,
+  "5405": 951,
+  "5656": 40
+ },
+ "C000062_cfop_cst_csosn": [
+  {
+   "cfop": "",
+   "cst": "000",
+   "csosn": null,
+   "n": 3
+  },
+  {
+   "cfop": "5102",
+   "cst": "000",
+   "csosn": null,
+   "n": 7
+  },
+  {
+   "cfop": "5102",
+   "cst": "020",
+   "csosn": null,
+   "n": 3
+  },
+  {
+   "cfop": "5102",
+   "cst": "040",
+   "csosn": null,
+   "n": 613
+  },
+  {
+   "cfop": "5102",
+   "cst": "051",
+   "csosn": null,
+   "n": 2
+  },
+  {
+   "cfop": "5102",
+   "cst": "060",
+   "csosn": null,
+   "n": 3
+  },
+  {
+   "cfop": "5202",
+   "cst": "000",
+   "csosn": null,
+   "n": 2
+  },
+  {
+   "cfop": "5202",
+   "cst": "020",
+   "csosn": null,
+   "n": 3
+  },
+  {
+   "cfop": "5202",
+   "cst": "030",
+   "csosn": null,
+   "n": 1
+  },
+  {
+   "cfop": "5202",
+   "cst": "040",
+   "csosn": null,
+   "n": 5
+  },
+  {
+   "cfop": "5405",
+   "cst": "060",
+   "csosn": null,
+   "n": 16
+  },
+  {
+   "cfop": "5656",
+   "cst": "060",
+   "csosn": null,
+   "n": 5
+  },
+  {
+   "cfop": "5916",
+   "cst": "040",
+   "csosn": null,
+   "n": 1
+  },
+  {
+   "cfop": "5920",
+   "cst": "060",
+   "csosn": null,
+   "n": 4
+  },
+  {
+   "cfop": "5929",
+   "cst": "041",
+   "csosn": null,
+   "n": 17
+  },
+  {
+   "cfop": "6949",
+   "cst": "000",
+   "csosn": null,
+   "n": 1
+  },
+  {
+   "cfop": "7205",
+   "cst": "060",
+   "csosn": null,
+   "n": 7
+  }
+ ],
+ "context_stability": {
+  "direction": {
+   "value": "saída",
+   "stable": true,
+   "evidence": "100% of NFC-e item CFOPs start with 5/6/7 (saída); C000025.CFOP is a saída default",
+   "available_to_agent": true
+  },
+  "company_uf": {
+   "value": "BA",
+   "stable": true,
+   "evidence": "C000004.UF + chave cUF=29",
+   "available_to_agent": true
+  },
+  "destination_uf_nfce": {
+   "value": "BA",
+   "stable": true,
+   "evidence": "NFC-e (mod 65) is intra-state consumer sale",
+   "available_to_agent": "derivable (document model), not per product"
+  },
+  "consumer_final": {
+   "value": true,
+   "stable": true,
+   "evidence": "NFC-e model 65",
+   "available_to_agent": "derivable (document model)"
+  },
+  "customer_taxpayer_status": {
+   "stable": false,
+   "evidence": "not present on NFC-e items; NF-e items (C000062) have no customer join in this analysis",
+   "available_to_agent": false
+  },
+  "st_retention_by_supplier": {
+   "stable": false,
+   "evidence": "no structured field",
+   "available_to_agent": false
+  }
+ },
+ "note": "Frequency is descriptive only; no rule is derived from it."
+}

docs/FIREBIRD_LIVE_20_V1.json

@@ -0,0 +1,122 @@
+[
+  {
+    "CODIGO": "000004",
+    "CLASSIFICACAO_FISCAL": "07069000",
+    "ALIQ_IPI": null,
+    "CEST": ""
+  },
+  {
+    "CODIGO": "000005",
+    "CLASSIFICACAO_FISCAL": "07069000",
+    "ALIQ_IPI": null,
+    "CEST": ""
+  },
+  {
+    "CODIGO": "000006",
+    "CLASSIFICACAO_FISCAL": "07069000",
+    "ALIQ_IPI": null,
+    "CEST": ""
+  },
+  {
+    "CODIGO": "000008",
+    "CLASSIFICACAO_FISCAL": "07069000",
+    "ALIQ_IPI": null,
+    "CEST": ""
+  },
+  {
+    "CODIGO": "000009",
+    "CLASSIFICACAO_FISCAL": "07069000",
+    "ALIQ_IPI": null,
+    "CEST": ""
+  },
+  {
+    "CODIGO": "000010",
+    "CLASSIFICACAO_FISCAL": "07069000",
+    "ALIQ_IPI": null,
+    "CEST": ""
+  },
+  {
+    "CODIGO": "000011",
+    "CLASSIFICACAO_FISCAL": "07069000",
+    "ALIQ_IPI": null,
+    "CEST": ""
+  },
+  {
+    "CODIGO": "000013",
+    "CLASSIFICACAO_FISCAL": "07069000",
+    "ALIQ_IPI": null,
+    "CEST": ""
+  },
+  {
+    "CODIGO": "000015",
+    "CLASSIFICACAO_FISCAL": "07133321",
+    "ALIQ_IPI": null,
+    "CEST": ""
+  },
+  {
+    "CODIGO": "000016",
+    "CLASSIFICACAO_FISCAL": "02071400",
+    "ALIQ_IPI": null,
+    "CEST": ""
+  },
+  {
+    "CODIGO": "000017",
+    "CLASSIFICACAO_FISCAL": "03061790",
+    "ALIQ_IPI": null,
+    "CEST": ""
+  },
+  {
+    "CODIGO": "000018",
+    "CLASSIFICACAO_FISCAL": "02071100",
+    "ALIQ_IPI": null,
+    "CEST": ""
+  },
+  {
+    "CODIGO": "000019",
+    "CLASSIFICACAO_FISCAL": "07133321",
+    "ALIQ_IPI": null,
+    "CEST": ""
+  },
+  {
+    "CODIGO": "000021",
+    "CLASSIFICACAO_FISCAL": "07089000",
+    "ALIQ_IPI": null,
+    "CEST": ""
+  },
+  {
+    "CODIGO": "000022",
+    "CLASSIFICACAO_FISCAL": "07089000",
+    "ALIQ_IPI": null,
+    "CEST": ""
+  },
+  {
+    "CODIGO": "000023",
+    "CLASSIFICACAO_FISCAL": "16025000",
+    "ALIQ_IPI": null,
+    "CEST": ""
+  },
+  {
+    "CODIGO": "000024",
+    "CLASSIFICACAO_FISCAL": "19022000",
+    "ALIQ_IPI": null,
+    "CEST": ""
+  },
+  {
+    "CODIGO": "000025",
+    "CLASSIFICACAO_FISCAL": "04061010",
+    "ALIQ_IPI": null,
+    "CEST": ""
+  },
+  {
+    "CODIGO": "000026",
+    "CLASSIFICACAO_FISCAL": "03055100",
+    "ALIQ_IPI": null,
+    "CEST": ""
+  },
+  {
+    "CODIGO": "000027",
+    "CLASSIFICACAO_FISCAL": "19022000",
+    "ALIQ_IPI": null,
+    "CEST": ""
+  }
+]

docs/FIREBIRD_LIVE_20_V2.json

@@ -0,0 +1,162 @@
+[
+  {
+    "CODIGO": "000004",
+    "CLASSIFICACAO_FISCAL": "07069000",
+    "IPI": null,
+    "EX_TIPI": null,
+    "CST_IPI": null,
+    "CEST": ""
+  },
+  {
+    "CODIGO": "000005",
+    "CLASSIFICACAO_FISCAL": "07069000",
+    "IPI": null,
+    "EX_TIPI": null,
+    "CST_IPI": null,
+    "CEST": ""
+  },
+  {
+    "CODIGO": "000006",
+    "CLASSIFICACAO_FISCAL": "07069000",
+    "IPI": null,
+    "EX_TIPI": null,
+    "CST_IPI": null,
+    "CEST": ""
+  },
+  {
+    "CODIGO": "000008",
+    "CLASSIFICACAO_FISCAL": "07069000",
+    "IPI": null,
+    "EX_TIPI": null,
+    "CST_IPI": null,
+    "CEST": ""
+  },
+  {
+    "CODIGO": "000009",
+    "CLASSIFICACAO_FISCAL": "07069000",
+    "IPI": null,
+    "EX_TIPI": null,
+    "CST_IPI": null,
+    "CEST": ""
+  },
+  {
+    "CODIGO": "000010",
+    "CLASSIFICACAO_FISCAL": "07069000",
+    "IPI": null,
+    "EX_TIPI": null,
+    "CST_IPI": null,
+    "CEST": ""
+  },
+  {
+    "CODIGO": "000011",
+    "CLASSIFICACAO_FISCAL": "07069000",
+    "IPI": null,
+    "EX_TIPI": null,
+    "CST_IPI": null,
+    "CEST": ""
+  },
+  {
+    "CODIGO": "000013",
+    "CLASSIFICACAO_FISCAL": "07069000",
+    "IPI": null,
+    "EX_TIPI": null,
+    "CST_IPI": null,
+    "CEST": ""
+  },
+  {
+    "CODIGO": "000015",
+    "CLASSIFICACAO_FISCAL": "07133321",
+    "IPI": null,
+    "EX_TIPI": null,
+    "CST_IPI": null,
+    "CEST": ""
+  },
+  {
+    "CODIGO": "000016",
+    "CLASSIFICACAO_FISCAL": "02071400",
+    "IPI": null,
+    "EX_TIPI": null,
+    "CST_IPI": null,
+    "CEST": ""
+  },
+  {
+    "CODIGO": "000017",
+    "CLASSIFICACAO_FISCAL": "03061790",
+    "IPI": null,
+    "EX_TIPI": null,
+    "CST_IPI": null,
+    "CEST": ""
+  },
+  {
+    "CODIGO": "000018",
+    "CLASSIFICACAO_FISCAL": "02071100",
+    "IPI": null,
+    "EX_TIPI": null,
+    "CST_IPI": null,
+    "CEST": ""
+  },
+  {
+    "CODIGO": "000019",
+    "CLASSIFICACAO_FISCAL": "07133321",
+    "IPI": null,
+    "EX_TIPI": null,
+    "CST_IPI": null,
+    "CEST": ""
+  },
+  {
+    "CODIGO": "000021",
+    "CLASSIFICACAO_FISCAL": "07089000",
+    "IPI": null,
+    "EX_TIPI": null,
+    "CST_IPI": null,
+    "CEST": ""
+  },
+  {
+    "CODIGO": "000022",
+    "CLASSIFICACAO_FISCAL": "07089000",
+    "IPI": null,
+    "EX_TIPI": null,
+    "CST_IPI": null,
+    "CEST": ""
+  },
+  {
+    "CODIGO": "000023",
+    "CLASSIFICACAO_FISCAL": "16025000",
+    "IPI": null,
+    "EX_TIPI": null,
+    "CST_IPI": null,
+    "CEST": ""
+  },
+  {
+    "CODIGO": "000024",
+    "CLASSIFICACAO_FISCAL": "19022000",
+    "IPI": null,
+    "EX_TIPI": null,
+    "CST_IPI": null,
+    "CEST": ""
+  },
+  {
+    "CODIGO": "000025",
+    "CLASSIFICACAO_FISCAL": "04061010",
+    "IPI": null,
+    "EX_TIPI": null,
+    "CST_IPI": null,
+    "CEST": ""
+  },
+  {
+    "CODIGO": "000026",
+    "CLASSIFICACAO_FISCAL": "03055100",
+    "IPI": null,
+    "EX_TIPI": null,
+    "CST_IPI": null,
+    "CEST": ""
+  },
+  {
+    "CODIGO": "000027",
+    "CLASSIFICACAO_FISCAL": "19022000",
+    "IPI": null,
+    "EX_TIPI": null,
+    "CST_IPI": null,
+    "CEST": ""
+  }
+]

docs/FIREBIRD_LIVE_20_V3.json

@@ -0,0 +1,162 @@
+[
+  {
+    "CODIGO": "000004",
+    "CLASSIFICACAO_FISCAL": "07069000",
+    "IPI": null,
+    "EX_TIPI": null,
+    "CST_IPI": null,
+    "CEST": ""
+  },
+  {
+    "CODIGO": "000005",
+    "CLASSIFICACAO_FISCAL": "07069000",
+    "IPI": null,
+    "EX_TIPI": null,
+    "CST_IPI": null,
+    "CEST": ""
+  },
+  {
+    "CODIGO": "000006",
+    "CLASSIFICACAO_FISCAL": "07069000",
+    "IPI": null,
+    "EX_TIPI": null,
+    "CST_IPI": null,
+    "CEST": ""
+  },
+  {
+    "CODIGO": "000008",
+    "CLASSIFICACAO_FISCAL": "07069000",
+    "IPI": null,
+    "EX_TIPI": null,
+    "CST_IPI": null,
+    "CEST": ""
+  },
+  {
+    "CODIGO": "000009",
+    "CLASSIFICACAO_FISCAL": "07069000",
+    "IPI": null,
+    "EX_TIPI": null,
+    "CST_IPI": null,
+    "CEST": ""
+  },
+  {
+    "CODIGO": "000010",
+    "CLASSIFICACAO_FISCAL": "07069000",
+    "IPI": null,
+    "EX_TIPI": null,
+    "CST_IPI": null,
+    "CEST": ""
+  },
+  {
+    "CODIGO": "000011",
+    "CLASSIFICACAO_FISCAL": "07069000",
+    "IPI": null,
+    "EX_TIPI": null,
+    "CST_IPI": null,
+    "CEST": ""
+  },
+  {
+    "CODIGO": "000013",
+    "CLASSIFICACAO_FISCAL": "07069000",
+    "IPI": null,
+    "EX_TIPI": null,
+    "CST_IPI": null,
+    "CEST": ""
+  },
+  {
+    "CODIGO": "000015",
+    "CLASSIFICACAO_FISCAL": "07133321",
+    "IPI": null,
+    "EX_TIPI": null,
+    "CST_IPI": null,
+    "CEST": ""
+  },
+  {
+    "CODIGO": "000016",
+    "CLASSIFICACAO_FISCAL": "02071400",
+    "IPI": null,
+    "EX_TIPI": null,
+    "CST_IPI": null,
+    "CEST": ""
+  },
+  {
+    "CODIGO": "000017",
+    "CLASSIFICACAO_FISCAL": "03061790",
+    "IPI": null,
+    "EX_TIPI": null,
+    "CST_IPI": null,
+    "CEST": ""
+  },
+  {
+    "CODIGO": "000018",
+    "CLASSIFICACAO_FISCAL": "02071100",
+    "IPI": null,
+    "EX_TIPI": null,
+    "CST_IPI": null,
+    "CEST": ""
+  },
+  {
+    "CODIGO": "000019",
+    "CLASSIFICACAO_FISCAL": "07133321",
+    "IPI": null,
+    "EX_TIPI": null,
+    "CST_IPI": null,
+    "CEST": ""
+  },
+  {
+    "CODIGO": "000021",
+    "CLASSIFICACAO_FISCAL": "07089000",
+    "IPI": null,
+    "EX_TIPI": null,
+    "CST_IPI": null,
+    "CEST": ""
+  },
+  {
+    "CODIGO": "000022",
+    "CLASSIFICACAO_FISCAL": "07089000",
+    "IPI": null,
+    "EX_TIPI": null,
+    "CST_IPI": null,
+    "CEST": ""
+  },
+  {
+    "CODIGO": "000023",
+    "CLASSIFICACAO_FISCAL": "16025000",
+    "IPI": null,
+    "EX_TIPI": null,
+    "CST_IPI": null,
+    "CEST": ""
+  },
+  {
+    "CODIGO": "000024",
+    "CLASSIFICACAO_FISCAL": "19022000",
+    "IPI": null,
+    "EX_TIPI": null,
+    "CST_IPI": null,
+    "CEST": ""
+  },
+  {
+    "CODIGO": "000025",
+    "CLASSIFICACAO_FISCAL": "04061010",
+    "IPI": null,
+    "EX_TIPI": null,
+    "CST_IPI": null,
+    "CEST": ""
+  },
+  {
+    "CODIGO": "000026",
+    "CLASSIFICACAO_FISCAL": "03055100",
+    "IPI": 3.25,
+    "EX_TIPI": null,
+    "CST_IPI": null,
+    "CEST": ""
+  },
+  {
+    "CODIGO": "000027",
+    "CLASSIFICACAO_FISCAL": "19022000",
+    "IPI": null,
+    "EX_TIPI": null,
+    "CST_IPI": null,
+    "CEST": ""
+  }
+]

docs/FISCAL_CONTEXT_COVERAGE_V1.json

@@ -0,0 +1,172 @@
+{
+ "artifact": "FISCAL_CONTEXT_COVERAGE_V1",
+ "TOTAL_PRODUCTS": 521,
+ "firebird_writes": 0,
+ "ERP_TABLES_INSPECTED": 334,
+ "ERP_TABLES_NON_EMPTY": 168,
+ "ERP_CONTEXT_TABLES_FOUND": [
+  "C000001",
+  "C000004",
+  "C000030",
+  "C000083",
+  "EMISSOR",
+  "NFE_ALIQUOTA_INTERESTADUAL"
+ ],
+ "ERP_FISCAL_TABLES_FOUND": 36,
+ "HISTORICAL_FISCAL_DOCUMENT_TABLES": [
+  "NFCE",
+  "NFCE_ITENS",
+  "C000032",
+  "C000061",
+  "C000062"
+ ],
+ "HISTORICAL_FISCAL_DOCUMENTS_FOUND": {
+  "NFCE": 1502,
+  "C000061": 50
+ },
+ "HISTORICAL_ITEMS_ANALYZED": 38764,
+ "CFOP_MAPPING_CONFIRMED": true,
+ "CST_MAPPING_CONFIRMED": true,
+ "CSOSN_MAPPING_CONFIRMED": true,
+ "PIS_MAPPING_CONFIRMED": false,
+ "COFINS_MAPPING_CONFIRMED": false,
+ "ORIGIN_MAPPING_CONFIRMED": false,
+ "MVA_FIELD_CONFIRMED": false,
+ "CFOP_CONTEXT_AVAILABLE": {
+  "available": 4,
+  "job_dependent": 1,
+  "missing": 2,
+  "total": 7,
+  "complete": false
+ },
+ "CSOSN_CONTEXT_AVAILABLE": {
+  "available": 3,
+  "job_dependent": 1,
+  "missing": 2,
+  "total": 6,
+  "complete": false
+ },
+ "CST_CONTEXT_AVAILABLE": {
+  "available": 2,
+  "job_dependent": 0,
+  "missing": 1,
+  "total": 3,
+  "complete": false
+ },
+ "PIS_COFINS_CONTEXT_AVAILABLE": {
+  "available": 2,
+  "job_dependent": 0,
+  "missing": 2,
+  "total": 4,
+  "complete": false
+ },
+ "FCP_CONTEXT_AVAILABLE": {
+  "available": 1,
+  "job_dependent": 2,
+  "missing": 1,
+  "total": 4,
+  "complete": false
+ },
+ "RTC_CONTEXT_AVAILABLE": {
+  "available": 1,
+  "job_dependent": 0,
+  "missing": 3,
+  "total": 4,
+  "complete": false
+ },
+ "CONTEXT_AVAILABLE": 14,
+ "CONTEXT_JOB_DEPENDENT": 5,
+ "CONTEXT_MISSING": 15,
+ "history_agreement_all_joins": {
+  "CFOP": {
+   "MATCH": 29570,
+   "MISMATCH": 1215,
+   "ITEM_NULL": 2410
+  },
+  "CST": {
+   "MATCH": 17995,
+   "MISMATCH": 12790,
+   "ITEM_NULL": 2410
+  },
+  "GRUPO_ICMS": {
+   "MATCH": 29073,
+   "MISMATCH": 1712,
+   "ITEM_NULL": 2410
+  },
+  "CSOSN": {
+   "ITEM_NULL": 30278,
+   "MATCH": 1976,
+   "MISMATCH": 941
+  },
+  "NCM": {
+   "ITEM_NULL": 30278,
+   "MATCH": 1241,
+   "MISMATCH": 1676
+  },
+  "CEST": {
+   "ITEM_NULL": 30279,
+   "MATCH": 1526,
+   "MISMATCH": 1390
+  },
+  "PIS": {
+   "ITEM_NULL": 30278,
+   "MATCH": 1167,
+   "MISMATCH": 1750
+  }
+ },
+ "history_agreement_identity_consistent_joins": {
+  "CFOP": {
+   "MATCH": 1231,
+   "MISMATCH": 10
+  },
+  "CST": {
+   "MATCH": 1241
+  },
+  "CSOSN": {
+   "MATCH": 1179,
+   "MISMATCH": 62
+  },
+  "CEST": {
+   "MATCH": 1231,
+   "MISMATCH": 9
+  },
+  "PIS": {
+   "MATCH": 1162,
+   "MISMATCH": 79
+  }
+ },
+ "identity_drift": {
+  "consistent_items": 1241,
+  "inconsistent_items": 1676
+ },
+ "cest_historically_supported": 1,
+ "shadow_validation_engine_vs_history": {
+  "items": 2917,
+  "MATCH": 1189,
+  "MISMATCH": 1671,
+  "UNRESOLVED": 14642,
+  "by_domain": {
+   "NCM": {
+    "MATCH": 1189,
+    "UNRESOLVED": 57,
+    "MISMATCH": 1671
+   },
+   "CEST": {
+    "UNRESOLVED": 2917
+   },
+   "CFOP": {
+    "UNRESOLVED": 2917
+   },
+   "CST_ICMS": {
+    "UNRESOLVED": 2917
+   },
+   "CSOSN": {
+    "UNRESOLVED": 2917
+   },
+   "PIS_CST": {
+    "UNRESOLVED": 2917
+   }
+  },
+  "note": "NCM 'mismatch' = product's current NCM differs from the NCM emitted on that CODPRODUTO (identity drift), not an engine error; all operation-dependent domains stay UNRESOLVED by design."
+ }
+}

docs/FISCAL_CONTEXT_REQUIREMENTS_V1.json

@@ -0,0 +1,197 @@
+{
+ "artifact": "FISCAL_CONTEXT_REQUIREMENTS_V1",
+ "domains": {
+  "CFOP": {
+   "official_basis": "CFOP table (IT 2023.002): direction, UF scope, ST, purpose in title/description/ind* flags",
+   "inputs": {
+    "direction (entrada/saída)": {
+     "status": "AVAILABLE_FROM_ERP",
+     "evidence": "C000030.TIPO (1/2) per natureza; NFC-e is always saída"
+    },
+    "operation_type / natureza": {
+     "status": "AVAILABLE_FROM_ERP",
+     "evidence": "C000030 (590 rows) at document level; not derivable from a product alone"
+    },
+    "origin_uf": {
+     "status": "AVAILABLE_FROM_ERP",
+     "evidence": "C000004.UF=BA"
+    },
+    "destination_uf": {
+     "status": "AVAILABLE_FROM_JOB",
+     "evidence": "NFC-e is intra-UF by nature; NF-e needs customer UF (customer tables) — absent from a product-only job"
+    },
+    "customer_taxpayer_status": {
+     "status": "MISSING",
+     "evidence": "per-document/customer; not in product request"
+    },
+    "st_applicability": {
+     "status": "AVAILABLE_FROM_ERP",
+     "evidence": "BA_ST_MVA + CEST datasets, only 31 products MVA_RESOLVED"
+    },
+    "purpose (revenda/consumo/devolução)": {
+     "status": "MISSING",
+     "evidence": "only natureza text; no structured field"
+    }
+   }
+  },
+  "CSOSN": {
+   "official_basis": "MOC CSOSN table + CRT=1",
+   "inputs": {
+    "CRT": {
+     "status": "AVAILABLE_FROM_ERP",
+     "evidence": "C000004.CRT=1, EMISSOR.EMITENTE_CRT=1"
+    },
+    "company_default_csosn": {
+     "status": "AVAILABLE_FROM_ERP",
+     "evidence": "C000004.ICMS_CSOSN=102"
+    },
+    "st_applicability": {
+     "status": "AVAILABLE_FROM_ERP",
+     "evidence": "same as CFOP (partial)"
+    },
+    "st_already_retained_by_supplier": {
+     "status": "MISSING",
+     "evidence": "requires purchase documents per product; not structured"
+    },
+    "operation_type": {
+     "status": "MISSING",
+     "evidence": "document-level"
+    },
+    "destination_context": {
+     "status": "AVAILABLE_FROM_JOB",
+     "evidence": "document-level"
+    }
+   }
+  },
+  "CST_ICMS": {
+   "official_basis": "not emitted while CRT=1 (CSOSN used)",
+   "inputs": {
+    "CRT": {
+     "status": "AVAILABLE_FROM_ERP",
+     "evidence": "C000004.CRT"
+    },
+    "regime_change_flag": {
+     "status": "AVAILABLE_FROM_AGENT_CONFIG",
+     "evidence": "only if client leaves Simples"
+    },
+    "operation_type": {
+     "status": "MISSING",
+     "evidence": "document-level"
+    }
+   }
+  },
+  "ORIGEM": {
+   "official_basis": "MOC origin table 0-8",
+   "inputs": {
+    "objective_product_origin (import/national)": {
+     "status": "MISSING",
+     "evidence": "C000025.ORIGEM 0/521; COD_ORIGEM_MERCADORIA 1/521; ERP CST digit 1 is a config value not proof"
+    }
+   }
+  },
+  "PIS_COFINS": {
+   "official_basis": "CST PIS/COFINS table + regime; rate tables 4.3.x deferred",
+   "inputs": {
+    "regime": {
+     "status": "AVAILABLE_FROM_ERP",
+     "evidence": "CRT=1 / OPTANTE_SIMPLES=S (NFC-e PIS/COFINS always 0)"
+    },
+    "product_treatment": {
+     "status": "AVAILABLE_FROM_ERP",
+     "evidence": "C000025.INCIDENCIA_PISCOFINS (519 NENHUMA, 1 MONOFÁSICA, 1 SUBST.TRIBUTÁRIA)"
+    },
+    "cst_rule_table": {
+     "status": "MISSING",
+     "evidence": "no NCM→CST PIS/COFINS rule in acquired datasets (deferred by business scope)"
+    },
+    "operation_type": {
+     "status": "MISSING",
+     "evidence": "document-level"
+    }
+   }
+  },
+  "FCP": {
+   "official_basis": "FCP rate per UF (dataset) + state item list",
+   "inputs": {
+    "company_uf": {
+     "status": "AVAILABLE_FROM_ERP",
+     "evidence": "C000004.UF=BA"
+    },
+    "destination_uf": {
+     "status": "AVAILABLE_FROM_JOB",
+     "evidence": "document-level"
+    },
+    "item_in_fcp_list_for_uf": {
+     "status": "MISSING",
+     "evidence": "no NCM/CEST list of FCP-subject items in datasets"
+    },
+    "operation_interstate_or_internal": {
+     "status": "AVAILABLE_FROM_JOB",
+     "evidence": "document-level"
+    }
+   }
+  },
+  "RTC_CCLASSTRIB": {
+   "official_basis": "cClassTrib table + LC 214 annexes",
+   "inputs": {
+    "ncm_to_annex_mapping": {
+     "status": "MISSING",
+     "evidence": "LC 214 annex NCM lists are not in acquired datasets"
+    },
+    "operation_nature": {
+     "status": "MISSING",
+     "evidence": "document-level"
+    },
+    "customer_type": {
+     "status": "MISSING",
+     "evidence": "document-level"
+    },
+    "CRT": {
+     "status": "AVAILABLE_FROM_ERP",
+     "evidence": "C000004.CRT"
+    }
+   }
+  },
+  "RTC_CBS_RATE": {
+   "official_basis": "IT 2026.002: 2026=0.009, 2027 pending legislation",
+   "inputs": {
+    "cclasstrib_resolved": {
+     "status": "MISSING",
+     "evidence": "blocked by RTC_CCLASSTRIB"
+    },
+    "reference_year": {
+     "status": "AVAILABLE_FROM_JOB",
+     "evidence": "document date"
+    }
+   }
+  },
+  "RTC_CCREDPRES": {
+   "official_basis": "cCredPres official conditions",
+   "inputs": {
+    "condition_flags (ZFM, presumed credit eligibility)": {
+     "status": "MISSING",
+     "evidence": "no ERP field"
+    }
+   }
+  },
+  "MVA": {
+   "official_basis": "RICMS-BA Anexo 1 item/CEST",
+   "inputs": {
+    "confirmed_cest": {
+     "status": "AVAILABLE_FROM_ERP",
+     "evidence": "only 15 CEST candidates remain, 1 historically supported"
+    },
+    "erp_destination_field": {
+     "status": "MISSING",
+     "evidence": "NO_PRODUCT_FIELD proven"
+    }
+   }
+  }
+ },
+ "summary": {
+  "AVAILABLE_FROM_ERP": 13,
+  "AVAILABLE_FROM_AGENT_CONFIG": 1,
+  "AVAILABLE_FROM_JOB": 5,
+  "MISSING": 15
+ }
+}

docs/FISCAL_CONTEXT_REQUIREMENTS_V2.json

@@ -0,0 +1,61 @@
+{
+ "artifact": "FISCAL_CONTEXT_REQUIREMENTS_V2",
+ "requirements": [
+  {
+   "INPUT": "valid_ncm",
+   "SOURCE_EXPECTED": "product master (C000025.CLASSIFICACAO_FISCAL)",
+   "AVAILABLE": "PARTIAL (495/521 valid)",
+   "AFFECTED_PRODUCTS": 26,
+   "AFFECTED_FIELD": "CFOP,CSOSN",
+   "NEXT_ACTION": "Fix/review invalid+legacy NCMs (never auto-change)."
+  },
+  {
+   "INPUT": "st_applicability_confirmed (CEST confirmation)",
+   "SOURCE_EXPECTED": "CEST dataset + BA Anexo 1 item",
+   "AVAILABLE": "PARTIAL (31 resolved, 237 candidates)",
+   "AFFECTED_PRODUCTS": 237,
+   "AFFECTED_FIELD": "CFOP,CSOSN",
+   "NEXT_ACTION": "Confirm CEST per product (description evidence/manual review) to settle ST applicability."
+  },
+  {
+   "INPUT": "st_retention_by_supplier",
+   "SOURCE_EXPECTED": "purchase document per product (entrada) or supplier flag",
+   "AVAILABLE": false,
+   "AFFECTED_PRODUCTS": 31,
+   "AFFECTED_FIELD": "CSOSN(500 vs 102),CFOP(5405 vs 5102)",
+   "NEXT_ACTION": "Locate structured retention evidence in purchase items (C000032/C000062 CST 060/CSOSN 500 history) or ask vendor."
+  },
+  {
+   "INPUT": "product_icms_treatment (taxed / exempt / not taxed)",
+   "SOURCE_EXPECTED": "state ICMS rules per NCM (no acquired dataset)",
+   "AVAILABLE": false,
+   "AFFECTED_PRODUCTS": 227,
+   "AFFECTED_FIELD": "CSOSN(102 vs 400/300/103)",
+   "NEXT_ACTION": "Needs an official per-NCM ICMS treatment source; ERP CST=040 with CSOSN=102 coexists, so ERP alone is ambiguous."
+  },
+  {
+   "INPUT": "declared_resale_vs_production",
+   "SOURCE_EXPECTED": "product nature/type (C000025.TIPO_ITEM unused) or company activity",
+   "AVAILABLE": false,
+   "AFFECTED_PRODUCTS": 7,
+   "AFFECTED_FIELD": "CFOP",
+   "NEXT_ACTION": "Confirm meaning of FOOD_ATRIBUICAO_VALORES/TIPO_ITEM with vendor before deriving 5101 vs 5102."
+  },
+  {
+   "INPUT": "st_conflict_resolution (which of ERP CFOP or BA Anexo 1 is wrong)",
+   "SOURCE_EXPECTED": "human/fiscal review of conflicting products",
+   "AVAILABLE": false,
+   "AFFECTED_PRODUCTS": 29,
+   "AFFECTED_FIELD": "CFOP",
+   "NEXT_ACTION": "Review queue; do not auto-apply."
+  },
+  {
+   "INPUT": "destination_uf / consumer_final / direction",
+   "SOURCE_EXPECTED": "NFC-e document model 65 + chave cUF (proven 1499/1499) and C000004.UF",
+   "AVAILABLE": true,
+   "AFFECTED_PRODUCTS": 0,
+   "AFFECTED_FIELD": "CFOP",
+   "NEXT_ACTION": "Already satisfied for NFC-e scope; NF-e needs customer data."
+  }
+ ]
+}

docs/FISCAL_CONTEXT_REQUIREMENTS_V3.json

@@ -0,0 +1,45 @@
+{
+ "artifact": "FISCAL_CONTEXT_REQUIREMENTS_V3",
+ "requirements": [
+  {
+   "INPUT": "valid_ncm",
+   "SOURCE_EXPECTED": "product master",
+   "AVAILABLE": "PARTIAL",
+   "AFFECTED_PRODUCTS": 26,
+   "AFFECTED_FIELD": "CSOSN",
+   "NEXT_ACTION": "Manual NCM review (3 legacy + 23 invalid); not auto-corrected."
+  },
+  {
+   "INPUT": "st_confirmed_per_product (CEST corroboration)",
+   "SOURCE_EXPECTED": "ERP CEST field filled and equal to the BA Anexo 1 item CEST",
+   "AVAILABLE": "PARTIAL",
+   "AFFECTED_PRODUCTS": 467,
+   "AFFECTED_FIELD": "CSOSN",
+   "NEXT_ACTION": "Fill/confirm CEST for ST candidates (description review) — 490 of 521 ERP CEST values are blank."
+  },
+  {
+   "INPUT": "st_withheld_by_supplier (purchase evidence)",
+   "SOURCE_EXPECTED": "purchase items with ICMS_RETIDO/ST values (C000088)",
+   "AVAILABLE": "NO (12 purchase items, all ICMS_RETIDO='N', ST values 0)",
+   "AFFECTED_PRODUCTS": 268,
+   "AFFECTED_FIELD": "CSOSN(500 vs other)",
+   "NEXT_ACTION": "Import supplier NF-e XML (ICMS ST/CSOSN 500 on entrada) or obtain vendor confirmation of how retention is recorded."
+  },
+  {
+   "INPUT": "product_role (resale/own production)",
+   "SOURCE_EXPECTED": "C000025.TIPO/PROD_COZINHA + recipe + purchase docs",
+   "AVAILABLE": "PARTIAL",
+   "AFFECTED_PRODUCTS": 483,
+   "AFFECTED_FIELD": "CSOSN,CFOP",
+   "NEXT_ACTION": "TIPO_ITEM/PRODUTO_SERVICO are unused; only 7 INPUT and ~13 own-production products are objectively evidenced."
+  },
+  {
+   "INPUT": "product_icms_treatment (taxed vs exempt/not taxed)",
+   "SOURCE_EXPECTED": "official per-NCM ICMS treatment source (none acquired)",
+   "AVAILABLE": false,
+   "AFFECTED_PRODUCTS": 28,
+   "AFFECTED_FIELD": "CSOSN(102 vs 400/300/103)",
+   "NEXT_ACTION": "Decide with accountant/vendor: ERP CST=040 with CSOSN=102 is the emitted practice; needs a documented rule."
+  }
+ ]
+}

docs/FISCAL_COVERAGE_FULL_V1.json

@@ -0,0 +1,77 @@
+{
+  "artifact": "FISCAL_COVERAGE_FULL_V1",
+  "firebird_writes": 0,
+  "total_products": 521,
+  "ncm_valid": 495,
+  "ncm_legacy": 3,
+  "ncm_invalid": 23,
+  "ncm_missing": 0,
+  "ipi": {
+    "numeric": 107,
+    "non_numeric": 20,
+    "source_blank": 297,
+    "ambiguous": 71,
+    "no_match": 23
+  },
+  "cest": {
+    "match": 462,
+    "confirmed": 0,
+    "candidates": 15
+  },
+  "ba_st_mva": {
+    "match": 268,
+    "resolved": 31,
+    "candidates": 237
+  },
+  "pis_cofins": {
+    "data_available": true,
+    "match": 0,
+    "unresolved": 521,
+    "note": "CST_PIS/CST_COFINS code domains are ACTIVE and consultable, but no NCM-linked determination table (SPED Tabela 4.3.10-4.3.17) is available to resolve a specific product's PIS/COFINS situation yet. DATA_AVAILABLE=true, RULE_RESOLVED=0 for all products."
+  },
+  "cfop": {
+    "dataset_available": false,
+    "note": "CFOP full table FAILED to acquire this session (portal-gated); MOC7 only references CFOP, does not enumerate it. See docs/SOURCE_REGISTRY_V2.md."
+  },
+  "cst_icms": {
+    "dataset_available": true,
+    "record_count": 11
+  },
+  "csosn": {
+    "dataset_available": true,
+    "record_count": 10
+  },
+  "origin": {
+    "dataset_available": true,
+    "record_count": 9
+  },
+  "fcp": {
+    "dataset_available": false,
+    "note": "No single canonical national table exists; FAILED (see docs/SOURCE_REGISTRY_V2.md)."
+  },
+  "icms_monophasic": {
+    "match": 0,
+    "dataset_available": false
+  },
+  "anp": {
+    "match": 0,
+    "dataset_available": false
+  },
+  "ncm_utrib": {
+    "dataset_available": false
+  },
+  "rtc": {
+    "cclasstrib_match": 0,
+    "ccredpres_match": 0,
+    "cbs_rate_match": 0,
+    "biofuel_index_available": false,
+    "note": "All RTC (Reforma Tributária) tables FAILED to acquire — 2025/26-era portal documents, not present in MOC7 or locally."
+  },
+  "active_dataset_kinds": [
+    "BA_ST_MVA",
+    "CEST",
+    "NCM",
+    "NFE_MOC_TABLES",
+    "TIPI_IPI"
+  ]
+}

docs/FISCAL_COVERAGE_FULL_V2.json

@@ -0,0 +1,100 @@
+{
+  "artifact": "FISCAL_COVERAGE_FULL_V2",
+  "firebird_writes": 0,
+  "total_products": 521,
+  "ncm_valid": 495,
+  "ncm_legacy": 3,
+  "ncm_invalid": 23,
+  "ncm_missing": 0,
+  "ipi": {
+    "numeric": 107,
+    "non_numeric": 20,
+    "source_blank": 297,
+    "ambiguous": 71,
+    "no_match": 23
+  },
+  "cest": {
+    "match": 462,
+    "confirmed": 0,
+    "candidates": 15
+  },
+  "ba_st_mva": {
+    "match": 268,
+    "resolved": 31,
+    "candidates": 237
+  },
+  "pis_cofins": {
+    "data_available": true,
+    "match_found": 0,
+    "rule_resolved": 0,
+    "rule_unresolved": 521,
+    "note": "CST_PIS/CST_COFINS code domain is ACTIVE (66 codes) but no NCM-linked SPED Tabela 4.3.10-4.3.17 determination table was available to acquire (MISSING_BOOTSTRAP_FILE) — no per-product PIS/COFINS rule can be resolved."
+  },
+  "cfop": {
+    "dataset_available": true,
+    "record_count": 619,
+    "match_found": 498,
+    "note": "match = this product's own C000025.CFOP value exists in the official table"
+  },
+  "cst_icms": {
+    "dataset_available": true,
+    "record_count": 11
+  },
+  "csosn": {
+    "dataset_available": true,
+    "record_count": 10
+  },
+  "origin": {
+    "dataset_available": true,
+    "record_count": 9
+  },
+  "fcp": {
+    "dataset_available": true,
+    "record_count": 27,
+    "note": "per-UF rate table; not linked to a product-level UF field in C000025, so match_found is not meaningful per-product"
+  },
+  "icms_monophasic": {
+    "match_found": 0,
+    "dataset_available": false,
+    "status": "MISSING_BOOTSTRAP_FILE"
+  },
+  "anp": {
+    "dataset_available": true,
+    "record_count": 1031,
+    "match_found": 0,
+    "note": "C000025 has no ANP/fuel product code field to join on; dataset exists but is not applicable to this ERP's product catalog"
+  },
+  "ncm_utrib": {
+    "dataset_available": true,
+    "record_count": 10516,
+    "match_found": 495
+  },
+  "rtc": {
+    "cclasstrib_match": 0,
+    "cclasstrib_available": false,
+    "cclasstrib_status": "MISSING_BOOTSTRAP_FILE",
+    "ccredpres_match": 0,
+    "ccredpres_available": true,
+    "ccredpres_record_count": 13,
+    "cbs_rate_match": 0,
+    "cbs_rate_available": false,
+    "cbs_rate_status": "MISSING_BOOTSTRAP_FILE",
+    "biofuel_match": 0,
+    "biofuel_available": true,
+    "biofuel_record_count": 23,
+    "note": "cCredPres and biofuel index datasets are ACTIVE but have no join key present in C000025 (no cProdANP/cCredPres field on this ERP's grocery/restaurant catalog), so match_found=0 is a data-shape fact, not a gap."
+  },
+  "active_dataset_kinds": [
+    "ANP",
+    "BA_ST_MVA",
+    "CEST",
+    "CFOP",
+    "FCP",
+    "NCM",
+    "NCM_UTRIB",
+    "NFE_MOC_TABLES",
+    "RTC_BIOFUEL_INDEX",
+    "RTC_CCREDPRES",
+    "TIPI_IPI"
+  ]
+}

docs/FISCAL_COVERAGE_FULL_V3.json

@@ -0,0 +1,123 @@
+{
+  "artifact": "FISCAL_COVERAGE_FULL_V3",
+  "firebird_writes": 0,
+  "total_products": 521,
+  "ncm_valid": 495,
+  "ncm_legacy": 3,
+  "ncm_invalid": 23,
+  "ncm_missing": 0,
+  "ipi": {
+    "numeric": 107,
+    "non_numeric": 20,
+    "source_blank": 297,
+    "ambiguous": 71,
+    "no_match": 23
+  },
+  "cest": {
+    "match": 462,
+    "confirmed": 0,
+    "candidates": 15
+  },
+  "ba_st_mva": {
+    "match": 268,
+    "resolved": 31,
+    "candidates": 237
+  },
+  "pis_cofins_4_3_10_17": "DEFERRED_BY_BUSINESS_SCOPE",
+  "pis_cofins": {
+    "data_available": true,
+    "match_found": 0,
+    "rule_resolved": 0,
+    "rule_unresolved": 521,
+    "note": "CST_PIS/CST_COFINS code domain is ACTIVE (66 codes) but no NCM-linked SPED Tabela 4.3.10-4.3.17 determination table was available to acquire (MISSING_BOOTSTRAP_FILE) — no per-product PIS/COFINS rule can be resolved."
+  },
+  "cfop": {
+    "dataset_available": true,
+    "record_count": 619,
+    "match_found": 498,
+    "note": "match = this product's own C000025.CFOP value exists in the official table"
+  },
+  "cst_icms": {
+    "dataset_available": true,
+    "record_count": 11
+  },
+  "csosn": {
+    "dataset_available": true,
+    "record_count": 10
+  },
+  "origin": {
+    "dataset_available": true,
+    "record_count": 9
+  },
+  "fcp": {
+    "dataset_available": true,
+    "record_count": 27,
+    "note": "per-UF rate table; not linked to a product-level UF field in C000025, so match_found is not meaningful per-product"
+  },
+  "icms_monophasic": {
+    "match_found": 0,
+    "dataset_available": false,
+    "status": "OUT_OF_SCOPE_MVP"
+  },
+  "anp": {
+    "scope": "ACTIVE_REFERENCE_ONLY",
+    "dataset_available": true,
+    "record_count": 1031,
+    "match_found": 0,
+    "note": "C000025 has no ANP/fuel product code field to join on; dataset exists but is not applicable to this ERP's product catalog"
+  },
+  "ncm_utrib": {
+    "dataset_available": true,
+    "record_count": 10516,
+    "match_found": 495
+  },
+  "rtc": {
+    "cclasstrib_available": true,
+    "cclasstrib_record_count": 164,
+    "cclasstrib_match": 0,
+    "cbs_rate_available": true,
+    "cbs_rate_record_count": 2,
+    "cbs_rate_2026": {
+      "found": true,
+      "year": 2026,
+      "rate": 0.009,
+      "rate_text": "0.009"
+    },
+    "ccredpres_available": true,
+    "ccredpres_record_count": 13,
+    "biofuel_available": true,
+    "biofuel_scope": "ACTIVE_REFERENCE_ONLY",
+    "note": "cClassTrib/cCredPres are DATA_AVAILABLE only: C000025 carries no cClassTrib/cCredPres field to join on, so match_found=0 and rule_resolved=0 are data-shape facts, not gaps. No rule was invented."
+  },
+  "core_domains_active": {
+    "NCM": true,
+    "TIPI_IPI": true,
+    "CEST": true,
+    "BA_ST_MVA": true,
+    "CFOP": true,
+    "ORIGIN": true,
+    "CST_ICMS": true,
+    "CSOSN": true,
+    "CST_PIS": true,
+    "CST_COFINS": true,
+    "FCP": true,
+    "RTC_CCLASSTRIB": true,
+    "RTC_CCREDPRES": true,
+    "RTC_CBS_RATES": true
+  },
+  "active_dataset_kinds": [
+    "ANP",
+    "BA_ST_MVA",
+    "CEST",
+    "CFOP",
+    "FCP",
+    "NCM",
+    "NCM_UTRIB",
+    "NFE_MOC_TABLES",
+    "RTC_BIOFUEL_INDEX",
+    "RTC_CBS_RATES",
+    "RTC_CCLASSTRIB",
+    "RTC_CCREDPRES",
+    "TIPI_IPI"
+  ]
+}

docs/FISCAL_DATASETS.md

@@ -0,0 +1,13 @@
+# Fiscal Dataset Status
+
+| Dataset or provider | Status | Evidence / limitation |
+| --- | --- | --- |
+| NCM | IMPLEMENTED | Imports the official Siscomex JSON endpoint configured as `NCM_DATASET_URL`; each version retains SHA-256, source URL, download time, act, update label, and row count. |
+| CEST | IMPLEMENTED | Imports only DOM tables in Annexes II-XXVI from official CONFAZ `CV142_18`; each raw HTML revision retains SHA-256, source URL, download time, act, version, and row count. |
+| CFOP | NOT_AVAILABLE | No authoritative dataset integration is configured in Mission 02. |
+| CST/CSOSN | NOT_AVAILABLE | No authoritative rules integration is configured in Mission 02. |
+| cClassTrib | DISCOVERED | Kept as an input/output placeholder only; no source or decision engine is claimed. |
+| IBS/CBS | NOT_AVAILABLE | No verified official calculator is configured. |
+| RTC calculator | NOT_CONFIGURED | The hub returns no RTC result and never fabricates fiscal values. |
+
+The CEST result is an informational official source match, never an automatic fiscal determination.

docs/FISCAL_DECISION_COVERAGE_V1.json

@@ -0,0 +1,313 @@
+{
+ "artifact": "FISCAL_DECISION_COVERAGE_V1",
+ "engine": "fiscal-decision-v1",
+ "total_products": 521,
+ "company_context": {
+  "uf": "BA",
+  "crt": "1"
+ },
+ "erp_fields_mapped": 11,
+ "erp_fields_unconfirmed": [
+  "CFOP_ENTRADA",
+  "CST_ENTRADA",
+  "COD_ENTRADA_PIS",
+  "COD_SAIDA_PIS",
+  "ALIQ_PIS",
+  "COD_ENTRADA_COFINS",
+  "COD_SAIDA_COFINS",
+  "ALIQ_COFINS",
+  "CST_IPI",
+  "ORIGEM"
+ ],
+ "action_class_totals": {
+  "ALREADY_CORRECT": 602,
+  "NO_RULE": 2319,
+  "OPERATION_CONTEXT_REQUIRED": 4168,
+  "REVIEW_REQUIRED": 941,
+  "NO_DATA": 306
+ },
+ "domains": {
+  "NCM": {
+   "nature": "PRODUCT_INTRINSIC",
+   "DATA_AVAILABLE": 521,
+   "MATCH_FOUND": 498,
+   "RULE_RESOLVED": 495,
+   "RULE_CANDIDATE": 26,
+   "RULE_UNRESOLVED": 0,
+   "OPERATION_CONTEXT_REQUIRED": 0,
+   "CHANGE_REQUIRED": 0,
+   "action_class": {
+    "ALREADY_CORRECT": 495,
+    "REVIEW_REQUIRED": 26
+   },
+   "reason_codes": {
+    "NCM_VALID_SAME_VALUE": 495,
+    "NCM_INVALID_REVIEW_REQUIRED": 23,
+    "LEGACY_NCM_REVIEW_REQUIRED": 3
+   }
+  },
+  "IPI": {
+   "nature": "PRODUCT_INTRINSIC",
+   "DATA_AVAILABLE": 224,
+   "MATCH_FOUND": 495,
+   "RULE_RESOLVED": 107,
+   "RULE_CANDIDATE": 71,
+   "RULE_UNRESOLVED": 343,
+   "OPERATION_CONTEXT_REQUIRED": 0,
+   "CHANGE_REQUIRED": 0,
+   "action_class": {
+    "NO_RULE": 46,
+    "NO_DATA": 297,
+    "ALREADY_CORRECT": 107,
+    "REVIEW_REQUIRED": 71
+   },
+   "reason_codes": {
+    "TIPI_RATE_SOURCE_BLANK": 297,
+    "TIPI_NUMERIC_SAME_VALUE": 107,
+    "MULTIPLE_TIPI_CANDIDATES": 71,
+    "NO_TIPI_MAPPING_FOUND": 23,
+    "TIPI_RATE_NT_OR_NON_TAXED": 20,
+    "LEGACY_NCM": 3
+   }
+  },
+  "EX_TIPI": {
+   "nature": "PRODUCT_INTRINSIC",
+   "DATA_AVAILABLE": 518,
+   "MATCH_FOUND": 71,
+   "RULE_RESOLVED": 0,
+   "RULE_CANDIDATE": 71,
+   "RULE_UNRESOLVED": 450,
+   "OPERATION_CONTEXT_REQUIRED": 0,
+   "CHANGE_REQUIRED": 0,
+   "action_class": {
+    "NO_RULE": 447,
+    "NO_DATA": 3,
+    "REVIEW_REQUIRED": 71
+   },
+   "reason_codes": {
+    "NO_EX_TIPI_FOR_NCM": 450,
+    "SINGLE_EX_FOR_NCM_BUT_PRODUCT_DESCRIPTION_DOES_NOT_EVIDENCE_IT": 56,
+    "MULTIPLE_EX_TIPI_CANDIDATES_NO_SINGLE_EVIDENCE": 15
+   }
+  },
+  "CEST": {
+   "nature": "PRODUCT_INTRINSIC",
+   "DATA_AVAILABLE": 518,
+   "MATCH_FOUND": 15,
+   "RULE_RESOLVED": 0,
+   "RULE_CANDIDATE": 15,
+   "RULE_UNRESOLVED": 506,
+   "OPERATION_CONTEXT_REQUIRED": 0,
+   "CHANGE_REQUIRED": 0,
+   "action_class": {
+    "NO_RULE": 503,
+    "NO_DATA": 3,
+    "REVIEW_REQUIRED": 15
+   },
+   "reason_codes": {
+    "CEST_DESCRIPTION_SCORE_BELOW_THRESHOLD": 447,
+    "NO_CEST_MAPPING_FOUND_FOR_NCM": 56,
+    "MULTIPLE_CEST_CANDIDATES_NO_SINGLE_EVIDENCE": 15,
+    "LEGACY_NCM": 3
+   }
+  },
+  "MVA": {
+   "nature": "PRODUCT_INTRINSIC",
+   "DATA_AVAILABLE": 518,
+   "MATCH_FOUND": 268,
+   "RULE_RESOLVED": 31,
+   "RULE_CANDIDATE": 237,
+   "RULE_UNRESOLVED": 253,
+   "OPERATION_CONTEXT_REQUIRED": 0,
+   "CHANGE_REQUIRED": 0,
+   "action_class": {
+    "NO_RULE": 281,
+    "NO_DATA": 3,
+    "REVIEW_REQUIRED": 237
+   },
+   "reason_codes": {
+    "MVA_NOT_APPLICABLE_NO_BA_ANNEX1_ENTRY_FOR_NCM": 250,
+    "MULTIPLE_MVA_ITEMS_NEED_CEST_CONFIRMATION": 237,
+    "MVA_RESOLVED_NO_ERP_TARGET_FIELD": 31,
+    "LEGACY_OR_INVALID_NCM": 3
+   }
+  },
+  "CFOP": {
+   "nature": "OPERATION_DEPENDENT",
+   "DATA_AVAILABLE": 521,
+   "MATCH_FOUND": 498,
+   "RULE_RESOLVED": 0,
+   "RULE_CANDIDATE": 0,
+   "RULE_UNRESOLVED": 0,
+   "OPERATION_CONTEXT_REQUIRED": 521,
+   "CHANGE_REQUIRED": 0,
+   "action_class": {
+    "OPERATION_CONTEXT_REQUIRED": 521
+   },
+   "reason_codes": {
+    "CFOP_DEPENDS_ON_OPERATION_DIRECTION_UF_ST_PURPOSE": 521
+   }
+  },
+  "CSOSN": {
+   "nature": "OPERATION_DEPENDENT",
+   "DATA_AVAILABLE": 521,
+   "MATCH_FOUND": 497,
+   "RULE_RESOLVED": 0,
+   "RULE_CANDIDATE": 0,
+   "RULE_UNRESOLVED": 0,
+   "OPERATION_CONTEXT_REQUIRED": 521,
+   "CHANGE_REQUIRED": 0,
+   "action_class": {
+    "OPERATION_CONTEXT_REQUIRED": 521
+   },
+   "reason_codes": {
+    "CSOSN_DEPENDS_ON_SALE_SCENARIO_ST_RETENTION_CONSUMER": 521
+   }
+  },
+  "CST_ICMS": {
+   "nature": "OPERATION_DEPENDENT",
+   "DATA_AVAILABLE": 521,
+   "MATCH_FOUND": 521,
+   "RULE_RESOLVED": 0,
+   "RULE_CANDIDATE": 0,
+   "RULE_UNRESOLVED": 0,
+   "OPERATION_CONTEXT_REQUIRED": 521,
+   "CHANGE_REQUIRED": 0,
+   "action_class": {
+    "OPERATION_CONTEXT_REQUIRED": 521
+   },
+   "reason_codes": {
+    "CRT1_USES_CSOSN_CST_DEPENDS_ON_OPERATION": 521
+   }
+  },
+  "ORIGEM": {
+   "nature": "PRODUCT_INTRINSIC",
+   "DATA_AVAILABLE": 521,
+   "MATCH_FOUND": 0,
+   "RULE_RESOLVED": 0,
+   "RULE_CANDIDATE": 521,
+   "RULE_UNRESOLVED": 0,
+   "OPERATION_CONTEXT_REQUIRED": 0,
+   "CHANGE_REQUIRED": 0,
+   "action_class": {
+    "REVIEW_REQUIRED": 521
+   },
+   "reason_codes": {
+    "ORIGIN_ONLY_FROM_ERP_CST_FIRST_DIGIT_NO_OBJECTIVE_PRODUCT_ORIGIN": 521
+   }
+  },
+  "PIS_CST": {
+   "nature": "OPERATION_DEPENDENT",
+   "DATA_AVAILABLE": 521,
+   "MATCH_FOUND": 2,
+   "RULE_RESOLVED": 0,
+   "RULE_CANDIDATE": 0,
+   "RULE_UNRESOLVED": 0,
+   "OPERATION_CONTEXT_REQUIRED": 521,
+   "CHANGE_REQUIRED": 0,
+   "action_class": {
+    "OPERATION_CONTEXT_REQUIRED": 521
+   },
+   "reason_codes": {
+    "CST_PIS_COFINS_DEPENDS_ON_OPERATION_AND_INCIDENCE_NO_DETERMINISTIC_RULE_IN_CORE_DATASETS": 521
+   }
+  },
+  "COFINS_CST": {
+   "nature": "OPERATION_DEPENDENT",
+   "DATA_AVAILABLE": 521,
+   "MATCH_FOUND": 2,
+   "RULE_RESOLVED": 0,
+   "RULE_CANDIDATE": 0,
+   "RULE_UNRESOLVED": 0,
+   "OPERATION_CONTEXT_REQUIRED": 521,
+   "CHANGE_REQUIRED": 0,
+   "action_class": {
+    "OPERATION_CONTEXT_REQUIRED": 521
+   },
+   "reason_codes": {
+    "CST_PIS_COFINS_DEPENDS_ON_OPERATION_AND_INCIDENCE_NO_DETERMINISTIC_RULE_IN_CORE_DATASETS": 521
+   }
+  },
+  "PIS_COFINS_RATE": {
+   "nature": "COMPANY_CONTEXT_DEPENDENT",
+   "DATA_AVAILABLE": 0,
+   "MATCH_FOUND": 0,
+   "RULE_RESOLVED": 0,
+   "RULE_CANDIDATE": 0,
+   "RULE_UNRESOLVED": 521,
+   "OPERATION_CONTEXT_REQUIRED": 0,
+   "CHANGE_REQUIRED": 0,
+   "action_class": {
+    "NO_RULE": 521
+   },
+   "reason_codes": {
+    "NO_RATE_SOURCE_4_3_10_17_DEFERRED_NEVER_ASSUME_ZERO": 521
+   }
+  },
+  "FCP": {
+   "nature": "OPERATION_DEPENDENT",
+   "DATA_AVAILABLE": 521,
+   "MATCH_FOUND": 0,
+   "RULE_RESOLVED": 0,
+   "RULE_CANDIDATE": 0,
+   "RULE_UNRESOLVED": 0,
+   "OPERATION_CONTEXT_REQUIRED": 521,
+   "CHANGE_REQUIRED": 0,
+   "action_class": {
+    "OPERATION_CONTEXT_REQUIRED": 521
+   },
+   "reason_codes": {
+    "FCP_APPLICABILITY_DEPENDS_ON_DESTINATION_UF_OPERATION_AND_ITEM_LIST": 521
+   }
+  },
+  "RTC_CCLASSTRIB": {
+   "nature": "OPERATION_DEPENDENT",
+   "DATA_AVAILABLE": 521,
+   "MATCH_FOUND": 0,
+   "RULE_RESOLVED": 0,
+   "RULE_CANDIDATE": 0,
+   "RULE_UNRESOLVED": 0,
+   "OPERATION_CONTEXT_REQUIRED": 521,
+   "CHANGE_REQUIRED": 0,
+   "action_class": {
+    "OPERATION_CONTEXT_REQUIRED": 521
+   },
+   "reason_codes": {
+    "NO_NCM_TO_CCLASSTRIB_MAP_IN_ACTIVE_DATASETS_AND_DEPENDS_ON_OPERATION": 521
+   }
+  },
+  "RTC_CBS_RATE": {
+   "nature": "OPERATION_DEPENDENT",
+   "DATA_AVAILABLE": 521,
+   "MATCH_FOUND": 0,
+   "RULE_RESOLVED": 0,
+   "RULE_CANDIDATE": 0,
+   "RULE_UNRESOLVED": 0,
+   "OPERATION_CONTEXT_REQUIRED": 521,
+   "CHANGE_REQUIRED": 0,
+   "action_class": {
+    "OPERATION_CONTEXT_REQUIRED": 521
+   },
+   "reason_codes": {
+    "CBS_2026_RATE_APPLIES_ONLY_AFTER_CCLASSTRIB_RESOLVED_NOT_UNIVERSAL": 521
+   }
+  },
+  "RTC_CCREDPRES": {
+   "nature": "OPERATION_DEPENDENT",
+   "DATA_AVAILABLE": 521,
+   "MATCH_FOUND": 0,
+   "RULE_RESOLVED": 0,
+   "RULE_CANDIDATE": 0,
+   "RULE_UNRESOLVED": 521,
+   "OPERATION_CONTEXT_REQUIRED": 0,
+   "CHANGE_REQUIRED": 0,
+   "action_class": {
+    "NO_RULE": 521
+   },
+   "reason_codes": {
+    "OFFICIAL_CONDITION_NOT_SATISFIED_OR_NOT_KNOWABLE_FROM_PRODUCT": 521
+   }
+  }
+ },
+ "reference_cbs_rate_2026": 0.009
+}

docs/FISCAL_FIELD_CONTRACT_V1.json

@@ -0,0 +1,556 @@
+{
+ "artifact": "FISCAL_FIELD_CONTRACT_V1",
+ "contract_version": "field-contract-v1",
+ "product_table": "C000025",
+ "write_targets": 23,
+ "final_states_per_product_field": [
+  "ALREADY_CORRECT",
+  "CHANGE_REQUIRED",
+  "CORRECTED",
+  "NOT_APPLICABLE",
+  "MANUAL_INPUT_REQUIRED(<input_key>)"
+ ],
+ "declared_valid_policy": "A valid ERP declaration that no proven evidence contradicts is ALREADY_CORRECT with reason DECLARED_VALID_NOT_CONTRADICTED; rule-proven results carry other reasons.",
+ "operator_context_keys": [
+  "cest",
+  "credit_rate",
+  "cst_ipi",
+  "entry_scope",
+  "ex_tipi",
+  "icms_rate",
+  "icms_treatment",
+  "incidence",
+  "ncm",
+  "origin",
+  "pis_cofins_profile",
+  "piscofins",
+  "product_role",
+  "rounding",
+  "service_cfop",
+  "st_status",
+  "st_withheld"
+ ],
+ "context_hierarchy": "PRODUCT > GROUP (CODGRUPO) > NCM > COMPANY (Hub table fiscal_context_entries; API /v1/context; CLI scripts/import_fiscal_context.py)",
+ "unresolved_official_sources": {
+  "PIS/COFINS": "No official rule table in the ACTIVE core datasets maps regime/NCM to CST PIS/COFINS or rates (SPED Tabelas 4.3.x + the Simples Nacional PIS/COFINS guidance are the missing sources; they are manual downloads and were deferred by business scope). Contract answer: company-level `pis_cofins_profile` supplied by the accountant; never assumed 0%.",
+  "ICMS internal rate (regime normal)": "RICMS-BA articles on internal rates/FECP are not in the acquired datasets: `icms_rate` is an operator fact for CRT 2/3 taxed items.",
+  "Monofásico incidence": "Official monophasic NCM list not acquired: INCIDENCIA_PISCOFINS keeps the ERP declaration or takes an operator `incidence`."
+ },
+ "rtc": {
+  "status": {
+   "RTC_CCLASSTRIB": "SUPPORTED_BY_CURRENT_ERP_SCHEMA_UI_BINDING_UNCONFIRMED",
+   "RTC_CCREDPRES": "ERP_SCHEMA_NOT_READY",
+   "RTC_CBS_RATES": "ERP_SCHEMA_NOT_READY"
+  },
+  "evidence": "C000025.CCLASSTRIB VARCHAR(6) exists (all NULL) in CONSTRUCAO, MMMODAS, RINCAO and UNIAO (a newer SGV schema) and is absent in TESTESOFICIAIS. The SGV executable available locally (5.0.6.124) neither binds nor mentions it and the fiscal screen shows no such control, so the binding cannot be confirmed; no cCredPres/CBS/IBS column exists in any database.",
+  "write_target": false,
+  "why_not_written": "no proven UI binding and no NCM -> LC 214 annex (cClassTrib) source in the ACTIVE datasets; a value here would be invented",
+  "to_close": [
+   "the newer SGV executable/screen that binds CCLASSTRIB (binding proof)",
+   "official LC 214/2025 annex NCM lists to derive cClassTrib deterministically"
+  ]
+ },
+ "not_persisted_controls": {
+  "CSOSN significado (ComboBox1)": "presentation only, not data-aware",
+  "CODALIQUOTA": "exists in the ERP, empty, not on the fiscal screen: not a requirement without new evidence"
+ },
+ "fields": {
+  "CLASSIFICACAO_FISCAL": {
+   "UI_LABEL": "NCM",
+   "SEMANTICS": "NCM canônico (8 dígitos)",
+   "DATA_TYPE": "VARCHAR(20)",
+   "SOURCE_OF_TRUTH": "dataset NCM (Siscomex) ACTIVE + legacy NCM table",
+   "REQUIRED_INPUTS": [
+    "current NCM"
+   ],
+   "RESOLUTION_RULE": "VALID -> ALREADY_CORRECT. LEGACY/INVALID/MISSING never auto-replaced from the description; an OPERATOR context `ncm` that the Hub validates as EXACT_NCM becomes CHANGE_REQUIRED and every dependent field is reprocessed with it",
+   "VALID_VALUES": "8-digit code present in the ACTIVE NCM dataset",
+   "NOT_APPLICABLE_RULE": "never (every product has an NCM)",
+   "MANUAL_INPUT_RULE": "MANUAL_INPUT_REQUIRED(ncm) for LEGACY/INVALID/MISSING or an invalid manual value",
+   "WRITE_ALLOWED": true,
+   "VALIDATION_RULE": "Hub classify status == EXACT_NCM",
+   "PROVENANCE": "NCM dataset sha256 + engine version",
+   "ERP_FIELD": "CLASSIFICACAO_FISCAL",
+   "UI_BINDING": {
+    "classification": "CONFIRMED_STRONG",
+    "evidence": "DFM: TDBEdit DBEdit14 DataField=CLASSIFICACAO_FISCAL DataSource=dsproduto2 (qrproduto = select * from c000025)"
+   }
+  },
+  "IPI": {
+   "UI_LABEL": "Alíquota IPI %",
+   "SEMANTICS": "alíquota numérica de IPI",
+   "DATA_TYPE": "DOUBLE PRECISION",
+   "SOURCE_OF_TRUTH": "dataset TIPI_IPI ACTIVE",
+   "REQUIRED_INPUTS": [
+    "valid NCM",
+    "TIPI row (and EX choice when several rows)"
+   ],
+   "RESOLUTION_RULE": "TIPI numeric rate -> ALREADY_CORRECT if equal else CHANGE_REQUIRED. NT/non-numeric and blank rates never write (NOT_APPLICABLE, never zero)",
+   "VALID_VALUES": "float >= 0",
+   "NOT_APPLICABLE_RULE": "TIPI rate is NT/non-numeric or blank",
+   "MANUAL_INPUT_RULE": "MANUAL_INPUT_REQUIRED(ex_tipi) when several TIPI rows exist for the NCM",
+   "WRITE_ALLOWED": true,
+   "VALIDATION_RULE": "numeric, from TIPI row",
+   "PROVENANCE": "TIPI dataset sha256",
+   "ERP_FIELD": "IPI",
+   "UI_BINDING": {
+    "classification": "CONFIRMED_STRONG",
+    "evidence": "DFM: TRzDBEdit RzDBEdit2 DataField=IPI DataSource=dsproduto2 (qrproduto = select * from c000025)"
+   }
+  },
+  "EX_TIPI": {
+   "UI_LABEL": "EX TIPI",
+   "SEMANTICS": "código EX da TIPI",
+   "DATA_TYPE": "VARCHAR(3)",
+   "SOURCE_OF_TRUTH": "dataset TIPI_IPI + product description evidence",
+   "REQUIRED_INPUTS": [
+    "valid NCM",
+    "TIPI EX rows"
+   ],
+   "RESOLUTION_RULE": "EX applies only when the product description carries the official EX description; otherwise the base rate applies (no EX)",
+   "VALID_VALUES": "EX code of an existing TIPI EX row",
+   "NOT_APPLICABLE_RULE": "NCM has no EX row, or the description evidences none",
+   "MANUAL_INPUT_RULE": "MANUAL_INPUT_REQUIRED(ex_tipi) when the ERP holds an EX that no TIPI row supports",
+   "WRITE_ALLOWED": true,
+   "VALIDATION_RULE": "value in TIPI EX rows for the NCM",
+   "PROVENANCE": "TIPI dataset sha256",
+   "ERP_FIELD": "EX_TIPI",
+   "UI_BINDING": {
+    "classification": "CONFIRMED_STRONG",
+    "evidence": "user-declared earlier missions; TIPI column EX_TIPI"
+   }
+  },
+  "CEST": {
+   "UI_LABEL": "CEST",
+   "SEMANTICS": "CEST (7 dígitos sem pontuação)",
+   "DATA_TYPE": "VARCHAR(7)",
+   "SOURCE_OF_TRUTH": "dataset CEST (CONFAZ 142/18) ACTIVE + BA_ST_MVA",
+   "REQUIRED_INPUTS": [
+    "valid NCM",
+    "description"
+   ],
+   "RESOLUTION_RULE": "single defensible official CEST -> ALREADY/CHANGE; ERP CEST that is one of the official codes of the NCM -> ALREADY_CORRECT; several official candidates with a blank CEST -> MANUAL; NCM absent from the CEST list -> NOT_APPLICABLE",
+   "VALID_VALUES": "official CEST code of the NCM",
+   "NOT_APPLICABLE_RULE": "NCM not in the CEST list, or the description matches no official CEST item",
+   "MANUAL_INPUT_RULE": "MANUAL_INPUT_REQUIRED(cest) when several official candidates exist, or the ERP CEST is not official for the NCM",
+   "WRITE_ALLOWED": true,
+   "VALIDATION_RULE": "digits equal to an official CEST of the NCM",
+   "PROVENANCE": "CEST dataset sha256",
+   "ERP_FIELD": "CEST",
+   "UI_BINDING": {
+    "classification": "CONFIRMED_STRONG",
+    "evidence": "DFM: TDBEdit DBEdit74 DataField=CEST DataSource=dsproduto2 (qrproduto = select * from c000025)"
+   }
+  },
+  "SITUACAO_TRIBUTARIA": {
+   "UI_LABEL": "Seletor ao lado do CEST",
+   "SEMANTICS": "T=Tributado, I=Isento, N=Não tributado, S=Substituição Tributária",
+   "DATA_TYPE": "VARCHAR(2)",
+   "SOURCE_OF_TRUTH": "ST engine (BA Anexo 1 + CEST corroboration) + purchase evidence / operator st_withheld",
+   "REQUIRED_INPUTS": [
+    "ST status",
+    "ST withheld"
+   ],
+   "RESOLUTION_RULE": "ST proven and withheld -> S. Otherwise a valid declaration stays",
+   "VALID_VALUES": "T | I | N | S",
+   "NOT_APPLICABLE_RULE": "never",
+   "MANUAL_INPUT_RULE": "MANUAL_INPUT_REQUIRED(st_withheld) when ST is proven but retention unknown; (icms_treatment) when the field is blank",
+   "WRITE_ALLOWED": true,
+   "VALIDATION_RULE": "value in T/I/N/S",
+   "PROVENANCE": "BA_ST_MVA + CEST dataset sha256",
+   "ERP_FIELD": "SITUACAO_TRIBUTARIA",
+   "UI_BINDING": {
+    "classification": "CONFIRMED_STRONG",
+    "evidence": "DFM: TwwDBComboBox wwDBComboBox2 DataField=SITUACAO_TRIBUTARIA DataSource=dsproduto2 (qrproduto = select * from c000025)"
+   }
+  },
+  "CFOP": {
+   "UI_LABEL": "CFOP (Nota Fiscal de Saída)",
+   "SEMANTICS": "CFOP padrão de saída (intra-UF)",
+   "DATA_TYPE": "VARCHAR(4)",
+   "SOURCE_OF_TRUTH": "dataset CFOP oficial + product role + ST",
+   "REQUIRED_INPUTS": [
+    "product_role",
+    "ST status",
+    "ST withheld"
+   ],
+   "RESOLUTION_RULE": "RESALE: non-ST 5102, ST withheld 5405; OWN_PRODUCTION: 5101 / 5401; a declared official 5xxx that is not contradicted by proven role/ST stays",
+   "VALID_VALUES": "official CFOP starting with 5",
+   "NOT_APPLICABLE_RULE": "INPUT (not a sale item)",
+   "MANUAL_INPUT_RULE": "MANUAL_INPUT_REQUIRED(product_role | st_status | st_withheld | service_cfop)",
+   "WRITE_ALLOWED": true,
+   "VALIDATION_RULE": "code in CFOP dataset",
+   "PROVENANCE": "CFOP dataset sha256",
+   "ERP_FIELD": "CFOP",
+   "UI_BINDING": {
+    "classification": "CONFIRMED_STRONG",
+    "evidence": "DFM: TRzDBButtonEdit DbEdit71 DataField=CFOP DataSource=dsproduto2 (qrproduto = select * from c000025)"
+   }
+  },
+  "CFOP_ENTRADA": {
+   "UI_LABEL": "CFOP (Nota Fiscal de Entrada)",
+   "SEMANTICS": "CFOP padrão de entrada",
+   "DATA_TYPE": "CHAR(4)",
+   "SOURCE_OF_TRUTH": "dataset CFOP + product role + ST + company entry scope",
+   "REQUIRED_INPUTS": [
+    "product_role",
+    "ST withheld",
+    "entry_scope (company)"
+   ],
+   "RESOLUTION_RULE": "RESALE 1102/2102, ST withheld 1403/2403, OWN_PRODUCTION/INPUT 1101/2101 (ST 1401/2401); declared official 1xxx/2xxx that is not contradicted stays",
+   "VALID_VALUES": "official CFOP starting with 1 or 2",
+   "NOT_APPLICABLE_RULE": "SERVICE",
+   "MANUAL_INPUT_RULE": "MANUAL_INPUT_REQUIRED(product_role | entry_scope | st_withheld)",
+   "WRITE_ALLOWED": true,
+   "VALIDATION_RULE": "code in CFOP dataset",
+   "PROVENANCE": "CFOP dataset sha256",
+   "ERP_FIELD": "CFOP_ENTRADA",
+   "UI_BINDING": {
+    "classification": "CONFIRMED_STRONG",
+    "evidence": "DFM: TDBEdit DBEdit72 DataField=CFOP_ENTRADA DataSource=dsproduto2 (qrproduto = select * from c000025)"
+   }
+  },
+  "CST": {
+   "UI_LABEL": "CST de ICMS (Nota Fiscal de Saída)",
+   "SEMANTICS": "CST ICMS = origem(1)+CST(2), regime normal",
+   "DATA_TYPE": "VARCHAR(10)",
+   "SOURCE_OF_TRUTH": "MOC CST_ICMS + ORIGEM tables + icms_treatment",
+   "REQUIRED_INPUTS": [
+    "CRT 2/3",
+    "icms_treatment",
+    "origin"
+   ],
+   "RESOLUTION_RULE": "CRT 1 uses CSOSN. CRT 2/3: treatment TAXED 00 / EXEMPT 40 / NOT_TAXED 41 / ST_WITHHELD 60; a valid declaration that the treatment does not contradict stays",
+   "VALID_VALUES": "3 digits: origin 0-8 + CST_ICMS code",
+   "NOT_APPLICABLE_RULE": "CRT = 1",
+   "MANUAL_INPUT_RULE": "MANUAL_INPUT_REQUIRED(icms_treatment | origin) when blank and not derivable",
+   "WRITE_ALLOWED": true,
+   "VALIDATION_RULE": "origin in ORIGEM table, last two digits in CST_ICMS",
+   "PROVENANCE": "MOC tables sha256",
+   "ERP_FIELD": "CST",
+   "UI_BINDING": {
+    "classification": "CONFIRMED_STRONG",
+    "evidence": "DFM: TRzDBButtonEdit dbedit13 DataField=CST DataSource=dsproduto2 (qrproduto = select * from c000025)"
+   }
+  },
+  "CST_ENTRADA": {
+   "UI_LABEL": "CST de ICMS (Nota Fiscal de Entrada)",
+   "SEMANTICS": "CST ICMS de entrada, regime normal",
+   "DATA_TYPE": "CHAR(4)",
+   "SOURCE_OF_TRUTH": "MOC tables + icms_treatment",
+   "REQUIRED_INPUTS": [
+    "CRT 2/3",
+    "icms_treatment",
+    "origin"
+   ],
+   "RESOLUTION_RULE": "same derivation as CST for CRT 2/3",
+   "VALID_VALUES": "3 digits origin+CST",
+   "NOT_APPLICABLE_RULE": "CRT = 1",
+   "MANUAL_INPUT_RULE": "MANUAL_INPUT_REQUIRED(icms_treatment | origin)",
+   "WRITE_ALLOWED": true,
+   "VALIDATION_RULE": "as CST",
+   "PROVENANCE": "MOC tables sha256",
+   "ERP_FIELD": "CST_ENTRADA",
+   "UI_BINDING": {
+    "classification": "CONFIRMED_STRONG",
+    "evidence": "DFM: TDBEdit DBEdit73 DataField=CST_ENTRADA DataSource=dsproduto2 (qrproduto = select * from c000025)"
+   }
+  },
+  "CSOSN": {
+   "UI_LABEL": "CSOSN Classificação",
+   "SEMANTICS": "CSOSN de saída (Simples Nacional)",
+   "DATA_TYPE": "VARCHAR(60)",
+   "SOURCE_OF_TRUTH": "MOC CSOSN table + icms_treatment (operator or proven ST)",
+   "REQUIRED_INPUTS": [
+    "CRT 1",
+    "icms_treatment"
+   ],
+   "RESOLUTION_RULE": "treatment TAXED -> 101/102/103 family (default 102), EXEMPT/NOT_TAXED -> 300/400 (default 400), ST_WITHHELD -> 500; a valid declaration outside a proven contradiction stays",
+   "VALID_VALUES": "CSOSN code in MOC table",
+   "NOT_APPLICABLE_RULE": "CRT != 1",
+   "MANUAL_INPUT_RULE": "MANUAL_INPUT_REQUIRED(icms_treatment) when blank/invalid",
+   "WRITE_ALLOWED": true,
+   "VALIDATION_RULE": "code in CSOSN table",
+   "PROVENANCE": "MOC tables sha256",
+   "ERP_FIELD": "CSOSN",
+   "UI_BINDING": {
+    "classification": "CONFIRMED_STRONG",
+    "evidence": "DFM: TDBEdit DBEdit75 DataField=CSOSN DataSource=dsproduto2 (qrproduto = select * from c000025)"
+   }
+  },
+  "ALIQUOTA": {
+   "UI_LABEL": "Aliq. ICMS",
+   "SEMANTICS": "alíquota ICMS % de destaque",
+   "DATA_TYPE": "NUMERIC(15,2)",
+   "SOURCE_OF_TRUTH": "regime + CSOSN/CST family + operator icms_rate",
+   "REQUIRED_INPUTS": [
+    "CSOSN or CST family",
+    "icms_rate (company/group) for taxed regime-normal items"
+   ],
+   "RESOLUTION_RULE": "no ICMS highlighted (CSOSN 102/103/300/400/500/202/203/900 or CST 40/41/60/50/51) -> NOT_APPLICABLE; taxed items keep a declared value or take the operator icms_rate",
+   "VALID_VALUES": "numeric >= 0",
+   "NOT_APPLICABLE_RULE": "no ICMS is highlighted for the item",
+   "MANUAL_INPUT_RULE": "MANUAL_INPUT_REQUIRED(icms_rate | credit_rate)",
+   "WRITE_ALLOWED": true,
+   "VALIDATION_RULE": "numeric",
+   "PROVENANCE": "operator context / company regime",
+   "ERP_FIELD": "ALIQUOTA",
+   "UI_BINDING": {
+    "classification": "CONFIRMED_STRONG",
+    "evidence": "DFM: TDBEdit ealiq DataField=ALIQUOTA DataSource=dsproduto2 (qrproduto = select * from c000025)"
+   }
+  },
+  "COD_ORIGEM_MERCADORIA": {
+   "UI_LABEL": "Código da origem da Mercadoria (0/1/2)",
+   "SEMANTICS": "origem da mercadoria (0 Nacional, 1 Estrangeira-importação direta, 2 Estrangeira-mercado interno)",
+   "DATA_TYPE": "INTEGER",
+   "SOURCE_OF_TRUTH": "operator origin, else the origin digit of the ERP's own CST declaration",
+   "REQUIRED_INPUTS": [
+    "origin"
+   ],
+   "RESOLUTION_RULE": "declared 0/1/2 stays; blank is filled from the ERP CST origin digit when it is 0/1/2; a CST digit 3-8 or conflicting declarations need the operator (the SGV screen only offers 0/1/2)",
+   "VALID_VALUES": "0 | 1 | 2",
+   "NOT_APPLICABLE_RULE": "never",
+   "MANUAL_INPUT_RULE": "MANUAL_INPUT_REQUIRED(origin)",
+   "WRITE_ALLOWED": true,
+   "VALIDATION_RULE": "value in {0,1,2}",
+   "PROVENANCE": "SGV DFM: hidden edit CodOrigemMercadoria + RgOrigemMercadoria.OnClick",
+   "ERP_FIELD": "COD_ORIGEM_MERCADORIA",
+   "UI_BINDING": {
+    "classification": "CONFIRMED_STRONG",
+    "evidence": "DFM: RgOrigemMercadoria (TRadioGroup, OnClick=RgOrigemMercadoriaClick, no DataField) + hidden data-aware TDBEdit CodOrigemMercadoria bound to COD_ORIGEM_MERCADORIA in the same tab; the only origin-bound control of the form; values 0/1/2 observed in 4 databases"
+   }
+  },
+  "CST_IPI": {
+   "UI_LABEL": "CST IPI",
+   "SEMANTICS": "CST do IPI",
+   "DATA_TYPE": "CHAR(3)",
+   "SOURCE_OF_TRUTH": "company C000004.CONTRIBUINTE_IPI",
+   "REQUIRED_INPUTS": [
+    "company IPI taxpayer flag"
+   ],
+   "RESOLUTION_RULE": "company not an IPI taxpayer (CONTRIBUINTE_IPI != S) -> NOT_APPLICABLE; taxpayer -> declared value stays",
+   "VALID_VALUES": "IPI CST code",
+   "NOT_APPLICABLE_RULE": "company is not an IPI taxpayer",
+   "MANUAL_INPUT_RULE": "MANUAL_INPUT_REQUIRED(cst_ipi) for IPI taxpayers with a blank value",
+   "WRITE_ALLOWED": true,
+   "VALIDATION_RULE": "non-blank code",
+   "PROVENANCE": "C000004.CONTRIBUINTE_IPI",
+   "ERP_FIELD": "CST_IPI",
+   "UI_BINDING": {
+    "classification": "CONFIRMED_STRONG",
+    "evidence": "DFM: TRzDBEdit RzDBEdit1 DataField=CST_IPI DataSource=dsproduto2 (qrproduto = select * from c000025)"
+   }
+  },
+  "COD_ENTRADA_PIS": {
+   "UI_LABEL": "Pis Entrada",
+   "SEMANTICS": "CST PIS de entrada",
+   "DATA_TYPE": "VARCHAR(3)",
+   "SOURCE_OF_TRUTH": "MOC CST_PIS + operator pis_cofins_profile",
+   "REQUIRED_INPUTS": [
+    "pis_cofins_profile"
+   ],
+   "RESOLUTION_RULE": "profile in_cst (validated against CST_PIS) -> ALREADY/CHANGE; else a valid declared code stays",
+   "VALID_VALUES": "CST PIS code",
+   "NOT_APPLICABLE_RULE": "never",
+   "MANUAL_INPUT_RULE": "MANUAL_INPUT_REQUIRED(pis_cofins_profile)",
+   "WRITE_ALLOWED": true,
+   "VALIDATION_RULE": "code in CST_PIS table",
+   "PROVENANCE": "MOC tables sha256",
+   "ERP_FIELD": "COD_ENTRADA_PIS",
+   "UI_BINDING": {
+    "classification": "CONFIRMED_STRONG",
+    "evidence": "DFM: TRzDBButtonEdit RzDBButtonEdit5 DataField=COD_ENTRADA_PIS DataSource=dsproduto2 (qrproduto = select * from c000025)"
+   }
+  },
+  "COD_SAIDA_PIS": {
+   "UI_LABEL": "Pis Saída",
+   "SEMANTICS": "CST PIS de saída",
+   "DATA_TYPE": "VARCHAR(3)",
+   "SOURCE_OF_TRUTH": "MOC CST_PIS + operator pis_cofins_profile",
+   "REQUIRED_INPUTS": [
+    "pis_cofins_profile"
+   ],
+   "RESOLUTION_RULE": "profile out_cst -> ALREADY/CHANGE; else a valid declared code stays",
+   "VALID_VALUES": "CST PIS code",
+   "NOT_APPLICABLE_RULE": "never",
+   "MANUAL_INPUT_RULE": "MANUAL_INPUT_REQUIRED(pis_cofins_profile)",
+   "WRITE_ALLOWED": true,
+   "VALIDATION_RULE": "code in CST_PIS table",
+   "PROVENANCE": "MOC tables sha256",
+   "ERP_FIELD": "COD_SAIDA_PIS",
+   "UI_BINDING": {
+    "classification": "CONFIRMED_STRONG",
+    "evidence": "DFM: TRzDBButtonEdit RzDBButtonEdit2 DataField=COD_SAIDA_PIS DataSource=dsproduto2 (qrproduto = select * from c000025)"
+   }
+  },
+  "ALIQ_PIS": {
+   "UI_LABEL": "Alíquota (Pis)",
+   "SEMANTICS": "alíquota PIS %",
+   "DATA_TYPE": "VARCHAR(8)",
+   "SOURCE_OF_TRUTH": "operator pis_cofins_profile",
+   "REQUIRED_INPUTS": [
+    "pis_cofins_profile"
+   ],
+   "RESOLUTION_RULE": "profile pis_rate -> ALREADY/CHANGE; else a declared value stays (never assumed 0)",
+   "VALID_VALUES": "decimal text",
+   "NOT_APPLICABLE_RULE": "never",
+   "MANUAL_INPUT_RULE": "MANUAL_INPUT_REQUIRED(pis_cofins_profile)",
+   "WRITE_ALLOWED": true,
+   "VALIDATION_RULE": "numeric text",
+   "PROVENANCE": "operator context",
+   "ERP_FIELD": "ALIQ_PIS",
+   "UI_BINDING": {
+    "classification": "CONFIRMED_STRONG",
+    "evidence": "DFM: TRzDBEdit RzDBEdit3 DataField=ALIQ_PIS DataSource=dsproduto2 (qrproduto = select * from c000025)"
+   }
+  },
+  "COD_ENTRADA_COFINS": {
+   "UI_LABEL": "Cofins Entrada",
+   "SEMANTICS": "CST COFINS de entrada",
+   "DATA_TYPE": "VARCHAR(3)",
+   "SOURCE_OF_TRUTH": "MOC CST_COFINS + operator pis_cofins_profile",
+   "REQUIRED_INPUTS": [
+    "pis_cofins_profile"
+   ],
+   "RESOLUTION_RULE": "profile in_cst -> ALREADY/CHANGE; else a valid declared code stays",
+   "VALID_VALUES": "CST COFINS code",
+   "NOT_APPLICABLE_RULE": "never",
+   "MANUAL_INPUT_RULE": "MANUAL_INPUT_REQUIRED(pis_cofins_profile)",
+   "WRITE_ALLOWED": true,
+   "VALIDATION_RULE": "code in CST_COFINS table",
+   "PROVENANCE": "MOC tables sha256",
+   "ERP_FIELD": "COD_ENTRADA_COFINS",
+   "UI_BINDING": {
+    "classification": "CONFIRMED_STRONG",
+    "evidence": "DFM: TRzDBButtonEdit RzDBButtonEdit3 DataField=COD_ENTRADA_COFINS DataSource=dsproduto2 (qrproduto = select * from c000025)"
+   }
+  },
+  "COD_SAIDA_COFINS": {
+   "UI_LABEL": "Cofins Saída",
+   "SEMANTICS": "CST COFINS de saída",
+   "DATA_TYPE": "VARCHAR(3)",
+   "SOURCE_OF_TRUTH": "MOC CST_COFINS + operator pis_cofins_profile",
+   "REQUIRED_INPUTS": [
+    "pis_cofins_profile"
+   ],
+   "RESOLUTION_RULE": "profile out_cst -> ALREADY/CHANGE; else a valid declared code stays",
+   "VALID_VALUES": "CST COFINS code",
+   "NOT_APPLICABLE_RULE": "never",
+   "MANUAL_INPUT_RULE": "MANUAL_INPUT_REQUIRED(pis_cofins_profile)",
+   "WRITE_ALLOWED": true,
+   "VALIDATION_RULE": "code in CST_COFINS table",
+   "PROVENANCE": "MOC tables sha256",
+   "ERP_FIELD": "COD_SAIDA_COFINS",
+   "UI_BINDING": {
+    "classification": "CONFIRMED_STRONG",
+    "evidence": "DFM: TRzDBButtonEdit RzDBButtonEdit1 DataField=COD_SAIDA_COFINS DataSource=dsproduto2 (qrproduto = select * from c000025)"
+   }
+  },
+  "ALIQ_COFINS": {
+   "UI_LABEL": "Alíquota (Cofins)",
+   "SEMANTICS": "alíquota COFINS %",
+   "DATA_TYPE": "VARCHAR(8)",
+   "SOURCE_OF_TRUTH": "operator pis_cofins_profile",
+   "REQUIRED_INPUTS": [
+    "pis_cofins_profile"
+   ],
+   "RESOLUTION_RULE": "profile cofins_rate -> ALREADY/CHANGE; else a declared value stays (never assumed 0)",
+   "VALID_VALUES": "decimal text",
+   "NOT_APPLICABLE_RULE": "never",
+   "MANUAL_INPUT_RULE": "MANUAL_INPUT_REQUIRED(pis_cofins_profile)",
+   "WRITE_ALLOWED": true,
+   "VALIDATION_RULE": "numeric text",
+   "PROVENANCE": "operator context",
+   "ERP_FIELD": "ALIQ_COFINS",
+   "UI_BINDING": {
+    "classification": "CONFIRMED_STRONG",
+    "evidence": "DFM: TRzDBEdit RzDBEdit4 DataField=ALIQ_COFINS DataSource=dsproduto2 (qrproduto = select * from c000025)"
+   }
+  },
+  "INCIDENCIA_PISCOFINS": {
+   "UI_LABEL": "Incidência",
+   "SEMANTICS": "tipo de incidência PIS/COFINS",
+   "DATA_TYPE": "VARCHAR(30)",
+   "SOURCE_OF_TRUTH": "ERP declaration (NENHUMA / MONOFÁSICA / SUBST.TRIBUTÁRIA) + operator incidence",
+   "REQUIRED_INPUTS": [
+    "incidence (group) when blank"
+   ],
+   "RESOLUTION_RULE": "valid declaration stays; operator `incidence` may set it",
+   "VALID_VALUES": "NENHUMA | MONOFÁSICA | SUBST.TRIBUTÁRIA",
+   "NOT_APPLICABLE_RULE": "never",
+   "MANUAL_INPUT_RULE": "MANUAL_INPUT_REQUIRED(incidence)",
+   "WRITE_ALLOWED": true,
+   "VALIDATION_RULE": "value in domain",
+   "PROVENANCE": "ERP domain observed in 4 databases",
+   "ERP_FIELD": "INCIDENCIA_PISCOFINS",
+   "UI_BINDING": {
+    "classification": "CONFIRMED_STRONG",
+    "evidence": "DFM: TwwDBComboBox wwDBComboBox1 DataField=INCIDENCIA_PISCOFINS DataSource=dsproduto2 (qrproduto = select * from c000025)"
+   }
+  },
+  "PISCOFINS": {
+   "UI_LABEL": "PIS/COFINS (combo)",
+   "SEMANTICS": "flag PIS/COFINS N/S",
+   "DATA_TYPE": "VARCHAR(1)",
+   "SOURCE_OF_TRUTH": "ERP declaration + operator piscofins",
+   "REQUIRED_INPUTS": [
+    "piscofins when blank"
+   ],
+   "RESOLUTION_RULE": "valid N/S stays; operator `piscofins` may set it",
+   "VALID_VALUES": "N | S",
+   "NOT_APPLICABLE_RULE": "never",
+   "MANUAL_INPUT_RULE": "MANUAL_INPUT_REQUIRED(piscofins)",
+   "WRITE_ALLOWED": true,
+   "VALIDATION_RULE": "value in N/S",
+   "PROVENANCE": "ERP domain observed in 4 databases",
+   "ERP_FIELD": "PISCOFINS",
+   "UI_BINDING": {
+    "classification": "CONFIRMED_STRONG",
+    "evidence": "DFM: TwwDBComboBox ecombo_piscofins DataField=PISCOFINS DataSource=dsproduto2 (qrproduto = select * from c000025)"
+   }
+  },
+  "IAT": {
+   "UI_LABEL": "IAT",
+   "SEMANTICS": "indicador de arredondamento (A) ou truncamento (T)",
+   "DATA_TYPE": "VARCHAR(1)",
+   "SOURCE_OF_TRUTH": "company rounding policy (operator) or ERP declaration",
+   "REQUIRED_INPUTS": [
+    "rounding (company) when blank"
+   ],
+   "RESOLUTION_RULE": "valid A/T stays; blank -> operator `rounding`",
+   "VALID_VALUES": "A | T",
+   "NOT_APPLICABLE_RULE": "never",
+   "MANUAL_INPUT_RULE": "MANUAL_INPUT_REQUIRED(rounding)",
+   "WRITE_ALLOWED": true,
+   "VALIDATION_RULE": "value in A/T",
+   "PROVENANCE": "PAF-ECF/Convênio registro de produto layout (IAT)",
+   "ERP_FIELD": "IAT",
+   "UI_BINDING": {
+    "classification": "CONFIRMED_STRONG",
+    "evidence": "DFM: TwwDBComboBox wwDBComboBox3 DataField=IAT DataSource=dsproduto2 (qrproduto = select * from c000025)"
+   }
+  },
+  "IPPT": {
+   "UI_LABEL": "IPPT",
+   "SEMANTICS": "indicador de produção própria (P) ou de terceiros (T)",
+   "DATA_TYPE": "VARCHAR(1)",
+   "SOURCE_OF_TRUTH": "product_role (own production evidence / purchase evidence / operator)",
+   "REQUIRED_INPUTS": [
+    "product_role"
+   ],
+   "RESOLUTION_RULE": "OWN_PRODUCTION -> P, RESALE -> T; INPUT/SERVICE not applicable",
+   "VALID_VALUES": "P | T",
+   "NOT_APPLICABLE_RULE": "INPUT or SERVICE",
+   "MANUAL_INPUT_RULE": "MANUAL_INPUT_REQUIRED(product_role)",
+   "WRITE_ALLOWED": true,
+   "VALIDATION_RULE": "value in P/T",
+   "PROVENANCE": "PAF-ECF/Convênio registro de produto layout (IPPT)",
+   "ERP_FIELD": "IPPT",
+   "UI_BINDING": {
+    "classification": "CONFIRMED_STRONG",
+    "evidence": "DFM: TwwDBComboBox wwDBComboBox4 DataField=IPPT DataSource=dsproduto2 (qrproduto = select * from c000025)"
+   }
+  }
+ }
+}

docs/ICMS_CONTEXT_COVERAGE_V1.json

@@ -0,0 +1,82 @@
+{
+ "artifact": "ICMS_CONTEXT_COVERAGE_V1",
+ "firebird_writes": 0,
+ "TOTAL_PRODUCTS": 521,
+ "engine": "icms-context-v1",
+ "ST": {
+  "ST_CONFIRMED": 0,
+  "ST_NOT_APPLICABLE": 28,
+  "ST_CANDIDATE": 268,
+  "ST_UNKNOWN": 225
+ },
+ "ST_reasons": {
+  "NCM_ABSENT_FROM_BA_ANNEX1_AND_CEST_LIST": 28,
+  "NCM_NOT_VALID": 26,
+  "MULTIPLE_BA_ANNEX1_ITEMS": 237,
+  "CEST_LISTED_BUT_BA_ANNEX1_ABSENT": 199,
+  "UNIQUE_BA_ANNEX1_ITEM_WITHOUT_CEST_CORROBORATION": 31
+ },
+ "ST_WITHHELD": {
+  "ST_ALREADY_WITHHELD_CONFIRMED": 0,
+  "ST_ALREADY_WITHHELD_NOT_CONFIRMED": 11,
+  "ST_ALREADY_WITHHELD_UNKNOWN": 510
+ },
+ "PRODUCT_ROLE": {
+  "RESALE": 13,
+  "OWN_PRODUCTION": 18,
+  "INPUT": 7,
+  "SERVICE": 0,
+  "UNKNOWN": 483
+ },
+ "CSOSN": {
+  "RESOLVED": 0,
+  "ALREADY_CORRECT": 0,
+  "CHANGE_REQUIRED": 0,
+  "CANDIDATES": 5,
+  "CONTEXT_REQUIRED": 490,
+  "CONFLICT": 0,
+  "UNRESOLVED": 26,
+  "AUTO_APPLY_SAFE": 0,
+  "AUTO_APPLY_READY_IF_ENABLED": 0,
+  "action_class": {
+   "CONTEXT_REQUIRED": 490,
+   "REVIEW_REQUIRED": 5,
+   "NO_RULE": 26
+  },
+  "reasons": {
+   "ST_CANDIDATE_APPLICABILITY_UNPROVEN": 268,
+   "ST_UNKNOWN_APPLICABILITY_UNPROVEN": 198,
+   "NCM_NOT_VALID": 26,
+   "PRODUCT_ROLE_UNKNOWN": 21,
+   "NON_ST_MATCHES_COMPANY_DEFAULT_ICMS_TREATMENT_UNPROVEN": 5,
+   "DIFFERS_FROM_OR_LACKS_COMPANY_DEFAULT_TREATMENT_UNPROVEN": 2,
+   "ROLE_INPUT_NOT_A_MERCHANDISE_SALE_DEFAULT": 1
+  }
+ },
+ "CSOSN_HISTORY_of_proposals": {
+  "MATCH": 4,
+  "MISMATCH": 0,
+  "UNVALIDATED": 517
+ },
+ "CSOSN_HISTORY_of_proposals_note": "MATCH/MISMATCH/UNVALIDATED counted on products WITH a proposed value; UNVALIDATED additionally counts products with no proposal (nothing to validate).",
+ "NCM_BLOCKED_PRODUCTS": 26,
+ "NCM_BLOCKED_ONLY_BY_NCM": 26,
+ "ST_CONFLICT_AUDIT": {
+  "population": 29,
+  "primary_class": {
+   "NO_EVIDENCE": 2,
+   "ERP_HISTORY_CONFLICT": 14,
+   "DESCRIPTION_MISMATCH": 8,
+   "MULTIPLE_CEST": 4,
+   "BA_ST_RULE_CONFLICT": 1
+  },
+  "any_flag": {
+   "NO_EVIDENCE": 2,
+   "ERP_HISTORY_CONFLICT": 15,
+   "DESCRIPTION_MISMATCH": 21,
+   "MULTIPLE_CEST": 5,
+   "BA_ST_RULE_CONFLICT": 1,
+   "NCM_TOO_BROAD": 1
+  }
+ }
+}

docs/LOCAL_COMPLETION_GATE_REPORT_V1.md

@@ -0,0 +1,17 @@
+# Último gate determinístico — relatório
+
+## Fontes
+- SPED (host acessível por http; https recusado): tabelas 4.3.10 (LC 228/2026), 4.3.11 (Decreto 12.875/2026), 4.3.12, 4.3.13 v1.34 (16/04/2026), 4.3.14, 4.3.15 v1.02, 4.3.3, 4.3.4 baixadas direto do repositório oficial, parseadas e validadas → `docs/sources/SPED_PISCOFINS_TABLES_V3.json` (source_url, download_date, effective_date, version, sha256). V2 (snapshot arquivado de 2023) mantido em `SPED_PISCOFINS_TABLES_V2_archived_2023_snapshot.json`. NT 011/2026 (EFD-Contribuições descontinuada em 2027, sem efeito no cadastro de produto) e NT 012/2026 (LC 224/2025 reduz benefícios por ajustes M110/M220 **sem alterar os CST**) arquivadas.
+- RICMS-BA Anexo 1 vigente 2026: baixado (sha 2da37467…, republicação com Prot. ICMS 119/26, 120/26, 93/26), diferente do dataset ativo (e07e9085…). Diff: 1 item removido, 8 itens com MVA/nota alterada, **0 prefixos de NCM alterados → 0 produtos afetados** nos 5 bancos (`docs/BA_ST_MVA_REFRESH_DIFF_V1.json`). Dataset ativo NÃO alterado; PDF versionado.
+- Manifesto: `docs/sources/SOURCES_MANIFEST_V3.json`.
+
+## Efeito do reprocessamento
+- Pendências eliminadas pelas fontes novas: **0** (MANUAL 55.756 → 55.756).
+- Efeito real: a nova 4.3.11 (bebidas frias, NCM 2202.10.00, monofásico revenda) transformou 154 células NOT_APPLICABLE em CST oficial 04 (UNIAO, 77 produtos, PIS e COFINS). Gravadas: 154/154 verificadas, 2ª passada 0 escritas.
+- Nenhum valor incerto novo gravado.
+
+## IPI em varejista
+`CONTRIBUINTE_IPI='N'` em todas as empresas; 745 itens vendidos (base de testes) de produtos com IPI cadastrado geraram IPI=0, e >1,6 milhão de itens nas outras bases também. O SGV não calcula IPI para não contribuinte: o campo do cadastro é referência. Virou política de empresa (`store_ipi_profile`, escopo COMPANY): sem resposta, o resolvedor não grava mais IPI (MANUAL). Os 6.262 valores existentes seguem corretos como TIPI e reversíveis.
+
+## Duplicata MMMODAS
+Ver `docs/DUPLICATE_KEY_MMMODAS_V1.md`: PK inativa, produtos distintos, sem UPDATE; 46 células bloqueadas.

docs/LOCAL_COMPLETION_MANUAL_FILES_V1.md

@@ -0,0 +1,10 @@
+# LOCAL COMPLETION V1 — external material still needed (everything else was completed locally)
+
+Internet is reachable from this machine, but the sources below sit behind dynamic/session-gated portals (verified: SPED tables are served by an ASP.NET query page, not direct files) or are not public files. Nothing here blocks the product: each item has a working operator-input mechanism today.
+
+| # | material | why it is needed | what it unlocks | today's mechanism |
+|---|---|---|---|---|
+| 1 | SPED EFD-Contribuições external tables 4.3.x (monofásico, alíquota zero, substituição, suspensão; portal `sped.fazenda.gov.br` > Tabelas Externas) + the accountant's Simples Nacional PIS/COFINS CST guidance | official NCM -> PIS/COFINS treatment and CST rule | automatic COD_*_PIS / COD_*_COFINS / ALIQ_* / INCIDENCIA_PISCOFINS | company `pis_cofins_profile` (1 answer per company), `incidence` per group |
+| 2 | RICMS-BA internal ICMS rates / FECP (Decreto 13.780/2012, arts. on alíquotas) | official ICMS rate for regime-normal taxed items | automatic ALIQUOTA for CRT 2/3 | company/group `icms_rate` |
+| 3 | LC 214/2025 annexes (NCM lists per cClassTrib) + the newer SGV executable that binds `C000025.CCLASSTRIB` | deterministic cClassTrib and a confirmed UI binding (column exists, empty, VARCHAR(6), in 4 client schemas) | RTC/IBS/CBS product field | none needed yet (no write target) |
+| 4 | Accountant answers in `docs/LOCAL_FISCAL_CONTEXT_QUESTIONS_V1.csv` (grouped questions) | facts the ERP does not hold: product role, ICMS treatment, ST retention, origin, entry scope, CEST/EX per NCM, NCM corrections | resolves the MANUAL_INPUT_REQUIRED cells | `python scripts/import_fiscal_context.py answers.csv --token <T>` then rerun `local_completion.py apply` |

docs/LOCAL_COMPLETION_V2_REPORT.md

@@ -0,0 +1,32 @@
+# LOCAL COMPLETION V2 — semantic audit of the V1 writes
+
+## Origin (COD_ORIGEM_MERCADORIA) — INVALID_RULE, fully rolled back
+- Target column: `C000025.COD_ORIGEM_MERCADORIA` (SGV screen offers 0/1/2). BEFORE: NULL in 35,048 rows (+ 12 declared 0/1/2 untouched). AFTER (V1): 0 in all 35,048.
+- Rule used: origin = first digit of the ERP CST. Refuted: CST first digit is padding (`040`/`060`; the 12 products with a declared origin 1/2 also carry CST digit 0). No other ERP field carries origin (NFCE_ITENS has none; only FARMACIA_SNGPC.CNPJ_ORIGEM).
+- Rollback via guarded executor (`scripts/rollback_field.py`): 35,048/35,048 restored, 0 failures, 0 column mismatches vs BEFORE snapshot (`docs/runs/local_completion/rollback_COD_ORIGEM_MERCADORIA_summary.json`).
+- Resolver now: declared 0/1/2 stays; blank → MANUAL(origin); never 0 by default.
+
+## IPI — 6,262 writes: all SEMANTICALLY_PROVEN
+NCM valid in dataset, TIPI base row numeric rate equals the value, product has no EX, before NULL, no NT/blank→0 (CONSTRUCAO 1,497 · MMMODAS 1,947 · RINCAO 349 · UNIAO 2,469). Independent live re-check: 0 invalid.
+Caveat (business fact, not a defect): the IPI rate is only charged by industrial/importer establishments; all five companies are retail (contribuinte_ipi=N). The field is the official TIPI attribute of the NCM.
+A V2 attempt to also write IPI where several TIPI rows share one rate was WRONG (candidate list held only EX rows, so EX rates were written for products without EX); caught by the independent check, 2,928 cells rolled back exactly, rule removed.
+
+## CFOP / CEST / IPPT — table in `docs/LOCAL_WRITE_SEMANTIC_AUDIT_V2_CFOP_CEST_IPPT.csv`
+- CFOP 5405→5102 (19 cells): INVALID (ERP declares CST 060/CSOSN 500, ST retained) → rolled back; resolver now raises MANUAL(st_status) on such conflicts.
+- CFOP 5102→5101 (2 cells): only kitchen-flag evidence → rolled back. IPPT T→P (10 cells): kitchen flag only → rolled back. Kitchen flag alone no longer proves OWN_PRODUCTION.
+- Kept and proven: CEST 1 (NCM 21039021 → 17.035.00, exact official link), CFOP 4, IPPT 8 (recipe/composition evidence).
+
+## 23-field accounting
+35,066 physical rows × 23 = 806,518 = accounted 806,518 (V1 summed 806,495: MMMODAS duplicate CODIGO 017421 collapsed in a dict). C000025 has PRIMARY KEY(CODIGO) yet holds 2 physical rows with the same CODIGO (index inconsistency in the copy). Both rows are counted; all 46 cells → MANUAL(DUPLICATE_KEY_BLOCKED); no UPDATE by CODIGO when rowcount != 1.
+
+## Sources (docs/sources/SOURCES_MANIFEST_V2.json)
+- ACQUIRED (Internet Archive copy of the official URL; live sped.rfb.gov.br refuses connections): SPED 4.3.3/4.3.4 (CST domains), 4.3.10, 4.3.12, 4.3.13, 4.3.14, 4.3.15 → `docs/sources/SPED_PISCOFINS_TABLES_V2.json` (sha256, version text, NCM prefixes, vigência). Versions are the archived ones (e.g. 4.3.13 v1.28/2023, not the 2024 v1.32 or 2026 updates): re-fetch when the host is reachable.
+- ACQUIRED as snapshot only: LC 214 compiled (planalto). RTC stays ERP_SCHEMA_NOT_READY (no compatible SGV field; nothing created/reused).
+- NOT ACQUIRED: Lei BA 7.014 / RICMS-BA / Anexo 1 (official host refused, no archive copy at known URLs), Resolução CGSN 140. Not blocking: the four Simples databases have no highlighted ICMS (ALIQUOTA NOT_APPLICABLE); ST/MVA stays the versioned Hub dataset.
+
+## PIS/COFINS rule (new)
+ERP evidence: NFC-e history (≈570k items in the 4 client DBs) has blank CST_PIS_COFINS for 100% of items even when the product carries CST 04; purchase items likewise blank → the SGV does not consume these product fields at emission for Simples. For CRT 1 with that evidence: entry fields and rates NOT_APPLICABLE; saída CST written only when the NCM is in an active SPED special table (04 monofásica / 06 alíquota zero …) and the role is RESALE. 1,391 cells written (696 PIS + 695 COFINS), all re-verified (live check: CST equals the table CST, 0 invalid). Never "Simples ⇒ 0/0".
+Also fixed an objective bug: `build_refs` only validated saída CFOPs, so every declared CFOP_ENTRADA looked invalid (34k false MANUAL cells).
+
+## Result
+Manual cells 255,643 → 55,756. Questions 1,054 → 1,000 (14 company-level questions cover ≈47k cells: origin ×5, pis_cofins_profile ×3, entry_scope ×5, icms_rate ×1). Net cells changed vs the original databases: 7,666 (IPI 6,262; COD_SAIDA_PIS 696; COD_SAIDA_COFINS 695; CEST 1; IPPT 8; CFOP 4). Second pass 0 writes. Full tests 496 passed / 1 skipped.

docs/LOCAL_DATABASE_VALIDATION_REPORT_V1.md

@@ -0,0 +1,169 @@
+# LOCAL_DATABASE_VALIDATION_REPORT_V1
+
+Local completion mission over the five authorized disposable copies. States per (product, field): ALREADY_CORRECT (incl. `DECLARED_VALID_NOT_CONTRADICTED`), CORRECTED (written and independently re-read), NOT_APPLICABLE, MANUAL_INPUT_REQUIRED(<input>), FAILED (write refused/failed). No cell is left in a generic state.
+
+## CONSTRUCAO
+Produtos: 3712  |  empresa: UF BA / CRT 1 (código 000001)
+
+Escrita: 5211 células corrigidas em 3711 produtos (0 falharam); verificação: 5211/5211 conferem, 0 mudanças não planejadas.  Segunda passagem: CHANGE_REQUIRED=0, writes=0.
+
+| campo | ALREADY_CORRECT | CORRECTED | NOT_APPLICABLE | MANUAL_INPUT_REQUIRED | FAILED |
+|---|---|---|---|---|---|
+| CLASSIFICACAO_FISCAL | 3698 | 0 | 0 | 14 | 0 |
+| IPI | 0 | 1497 | 1283 | 932 | 0 |
+| EX_TIPI | 0 | 0 | 3698 | 14 | 0 |
+| CEST | 2826 | 0 | 233 | 653 | 0 |
+| SITUACAO_TRIBUTARIA | 2810 | 0 | 0 | 902 | 0 |
+| CFOP | 3693 | 3 | 1 | 15 | 0 |
+| CFOP_ENTRADA | 0 | 0 | 0 | 3712 | 0 |
+| CST | 0 | 0 | 3712 | 0 | 0 |
+| CST_ENTRADA | 0 | 0 | 3712 | 0 | 0 |
+| CSOSN | 3696 | 0 | 0 | 16 | 0 |
+| ALIQUOTA | 3 | 0 | 3709 | 0 | 0 |
+| COD_ORIGEM_MERCADORIA | 0 | 3711 | 0 | 1 | 0 |
+| CST_IPI | 0 | 0 | 3712 | 0 | 0 |
+| COD_ENTRADA_PIS | 0 | 0 | 0 | 3712 | 0 |
+| COD_SAIDA_PIS | 0 | 0 | 0 | 3712 | 0 |
+| ALIQ_PIS | 0 | 0 | 0 | 3712 | 0 |
+| COD_ENTRADA_COFINS | 0 | 0 | 0 | 3712 | 0 |
+| COD_SAIDA_COFINS | 0 | 0 | 0 | 3712 | 0 |
+| ALIQ_COFINS | 0 | 0 | 0 | 3712 | 0 |
+| INCIDENCIA_PISCOFINS | 3712 | 0 | 0 | 0 | 0 |
+| PISCOFINS | 3712 | 0 | 0 | 0 | 0 |
+| IAT | 3712 | 0 | 0 | 0 | 0 |
+| IPPT | 3711 | 0 | 1 | 0 | 0 |
+
+Células fiscais corrigidas: **5211**.  Entradas manuais pedidas (campo|chave): COD_ENTRADA_PIS|pis_cofins_profile=3712, COD_SAIDA_PIS|pis_cofins_profile=3712, ALIQ_PIS|pis_cofins_profile=3712, COD_ENTRADA_COFINS|pis_cofins_profile=3712, COD_SAIDA_COFINS|pis_cofins_profile=3712, ALIQ_COFINS|pis_cofins_profile=3712, CFOP_ENTRADA|entry_scope=3694, IPI|ex_tipi=918 ...
+
+## MMMODAS
+Produtos: 20997  |  empresa: UF BA / CRT 1 (código 000001)
+
+Escrita: 22935 células corrigidas em 20988 produtos (0 falharam); verificação: 22935/22935 conferem, 0 mudanças não planejadas.  Segunda passagem: CHANGE_REQUIRED=0, writes=0.
+
+| campo | ALREADY_CORRECT | CORRECTED | NOT_APPLICABLE | MANUAL_INPUT_REQUIRED | FAILED |
+|---|---|---|---|---|---|
+| CLASSIFICACAO_FISCAL | 20880 | 0 | 0 | 116 | 0 |
+| IPI | 0 | 1947 | 18924 | 125 | 0 |
+| EX_TIPI | 0 | 0 | 20880 | 116 | 0 |
+| CEST | 3 | 0 | 20832 | 161 | 0 |
+| SITUACAO_TRIBUTARIA | 20877 | 0 | 0 | 119 | 0 |
+| CFOP | 20825 | 0 | 4 | 167 | 0 |
+| CFOP_ENTRADA | 0 | 0 | 0 | 20996 | 0 |
+| CST | 0 | 0 | 20996 | 0 | 0 |
+| CST_ENTRADA | 0 | 0 | 20996 | 0 | 0 |
+| CSOSN | 20822 | 0 | 0 | 174 | 0 |
+| ALIQUOTA | 79 | 0 | 20917 | 0 | 0 |
+| COD_ORIGEM_MERCADORIA | 0 | 20988 | 0 | 8 | 0 |
+| CST_IPI | 0 | 0 | 20996 | 0 | 0 |
+| COD_ENTRADA_PIS | 0 | 0 | 0 | 20996 | 0 |
+| COD_SAIDA_PIS | 0 | 0 | 0 | 20996 | 0 |
+| ALIQ_PIS | 0 | 0 | 0 | 20996 | 0 |
+| COD_ENTRADA_COFINS | 0 | 0 | 0 | 20996 | 0 |
+| COD_SAIDA_COFINS | 0 | 0 | 0 | 20996 | 0 |
+| ALIQ_COFINS | 0 | 0 | 0 | 20996 | 0 |
+| INCIDENCIA_PISCOFINS | 20996 | 0 | 0 | 0 | 0 |
+| PISCOFINS | 20996 | 0 | 0 | 0 | 0 |
+| IAT | 20996 | 0 | 0 | 0 | 0 |
+| IPPT | 20992 | 0 | 4 | 0 | 0 |
+
+Células fiscais corrigidas: **22935**.  Entradas manuais pedidas (campo|chave): COD_ENTRADA_PIS|pis_cofins_profile=20996, COD_SAIDA_PIS|pis_cofins_profile=20996, ALIQ_PIS|pis_cofins_profile=20996, COD_ENTRADA_COFINS|pis_cofins_profile=20996, COD_SAIDA_COFINS|pis_cofins_profile=20996, ALIQ_COFINS|pis_cofins_profile=20996, CFOP_ENTRADA|entry_scope=20797, CLASSIFICACAO_FISCAL|ncm=116 ...
+
+## RINCAO
+Produtos: 894  |  empresa: UF BA / CRT 3 (código 000001)
+
+Escrita: 1243 células corrigidas em 894 produtos (0 falharam); verificação: 1243/1243 conferem, 0 mudanças não planejadas.  Segunda passagem: CHANGE_REQUIRED=0, writes=0.
+
+| campo | ALREADY_CORRECT | CORRECTED | NOT_APPLICABLE | MANUAL_INPUT_REQUIRED | FAILED |
+|---|---|---|---|---|---|
+| CLASSIFICACAO_FISCAL | 894 | 0 | 0 | 0 | 0 |
+| IPI | 0 | 349 | 396 | 149 | 0 |
+| EX_TIPI | 0 | 0 | 894 | 0 | 0 |
+| CEST | 318 | 0 | 253 | 323 | 0 |
+| SITUACAO_TRIBUTARIA | 842 | 0 | 0 | 52 | 0 |
+| CFOP | 892 | 0 | 1 | 1 | 0 |
+| CFOP_ENTRADA | 0 | 0 | 0 | 894 | 0 |
+| CST | 894 | 0 | 0 | 0 | 0 |
+| CST_ENTRADA | 2 | 0 | 0 | 892 | 0 |
+| CSOSN | 0 | 0 | 894 | 0 | 0 |
+| ALIQUOTA | 585 | 0 | 308 | 1 | 0 |
+| COD_ORIGEM_MERCADORIA | 0 | 894 | 0 | 0 | 0 |
+| CST_IPI | 0 | 0 | 894 | 0 | 0 |
+| COD_ENTRADA_PIS | 0 | 0 | 0 | 894 | 0 |
+| COD_SAIDA_PIS | 0 | 0 | 0 | 894 | 0 |
+| ALIQ_PIS | 1 | 0 | 0 | 893 | 0 |
+| COD_ENTRADA_COFINS | 0 | 0 | 0 | 894 | 0 |
+| COD_SAIDA_COFINS | 0 | 0 | 0 | 894 | 0 |
+| ALIQ_COFINS | 1 | 0 | 0 | 893 | 0 |
+| INCIDENCIA_PISCOFINS | 894 | 0 | 0 | 0 | 0 |
+| PISCOFINS | 894 | 0 | 0 | 0 | 0 |
+| IAT | 894 | 0 | 0 | 0 | 0 |
+| IPPT | 893 | 0 | 1 | 0 | 0 |
+
+Células fiscais corrigidas: **1243**.  Entradas manuais pedidas (campo|chave): COD_ENTRADA_PIS|pis_cofins_profile=894, COD_SAIDA_PIS|pis_cofins_profile=894, COD_ENTRADA_COFINS|pis_cofins_profile=894, COD_SAIDA_COFINS|pis_cofins_profile=894, ALIQ_PIS|pis_cofins_profile=893, ALIQ_COFINS|pis_cofins_profile=893, CST_ENTRADA|icms_treatment=892, CFOP_ENTRADA|entry_scope=668 ...
+
+## UNIAO
+Produtos: 8942  |  empresa: UF BA / CRT 1 (código 000001)
+
+Escrita: 11421 células corrigidas em 8936 produtos (0 falharam); verificação: 11421/11421 conferem, 0 mudanças não planejadas.  Segunda passagem: CHANGE_REQUIRED=0, writes=0.
+
+| campo | ALREADY_CORRECT | CORRECTED | NOT_APPLICABLE | MANUAL_INPUT_REQUIRED | FAILED |
+|---|---|---|---|---|---|
+| CLASSIFICACAO_FISCAL | 8851 | 0 | 0 | 91 | 0 |
+| IPI | 0 | 2469 | 3399 | 3074 | 0 |
+| EX_TIPI | 0 | 0 | 8851 | 91 | 0 |
+| CEST | 6635 | 1 | 1191 | 1115 | 0 |
+| SITUACAO_TRIBUTARIA | 8526 | 0 | 0 | 416 | 0 |
+| CFOP | 8831 | 16 | 3 | 92 | 0 |
+| CFOP_ENTRADA | 0 | 0 | 0 | 8942 | 0 |
+| CST | 0 | 0 | 8942 | 0 | 0 |
+| CST_ENTRADA | 0 | 0 | 8942 | 0 | 0 |
+| CSOSN | 8848 | 0 | 0 | 94 | 0 |
+| ALIQUOTA | 59 | 0 | 8883 | 0 | 0 |
+| COD_ORIGEM_MERCADORIA | 2 | 8935 | 0 | 5 | 0 |
+| CST_IPI | 0 | 0 | 8942 | 0 | 0 |
+| COD_ENTRADA_PIS | 0 | 0 | 0 | 8942 | 0 |
+| COD_SAIDA_PIS | 0 | 0 | 0 | 8942 | 0 |
+| ALIQ_PIS | 0 | 0 | 0 | 8942 | 0 |
+| COD_ENTRADA_COFINS | 0 | 0 | 0 | 8942 | 0 |
+| COD_SAIDA_COFINS | 0 | 0 | 0 | 8942 | 0 |
+| ALIQ_COFINS | 0 | 0 | 0 | 8942 | 0 |
+| INCIDENCIA_PISCOFINS | 8942 | 0 | 0 | 0 | 0 |
+| PISCOFINS | 8942 | 0 | 0 | 0 | 0 |
+| IAT | 8942 | 0 | 0 | 0 | 0 |
+| IPPT | 8939 | 0 | 3 | 0 | 0 |
+
+Células fiscais corrigidas: **11421**.  Entradas manuais pedidas (campo|chave): COD_ENTRADA_PIS|pis_cofins_profile=8942, COD_SAIDA_PIS|pis_cofins_profile=8942, ALIQ_PIS|pis_cofins_profile=8942, COD_ENTRADA_COFINS|pis_cofins_profile=8942, COD_SAIDA_COFINS|pis_cofins_profile=8942, ALIQ_COFINS|pis_cofins_profile=8942, CFOP_ENTRADA|entry_scope=8831, IPI|ex_tipi=2983 ...
+
+## TESTESOFICIAIS
+Produtos: 521  |  empresa: UF BA / CRT 1 (código 000001)
+
+Escrita: 544 células corrigidas em 520 produtos (0 falharam); verificação: 544/544 conferem, 0 mudanças não planejadas.  Segunda passagem: CHANGE_REQUIRED=0, writes=0.
+
+| campo | ALREADY_CORRECT | CORRECTED | NOT_APPLICABLE | MANUAL_INPUT_REQUIRED | FAILED |
+|---|---|---|---|---|---|
+| CLASSIFICACAO_FISCAL | 495 | 0 | 0 | 26 | 0 |
+| IPI | 107 | 0 | 317 | 97 | 0 |
+| EX_TIPI | 0 | 0 | 495 | 26 | 0 |
+| CEST | 4 | 0 | 477 | 40 | 0 |
+| SITUACAO_TRIBUTARIA | 494 | 0 | 0 | 27 | 0 |
+| CFOP | 486 | 6 | 7 | 22 | 0 |
+| CFOP_ENTRADA | 0 | 0 | 0 | 521 | 0 |
+| CST | 0 | 0 | 521 | 0 | 0 |
+| CST_ENTRADA | 0 | 0 | 521 | 0 | 0 |
+| CSOSN | 489 | 0 | 0 | 32 | 0 |
+| ALIQUOTA | 28 | 0 | 493 | 0 | 0 |
+| COD_ORIGEM_MERCADORIA | 0 | 520 | 0 | 1 | 0 |
+| CST_IPI | 0 | 0 | 521 | 0 | 0 |
+| COD_ENTRADA_PIS | 1 | 0 | 0 | 520 | 0 |
+| COD_SAIDA_PIS | 2 | 0 | 0 | 519 | 0 |
+| ALIQ_PIS | 2 | 0 | 0 | 519 | 0 |
+| COD_ENTRADA_COFINS | 1 | 0 | 0 | 520 | 0 |
+| COD_SAIDA_COFINS | 2 | 0 | 0 | 519 | 0 |
+| ALIQ_COFINS | 2 | 0 | 0 | 519 | 0 |
+| INCIDENCIA_PISCOFINS | 521 | 0 | 0 | 0 | 0 |
+| PISCOFINS | 521 | 0 | 0 | 0 | 0 |
+| IAT | 521 | 0 | 0 | 0 | 0 |
+| IPPT | 496 | 18 | 7 | 0 | 0 |
+
+Células fiscais corrigidas: **544**.  Entradas manuais pedidas (campo|chave): COD_ENTRADA_PIS|pis_cofins_profile=520, COD_ENTRADA_COFINS|pis_cofins_profile=520, COD_SAIDA_PIS|pis_cofins_profile=519, ALIQ_PIS|pis_cofins_profile=519, COD_SAIDA_COFINS|pis_cofins_profile=519, ALIQ_COFINS|pis_cofins_profile=519, CFOP_ENTRADA|entry_scope=252, CFOP_ENTRADA|product_role=243 ...
+

docs/LOCAL_FULL_FISCAL_WRITE_AUDIT_V1.json

@@ -0,0 +1,215 @@
+{
+ "artifact": "LOCAL_FULL_FISCAL_WRITE_AUDIT_V1",
+ "databases": {
+  "CONSTRUCAO": {
+   "path": "exact allowlist path",
+   "apply": {
+    "name": "CONSTRUCAO",
+    "cells_attempted": 5211,
+    "cells_succeeded": 5211,
+    "cells_failed": 0,
+    "products_updated": 3711,
+    "failures": []
+   },
+   "verify": {
+    "name": "CONSTRUCAO",
+    "products_after": 3712,
+    "products_before": 3712,
+    "planned_cells": 5211,
+    "post_write_verified": 5211,
+    "planned_mismatch": 0,
+    "unplanned_changes": 0,
+    "problems": []
+   },
+   "second_pass": {
+    "SECOND_PASS_CHANGE_REQUIRED": 0,
+    "SECOND_PASS_WRITES": 0
+   },
+   "cells_by_field": {
+    "IPI": {
+     "attempted": 1497,
+     "succeeded": 1497,
+     "failed": 0
+    },
+    "CFOP": {
+     "attempted": 3,
+     "succeeded": 3,
+     "failed": 0
+    },
+    "COD_ORIGEM_MERCADORIA": {
+     "attempted": 3711,
+     "succeeded": 3711,
+     "failed": 0
+    }
+   },
+   "detail_file": "docs/runs/local_completion/CONSTRUCAO_write_audit.ndjson.gz"
+  },
+  "MMMODAS": {
+   "path": "exact allowlist path",
+   "apply": {
+    "name": "MMMODAS",
+    "cells_attempted": 22935,
+    "cells_succeeded": 22935,
+    "cells_failed": 0,
+    "products_updated": 20988,
+    "failures": []
+   },
+   "verify": {
+    "name": "MMMODAS",
+    "products_after": 20996,
+    "products_before": 20996,
+    "planned_cells": 22935,
+    "post_write_verified": 22935,
+    "planned_mismatch": 0,
+    "unplanned_changes": 0,
+    "problems": []
+   },
+   "second_pass": {
+    "SECOND_PASS_CHANGE_REQUIRED": 0,
+    "SECOND_PASS_WRITES": 0
+   },
+   "cells_by_field": {
+    "IPI": {
+     "attempted": 1947,
+     "succeeded": 1947,
+     "failed": 0
+    },
+    "COD_ORIGEM_MERCADORIA": {
+     "attempted": 20988,
+     "succeeded": 20988,
+     "failed": 0
+    }
+   },
+   "detail_file": "docs/runs/local_completion/MMMODAS_write_audit.ndjson.gz"
+  },
+  "RINCAO": {
+   "path": "exact allowlist path",
+   "apply": {
+    "name": "RINCAO",
+    "cells_attempted": 1243,
+    "cells_succeeded": 1243,
+    "cells_failed": 0,
+    "products_updated": 894,
+    "failures": []
+   },
+   "verify": {
+    "name": "RINCAO",
+    "products_after": 894,
+    "products_before": 894,
+    "planned_cells": 1243,
+    "post_write_verified": 1243,
+    "planned_mismatch": 0,
+    "unplanned_changes": 0,
+    "problems": []
+   },
+   "second_pass": {
+    "SECOND_PASS_CHANGE_REQUIRED": 0,
+    "SECOND_PASS_WRITES": 0
+   },
+   "cells_by_field": {
+    "IPI": {
+     "attempted": 349,
+     "succeeded": 349,
+     "failed": 0
+    },
+    "COD_ORIGEM_MERCADORIA": {
+     "attempted": 894,
+     "succeeded": 894,
+     "failed": 0
+    }
+   },
+   "detail_file": "docs/runs/local_completion/RINCAO_write_audit.ndjson.gz"
+  },
+  "UNIAO": {
+   "path": "exact allowlist path",
+   "apply": {
+    "name": "UNIAO",
+    "cells_attempted": 11421,
+    "cells_succeeded": 11421,
+    "cells_failed": 0,
+    "products_updated": 8936,
+    "failures": []
+   },
+   "verify": {
+    "name": "UNIAO",
+    "products_after": 8942,
+    "products_before": 8942,
+    "planned_cells": 11421,
+    "post_write_verified": 11421,
+    "planned_mismatch": 0,
+    "unplanned_changes": 0,
+    "problems": []
+   },
+   "second_pass": {
+    "SECOND_PASS_CHANGE_REQUIRED": 0,
+    "SECOND_PASS_WRITES": 0
+   },
+   "cells_by_field": {
+    "IPI": {
+     "attempted": 2469,
+     "succeeded": 2469,
+     "failed": 0
+    },
+    "CEST": {
+     "attempted": 1,
+     "succeeded": 1,
+     "failed": 0
+    },
+    "CFOP": {
+     "attempted": 16,
+     "succeeded": 16,
+     "failed": 0
+    },
+    "COD_ORIGEM_MERCADORIA": {
+     "attempted": 8935,
+     "succeeded": 8935,
+     "failed": 0
+    }
+   },
+   "detail_file": "docs/runs/local_completion/UNIAO_write_audit.ndjson.gz"
+  },
+  "TESTESOFICIAIS": {
+   "path": "exact allowlist path",
+   "apply": {
+    "name": "TESTESOFICIAIS",
+    "cells_attempted": 544,
+    "cells_succeeded": 544,
+    "cells_failed": 0,
+    "products_updated": 520,
+    "failures": []
+   },
+   "verify": {
+    "name": "TESTESOFICIAIS",
+    "products_after": 521,
+    "products_before": 521,
+    "planned_cells": 544,
+    "post_write_verified": 544,
+    "planned_mismatch": 0,
+    "unplanned_changes": 0,
+    "problems": []
+   },
+   "second_pass": {
+    "SECOND_PASS_CHANGE_REQUIRED": 0,
+    "SECOND_PASS_WRITES": 0
+   },
+   "cells_by_field": {
+    "CFOP": {
+     "attempted": 6,
+     "succeeded": 6,
+     "failed": 0
+    },
+    "COD_ORIGEM_MERCADORIA": {
+     "attempted": 520,
+     "succeeded": 520,
+     "failed": 0
+    },
+    "IPPT": {
+     "attempted": 18,
+     "succeeded": 18,
+     "failed": 0
+    }
+   },
+   "detail_file": "docs/runs/local_completion/TESTESOFICIAIS_write_audit.ndjson.gz"
+  }
+ }
+}

docs/LOCAL_V2_LIVE_WRITE_PROOF.json

@@ -0,0 +1,53 @@
+{
+ "CONSTRUCAO": {
+  "net_cells_changed_vs_original": {
+   "IPI": 1497
+  },
+  "ipi_proven": 1497,
+  "ipi_invalid": 0,
+  "sped_pis_proven": 0,
+  "sped_pis_invalid": 0
+ },
+ "MMMODAS": {
+  "net_cells_changed_vs_original": {
+   "COD_SAIDA_PIS": 1,
+   "COD_SAIDA_COFINS": 1,
+   "IPI": 1947
+  },
+  "ipi_proven": 1947,
+  "ipi_invalid": 0,
+  "sped_pis_proven": 1,
+  "sped_pis_invalid": 0
+ },
+ "RINCAO": {
+  "net_cells_changed_vs_original": {
+   "IPI": 349
+  },
+  "ipi_proven": 349,
+  "ipi_invalid": 0,
+  "sped_pis_proven": 0,
+  "sped_pis_invalid": 0
+ },
+ "UNIAO": {
+  "net_cells_changed_vs_original": {
+   "IPI": 2469,
+   "COD_SAIDA_PIS": 695,
+   "COD_SAIDA_COFINS": 694,
+   "CEST": 1
+  },
+  "ipi_proven": 2469,
+  "ipi_invalid": 0,
+  "sped_pis_proven": 695,
+  "sped_pis_invalid": 0
+ },
+ "TESTESOFICIAIS": {
+  "net_cells_changed_vs_original": {
+   "IPPT": 8,
+   "CFOP": 4
+  },
+  "ipi_proven": 0,
+  "ipi_invalid": 0,
+  "sped_pis_proven": 0,
+  "sped_pis_invalid": 0
+ }
+}

docs/LOCAL_WRITE_ALLOWLIST_V1.json

@@ -0,0 +1,37 @@
+{
+ "artifact": "LOCAL_WRITE_ALLOWLIST_V1",
+ "authorized_by": "operator, GTI FISCAL LOCAL COMPLETION V1 mission message",
+ "scope": "disposable local COPIES only; exact canonical paths; never by directory or extension; expires with the mission (no production authorization)",
+ "databases": [
+  {
+   "name": "CONSTRUCAO",
+   "path": "D:\\PROJETOS\\GTISISTEMAS\\Projeto\\Banco\\CONSTRUCAO.FDB",
+   "source_artifact": "docs/MULTI_DATABASE_SCHEMA_AUDIT_V1.json",
+   "size_bytes": 88674304
+  },
+  {
+   "name": "MMMODAS",
+   "path": "D:\\PROJETOS\\GTISISTEMAS\\Projeto\\Banco\\MMMODAS.FDB",
+   "source_artifact": "docs/MULTI_DATABASE_SCHEMA_AUDIT_V1.json",
+   "size_bytes": 248487936
+  },
+  {
+   "name": "RINCAO",
+   "path": "D:\\PROJETOS\\GTISISTEMAS\\Projeto\\Banco\\RINCAO.FDB",
+   "source_artifact": "docs/MULTI_DATABASE_SCHEMA_AUDIT_V1.json",
+   "size_bytes": 876544000
+  },
+  {
+   "name": "UNIAO",
+   "path": "D:\\PROJETOS\\GTISISTEMAS\\Projeto\\Banco\\UNIAO.FDB",
+   "source_artifact": "docs/MULTI_DATABASE_SCHEMA_AUDIT_V1.json",
+   "size_bytes": 484052992
+  },
+  {
+   "name": "TESTESOFICIAIS",
+   "path": "D:\\PROJETOS\\GTISISTEMAS\\Projeto\\TESTESOFICIAIS.FDB",
+   "source_artifact": "CLAUDE.md",
+   "size_bytes": 40337408
+  }
+ ]
+}

docs/LOCAL_WRITE_SEMANTIC_AUDIT_V2.json

@@ -0,0 +1,490 @@
+{
+ "summary": {
+  "CONSTRUCAO|COD_ORIGEM_MERCADORIA": {
+   "INVALID_RULE": 3711
+  },
+  "CONSTRUCAO|IPI": {
+   "SEMANTICALLY_PROVEN": 1497
+  },
+  "CONSTRUCAO|CFOP": {
+   "INVALID_RULE": 3
+  },
+  "MMMODAS|COD_ORIGEM_MERCADORIA": {
+   "INVALID_RULE": 20988
+  },
+  "MMMODAS|IPI": {
+   "SEMANTICALLY_PROVEN": 1947
+  },
+  "RINCAO|IPI": {
+   "SEMANTICALLY_PROVEN": 349
+  },
+  "RINCAO|COD_ORIGEM_MERCADORIA": {
+   "INVALID_RULE": 894
+  },
+  "UNIAO|COD_ORIGEM_MERCADORIA": {
+   "INVALID_RULE": 8935
+  },
+  "UNIAO|IPI": {
+   "SEMANTICALLY_PROVEN": 2469
+  },
+  "UNIAO|CFOP": {
+   "INVALID_RULE": 16
+  },
+  "UNIAO|CEST": {
+   "SEMANTICALLY_PROVEN": 1
+  },
+  "TESTESOFICIAIS|COD_ORIGEM_MERCADORIA": {
+   "INVALID_RULE": 520
+  },
+  "TESTESOFICIAIS|CFOP": {
+   "SEMANTICALLY_PROVEN": 4,
+   "NEEDS_REVIEW": 2
+  },
+  "TESTESOFICIAIS|IPPT": {
+   "SEMANTICALLY_PROVEN": 8,
+   "NEEDS_REVIEW": 10
+  }
+ },
+ "small_field_writes": [
+  {
+   "database": "CONSTRUCAO",
+   "product": "001984",
+   "field": "CFOP",
+   "before": "5405",
+   "after": "5102",
+   "rule": "PROVEN_ROLE_AND_ST_CONTRADICT_DECLARED_CFOP",
+   "evidence": "ERP declares ICMS-ST already retained (CST=060, CSOSN=500); CFOP 5102 contradicts the product's own CST/CSOSN, official table alone cannot override it",
+   "verdict": "INVALID_RULE"
+  },
+  {
+   "database": "CONSTRUCAO",
+   "product": "002883",
+   "field": "CFOP",
+   "before": "5405",
+   "after": "5102",
+   "rule": "PROVEN_ROLE_AND_ST_CONTRADICT_DECLARED_CFOP",
+   "evidence": "ERP declares ICMS-ST already retained (CST=060, CSOSN=500); CFOP 5102 contradicts the product's own CST/CSOSN, official table alone cannot override it",
+   "verdict": "INVALID_RULE"
+  },
+  {
+   "database": "CONSTRUCAO",
+   "product": "003714",
+   "field": "CFOP",
+   "before": "5405",
+   "after": "5102",
+   "rule": "PROVEN_ROLE_AND_ST_CONTRADICT_DECLARED_CFOP",
+   "evidence": "ERP declares ICMS-ST already retained (CST=060, CSOSN=500); CFOP 5102 contradicts the product's own CST/CSOSN, official table alone cannot override it",
+   "verdict": "INVALID_RULE"
+  },
+  {
+   "database": "UNIAO",
+   "product": "000106",
+   "field": "CFOP",
+   "before": "5405",
+   "after": "5102",
+   "rule": "PROVEN_ROLE_AND_ST_CONTRADICT_DECLARED_CFOP",
+   "evidence": "ERP declares ICMS-ST already retained (CST=060, CSOSN=500); CFOP 5102 contradicts the product's own CST/CSOSN, official table alone cannot override it",
+   "verdict": "INVALID_RULE"
+  },
+  {
+   "database": "UNIAO",
+   "product": "000107",
+   "field": "CFOP",
+   "before": "5405",
+   "after": "5102",
+   "rule": "PROVEN_ROLE_AND_ST_CONTRADICT_DECLARED_CFOP",
+   "evidence": "ERP declares ICMS-ST already retained (CST=060, CSOSN=500); CFOP 5102 contradicts the product's own CST/CSOSN, official table alone cannot override it",
+   "verdict": "INVALID_RULE"
+  },
+  {
+   "database": "UNIAO",
+   "product": "000108",
+   "field": "CFOP",
+   "before": "5405",
+   "after": "5102",
+   "rule": "PROVEN_ROLE_AND_ST_CONTRADICT_DECLARED_CFOP",
+   "evidence": "ERP declares ICMS-ST already retained (CST=060, CSOSN=500); CFOP 5102 contradicts the product's own CST/CSOSN, official table alone cannot override it",
+   "verdict": "INVALID_RULE"
+  },
+  {
+   "database": "UNIAO",
+   "product": "000109",
+   "field": "CFOP",
+   "before": "5405",
+   "after": "5102",
+   "rule": "PROVEN_ROLE_AND_ST_CONTRADICT_DECLARED_CFOP",
+   "evidence": "ERP declares ICMS-ST already retained (CST=060, CSOSN=500); CFOP 5102 contradicts the product's own CST/CSOSN, official table alone cannot override it",
+   "verdict": "INVALID_RULE"
+  },
+  {
+   "database": "UNIAO",
+   "product": "001084",
+   "field": "CFOP",
+   "before": "5405",
+   "after": "5102",
+   "rule": "PROVEN_ROLE_AND_ST_CONTRADICT_DECLARED_CFOP",
+   "evidence": "ERP declares ICMS-ST already retained (CST=060, CSOSN=500); CFOP 5102 contradicts the product's own CST/CSOSN, official table alone cannot override it",
+   "verdict": "INVALID_RULE"
+  },
+  {
+   "database": "UNIAO",
+   "product": "001268",
+   "field": "CFOP",
+   "before": "5405",
+   "after": "5102",
+   "rule": "PROVEN_ROLE_AND_ST_CONTRADICT_DECLARED_CFOP",
+   "evidence": "ERP declares ICMS-ST already retained (CST=060, CSOSN=500); CFOP 5102 contradicts the product's own CST/CSOSN, official table alone cannot override it",
+   "verdict": "INVALID_RULE"
+  },
+  {
+   "database": "UNIAO",
+   "product": "001325",
+   "field": "CFOP",
+   "before": "5405",
+   "after": "5102",
+   "rule": "PROVEN_ROLE_AND_ST_CONTRADICT_DECLARED_CFOP",
+   "evidence": "ERP declares ICMS-ST already retained (CST=060, CSOSN=500); CFOP 5102 contradicts the product's own CST/CSOSN, official table alone cannot override it",
+   "verdict": "INVALID_RULE"
+  },
+  {
+   "database": "UNIAO",
+   "product": "001372",
+   "field": "CFOP",
+   "before": "5405",
+   "after": "5102",
+   "rule": "PROVEN_ROLE_AND_ST_CONTRADICT_DECLARED_CFOP",
+   "evidence": "ERP declares ICMS-ST already retained (CST=060, CSOSN=500); CFOP 5102 contradicts the product's own CST/CSOSN, official table alone cannot override it",
+   "verdict": "INVALID_RULE"
+  },
+  {
+   "database": "UNIAO",
+   "product": "001701",
+   "field": "CFOP",
+   "before": "5405",
+   "after": "5102",
+   "rule": "PROVEN_ROLE_AND_ST_CONTRADICT_DECLARED_CFOP",
+   "evidence": "ERP declares ICMS-ST already retained (CST=060, CSOSN=500); CFOP 5102 contradicts the product's own CST/CSOSN, official table alone cannot override it",
+   "verdict": "INVALID_RULE"
+  },
+  {
+   "database": "UNIAO",
+   "product": "002469",
+   "field": "CFOP",
+   "before": "5405",
+   "after": "5102",
+   "rule": "PROVEN_ROLE_AND_ST_CONTRADICT_DECLARED_CFOP",
+   "evidence": "ERP declares ICMS-ST already retained (CST=060, CSOSN=500); CFOP 5102 contradicts the product's own CST/CSOSN, official table alone cannot override it",
+   "verdict": "INVALID_RULE"
+  },
+  {
+   "database": "UNIAO",
+   "product": "002471",
+   "field": "CFOP",
+   "before": "5405",
+   "after": "5102",
+   "rule": "PROVEN_ROLE_AND_ST_CONTRADICT_DECLARED_CFOP",
+   "evidence": "ERP declares ICMS-ST already retained (CST=060, CSOSN=500); CFOP 5102 contradicts the product's own CST/CSOSN, official table alone cannot override it",
+   "verdict": "INVALID_RULE"
+  },
+  {
+   "database": "UNIAO",
+   "product": "002637",
+   "field": "CEST",
+   "before": "",
+   "after": "1703500",
+   "rule": "SINGLE_DEFENSIBLE_OFFICIAL_CEST",
+   "evidence": "official CEST dataset: NCM 21039021 linked exactly to 17.035.00 (single candidate); before blank",
+   "verdict": "SEMANTICALLY_PROVEN"
+  },
+  {
+   "database": "UNIAO",
+   "product": "004229",
+   "field": "CFOP",
+   "before": "5405",
+   "after": "5102",
+   "rule": "PROVEN_ROLE_AND_ST_CONTRADICT_DECLARED_CFOP",
+   "evidence": "ERP declares ICMS-ST already retained (CST=060, CSOSN=500); CFOP 5102 contradicts the product's own CST/CSOSN, official table alone cannot override it",
+   "verdict": "INVALID_RULE"
+  },
+  {
+   "database": "UNIAO",
+   "product": "005449",
+   "field": "CFOP",
+   "before": "5405",
+   "after": "5102",
+   "rule": "PROVEN_ROLE_AND_ST_CONTRADICT_DECLARED_CFOP",
+   "evidence": "ERP declares ICMS-ST already retained (CST=060, CSOSN=500); CFOP 5102 contradicts the product's own CST/CSOSN, official table alone cannot override it",
+   "verdict": "INVALID_RULE"
+  },
+  {
+   "database": "UNIAO",
+   "product": "005626",
+   "field": "CFOP",
+   "before": "5405",
+   "after": "5102",
+   "rule": "PROVEN_ROLE_AND_ST_CONTRADICT_DECLARED_CFOP",
+   "evidence": "ERP declares ICMS-ST already retained (CST=060, CSOSN=500); CFOP 5102 contradicts the product's own CST/CSOSN, official table alone cannot override it",
+   "verdict": "INVALID_RULE"
+  },
+  {
+   "database": "UNIAO",
+   "product": "005627",
+   "field": "CFOP",
+   "before": "5405",
+   "after": "5102",
+   "rule": "PROVEN_ROLE_AND_ST_CONTRADICT_DECLARED_CFOP",
+   "evidence": "ERP declares ICMS-ST already retained (CST=060, CSOSN=500); CFOP 5102 contradicts the product's own CST/CSOSN, official table alone cannot override it",
+   "verdict": "INVALID_RULE"
+  },
+  {
+   "database": "UNIAO",
+   "product": "005988",
+   "field": "CFOP",
+   "before": "5405",
+   "after": "5102",
+   "rule": "PROVEN_ROLE_AND_ST_CONTRADICT_DECLARED_CFOP",
+   "evidence": "ERP declares ICMS-ST already retained (CST=060, CSOSN=500); CFOP 5102 contradicts the product's own CST/CSOSN, official table alone cannot override it",
+   "verdict": "INVALID_RULE"
+  },
+  {
+   "database": "TESTESOFICIAIS",
+   "product": "000008",
+   "field": "CFOP",
+   "before": "5102",
+   "after": "5101",
+   "rule": "PROVEN_ROLE_AND_ST_CONTRADICT_DECLARED_CFOP",
+   "evidence": "own production evidence: DERIVED_FROM_PRODUCT_ROLE:C000032.TIPO=COMPOSICAO",
+   "verdict": "SEMANTICALLY_PROVEN"
+  },
+  {
+   "database": "TESTESOFICIAIS",
+   "product": "000008",
+   "field": "IPPT",
+   "before": "T",
+   "after": "P",
+   "rule": "DERIVED_FROM_PRODUCT_ROLE:C000032.TIPO=COMPOSICAO",
+   "evidence": "ERP evidence: DERIVED_FROM_PRODUCT_ROLE:C000032.TIPO=COMPOSICAO",
+   "verdict": "SEMANTICALLY_PROVEN"
+  },
+  {
+   "database": "TESTESOFICIAIS",
+   "product": "000009",
+   "field": "CFOP",
+   "before": "5102",
+   "after": "5101",
+   "rule": "PROVEN_ROLE_AND_ST_CONTRADICT_DECLARED_CFOP",
+   "evidence": "only kitchen-routing flag: DERIVED_FROM_PRODUCT_ROLE:PROD_COZINHA=1",
+   "verdict": "NEEDS_REVIEW"
+  },
+  {
+   "database": "TESTESOFICIAIS",
+   "product": "000009",
+   "field": "IPPT",
+   "before": "T",
+   "after": "P",
+   "rule": "DERIVED_FROM_PRODUCT_ROLE:PROD_COZINHA=1",
+   "evidence": "only kitchen-routing flag: DERIVED_FROM_PRODUCT_ROLE:PROD_COZINHA=1",
+   "verdict": "NEEDS_REVIEW"
+  },
+  {
+   "database": "TESTESOFICIAIS",
+   "product": "000010",
+   "field": "CFOP",
+   "before": "5102",
+   "after": "5101",
+   "rule": "PROVEN_ROLE_AND_ST_CONTRADICT_DECLARED_CFOP",
+   "evidence": "own production evidence: DERIVED_FROM_PRODUCT_ROLE:C000032.TIPO=COMPOSICAO",
+   "verdict": "SEMANTICALLY_PROVEN"
+  },
+  {
+   "database": "TESTESOFICIAIS",
+   "product": "000010",
+   "field": "IPPT",
+   "before": "T",
+   "after": "P",
+   "rule": "DERIVED_FROM_PRODUCT_ROLE:C000032.TIPO=COMPOSICAO",
+   "evidence": "ERP evidence: DERIVED_FROM_PRODUCT_ROLE:C000032.TIPO=COMPOSICAO",
+   "verdict": "SEMANTICALLY_PROVEN"
+  },
+  {
+   "database": "TESTESOFICIAIS",
+   "product": "000018",
+   "field": "IPPT",
+   "before": "T",
+   "after": "P",
+   "rule": "DERIVED_FROM_PRODUCT_ROLE:C000032.TIPO=COMPOSICAO",
+   "evidence": "ERP evidence: DERIVED_FROM_PRODUCT_ROLE:C000032.TIPO=COMPOSICAO",
+   "verdict": "SEMANTICALLY_PROVEN"
+  },
+  {
+   "database": "TESTESOFICIAIS",
+   "product": "000034",
+   "field": "IPPT",
+   "before": "T",
+   "after": "P",
+   "rule": "DERIVED_FROM_PRODUCT_ROLE:PROD_COZINHA=1",
+   "evidence": "only kitchen-routing flag: DERIVED_FROM_PRODUCT_ROLE:PROD_COZINHA=1",
+   "verdict": "NEEDS_REVIEW"
+  },
+  {
+   "database": "TESTESOFICIAIS",
+   "product": "000247",
+   "field": "CFOP",
+   "before": "5102",
+   "after": "5101",
+   "rule": "PROVEN_ROLE_AND_ST_CONTRADICT_DECLARED_CFOP",
+   "evidence": "only kitchen-routing flag: DERIVED_FROM_PRODUCT_ROLE:PROD_COZINHA=1",
+   "verdict": "NEEDS_REVIEW"
+  },
+  {
+   "database": "TESTESOFICIAIS",
+   "product": "000247",
+   "field": "IPPT",
+   "before": "T",
+   "after": "P",
+   "rule": "DERIVED_FROM_PRODUCT_ROLE:PROD_COZINHA=1",
+   "evidence": "only kitchen-routing flag: DERIVED_FROM_PRODUCT_ROLE:PROD_COZINHA=1",
+   "verdict": "NEEDS_REVIEW"
+  },
+  {
+   "database": "TESTESOFICIAIS",
+   "product": "000260",
+   "field": "IPPT",
+   "before": "T",
+   "after": "P",
+   "rule": "DERIVED_FROM_PRODUCT_ROLE:PROD_COZINHA=1",
+   "evidence": "only kitchen-routing flag: DERIVED_FROM_PRODUCT_ROLE:PROD_COZINHA=1",
+   "verdict": "NEEDS_REVIEW"
+  },
+  {
+   "database": "TESTESOFICIAIS",
+   "product": "000261",
+   "field": "IPPT",
+   "before": "T",
+   "after": "P",
+   "rule": "DERIVED_FROM_PRODUCT_ROLE:PROD_COZINHA=1",
+   "evidence": "only kitchen-routing flag: DERIVED_FROM_PRODUCT_ROLE:PROD_COZINHA=1",
+   "verdict": "NEEDS_REVIEW"
+  },
+  {
+   "database": "TESTESOFICIAIS",
+   "product": "000321",
+   "field": "IPPT",
+   "before": "T",
+   "after": "P",
+   "rule": "DERIVED_FROM_PRODUCT_ROLE:C000032.TIPO=COMPOSICAO",
+   "evidence": "ERP evidence: DERIVED_FROM_PRODUCT_ROLE:C000032.TIPO=COMPOSICAO",
+   "verdict": "SEMANTICALLY_PROVEN"
+  },
+  {
+   "database": "TESTESOFICIAIS",
+   "product": "000323",
+   "field": "IPPT",
+   "before": "T",
+   "after": "P",
+   "rule": "DERIVED_FROM_PRODUCT_ROLE:C000032.TIPO=COMPOSICAO",
+   "evidence": "ERP evidence: DERIVED_FROM_PRODUCT_ROLE:C000032.TIPO=COMPOSICAO",
+   "verdict": "SEMANTICALLY_PROVEN"
+  },
+  {
+   "database": "TESTESOFICIAIS",
+   "product": "000474",
+   "field": "IPPT",
+   "before": "T",
+   "after": "P",
+   "rule": "DERIVED_FROM_PRODUCT_ROLE:PROD_COZINHA=1",
+   "evidence": "only kitchen-routing flag: DERIVED_FROM_PRODUCT_ROLE:PROD_COZINHA=1",
+   "verdict": "NEEDS_REVIEW"
+  },
+  {
+   "database": "TESTESOFICIAIS",
+   "product": "000481",
+   "field": "IPPT",
+   "before": "T",
+   "after": "P",
+   "rule": "DERIVED_FROM_PRODUCT_ROLE:PROD_COZINHA=1",
+   "evidence": "only kitchen-routing flag: DERIVED_FROM_PRODUCT_ROLE:PROD_COZINHA=1",
+   "verdict": "NEEDS_REVIEW"
+  },
+  {
+   "database": "TESTESOFICIAIS",
+   "product": "000590",
+   "field": "IPPT",
+   "before": "T",
+   "after": "P",
+   "rule": "DERIVED_FROM_PRODUCT_ROLE:PROD_COZINHA=1",
+   "evidence": "only kitchen-routing flag: DERIVED_FROM_PRODUCT_ROLE:PROD_COZINHA=1",
+   "verdict": "NEEDS_REVIEW"
+  },
+  {
+   "database": "TESTESOFICIAIS",
+   "product": "000640",
+   "field": "IPPT",
+   "before": "T",
+   "after": "P",
+   "rule": "DERIVED_FROM_PRODUCT_ROLE:PROD_COZINHA=1",
+   "evidence": "only kitchen-routing flag: DERIVED_FROM_PRODUCT_ROLE:PROD_COZINHA=1",
+   "verdict": "NEEDS_REVIEW"
+  },
+  {
+   "database": "TESTESOFICIAIS",
+   "product": "000652",
+   "field": "IPPT",
+   "before": "T",
+   "after": "P",
+   "rule": "DERIVED_FROM_PRODUCT_ROLE:C000032.TIPO=COMPOSICAO",
+   "evidence": "ERP evidence: DERIVED_FROM_PRODUCT_ROLE:C000032.TIPO=COMPOSICAO",
+   "verdict": "SEMANTICALLY_PROVEN"
+  },
+  {
+   "database": "TESTESOFICIAIS",
+   "product": "000697",
+   "field": "IPPT",
+   "before": "T",
+   "after": "P",
+   "rule": "DERIVED_FROM_PRODUCT_ROLE:PROD_COZINHA=1,RECEITA_INGREDIENTES",
+   "evidence": "ERP evidence: DERIVED_FROM_PRODUCT_ROLE:PROD_COZINHA=1,RECEITA_INGREDIENTES",
+   "verdict": "SEMANTICALLY_PROVEN"
+  },
+  {
+   "database": "TESTESOFICIAIS",
+   "product": "000711",
+   "field": "IPPT",
+   "before": "T",
+   "after": "P",
+   "rule": "DERIVED_FROM_PRODUCT_ROLE:C000032.TIPO=COMPOSICAO",
+   "evidence": "ERP evidence: DERIVED_FROM_PRODUCT_ROLE:C000032.TIPO=COMPOSICAO",
+   "verdict": "SEMANTICALLY_PROVEN"
+  },
+  {
+   "database": "TESTESOFICIAIS",
+   "product": "000769",
+   "field": "IPPT",
+   "before": "T",
+   "after": "P",
+   "rule": "DERIVED_FROM_PRODUCT_ROLE:PROD_COZINHA=1",
+   "evidence": "only kitchen-routing flag: DERIVED_FROM_PRODUCT_ROLE:PROD_COZINHA=1",
+   "verdict": "NEEDS_REVIEW"
+  },
+  {
+   "database": "TESTESOFICIAIS",
+   "product": "000801",
+   "field": "CFOP",
+   "before": null,
+   "after": "5102",
+   "rule": "DERIVED_FROM_ROLE_AND_ST_FILLING_BLANK",
+   "evidence": "resale; CST=000 CSOSN= not ST; NCM 03046100 not in BA ST prefixes",
+   "verdict": "SEMANTICALLY_PROVEN"
+  },
+  {
+   "database": "TESTESOFICIAIS",
+   "product": "000802",
+   "field": "CFOP",
+   "before": null,
+   "after": "5102",
+   "rule": "DERIVED_FROM_ROLE_AND_ST_FILLING_BLANK",
+   "evidence": "resale; CST=000 CSOSN= not ST; NCM 03038910 not in BA ST prefixes",
+   "verdict": "SEMANTICALLY_PROVEN"
+  }
+ ]
+}

docs/LOCAL_WRITE_SEMANTIC_AUDIT_V2_CFOP_CEST_IPPT.csv

@@ -0,0 +1,45 @@
+database,product,field,before,after,rule,evidence,verdict
+CONSTRUCAO,001984,CFOP,5405,5102,PROVEN_ROLE_AND_ST_CONTRADICT_DECLARED_CFOP,"ERP declares ICMS-ST already retained (CST=060, CSOSN=500); CFOP 5102 contradicts the product's own CST/CSOSN, official table alone cannot override it",INVALID_RULE
+CONSTRUCAO,002883,CFOP,5405,5102,PROVEN_ROLE_AND_ST_CONTRADICT_DECLARED_CFOP,"ERP declares ICMS-ST already retained (CST=060, CSOSN=500); CFOP 5102 contradicts the product's own CST/CSOSN, official table alone cannot override it",INVALID_RULE
+CONSTRUCAO,003714,CFOP,5405,5102,PROVEN_ROLE_AND_ST_CONTRADICT_DECLARED_CFOP,"ERP declares ICMS-ST already retained (CST=060, CSOSN=500); CFOP 5102 contradicts the product's own CST/CSOSN, official table alone cannot override it",INVALID_RULE
+UNIAO,000106,CFOP,5405,5102,PROVEN_ROLE_AND_ST_CONTRADICT_DECLARED_CFOP,"ERP declares ICMS-ST already retained (CST=060, CSOSN=500); CFOP 5102 contradicts the product's own CST/CSOSN, official table alone cannot override it",INVALID_RULE
+UNIAO,000107,CFOP,5405,5102,PROVEN_ROLE_AND_ST_CONTRADICT_DECLARED_CFOP,"ERP declares ICMS-ST already retained (CST=060, CSOSN=500); CFOP 5102 contradicts the product's own CST/CSOSN, official table alone cannot override it",INVALID_RULE
+UNIAO,000108,CFOP,5405,5102,PROVEN_ROLE_AND_ST_CONTRADICT_DECLARED_CFOP,"ERP declares ICMS-ST already retained (CST=060, CSOSN=500); CFOP 5102 contradicts the product's own CST/CSOSN, official table alone cannot override it",INVALID_RULE
+UNIAO,000109,CFOP,5405,5102,PROVEN_ROLE_AND_ST_CONTRADICT_DECLARED_CFOP,"ERP declares ICMS-ST already retained (CST=060, CSOSN=500); CFOP 5102 contradicts the product's own CST/CSOSN, official table alone cannot override it",INVALID_RULE
+UNIAO,001084,CFOP,5405,5102,PROVEN_ROLE_AND_ST_CONTRADICT_DECLARED_CFOP,"ERP declares ICMS-ST already retained (CST=060, CSOSN=500); CFOP 5102 contradicts the product's own CST/CSOSN, official table alone cannot override it",INVALID_RULE
+UNIAO,001268,CFOP,5405,5102,PROVEN_ROLE_AND_ST_CONTRADICT_DECLARED_CFOP,"ERP declares ICMS-ST already retained (CST=060, CSOSN=500); CFOP 5102 contradicts the product's own CST/CSOSN, official table alone cannot override it",INVALID_RULE
+UNIAO,001325,CFOP,5405,5102,PROVEN_ROLE_AND_ST_CONTRADICT_DECLARED_CFOP,"ERP declares ICMS-ST already retained (CST=060, CSOSN=500); CFOP 5102 contradicts the product's own CST/CSOSN, official table alone cannot override it",INVALID_RULE
+UNIAO,001372,CFOP,5405,5102,PROVEN_ROLE_AND_ST_CONTRADICT_DECLARED_CFOP,"ERP declares ICMS-ST already retained (CST=060, CSOSN=500); CFOP 5102 contradicts the product's own CST/CSOSN, official table alone cannot override it",INVALID_RULE
+UNIAO,001701,CFOP,5405,5102,PROVEN_ROLE_AND_ST_CONTRADICT_DECLARED_CFOP,"ERP declares ICMS-ST already retained (CST=060, CSOSN=500); CFOP 5102 contradicts the product's own CST/CSOSN, official table alone cannot override it",INVALID_RULE
+UNIAO,002469,CFOP,5405,5102,PROVEN_ROLE_AND_ST_CONTRADICT_DECLARED_CFOP,"ERP declares ICMS-ST already retained (CST=060, CSOSN=500); CFOP 5102 contradicts the product's own CST/CSOSN, official table alone cannot override it",INVALID_RULE
+UNIAO,002471,CFOP,5405,5102,PROVEN_ROLE_AND_ST_CONTRADICT_DECLARED_CFOP,"ERP declares ICMS-ST already retained (CST=060, CSOSN=500); CFOP 5102 contradicts the product's own CST/CSOSN, official table alone cannot override it",INVALID_RULE
+UNIAO,002637,CEST,,1703500,SINGLE_DEFENSIBLE_OFFICIAL_CEST,official CEST dataset: NCM 21039021 linked exactly to 17.035.00 (single candidate); before blank,SEMANTICALLY_PROVEN
+UNIAO,004229,CFOP,5405,5102,PROVEN_ROLE_AND_ST_CONTRADICT_DECLARED_CFOP,"ERP declares ICMS-ST already retained (CST=060, CSOSN=500); CFOP 5102 contradicts the product's own CST/CSOSN, official table alone cannot override it",INVALID_RULE
+UNIAO,005449,CFOP,5405,5102,PROVEN_ROLE_AND_ST_CONTRADICT_DECLARED_CFOP,"ERP declares ICMS-ST already retained (CST=060, CSOSN=500); CFOP 5102 contradicts the product's own CST/CSOSN, official table alone cannot override it",INVALID_RULE
+UNIAO,005626,CFOP,5405,5102,PROVEN_ROLE_AND_ST_CONTRADICT_DECLARED_CFOP,"ERP declares ICMS-ST already retained (CST=060, CSOSN=500); CFOP 5102 contradicts the product's own CST/CSOSN, official table alone cannot override it",INVALID_RULE
+UNIAO,005627,CFOP,5405,5102,PROVEN_ROLE_AND_ST_CONTRADICT_DECLARED_CFOP,"ERP declares ICMS-ST already retained (CST=060, CSOSN=500); CFOP 5102 contradicts the product's own CST/CSOSN, official table alone cannot override it",INVALID_RULE
+UNIAO,005988,CFOP,5405,5102,PROVEN_ROLE_AND_ST_CONTRADICT_DECLARED_CFOP,"ERP declares ICMS-ST already retained (CST=060, CSOSN=500); CFOP 5102 contradicts the product's own CST/CSOSN, official table alone cannot override it",INVALID_RULE
+TESTESOFICIAIS,000008,CFOP,5102,5101,PROVEN_ROLE_AND_ST_CONTRADICT_DECLARED_CFOP,own production evidence: DERIVED_FROM_PRODUCT_ROLE:C000032.TIPO=COMPOSICAO,SEMANTICALLY_PROVEN
+TESTESOFICIAIS,000008,IPPT,T,P,DERIVED_FROM_PRODUCT_ROLE:C000032.TIPO=COMPOSICAO,ERP evidence: DERIVED_FROM_PRODUCT_ROLE:C000032.TIPO=COMPOSICAO,SEMANTICALLY_PROVEN
+TESTESOFICIAIS,000009,CFOP,5102,5101,PROVEN_ROLE_AND_ST_CONTRADICT_DECLARED_CFOP,only kitchen-routing flag: DERIVED_FROM_PRODUCT_ROLE:PROD_COZINHA=1,NEEDS_REVIEW
+TESTESOFICIAIS,000009,IPPT,T,P,DERIVED_FROM_PRODUCT_ROLE:PROD_COZINHA=1,only kitchen-routing flag: DERIVED_FROM_PRODUCT_ROLE:PROD_COZINHA=1,NEEDS_REVIEW
+TESTESOFICIAIS,000010,CFOP,5102,5101,PROVEN_ROLE_AND_ST_CONTRADICT_DECLARED_CFOP,own production evidence: DERIVED_FROM_PRODUCT_ROLE:C000032.TIPO=COMPOSICAO,SEMANTICALLY_PROVEN
+TESTESOFICIAIS,000010,IPPT,T,P,DERIVED_FROM_PRODUCT_ROLE:C000032.TIPO=COMPOSICAO,ERP evidence: DERIVED_FROM_PRODUCT_ROLE:C000032.TIPO=COMPOSICAO,SEMANTICALLY_PROVEN
+TESTESOFICIAIS,000018,IPPT,T,P,DERIVED_FROM_PRODUCT_ROLE:C000032.TIPO=COMPOSICAO,ERP evidence: DERIVED_FROM_PRODUCT_ROLE:C000032.TIPO=COMPOSICAO,SEMANTICALLY_PROVEN
+TESTESOFICIAIS,000034,IPPT,T,P,DERIVED_FROM_PRODUCT_ROLE:PROD_COZINHA=1,only kitchen-routing flag: DERIVED_FROM_PRODUCT_ROLE:PROD_COZINHA=1,NEEDS_REVIEW
+TESTESOFICIAIS,000247,CFOP,5102,5101,PROVEN_ROLE_AND_ST_CONTRADICT_DECLARED_CFOP,only kitchen-routing flag: DERIVED_FROM_PRODUCT_ROLE:PROD_COZINHA=1,NEEDS_REVIEW
+TESTESOFICIAIS,000247,IPPT,T,P,DERIVED_FROM_PRODUCT_ROLE:PROD_COZINHA=1,only kitchen-routing flag: DERIVED_FROM_PRODUCT_ROLE:PROD_COZINHA=1,NEEDS_REVIEW
+TESTESOFICIAIS,000260,IPPT,T,P,DERIVED_FROM_PRODUCT_ROLE:PROD_COZINHA=1,only kitchen-routing flag: DERIVED_FROM_PRODUCT_ROLE:PROD_COZINHA=1,NEEDS_REVIEW
+TESTESOFICIAIS,000261,IPPT,T,P,DERIVED_FROM_PRODUCT_ROLE:PROD_COZINHA=1,only kitchen-routing flag: DERIVED_FROM_PRODUCT_ROLE:PROD_COZINHA=1,NEEDS_REVIEW
+TESTESOFICIAIS,000321,IPPT,T,P,DERIVED_FROM_PRODUCT_ROLE:C000032.TIPO=COMPOSICAO,ERP evidence: DERIVED_FROM_PRODUCT_ROLE:C000032.TIPO=COMPOSICAO,SEMANTICALLY_PROVEN
+TESTESOFICIAIS,000323,IPPT,T,P,DERIVED_FROM_PRODUCT_ROLE:C000032.TIPO=COMPOSICAO,ERP evidence: DERIVED_FROM_PRODUCT_ROLE:C000032.TIPO=COMPOSICAO,SEMANTICALLY_PROVEN
+TESTESOFICIAIS,000474,IPPT,T,P,DERIVED_FROM_PRODUCT_ROLE:PROD_COZINHA=1,only kitchen-routing flag: DERIVED_FROM_PRODUCT_ROLE:PROD_COZINHA=1,NEEDS_REVIEW
+TESTESOFICIAIS,000481,IPPT,T,P,DERIVED_FROM_PRODUCT_ROLE:PROD_COZINHA=1,only kitchen-routing flag: DERIVED_FROM_PRODUCT_ROLE:PROD_COZINHA=1,NEEDS_REVIEW
+TESTESOFICIAIS,000590,IPPT,T,P,DERIVED_FROM_PRODUCT_ROLE:PROD_COZINHA=1,only kitchen-routing flag: DERIVED_FROM_PRODUCT_ROLE:PROD_COZINHA=1,NEEDS_REVIEW
+TESTESOFICIAIS,000640,IPPT,T,P,DERIVED_FROM_PRODUCT_ROLE:PROD_COZINHA=1,only kitchen-routing flag: DERIVED_FROM_PRODUCT_ROLE:PROD_COZINHA=1,NEEDS_REVIEW
+TESTESOFICIAIS,000652,IPPT,T,P,DERIVED_FROM_PRODUCT_ROLE:C000032.TIPO=COMPOSICAO,ERP evidence: DERIVED_FROM_PRODUCT_ROLE:C000032.TIPO=COMPOSICAO,SEMANTICALLY_PROVEN
+TESTESOFICIAIS,000697,IPPT,T,P,"DERIVED_FROM_PRODUCT_ROLE:PROD_COZINHA=1,RECEITA_INGREDIENTES","ERP evidence: DERIVED_FROM_PRODUCT_ROLE:PROD_COZINHA=1,RECEITA_INGREDIENTES",SEMANTICALLY_PROVEN
+TESTESOFICIAIS,000711,IPPT,T,P,DERIVED_FROM_PRODUCT_ROLE:C000032.TIPO=COMPOSICAO,ERP evidence: DERIVED_FROM_PRODUCT_ROLE:C000032.TIPO=COMPOSICAO,SEMANTICALLY_PROVEN
+TESTESOFICIAIS,000769,IPPT,T,P,DERIVED_FROM_PRODUCT_ROLE:PROD_COZINHA=1,only kitchen-routing flag: DERIVED_FROM_PRODUCT_ROLE:PROD_COZINHA=1,NEEDS_REVIEW
+TESTESOFICIAIS,000801,CFOP,,5102,DERIVED_FROM_ROLE_AND_ST_FILLING_BLANK,resale; CST=000 CSOSN= not ST; NCM 03046100 not in BA ST prefixes,SEMANTICALLY_PROVEN
+TESTESOFICIAIS,000802,CFOP,,5102,DERIVED_FROM_ROLE_AND_ST_FILLING_BLANK,resale; CST=000 CSOSN= not ST; NCM 03038910 not in BA ST prefixes,SEMANTICALLY_PROVEN

docs/MISSION_00F_REPORT.md

@@ -0,0 +1,169 @@
+# Missao 00F - Relatorio Final Live
+
+## 1. Veredito
+
+`MISSION_00_BLOCKED`
+
+O banco foi conectado e inspecionado em modo read-only, mas a missao nao
+atinge `MISSION_00_COMPLETE` porque a correlacao do produto da tela nao foi
+confirmada na tabela principal, a contagem de produtos nao foi coletada e a
+classificacao do fingerprint permanece `SCHEMA_UNKNOWN`.
+
+## 2. Proveniencia e runtime
+
+- `FDB_PROVENANCE=PASS`
+- `fdb.__file__`: `.../site-packages/fdb/__init__.py`
+- `fdb.__package__`: `fdb`
+- `fdb.__version__`: `2.0.4`
+- Distribuicao: `fdb==2.0.4`
+- Firebird/client: `2.5.9.27139`
+- Arquitetura Python/client: `MATCH`
+- API read-only: `PROVEN`
+- Shadowing: nenhum
+- Origens ambiguas: nao
+- `CREDENTIAL_SOURCE=OPERATOR_ENV`; valores nao foram registrados.
+
+## 3. Conexao
+
+- Alvo exclusivo: `TESTESOFICIAIS.FDB`
+- Resultado: `CONNECTED`
+- Engine reportada: `2.5`
+- SQL dialect: `3`
+- ODS: `11.2`
+- Page size: `4096`
+- Charset: nao reportado pelo driver (`UNKNOWN`)
+- Nenhuma query de escrita foi executada.
+
+## 4. Catalogo real
+
+- Relacoes/tabelas/views: `376`
+- Campos: `5772`
+- Chaves: `217`
+- Foreign keys: `17`
+- Indices: `456`
+- Triggers: `151`
+- Procedures: `12`
+- Procedure parameters: indisponivel no Firebird 2.5 (`0` coletados)
+- Packages: indisponivel no Firebird 2.5 (`0` coletados)
+- Generators: `71`
+- Dependencies: `1433`
+- Monitoring: indisponivel nesta coleta
+
+## 5. Produto
+
+- Tabela principal identificada por estrutura, PK, campos semanticos e amostra:
+  `C000025`
+- PK: `CODIGO`
+- Campos da tabela: `189`
+- Quantidade aproximada: `UNKNOWN`; nao foi executado count dinamico.
+- Campos principais confirmados por metadata: `CODIGO`, `PRODUTO`, `UNIDADE`,
+  `CODGRUPO`, `CODSUBGRUPO`, `CODFORNECEDOR`, `CODMARCA`, `ESTOQUE`,
+  `NCM`, `GTIN`, `DATA_CADASTRO`, `ULTIMA_ALTERACAO`, `FLAG_ATIVO`.
+- FKs diretas de `C000025`: nenhuma retornada.
+
+O codigo `000276` foi encontrado em amostra da tabela auxiliar
+`PRODUTOS_CODIGOS_BARRAS`/`CL00007`, mas o registro principal correspondente em
+`C000025` nao foi confirmado pela amostra limitada. O texto visual e NCM nao
+foram usados como prova de equivalencia sem essa correlacao.
+
+## 6. Mapping fiscal UI -> Firebird
+
+Tabela base: `C000025`. A existencia das colunas abaixo foi confirmada por
+metadata; a semantica exata de entrada/saida e os valores do produto continuam
+`INFERRED` quando nao existe coluna direcional explícita.
+
+| UI_FIELD | TABLE | COLUMN | DATA_TYPE | DOMAIN | FK | NULLABLE/DEFAULT | CONFIDENCE |
+|---|---|---|---|---|---|---|---|
+| NCM | C000025 | NCM | VARYING | UNKNOWN | UNKNOWN | UNKNOWN | CONFIRMED |
+| CFOP entrada | C000025 | CFOP_ENTRADA | TEXT | UNKNOWN | UNKNOWN | UNKNOWN | CONFIRMED |
+| CFOP saída | C000025 | CFOP | VARYING | UNKNOWN | UNKNOWN | UNKNOWN | INFERRED |
+| CST ICMS entrada | C000025 | CST_ENTRADA | TEXT | UNKNOWN | UNKNOWN | UNKNOWN | CONFIRMED |
+| CST ICMS saída | C000025 | CST | VARYING | UNKNOWN | UNKNOWN | UNKNOWN | INFERRED |
+| Alíquota ICMS | C000025 | ALIQUOTA | INT64 | UNKNOWN | UNKNOWN | UNKNOWN | INFERRED |
+| CEST | C000025 | CEST | VARYING | UNKNOWN | UNKNOWN | UNKNOWN | CONFIRMED |
+| CSOSN código/significado | C000025 | CSOSN | VARYING | UNKNOWN | UNKNOWN | UNKNOWN | CONFIRMED |
+| COFINS entrada | C000025 | COD_ENTRADA_COFINS | VARYING | UNKNOWN | UNKNOWN | UNKNOWN | CONFIRMED |
+| COFINS saída | C000025 | COD_SAIDA_COFINS | VARYING | UNKNOWN | UNKNOWN | UNKNOWN | CONFIRMED |
+| Alíquota COFINS | C000025 | ALIQ_COFINS | VARYING | UNKNOWN | UNKNOWN | UNKNOWN | CONFIRMED |
+| PIS entrada | C000025 | COD_ENTRADA_PIS | VARYING | UNKNOWN | UNKNOWN | UNKNOWN | CONFIRMED |
+| PIS saída | C000025 | COD_SAIDA_PIS | VARYING | UNKNOWN | UNKNOWN | UNKNOWN | CONFIRMED |
+| Alíquota PIS | C000025 | ALIQ_PIS | VARYING | UNKNOWN | UNKNOWN | UNKNOWN | CONFIRMED |
+| Alíquota IPI | C000025 | ALIQ_IPI | VARYING | UNKNOWN | UNKNOWN | UNKNOWN | CONFIRMED |
+| CST IPI | C000025 | CST_IPI | TEXT | UNKNOWN | UNKNOWN | UNKNOWN | CONFIRMED |
+| Origem mercadoria | C000025 | ORIGEM | VARYING | UNKNOWN | UNKNOWN | UNKNOWN | CONFIRMED |
+| IAT | C000025 | IAT | VARYING | UNKNOWN | UNKNOWN | UNKNOWN | CONFIRMED |
+| Incidência | C000025 | INCIDENCIA_PISCOFINS | VARYING | UNKNOWN | UNKNOWN | UNKNOWN | CONFIRMED |
+| IPPT | C000025 | IPPT | VARYING | UNKNOWN | UNKNOWN | UNKNOWN | CONFIRMED |
+
+Dependencias de trigger para esses campos: metadata de trigger foi coletada,
+mas o source nao foi executado; relacionamento campo-trigger permanece
+`UNKNOWN`.
+
+## 7. Aba Foto
+
+- Campo BLOB candidato: `IMG_PRODUTO`, subtype `1`; tipo BLOB confirmado pelo
+  metadata, valor nao lido.
+- Campo relacionado: `ID_IMG`, tipo `LONG`.
+- Campo alternativo: `FOTO`, tipo `VARYING`.
+- Tabela separada/FK: nao confirmada; FKs diretas de `C000025` nao retornaram.
+- Formato, tamanho, thumbnail e path externo: `UNKNOWN`.
+- Nenhum BLOB completo foi lido.
+
+## 8. Incrementalidade
+
+Evidencias reais na tabela `C000025`:
+
+- `DATA_CADASTRO` (`TIMESTAMP`)
+- `ULTIMA_ALTERACAO` (`TIMESTAMP`)
+- `ESTOQUE` e campos de estoque derivados
+- Triggers `C000025_INS`, `C000025_UPD` e `C000025_DEL`
+
+Classificação: `INFERRED`. O source dos triggers nao foi executado e nao foi
+possivel provar quais colunas eles alteram. Esses campos sao o mecanismo
+preferencial para produto novo/alterado; fingerprint de campos relevantes e o
+fallback futuro.
+
+## 9. Triggers e procedures
+
+Triggers diretamente relacionados a `C000025`:
+
+- `C000025_INS`, tipo `2`
+- `C000025_UPD`, tipo `4`
+- `C000025_DEL`, tipo `6`
+- `CODBARRA_CODPRO`, tipo `1`
+
+Foram inventariadas `151` triggers e `12` procedures. Nenhuma procedure/UDF
+foi executada; source e dependencias foram tratados somente como metadata.
+
+## 10. Fingerprint
+
+- SHA-256 real: `1198f89897532b643439f06b729e93b189018f56e7d478e95095f8f56977005b`
+- Classificacao: `SCHEMA_UNKNOWN`
+- Motivo: fingerprint ainda nao consta em allowlist de banco de referencia.
+- Mecanismo futuro: `SCHEMA_SUPPORTED`, `SCHEMA_CHANGED` ou `SCHEMA_UNKNOWN`.
+
+## 11. Segurança e testes
+
+- `APPLICATION_DDL_DML_WRITES=0`
+- `OTHER_DATABASES_ACCESSED=0`
+- `ERP_FILES_MODIFIED=0`
+- `CONNECTION_ATTEMPTS=1` na execucao final conectada
+- Suíte: `267 passed, 1 skipped`
+- `git diff --check`: passou, com avisos LF/CRLF
+
+## 12. Git
+
+- Branch: `master`
+- `git status`: arquivos staged, modificados e nao rastreados
+- `git log -5`: nenhum commit
+- Hash do ultimo commit: inexistente
+- `GIT_IDENTITY_NOT_CONFIGURED`
+- Nenhuma configuração Git foi criada ou alterada.
+
+## 13. Gaps restantes
+
+- Confirmar o registro `000276` diretamente em `C000025` por lookup read-only
+  limitado.
+- Obter quantidade aproximada de produtos por operação de contagem segura.
+- Inspecionar metadata de source dos triggers sem execução.
+- Confirmar charset e allowlist/classificação do fingerprint.

docs/MISSION_00_REPORT.md

@@ -0,0 +1,52 @@
+# Firebird Mission 00E Task 4 Report
+
+## Verdict
+
+`MISSION_00_BLOCKED` remains the live-discovery result carried forward from the
+prior credential-gated run; this report also records Mission 00E Task 4 boundary
+hardening.
+
+The live gate stopped before driver import or database access because the
+required process-environment credentials `FB_USER` and `FB_PASSWORD` were not
+available. No credentials were guessed or read from external ERP files.
+
+## Boundary
+
+- Authorized target: authorized-database label only
+- Other databases accessed: `0`
+- Application DDL/DML writes: `0`
+- ERP files modified: `0`
+- Client library loading: not reached
+- Engine identity check: not reached
+- Catalog collection and safe sampling: not reached
+- Procedures/triggers: not executed or inspected live
+- BLOB/image data: not read
+- Real fingerprint: not generated; classification is `SCHEMA_UNKNOWN`
+
+## Threat model
+
+The boundary protects against implementation mistakes, accidental unauthorized operations,
+arbitrary SQL exposed to normal callers, the wrong database,
+writes, procedures/UDFs, injection, and dependency shadowing. `TRUSTED_PROCESS
+= TRUE`: arbitrary Python already running in the same process, including
+deliberate introspection or monkey patching, is outside scope. No artificial
+cryptographic controls are added.
+
+## Blocker
+
+`credentials_unavailable`
+
+The probe emitted the blocker without exposing exception text or secret
+values. Continue only after `FB_USER` and `FB_PASSWORD` are supplied through
+the process environment, using the same authorized database label.
+
+## Verification
+
+The complete offline test suite, diff check, Git status, and Git identity check
+were run after this report was written; results are recorded in the task
+completion response.
+
+## Git State
+
+`GIT_IDENTITY_NOT_CONFIGURED`. No Git identity was configured and no Git
+configuration was modified.

docs/MISSION_01_REPORT.md

@@ -0,0 +1,80 @@
+# Missao 01 - C000025 e Dataset Real
+
+## Resultado
+
+- `TOTAL_PRODUCTS=521`
+- Produto `000276` encontrado: **sim**
+- Tabela: `C000025`
+- PK: `CODIGO`
+- `APPLICATION_DDL_DML_WRITES=0`
+- Nenhum UPDATE, INSERT ou DDL executado.
+
+## Produto da UI
+
+Registro confirmado por lookup em `CODIGO`, `PRODUTO` e `CLASSIFICACAO_FISCAL`:
+
+```json
+{
+  "CODIGO": "000276",
+  "PRODUTO": "ABACAXI M/ JARRA",
+  "NCM": null,
+  "CLASSIFICACAO_FISCAL": "08043000",
+  "CFOP": "5102",
+  "CFOP_ENTRADA": null,
+  "CST": "040",
+  "CST_ENTRADA": null,
+  "ALIQUOTA": "20.5",
+  "CEST": "",
+  "CSOSN": "102",
+  "IAT": "A",
+  "INCIDENCIA_PISCOFINS": "NENHUMA",
+  "IPPT": "T"
+}
+```
+
+O campo `NCM` está nulo no registro. O valor visível `08043000` está em
+`CLASSIFICACAO_FISCAL`.
+
+## Campos reais
+
+Os 28 campos solicitados existem em `C000025`, exceto `CCLASSTRIB`. O campo
+equivalente encontrado é `CLASSIFICACAO_FISCAL`; também existe
+`SITUACAO_TRIBUTARIA`. Não foram encontradas colunas `IBS` ou `CBS`.
+
+Campos confirmados: `CODIGO`, `PRODUTO`, `NCM`, `CFOP`, `CFOP_ENTRADA`, `CST`,
+`CST_ENTRADA`, `ALIQUOTA`, `CEST`, `CSOSN`, `CLASSIFICACAO_FISCAL`,
+`COD_ENTRADA_COFINS`, `COD_SAIDA_COFINS`, `ALIQ_COFINS`, `COD_ENTRADA_PIS`,
+`COD_SAIDA_PIS`, `ALIQ_PIS`, `ALIQ_IPI`, `CST_IPI`, `ORIGEM`, `IAT`,
+`INCIDENCIA_PISCOFINS`, `IPPT`, `IMG_PRODUTO`, `FOTO`, `DATA_CADASTRO` e
+`ULTIMA_ALTERACAO`.
+
+## Amostras
+
+- Produtos com `NCM` preenchido: `0`.
+- Produtos sem `NCM`: `20`.
+- Produtos com EAN/CODBARRA: `520`.
+- Dataset: `docs/SAMPLE_PRODUCTS_V1.json`.
+- A amostra não exporta BLOBs nem dados comerciais fora dos campos pedidos.
+
+## Triggers
+
+`C000025_INS` é `BEFORE INSERT` e chama `c000100_insert`, além de inserir
+metadata de auditoria em `C000058`. Usa `NEW.CODIGO`, `NEW.ESTOQUE` e
+`NEW.DATA_CADASTRO`.
+
+`C000025_UPD` é `BEFORE UPDATE` e compara, entre outros, `CST`, `PRODUTO`,
+`ALIQUOTA`, `CODBARRA` e `SITUACAO`; quando há mudança, insere auditoria em
+`C000058` usando `CURRENT_TIMESTAMP`. Não executamos nenhum trigger.
+
+## Fingerprint
+
+- Fingerprint: `1198f89897532b643439f06b729e93b189018f56e7d478e95095f8f56977005b`
+- `REFERENCE_SCHEMA_V1_CREATED=YES`
+- `SCHEMA_CLASSIFICATION=SCHEMA_UNKNOWN` até existir uma allowlist operacional.
+
+## Testes e segurança
+
+- `267 passed, 1 skipped`
+- `APPLICATION_DDL_DML_WRITES=0`
+- `OTHER_DATABASES_ACCESSED=0`
+- `ERP_FILES_MODIFIED=0`

docs/MISSION_02_PRODUCT_RESULTS.json

@@ -0,0 +1,9 @@
+{
+  "status": "OK",
+  "results": [],
+  "firebird_writes": 0,
+  "api_requests": 0,
+  "products_requested": 20,
+  "firebird_products_read": 20,
+  "firebird_access": "READ_ONLY_SELECT"
+}

docs/MISSION_02_REPORT.md

@@ -0,0 +1,20 @@
+# Mission 02 Report
+
+## Result
+
+The central hub implements versioned NCM storage, atomic active-version promotion, authenticated v1 classification routes, deterministic NCM validation/ranking, cache provenance, and null fiscal determination fields. The agent has local SQLite state and a retrying HTTP outbox. It has no Firebird write capability.
+
+The live 20-product run was not performed because Firebird credentials were not available in the process environment. `MISSION_02_PRODUCT_RESULTS.json` records this explicitly; no classification result is presented as live evidence.
+
+## Safety and Cost Counters
+
+- `PAID_API_CALLS=0`
+- `PAID_API_COST=R$0.00`
+- `APPLICATION_DDL_DML_WRITES=0`
+- `FIREBIRD_WRITES=0`
+- `ERP_FILES_MODIFIED=0`
+- `OTHER_DATABASES_ACCESSED=0`
+
+## Dataset and RTC Status
+
+See `FISCAL_DATASETS.md`. NCM becomes `ACTIVE` only after the official payload parses, passes the importer volume and duplicate checks, persists fully, and atomically supersedes the prior active version. RTC and every unconfigured fiscal dataset remain conservative and return no tax values.

docs/MULTI_DATABASE_COMPANY_CONTEXT_V1.json

@@ -0,0 +1,182 @@
+{
+ "artifact": "MULTI_DATABASE_COMPANY_CONTEXT_V1",
+ "firebird_writes": 0,
+ "resolution_classes": {
+  "AUTO_RESOLVED": [
+   "CONSTRUCAO"
+  ],
+  "CONFLICT": [
+   "MMMODAS",
+   "RINCAO",
+   "UNIAO"
+  ]
+ },
+ "databases": {
+  "CONSTRUCAO": {
+   "without_config": {
+    "COMPANY_CONTEXT": "PASS",
+    "company_code": "000001",
+    "company_cnpj": "45**********90",
+    "company_uf": "BA",
+    "company_crt": "1",
+    "source_of_truth": {
+     "company": "SINGLE_C000004_ROW",
+     "uf": "EMISSOR+C000004+DOCUMENT_KEYS",
+     "crt": "EMISSOR+C000004"
+    },
+    "confidence": "HIGH",
+    "classification": "AUTO_RESOLVED",
+    "warnings": [],
+    "reasons": []
+   },
+   "with_COMPANY_CRT_SOURCE=EMISSOR": {
+    "COMPANY_CONTEXT": "PASS",
+    "company_code": "000001",
+    "company_cnpj": "45**********90",
+    "company_uf": "BA",
+    "company_crt": "1",
+    "source_of_truth": {
+     "company": "SINGLE_C000004_ROW",
+     "uf": "EMISSOR+C000004+DOCUMENT_KEYS",
+     "crt": "EMISSOR+C000004"
+    },
+    "confidence": "HIGH",
+    "classification": "AUTO_RESOLVED",
+    "warnings": [],
+    "reasons": []
+   },
+   "negative_tests": {},
+   "crt_source_status": "CRT_SOURCE_CONFIRMED",
+   "uf_source_status": "UF_SOURCE_CONFIRMED",
+   "resolution_class": "AUTO_RESOLVED"
+  },
+  "MMMODAS": {
+   "without_config": {
+    "COMPANY_CONTEXT": "FAIL",
+    "company_code": "000001",
+    "company_cnpj": "01**********19",
+    "company_uf": "BA",
+    "company_crt": null,
+    "source_of_truth": {
+     "company": "SINGLE_C000004_ROW",
+     "uf": "EMISSOR+C000004+DOCUMENT_KEYS"
+    },
+    "confidence": "NONE",
+    "classification": "CONFLICT",
+    "warnings": [],
+    "reasons": [
+     "CRT_SOURCE_CONFLICT EMISSOR=1 C000004=2: configure COMPANY_CRT_SOURCE (emission programs read EMISSOR)"
+    ]
+   },
+   "with_COMPANY_CRT_SOURCE=EMISSOR": {
+    "COMPANY_CONTEXT": "PASS",
+    "company_code": "000001",
+    "company_cnpj": "01**********19",
+    "company_uf": "BA",
+    "company_crt": "1",
+    "source_of_truth": {
+     "company": "SINGLE_C000004_ROW",
+     "uf": "EMISSOR+C000004+DOCUMENT_KEYS",
+     "crt": "EMISSOR (configured; conflict acknowledged)"
+    },
+    "confidence": "MEDIUM",
+    "classification": "CONFIGURED",
+    "warnings": [
+     "CRT_CONFLICT EMISSOR=1 C000004=2",
+     "OPTANTE_SIMPLES=N inconsistent with CRT=1"
+    ],
+    "reasons": []
+   },
+   "negative_tests": {},
+   "crt_source_status": "CRT_SOURCE_CONFLICT",
+   "uf_source_status": "UF_SOURCE_CONFIRMED",
+   "resolution_class": "CONFLICT"
+  },
+  "RINCAO": {
+   "without_config": {
+    "COMPANY_CONTEXT": "FAIL",
+    "company_code": "000001",
+    "company_cnpj": "09**********54",
+    "company_uf": "BA",
+    "company_crt": null,
+    "source_of_truth": {
+     "company": "EMISSOR_CNPJ_MATCH",
+     "uf": "EMISSOR+C000004+DOCUMENT_KEYS"
+    },
+    "confidence": "NONE",
+    "classification": "CONFLICT",
+    "warnings": [],
+    "reasons": [
+     "CRT_SOURCE_CONFLICT EMISSOR=3 C000004=1: configure COMPANY_CRT_SOURCE (emission programs read EMISSOR)"
+    ]
+   },
+   "with_COMPANY_CRT_SOURCE=EMISSOR": {
+    "COMPANY_CONTEXT": "PASS",
+    "company_code": "000001",
+    "company_cnpj": "09**********54",
+    "company_uf": "BA",
+    "company_crt": "3",
+    "source_of_truth": {
+     "company": "EMISSOR_CNPJ_MATCH",
+     "uf": "EMISSOR+C000004+DOCUMENT_KEYS",
+     "crt": "EMISSOR (configured; conflict acknowledged)"
+    },
+    "confidence": "MEDIUM",
+    "classification": "CONFIGURED",
+    "warnings": [
+     "CRT_CONFLICT EMISSOR=3 C000004=1",
+     "OPTANTE_SIMPLES=S inconsistent with CRT=3"
+    ],
+    "reasons": []
+   },
+   "negative_tests": {
+    "configured_non_emitting_company": "CONFLICT",
+    "configured_unknown_cnpj": "CONFIG_REQUIRED"
+   },
+   "crt_source_status": "CRT_SOURCE_CONFLICT",
+   "uf_source_status": "UF_SOURCE_CONFIRMED",
+   "resolution_class": "CONFLICT"
+  },
+  "UNIAO": {
+   "without_config": {
+    "COMPANY_CONTEXT": "FAIL",
+    "company_code": "000001",
+    "company_cnpj": "09**********05",
+    "company_uf": "BA",
+    "company_crt": null,
+    "source_of_truth": {
+     "company": "SINGLE_C000004_ROW",
+     "uf": "EMISSOR+C000004+DOCUMENT_KEYS"
+    },
+    "confidence": "NONE",
+    "classification": "CONFLICT",
+    "warnings": [],
+    "reasons": [
+     "CRT_SOURCE_CONFLICT EMISSOR=1 C000004=3: configure COMPANY_CRT_SOURCE (emission programs read EMISSOR)"
+    ]
+   },
+   "with_COMPANY_CRT_SOURCE=EMISSOR": {
+    "COMPANY_CONTEXT": "PASS",
+    "company_code": "000001",
+    "company_cnpj": "09**********05",
+    "company_uf": "BA",
+    "company_crt": "1",
+    "source_of_truth": {
+     "company": "SINGLE_C000004_ROW",
+     "uf": "EMISSOR+C000004+DOCUMENT_KEYS",
+     "crt": "EMISSOR (configured; conflict acknowledged)"
+    },
+    "confidence": "MEDIUM",
+    "classification": "CONFIGURED",
+    "warnings": [
+     "CRT_CONFLICT EMISSOR=1 C000004=3"
+    ],
+    "reasons": []
+   },
+   "negative_tests": {},
+   "crt_source_status": "CRT_SOURCE_CONFLICT",
+   "uf_source_status": "UF_SOURCE_CONFIRMED",
+   "resolution_class": "CONFLICT"
+  }
+ }
+}

docs/MULTI_DATABASE_FINDINGS_V1.md

@@ -0,0 +1,94 @@
+# MULTI_DATABASE_FINDINGS_V1
+
+Read-only audit of the copies in `Banco/` (no Firebird writes, no new fiscal rules, no new datasets). Segment = inferred from table population and the company name stored in C000004, never from the file name.
+
+## Databases
+
+| file | segment (evidence) | products | company UF/CRT (C000004) | EMISSOR.EMITENTE_CRT | schema class |
+|---|---|---|---|---|---|
+| CONSTRUCAO.FDB | CONSTRUCTION | 3712 | BA/1 | ['1'] | COMPATIBLE_WITH_VARIATIONS |
+| MMMODAS.FDB | APPAREL | 20997 | BA/2 | ['1'] | COMPATIBLE_WITH_VARIATIONS |
+| RINCAO.FDB | RESTAURANT | 894 | UNAVAILABLE (3 company rows) | ['3'] | COMPATIBLE_WITH_VARIATIONS |
+| UNIAO.FDB | RETAIL_MARKET | 8942 | BA/3 | ['1'] | COMPATIBLE_WITH_VARIATIONS |
+
+Company-context findings: C000004.CRT disagrees with EMISSOR.EMITENTE_CRT in 3 of the 4 copies, OPTANTE_SIMPLES=S coexists with CRT=3 (UNIAO) and OPTANTE_SIMPLES=N with CRT=2 (MMMODAS); RINCAO's C000004 holds 3 company rows (fail-closed: context ambiguous). The Agent must not guess: it needs an explicit company selection and a decided CRT source of truth.
+
+## Fiscal coverage (Fiscal Engine V1, read-only)
+
+| metric | CONSTRUCAO.FDB | MMMODAS.FDB | RINCAO.FDB | UNIAO.FDB |
+|---|---|---|---|---|
+| TOTAL_PRODUCTS | 3712 | 20997 | 894 | 8942 |
+| NCM_VALID | 3698 | 20881 | 894 | 8851 |
+| NCM_LEGACY | 0 | 0 | 0 | 3 |
+| NCM_INVALID | 14 | 116 | 0 | 88 |
+| NCM_MISSING | 0 | 0 | 0 | 0 |
+| IPI_NUMERIC | 1497 | 1947 | 349 | 2469 |
+| IPI_NON_NUMERIC | 63 | 38 | 18 | 249 |
+| IPI_SOURCE_BLANK | 1220 | 18887 | 378 | 3150 |
+| IPI_AMBIGUOUS | 918 | 9 | 149 | 2983 |
+| IPI_NO_MATCH | 14 | 116 | 0 | 88 |
+| IPI_ALREADY_CORRECT | 0 | 0 | 0 | 0 |
+| IPI_CHANGE_REQUIRED | 1497 | 1947 | 349 | 2469 |
+| IPI_WRITE_ELIGIBLE | 1497 | 1947 | 349 | 2469 |
+| CEST_CONFIRMED | 0 | 0 | 0 | 4 |
+| CEST_CANDIDATES | 0 | 45 | 2 | 42 |
+| CFOP_RESOLVED | 2198 | 20798 | 0 | 5944 |
+| CFOP_CONTEXT_REQUIRED | 1514 | 199 | 894 | 2998 |
+| CSOSN_RESOLVED | 0 | 0 | 0 | 0 |
+| CSOSN_CANDIDATES | 74 | 0 | 0 | 0 |
+| CSOSN_CONTEXT_REQUIRED | 3638 | 20997 | 894 | 8942 |
+| ST_CONFIRMED | 867 | 0 | 0 | 297 |
+| ST_CANDIDATE | 434 | 26 | 0 | 1706 |
+| ST_UNKNOWN | 2337 | 20933 | 894 | 6444 |
+| ST_NOT_APPLICABLE | 74 | 38 | 0 | 495 |
+| PRODUCT_ROLE_KNOWN | 3708 | 20909 | 668 | 8922 |
+| PRODUCT_ROLE_UNKNOWN | 4 | 88 | 226 | 20 |
+| ST_WITHHOLDING_CONFIRMED | 0 | 0 | 0 | 0 |
+| ST_WITHHOLDING_NOT_CONFIRMED | 0 | 10039 | 0 | 0 |
+| ST_WITHHOLDING_UNKNOWN | 3712 | 10958 | 894 | 8942 |
+
+Guards: ST/MVA dataset is BA-only and CSOSN logic needs CRT=1; when the company context does not satisfy them the engine reports context-required instead of applying a rule (`guards_applied` in the coverage artifact).
+
+## Segment comparison
+
+| indicator | CONSTRUCAO.FDB (CONSTRUCTION) | MMMODAS.FDB (APPAREL) | RINCAO.FDB (RESTAURANT) | UNIAO.FDB (RETAIL_MARKET) |
+|---|---|---|---|---|
+| NCM valid share | 99.6% | 99.4% | 100.0% | 99.0% |
+| CEST filled | 93.4% | 0.0% | 71.6% | 86.2% |
+| CSOSN filled | 99.9% | 99.7% | 99.0% | 100.0% |
+| CFOP distinct values | 3 | 5 | 4 | 5 |
+| CFOP top | [['5405', 2266], ['5102', 1444], [None, 2]] | [['5102', 20935], [None, 54], ['5101', 6]] | [['5102', 666], ['5405', 226], ['1556', 1]] | [['5102', 6837], ['5405', 2102], [None, 1]] |
+| SITUACAO_TRIBUTARIA | {'T': 3687, 'null': 25} | {'T': 20994, 'null': 3} | {'T': 893, 'null': 1} | {'T': 8914, 'null': 28} |
+| ST_CANDIDATE+CONFIRMED (BA dataset) | 1301 | 26 | 0 | 2003 |
+| purchase items C000088 | 0 | 117657 | 0 | 0 |
+| products with purchase evidence | 0 | 10041 | 0 | 0 |
+| recipes / composed | 0 / 0 | 0 / 0 | 0 / 0 | 0 / 0 |
+| role known share | 99.9% | 99.6% | 74.7% | 99.8% |
+| IPI numeric share | 40.3% | 9.3% | 39.0% | 27.6% |
+| IPI already stored | 0.0% | 0.0% | 0.0% | 0.0% |
+
+## Where the gaps come from
+
+- **ERP-wide (0 in every database):** CSOSN_RESOLVED, ST_WITHHOLDING_CONFIRMED. These are limits of the SGV data model / current rules, not of one client.
+- **Client/segment:** CEST filling varies from near-empty (apparel) to mostly filled (market/restaurant/construction) — segment-shaped (goods under ST agreements), but each segment has ONE database here, so client vs segment cannot be separated.
+- **Company context (client-specific and ERP-wide):** CRT/regime data is inconsistent inside the same ERP (C000004 vs EMISSOR vs OPTANTE_SIMPLES); it is a data-quality/config issue every client needs to settle.
+- **No auto-repair (oficina) database was provided** (`Banco/` holds construction, apparel, restaurant and market copies); auto-repair conclusions are NOT drawn.
+
+## GUI map validation (21 write targets + origin)
+
+All 21 write-target columns exist in all databases (21 present everywhere); the only type variation is {"CEST": {"UNIAO.FDB": {"reference": [37, 7, 0], "this": [37, 10, 0]}}}. Value patterns repeat across databases (CST 3-digit origin+CST, CSOSN 102/500/101, SITUACAO_TRIBUTARIA T, IAT/IPPT/INCIDENCIA constants, PIS/COFINS columns almost empty), which supports the DFM-derived map without changing it.
+
+Origin (`COD_ORIGEM_MERCADORIA`): populated counts per database {"CONSTRUCAO.FDB": 1, "MMMODAS.FDB": 0, "RINCAO.FDB": 0, "UNIAO.FDB": 6}; observed values {"CONSTRUCAO.FDB": [[null, 3711], ["2", 1]], "MMMODAS.FDB": [[null, 20997]], "RINCAO.FDB": [[null, 894]], "UNIAO.FDB": [[null, 8936], ["1", 3], ["0", 2], ["2", 1]]}. Values stay inside the 0/1/2 domain, but so few rows are populated that this is weak correlation: the field stays **PROBABLE** until a UI diff on the radio group.
+
+## Architecture answer
+
+**CAN_USE_ONE_GENERIC_AGENT=true.** All four databases expose C000004 and C000025 with every write-target column; differences are optional tables, one column length (CEST VARCHAR(10) vs (7)) and company-context quality. Required capabilities: `supports_ncm`, `supports_ipi` (only IPI is written today), `supports_cest`, C000025+C000004 present, an unambiguous (or explicitly configured) company context, and the write executor's live column-length/type check. Detected-but-optional: `supports_csosn/cfop/cst/pis/cofins/origin/iat/incidence/ippt`, and evidence tables (C000088, C000100, RECEITA_INGREDIENTES, NFCE_ITENS) which only enrich validation. No per-client Agent is needed; per-client configuration is: company selector (C000004.CODIGO), CRT source of truth, and the authorized write path/fingerprint (pilot two-layer authorization).
+
+
+## Additional observations
+
+- **IPI_WRITE_ELIGIBLE is engine eligibility, not permission.** Real-client copies store IPI in at most 1 product (none had it filled), so every numeric TIPI match shows as a change (CONSTRUCAO 1497, MMMODAS 1947, RINCAO 349, UNIAO 2469). Policy stays: real-client databases are read-only unless the two-layer pilot authorization (path + schema fingerprint) is configured per installation.
+- **Regime guards mattered:** MMMODAS (CRT=2) and UNIAO (CRT=3) are outside the CRT=1 assumption of the CSOSN engine, and RINCAO's company context is ambiguous, so their CSOSN/ST results are context-required by design, not by data quality.
+- **ST evidence:** CONSTRUCAO has the most CEST-corroborated ST (867 ST_CONFIRMED: ERP CEST equals the BA Anexo 1 item CEST); withholding is still unproven everywhere (0 confirmed; MMMODAS has purchase items flagged ICMS_RETIDO='N'). CEST_LISTED_BUT_BA_ANNEX1_ABSENT keeps apparel in ST_UNKNOWN because the CONFAZ list also names apparel/footwear NCMs.
+- **Method:** classification ran the production Classifier inside the hub container against PostgreSQL (read-only, memoized dataset lookups); 60 products compared with `/v1/classify/batch` gave 0 differences. Side finding: the Hub computes the decision before checking `classification_cache`, so the cache saves storage, not latency (~0.4 s/product over HTTP).
+- **Not provided:** an auto-repair (oficina) database. Restaurant = RINCAO, market = UNIAO; CONSTRUCAO (construction materials) and MMMODAS (apparel) were extra segments.

docs/MULTI_DATABASE_FISCAL_COVERAGE_V1.json

@@ -0,0 +1,298 @@
+{
+ "artifact": "MULTI_DATABASE_FISCAL_COVERAGE_V1",
+ "firebird_writes": 0,
+ "databases": [
+  {
+   "file": "CONSTRUCAO.FDB",
+   "company": {
+    "status": "OK",
+    "uf": "BA",
+    "crt": "1",
+    "error": null
+   },
+   "TOTAL_PRODUCTS": 3712,
+   "metrics": {
+    "NCM_VALID": 3698,
+    "IPI_SOURCE_BLANK": 1220,
+    "CFOP_CONTEXT_REQUIRED": 1514,
+    "ST_CANDIDATE": 434,
+    "ST_WITHHOLDING_UNKNOWN": 3712,
+    "PRODUCT_ROLE_KNOWN": 3708,
+    "ROLE_RESALE": 3707,
+    "CSOSN_CONTEXT_REQUIRED": 3638,
+    "CFOP_RESOLVED": 2198,
+    "ST_CONFIRMED": 867,
+    "IPI_NUMERIC": 1497,
+    "IPI_CHANGE_REQUIRED": 1497,
+    "IPI_WRITE_ELIGIBLE": 1497,
+    "ST_UNKNOWN": 2337,
+    "IPI_AMBIGUOUS": 918,
+    "ST_NOT_APPLICABLE": 74,
+    "CSOSN_CANDIDATES": 74,
+    "NCM_INVALID": 14,
+    "IPI_NO_MATCH": 14,
+    "IPI_NON_NUMERIC": 63,
+    "PRODUCT_ROLE_UNKNOWN": 4,
+    "ROLE_UNKNOWN": 4,
+    "ROLE_INPUT": 1
+   },
+   "quality": {
+    "ncm_valid_share": 0.9962,
+    "cest_filled": 3467,
+    "csosn_filled": 3709,
+    "cfop_filled": 3710,
+    "ipi_filled": 0,
+    "cfop_distinct": 3,
+    "cfop_top": [
+     [
+      "5405",
+      2266
+     ],
+     [
+      "5102",
+      1444
+     ],
+     [
+      null,
+      2
+     ]
+    ],
+    "situacao_tributaria": {
+     "T": 3687,
+     "null": 25
+    },
+    "purchase_items_C000088": 0,
+    "products_with_purchase_evidence": 0,
+    "recipes": 0,
+    "composed_products": 0
+   },
+   "guards_applied": {
+    "st_dataset_ba_only": false,
+    "csosn_requires_crt1": false
+   }
+  },
+  {
+   "file": "MMMODAS.FDB",
+   "company": {
+    "status": "OK",
+    "uf": "BA",
+    "crt": "2",
+    "error": null
+   },
+   "TOTAL_PRODUCTS": 20997,
+   "metrics": {
+    "NCM_VALID": 20881,
+    "IPI_SOURCE_BLANK": 18887,
+    "CFOP_CONTEXT_REQUIRED": 199,
+    "ST_CANDIDATE": 26,
+    "ST_WITHHOLDING_NOT_CONFIRMED": 10039,
+    "PRODUCT_ROLE_KNOWN": 20909,
+    "ROLE_RESALE": 20905,
+    "CSOSN_CONTEXT_REQUIRED": 20997,
+    "CFOP_RESOLVED": 20798,
+    "ST_UNKNOWN": 20933,
+    "ST_WITHHOLDING_UNKNOWN": 10958,
+    "IPI_NUMERIC": 1947,
+    "IPI_CHANGE_REQUIRED": 1947,
+    "IPI_WRITE_ELIGIBLE": 1947,
+    "NCM_INVALID": 116,
+    "IPI_NO_MATCH": 116,
+    "IPI_NON_NUMERIC": 38,
+    "CEST_CANDIDATES": 45,
+    "PRODUCT_ROLE_UNKNOWN": 88,
+    "ROLE_UNKNOWN": 88,
+    "ST_NOT_APPLICABLE": 38,
+    "ROLE_INPUT": 4,
+    "IPI_AMBIGUOUS": 9
+   },
+   "quality": {
+    "ncm_valid_share": 0.9945,
+    "cest_filled": 3,
+    "csosn_filled": 20935,
+    "cfop_filled": 20942,
+    "ipi_filled": 1,
+    "cfop_distinct": 5,
+    "cfop_top": [
+     [
+      "5102",
+      20935
+     ],
+     [
+      null,
+      54
+     ],
+     [
+      "5101",
+      6
+     ],
+     [
+      "5405",
+      1
+     ],
+     [
+      "",
+      1
+     ]
+    ],
+    "situacao_tributaria": {
+     "T": 20994,
+     "null": 3
+    },
+    "purchase_items_C000088": 117657,
+    "products_with_purchase_evidence": 10041,
+    "recipes": 0,
+    "composed_products": 0
+   },
+   "guards_applied": {
+    "st_dataset_ba_only": false,
+    "csosn_requires_crt1": true
+   }
+  },
+  {
+   "file": "RINCAO.FDB",
+   "company": {
+    "status": "UNAVAILABLE",
+    "uf": null,
+    "crt": null,
+    "error": "company context unavailable or ambiguous (3 distinct UF/CRT rows in C000004)"
+   },
+   "TOTAL_PRODUCTS": 894,
+   "metrics": {
+    "NCM_VALID": 894,
+    "IPI_AMBIGUOUS": 149,
+    "CFOP_CONTEXT_REQUIRED": 894,
+    "ST_UNKNOWN": 894,
+    "ST_WITHHOLDING_UNKNOWN": 894,
+    "PRODUCT_ROLE_KNOWN": 668,
+    "ROLE_RESALE": 667,
+    "CSOSN_CONTEXT_REQUIRED": 894,
+    "IPI_NUMERIC": 349,
+    "IPI_CHANGE_REQUIRED": 349,
+    "IPI_WRITE_ELIGIBLE": 349,
+    "IPI_SOURCE_BLANK": 378,
+    "PRODUCT_ROLE_UNKNOWN": 226,
+    "ROLE_UNKNOWN": 226,
+    "IPI_NON_NUMERIC": 18,
+    "CEST_CANDIDATES": 2,
+    "ROLE_INPUT": 1
+   },
+   "quality": {
+    "ncm_valid_share": 1.0,
+    "cest_filled": 640,
+    "csosn_filled": 885,
+    "cfop_filled": 894,
+    "ipi_filled": 0,
+    "cfop_distinct": 4,
+    "cfop_top": [
+     [
+      "5102",
+      666
+     ],
+     [
+      "5405",
+      226
+     ],
+     [
+      "1556",
+      1
+     ],
+     [
+      "5202",
+      1
+     ]
+    ],
+    "situacao_tributaria": {
+     "T": 893,
+     "null": 1
+    },
+    "purchase_items_C000088": 0,
+    "products_with_purchase_evidence": 0,
+    "recipes": 0,
+    "composed_products": 0
+   },
+   "guards_applied": {
+    "st_dataset_ba_only": true,
+    "csosn_requires_crt1": true
+   }
+  },
+  {
+   "file": "UNIAO.FDB",
+   "company": {
+    "status": "OK",
+    "uf": "BA",
+    "crt": "3",
+    "error": null
+   },
+   "TOTAL_PRODUCTS": 8942,
+   "metrics": {
+    "NCM_VALID": 8851,
+    "IPI_SOURCE_BLANK": 3150,
+    "CFOP_RESOLVED": 5944,
+    "ST_UNKNOWN": 6444,
+    "ST_WITHHOLDING_UNKNOWN": 8942,
+    "PRODUCT_ROLE_KNOWN": 8922,
+    "ROLE_RESALE": 8919,
+    "CSOSN_CONTEXT_REQUIRED": 8942,
+    "IPI_NUMERIC": 2469,
+    "IPI_CHANGE_REQUIRED": 2469,
+    "IPI_WRITE_ELIGIBLE": 2469,
+    "IPI_AMBIGUOUS": 2983,
+    "IPI_NON_NUMERIC": 249,
+    "CFOP_CONTEXT_REQUIRED": 2998,
+    "ST_CANDIDATE": 1706,
+    "ST_NOT_APPLICABLE": 495,
+    "NCM_INVALID": 88,
+    "IPI_NO_MATCH": 88,
+    "ST_CONFIRMED": 297,
+    "PRODUCT_ROLE_UNKNOWN": 20,
+    "ROLE_UNKNOWN": 20,
+    "CEST_CANDIDATES": 42,
+    "CEST_CONFIRMED": 4,
+    "ROLE_INPUT": 3,
+    "NCM_LEGACY": 3
+   },
+   "quality": {
+    "ncm_valid_share": 0.9898,
+    "cest_filled": 7708,
+    "csosn_filled": 8939,
+    "cfop_filled": 8941,
+    "ipi_filled": 1,
+    "cfop_distinct": 5,
+    "cfop_top": [
+     [
+      "5102",
+      6837
+     ],
+     [
+      "5405",
+      2102
+     ],
+     [
+      null,
+      1
+     ],
+     [
+      "5403",
+      1
+     ],
+     [
+      "5411",
+      1
+     ]
+    ],
+    "situacao_tributaria": {
+     "T": 8914,
+     "null": 28
+    },
+    "purchase_items_C000088": 0,
+    "products_with_purchase_evidence": 0,
+    "recipes": 0,
+    "composed_products": 0
+   },
+   "guards_applied": {
+    "st_dataset_ba_only": false,
+    "csosn_requires_crt1": true
+   }
+  }
+ ]
+}

docs/MULTI_DATABASE_SCHEMA_AUDIT_V1.json

@@ -0,0 +1,390 @@
+{
+ "artifact": "MULTI_DATABASE_SCHEMA_AUDIT_V1",
+ "firebird_writes": 0,
+ "directory": "Banco",
+ "reference_fingerprint_TESTESOFICIAIS": "e2409c9b9e51b84d056939e6e7d0f1381440e6a7c02ec99583d61e2de13d7742",
+ "databases_found": 4,
+ "databases_audited": 4,
+ "classification_counts": {
+  "REFERENCE_SCHEMA_MATCH": 0,
+  "COMPATIBLE_WITH_VARIATIONS": 4,
+  "INCOMPATIBLE": 0
+ },
+ "databases": [
+  {
+   "file": "CONSTRUCAO.FDB",
+   "size_mb": 88.7,
+   "firebird_server_version": "WI-V6.3.9.27139 Firebird 2.5",
+   "ods": "11.2",
+   "schema_fingerprint": "1414a15950d0b623addd12f8fdb8cbe59a02d8d75211f2de181affaeb57d2781",
+   "tables": 336,
+   "product_count": 3712,
+   "company": {
+    "status": "OK",
+    "uf": "BA",
+    "crt": "1",
+    "OPTANTE_SIMPLES": "S",
+    "OPTANTE_SUPER_SIMPLES": "N",
+    "SUBSTITUTO_TRIBUTARIO": "N",
+    "CONTRIBUINTE_IPI": "N",
+    "ICMS_CSOSN": "102",
+    "name": "UNIAO MATERIAIS DE CONSTRUCAO",
+    "rows": 1,
+    "rows_summary": [
+     [
+      "000001",
+      "BA",
+      "1"
+     ]
+    ],
+    "filial_name_first_row": "UNIÃO MATERIAIS DE CONSTRUÇÃO PALMA LTDA",
+    "emissor_crt": [
+     "1"
+    ]
+   },
+   "C000004_present": true,
+   "C000025_present": true,
+   "schema_class": "COMPATIBLE_WITH_VARIATIONS",
+   "capabilities": {
+    "supports_ncm": true,
+    "supports_cfop_entry": true,
+    "supports_cfop_exit": true,
+    "supports_cst_entry": true,
+    "supports_cst_exit": true,
+    "supports_icms_rate": true,
+    "supports_cest": true,
+    "supports_csosn": true,
+    "supports_ipi": true,
+    "supports_pis": true,
+    "supports_cofins": true,
+    "supports_origin": true,
+    "supports_iat": true,
+    "supports_incidence": true,
+    "supports_ippt": true
+   },
+   "segment_inferred": {
+    "segment": "CONSTRUCTION",
+    "score": {
+     "RESTAURANT": 0,
+     "AUTO_REPAIR": 0,
+     "APPAREL": 0,
+     "RETAIL_MARKET": 0,
+     "CONSTRUCTION": 1
+    },
+    "evidence": [
+     "company name in C000004 contains CONSTRU (weak, name is data, not the file name)"
+    ],
+    "signals": {
+     "restaurant_tables_rows": 0,
+     "kitchen_products": 0,
+     "recipes": 0,
+     "service_orders": 1,
+     "vehicle_products": 0,
+     "grade_items": 0,
+     "nfce_items": 28934
+    },
+    "note": "inferred from table population, not from the file name"
+   },
+   "table_rows": {
+    "MESAS": 0,
+    "R000002": 0,
+    "RECEITA_INGREDIENTES": 0,
+    "DELIVERY_M": 0,
+    "C000051": 1,
+    "NFCE": 24466,
+    "NFCE_ITENS": 28934,
+    "C000032": 91886,
+    "C000062": 547,
+    "C000088": 0,
+    "C000100": 3712,
+    "C000030": 590,
+    "C000061": 115
+   },
+   "error": null
+  },
+  {
+   "file": "MMMODAS.FDB",
+   "size_mb": 248.5,
+   "firebird_server_version": "WI-V6.3.9.27139 Firebird 2.5",
+   "ods": "11.2",
+   "schema_fingerprint": "2c4f68470a2c46c8df1ec18281880cfa833cf3dd44f458e25cdc4482ef8ac085",
+   "tables": 338,
+   "product_count": 20997,
+   "company": {
+    "status": "OK",
+    "uf": "BA",
+    "crt": "2",
+    "OPTANTE_SIMPLES": "N",
+    "OPTANTE_SUPER_SIMPLES": "N",
+    "SUBSTITUTO_TRIBUTARIO": "N",
+    "CONTRIBUINTE_IPI": "N",
+    "ICMS_CSOSN": "102",
+    "name": "MM MODAS",
+    "rows": 1,
+    "rows_summary": [
+     [
+      "000001",
+      "BA",
+      "2"
+     ]
+    ],
+    "filial_name_first_row": "PATRICIA B MATTOS MARTINS",
+    "emissor_crt": [
+     "1"
+    ]
+   },
+   "C000004_present": true,
+   "C000025_present": true,
+   "schema_class": "COMPATIBLE_WITH_VARIATIONS",
+   "capabilities": {
+    "supports_ncm": true,
+    "supports_cfop_entry": true,
+    "supports_cfop_exit": true,
+    "supports_cst_entry": true,
+    "supports_cst_exit": true,
+    "supports_icms_rate": true,
+    "supports_cest": true,
+    "supports_csosn": true,
+    "supports_ipi": true,
+    "supports_pis": true,
+    "supports_cofins": true,
+    "supports_origin": true,
+    "supports_iat": true,
+    "supports_incidence": true,
+    "supports_ippt": true
+   },
+   "segment_inferred": {
+    "segment": "APPAREL",
+    "score": {
+     "RESTAURANT": 0,
+     "AUTO_REPAIR": 0,
+     "APPAREL": 1,
+     "RETAIL_MARKET": 0,
+     "CONSTRUCTION": 0
+    },
+    "evidence": [
+     "company name in C000004 contains MODAS (weak, name is data, not the file name)"
+    ],
+    "signals": {
+     "restaurant_tables_rows": 0,
+     "kitchen_products": 0,
+     "recipes": 0,
+     "service_orders": 0,
+     "vehicle_products": 0,
+     "grade_items": 0,
+     "nfce_items": 26067
+    },
+    "note": "inferred from table population, not from the file name"
+   },
+   "table_rows": {
+    "MESAS": 0,
+    "R000002": 0,
+    "RECEITA_INGREDIENTES": 0,
+    "DELIVERY_M": 0,
+    "C000051": 0,
+    "NFCE": 36293,
+    "NFCE_ITENS": 26067,
+    "C000032": 192763,
+    "C000062": 66,
+    "C000088": 117657,
+    "C000100": 20997,
+    "C000030": 590,
+    "C000061": 26
+   },
+   "error": null
+  },
+  {
+   "file": "RINCAO.FDB",
+   "size_mb": 876.5,
+   "firebird_server_version": "WI-V6.3.9.27139 Firebird 2.5",
+   "ods": "11.2",
+   "schema_fingerprint": "80565949a814b0e799956af8044b76bd6b22075175a0a0564f4d34f0b171e70b",
+   "tables": 345,
+   "product_count": 894,
+   "company": {
+    "status": "UNAVAILABLE",
+    "error": "company context unavailable or ambiguous (3 distinct UF/CRT rows in C000004)",
+    "OPTANTE_SIMPLES": "S",
+    "OPTANTE_SUPER_SIMPLES": "N",
+    "SUBSTITUTO_TRIBUTARIO": "N",
+    "CONTRIBUINTE_IPI": "N",
+    "ICMS_CSOSN": "102",
+    "name": "RINCAO GAUCHO",
+    "rows": 3,
+    "rows_summary": [
+     [
+      "000001",
+      "BA",
+      "1"
+     ],
+     [
+      "000005",
+      "SP",
+      null
+     ],
+     [
+      "000007",
+      "BA",
+      null
+     ]
+    ],
+    "filial_name_first_row": "RESTAURANTE E PIZZARIA TURIZZI LTDA - ME",
+    "emissor_crt": [
+     "3"
+    ]
+   },
+   "C000004_present": true,
+   "C000025_present": true,
+   "schema_class": "COMPATIBLE_WITH_VARIATIONS",
+   "capabilities": {
+    "supports_ncm": true,
+    "supports_cfop_entry": true,
+    "supports_cfop_exit": true,
+    "supports_cst_entry": true,
+    "supports_cst_exit": true,
+    "supports_icms_rate": true,
+    "supports_cest": true,
+    "supports_csosn": true,
+    "supports_ipi": true,
+    "supports_pis": true,
+    "supports_cofins": true,
+    "supports_origin": true,
+    "supports_iat": true,
+    "supports_incidence": true,
+    "supports_ippt": true
+   },
+   "segment_inferred": {
+    "segment": "RESTAURANT",
+    "score": {
+     "RESTAURANT": 4,
+     "AUTO_REPAIR": 0,
+     "APPAREL": 0,
+     "RETAIL_MARKET": 0,
+     "CONSTRUCTION": 0
+    },
+    "evidence": [
+     "company name in C000004 contains RESTAURANTE (weak, name is data, not the file name)",
+     "mesas/comandas rows=715",
+     "PROD_COZINHA products=223"
+    ],
+    "signals": {
+     "restaurant_tables_rows": 715,
+     "kitchen_products": 223,
+     "recipes": 0,
+     "service_orders": 0,
+     "vehicle_products": 0,
+     "grade_items": 0,
+     "nfce_items": 224355
+    },
+    "note": "inferred from table population, not from the file name"
+   },
+   "table_rows": {
+    "MESAS": 701,
+    "R000002": 14,
+    "RECEITA_INGREDIENTES": 0,
+    "DELIVERY_M": 0,
+    "C000051": 0,
+    "NFCE": 173526,
+    "NFCE_ITENS": 224355,
+    "C000032": 1586249,
+    "C000062": 548,
+    "C000088": 0,
+    "C000100": 895,
+    "C000030": 590,
+    "C000061": 278
+   },
+   "error": null
+  },
+  {
+   "file": "UNIAO.FDB",
+   "size_mb": 484.1,
+   "firebird_server_version": "WI-V6.3.9.27139 Firebird 2.5",
+   "ods": "11.2",
+   "schema_fingerprint": "36ed9ffd6fd843955167f2ef389588f4fa184b187ae94a887b50da9ad790150a",
+   "tables": 337,
+   "product_count": 8942,
+   "company": {
+    "status": "OK",
+    "uf": "BA",
+    "crt": "3",
+    "OPTANTE_SIMPLES": "S",
+    "OPTANTE_SUPER_SIMPLES": "N",
+    "SUBSTITUTO_TRIBUTARIO": "N",
+    "CONTRIBUINTE_IPI": "N",
+    "ICMS_CSOSN": "102",
+    "name": "MERCADO UNIAO",
+    "rows": 1,
+    "rows_summary": [
+     [
+      "000001",
+      "BA",
+      "3"
+     ]
+    ],
+    "filial_name_first_row": "GELSON NEVES DA SILVA",
+    "emissor_crt": [
+     "1"
+    ]
+   },
+   "C000004_present": true,
+   "C000025_present": true,
+   "schema_class": "COMPATIBLE_WITH_VARIATIONS",
+   "capabilities": {
+    "supports_ncm": true,
+    "supports_cfop_entry": true,
+    "supports_cfop_exit": true,
+    "supports_cst_entry": true,
+    "supports_cst_exit": true,
+    "supports_icms_rate": true,
+    "supports_cest": true,
+    "supports_csosn": true,
+    "supports_ipi": true,
+    "supports_pis": true,
+    "supports_cofins": true,
+    "supports_origin": true,
+    "supports_iat": true,
+    "supports_incidence": true,
+    "supports_ippt": true
+   },
+   "segment_inferred": {
+    "segment": "RETAIL_MARKET",
+    "score": {
+     "RESTAURANT": 0,
+     "AUTO_REPAIR": 0,
+     "APPAREL": 0,
+     "RETAIL_MARKET": 1,
+     "CONSTRUCTION": 0
+    },
+    "evidence": [
+     "company name in C000004 contains MERCADO (weak, name is data, not the file name)"
+    ],
+    "signals": {
+     "restaurant_tables_rows": 1,
+     "kitchen_products": 0,
+     "recipes": 0,
+     "service_orders": 0,
+     "vehicle_products": 0,
+     "grade_items": 0,
+     "nfce_items": 121266
+    },
+    "note": "inferred from table population, not from the file name"
+   },
+   "table_rows": {
+    "MESAS": 0,
+    "R000002": 1,
+    "RECEITA_INGREDIENTES": 0,
+    "DELIVERY_M": 0,
+    "C000051": 0,
+    "NFCE": 48872,
+    "NFCE_ITENS": 121266,
+    "C000032": 1582133,
+    "C000062": 1170,
+    "C000088": 0,
+    "C000100": 8942,
+    "C000030": 590,
+    "C000061": 82
+   },
+   "error": null
+  }
+ ]
+}

docs/NCM_HISTORICAL_RECONCILIATION_V1.json

@@ -0,0 +1,173 @@
+{
+ "artifact": "NCM_HISTORICAL_RECONCILIATION_V1",
+ "firebird_writes": 0,
+ "items_with_ncm": 4668,
+ "items_joined_to_product": 2917,
+ "orphan_items_no_product": 1751,
+ "mismatches_total": 1676,
+ "mismatches_in_initial_sample_5000": 1671,
+ "classification": {
+  "BAD_JOIN": 1661,
+  "UNKNOWN": 11,
+  "TRUE_HISTORICAL_DIFFERENCE": 4
+ },
+ "reasons": {
+  "BAD_JOIN|SYSTEMIC_WINDOW_2022-12": 1565,
+  "BAD_JOIN|SYSTEMIC_WINDOW_2024-01": 40,
+  "BAD_JOIN|SYSTEMIC_WINDOW_2025-12": 32,
+  "BAD_JOIN|ALT_PRODUCT_WITH_SAME_NCM_AND_PRICE": 24,
+  "UNKNOWN|ITEM_NCM_NOT_VALID_IN_NCM_DATASET": 11,
+  "TRUE_HISTORICAL_DIFFERENCE|ISOLATED_DIFFERENCE_PRODUCT_OTHERWISE_CONSISTENT_UNPROVEN_CAUSE": 4
+ },
+ "systemic_bad_join_windows": {
+  "2022-12": {
+   "matches": 47,
+   "mismatches": 1565
+  },
+  "2024-01": {
+   "matches": 28,
+   "mismatches": 40
+  },
+  "2025-12": {
+   "matches": 20,
+   "mismatches": 32
+  }
+ },
+ "window_rule": "month with >= 50% NCM disagreement is treated as a systemic bad-join window",
+ "mismatches_by_month": {
+  "2022-12": 1565,
+  "2023-11": 4,
+  "2024-01": 40,
+  "2024-02": 5,
+  "2024-03": 26,
+  "2025-05": 2,
+  "2025-12": 32,
+  "2026-03": 2
+ },
+ "examples": {
+  "BAD_JOIN": [
+   {
+    "nfce_item_id": 30641,
+    "product": "000280",
+    "product_desc": "CAJU M/ JARRA",
+    "product_ncm": "20099000",
+    "item_ncm": "19022000",
+    "date": "2022-12-01",
+    "reason": "SYSTEMIC_WINDOW_2022-12"
+   },
+   {
+    "nfce_item_id": 30642,
+    "product": "000280",
+    "product_desc": "CAJU M/ JARRA",
+    "product_ncm": "20099000",
+    "item_ncm": "19022000",
+    "date": "2022-12-01",
+    "reason": "SYSTEMIC_WINDOW_2022-12"
+   },
+   {
+    "nfce_item_id": 30643,
+    "product": "000058",
+    "product_desc": "PAO DE ALHO",
+    "product_ncm": "19059010",
+    "item_ncm": "22030000",
+    "date": "2022-12-01",
+    "reason": "SYSTEMIC_WINDOW_2022-12"
+   },
+   {
+    "nfce_item_id": 30644,
+    "product": "000058",
+    "product_desc": "PAO DE ALHO",
+    "product_ncm": "19059010",
+    "item_ncm": "22030000",
+    "date": "2022-12-01",
+    "reason": "SYSTEMIC_WINDOW_2022-12"
+   }
+  ],
+  "UNKNOWN": [
+   {
+    "nfce_item_id": 34122,
+    "product": "000792",
+    "product_desc": "MOUSE GTI",
+    "product_ncm": "84716053",
+    "item_ncm": "00000000",
+    "date": "2023-11-29",
+    "reason": "ITEM_NCM_NOT_VALID_IN_NCM_DATASET"
+   },
+   {
+    "nfce_item_id": 34123,
+    "product": "000792",
+    "product_desc": "MOUSE GTI",
+    "product_ncm": "84716053",
+    "item_ncm": "00000000",
+    "date": "2023-11-29",
+    "reason": "ITEM_NCM_NOT_VALID_IN_NCM_DATASET"
+   },
+   {
+    "nfce_item_id": 34130,
+    "product": "000783",
+    "product_desc": "LIXEIRA",
+    "product_ncm": "39229000",
+    "item_ncm": "11111111",
+    "date": "2023-11-29",
+    "reason": "ITEM_NCM_NOT_VALID_IN_NCM_DATASET"
+   },
+   {
+    "nfce_item_id": 34131,
+    "product": "000783",
+    "product_desc": "LIXEIRA",
+    "product_ncm": "39229000",
+    "item_ncm": "11111111",
+    "date": "2023-11-29",
+    "reason": "ITEM_NCM_NOT_VALID_IN_NCM_DATASET"
+   }
+  ],
+  "TRUE_HISTORICAL_DIFFERENCE": [
+   {
+    "nfce_item_id": 35574,
+    "product": "000700",
+    "product_desc": "TESTE ERRO NA EMISSÃO DA NFCE (136)",
+    "product_ncm": "62046200",
+    "item_ncm": "08043000",
+    "date": "2025-05-15",
+    "reason": "ISOLATED_DIFFERENCE_PRODUCT_OTHERWISE_CONSISTENT_UNPROVEN_CAUSE"
+   },
+   {
+    "nfce_item_id": 35576,
+    "product": "000700",
+    "product_desc": "TESTE ERRO NA EMISSÃO DA NFCE (136)",
+    "product_ncm": "62046200",
+    "item_ncm": "08043000",
+    "date": "2025-05-15",
+    "reason": "ISOLATED_DIFFERENCE_PRODUCT_OTHERWISE_CONSISTENT_UNPROVEN_CAUSE"
+   },
+   {
+    "nfce_item_id": 35684,
+    "product": "000700",
+    "product_desc": "TESTE ERRO NA EMISSÃO DA NFCE (136)",
+    "product_ncm": "62046200",
+    "item_ncm": "08043000",
+    "date": "2026-03-17",
+    "reason": "ISOLATED_DIFFERENCE_PRODUCT_OTHERWISE_CONSISTENT_UNPROVEN_CAUSE"
+   },
+   {
+    "nfce_item_id": 35686,
+    "product": "000700",
+    "product_desc": "TESTE ERRO NA EMISSÃO DA NFCE (136)",
+    "product_ncm": "62046200",
+    "item_ncm": "08043000",
+    "date": "2026-03-17",
+    "reason": "ISOLATED_DIFFERENCE_PRODUCT_OTHERWISE_CONSISTENT_UNPROVEN_CAUSE"
+   }
+  ]
+ },
+ "technical_bugs_found": {
+  "normalization": 0,
+  "note": "0 => no code bug; the mismatches are data-identity problems (CODPRODUTO does not reliably identify the product in 2022-12 and a few other windows)."
+ },
+ "trusted_corpus": {
+  "definition": "NFC-e item with NCM present, product exists, item NCM == product NCM (identity proof), 8-digit NCM, month not a systemic window",
+  "TRUSTED_HISTORICAL_ITEMS": 1146,
+  "excluded_matches_in_windows": 95,
+  "items_without_ncm_not_trusted": 30278
+ }
+}

docs/NEXT_FISCAL_AUTOMATION_PRIORITIES_V1.md

@@ -0,0 +1,23 @@
+# NEXT_FISCAL_AUTOMATION_PRIORITIES_V1
+
+Generated by `scripts/run_fiscal_decision_v1.py` from `docs/FISCAL_DECISION_COVERAGE_V1.json` (521 products).
+Ordering is mechanical: AUTO_APPLY_SAFE desc, CHANGE_REQUIRED desc, RESOLVED_PRODUCTS desc, candidates desc.
+
+| FIELD | RESOLVED_PRODUCTS | CHANGE_REQUIRED | AUTO_APPLY_SAFE | CANDIDATES | OP_CONTEXT_REQUIRED | BLOCKER | NEXT_ACTION |
+|---|---|---|---|---|---|---|---|
+| NCM | 495 | 0 | 0 | 26 | 0 | NCM_VALID_SAME_VALUE | Review LEGACY/INVALID NCMs manually (no unambiguous successor); never auto-change. |
+| IPI | 107 | 0 | 0 | 71 | 0 | TIPI_RATE_SOURCE_BLANK | Keep auto-apply; NON_NUMERIC/blank TIPI rows need a business decision on how ERP represents NT. |
+| MVA | 31 | 0 | 0 | 237 | 0 | MVA_NOT_APPLICABLE_NO_BA_ANNEX1_ENTRY_FOR_NCM | Confirm CEST first; then identify the ERP destination field for MVA (none proven). |
+| ORIGEM | 0 | 0 | 0 | 521 | 0 | ORIGIN_ONLY_FROM_ERP_CST_FIRST_DIGIT_NO_OBJECTIVE_PRODUCT_ORIGIN | Obtain objective product origin (supplier/import flag) before any write; ERP CST prefix is not proof. |
+| EX_TIPI | 0 | 0 | 0 | 71 | 0 | NO_EX_TIPI_FOR_NCM | Propose only when a single concrete EX applies; needs product-description evidence. |
+| CEST | 0 | 0 | 0 | 15 | 0 | CEST_DESCRIPTION_SCORE_BELOW_THRESHOLD | Improve description evidence per candidate group (do not lower threshold); manual review queue for candidates. |
+| CFOP | 0 | 0 | 0 | 0 | 521 | CFOP_DEPENDS_ON_OPERATION_DIRECTION_UF_ST_PURPOSE | Requires operation context (direction, destination UF, ST, purpose) — capture it at document level. |
+| COFINS_CST | 0 | 0 | 0 | 0 | 521 | CST_PIS_COFINS_DEPENDS_ON_OPERATION_AND_INCIDENCE_NO_DETERMINISTIC_RULE_IN_CORE_DATASETS | Same as PIS_CST. |
+| CSOSN | 0 | 0 | 0 | 0 | 521 | CSOSN_DEPENDS_ON_SALE_SCENARIO_ST_RETENTION_CONSUMER | Requires sale scenario/ST retention context; consider per-product default review for ST-annex NCMs. |
+| CST_ICMS | 0 | 0 | 0 | 0 | 521 | CRT1_USES_CSOSN_CST_DEPENDS_ON_OPERATION | Not used under CRT=1; only relevant if the client changes regime. |
+| FCP | 0 | 0 | 0 | 0 | 521 | FCP_APPLICABILITY_DEPENDS_ON_DESTINATION_UF_OPERATION_AND_ITEM_LIST | Needs destination UF + operation + BA FCP item list per NCM. |
+| PIS_COFINS_RATE | 0 | 0 | 0 | 0 | 0 | NO_RATE_SOURCE_4_3_10_17_DEFERRED_NEVER_ASSUME_ZERO | Needs source tables (deferred); never assume 0%. |
+| PIS_CST | 0 | 0 | 0 | 0 | 521 | CST_PIS_COFINS_DEPENDS_ON_OPERATION_AND_INCIDENCE_NO_DETERMINISTIC_RULE_IN_CORE_DATASETS | Needs regime+incidence rule table (deferred 4.3.x) — measure need from client data first. |
+| RTC_CBS_RATE | 0 | 0 | 0 | 0 | 521 | CBS_2026_RATE_APPLIES_ONLY_AFTER_CCLASSTRIB_RESOLVED_NOT_UNIVERSAL | Blocked by cClassTrib; apply 0.009 only where the official rule applies. |
+| RTC_CCLASSTRIB | 0 | 0 | 0 | 0 | 521 | NO_NCM_TO_CCLASSTRIB_MAP_IN_ACTIVE_DATASETS_AND_DEPENDS_ON_OPERATION | Needs official NCM->annex/cClassTrib mapping (LC 214 annexes) — not in acquired datasets. |
+| RTC_CCREDPRES | 0 | 0 | 0 | 0 | 0 | OFFICIAL_CONDITION_NOT_SATISFIED_OR_NOT_KNOWABLE_FROM_PRODUCT | Official conditions not derivable from product data. |

docs/NEXT_FISCAL_FIELD_IMPLEMENTATION_V1.md

@@ -0,0 +1,20 @@
+# 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.

docs/NEXT_FISCAL_FIELD_IMPLEMENTATION_V2.md

@@ -0,0 +1,13 @@
+# NEXT_FISCAL_FIELD_IMPLEMENTATION_V2
+
+Mechanical ordering: mapping confirmed, rule available, context available, products affected, history validation, auto-apply possible (post PRODUCT DEFAULTS V1).
+
+| FIELD | ERP_MAPPING | CONTEXT_AVAILABLE | RULE_AVAILABLE | POTENTIAL_PRODUCTS | HISTORICAL_VALIDATION | NEXT_ACTION |
+|---|---|---|---|---|---|---|
+| CFOP | CONFIRMED (HIGH) | PARTIAL | YES (ST family) | 251 | trusted history available | AUTO_APPLY_SAFE=0; review the ST conflicts. |
+| CSOSN | CONFIRMED (HIGH) | NO | NO (treatment/retention sources missing) | 495 | trusted history available | Acquire retention/treatment evidence. |
+| CST | CONFIRMED (MEDIUM) | YES | n/a (reference only, CRT=1) | 521 | trusted history 100% | No write needed. |
+| CEST | CONFIRMED (HIGH) | YES | PARTIAL | 15 | weak (1/15 supported) | Description-evidence review of 15 candidates. |
+| IPI | CONFIRMED (HIGH) | YES | YES | 107 | n/a | Maintained; already reconciled. |
+
+Blocking inputs and affected counts: `docs/FISCAL_CONTEXT_REQUIREMENTS_V2.json`.

docs/NEXT_FISCAL_FIELD_IMPLEMENTATION_V3.md

@@ -0,0 +1,12 @@
+# NEXT_FISCAL_FIELD_IMPLEMENTATION_V3
+
+Mechanical ordering: mapping confirmed, rule available, context available, products affected, history validation, auto-apply possible.
+
+| FIELD | ERP_MAPPING | CONTEXT_AVAILABLE | RULE_AVAILABLE | POTENTIAL_PRODUCTS | HISTORICAL_VALIDATION | NEXT_ACTION |
+|---|---|---|---|---|---|---|
+| CSOSN | CONFIRMED (HIGH) | NO (retention + ICMS treatment missing) | PARTIAL (ST→500 rule needs withholding proof) | 495 | trusted 1146 items | Acquire supplier ST retention evidence; get accountant decision on 102 vs 400 |
+| CEST | CONFIRMED (HIGH) | PARTIAL | PARTIAL | 268 | weak | CEST fill/confirm drives ST_CONFIRMED |
+| CFOP | CONFIRMED (HIGH) | PARTIAL | YES (ST family) | 29 conflicts | trusted history | Depends on ST_CONFIRMED + retention |
+| IPI | CONFIRMED (HIGH) | YES | YES | 107 | n/a | Maintained |
+
+Blocking inputs with counts: `docs/FISCAL_CONTEXT_REQUIREMENTS_V3.json`.

docs/OPERATIONS.md

@@ -0,0 +1,162 @@
+# GTI Fiscal Hub + Agent — Operations Guide
+
+Living document. Update it when the architecture or operational flow changes;
+keep `docs/AI_PROJECT_STATE.md` as the short factual snapshot, this file as
+the "how do I actually run it" reference.
+
+## RC1 operational notes (1.0.0-rc1)
+
+- **Versions:** `release/VERSION`, `central/app/version.py` (`GTI_FISCAL_VERSION`), `GET /version`, `release/RELEASE_MANIFEST.json` (`python scripts/release_manifest.py <token>`: release, agent, engine/decision versions, ACTIVE dataset hashes, migrations head/applied). A release bump never changes fiscal semantics.
+- **Modes:** `FISCAL_MODE=DRY_RUN` makes writes technically impossible (Config.firebird_writes is false, `open_write_connection` refuses, the executor is never called) regardless of `FIREBIRD_WRITES`. `AUTO_APPLY` additionally needs the two pilot authorization layers (`AUTHORIZED_WRITE_DATABASE_PATH`, `EXPECTED_SCHEMA_FINGERPRINT`) and is NOT part of RC1 pilots.
+- **REPROCESS_ALL result** (stored by the Hub in the job's `result_summary`): counts of products and, in `coverage`, NCM/IPI/CEST/CFOP/CSOSN/ST/role metrics plus `company_context` (masked CNPJ, UF, CRT, source of truth).
+- **Company context:** `python agent/scripts/preflight_company_context.py` for the resolver alone; rules in `docs/AGENT_COMPANY_CONTEXT_RULES_V1.md`.
+- **Known follow-up (not RC1):** `dataset_versions()` runs ~11 queries per classification request and dominates the ~15 ms cache-hit latency; it can be memoized/cached later.
+
+## Architecture
+
+```
+Firebird (client ERP, TESTESOFICIAIS.FDB in dev)
+        │  read-only SELECT (always)
+        ▼
+   Agent (agent/)                    Hub (central/) ── PostgreSQL
+   - reads C000025                   - classify NCM/CEST/TIPI/BA_ST_MVA
+   - polls Hub for Jobs   ────HTTP──▶ - owns Job queue + Agent registry
+   - runs dry-run + guarded          - never touches Firebird, never
+     IPI write locally                 stores Firebird credentials
+   - writes only to the same
+     Firebird it read from (only
+     when FIREBIRD_WRITES=1 and
+     the path is the authorized
+     disposable test database)
+```
+
+The Hub never has Firebird credentials and never connects to any ERP
+database. All Firebird reads/writes happen inside the Agent process, on the
+machine where the ERP database lives.
+
+## Bring up Hub + Postgres
+
+```bash
+docker compose up -d postgres fiscal-hub
+curl http://localhost:8000/health
+```
+
+The `fiscal-hub` container runs `alembic upgrade head` on startup, so schema
+migrations apply automatically. Check `docker compose logs fiscal-hub` if it
+doesn't come up healthy.
+
+## Agent configuration
+
+Copy `.env.example` to `.env` locally (never commit it — already gitignored)
+and set:
+
+| Variable | Meaning |
+|---|---|
+| `GTI_HUB_URL` | Hub base URL, e.g. `http://localhost:8000` (falls back to `HUB_URL` for backward compatibility) |
+| `AGENT_TOKEN` | Bearer token identifying this Agent (falls back to `AGENT_DEV_TOKEN` in dev) |
+| `AGENT_ID` | Informational identifier for this Agent instance (the Hub derives the real identity from the token) |
+| `COMPANY_ID` / `COMPANY_UF` | Which client/company this Agent instance serves (informational, for logs/heartbeat) |
+| `FIREBIRD_DATABASE_PATH` | Absolute path to the client's `.FDB` file |
+| `FB_USER` / `FB_PASSWORD` | Firebird credentials — **local only, never sent to the Hub** |
+| `FIREBIRD_WRITES` | `0` (default, required) or `1`. See "Write safety" below. |
+| `POLL_INTERVAL_SECONDS` | How long to sleep when there's no pending Job (default `5`) |
+| `AGENT_VERSION` | Reported in heartbeats/job results |
+
+## Registering an Agent
+
+There's no separate "register" endpoint yet — an Agent is created the first
+time its bearer token is used against the Hub (`bootstrap` in
+`central/app/auth.py`), the same mechanism `/v1/classify` already used. Set
+`AGENT_TOKEN`/`AGENT_DEV_TOKEN` to a value only this Agent knows and the Hub
+will create the Agent record on first contact.
+
+## Starting the Agent
+
+```bash
+cd agent
+python scripts/run_agent_service.py
+```
+
+On startup it prints one line confirming Hub and Firebird connectivity, then
+loops forever: heartbeat → poll for a Job → claim → execute → report →
+sleep or poll again. `Ctrl+C` (SIGINT) or SIGTERM stops it after the current
+iteration finishes.
+
+For a bounded run (useful for scripting/tests), pass `--max-iterations N`.
+
+## Creating work
+
+```bash
+# Reprocess everything this Agent can see in C000025
+curl -X POST $GTI_HUB_URL/v1/jobs \
+  -H "Authorization: Bearer $AGENT_TOKEN" -H "Content-Type: application/json" \
+  -d '{"kind": "REPROCESS_ALL"}'
+
+# Reprocess a specific list of CODIGOs
+curl -X POST $GTI_HUB_URL/v1/jobs \
+  -H "Authorization: Bearer $AGENT_TOKEN" -H "Content-Type: application/json" \
+  -d '{"kind": "REPROCESS_PRODUCTS", "payload": {"codigos": ["000026", "000027"]}}'
+```
+
+Both return the Job in `PENDING` status. The Agent that owns that token is
+the only one that will ever see or claim it — `GET /v1/jobs/next` only
+returns `PENDING` jobs whose `agent_id` matches the caller.
+
+## Checking status
+
+```bash
+curl $GTI_HUB_URL/v1/jobs/<job_id> -H "Authorization: Bearer $AGENT_TOKEN"
+```
+
+`status` is one of `PENDING`, `RUNNING`, `COMPLETED`, `FAILED`. A completed
+job's `result_summary` has `products_processed`, `writes_attempted`,
+`writes_succeeded`, `writes_failed`, `no_ops`, plus `agent_id` and
+`schema_fingerprint`. A failed job's `error` is a sanitized (truncated,
+no-secrets) message; the Agent keeps polling afterwards.
+
+## Heartbeat
+
+Every poll cycle the Agent calls `POST /v1/agents/heartbeat` with its
+status (`IDLE`/`BUSY`), `schema_fingerprint`, and `agent_version`. The Hub
+updates `agents.last_seen_at`, `last_status`, `schema_fingerprint`,
+`agent_version`. Check it's alive with:
+
+```sql
+SELECT id, name, last_seen_at, last_status, agent_version FROM agents;
+```
+
+## Write safety: FIREBIRD_WRITES
+
+- `FIREBIRD_WRITES=0` (the required default): the Agent classifies every
+  product, builds the dry-run decision, and logs what it *would* write —
+  but issues no `UPDATE`. Jobs still complete normally.
+- `FIREBIRD_WRITES=1`: the Agent also auto-applies `C000025.IPI` when the
+  proposal is unambiguous (`rate_kind=NUMERIC`, `write_eligible=true`).
+  Before opening any write connection, it verifies the configured
+  `FIREBIRD_DATABASE_PATH` is **exactly**
+  `D:\PROJETOS\GTISISTEMAS\Projeto\TESTESOFICIAIS.FDB` (see
+  `scripts/firebird_write_executor.py::assert_authorized_write_path`) and
+  fails closed — no connection opened, no job attempted — if it isn't.
+  See `CLAUDE.md`'s "Firebird write policy" for the full policy; this is
+  the only database ever authorized for writes.
+- Auto-apply never touches CEST, EX_TIPI, CFOP, CST/CSOSN, PIS/COFINS, or
+  MVA. Those remain measurement-only.
+
+## Where logs/audits live
+
+- **Central audit** (coarse, per Job): Postgres `jobs.result_summary` —
+  counts only, queryable via `GET /v1/jobs/{id}`.
+- **Local audit** (detailed, per product per attempt): the Agent's SQLite
+  file (`agent/agent_state.sqlite` by default, override with
+  `AGENT_STATE_DB`), table `ipi_write_log` — one row per product per Job
+  run, with before/after values, write status, and reason code. Table
+  `product_state`/`outbox` still tracks the classify-request dedup from the
+  original manual runner; `ipi_write_log` is independent of it.
+
+## Running as a Windows Service (future)
+
+`run_agent_service.py`'s `main()` is a plain, blocking, signal-aware loop —
+suitable to wrap with `pywin32`'s `win32serviceutil.ServiceFramework` (call
+`main()` or `run()` from `SvcDoRun`, use `SvcStop` to flip the same
+`GracefulStop` flag). No installer is built yet; this is a follow-up task,
+not part of this MVP.

docs/OPERATOR_COMPANY_QUESTIONS_V1.md

@@ -0,0 +1,127 @@
+# Perguntas de empresa — respostas necessárias ANTES da camada de IA
+
+Só entram decisões que valem para a **empresa inteira**. Nada aqui é preenchido automaticamente: sem resposta, as células continuam pendentes.
+Como responder: preencher a coluna `VALUE` da linha do mesmo QUESTION_ID em `docs/LOCAL_FISCAL_CONTEXT_QUESTIONS_V2.csv` e importar com `scripts/import_fiscal_context.py`.
+
+## 1. Perfil de PIS/COFINS (por empresa)
+### Q0003 — RINCAO (Regime normal (Lucro Presumido/Real))
+- **Pergunta:** Qual o enquadramento de PIS/COFINS desta empresa para produtos que NÃO estão em regime especial (monofásico, alíquota zero, etc.)?
+- **Opções:** JSON com pis_in_cst, pis_out_cst, pis_rate, cofins_in_cst, cofins_out_cst, cofins_rate (CSTs da tabela oficial 4.3.3/4.3.4). Ex. regime não cumulativo: saída 01, alíquotas 1,65 / 7,6; cumulativo: 0,65 / 3,0
+- **Recomendação:** nenhuma provada (depende do regime tributário real da empresa: cumulativo ou não cumulativo, dado que só o contador confirma)
+- **Produtos afetados:** 894
+- **Células afetadas:** 5362
+- **Explicação:** A tabela oficial da Receita já resolveu os produtos em regime especial; os demais dependem do enquadramento da empresa. Nesta base o SGV não usa estes campos na emissão (100% dos itens de NFC-e saíram sem CST de PIS/COFINS); a resposta só completa poucos produtos com valor inválido no cadastro.
+
+### Q0005 — TESTESOFICIAIS (Simples Nacional)
+- **Pergunta:** Qual o enquadramento de PIS/COFINS desta empresa para produtos que NÃO estão em regime especial (monofásico, alíquota zero, etc.)?
+- **Opções:** JSON com pis_in_cst, pis_out_cst, pis_rate, cofins_in_cst, cofins_out_cst, cofins_rate (CSTs da tabela oficial 4.3.3/4.3.4). Ex. regime não cumulativo: saída 01, alíquotas 1,65 / 7,6; cumulativo: 0,65 / 3,0
+- **Recomendação:** nenhuma provada (depende do regime tributário real da empresa: cumulativo ou não cumulativo, dado que só o contador confirma)
+- **Produtos afetados:** 520
+- **Células afetadas:** 3116
+- **Explicação:** A tabela oficial da Receita já resolveu os produtos em regime especial; os demais dependem do enquadramento da empresa. O histórico de NFC-e desta base emite CST de PIS/COFINS preenchido, então o campo do produto é usado na emissão.
+
+### Q0516 — UNIAO (Simples Nacional)
+- **Pergunta:** Qual o enquadramento de PIS/COFINS desta empresa para produtos que NÃO estão em regime especial (monofásico, alíquota zero, etc.)?
+- **Opções:** JSON com pis_in_cst, pis_out_cst, pis_rate, cofins_in_cst, cofins_out_cst, cofins_rate (CSTs da tabela oficial 4.3.3/4.3.4). Ex. regime não cumulativo: saída 01, alíquotas 1,65 / 7,6; cumulativo: 0,65 / 3,0
+- **Recomendação:** nenhuma provada (depende do regime tributário real da empresa: cumulativo ou não cumulativo, dado que só o contador confirma)
+- **Produtos afetados:** 3
+- **Células afetadas:** 4
+- **Explicação:** A tabela oficial da Receita já resolveu os produtos em regime especial; os demais dependem do enquadramento da empresa. Nesta base o SGV não usa estes campos na emissão (100% dos itens de NFC-e saíram sem CST de PIS/COFINS); a resposta só completa poucos produtos com valor inválido no cadastro.
+
+## 2. Escopo das compras (CFOP de entrada)
+### Q0008 — RINCAO
+- **Pergunta:** As compras de mercadoria desta empresa são, em regra, dentro do estado (INTRA, CFOP 1xxx) ou de outro estado (INTER, CFOP 2xxx)?
+- **Opções:** INTRA | INTER
+- **Recomendação:** nenhuma provada. Só informativo: nos cadastros existentes desta base, CFOP de entrada 1xxx = 1, 2xxx = 0, vazio = 891 de 894 produtos (declarações históricas, não prova de regra)
+- **Produtos afetados:** 667
+- **Células afetadas:** 667
+- **Explicação:** Só é usado nos produtos cujo CFOP de entrada está vazio. Produtos que já têm CFOP de entrada válido não são alterados.
+
+### Q0012 — TESTESOFICIAIS
+- **Pergunta:** As compras de mercadoria desta empresa são, em regra, dentro do estado (INTRA, CFOP 1xxx) ou de outro estado (INTER, CFOP 2xxx)?
+- **Opções:** INTRA | INTER
+- **Recomendação:** nenhuma provada. Só informativo: nos cadastros existentes desta base, CFOP de entrada 1xxx = 0, 2xxx = 0, vazio = 521 de 521 produtos (declarações históricas, não prova de regra)
+- **Produtos afetados:** 242
+- **Células afetadas:** 242
+- **Explicação:** Só é usado nos produtos cujo CFOP de entrada está vazio. Produtos que já têm CFOP de entrada válido não são alterados.
+
+### Q0013 — UNIAO
+- **Pergunta:** As compras de mercadoria desta empresa são, em regra, dentro do estado (INTRA, CFOP 1xxx) ou de outro estado (INTER, CFOP 2xxx)?
+- **Opções:** INTRA | INTER
+- **Recomendação:** nenhuma provada. Só informativo: nos cadastros existentes desta base, CFOP de entrada 1xxx = 8540, 2xxx = 247, vazio = 3 de 8942 produtos (declarações históricas, não prova de regra)
+- **Produtos afetados:** 192
+- **Células afetadas:** 192
+- **Explicação:** Só é usado nos produtos cujo CFOP de entrada está vazio. Produtos que já têm CFOP de entrada válido não são alterados.
+
+### Q0021 — MMMODAS
+- **Pergunta:** As compras de mercadoria desta empresa são, em regra, dentro do estado (INTRA, CFOP 1xxx) ou de outro estado (INTER, CFOP 2xxx)?
+- **Opções:** INTRA | INTER
+- **Recomendação:** nenhuma provada. Só informativo: nos cadastros existentes desta base, CFOP de entrada 1xxx = 4177, 2xxx = 16733, vazio = 30 de 20996 produtos (declarações históricas, não prova de regra)
+- **Produtos afetados:** 110
+- **Células afetadas:** 110
+- **Explicação:** Só é usado nos produtos cujo CFOP de entrada está vazio. Produtos que já têm CFOP de entrada válido não são alterados.
+
+### Q0067 — CONSTRUCAO
+- **Pergunta:** As compras de mercadoria desta empresa são, em regra, dentro do estado (INTRA, CFOP 1xxx) ou de outro estado (INTER, CFOP 2xxx)?
+- **Opções:** INTRA | INTER
+- **Recomendação:** nenhuma provada. Só informativo: nos cadastros existentes desta base, CFOP de entrada 1xxx = 3270, 2xxx = 431, vazio = 7 de 3712 produtos (declarações históricas, não prova de regra)
+- **Produtos afetados:** 26
+- **Células afetadas:** 26
+- **Explicação:** Só é usado nos produtos cujo CFOP de entrada está vazio. Produtos que já têm CFOP de entrada válido não são alterados.
+
+## 3. Alíquota padrão de ICMS
+### Q0821 — RINCAO
+- **Pergunta:** Qual a alíquota interna de ICMS padrão desta empresa (regime normal)?
+- **Opções:** número em % (ex.: 20,5)
+- **Recomendação:** nenhuma provada (a alíquota depende da mercadoria; não vale 20,5% universal)
+- **Produtos afetados:** 1
+- **Células afetadas:** 1
+- **Explicação:** Um único produto da base de testes depende desta resposta. As demais empresas são Simples Nacional e não destacam ICMS: não perguntado.
+
+## 4. IPI no cadastro de empresa varejista (STORE_IPI_PROFILE)
+Evidência do próprio SGV: em TODAS as bases `CONTRIBUINTE_IPI = N`; 745 itens vendidos na base de testes de produtos com alíquota de IPI cadastrada geraram IPI = 0 (nenhum valor de IPI foi calculado), e mais de 1,6 milhão de itens vendidos nas demais bases também têm IPI 0. O campo do cadastro é, portanto, apenas referência para empresa não contribuinte. **O SGV não impõe preencher.** Decisão de política:
+
+### QIPI-CONSTRUCAO — CONSTRUCAO
+- **Pergunta:** Guardar no cadastro dos produtos a alíquota oficial da TIPI como referência (mesmo a empresa não sendo indústria/importadora)?
+- **Opções:** `POPULATE_REFERENCE_RATE` (guardar) | `LEAVE_NOT_APPLICABLE` (deixar em branco)
+- **Recomendação:** nenhuma (é política da empresa; ambas as opções são válidas)
+- **Produtos afetados:** 1497
+- **Células afetadas:** 1497 (já gravadas com o valor oficial; se responder LEAVE_NOT_APPLICABLE, serão revertidas com `scripts/rollback_field.py`)
+- **Explicação:** enquanto não houver resposta, nenhum novo valor de IPI é gravado. Chave: `store_ipi_profile` (escopo COMPANY).
+
+### QIPI-MMMODAS — MMMODAS
+- **Pergunta:** Guardar no cadastro dos produtos a alíquota oficial da TIPI como referência (mesmo a empresa não sendo indústria/importadora)?
+- **Opções:** `POPULATE_REFERENCE_RATE` (guardar) | `LEAVE_NOT_APPLICABLE` (deixar em branco)
+- **Recomendação:** nenhuma (é política da empresa; ambas as opções são válidas)
+- **Produtos afetados:** 1947
+- **Células afetadas:** 1947 (já gravadas com o valor oficial; se responder LEAVE_NOT_APPLICABLE, serão revertidas com `scripts/rollback_field.py`)
+- **Explicação:** enquanto não houver resposta, nenhum novo valor de IPI é gravado. Chave: `store_ipi_profile` (escopo COMPANY).
+
+### QIPI-RINCAO — RINCAO
+- **Pergunta:** Guardar no cadastro dos produtos a alíquota oficial da TIPI como referência (mesmo a empresa não sendo indústria/importadora)?
+- **Opções:** `POPULATE_REFERENCE_RATE` (guardar) | `LEAVE_NOT_APPLICABLE` (deixar em branco)
+- **Recomendação:** nenhuma (é política da empresa; ambas as opções são válidas)
+- **Produtos afetados:** 349
+- **Células afetadas:** 349 (já gravadas com o valor oficial; se responder LEAVE_NOT_APPLICABLE, serão revertidas com `scripts/rollback_field.py`)
+- **Explicação:** enquanto não houver resposta, nenhum novo valor de IPI é gravado. Chave: `store_ipi_profile` (escopo COMPANY).
+
+### QIPI-UNIAO — UNIAO
+- **Pergunta:** Guardar no cadastro dos produtos a alíquota oficial da TIPI como referência (mesmo a empresa não sendo indústria/importadora)?
+- **Opções:** `POPULATE_REFERENCE_RATE` (guardar) | `LEAVE_NOT_APPLICABLE` (deixar em branco)
+- **Recomendação:** nenhuma (é política da empresa; ambas as opções são válidas)
+- **Produtos afetados:** 2469
+- **Células afetadas:** 2469 (já gravadas com o valor oficial; se responder LEAVE_NOT_APPLICABLE, serão revertidas com `scripts/rollback_field.py`)
+- **Explicação:** enquanto não houver resposta, nenhum novo valor de IPI é gravado. Chave: `store_ipi_profile` (escopo COMPANY).
+
+### QIPI-TESTESOFICIAIS — TESTESOFICIAIS
+- **Pergunta:** Guardar no cadastro dos produtos a alíquota oficial da TIPI como referência (mesmo a empresa não sendo indústria/importadora)?
+- **Opções:** `POPULATE_REFERENCE_RATE` (guardar) | `LEAVE_NOT_APPLICABLE` (deixar em branco)
+- **Recomendação:** nenhuma (é política da empresa; ambas as opções são válidas)
+- **Produtos afetados:** 107
+- **Células afetadas:** 107 (já gravadas com o valor oficial; se responder LEAVE_NOT_APPLICABLE, serão revertidas com `scripts/rollback_field.py`)
+- **Explicação:** enquanto não houver resposta, nenhum novo valor de IPI é gravado. Chave: `store_ipi_profile` (escopo COMPANY).
+
+## 5. Origem da mercadoria — NÃO é decisão de empresa
+A origem (0 a 8) é atributo real de cada mercadoria e o ERP não a registra em lugar nenhum (o primeiro dígito do CST é só preenchimento). **Não existe uma resposta padrão de empresa** e nenhum valor será assumido. Só responda por GRUPO/PRODUTO quando puder garantir (ex.: grupo inteiro de importados = 1). Essas perguntas continuam nos arquivos V2, fora desta lista.
+
+**Total desta lista: 14 perguntas de empresa.**

docs/PILOT_DEPLOYMENT.md

@@ -0,0 +1,330 @@
+# GTI Fiscal — Pilot Deployment Guide
+
+Living document for operating a real pilot: one Hub, one or more client
+Agent installations. See `docs/OPERATIONS.md` for the day-to-day command
+reference (creating jobs, checking status); this document is about getting a
+new environment stood up and kept alive.
+
+## RC1 (1.0.0-rc1) — supported path
+
+```
+Hub central (Docker: Hub + PostgreSQL, deploy/hub)
+        ^   HTTPS (TLS terminated by a reverse proxy)
+        |
+Agent Windows (service "GTIFiscalAgent", deploy/agent-windows)
+        |   local read-only connection
+SGV Firebird (the client's C000025 / C000004)
+```
+
+The Hub **never** accesses Firebird, never stores Firebird credentials and never holds the client's database path. Only the Agent, on the client's Windows host, opens
+Firebird. RC1 pilots run `FISCAL_MODE=DRY_RUN` + `FIREBIRD_WRITES=0`: the Agent is technically unable to write (no write connection is ever opened, the executor is never called).
+
+### Hub (GTI infrastructure)
+1. `cd deploy/hub && cp .env.example .env` — set `POSTGRES_PASSWORD` (`openssl rand -hex 24`), `BASE_URL` (public HTTPS URL). Leave `HUB_BIND=127.0.0.1` and publish it through the reverse proxy.
+2. `docker compose -f docker-compose.prod.yml --env-file .env up -d --build` — PostgreSQL (internal network only, persistent volume, healthcheck), Hub (migrations at start, healthcheck, `restart: unless-stopped`, json-file logs 10 MB x 5).
+3. Seed the validated datasets once: on the development machine `sh export_datasets_seed.sh > gti_datasets_seed.dump`; on the Hub host `sh seed_datasets.sh gti_datasets_seed.dump` (refuses if `datasets` is not empty; reference tables only, never tenants/agents/jobs).
+4. Register the Agent: `docker compose -f docker-compose.prod.yml exec fiscal-hub python central/scripts/register_agent.py --company "<Client>" --name "<installation>"` — the token is printed once; store it only in the Agent's local `.env`.
+5. Health: `GET /health` (Postgres included), `GET /version` (release/engine/decision versions). `APP_ENV=production` refuses to start when `AGENT_DEV_TOKEN` is set.
+6. Backup/restore: `sh backup.sh` (pg_dump -Fc into `BACKUP_DIR`, keeps 14) and `sh restore.sh <dump>` (asks for the word RESTORE, stops the Hub, restores, restarts; migrations rerun at start).
+
+### Agent (client host, PowerShell as Administrator, inside the extracted `GTIFiscalAgent-1.0.0-rc1` folder)
+Build the package on the release machine: `python scripts/build_agent_package.py` -> `dist/GTIFiscalAgent-1.0.0-rc1.zip` (+ `.sha256`; secret-scanned, no `.env`).
+
+| step | command |
+|---|---|
+| install | `.\gti-agent.ps1 install` (venv + dependencies + service registration; does not start) |
+| configure | `.\gti-agent.ps1 configure` (prompts; secrets never echoed) or `configure -FromTemplate .\pilot-construcao.env.example` |
+| preflight | `.\gti-agent.ps1 preflight` -> `PREFLIGHT=PASS|FAIL` + blockers |
+| start / stop / restart | `.\gti-agent.ps1 start` (refuses when preflight fails) |
+| status | `.\gti-agent.ps1 status` |
+| uninstall | `.\gti-agent.ps1 uninstall [-Purge]` |
+
+### Agent configuration (per installation, `.env` in the install folder)
+`GTI_HUB_URL`, `AGENT_ID`, `AGENT_TOKEN`; `COMPANY_CODE` / `COMPANY_CNPJ` (company selection), `COMPANY_CRT_SOURCE` = `AUTO` | `EMISSOR` | `C000004`; `COMPANY_UF` only as an explicit
+override (it never replaces the resolver: it must agree with what the database proves); `FIREBIRD_DATABASE_PATH`, `FB_USER` (read-only account), `FB_PASSWORD`; `FISCAL_MODE=DRY_RUN`, `FIREBIRD_WRITES=0`;
+`POLL_INTERVAL_SECONDS`, `AGENT_VERSION`. `AUTO` resolves the CRT only when EMISSOR and C000004 agree; a conflict makes the preflight FAIL until `EMISSOR` or `C000004` is chosen explicitly.
+The first row of C000004 is never used to pick the company.
+
+### Preflight (`agent/scripts/preflight.py`, also enforced at service start)
+HUB_REACHABLE, AUTH, HUB_VERSION_COMPATIBLE (major.minor), FIREBIRD_REACHABLE, FIREBIRD_VERSION_ODS, C000004, C000025, CAPABILITIES (required: NCM, IPI, CEST), COMPANY_CONTEXT (UF, CRT),
+SCHEMA_TYPE_GUARDS, SQLITE, LOG_DIRECTORY, FISCAL_MODE, FIREBIRD_WRITES (`DRY_RUN` + `FIREBIRD_WRITES=1` is a misconfiguration -> FAIL).
+
+### Pilot profiles
+`deploy/agent-windows/pilot-construcao.env.example` (first pilot: company 000001, UF BA, CRT 1, `COMPANY_CRT_SOURCE=AUTO`, DRY_RUN). Planned, **not installed**: `profiles/mmmodas|rincao|uniao.env.example`
+(`COMPANY_CRT_SOURCE=EMISSOR` required: EMISSOR and C000004 disagree on the CRT). Never reuse the path of a local database copy as the client's real path.
+
+### Zero-write proof
+`python scripts/prove_zero_write.py snapshot <FDB> before.json` ... run the pilot ... `snapshot <FDB> after.json` ... `compare before.json after.json` (database DML counters, SHA-256 of every row of C000025/C000004, row counts).
+
+---
+
+The sections below are the previous manual instructions (still accurate for development); the RC1 scripts above are the supported way to deploy.
+
+## Architecture
+
+```
+                         ┌────────────────────────────┐
+                         │  Hub server (GTI/Proxmox)  │
+                         │  Docker Compose:            │
+                         │   - postgres (data volume)  │
+                         │   - fiscal-hub (FastAPI)     │
+                         └─────────────┬────────────────┘
+                                       │ HTTPS (reverse proxy terminates TLS)
+              ┌────────────────────────┼────────────────────────┐
+              │                        │                        │
+    ┌─────────▼─────────┐    ┌─────────▼─────────┐    ┌─────────▼─────────┐
+    │ Client A — Agent   │    │ Client B — Agent   │    │ Client C — Agent   │
+    │ Windows Service    │    │ Windows Service    │    │ Windows Service    │
+    │ + local Firebird    │    │ + local Firebird    │    │ + local Firebird    │
+    │ + local SQLite audit│    │ + local SQLite audit│    │ + local SQLite audit│
+    └────────────────────┘    └────────────────────┘    └────────────────────┘
+```
+
+The Hub never has Firebird credentials and never opens a Firebird
+connection. Each Agent has its own token and only ever reads/writes the one
+Firebird database it was configured for.
+
+## Hub server requirements
+
+- Docker + Docker Compose v2.
+- Enough disk for the Postgres volume (starts small; grows with
+  `classification_cache`/`jobs` history — no large binary data).
+- One inbound port for the Hub API (default `8000`, or whatever your reverse
+  proxy forwards to it). Postgres itself does **not** need a host port —
+  `docker-compose.yml` intentionally does not publish `5432`; only containers
+  on the compose network reach it.
+
+## Deploying the Hub
+
+```bash
+git clone <repo> && cd Projeto
+cp .env.example .env
+# Edit .env: set a real POSTGRES_PASSWORD, leave AGENT_DEV_TOKEN empty,
+# set APP_ENV=production, BASE_URL to the public HTTPS URL.
+docker compose up -d postgres fiscal-hub
+curl http://localhost:8000/health   # {"status": "ok"}
+```
+
+`fiscal-hub`'s container command runs `alembic upgrade head` before starting
+`uvicorn`, so schema migrations apply automatically on every deploy/restart.
+Both services have `restart: unless-stopped` and Docker healthchecks
+(`pg_isready` for Postgres, an HTTP GET to `/health` for the Hub).
+
+**Never** put `AGENT_DEV_TOKEN` in a production `.env` — it auto-bootstraps
+an agent from a fixed shared token on every request, fine for local dev,
+wrong for a pilot with real client secrets. Leave it empty; register real
+Agents with `central/scripts/register_agent.py` (see below).
+
+### Persistence
+
+- Postgres data lives in the named volume `postgres_data`. Back it up with
+  `docker exec <postgres-container> pg_dump -U gti gti_fiscal > backup.sql`
+  (or `pg_dumpall` for the whole cluster) on whatever schedule your
+  operations policy requires.
+- Migrations are additive-only so far (`0001`..`0006`); always run
+  `alembic upgrade head` (the container does this automatically) rather than
+  hand-editing the schema.
+
+### HTTPS / reverse proxy
+
+The Hub itself speaks plain HTTP. For a pilot reachable outside the Hub's
+own host, put it behind a reverse proxy (nginx, Caddy, Traefik — whatever
+the GTI/Proxmox environment already standardizes on) that terminates TLS and
+forwards to `fiscal-hub:8000`. Nothing in the app assumes a particular
+proxy; `BASE_URL` in `.env` is informational only (not currently used to
+generate absolute links, but keep it accurate for anyone reading the config).
+
+## Registering an Agent (per client installation)
+
+Run once per Agent installation, from anywhere with access to Postgres —
+easiest is inside the running Hub container:
+
+```bash
+docker exec <fiscal-hub-container> python central/scripts/register_agent.py \
+  --company "Client Company Name" --name "loja-01"
+```
+
+This prints `AGENT_ID`, a freshly generated `AGENT_TOKEN` (shown once — copy
+it immediately), and `COMPANY_ID`. Only the token's SHA-256 hash is ever
+stored in Postgres (same `token_hash` mechanism `/v1/classify` already used
+— no new auth system). Each Agent gets its own token; one Agent's token
+never authenticates another Agent's jobs (`agent_id` is checked on every
+Job operation).
+
+## Configuring an Agent installation
+
+On the client machine, copy `agent/.env.example` to `agent/.env` and fill in
+the values from registration plus that machine's Firebird details:
+
+```
+GTI_HUB_URL=https://hub.example.com
+AGENT_ID=<from registration>
+AGENT_TOKEN=<from registration>
+COMPANY_ID=<from registration>
+COMPANY_UF=BA
+FIREBIRD_DATABASE_PATH=C:\ERP\dados\PRODUCAO.FDB
+FB_USER=...
+FB_PASSWORD=...
+FIREBIRD_WRITES=0
+POLL_INTERVAL_SECONDS=10
+AGENT_VERSION=0.1.0
+```
+
+**`FIREBIRD_WRITES` must default to `0`.** See "Write safety" below before
+ever setting it to `1`.
+
+## Installing the Agent as a Windows Service
+
+Requires `pywin32` (`pip install pywin32`, or `pip install -e ".[windows-service]"`
+from `agent/`).
+
+```powershell
+# From an elevated (Administrator) terminal, in agent/service/:
+python gti_agent_windows_service.py --startup=auto install
+python gti_agent_windows_service.py start
+
+# One-time, so Windows restarts it automatically after a crash:
+sc.exe failure "GTIFiscalAgent" reset= 86400 actions= restart/60000/restart/60000/restart/60000
+```
+
+`gti_agent_windows_service.py` is a thin wrapper: it does not reimplement
+polling, heartbeat, or the pipeline — it calls `run_agent_service.run()`
+directly, stopping it via the Service Control Manager's own stop signal
+instead of `SIGINT`/`SIGTERM` (which don't apply to services running with no
+console). See the module's docstring for the exact commands.
+
+### Install / configure / start / status / stop / restart / uninstall
+
+```powershell
+# Install (registers with SCM, Startup=Automatic)
+python gti_agent_windows_service.py --startup=auto install
+
+# Configure: edit agent/.env, no service restart needed until you `restart`
+notepad agent\.env
+
+# Start
+python gti_agent_windows_service.py start
+
+# Status
+sc.exe query GTIFiscalAgent
+
+# Stop
+python gti_agent_windows_service.py stop
+
+# Restart (picks up any agent/.env changes)
+python gti_agent_windows_service.py restart
+
+# Uninstall
+python gti_agent_windows_service.py stop
+python gti_agent_windows_service.py remove
+```
+
+### Updating the Agent's version
+
+1. Stop the service: `python gti_agent_windows_service.py stop`
+2. Replace the `agent/` code with the new version (git pull, or copy files).
+3. Bump `AGENT_VERSION` in `agent/.env` if you track it per-release.
+4. Start the service again: `python gti_agent_windows_service.py start`.
+5. Confirm the new version shows up via `GET /v1/agents/me` on the Hub.
+
+There is no auto-update mechanism yet (deliberately out of scope for this
+pilot) — updates are a manual stop/replace/start.
+
+### Running without installing as a service (dev/testing)
+
+```bash
+cd agent
+python scripts/run_agent_service.py                 # runs forever, Ctrl+C to stop
+python scripts/run_agent_service.py --max-iterations 5   # bounded, for scripting/tests
+```
+
+## Creating and checking work
+
+See `docs/OPERATIONS.md` for the full `curl` examples
+(`POST /v1/jobs` with `kind: REPROCESS_ALL` or `REPROCESS_PRODUCTS`,
+`GET /v1/jobs/{id}` for status). Every Job is scoped to the Agent whose
+token created it — no cross-Agent visibility.
+
+## Checking Agent status
+
+```bash
+curl $GTI_HUB_URL/v1/agents/me -H "Authorization: Bearer $AGENT_TOKEN"
+```
+
+Returns `agent_id`, `company_id`, `enabled`, `last_seen_at`, `last_status`,
+`schema_fingerprint`, `agent_version`, and a derived `status` of `ONLINE` or
+`OFFLINE` (offline if no heartbeat arrived within
+`AGENT_ONLINE_THRESHOLD_SECONDS`, default 120s — configurable on the Hub).
+No dashboard yet; this is the query an operator or a future dashboard would
+poll.
+
+## Write safety: enabling FIREBIRD_WRITES for a real client
+
+**Do not set `FIREBIRD_WRITES=1` against a real client database casually.**
+The authorization model has two independent layers, both required:
+
+1. **Path**: `AUTHORIZED_WRITE_DATABASE_PATH` in that installation's
+   `agent/.env` must be set to the *exact* absolute path of
+   `FIREBIRD_DATABASE_PATH` for that same installation. If it's unset, the
+   guard falls back to the developer-only disposable test database path
+   (`TESTESOFICIAIS.FDB`), so a real client path is refused automatically —
+   authorization is never inferred from the filename or the `.FDB`
+   extension.
+2. **Schema fingerprint**: `EXPECTED_SCHEMA_FINGERPRINT` must equal the live
+   schema fingerprint that installation reports in its heartbeat
+   (`schema_fingerprint`, visible via `GET /v1/agents/me`). If the live
+   schema ever drifts from what was verified, writes are refused until an
+   operator re-verifies and updates this value.
+
+Both checks happen before any write connection is opened
+(`scripts/firebird_write_executor.py::assert_authorized_write_path` /
+`assert_schema_fingerprint_authorized`), and before any product is even
+read from Firebird for that job.
+
+Even with both layers satisfied, auto-apply only ever touches
+`C000025.IPI`, and only when the TIPI match is `rate_kind=NUMERIC` and
+unambiguous. **No real client database has been written to during this or
+any prior mission** — all writes so far were against `TESTESOFICIAIS.FDB`.
+
+## Logs and diagnostics
+
+- **Agent**: rotating local log file (`AGENT_LOG_PATH` in `agent/.env`,
+  default `agent/logs/agent.log`, 5MB × 5 backups). Contains startup,
+  heartbeat outcomes, job received/finished, products processed, write
+  counts, failures, and Hub reconnects — never secrets (`FB_PASSWORD` and
+  `AGENT_TOKEN` are never logged). Detailed per-product audit is in the
+  Agent's SQLite file (`AGENT_STATE_DB`, table `ipi_write_log`).
+- **Hub**: structured `logging` output (visible via `docker compose logs
+  fiscal-hub`) for startup, health-check failures, heartbeats, and the full
+  Job lifecycle (created/claimed/completed/failed, with sanitized errors).
+  Coarse per-Job audit persists in Postgres (`jobs.result_summary`).
+
+## Troubleshooting
+
+| Symptom | Check |
+|---|---|
+| Agent shows `OFFLINE` | Is the service running (`sc.exe query GTIFiscalAgent`)? Check `agent/logs/agent.log` for heartbeat failures — usually `GTI_HUB_URL` unreachable or wrong `AGENT_TOKEN`. |
+| Job stuck `PENDING` | Confirm the Agent that owns it is running and polling (its `agent_id` must match the Job's `agent_id` — an Agent never claims another Agent's Job). |
+| Job `FAILED` | `GET /v1/jobs/{id}` for the sanitized `error`. Common causes: Firebird unreachable, `FIREBIRD_WRITES=1` misconfigured (see "Write safety"), Hub unreachable at report time (the Agent keeps the local `ipi_write_log` regardless). |
+| `writes_attempted` always 0 with `FIREBIRD_WRITES=1` | Check both `AUTHORIZED_WRITE_DATABASE_PATH` and `EXPECTED_SCHEMA_FINGERPRINT` are set and correct for that installation. |
+| Hub `/health` returns 503 | Postgres is down or unreachable; check `docker compose ps` and `docker compose logs postgres`. |
+
+## Rollback / uninstalling an Agent
+
+1. Stop and remove the Windows service (see above).
+2. Delete the `agent/` installation directory on that machine (its SQLite
+   audit and logs are local-only; nothing to clean up centrally).
+3. On the Hub, disable the Agent rather than deleting history: set
+   `enabled = false` for that `agents` row (no HTTP endpoint for this yet —
+   run it via `psql`/a short script against `DATABASE_URL`, the same access
+   `register_agent.py` uses). Its past Jobs and `classification_cache`
+   entries remain for audit.
+
+## Rolling back the Hub
+
+`docker compose down` does not remove the `postgres_data` volume — data
+survives. To roll back to a previous Hub image/version, redeploy that
+version's code and run `alembic upgrade head` again (migrations are
+additive, so this is safe going forward; there is no tested downgrade path
+for `0006`, so don't `alembic downgrade` in a pilot without restoring from a
+backup first).

docs/PILOT_DRY_RUN_CONSTRUCAO_LOCAL_SIMULATION_V1.json

@@ -0,0 +1,124 @@
+{
+ "artifact": "PILOT_DRY_RUN_CONSTRUCAO_LOCAL_SIMULATION_V1",
+ "real_pilot": false,
+ "note": "Local simulation: registered Agent, FISCAL_MODE=DRY_RUN, FIREBIRD_WRITES=0, REPROCESS_ALL through the Hub against the CONSTRUCAO COPY (Banco/CONSTRUCAO.FDB). Not the client's real host.",
+ "job": {
+  "job_id": 9,
+  "kind": "REPROCESS_ALL",
+  "status": "COMPLETED",
+  "started_at": "2026-09-19T18:59:12.390549+00:00",
+  "finished_at": "2026-09-19T20:32:02.336289+00:00",
+  "attempts": 1
+ },
+ "result": {
+  "coverage": {
+   "TOTAL_PRODUCTS": 3712,
+   "metrics": {
+    "NCM_VALID": 3698,
+    "IPI_SOURCE_BLANK": 1220,
+    "CFOP_CONTEXT_REQUIRED": 1514,
+    "ST_CANDIDATE": 434,
+    "ST_WITHHOLDING_UNKNOWN": 3712,
+    "PRODUCT_ROLE_KNOWN": 3708,
+    "ROLE_RESALE": 3707,
+    "CSOSN_CONTEXT_REQUIRED": 3638,
+    "CFOP_RESOLVED": 2198,
+    "ST_CONFIRMED": 867,
+    "IPI_NUMERIC": 1497,
+    "IPI_CHANGE_REQUIRED": 1497,
+    "IPI_WRITE_ELIGIBLE": 1497,
+    "ST_UNKNOWN": 2337,
+    "IPI_AMBIGUOUS": 918,
+    "ST_NOT_APPLICABLE": 74,
+    "CSOSN_CANDIDATES": 74,
+    "NCM_INVALID": 14,
+    "IPI_NO_MATCH": 14,
+    "IPI_NON_NUMERIC": 63,
+    "PRODUCT_ROLE_UNKNOWN": 4,
+    "ROLE_UNKNOWN": 4,
+    "ROLE_INPUT": 1
+   },
+   "IPI_RESOLVED": 2780,
+   "quality": {
+    "ncm_valid_share": 0.9962,
+    "cest_filled": 3467,
+    "csosn_filled": 3709,
+    "cfop_filled": 3710,
+    "ipi_filled": 0,
+    "cfop_distinct": 3,
+    "cfop_top": [
+     [
+      "5405",
+      2266
+     ],
+     [
+      "5102",
+      1444
+     ],
+     [
+      null,
+      2
+     ]
+    ],
+    "situacao_tributaria": {
+     "T": 3687,
+     "null": 25
+    },
+    "purchase_items_C000088": 0,
+    "products_with_purchase_evidence": 0,
+    "recipes": 0,
+    "composed_products": 0
+   },
+   "guards_applied": {
+    "st_dataset_ba_only": false,
+    "csosn_requires_crt1": false
+   },
+   "company_context": {
+    "COMPANY_CONTEXT_STATUS": "PASS",
+    "classification": "CONFIGURED",
+    "company_code": "000001",
+    "company_cnpj": "45**********90",
+    "company_uf": "BA",
+    "company_crt": "1",
+    "source_of_truth": {
+     "company": "CONFIGURED",
+     "uf": "EMISSOR+C000004+DOCUMENT_KEYS",
+     "crt": "EMISSOR+C000004"
+    },
+    "confidence": "HIGH",
+    "warnings": []
+   }
+  },
+  "fiscal_mode": "DRY_RUN",
+  "release_version": "1.0.0-rc1",
+  "products_processed": 3712,
+  "writes_attempted": 0,
+  "writes_succeeded": 0,
+  "writes_failed": 0,
+  "no_ops": 0,
+  "firebird_writes_enabled": false,
+  "agent_id": 8,
+  "schema_fingerprint": "1198f89897532b643439f06b729e93b189018f56e7d478e95095f8f56977005b"
+ },
+ "zero_write_proof": {
+  "dml_counters_identical": true,
+  "table_digests_identical": true,
+  "row_counts_identical": true,
+  "file_sha256_identical": false,
+  "dml_counters": {
+   "before": {
+    "inserts": 0,
+    "updates": 0,
+    "deletes": 0
+   },
+   "after": {
+    "inserts": 0,
+    "updates": 0,
+    "deletes": 0
+   }
+  },
+  "ZERO_WRITE_PROVEN": true,
+  "note": "DML counters (MON$RECORD_STATS), SHA-256 of every row of C000025/C000004 and row counts are identical before/after the REPROCESS_ALL. The file-level SHA-256 differs because ANY attach (even two idle read-only snapshots with no Agent) touches header/page metadata; it is informational, not a DML indicator."
+ },
+ "preflight": "PASS (see docs/RELEASE_CANDIDATE_V1.md)"
+}

docs/PRODUCT_FISCAL_DEFAULTS_DRY_RUN_V1.json

@@ -0,0 +1,64 @@
+{
+ "artifact": "PRODUCT_FISCAL_DEFAULTS_DRY_RUN_V1",
+ "firebird_writes": 0,
+ "write_candidates": [],
+ "TOTAL_PRODUCTS": 521,
+ "company": {
+  "crt": "1",
+  "uf": "BA",
+  "icms_csosn": "102"
+ },
+ "CFOP": {
+  "RESOLVED": 222,
+  "ALREADY_CORRECT": 222,
+  "CHANGE_REQUIRED": 0,
+  "REVIEW": 29,
+  "CONTEXT_REQUIRED": 244,
+  "UNRESOLVED": 26,
+  "CANDIDATE": 29,
+  "AUTO_APPLY_SAFE": 0,
+  "states": {
+   "CFOP_DEFAULT_RESOLVED": 222,
+   "CFOP_UNRESOLVED": 26,
+   "CFOP_OPERATION_CONTEXT_REQUIRED": 244,
+   "CFOP_DEFAULT_CANDIDATE": 29
+  },
+  "historical_validation_of_proposals": {
+   "MATCH": 85,
+   "UNVALIDATED": 151,
+   "MISMATCH": 15
+  },
+  "conflict_candidates_vs_history": {
+   "no_trusted_history": 14,
+   "history_emitted_current_value": 15
+  }
+ },
+ "CSOSN": {
+  "RESOLVED": 0,
+  "ALREADY_CORRECT": 0,
+  "CHANGE_REQUIRED": 0,
+  "REVIEW": 227,
+  "CONTEXT_REQUIRED": 268,
+  "UNRESOLVED": 26,
+  "CANDIDATE": 227,
+  "AUTO_APPLY_SAFE": 0,
+  "states": {
+   "CSOSN_DEFAULT_CANDIDATE": 227,
+   "CSOSN_UNRESOLVED": 26,
+   "CSOSN_OPERATION_CONTEXT_REQUIRED": 268
+  },
+  "historical_validation_of_proposals": {
+   "MATCH": 83,
+   "UNVALIDATED": 139,
+   "MISMATCH": 2
+  },
+  "st_conflicts": {
+   "ST_SUBJECT_BUT_CSOSN_NOT_500": 28,
+   "ST_CSOSN_500_RETENTION_UNVERIFIED": 3
+  }
+ },
+ "CST": {
+  "CST_REFERENCE_ONLY": 521
+ },
+ "note": "No proposal is write-eligible: CFOP conflicts need ST-retention/resale context; CSOSN needs product ICMS-treatment and retention context."
+}

docs/RELEASE_CANDIDATE_V1.md

@@ -0,0 +1,53 @@
+# GTI Fiscal 1.0.0-rc1 — Release Candidate
+
+Status: **COMPLETE_LOCAL_RC**. Nothing was installed on a real client host and no real client database received a write (`FIREBIRD_WRITES=0`, `FISCAL_MODE=DRY_RUN`).
+
+## Architecture
+
+```
+Hub central (Docker: Hub + PostgreSQL)
+        ^   HTTPS
+Agent Windows (service GTIFiscalAgent)
+        |   local, read-only
+SGV Firebird (C000025 / C000004)
+```
+The Hub never accesses Firebird and never stores Firebird credentials or paths.
+
+## Frozen versions (`release/RELEASE_MANIFEST.json`)
+| item | value |
+|---|---|
+| GTI_FISCAL_VERSION (Hub, Agent, packages) | 1.0.0-rc1 (`release/VERSION`, `central/app/version.py`, `GET /version`) |
+| fiscal engine (`ENGINE_VERSION`) / decision (`DECISION_VERSION`) | 0.3.0 / mission-04c-ipi-ex-split (unchanged: no fiscal semantics touched) |
+| decision engines | fiscal-decision-v1, product-defaults-v1, icms-context-v1 |
+| migrations | 0001..0010 (head 0010, applied) |
+| datasets | 13 ACTIVE kinds with sha256/record_count in the manifest |
+
+## What RC1 adds (no fiscal rule changes)
+- Agent config: `FISCAL_MODE` (DRY_RUN | AUTO_APPLY), `COMPANY_CODE`, `COMPANY_CNPJ`, `COMPANY_CRT_SOURCE` (AUTO | EMISSOR | C000004), `COMPANY_UF` as an explicit, non-substituting override; `AGENT_VERSION` default 1.0.0-rc1.
+- Single preflight (`agent/scripts/preflight.py`, enforced at service start): Hub reachability/auth/version, Firebird version + ODS, C000004/C000025, capabilities (NCM, IPI, CEST), company context (UF/CRT), schema/type guards, SQLite, log directory, mode/write consistency -> `PREFLIGHT=PASS|FAIL` + blockers.
+- Technical zero-write in DRY_RUN: effective writes are `FIREBIRD_WRITES=1 AND FISCAL_MODE=AUTO_APPLY`; `open_write_connection` refuses otherwise; tests cover it (`agent/tests/test_preflight_and_dry_run.py`); `scripts/prove_zero_write.py` proves it on a database.
+- REPROCESS_ALL result now carries the coverage report (NCM/IPI/CEST/CFOP/CSOSN/ST/role/company context) computed on the Agent from Hub decisions (`gti_fiscal_agent/coverage.py`, shared with the multi-database tooling).
+- Windows package (`deploy/agent-windows`, `scripts/build_agent_package.py`): install / configure / preflight / start / stop / restart / status / uninstall; no secrets inside; secret-scanned zip with SHA-256 manifest.
+- Hub production package (`deploy/hub`): compose with PostgreSQL on an internal network (no published port), persistent volume, healthchecks, restart policy, log rotation, required secrets, `backup.sh`, `restore.sh`, dataset seed export/import; `APP_ENV=production` refuses `AGENT_DEV_TOKEN`.
+- Pilot profile `pilot-construcao.env.example`; planned (not installed) `profiles/mmmodas|rincao|uniao.env.example` with `COMPANY_CRT_SOURCE=EMISSOR`.
+
+## Profiles
+| client | company context | required config |
+|---|---|---|
+| CONSTRUCAO (first pilot) | company 000001, UF BA, CRT 1, AUTO_RESOLVED, HIGH | `COMPANY_CODE=000001`, `COMPANY_CRT_SOURCE=AUTO`; host preflight must confirm UF=BA / CRT=1 |
+| MMMODAS | CRT conflict (EMISSOR 1 / C000004 2) | `COMPANY_CRT_SOURCE=EMISSOR` required |
+| RINCAO | company resolved via EMISSOR CNPJ (3 C000004 rows); CRT conflict (EMISSOR 3 / C000004 1) | `COMPANY_CODE=000001`, `COMPANY_CRT_SOURCE=EMISSOR` required |
+| UNIAO | CRT conflict (EMISSOR 1 / C000004 3) | `COMPANY_CRT_SOURCE=EMISSOR` required |
+
+## Follow-ups (explicitly not in RC1)
+- `dataset_versions()` (~11 queries per classification request) can be memoized/cached; it dominates the ~15 ms cache-hit latency.
+- Auto-apply stays disabled everywhere; enabling it for any real client needs the two pilot authorization layers and a separate decision.
+- No dashboard, no Kubernetes/Redis/RabbitMQ.
+
+## External requirements for the first real pilot
+1. Hub URL (or the Proxmox host / VM to deploy it on) and shell access to deploy `deploy/hub`, plus the public HTTPS name and the reverse proxy/TLS certificate.
+2. The Windows host of the CONSTRUCAO client (remote access + administrator rights).
+3. The real path of the client's SGV `.FDB` on that host (not the local copy's path).
+4. A read-only Firebird account (user/password) entered locally on that host.
+5. Explicit authorization to install the Windows Service `GTIFiscalAgent` there.
+6. An Agent token generated with `register_agent.py` on the production Hub.

docs/SAMPLE_PRODUCTS_V1.json

@@ -0,0 +1,81 @@
+{
+  "dataset": "SAMPLE_PRODUCTS_V1",
+  "source_table": "C000025",
+  "sanitized": true,
+  "total_products": 521,
+  "ncm_nonempty_count": 0,
+  "gtin_or_ean_count": 520,
+  "target_product": {
+    "CODIGO": "000276",
+    "PRODUTO": "ABACAXI M/ JARRA",
+    "EAN_GTIN": "9788576766308",
+    "NCM": null,
+    "CFOP": "5102",
+    "CFOP_ENTRADA": null,
+    "CST": "040",
+    "CST_ENTRADA": null,
+    "ALIQUOTA": "20.5",
+    "CEST": "",
+    "CSOSN": "102",
+    "CLASSIFICACAO_FISCAL": "08043000",
+    "CCLASSTRIB": null,
+    "COD_ENTRADA_COFINS": null,
+    "COD_SAIDA_COFINS": null,
+    "ALIQ_COFINS": null,
+    "COD_ENTRADA_PIS": null,
+    "COD_SAIDA_PIS": null,
+    "ALIQ_PIS": null,
+    "ALIQ_IPI": null,
+    "CST_IPI": null,
+    "ORIGEM": null,
+    "IAT": "A",
+    "INCIDENCIA_PISCOFINS": "NENHUMA",
+    "IPPT": "T"
+  },
+  "sample_without_ncm": [
+    {"CODIGO":"000004","PRODUTO":"SALADA DE BACALHAU MINI","EAN_GTIN":"0000000000004","NCM":null,"CLASSIFICACAO_FISCAL":"07069000","CFOP":"5102","CST":"040","ALIQUOTA":"20.5","CEST":"","CSOSN":"102"},
+    {"CODIGO":"000005","PRODUTO":"SALADA MARROQUINA MINI","EAN_GTIN":"0000000000005","NCM":null,"CLASSIFICACAO_FISCAL":"07069000","CFOP":"5102","CST":"040","ALIQUOTA":"20.5","CEST":"","CSOSN":"102"},
+    {"CODIGO":"000006","PRODUTO":"SALADA ITALIANA MINI","EAN_GTIN":"0000000000006","NCM":null,"CLASSIFICACAO_FISCAL":"07069000","CFOP":"5102","CST":"040","ALIQUOTA":"20.5","CEST":"","CSOSN":"102"},
+    {"CODIGO":"000008","PRODUTO":"SALADA MISTA MINI","EAN_GTIN":"0000000000008","NCM":null,"CLASSIFICACAO_FISCAL":"07069000","CFOP":"5102","CST":"040","ALIQUOTA":"20.5","CEST":"","CSOSN":"102"},
+    {"CODIGO":"000009","PRODUTO":"SALADA DE BACALHAU COMPLETO","EAN_GTIN":"SEM GTIN","NCM":null,"CLASSIFICACAO_FISCAL":"07069000","CFOP":"5102","CST":"040","ALIQUOTA":"20.5","CEST":"","CSOSN":"102"},
+    {"CODIGO":"000010","PRODUTO":"SALADA MARROQUINA COMPLETO","EAN_GTIN":"0000000000010","NCM":null,"CLASSIFICACAO_FISCAL":"07069000","CFOP":"5102","CST":"040","ALIQUOTA":"20.5","CEST":"","CSOSN":"102"},
+    {"CODIGO":"000011","PRODUTO":"SALADA ITALIANA COMPLETO","EAN_GTIN":"0000000000011","NCM":null,"CLASSIFICACAO_FISCAL":"07069000","CFOP":"5102","CST":"040","ALIQUOTA":"20.5","CEST":"","CSOSN":"102"},
+    {"CODIGO":"000013","PRODUTO":"SALADA MISTA COMPLETO","EAN_GTIN":"0000000000013","NCM":null,"CLASSIFICACAO_FISCAL":"07069000","CFOP":"5102","CST":"040","ALIQUOTA":"20.5","CEST":"","CSOSN":"102"},
+    {"CODIGO":"000015","PRODUTO":"CALDO DE FEIJÃO ","EAN_GTIN":"0000000000015","NCM":null,"CLASSIFICACAO_FISCAL":"07133321","CFOP":"5102","CST":"040","ALIQUOTA":"20.5","CEST":"","CSOSN":"102"},
+    {"CODIGO":"000016","PRODUTO":"CALDO DE SURURU","EAN_GTIN":"0000000000016","NCM":null,"CLASSIFICACAO_FISCAL":"02071400","CFOP":"5102","CST":"040","ALIQUOTA":"20.5","CEST":"","CSOSN":"102"},
+    {"CODIGO":"000017","PRODUTO":"CALDO DE CAMARAO","EAN_GTIN":"0000000000017","NCM":null,"CLASSIFICACAO_FISCAL":"03061790","CFOP":"5102","CST":"040","ALIQUOTA":"20.5","CEST":"","CSOSN":"102"},
+    {"CODIGO":"000018","PRODUTO":"CANJA DE GALINHA","EAN_GTIN":"0000000000018","NCM":null,"CLASSIFICACAO_FISCAL":"02071100","CFOP":"5102","CST":"040","ALIQUOTA":"20.5","CEST":"","CSOSN":"102"},
+    {"CODIGO":"000019","PRODUTO":"SOPA DE FEIJAO","EAN_GTIN":"0000000000019","NCM":null,"CLASSIFICACAO_FISCAL":"07133321","CFOP":"5102","CST":"040","ALIQUOTA":"20.5","CEST":"","CSOSN":"102"},
+    {"CODIGO":"000021","PRODUTO":"SOPA DE LEGUMES","EAN_GTIN":"0000000000021","NCM":null,"CLASSIFICACAO_FISCAL":"07089000","CFOP":"5102","CST":"040","ALIQUOTA":"20.5","CEST":"","CSOSN":"102"},
+    {"CODIGO":"000022","PRODUTO":"CREME DE LEGUMES","EAN_GTIN":"0000000000022","NCM":null,"CLASSIFICACAO_FISCAL":"07089000","CFOP":"5102","CST":"040","ALIQUOTA":"20.5","CEST":"","CSOSN":"102"},
+    {"CODIGO":"000023","PRODUTO":"QUIBE ( 6 UND )","EAN_GTIN":"0000000000023","NCM":null,"CLASSIFICACAO_FISCAL":"16025000","CFOP":"5102","CST":"040","ALIQUOTA":"20.5","CEST":"","CSOSN":"102"},
+    {"CODIGO":"000024","PRODUTO":"COXINHA ( 6 UNID )","EAN_GTIN":"0000000000024","NCM":null,"CLASSIFICACAO_FISCAL":"19022000","CFOP":"5102","CST":"040","ALIQUOTA":"20.5","CEST":"","CSOSN":"102"},
+    {"CODIGO":"000025","PRODUTO":"BOLINHO DE QUEIJO","EAN_GTIN":"0000000000025","NCM":null,"CLASSIFICACAO_FISCAL":"04061010","CFOP":"5102","CST":"040","ALIQUOTA":"20.5","CEST":"","CSOSN":"102"},
+    {"CODIGO":"000026","PRODUTO":"BOLINHO DE BACALHAU ( 6 UND )","EAN_GTIN":"0000000000026","NCM":null,"CLASSIFICACAO_FISCAL":"03055100","CFOP":"5102","CST":"040","ALIQUOTA":"20.5","CEST":"","CSOSN":"102"},
+    {"CODIGO":"000027","PRODUTO":"RISOLE DE CAMARAO","EAN_GTIN":"0000000000027","NCM":null,"CLASSIFICACAO_FISCAL":"19022000","CFOP":"5102","CST":"040","ALIQUOTA":"20.5","CEST":"","CSOSN":"102"}
+  ],
+  "sample_with_ncm": [],
+  "sample_with_ean_gtin": [
+    {"CODIGO":"000004","EAN_GTIN":"0000000000004"},
+    {"CODIGO":"000005","EAN_GTIN":"0000000000005"},
+    {"CODIGO":"000006","EAN_GTIN":"0000000000006"},
+    {"CODIGO":"000008","EAN_GTIN":"0000000000008"},
+    {"CODIGO":"000009","EAN_GTIN":"SEM GTIN"},
+    {"CODIGO":"000010","EAN_GTIN":"0000000000010"},
+    {"CODIGO":"000011","EAN_GTIN":"0000000000011"},
+    {"CODIGO":"000013","EAN_GTIN":"0000000000013"},
+    {"CODIGO":"000015","EAN_GTIN":"0000000000015"},
+    {"CODIGO":"000016","EAN_GTIN":"0000000000016"},
+    {"CODIGO":"000017","EAN_GTIN":"0000000000017"},
+    {"CODIGO":"000018","EAN_GTIN":"0000000000018"},
+    {"CODIGO":"000019","EAN_GTIN":"0000000000019"},
+    {"CODIGO":"000021","EAN_GTIN":"0000000000021"},
+    {"CODIGO":"000022","EAN_GTIN":"0000000000022"},
+    {"CODIGO":"000023","EAN_GTIN":"0000000000023"},
+    {"CODIGO":"000024","EAN_GTIN":"0000000000024"},
+    {"CODIGO":"000025","EAN_GTIN":"0000000000025"},
+    {"CODIGO":"000026","EAN_GTIN":"0000000000026"},
+    {"CODIGO":"000027","EAN_GTIN":"0000000000027"}
+  ],
+  "reference_schema": "REFERENCE_SCHEMA_V1"
+}

docs/SCHEMA_MAPPING.md

@@ -0,0 +1,38 @@
+# Schema Mapping and Fingerprint Strategy
+
+## Mapping status
+
+`SCHEMA_UNKNOWN`.
+
+Mission 00F connected read-only and collected live metadata. The main product
+candidate is `C000025` with PK `CODIGO`; product, stock,
+fiscal, image, or incremental structures were inspected, and no UI concept is
+mapped to a live table or column.
+
+## Evidence boundary
+
+The authorized target is identified by the authorized-database label. No other
+database was accessed. The structured catalog and safe sampling APIs remain available for a
+future gated run, but this document contains no live schema findings.
+
+The real fingerprint is `1198f89897532b643439f06b729e93b189018f56e7d478e95095f8f56977005b`,
+but its reference classification remains `SCHEMA_UNKNOWN` because it is not in
+the approved fingerprint allowlist.
+
+## Safety counters
+
+- `APPLICATION_DDL_DML_WRITES = 0`
+- `OTHER_DATABASES_ACCESSED = 0`
+- `ERP_FILES_MODIFIED = 0`
+- `CONNECTION_ATTEMPTS = 2`
+
+## Required follow-up
+
+Provide `FB_USER` and `FB_PASSWORD` only through the process environment and
+rerun the authorized discovery. Do not use another database or inspect raw
+BLOB/image data.
+
+## Git State
+
+`GIT_IDENTITY_NOT_CONFIGURED`. No Git identity was configured and no Git
+configuration was modified.

docs/SGV_PRODUCT_FISCAL_UI_MAP_V1.json

@@ -0,0 +1,864 @@
+{
+ "artifact": "SGV_PRODUCT_FISCAL_UI_MAP_V1",
+ "product_table": "C000025",
+ "company_table": "C000004",
+ "company_fields": {
+  "CRT": "C000004.CRT",
+  "UF": "C000004.UF"
+ },
+ "evidence_source": "Delphi DFM of form Tfrmproduto extracted from SGV_5.0.6.124.exe (docs/runs/sgv_product_form_bindings.json); dsproduto2 -> qrproduto = 'select * from c000025'",
+ "architecture_rule": "GTI Fiscal writes ONLY the canonical product record (C000025). Transactional/historical tables are evidence only.",
+ "transactional_table_writes_allowed": false,
+ "forbidden_write_tables": [
+  "NFCE",
+  "NFCE_ITENS",
+  "C000032",
+  "C000061",
+  "C000062",
+  "C000088",
+  "INVENTARIO",
+  "C000026 (price calculation)",
+  "any historical/document/item table"
+ ],
+ "columns_with_no_screen_control": [
+  "ORIGEM",
+  "GRUPO_ICMS",
+  "MARGEM_AGREGADA",
+  "CFOP_CUPOM",
+  "NCM"
+ ],
+ "summary": {
+  "ui_fields_total": 23,
+  "CONFIRMED_STRONG": 22,
+  "PROBABLE": 0,
+  "AMBIGUOUS": 0,
+  "NO_MATCH": 1,
+  "write_target_fields": [
+   "CLASSIFICACAO_FISCAL",
+   "CFOP_ENTRADA",
+   "CST_ENTRADA",
+   "CFOP",
+   "CST",
+   "ALIQUOTA",
+   "CEST",
+   "SITUACAO_TRIBUTARIA",
+   "COD_ENTRADA_COFINS",
+   "COD_SAIDA_COFINS",
+   "ALIQ_COFINS",
+   "COD_ENTRADA_PIS",
+   "COD_SAIDA_PIS",
+   "ALIQ_PIS",
+   "CSOSN",
+   "IPI",
+   "CST_IPI",
+   "COD_ORIGEM_MERCADORIA",
+   "IAT",
+   "INCIDENCIA_PISCOFINS",
+   "PISCOFINS",
+   "IPPT"
+  ],
+  "fields_requiring_manual_ui_diff": [],
+  "unidentified_controls": [
+   "Panel1.ealiquota -> CODALIQUOTA (data-aware, not visible in the supplied screenshots; column empty 0/521)"
+  ]
+ },
+ "fields": [
+  {
+   "ui_label": "NCM",
+   "screen_area": "Aba Estoque > Posição do Estoque/Informações",
+   "table": "C000025",
+   "field": "CLASSIFICACAO_FISCAL",
+   "db_type": "VARCHAR(20)",
+   "direction": "n/a",
+   "semantic": "NCM canônico (8 dígitos); C000025.NCM is not on the screen",
+   "before": null,
+   "after": null,
+   "confirmed_by_ui_diff": false,
+   "classification": "CONFIRMED_STRONG",
+   "confidence": "HIGH",
+   "binding_type": "DFM_DATAFIELD",
+   "evidence_basis": "DFM: TDBEdit DBEdit14 DataField=CLASSIFICACAO_FISCAL DataSource=dsproduto2 (qrproduto = select * from c000025)",
+   "dfm_control": {
+    "class": "TDBEdit",
+    "name": "DBEdit14",
+    "left": 359,
+    "top": 111,
+    "container_path": [
+     "PageSheet9[ Estoque]",
+     "PageView2",
+     "PageSheet10[Posição do Estoque / Informações]"
+    ]
+   },
+   "write_target": true,
+   "current_population": 521,
+   "sample_values": [
+    "21069090",
+    "22082000",
+    "22030000",
+    "20099000",
+    "19022000"
+   ],
+   "notes": "NCM lookup control; column NCM (C000025.NCM) has no control."
+  },
+  {
+   "ui_label": "CFOP (Nota Fiscal de Entrada)",
+   "screen_area": "Config. Impostos > Nota Fiscal de Entrada",
+   "table": "C000025",
+   "field": "CFOP_ENTRADA",
+   "db_type": "CHAR(4)",
+   "direction": "entrada",
+   "semantic": "CFOP padrão de entrada",
+   "before": null,
+   "after": null,
+   "confirmed_by_ui_diff": false,
+   "classification": "CONFIRMED_STRONG",
+   "confidence": "HIGH",
+   "binding_type": "DFM_DATAFIELD",
+   "evidence_basis": "DFM: TDBEdit DBEdit72 DataField=CFOP_ENTRADA DataSource=dsproduto2 (qrproduto = select * from c000025)",
+   "dfm_control": {
+    "class": "TDBEdit",
+    "name": "DBEdit72",
+    "left": 16,
+    "top": 32,
+    "container_path": [
+     "pageview1",
+     "PageSheet13[Config. Impostos]",
+     "FlatGroupBox5[Nota Fiscal de Entrada]"
+    ]
+   },
+   "write_target": true,
+   "current_population": 0,
+   "sample_values": [
+    null
+   ],
+   "notes": "Column is empty (0/521) but the screen writes it."
+  },
+  {
+   "ui_label": "CST de ICMS (Nota Fiscal de Entrada)",
+   "screen_area": "Config. Impostos > Nota Fiscal de Entrada",
+   "table": "C000025",
+   "field": "CST_ENTRADA",
+   "db_type": "CHAR(4)",
+   "direction": "entrada",
+   "semantic": "CST ICMS de entrada",
+   "before": null,
+   "after": null,
+   "confirmed_by_ui_diff": false,
+   "classification": "CONFIRMED_STRONG",
+   "confidence": "HIGH",
+   "binding_type": "DFM_DATAFIELD",
+   "evidence_basis": "DFM: TDBEdit DBEdit73 DataField=CST_ENTRADA DataSource=dsproduto2 (qrproduto = select * from c000025)",
+   "dfm_control": {
+    "class": "TDBEdit",
+    "name": "DBEdit73",
+    "left": 16,
+    "top": 72,
+    "container_path": [
+     "pageview1",
+     "PageSheet13[Config. Impostos]",
+     "FlatGroupBox5[Nota Fiscal de Entrada]"
+    ]
+   },
+   "write_target": true,
+   "current_population": 0,
+   "sample_values": [
+    null
+   ],
+   "notes": "Column is empty (0/521) but the screen writes it."
+  },
+  {
+   "ui_label": "CFOP (Nota Fiscal de Saída)",
+   "screen_area": "Config. Impostos > Nota Fiscal de Saída GRUPO DE ICMS",
+   "table": "C000025",
+   "field": "CFOP",
+   "db_type": "VARCHAR(4)",
+   "direction": "saída",
+   "semantic": "CFOP padrão de saída",
+   "before": null,
+   "after": null,
+   "confirmed_by_ui_diff": false,
+   "classification": "CONFIRMED_STRONG",
+   "confidence": "HIGH",
+   "binding_type": "DFM_DATAFIELD",
+   "evidence_basis": "DFM: TRzDBButtonEdit DbEdit71 DataField=CFOP DataSource=dsproduto2 (qrproduto = select * from c000025)",
+   "dfm_control": {
+    "class": "TRzDBButtonEdit",
+    "name": "DbEdit71",
+    "left": 19,
+    "top": 35,
+    "container_path": [
+     "pageview1",
+     "PageSheet13[Config. Impostos]",
+     "FlatGroupBox2[Nota Fiscal de Saída GRUPO DE ICMS]"
+    ]
+   },
+   "write_target": true,
+   "current_population": 500,
+   "sample_values": [
+    "5102",
+    null,
+    "5101",
+    "5405",
+    "5656"
+   ],
+   "notes": ""
+  },
+  {
+   "ui_label": "CST de ICMS (Nota Fiscal de Saída)",
+   "screen_area": "Config. Impostos > Nota Fiscal de Saída GRUPO DE ICMS",
+   "table": "C000025",
+   "field": "CST",
+   "db_type": "VARCHAR(10)",
+   "direction": "saída",
+   "semantic": "CST ICMS 3 dígitos (origem+CST)",
+   "before": null,
+   "after": null,
+   "confirmed_by_ui_diff": false,
+   "classification": "CONFIRMED_STRONG",
+   "confidence": "HIGH",
+   "binding_type": "DFM_DATAFIELD",
+   "evidence_basis": "DFM: TRzDBButtonEdit dbedit13 DataField=CST DataSource=dsproduto2 (qrproduto = select * from c000025)",
+   "dfm_control": {
+    "class": "TRzDBButtonEdit",
+    "name": "dbedit13",
+    "left": 79,
+    "top": 35,
+    "container_path": [
+     "pageview1",
+     "PageSheet13[Config. Impostos]",
+     "FlatGroupBox2[Nota Fiscal de Saída GRUPO DE ICMS]"
+    ]
+   },
+   "write_target": true,
+   "current_population": 521,
+   "sample_values": [
+    "040",
+    "000",
+    "060",
+    "020",
+    "051"
+   ],
+   "notes": "CRT=1 emission uses CSOSN."
+  },
+  {
+   "ui_label": "Aliq. ICMS",
+   "screen_area": "Config. Impostos > Nota Fiscal de Saída GRUPO DE ICMS",
+   "table": "C000025",
+   "field": "ALIQUOTA",
+   "db_type": "NUMERIC(*,2)",
+   "direction": "saída",
+   "semantic": "alíquota ICMS %",
+   "before": null,
+   "after": null,
+   "confirmed_by_ui_diff": false,
+   "classification": "CONFIRMED_STRONG",
+   "confidence": "HIGH",
+   "binding_type": "DFM_DATAFIELD",
+   "evidence_basis": "DFM: TDBEdit ealiq DataField=ALIQUOTA DataSource=dsproduto2 (qrproduto = select * from c000025)",
+   "dfm_control": {
+    "class": "TDBEdit",
+    "name": "ealiq",
+    "left": 144,
+    "top": 35,
+    "container_path": [
+     "pageview1",
+     "PageSheet13[Config. Impostos]",
+     "FlatGroupBox2[Nota Fiscal de Saída GRUPO DE ICMS]"
+    ]
+   },
+   "write_target": true,
+   "current_population": 521,
+   "sample_values": [
+    "20.5",
+    "17",
+    "0",
+    "21.5"
+   ],
+   "notes": "Binding proven; emitted NFC-e values differ from this default (see earlier missions)."
+  },
+  {
+   "ui_label": "CEST",
+   "screen_area": "Config. Impostos > Nota Fiscal de Saída GRUPO DE ICMS",
+   "table": "C000025",
+   "field": "CEST",
+   "db_type": "VARCHAR(7)",
+   "direction": "n/a",
+   "semantic": "CEST (7 dígitos)",
+   "before": null,
+   "after": null,
+   "confirmed_by_ui_diff": false,
+   "classification": "CONFIRMED_STRONG",
+   "confidence": "HIGH",
+   "binding_type": "DFM_DATAFIELD",
+   "evidence_basis": "DFM: TDBEdit DBEdit74 DataField=CEST DataSource=dsproduto2 (qrproduto = select * from c000025)",
+   "dfm_control": {
+    "class": "TDBEdit",
+    "name": "DBEdit74",
+    "left": 212,
+    "top": 36,
+    "container_path": [
+     "pageview1",
+     "PageSheet13[Config. Impostos]",
+     "FlatGroupBox2[Nota Fiscal de Saída GRUPO DE ICMS]"
+    ]
+   },
+   "write_target": true,
+   "current_population": 5,
+   "sample_values": [
+    "",
+    null,
+    "0601100",
+    "2110600",
+    "1708400"
+   ],
+   "notes": ""
+  },
+  {
+   "ui_label": "Seletor ao lado do CEST (T/I/N/S)",
+   "screen_area": "Config. Impostos > Nota Fiscal de Saída GRUPO DE ICMS",
+   "table": "C000025",
+   "field": "SITUACAO_TRIBUTARIA",
+   "db_type": "VARCHAR(2)",
+   "direction": "saída",
+   "semantic": "situação tributária do produto: T=Tributado, I=Isento, N=Não Tributado, S=Substituição Tributária",
+   "before": null,
+   "after": null,
+   "confirmed_by_ui_diff": false,
+   "classification": "CONFIRMED_STRONG",
+   "confidence": "HIGH",
+   "binding_type": "DFM_DATAFIELD",
+   "evidence_basis": "DFM: TwwDBComboBox wwDBComboBox2 DataField=SITUACAO_TRIBUTARIA DataSource=dsproduto2 (qrproduto = select * from c000025)",
+   "dfm_control": {
+    "class": "TwwDBComboBox",
+    "name": "wwDBComboBox2",
+    "left": 277,
+    "top": 35,
+    "container_path": [
+     "pageview1",
+     "PageSheet13[Config. Impostos]",
+     "FlatGroupBox2[Nota Fiscal de Saída GRUPO DE ICMS]"
+    ]
+   },
+   "write_target": true,
+   "current_population": 520,
+   "sample_values": [
+    "T",
+    null,
+    "I"
+   ],
+   "notes": "Hint of the control lists the domain; 'S' is the ERP's own ST flag."
+  },
+  {
+   "ui_label": "Cofins Entrada",
+   "screen_area": "Config. Impostos > CST PIS/COFINS",
+   "table": "C000025",
+   "field": "COD_ENTRADA_COFINS",
+   "db_type": "VARCHAR(3)",
+   "direction": "entrada",
+   "semantic": "CST COFINS de entrada",
+   "before": null,
+   "after": null,
+   "confirmed_by_ui_diff": false,
+   "classification": "CONFIRMED_STRONG",
+   "confidence": "HIGH",
+   "binding_type": "DFM_DATAFIELD",
+   "evidence_basis": "DFM: TRzDBButtonEdit RzDBButtonEdit3 DataField=COD_ENTRADA_COFINS DataSource=dsproduto2 (qrproduto = select * from c000025)",
+   "dfm_control": {
+    "class": "TRzDBButtonEdit",
+    "name": "RzDBButtonEdit3",
+    "left": 105,
+    "top": 22,
+    "container_path": [
+     "pageview1",
+     "PageSheet13[Config. Impostos]",
+     "FlatGroupBox1[CST PIS/COFINS]"
+    ]
+   },
+   "write_target": true,
+   "current_population": 2,
+   "sample_values": [
+    null,
+    "2",
+    "73"
+   ],
+   "notes": ""
+  },
+  {
+   "ui_label": "Cofins Saída",
+   "screen_area": "Config. Impostos > CST PIS/COFINS",
+   "table": "C000025",
+   "field": "COD_SAIDA_COFINS",
+   "db_type": "VARCHAR(3)",
+   "direction": "saída",
+   "semantic": "CST COFINS de saída",
+   "before": null,
+   "after": null,
+   "confirmed_by_ui_diff": false,
+   "classification": "CONFIRMED_STRONG",
+   "confidence": "HIGH",
+   "binding_type": "DFM_DATAFIELD",
+   "evidence_basis": "DFM: TRzDBButtonEdit RzDBButtonEdit1 DataField=COD_SAIDA_COFINS DataSource=dsproduto2 (qrproduto = select * from c000025)",
+   "dfm_control": {
+    "class": "TRzDBButtonEdit",
+    "name": "RzDBButtonEdit1",
+    "left": 105,
+    "top": 46,
+    "container_path": [
+     "pageview1",
+     "PageSheet13[Config. Impostos]",
+     "FlatGroupBox1[CST PIS/COFINS]"
+    ]
+   },
+   "write_target": true,
+   "current_population": 3,
+   "sample_values": [
+    null,
+    "2",
+    "01",
+    "04"
+   ],
+   "notes": ""
+  },
+  {
+   "ui_label": "Alíquota (Cofins)",
+   "screen_area": "Config. Impostos > CST PIS/COFINS",
+   "table": "C000025",
+   "field": "ALIQ_COFINS",
+   "db_type": "VARCHAR(8)",
+   "direction": "saída",
+   "semantic": "alíquota COFINS (texto)",
+   "before": null,
+   "after": null,
+   "confirmed_by_ui_diff": false,
+   "classification": "CONFIRMED_STRONG",
+   "confidence": "HIGH",
+   "binding_type": "DFM_DATAFIELD",
+   "evidence_basis": "DFM: TRzDBEdit RzDBEdit4 DataField=ALIQ_COFINS DataSource=dsproduto2 (qrproduto = select * from c000025)",
+   "dfm_control": {
+    "class": "TRzDBEdit",
+    "name": "RzDBEdit4",
+    "left": 105,
+    "top": 68,
+    "container_path": [
+     "pageview1",
+     "PageSheet13[Config. Impostos]",
+     "FlatGroupBox1[CST PIS/COFINS]"
+    ]
+   },
+   "write_target": true,
+   "current_population": 2,
+   "sample_values": [
+    null,
+    "",
+    "2",
+    "3"
+   ],
+   "notes": ""
+  },
+  {
+   "ui_label": "Pis Entrada",
+   "screen_area": "Config. Impostos > CST PIS/COFINS",
+   "table": "C000025",
+   "field": "COD_ENTRADA_PIS",
+   "db_type": "VARCHAR(3)",
+   "direction": "entrada",
+   "semantic": "CST PIS de entrada",
+   "before": null,
+   "after": null,
+   "confirmed_by_ui_diff": false,
+   "classification": "CONFIRMED_STRONG",
+   "confidence": "HIGH",
+   "binding_type": "DFM_DATAFIELD",
+   "evidence_basis": "DFM: TRzDBButtonEdit RzDBButtonEdit5 DataField=COD_ENTRADA_PIS DataSource=dsproduto2 (qrproduto = select * from c000025)",
+   "dfm_control": {
+    "class": "TRzDBButtonEdit",
+    "name": "RzDBButtonEdit5",
+    "left": 279,
+    "top": 22,
+    "container_path": [
+     "pageview1",
+     "PageSheet13[Config. Impostos]",
+     "FlatGroupBox1[CST PIS/COFINS]"
+    ]
+   },
+   "write_target": true,
+   "current_population": 2,
+   "sample_values": [
+    null,
+    "2",
+    "73"
+   ],
+   "notes": ""
+  },
+  {
+   "ui_label": "Pis Saída",
+   "screen_area": "Config. Impostos > CST PIS/COFINS",
+   "table": "C000025",
+   "field": "COD_SAIDA_PIS",
+   "db_type": "VARCHAR(3)",
+   "direction": "saída",
+   "semantic": "CST PIS de saída",
+   "before": null,
+   "after": null,
+   "confirmed_by_ui_diff": false,
+   "classification": "CONFIRMED_STRONG",
+   "confidence": "HIGH",
+   "binding_type": "DFM_DATAFIELD",
+   "evidence_basis": "DFM: TRzDBButtonEdit RzDBButtonEdit2 DataField=COD_SAIDA_PIS DataSource=dsproduto2 (qrproduto = select * from c000025)",
+   "dfm_control": {
+    "class": "TRzDBButtonEdit",
+    "name": "RzDBButtonEdit2",
+    "left": 279,
+    "top": 46,
+    "container_path": [
+     "pageview1",
+     "PageSheet13[Config. Impostos]",
+     "FlatGroupBox1[CST PIS/COFINS]"
+    ]
+   },
+   "write_target": true,
+   "current_population": 3,
+   "sample_values": [
+    null,
+    "2",
+    "01",
+    "04"
+   ],
+   "notes": ""
+  },
+  {
+   "ui_label": "Alíquota (Pis)",
+   "screen_area": "Config. Impostos > CST PIS/COFINS",
+   "table": "C000025",
+   "field": "ALIQ_PIS",
+   "db_type": "VARCHAR(8)",
+   "direction": "saída",
+   "semantic": "alíquota PIS (texto)",
+   "before": null,
+   "after": null,
+   "confirmed_by_ui_diff": false,
+   "classification": "CONFIRMED_STRONG",
+   "confidence": "HIGH",
+   "binding_type": "DFM_DATAFIELD",
+   "evidence_basis": "DFM: TRzDBEdit RzDBEdit3 DataField=ALIQ_PIS DataSource=dsproduto2 (qrproduto = select * from c000025)",
+   "dfm_control": {
+    "class": "TRzDBEdit",
+    "name": "RzDBEdit3",
+    "left": 279,
+    "top": 68,
+    "container_path": [
+     "pageview1",
+     "PageSheet13[Config. Impostos]",
+     "FlatGroupBox1[CST PIS/COFINS]"
+    ]
+   },
+   "write_target": true,
+   "current_population": 2,
+   "sample_values": [
+    null,
+    "",
+    "2",
+    "0,65"
+   ],
+   "notes": ""
+  },
+  {
+   "ui_label": "CSOSN Classificação",
+   "screen_area": "Config. Impostos > CSOSN",
+   "table": "C000025",
+   "field": "CSOSN",
+   "db_type": "VARCHAR(60)",
+   "direction": "saída",
+   "semantic": "CSOSN (código)",
+   "before": null,
+   "after": null,
+   "confirmed_by_ui_diff": false,
+   "classification": "CONFIRMED_STRONG",
+   "confidence": "HIGH",
+   "binding_type": "DFM_DATAFIELD",
+   "evidence_basis": "DFM: TDBEdit DBEdit75 DataField=CSOSN DataSource=dsproduto2 (qrproduto = select * from c000025)",
+   "dfm_control": {
+    "class": "TDBEdit",
+    "name": "DBEdit75",
+    "left": 4,
+    "top": 36,
+    "container_path": [
+     "pageview1",
+     "PageSheet13[Config. Impostos]",
+     "FlatGroupBox4[CSOSN]"
+    ]
+   },
+   "write_target": true,
+   "current_population": 497,
+   "sample_values": [
+    "102",
+    null,
+    "500",
+    "101",
+    ""
+   ],
+   "notes": ""
+  },
+  {
+   "ui_label": "CSOSN Informações - Significados",
+   "screen_area": "Config. Impostos > CSOSN",
+   "table": "C000025",
+   "field": null,
+   "db_type": null,
+   "direction": "n/a",
+   "semantic": "descrição do CSOSN (apoio visual)",
+   "before": null,
+   "after": null,
+   "confirmed_by_ui_diff": false,
+   "classification": "NO_MATCH",
+   "confidence": "HIGH",
+   "binding_type": "NOT_DATA_AWARE",
+   "evidence_basis": "DFM: ComboBox1 is not data-aware",
+   "write_target": false,
+   "current_population": null,
+   "sample_values": [],
+   "notes": "Plain TComboBox, not data-aware: presentation helper, no column."
+  },
+  {
+   "ui_label": "Alíquota IPI %",
+   "screen_area": "Config. Impostos > IPI",
+   "table": "C000025",
+   "field": "IPI",
+   "db_type": "DOUBLE PRECISION",
+   "direction": "saída",
+   "semantic": "alíquota IPI %",
+   "before": null,
+   "after": null,
+   "confirmed_by_ui_diff": false,
+   "classification": "CONFIRMED_STRONG",
+   "confidence": "HIGH",
+   "binding_type": "DFM_DATAFIELD",
+   "evidence_basis": "DFM: TRzDBEdit RzDBEdit2 DataField=IPI DataSource=dsproduto2 (qrproduto = select * from c000025)",
+   "dfm_control": {
+    "class": "TRzDBEdit",
+    "name": "RzDBEdit2",
+    "left": 22,
+    "top": 37,
+    "container_path": [
+     "pageview1",
+     "PageSheet13[Config. Impostos]",
+     "FlatGroupBox3[IPI]"
+    ]
+   },
+   "write_target": true,
+   "current_population": 109,
+   "sample_values": [
+    null,
+    "19.5",
+    "3.25",
+    "5.0",
+    "20.0"
+   ],
+   "notes": "Cálculo Preço tab has other IPI/PIS/COFINS controls bound to C000026 (price calculation), not fiscal defaults."
+  },
+  {
+   "ui_label": "CST IPI",
+   "screen_area": "Config. Impostos > IPI",
+   "table": "C000025",
+   "field": "CST_IPI",
+   "db_type": "CHAR(3)",
+   "direction": "saída",
+   "semantic": "CST do IPI",
+   "before": null,
+   "after": null,
+   "confirmed_by_ui_diff": false,
+   "classification": "CONFIRMED_STRONG",
+   "confidence": "HIGH",
+   "binding_type": "DFM_DATAFIELD",
+   "evidence_basis": "DFM: TRzDBEdit RzDBEdit1 DataField=CST_IPI DataSource=dsproduto2 (qrproduto = select * from c000025)",
+   "dfm_control": {
+    "class": "TRzDBEdit",
+    "name": "RzDBEdit1",
+    "left": 97,
+    "top": 37,
+    "container_path": [
+     "pageview1",
+     "PageSheet13[Config. Impostos]",
+     "FlatGroupBox3[IPI]"
+    ]
+   },
+   "write_target": true,
+   "current_population": 1,
+   "sample_values": [
+    null,
+    "040"
+   ],
+   "notes": ""
+  },
+  {
+   "ui_label": "Código da origem da Mercadoria (0/1/2)",
+   "screen_area": "Config. Impostos",
+   "table": "C000025",
+   "field": "COD_ORIGEM_MERCADORIA",
+   "db_type": "INTEGER",
+   "direction": "n/a",
+   "semantic": "origem da mercadoria (0 Nacional, 1 Estrangeira-Importação Direta, 2 Estrangeira-Mercado Interno)",
+   "before": null,
+   "after": null,
+   "confirmed_by_ui_diff": false,
+   "classification": "CONFIRMED_STRONG",
+   "confidence": "HIGH",
+   "binding_type": "DFM_RADIO_ONCLICK_HIDDEN_EDIT",
+   "evidence_basis": "DFM: RgOrigemMercadoria (TRadioGroup, no DataField, OnClick=RgOrigemMercadoriaClick) + hidden data-aware TDBEdit CodOrigemMercadoria bound to COD_ORIGEM_MERCADORIA in the same tab, the only origin-bound control of the form; the handler and both symbols exist in the executable; values 0/1/2 observed in 5 databases",
+   "dfm_control": {
+    "class": "TDBEdit",
+    "name": "CodOrigemMercadoria",
+    "left": 424,
+    "top": 78,
+    "container_path": [
+     "frmproduto[PRODUTOS | Ficha de Cadastro]",
+     "pageview1",
+     "PageSheet13[Config. Impostos]"
+    ]
+   },
+   "write_target": true,
+   "current_population": 521,
+   "sample_values": [
+    "0",
+    "2"
+   ],
+   "notes": "Radio group RgOrigemMercadoria is not data-aware; a hidden data-aware edit bound to COD_ORIGEM_MERCADORIA sits beside it. The radio->edit copy lives in event code."
+  },
+  {
+   "ui_label": "IAT",
+   "screen_area": "Config. Impostos",
+   "table": "C000025",
+   "field": "IAT",
+   "db_type": "VARCHAR(1)",
+   "direction": "n/a",
+   "semantic": "arredondamento/truncamento (A/T)",
+   "before": null,
+   "after": null,
+   "confirmed_by_ui_diff": false,
+   "classification": "CONFIRMED_STRONG",
+   "confidence": "HIGH",
+   "binding_type": "DFM_DATAFIELD",
+   "evidence_basis": "DFM: TwwDBComboBox wwDBComboBox3 DataField=IAT DataSource=dsproduto2 (qrproduto = select * from c000025)",
+   "dfm_control": {
+    "class": "TwwDBComboBox",
+    "name": "wwDBComboBox3",
+    "left": 443,
+    "top": 199,
+    "container_path": [
+     "frmproduto[PRODUTOS | Ficha de Cadastro]",
+     "pageview1",
+     "PageSheet13[Config. Impostos]"
+    ]
+   },
+   "write_target": true,
+   "current_population": 521,
+   "sample_values": [
+    "A"
+   ],
+   "notes": ""
+  },
+  {
+   "ui_label": "Incidência",
+   "screen_area": "Config. Impostos",
+   "table": "C000025",
+   "field": "INCIDENCIA_PISCOFINS",
+   "db_type": "VARCHAR(30)",
+   "direction": "n/a",
+   "semantic": "tipo de incidência PIS/COFINS",
+   "before": null,
+   "after": null,
+   "confirmed_by_ui_diff": false,
+   "classification": "CONFIRMED_STRONG",
+   "confidence": "HIGH",
+   "binding_type": "DFM_DATAFIELD",
+   "evidence_basis": "DFM: TwwDBComboBox wwDBComboBox1 DataField=INCIDENCIA_PISCOFINS DataSource=dsproduto2 (qrproduto = select * from c000025)",
+   "dfm_control": {
+    "class": "TwwDBComboBox",
+    "name": "wwDBComboBox1",
+    "left": 530,
+    "top": 199,
+    "container_path": [
+     "frmproduto[PRODUTOS | Ficha de Cadastro]",
+     "pageview1",
+     "PageSheet13[Config. Impostos]"
+    ]
+   },
+   "write_target": true,
+   "current_population": 521,
+   "sample_values": [
+    "NENHUMA",
+    "MONOFÁSICA",
+    "SUBST.TRIBUTÁRIA"
+   ],
+   "notes": ""
+  },
+  {
+   "ui_label": "PIS/COFINS (combo)",
+   "screen_area": "Config. Impostos",
+   "table": "C000025",
+   "field": "PISCOFINS",
+   "db_type": "VARCHAR(1)",
+   "direction": "n/a",
+   "semantic": "flag PIS/COFINS (N/S)",
+   "before": null,
+   "after": null,
+   "confirmed_by_ui_diff": false,
+   "classification": "CONFIRMED_STRONG",
+   "confidence": "HIGH",
+   "binding_type": "DFM_DATAFIELD",
+   "evidence_basis": "DFM: TwwDBComboBox ecombo_piscofins DataField=PISCOFINS DataSource=dsproduto2 (qrproduto = select * from c000025)",
+   "dfm_control": {
+    "class": "TwwDBComboBox",
+    "name": "ecombo_piscofins",
+    "left": 706,
+    "top": 198,
+    "container_path": [
+     "frmproduto[PRODUTOS | Ficha de Cadastro]",
+     "pageview1",
+     "PageSheet13[Config. Impostos]"
+    ]
+   },
+   "write_target": true,
+   "current_population": 521,
+   "sample_values": [
+    "N",
+    "S"
+   ],
+   "notes": ""
+  },
+  {
+   "ui_label": "IPPT",
+   "screen_area": "Config. Impostos",
+   "table": "C000025",
+   "field": "IPPT",
+   "db_type": "VARCHAR(1)",
+   "direction": "n/a",
+   "semantic": "produção própria/terceiros (P/T)",
+   "before": null,
+   "after": null,
+   "confirmed_by_ui_diff": false,
+   "classification": "CONFIRMED_STRONG",
+   "confidence": "HIGH",
+   "binding_type": "DFM_DATAFIELD",
+   "evidence_basis": "DFM: TwwDBComboBox wwDBComboBox4 DataField=IPPT DataSource=dsproduto2 (qrproduto = select * from c000025)",
+   "dfm_control": {
+    "class": "TwwDBComboBox",
+    "name": "wwDBComboBox4",
+    "left": 774,
+    "top": 199,
+    "container_path": [
+     "frmproduto[PRODUTOS | Ficha de Cadastro]",
+     "pageview1",
+     "PageSheet13[Config. Impostos]"
+    ]
+   },
+   "write_target": true,
+   "current_population": 521,
+   "sample_values": [
+    "T",
+    "P"
+   ],
+   "notes": ""
+  }
+ ]
+}

docs/SGV_UI_MAPPING_SESSION_V1.md

@@ -0,0 +1,35 @@
+# SGV UI mapping session (operator sequence)
+
+Use ONLY the disposable TESTESOFICIAIS.FDB. For each row: (1) `python scripts/sgv_product_snapshot.py before <PRODUTO>`, (2) in the SGV Cadastro de Produto change ONLY the listed field and save, (3) `python scripts/sgv_product_snapshot.py diff <PRODUTO> --ui-label "<CAMPO_DA_TELA>"`. The tool records which column really changed; write_target becomes true from UI evidence only after that.
+
+Suggested product: `001434` (TESTE SEM CSOSN)
+
+| PRODUTO | CAMPO_DA_TELA | VALOR_ATUAL | VALOR_TEMPORARIO_SUGERIDO | COLUNA_HIPOTESE |
+|---|---|---|---|---|
+| 001434 | NCM | 62046200 | 22030000 | CLASSIFICACAO_FISCAL |
+| 001434 | CFOP saída | 5102 | 5405 | CFOP |
+| 001434 | CFOP entrada | None | 1102 | CFOP_ENTRADA |
+| 001434 | CST ICMS saída | 000 | 041 | CST |
+| 001434 | CST ICMS entrada | None | 040 | CST_ENTRADA |
+| 001434 | Alíquota ICMS | 21.5 | 12 | ALIQUOTA |
+| 001434 | CEST | None | 0601100 | CEST |
+| 001434 | CSOSN | None | 103 | CSOSN |
+| 001434 | ICMS (grupo) | None | 500 | GRUPO_ICMS |
+| 001434 | Situação tributária | T | I | SITUACAO_TRIBUTARIA |
+| 001434 | PIS entrada | 2 | 73 | COD_ENTRADA_PIS |
+| 001434 | PIS saída | 2 | 01 | COD_SAIDA_PIS |
+| 001434 | Alíquota PIS | 2 | 0,65 | ALIQ_PIS |
+| 001434 | COFINS entrada | 2 | 73 | COD_ENTRADA_COFINS |
+| 001434 | COFINS saída | 2 | 01 | COD_SAIDA_COFINS |
+| 001434 | Alíquota COFINS | 2 | 3 | ALIQ_COFINS |
+| 001434 | IPI | None | 5 | IPI |
+| 001434 | CST IPI | None | 50 | CST_IPI |
+| 001434 | EX TIPI | None | 1 | EX_TIPI |
+| 001434 | Origem | None | 1 | ORIGEM |
+| 001434 | Origem (código) | None | 1 | COD_ORIGEM_MERCADORIA |
+| 001434 | IAT | A | T | IAT |
+| 001434 | Incidência PIS/COFINS | NENHUMA | MONOFÁSICA | INCIDENCIA_PISCOFINS |
+| 001434 | IPPT | T | P | IPPT |
+| 001434 | Margem agregada | None | 30 | MARGEM_AGREGADA |
+
+After each check restore the original value in the SGV, then re-run `before` for the next field. Fields the screen does not show are skipped.

docs/SOURCE_REGISTRY_V1.md

@@ -0,0 +1,17 @@
+# SOURCE_REGISTRY_V1
+
+| DOMAIN | AUTHORITY | OFFICIAL_PAGE_URL | DIRECT_DOWNLOAD_URL | FORMAT | PUBLICATION_DATE | VERSION | EXPECTED_SCHEMA | PARSER_REQUIRED | AUTO_UPDATE_SUPPORTED |
+|---|---|---|---|---|---|---|---|---|---|
+| BA_ST_MVA | SEFAZ-BA | https://www.sefaz.ba.gov.br/administracao/ricms/ricms.htm | none | Official HTML/PDF annex | Source-controlled | RICMS/BA Anexo 1 vigente | CEST, NCM/SH, descricao, segmento, MVA, acordos, vigencia | Yes, versioned fail-closed | No: document structure must be monitored |
+| CFOP | ENCAT/Portal Nacional NF-e | https://www.nfe.fazenda.gov.br/portal/principal.aspx | none | Official portal document | Source-controlled | Vigente on retrieval | codigo, descricao, aplicacao, vigencia | Yes, versioned fail-closed | No |
+| CST_CSOSN | ENCAT/Portal Nacional NF-e and SPED/RFB | https://www.nfe.fazenda.gov.br/portal/principal.aspx | none | Official technical documentation | Source-controlled | Vigente on retrieval | domain, codigo, descricao, vigencia | Yes, versioned fail-closed | No |
+| PIS_COFINS | Receita Federal / SPED | https://sped.rfb.gov.br/ | none | Official Guia Pratico / tables | Source-controlled | EFD-Contribuicoes vigente | tabela, codigo, descricao, vigencia | Yes, versioned fail-closed | No |
+| TIPI_IPI | Receita Federal | https://www.gov.br/receitafederal/pt-br/acesso-a-informacao/legislacao/documentos-e-arquivos/tipi.xlsx/view | https://www.gov.br/receitafederal/pt-br/acesso-a-informacao/legislacao/documentos-e-arquivos/tipi.xlsx | XLSX | Published with file | TIPI file revision | NCM, descricao, aliquota IPI, vigencia | Yes, XLSX schema validation | Yes: stable official file URL |
+| CCLASSTRIB_IBSCBS | ENCAT/Portal Nacional NF-e | https://www.nfe.fazenda.gov.br/portal/principal.aspx | none | Official RTC technical documentation | Source-controlled | RTC version on retrieval | CST IBS/CBS, cClassTrib, cCredPres, aliquotas, vigencia | Yes, versioned fail-closed | No |
+| FCP | ENCAT/Portal Nacional NF-e | https://www.nfe.fazenda.gov.br/portal/principal.aspx | none | No single national canonical table identified | N/A | N/A | UF, aliquota, vigencia, legal source | Not until a primary per-UF source registry exists | No |
+| MONOFASICO_ICMS | ENCAT/Portal Nacional NF-e | https://www.nfe.fazenda.gov.br/portal/principal.aspx | none | Official technical documentation | Source-controlled | Vigente on retrieval | produto, codigo ANP, aliquota, vigencia | Yes, versioned fail-closed | No |
+| ANP | Agencia Nacional do Petroleo | https://www.gov.br/anp/pt-br/assuntos/qualidade-de-produtos/registro-de-produtos | none | Official portal document/data publication | Source-controlled | Vigente on retrieval | codigo ANP, descricao, produto, vigencia | Yes, versioned fail-closed | No |
+
+## Limitations
+
+The Portal Nacional NF-e and SPED pages are primary authorities but do not expose a verified, stable public structured download URL for the listed domains. Their importers must retain the official document payload, record its parser version, and fail closed on structural change. FCP has no single nationally authoritative rate table: a canonical implementation requires a separate registry of each UF's primary normative publication; no aggregate source may be used.

docs/SOURCE_REGISTRY_V2.md

@@ -0,0 +1,122 @@
+# SOURCE_REGISTRY_V2
+
+Supersedes `SOURCE_REGISTRY_V1.md` (kept for history). Every dataset here
+follows the same lifecycle: acquire → hash → parse → normalize → validate →
+persist → smoke → `ACTIVE`. A failed reimport never silently replaces a
+valid `ACTIVE` version (see `central/scripts/import_ba_st_mva.py`'s >10%
+record-loss gate for a concrete example of that guard).
+
+**Update**: the 9 domains this file originally listed as `FAILED` (external
+acquisition blocker) were re-attempted after the operator manually placed
+the official files that were blocked by the Portal NF-e/SPED session gate
+into `sources/raw/bootstrap_v1/`. 6 of those 9 are now `ACTIVE`. The
+remaining 3 (ICMS Monofásico, RTC cClassTrib, RTC Alíquotas CBS) plus all 8
+PIS/COFINS Tabela 4.3.10–4.3.17 files are `MISSING_BOOTSTRAP_FILE` — no
+file for them was provided, which is a different, more precise status than
+"FAILED": it means acquisition is still blocked, not that something broke.
+
+Every new file's domain was confirmed by its actual sheet names and header
+row, never by filename alone (see "Identification evidence" below).
+
+## Domains ACTIVE (preserved from before this session)
+
+| DOMAIN | AUTHORITY | SOURCE | RAW_SHA256 (prefix) | PARSER_VERSION | RECORD_COUNT | STATUS |
+|---|---|---|---|---|---|---|
+| NCM | Receita Federal / Siscomex | Previously-fetched Siscomex JSON | `3abc0d2eb2501...` | ncm-v1 | 15156 | ACTIVE (preserved, no internet to re-verify) |
+| TIPI_IPI | Receita Federal | `1 TIPI 2022 - Atualizada ADE 001-2026.xlsx` | `d155f1baafb40...` | tipi-xlsx-v1 | 11103 | ACTIVE (hash-verified unchanged) |
+| CEST | CONFAZ Convênio ICMS 142/18 | Previously-fetched CONFAZ HTML | `d7fb7e8da0ace...` | cest-html-v1 | 1051 | ACTIVE (preserved) |
+| BA_ST_MVA | SEFAZ-BA / RICMS-BA Anexo 1 | `decreto_2012_13780_ricms_anexo_1_vigente_2026.pdf` | `e07e908595...` | ba-st-mva-pdf-v1 | 303 | ACTIVE (re-imported, content identical) |
+| ORIGEM_MERCADORIA / CST_ICMS / CSOSN / CST_PIS / CST_COFINS | Receita Federal / ENCAT (MOC 7.0 Anexo I) | `moc7-anexo-i-leiaute-e-rv.pdf` | `5eb4cf2010b1...` | moc7-tables-v1 | 9 / 11 / 10 / 33 / 33 | ACTIVE |
+
+## Domains ACTIVE this session (bootstrap_v1 operator-supplied files)
+
+| DOMAIN | AUTHORITY | FILE | RAW_SHA256 (prefix) | PARSER_VERSION | RECORD_COUNT | IDENTIFICATION EVIDENCE |
+|---|---|---|---|---|---|---|
+| CFOP | Portal Nacional NF-e, Informe Técnico 2023.002 v2.10 | `IT_2023_002_v2_10_Tabela_CFOP_Descrição.xlsx` (an identical PDF of the same IT is also present, kept as a cross-check copy, not separately imported) | `c95c91ed1644...` | cfop-xlsx-v1 | 619 | Sheet literally named `CFOP`; header row is `CFOP, Início de vigência, Fim de vigência, indNFe, indComunica, indTransp, indDevol, indRetor, indAnula, indRemes, indComb, indExcIBSCBS, Título do CFOP, Descrição` — the exact official field set, including the newer `indExcIBSCBS` (Reforma Tributária) column |
+| FCP | Portal Nacional NF-e | `Tabela_Alíquotas_FCP_por_UF_2025-02_07.xlsx` | `3079d08816...` | fcp-xlsx-v1 | 27 (26 states + DF) | Sheet `FCP`; header `cUF, UF, Nome UF, Aliq_1, Aliq_2, Aliq_3, ., Observação`; every Brazilian UF present exactly once |
+| ANP | Portal Nacional NF-e | `Tabela_Codigo_Produto_ANP-20241118.xlsx` | `8271a80007...` | anp-xlsx-v1 | 1031 | Sheet `cProdANP`; single-column header `cProdANP` — confirmed this really is the NF-e portal's validation code list (no description column exists in the official source; not invented) |
+| NCM_UTRIB | Portal Nacional NF-e, Informe Técnico 2024.001 v2.40 | `IT2024.001v2.40 - Tabela NCM 2022 com Utrib_Comércio Exterior_vigência 01.10.26.xlsx` | `afc8bfc94c...` | ncm-utrib-xlsx-v1 | 10516 | Sheet `NCM X uTrib_Vig 1-10-2026`; header `NCM, Início de vigência da NCM, Fim de vigência da NCM, uTrib..., Descrição da uTrib...`; effective from 2026-10-01 (only version present — no history to preserve) |
+| RTC_BIOFUEL_INDEX | Portal Nacional NF-e, Informe Técnico 2025.004 v1.20 | `IT 2025.004 v.1.20 - Tabela de Índice.xlsx` | `c49a01150...` | rtc-biofuel-index-xlsx-v1 | 23 (14 current + 9 historical) | Two sheets, `pBioObrigatorio` and `pBioObrigatorio_Historico`; header `cProdANP, Descrição, pBio (% Anidro Obrigatorio), Início de vigência, Fim de vigência`; both current and historical rows preserved (`is_historical` flag), forward-filling only the repeated `cProdANP`/`Descrição` a historical block shares with its preceding row — never inventing new values |
+| RTC_CCREDPRES | Portal Nacional NF-e / LC 214/2025 | `cCredPres_2026-06-22.xlsx` | `65f246139...` | rtc-cred-pres-xlsx-v1 | 13 | Sheet `cCredPres`; header has 18 real official columns (`LC 214/2025`, `Apropria via NF?`, `ind_gCBSCredPres`, `Alíquota CBS`, `pAliqCredPresCBS`, `dIniVigCBS`, etc.) — all 18 preserved as distinct typed columns, not reduced to code+description |
+
+Bug found and fixed mid-import: `rtc_cred_pres_entries.cclass_nota_referenciada`
+was originally `VARCHAR(16)` (assumed always a numeric class code); several
+official rows carry free text there instead (e.g. `"cClass de alíquota
+zero"`), which Postgres rejected with a truncation error on insert.
+Migration `0009` widens it to `Text`; no data was lost or silently truncated
+— the import failed closed and was retried after the fix (see `Dataset`
+history: the first failed attempt left no orphan row, confirmed via
+`ROLLBACK`).
+
+New read-only API endpoints for these domains (used by the coverage script,
+reusable for future classifier work): `GET /v1/reference/cfop/{code}`,
+`/v1/reference/ncm_utrib/{ncm}`, `/v1/reference/anp/{cprod_anp}`,
+`/v1/reference/fcp/{uf}`.
+
+## Domains MISSING_BOOTSTRAP_FILE (still blocked — no file provided)
+
+Not `FAILED` (which implied a broken acquisition attempt) — these simply
+have no corresponding file in `sources/raw/bootstrap_v1/` yet. The Portal
+Nacional NF-e (`nfe.fazenda.gov.br`) remains the authority for all of them;
+this session's Bash tool has zero DNS/internet resolution and the built-in
+browser was denied navigation into the portal's document sections on every
+attempt after one initial homepage load (see prior evidence, unchanged this
+session — this mission's instructions explicitly said not to attempt
+internet access again).
+
+| DOMAIN | AUTHORITY | STATUS |
+|---|---|---|
+| ICMS Monofásico — Combustíveis | Portal Nacional NF-e | MISSING_BOOTSTRAP_FILE |
+| RTC — cClassTrib (IBS/CBS) | Portal Nacional NF-e | MISSING_BOOTSTRAP_FILE |
+| RTC — Alíquotas CBS | Portal Nacional NF-e | MISSING_BOOTSTRAP_FILE |
+| PIS/COFINS Tabela 4.3.10 (alíquotas diferenciadas) | Receita Federal / SPED | MISSING_BOOTSTRAP_FILE |
+| PIS/COFINS Tabela 4.3.11 (alíquota por unidade) | Receita Federal / SPED | MISSING_BOOTSTRAP_FILE |
+| PIS/COFINS Tabela 4.3.12 (substituição tributária) | Receita Federal / SPED | MISSING_BOOTSTRAP_FILE |
+| PIS/COFINS Tabela 4.3.13 (alíquota zero) | Receita Federal / SPED | MISSING_BOOTSTRAP_FILE |
+| PIS/COFINS Tabela 4.3.14 (isenção) | Receita Federal / SPED | MISSING_BOOTSTRAP_FILE |
+| PIS/COFINS Tabela 4.3.15 (sem incidência) | Receita Federal / SPED | MISSING_BOOTSTRAP_FILE |
+| PIS/COFINS Tabela 4.3.16 (suspensão) | Receita Federal / SPED | MISSING_BOOTSTRAP_FILE |
+| PIS/COFINS Tabela 4.3.17 (demais alíquotas diferenciadas) | Receita Federal / SPED | MISSING_BOOTSTRAP_FILE |
+
+```
+BLOCKER_EXACT=No file for ICMS Monofásico, RTC cClassTrib, RTC Alíquotas CBS, or any of the 8 PIS/COFINS Tabela 4.3.10-17 documents exists in sources/raw/bootstrap_v1/; the Portal Nacional NF-e/SPED remains unreachable from this environment (unchanged from the prior mission's evidence; not re-tested per this mission's explicit "não tente acessar internet" instruction).
+EVIDENCE=find sources/raw -type f lists 11 files; none match these domains by content (only CFOP/FCP/ANP/NCM_UTRIB/RTC_BIOFUEL_INDEX/RTC_CCREDPRES files were provided).
+OPERATOR_ACTION_REQUIRED=Place the corresponding official files into sources/raw/bootstrap_v1/ (or a new bootstrap_v3/) for a future mission to identify, hash, and import the same way this session did for the other 6.
+```
+
+## Scope prioritization (business scope, 2026-09-19)
+
+GTI clients: restaurants, markets, clothing/retail, workshops, general commerce.
+No fuel stations; no EFD-Contribuições/SPED in product scope. "Every Brazilian
+fiscal table" is NOT an MVP requirement. Nothing below is a technical error and
+no existing support was removed.
+
+**CORE_MVP (required):** NCM, TIPI_IPI, CEST, BA_ST_MVA, CFOP, ORIGIN, CST_ICMS,
+CSOSN, CST_PIS, CST_COFINS, FCP, RTC_CCLASSTRIB, RTC_CCREDPRES, RTC_CBS_RATES.
+ACTIVE: all except RTC_CCLASSTRIB and RTC_CBS_RATES (`MISSING_BOOTSTRAP_FILE`).
+
+| DOMAIN | SCOPE STATUS |
+|---|---|
+| ICMS_MONOPHASIC | OUT_OF_SCOPE_MVP (reason: fuel/station segment is not the target audience) |
+| ANP | ACTIVE_REFERENCE_ONLY (no further rules for MVP) |
+| RTC_BIOFUEL_INDEX | ACTIVE_REFERENCE_ONLY (no further rules for MVP) |
+| PIS_COFINS_4_3_10..4_3_17 | DEFERRED_BY_BUSINESS_SCOPE (not required for deploy; measure need later from client data) |
+
+CST_PIS / CST_COFINS basic code domains stay ACTIVE.
+
+### Operator action — the two remaining CORE files
+Place in `sources/raw/bootstrap_v1/` (Portal Nacional NF-e, Reforma Tributária / RTC area):
+1. **RTC_CCLASSTRIB** — official cClassTrib table (IBS/CBS classificação tributária, xlsx) with CST/cClassTrib codes and their descriptions/indicators.
+2. **RTC_CBS_RATES** — official CBS rates table (alíquotas CBS, xlsx) with rate and validity dates.
+Status until then: `MISSING_BOOTSTRAP_FILE` (verified: no matching file locally).
+
+## Update 2026-09-19 — CORE MVP closed (RTC_CCLASSTRIB + RTC_CBS_RATES ACTIVE)
+
+Both files identified by sheet names/headers, not filename.
+
+| DOMAIN | FILE | SHA256 (prefix) | PARSER | RECORDS | EVIDENCE |
+|---|---|---|---|---|---|
+| RTC_CCLASSTRIB | `cClassTrib 2026-06-22.xlsx` | `1448cb63a41b...` | rtc-cclasstrib-xlsx-v1 | 164 cClassTrib + 18 CST-IBS/CBS | Sheets `CST 2026-06-01 Pub` (CST, description, ind_* flags) and `cClass 2026-06-01 Pub` (CST, cClassTrib, name, description, LC/regulamento refs, tipo de alíquota, pRedIBS/pRedCBS, dIniVig/dFimVig, ind_* per document model, ANEXO, Link). All official columns kept (key fields typed, ind_* in JSON). Every cClass CST exists in the CST sheet; cClassTrib unique; dIniVig 2026-01-01; 3 rows have dFimVig |
+| RTC_CBS_RATES | `IT 2026.002 v.1.00 - Aliquotas da CBS.xlsx` | `33f17aa332...` | rtc-cbs-rates-xlsx-v1 | 2 | Title "Aliquota da CBS", header Ano/Alíquota: 2026 = 0.009; 2027 = "aguarda legislação" (kept as text, rate NULL — not invented) |
+
+Migration 0010 (3 tables). Reimport idempotent (same dataset ids 49/50, no new rows). Both kinds are in `dataset_versions()` (cache fingerprint changes naturally). New endpoints: `GET /v1/reference/rtc_cclasstrib/{code}`, `/v1/reference/rtc_cbs_rate/{year}`. CORE MVP domains: all 14 ACTIVE. Coverage: `docs/FISCAL_COVERAGE_FULL_V3.json`.

docs/runs/audit_TESTESOFICIAIS.json

@@ -0,0 +1,82 @@
+{
+ "database": "TESTESOFICIAIS.FDB",
+ "mode": "READ_ONLY",
+ "firebird_server_version": "WI-V6.3.9.27139 Firebird 2.5",
+ "ods": "11.2",
+ "schema_fingerprint": "e2409c9b9e51b84d056939e6e7d0f1381440e6a7c02ec99583d61e2de13d7742",
+ "tables": 334,
+ "company": {
+  "status": "OK",
+  "uf": "BA",
+  "crt": "1"
+ },
+ "C000025_present": true,
+ "field_mapping_compatibility": {
+  "CLASSIFICACAO_FISCAL": "OK",
+  "NCM": "OK",
+  "CFOP": "OK",
+  "CFOP_ENTRADA": "OK",
+  "CST": "OK",
+  "CST_ENTRADA": "OK",
+  "ALIQUOTA": "OK",
+  "CEST": "OK",
+  "CSOSN": "OK",
+  "IPI": "OK",
+  "EX_TIPI": "OK",
+  "CST_IPI": "OK",
+  "COD_ENTRADA_PIS": "OK",
+  "COD_SAIDA_PIS": "OK",
+  "ALIQ_PIS": "OK",
+  "COD_ENTRADA_COFINS": "OK",
+  "COD_SAIDA_COFINS": "OK",
+  "ALIQ_COFINS": "OK",
+  "ORIGEM": "OK",
+  "COD_ORIGEM_MERCADORIA": "OK",
+  "IAT": "OK",
+  "INCIDENCIA_PISCOFINS": "OK",
+  "IPPT": "OK",
+  "GRUPO_ICMS": "OK",
+  "SITUACAO_TRIBUTARIA": "OK",
+  "MARGEM_AGREGADA": "OK"
+ },
+ "field_mapping_compatibility_summary": {
+  "OK": 26,
+  "MISSING": 0,
+  "TYPE_DIFFERS": 0
+ },
+ "product_count": 521,
+ "ncm_coverage": {
+  "eight_digits": 518,
+  "blank": 0,
+  "other_format": 3,
+  "share_eight_digits": 0.9942
+ },
+ "fiscal_field_population": {
+  "CLASSIFICACAO_FISCAL": 521,
+  "NCM": 0,
+  "CFOP": 498,
+  "CFOP_ENTRADA": 0,
+  "CST": 521,
+  "CST_ENTRADA": 0,
+  "ALIQUOTA": 521,
+  "CEST": 5,
+  "CSOSN": 497,
+  "IPI": 109,
+  "EX_TIPI": 0,
+  "CST_IPI": 1,
+  "COD_ENTRADA_PIS": 2,
+  "COD_SAIDA_PIS": 3,
+  "ALIQ_PIS": 2,
+  "COD_ENTRADA_COFINS": 2,
+  "COD_SAIDA_COFINS": 3,
+  "ALIQ_COFINS": 2,
+  "ORIGEM": 0,
+  "COD_ORIGEM_MERCADORIA": 1,
+  "IAT": 521,
+  "INCIDENCIA_PISCOFINS": 521,
+  "IPPT": 521,
+  "GRUPO_ICMS": 489,
+  "SITUACAO_TRIBUTARIA": 520,
+  "MARGEM_AGREGADA": 0
+ }
+}

docs/runs/ba_old_dataset.txt

@@ -0,0 +1,969 @@
+1.0||2018
+1.0||01.019.00
+1.0||01.062.01
+1.0||01.112.00
+1.0||01.127.00
+1.0||01.128.00
+1.0||01.999.00
+1.0||01.015.00
+1.0||24.540
+3.3|03.003.00|2201.1
+3.3|03.003.00|2201.9
+3.3.1|03.003.01|2201.1
+3.3.1|03.003.01|2201.9
+3.5.0|03.005.00|2201.1
+3.5.0|03.005.00|2201.9
+3.5.1|03.005.01|2201.1
+3.5.1|03.005.01|2201.9
+3.5.2|03.005.02|2201.1
+3.5.2|03.005.02|2201.9
+3.5.3|03.005.03|2201.1
+3.5.3|03.005.03|2201.9
+3.5.4|03.005.04|2201.1
+3.5.4|03.005.04|2201.9
+3.5.5|03.005.05|2201.1
+3.5.5|03.005.05|2201.9
+3.6|03.006.00|2201.1
+3.6|03.006.00|03.003.00
+3.6|03.006.00|03.003.01
+03.005.00||03.005.05
+03.005.00||03.024.00
+03.005.00||03.025.00
+3.7||03.007.00
+03.008.00||2202
+3.9|03.010.00|2202.10
+3.9|03.010.00|2202.99
+3.9.1|03.010.01|2202.10
+3.9.1|03.010.01|2202.99
+3.9.2|03.010.02|2202.10
+3.9.2|03.010.02|2202.99
+3.10|03.011.00|2202.10
+3.10|03.011.00|2202.99
+3.10|03.011.00|03.010.00
+3.10|03.011.00|03.010.01
+3.10|03.011.00|03.010.02
+3.10|03.011.00|03.011.01
+3.11.0|03.012.00|2106.90.1
+3.11.0|03.012.00|03.012.01
+3.11.1|03.012.01|2106.90.1
+3.12.0|03.013.00|2106.9
+3.12.0|03.013.00|2202.99
+3.12.1|03.013.01|2106.9
+3.12.1|03.013.01|2202.99
+3.12.2|03.013.02|2106.9
+3.12.2|03.013.02|2202.99
+3.14|03.015.00|2106.9
+3.14|03.015.00|2202.99
+3.16.0|03.021.00|2203
+3.16.1|03.021.01|2203
+3.16.2|03.021.02|2203
+3.16.3|03.021.03|2203
+3.16.4|03.021.04|2203
+3.16.5|03.021.05|2203
+3.16.6|03.021.06|2203
+3.17.0|03.022.00|2202.91
+3.17.1|03.022.01|2202.91
+3.17.2|03.022.02|2202.91
+3.17.3|03.022.03|2202.91
+3.17.4|03.022.04|2202.91
+3.17.5|03.022.05|2202.91
+3.17.6|03.022.06|2202.91
+3.18|03.023.00|2203
+3.19|02.003.00|2208.9
+3.20|03.024.00|2201.1
+3.21|03.025.00|2201.1
+4.1|04.001.00|2402
+4.2|04.002.00|2403.1
+5.1|05.001.00|2523
+6.1|06.001.01|2207.10.9
+6.4|06.004.00|2710.19.19
+6.4|06.004.00|32.5
+6.5|06.005.00|2710.19.11
+6.5|06.005.00|63.52
+6.5|06.005.00|32.5
+6.6.9|06.006.09|2710.19.2
+06.006.10||06.006.11
+6.6.10|06.006.10|2710.19.2
+6.6.11|06.006.11|2710.19.22
+6.7|06.007.00|2710.19.3
+6.8.0|06.008.00|2710.19.9
+6.8.1|06.008.01|2710.19.9
+6.9|06.009.00|2710.9
+6.10|06.010.00|2711
+6.12|06.012.00|2711.11
+6.13|06.013.00|2711.21
+6.14|06.014.00|2711.29.9
+6.15|06.015.00|2713
+6.17|06.017.00|3403
+6.18|06.018.00|2710.2
+6.19|06.019.00|2710.12.49
+7.1|09.001.00|8539
+7.1|09.001.00|09.001.00
+7.2|09.002.00|8540
+7.2|09.002.00|09.002.00
+7.3|09.003.00|8504.1
+7.4|09.004.00|8536.5
+7.4|09.004.00|09.004.00
+7.5|09.005.00|8539.52
+7.5|09.005.00|09.005.00
+8.1|10.001.00|2522
+8.2|10.002.00|3816.00.1
+8.2|10.002.00|3824.5
+8.3|10.003.00|3214.9
+8.4|10.004.00|3910
+8.5|10.005.00|3916
+8.6|10.006.00|3917
+8.7|10.007.00|3918
+8.8|10.008.00|3919
+8.9|10.009.00|3919
+8.9|10.009.00|3920
+8.9|10.009.00|3921
+8.10|10.010.00|3921
+8.11|10.011.00|3921
+8.12|10.012.00|3921
+8.12|10.012.00|10.010.00
+8.12|10.012.00|10.011.00
+8.13|10.013.00|3922
+8.14|10.014.00|3924
+8.15|10.015.00|3925.1
+8.16|10.016.00|3925.9
+8.17|10.017.00|3925.1
+8.17|10.017.00|3925.9
+8.17|10.017.00|10.015.00
+8.17|10.017.00|10.016.00
+8.18|10.018.00|3925.2
+8.19|10.019.00|3925.3
+8.19|10.019.00|24.540
+8.19|10.019.00|10.019.00
+8.20|10.020.00|3926.9
+8.21|10.021.00|4814
+8.22|10.022.00|6810.19
+8.24|10.024.00|6811
+8.25|10.025.00|6901
+8.26|10.026.00|6902
+8.27|10.027.00|6904
+8.28|10.028.00|6905
+8.29|10.029.00|6906
+8.30.0|10.030.00|6907
+8.30.1|10.030.01|6907
+8.30.1|10.030.01|10.030.00
+8.31|10.031.00|6910
+8.32|10.032.00|6912
+8.33|10.033.00|7003
+8.33|10.033.00|24.540
+8.33|10.033.00|10.033.00
+8.34|10.034.00|7004
+8.34|10.034.00|24.540
+8.34|10.034.00|10.034.00
+8.35|10.035.00|7005
+8.35|10.035.00|24.540
+8.35|10.035.00|10.035.00
+8.36|10.036.00|7007.19
+8.36|10.036.00|24.540
+8.36|10.036.00|10.036.00
+8.37|10.037.00|7007.29
+8.38|10.038.00|7008
+8.38|10.038.00|24.540
+8.38|10.038.00|10.038.00
+8.39|10.039.00|7016
+8.40|10.040.00|7214.2
+8.41|10.041.00|7308.90.1
+8.41.1|10.041.01|7308.90.1
+8.42|10.042.00|7214.2
+8.43|10.043.00|7213
+8.44|10.044.00|7217.10.9
+8.44.1|10.044.00|7312
+8.45.0|10.045.00|7217.20.1
+8.45.1|10.045.01|7217.20.9
+8.46|10.046.00|7307
+8.47|10.047.00|7308.3
+8.48|10.048.00|7308.4
+8.48|10.048.00|7308.9
+8.49|10.049.00|7308.4
+8.50|10.050.00|7308.90.9
+8.51|10.051.00|7310
+8.52|10.052.00|7313
+8.53|10.053.00|7314
+8.54|10.054.00|7315.11
+8.55|10.055.00|7315.12.9
+8.56|10.056.00|7315.82
+8.57|10.057.00|7317
+8.58|10.058.00|7318
+8.59.0|10.059.00|7323
+8.59.0|10.059.00|7323.10.00
+8.59.1|10.059.01|7323
+8.59.1|10.059.01|7323.10.00
+8.60|10.060.00|7324
+8.61|10.061.00|7325
+8.62|10.062.00|7326
+8.63|10.063.00|7407
+8.64|10.064.00|7411.10.1
+8.65|10.065.00|7412
+8.66|10.066.00|7415
+8.67|10.067.00|7418.2
+8.68|10.068.00|7607.19.9
+8.69|10.069.00|7608
+8.70|10.070.00|7609.00.00
+8.71|10.071.00|7610
+8.71|10.071.00|9406
+8.72|10.072.00|7615.20.00
+8.73|10.073.00|7616
+8.74|10.074.00|8302.41.00
+8.75|10.075.00|8301
+8.76|10.076.00|8302.10.00
+8.77|10.077.00|8307
+8.78|10.078.00|8311
+8.79|10.079.00|8481
+8.80|10.080.00|7009
+8.80|10.080.00|24.540
+9.0||24.540
+9.1.0|13.001.00|3003
+9.1.0|13.001.00|3004
+9.1.1|13.001.01|3003
+9.1.1|13.001.01|3004
+9.1.2|13.001.02|3003
+9.1.2|13.001.02|3004
+9.2.0|13.002.00|3003
+9.2.0|13.002.00|3004
+9.2.1|13.002.01|3003
+9.2.1|13.002.01|3004
+9.2.2|13.002.02|3003
+9.2.2|13.002.02|3004
+9.3.0|13.003.00|3003
+9.3.0|13.003.00|3004
+9.3.1|13.003.01|3003
+9.3.1|13.003.01|3004
+9.3.2|13.003.02|3003
+9.3.2|13.003.02|3004
+9.4.0|13.004.00|3003
+9.4.0|13.004.00|3004
+9.4.1|13.004.01|3003
+9.4.1|13.004.01|3004
+9.4.2|13.004.02|3003
+9.4.2|13.004.02|3004
+9.5.0|13.005.00|3006.6
+9.5.0|13.005.00|29.37
+9.5.1|13.005.01|3006.6
+9.5.1|13.005.01|29.37
+9.5.2|13.005.02|3006.6
+9.5.2|13.005.02|29.37
+9.5.3|13.005.03|3006.6
+9.5.3|13.005.03|29.37
+9.5.4|13.005.04|3006.6
+9.5.4|13.005.04|29.37
+9.5.5|13.005.05|3006.6
+9.5.5|13.005.05|29.37
+9.6|13.006.00|2936
+9.7.0|13.007.00|3006.3
+9.7.1|13.007.01|3006.3
+9.8.0|13.008.00|3002
+9.8.1|13.008.01|3002
+9.9.0|13.009.00|3002
+9.9.1|13.009.01|3002
+9.10.0|13.010.00|3005.10.1
+9.10.1|13.010.01|3005.10.1
+9.11|13.011.00|3005
+9.12|13.012.00|4015.12
+9.12|13.012.00|4015.19
+9.13|13.013.00|4014.1
+9.14|13.014.00|9018.31
+9.15|13.015.00|9018.32.1
+9.16|13.016.00|3926.90.9
+9.16|13.016.00|9018.90.99
+9.16|13.016.00|24.540
+9.16|13.016.00|13.001.00
+9.16|13.016.00|3003
+9.16|13.016.00|3004
+9.1.1|13.001.01|3003
+9.1.1|13.001.01|3004
+9.1.2|13.001.02|3003
+9.1.2|13.001.02|3004
+9.2.0|13.002.00|3003
+9.2.0|13.002.00|3004
+9.2.1|13.002.01|3003
+9.2.1|13.002.01|3004
+9.2.2|13.002.02|3003
+9.2.2|13.002.02|3004
+9.3.0|13.003.00|3003
+9.3.0|13.003.00|3004
+9.3.1|13.003.01|3003
+9.3.1|13.003.01|3004
+9.3.2|13.003.02|3003
+9.3.2|13.003.02|3004
+9.4.0|13.004.00|3003
+9.4.0|13.004.00|3004
+9.4.1|13.004.01|3003
+9.4.1|13.004.01|3004
+9.4.2|13.004.02|3003
+9.4.2|13.004.02|3004
+9.5.0|13.005.00|3006.6
+9.5.0|13.005.00|29.37
+9.5.1|13.005.01|3006.6
+9.5.1|13.005.01|29.37
+9.5.2|13.005.02|3006.6
+9.5.2|13.005.02|29.37
+9.5.3|13.005.03|3006.6
+9.5.3|13.005.03|29.37
+9.5.4|13.005.04|3006.6
+9.5.4|13.005.04|29.37
+9.5.5|13.005.05|3006.6
+9.5.5|13.005.05|29.37
+9.6|13.006.00|2936
+9.7.0|13.007.00|3006.3
+9.7.1|13.007.01|3006.3
+9.8.0|13.008.00|3002
+9.8.1|13.008.01|3002
+9.9.0|13.009.00|3002
+9.9.1|13.009.01|3002
+9.10.0|13.010.00|3005.10.1
+9.10.1|13.010.01|3005.10.1
+9.11|13.011.00|3005
+9.12|13.012.00|4015.12
+9.12|13.012.00|4015.19
+9.13|13.013.00|4014.1
+9.14|13.014.00|9018.31
+9.15|13.015.00|9018.32.1
+9.16|13.016.00|3926.90.9
+9.16|13.016.00|9018.90.99
+10.1|16.001.00|4011
+10.1|16.001.00|10.1
+10.2|16.002.00|4011
+10.2|16.002.00|10.2
+10.3|16.003.00|4011
+10.3|16.003.00|10.3
+10.4|16.004.00|4011
+10.4|16.004.00|16.005.00
+10.4|16.004.00|10.4
+10.5|16.005.00|4011.5
+10.6.0|16.007.00|4012.9
+16.007.01||10.6.0
+10.6.1|16.007.01|4012.9
+10.7|16.008.00|4013
+10.7|16.008.00|16.009.00
+10.7|16.008.00|10.7
+10.8|16.009.00|4013.2
+17.044.27||1101.00.1
+11.2|17.045.00|1101.00.2
+11.3|17.046.05|17.046.09
+11.3|17.046.05|1901.2
+11.3|17.046.05|1901.90.9
+17.046.14||1901
+11.4.1|17.046.16|1901.2
+11.4.1|17.046.16|1901.90.9
+17.046.10||17.046.15
+11.5||1001
+11.6.0|17.047.01|1902.3
+11.6.1|17.048.00|1902
+11.6.1|17.048.00|17.047.00
+11.6.1|17.048.00|17.048.01
+11.6.1|17.048.00|17.048.02
+11.6.2|17.048.02|1902.20.00
+11.7.2|17.049.02|1902.11
+11.7.3|17.049.03|1902.19
+11.7.4|17.049.04|1902.19
+11.7.5|17.049.05|1902.19
+11.7.6|17.049.06|1902.11
+11.7.7|17.049.07|1902.11
+11.8|17.050.00|1905.2
+11.9|17.051.00|1905.20.9
+11.10|17.052.00|1905.20.1
+11.16|17.059.00|1905.4
+11.17|17.060.00|1905.90.1
+11.18.0|17.062.00|1905.90.90
+11.18.0|17.062.00|17.062.03
+11.18.1|17.062.01|1905.90.90
+11.18.1|17.062.01|17.062.02
+11.18.1|17.062.01|17.062.03
+11.18.2|17.062.02|1905.90.2
+11.18.2|17.062.02|1905.90.9
+11.18.3|17.062.03|1905.90.9
+11.19|17.063.00|1905.1
+11.20|17.064.00|1905.9
+11.21|17.083.00|0210.2
+11.21|17.083.00|0210.99
+11.21|17.083.00|1502
+11.22|17.084.00|0201
+11.22|17.084.00|0202
+11.22|17.084.00|0204
+11.22|17.084.00|0206
+11.23|17.085.00|0204
+11.24||17.086.00
+11.24||0210.99
+11.24||1502.10.19
+11.24||1502.9
+11.25.0|17.087.00|0207
+11.25.0|17.087.00|0209
+11.25.0|17.087.00|0210.99
+11.25.0|17.087.00|1501
+11.25.0|17.087.00|17.087.02
+11.25.1||17.087.01
+11.25.1||0203
+11.25.1||0206
+11.25.1||0209
+11.25.1||0210.1
+11.25.1||0210.99
+11.25.1||1501
+11.25.2|17.087.02|0207.1
+11.25.2|17.087.02|0207.2
+15.1|23.001.00|2105
+15.1|23.001.00|15.1
+15.1|23.001.00|23.001.00
+16.1|24.001.00|3208
+16.1|24.001.00|3209
+16.1|24.001.00|3210
+16.1|24.001.00|16.1
+16.2|24.002.00|2821
+16.2|24.002.00|3204.17
+16.2|24.002.00|3206
+16.2|24.002.00|3206.11.10
+16.2|24.002.00|16.2
+16.2.1|24.002.01|2821
+16.2.1|24.002.01|3204.17
+16.2.1|24.002.01|3206
+16.2.1|24.002.01|3206.11.10
+16.2.1|24.002.01|16.2.1
+16.3|24.003.00|3204
+16.3|24.003.00|3205
+16.3|24.003.00|3206
+16.3|24.003.00|3212
+16.3|24.003.00|16.3
+17.1|25.001.00|8702.1
+17.2|25.002.00|8702.40.9
+17.3|25.003.00|8703.21
+17.3|25.003.00|1000
+17.4|25.004.00|8703.22.1
+17.4|25.004.00|1000
+17.4|25.004.00|1500
+17.5|25.005.00|8703.22.9
+17.5|25.005.00|1000
+17.5|25.005.00|1500
+17.6|25.006.00|8703.23.1
+17.6|25.006.00|1500
+17.6|25.006.00|3000
+17.7|25.007.00|8703.23.9
+17.7|25.007.00|1500
+17.7|25.007.00|3000
+17.8|25.008.00|8703.24.1
+17.8|25.008.00|3000
+17.9|25.009.00|8703.24.9
+17.9|25.009.00|3000
+17.10|25.010.00|8703.32.1
+17.10|25.010.00|1500
+17.10|25.010.00|2500
+17.11|25.011.00|8703.32.9
+17.11|25.011.00|1500
+17.11|25.011.00|2500
+17.12|25.012.00|8703.33.1
+17.12|25.012.00|2500
+17.13|25.013.00|8703.33.9
+17.13|25.013.00|2500
+17.14|25.014.00|8704.21.1
+17.15|25.015.00|8704.21.2
+17.16|25.016.00|8704.21.3
+17.17|25.017.00|8704.21.9
+17.18|25.018.00|8704.31.1
+17.19|25.019.00|8704.31.2
+17.20|25.020.00|8704.31.3
+17.21|25.021.00|8704.31.9
+17.22|25.022.00|8702.2
+17.23|25.023.00|8702.3
+17.24|25.024.00|8702.9
+17.25|25.025.00|8703.4
+17.26|25.026.00|8703.5
+17.27|25.027.00|8703.6
+17.28|25.028.00|8703.7
+17.29|25.029.00|8703.80.00
+17.30|25.030.00|8704.41
+17.31|25.031.00|8704.51
+17.32|25.032.00|8704.60.00
+18.1|26.001.00|8711
+18.1|26.001.00|26.001.01
+18.2|26.001.00|8711
+1.0||2018
+1.0||01.019.00
+1.0||01.062.01
+1.0||01.112.00
+1.0||01.127.00
+1.0||01.128.00
+1.0||01.999.00
+1.0||01.015.00
+1.0||24.540
+3.3|03.003.00|2201.1
+3.3|03.003.00|2201.9
+3.3.1|03.003.01|2201.1
+3.3.1|03.003.01|2201.9
+3.5.0|03.005.00|2201.1
+3.5.0|03.005.00|2201.9
+3.5.1|03.005.01|2201.1
+3.5.1|03.005.01|2201.9
+3.5.2|03.005.02|2201.1
+3.5.2|03.005.02|2201.9
+3.5.3|03.005.03|2201.1
+3.5.3|03.005.03|2201.9
+3.5.4|03.005.04|2201.1
+3.5.4|03.005.04|2201.9
+3.5.5|03.005.05|2201.1
+3.5.5|03.005.05|2201.9
+3.6|03.006.00|2201.1
+3.6|03.006.00|03.003.00
+3.6|03.006.00|03.003.01
+03.005.00||03.005.05
+03.005.00||03.024.00
+03.005.00||03.025.00
+3.7||03.007.00
+03.008.00||2202
+3.9|03.010.00|2202.10
+3.9|03.010.00|2202.99
+3.9.1|03.010.01|2202.10
+3.9.1|03.010.01|2202.99
+3.9.2|03.010.02|2202.10
+3.9.2|03.010.02|2202.99
+3.10|03.011.00|2202.10
+3.10|03.011.00|2202.99
+3.10|03.011.00|03.010.00
+3.10|03.011.00|03.010.01
+3.10|03.011.00|03.010.02
+3.10|03.011.00|03.011.01
+3.11.0|03.012.00|2106.90.1
+3.11.0|03.012.00|03.012.01
+3.11.1|03.012.01|2106.90.1
+3.12.0|03.013.00|2106.9
+3.12.0|03.013.00|2202.99
+3.12.1|03.013.01|2106.9
+3.12.1|03.013.01|2202.99
+3.12.2|03.013.02|2106.9
+3.12.2|03.013.02|2202.99
+3.14|03.015.00|2106.9
+3.14|03.015.00|2202.99
+3.16.0|03.021.00|2203
+3.16.1|03.021.01|2203
+3.16.2|03.021.02|2203
+3.16.3|03.021.03|2203
+3.16.4|03.021.04|2203
+3.16.5|03.021.05|2203
+3.16.6|03.021.06|2203
+3.17.0|03.022.00|2202.91
+3.17.1|03.022.01|2202.91
+3.17.2|03.022.02|2202.91
+3.17.3|03.022.03|2202.91
+3.17.4|03.022.04|2202.91
+3.17.5|03.022.05|2202.91
+3.17.6|03.022.06|2202.91
+3.18|03.023.00|2203
+3.19|02.003.00|2208.9
+3.20|03.024.00|2201.1
+3.21|03.025.00|2201.1
+4.1|04.001.00|2402
+4.2|04.002.00|2403.1
+5.1|05.001.00|2523
+6.1|06.001.01|2207.10.9
+6.4|06.004.00|2710.19.19
+6.4|06.004.00|32.5
+6.5|06.005.00|2710.19.11
+6.5|06.005.00|63.52
+6.5|06.005.00|32.5
+6.6.9|06.006.09|2710.19.2
+06.006.10||06.006.11
+6.6.10|06.006.10|2710.19.2
+6.6.11|06.006.11|2710.19.22
+6.7|06.007.00|2710.19.3
+6.8.0|06.008.00|2710.19.9
+6.8.1|06.008.01|2710.19.9
+6.9|06.009.00|2710.9
+6.10|06.010.00|2711
+6.12|06.012.00|2711.11
+6.13|06.013.00|2711.21
+6.14|06.014.00|2711.29.9
+6.15|06.015.00|2713
+6.17|06.017.00|3403
+6.18|06.018.00|2710.2
+6.19|06.019.00|2710.12.49
+7.1|09.001.00|8539
+7.1|09.001.00|09.001.00
+7.2|09.002.00|8540
+7.2|09.002.00|09.002.00
+7.3|09.003.00|8504.1
+7.4|09.004.00|8536.5
+7.4|09.004.00|09.004.00
+7.5|09.005.00|8539.52
+7.5|09.005.00|09.005.00
+8.1|10.001.00|2522
+8.2|10.002.00|3816.00.1
+8.2|10.002.00|3824.5
+8.3|10.003.00|3214.9
+8.4|10.004.00|3910
+8.5|10.005.00|3916
+8.6|10.006.00|3917
+8.7|10.007.00|3918
+8.8|10.008.00|3919
+8.9|10.009.00|3919
+8.9|10.009.00|3920
+8.9|10.009.00|3921
+8.10|10.010.00|3921
+8.11|10.011.00|3921
+8.12|10.012.00|3921
+8.12|10.012.00|10.010.00
+8.12|10.012.00|10.011.00
+8.13|10.013.00|3922
+8.14|10.014.00|3924
+8.15|10.015.00|3925.1
+8.16|10.016.00|3925.9
+8.17|10.017.00|3925.1
+8.17|10.017.00|3925.9
+8.17|10.017.00|10.015.00
+8.17|10.017.00|10.016.00
+8.18|10.018.00|3925.2
+8.19|10.019.00|3925.3
+8.19|10.019.00|24.540
+8.19|10.019.00|10.019.00
+8.20|10.020.00|3926.9
+8.21|10.021.00|4814
+8.22|10.022.00|6810.19
+8.24|10.024.00|6811
+8.25|10.025.00|6901
+8.26|10.026.00|6902
+8.27|10.027.00|6904
+8.28|10.028.00|6905
+8.29|10.029.00|6906
+8.30.0|10.030.00|6907
+8.30.1|10.030.01|6907
+8.30.1|10.030.01|10.030.00
+8.31|10.031.00|6910
+8.32|10.032.00|6912
+8.33|10.033.00|7003
+8.33|10.033.00|24.540
+8.33|10.033.00|10.033.00
+8.34|10.034.00|7004
+8.34|10.034.00|24.540
+8.34|10.034.00|10.034.00
+8.35|10.035.00|7005
+8.35|10.035.00|24.540
+8.35|10.035.00|10.035.00
+8.36|10.036.00|7007.19
+8.36|10.036.00|24.540
+8.36|10.036.00|10.036.00
+8.37|10.037.00|7007.29
+8.38|10.038.00|7008
+8.38|10.038.00|24.540
+8.38|10.038.00|10.038.00
+8.39|10.039.00|7016
+8.40|10.040.00|7214.2
+8.41|10.041.00|7308.90.1
+8.41.1|10.041.01|7308.90.1
+8.42|10.042.00|7214.2
+8.43|10.043.00|7213
+8.44|10.044.00|7217.10.9
+8.44.1|10.044.00|7312
+8.45.0|10.045.00|7217.20.1
+8.45.1|10.045.01|7217.20.9
+8.46|10.046.00|7307
+8.47|10.047.00|7308.3
+8.48|10.048.00|7308.4
+8.48|10.048.00|7308.9
+8.49|10.049.00|7308.4
+8.50|10.050.00|7308.90.9
+8.51|10.051.00|7310
+8.52|10.052.00|7313
+8.53|10.053.00|7314
+8.54|10.054.00|7315.11
+8.55|10.055.00|7315.12.9
+8.56|10.056.00|7315.82
+8.57|10.057.00|7317
+8.58|10.058.00|7318
+8.59.0|10.059.00|7323
+8.59.0|10.059.00|7323.10.00
+8.59.1|10.059.01|7323
+8.59.1|10.059.01|7323.10.00
+8.60|10.060.00|7324
+8.61|10.061.00|7325
+8.62|10.062.00|7326
+8.63|10.063.00|7407
+8.64|10.064.00|7411.10.1
+8.65|10.065.00|7412
+8.66|10.066.00|7415
+8.67|10.067.00|7418.2
+8.68|10.068.00|7607.19.9
+8.69|10.069.00|7608
+8.70|10.070.00|7609.00.00
+8.71|10.071.00|7610
+8.71|10.071.00|9406
+8.72|10.072.00|7615.20.00
+8.73|10.073.00|7616
+8.74|10.074.00|8302.41.00
+8.75|10.075.00|8301
+8.76|10.076.00|8302.10.00
+8.77|10.077.00|8307
+8.78|10.078.00|8311
+8.79|10.079.00|8481
+8.80|10.080.00|7009
+8.80|10.080.00|24.540
+9.0||24.540
+9.1.0|13.001.00|3003
+9.1.0|13.001.00|3004
+9.1.1|13.001.01|3003
+9.1.1|13.001.01|3004
+9.1.2|13.001.02|3003
+9.1.2|13.001.02|3004
+9.2.0|13.002.00|3003
+9.2.0|13.002.00|3004
+9.2.1|13.002.01|3003
+9.2.1|13.002.01|3004
+9.2.2|13.002.02|3003
+9.2.2|13.002.02|3004
+9.3.0|13.003.00|3003
+9.3.0|13.003.00|3004
+9.3.1|13.003.01|3003
+9.3.1|13.003.01|3004
+9.3.2|13.003.02|3003
+9.3.2|13.003.02|3004
+9.4.0|13.004.00|3003
+9.4.0|13.004.00|3004
+9.4.1|13.004.01|3003
+9.4.1|13.004.01|3004
+9.4.2|13.004.02|3003
+9.4.2|13.004.02|3004
+9.5.0|13.005.00|3006.6
+9.5.0|13.005.00|29.37
+9.5.1|13.005.01|3006.6
+9.5.1|13.005.01|29.37
+9.5.2|13.005.02|3006.6
+9.5.2|13.005.02|29.37
+9.5.3|13.005.03|3006.6
+9.5.3|13.005.03|29.37
+9.5.4|13.005.04|3006.6
+9.5.4|13.005.04|29.37
+9.5.5|13.005.05|3006.6
+9.5.5|13.005.05|29.37
+9.6|13.006.00|2936
+9.7.0|13.007.00|3006.3
+9.7.1|13.007.01|3006.3
+9.8.0|13.008.00|3002
+9.8.1|13.008.01|3002
+9.9.0|13.009.00|3002
+9.9.1|13.009.01|3002
+9.10.0|13.010.00|3005.10.1
+9.10.1|13.010.01|3005.10.1
+9.11|13.011.00|3005
+9.12|13.012.00|4015.12
+9.12|13.012.00|4015.19
+9.13|13.013.00|4014.1
+9.14|13.014.00|9018.31
+9.15|13.015.00|9018.32.1
+9.16|13.016.00|3926.90.9
+9.16|13.016.00|9018.90.99
+9.16|13.016.00|24.540
+9.16|13.016.00|13.001.00
+9.16|13.016.00|3003
+9.16|13.016.00|3004
+9.1.1|13.001.01|3003
+9.1.1|13.001.01|3004
+9.1.2|13.001.02|3003
+9.1.2|13.001.02|3004
+9.2.0|13.002.00|3003
+9.2.0|13.002.00|3004
+9.2.1|13.002.01|3003
+9.2.1|13.002.01|3004
+9.2.2|13.002.02|3003
+9.2.2|13.002.02|3004
+9.3.0|13.003.00|3003
+9.3.0|13.003.00|3004
+9.3.1|13.003.01|3003
+9.3.1|13.003.01|3004
+9.3.2|13.003.02|3003
+9.3.2|13.003.02|3004
+9.4.0|13.004.00|3003
+9.4.0|13.004.00|3004
+9.4.1|13.004.01|3003
+9.4.1|13.004.01|3004
+9.4.2|13.004.02|3003
+9.4.2|13.004.02|3004
+9.5.0|13.005.00|3006.6
+9.5.0|13.005.00|29.37
+9.5.1|13.005.01|3006.6
+9.5.1|13.005.01|29.37
+9.5.2|13.005.02|3006.6
+9.5.2|13.005.02|29.37
+9.5.3|13.005.03|3006.6
+9.5.3|13.005.03|29.37
+9.5.4|13.005.04|3006.6
+9.5.4|13.005.04|29.37
+9.5.5|13.005.05|3006.6
+9.5.5|13.005.05|29.37
+9.6|13.006.00|2936
+9.7.0|13.007.00|3006.3
+9.7.1|13.007.01|3006.3
+9.8.0|13.008.00|3002
+9.8.1|13.008.01|3002
+9.9.0|13.009.00|3002
+9.9.1|13.009.01|3002
+9.10.0|13.010.00|3005.10.1
+9.10.1|13.010.01|3005.10.1
+9.11|13.011.00|3005
+9.12|13.012.00|4015.12
+9.12|13.012.00|4015.19
+9.13|13.013.00|4014.1
+9.14|13.014.00|9018.31
+9.15|13.015.00|9018.32.1
+9.16|13.016.00|3926.90.9
+9.16|13.016.00|9018.90.99
+10.1|16.001.00|4011
+10.1|16.001.00|10.1
+10.2|16.002.00|4011
+10.2|16.002.00|10.2
+10.3|16.003.00|4011
+10.3|16.003.00|10.3
+10.4|16.004.00|4011
+10.4|16.004.00|16.005.00
+10.4|16.004.00|10.4
+10.5|16.005.00|4011.5
+10.6.0|16.007.00|4012.9
+16.007.01||10.6.0
+10.6.1|16.007.01|4012.9
+10.7|16.008.00|4013
+10.7|16.008.00|16.009.00
+10.7|16.008.00|10.7
+10.8|16.009.00|4013.2
+17.044.27||1101.00.1
+11.2|17.045.00|1101.00.2
+11.3|17.046.05|17.046.09
+11.3|17.046.05|1901.2
+11.3|17.046.05|1901.90.9
+17.046.14||1901
+11.4.1|17.046.16|1901.2
+11.4.1|17.046.16|1901.90.9
+17.046.10||17.046.15
+11.5||1001
+11.6.0|17.047.01|1902.3
+11.6.1|17.048.00|1902
+11.6.1|17.048.00|17.047.00
+11.6.1|17.048.00|17.048.01
+11.6.1|17.048.00|17.048.02
+11.6.2|17.048.02|1902.20.00
+11.7.2|17.049.02|1902.11
+11.7.3|17.049.03|1902.19
+11.7.4|17.049.04|1902.19
+11.7.5|17.049.05|1902.19
+11.7.6|17.049.06|1902.11
+11.7.7|17.049.07|1902.11
+11.8|17.050.00|1905.2
+11.9|17.051.00|1905.20.9
+11.10|17.052.00|1905.20.1
+11.16|17.059.00|1905.4
+11.17|17.060.00|1905.90.1
+11.18.0|17.062.00|1905.90.90
+11.18.0|17.062.00|17.062.03
+11.18.1|17.062.01|1905.90.90
+11.18.1|17.062.01|17.062.02
+11.18.1|17.062.01|17.062.03
+11.18.2|17.062.02|1905.90.2
+11.18.2|17.062.02|1905.90.9
+11.18.3|17.062.03|1905.90.9
+11.19|17.063.00|1905.1
+11.20|17.064.00|1905.9
+11.21|17.083.00|0210.2
+11.21|17.083.00|0210.99
+11.21|17.083.00|1502
+11.22|17.084.00|0201
+11.22|17.084.00|0202
+11.22|17.084.00|0204
+11.22|17.084.00|0206
+11.23|17.085.00|0204
+11.24||17.086.00
+11.24||0210.99
+11.24||1502.10.19
+11.24||1502.9
+11.25.0|17.087.00|0207
+11.25.0|17.087.00|0209
+11.25.0|17.087.00|0210.99
+11.25.0|17.087.00|1501
+11.25.0|17.087.00|17.087.02
+11.25.1||17.087.01
+11.25.1||0203
+11.25.1||0206
+11.25.1||0209
+11.25.1||0210.1
+11.25.1||0210.99
+11.25.1||1501
+11.25.2|17.087.02|0207.1
+11.25.2|17.087.02|0207.2
+15.1|23.001.00|2105
+15.1|23.001.00|15.1
+15.1|23.001.00|23.001.00
+16.1|24.001.00|3208
+16.1|24.001.00|3209
+16.1|24.001.00|3210
+16.1|24.001.00|16.1
+16.2|24.002.00|2821
+16.2|24.002.00|3204.17
+16.2|24.002.00|3206
+16.2|24.002.00|3206.11.10
+16.2|24.002.00|16.2
+16.2.1|24.002.01|2821
+16.2.1|24.002.01|3204.17
+16.2.1|24.002.01|3206
+16.2.1|24.002.01|3206.11.10
+16.2.1|24.002.01|16.2.1
+16.3|24.003.00|3204
+16.3|24.003.00|3205
+16.3|24.003.00|3206
+16.3|24.003.00|3212
+16.3|24.003.00|16.3
+17.1|25.001.00|8702.1
+17.2|25.002.00|8702.40.9
+17.3|25.003.00|8703.21
+17.3|25.003.00|1000
+17.4|25.004.00|8703.22.1
+17.4|25.004.00|1000
+17.4|25.004.00|1500
+17.5|25.005.00|8703.22.9
+17.5|25.005.00|1000
+17.5|25.005.00|1500
+17.6|25.006.00|8703.23.1
+17.6|25.006.00|1500
+17.6|25.006.00|3000
+17.7|25.007.00|8703.23.9
+17.7|25.007.00|1500
+17.7|25.007.00|3000
+17.8|25.008.00|8703.24.1
+17.8|25.008.00|3000
+17.9|25.009.00|8703.24.9
+17.9|25.009.00|3000
+17.10|25.010.00|8703.32.1
+17.10|25.010.00|1500
+17.10|25.010.00|2500
+17.11|25.011.00|8703.32.9
+17.11|25.011.00|1500
+17.11|25.011.00|2500
+17.12|25.012.00|8703.33.1
+17.12|25.012.00|2500
+17.13|25.013.00|8703.33.9
+17.13|25.013.00|2500
+17.14|25.014.00|8704.21.1
+17.15|25.015.00|8704.21.2
+17.16|25.016.00|8704.21.3
+17.17|25.017.00|8704.21.9
+17.18|25.018.00|8704.31.1
+17.19|25.019.00|8704.31.2
+17.20|25.020.00|8704.31.3
+17.21|25.021.00|8704.31.9
+17.22|25.022.00|8702.2
+17.23|25.023.00|8702.3
+17.24|25.024.00|8702.9
+17.25|25.025.00|8703.4
+17.26|25.026.00|8703.5
+17.27|25.027.00|8703.6
+17.28|25.028.00|8703.7
+17.29|25.029.00|8703.80.00
+17.30|25.030.00|8704.41
+17.31|25.031.00|8704.51
+17.32|25.032.00|8704.60.00
+18.1|26.001.00|8711
+18.1|26.001.00|26.001.01
+18.2|26.001.00|8711
+11.4|17.046.10|
+11.1|17.044.00|
+11.4|17.046.10|
+11.1|17.044.00|
+ERROR:  column "filename" does not exist
+LINE 1: select id, sha256, filename from datasets order by id desc l...
+                           ^

docs/runs/erp_c000025_audit.json

@@ -0,0 +1,574 @@
+{
+ "CLASSIFICACAO_FISCAL": {
+  "exists": true,
+  "type_code": 37,
+  "len": 20,
+  "precision": null,
+  "scale": 0,
+  "comment": null,
+  "default": null,
+  "distinct": 54,
+  "top": [
+   [
+    "21069090",
+    149
+   ],
+   [
+    "22082000",
+    105
+   ],
+   [
+    "22030000",
+    52
+   ],
+   [
+    "20099000",
+    41
+   ],
+   [
+    "19022000",
+    31
+   ],
+   [
+    "16042090",
+    22
+   ],
+   [
+    "02102000",
+    12
+   ],
+   [
+    "22089000",
+    12
+   ],
+   [
+    "07069000",
+    8
+   ],
+   [
+    "11111111",
+    6
+   ],
+   [
+    "04061010",
+    5
+   ],
+   [
+    "12345678",
+    5
+   ]
+  ]
+ },
+ "NCM": {
+  "exists": true,
+  "type_code": 37,
+  "len": 20,
+  "precision": null,
+  "scale": 0,
+  "comment": null,
+  "default": null,
+  "distinct": 1,
+  "top": [
+   [
+    null,
+    521
+   ]
+  ]
+ },
+ "IPI": {
+  "exists": true,
+  "type_code": 27,
+  "len": 8,
+  "precision": null,
+  "scale": -2,
+  "comment": null,
+  "default": null,
+  "distinct": 6,
+  "top": [
+   [
+    null,
+    412
+   ],
+   [
+    "19.5",
+    105
+   ],
+   [
+    "3.25",
+    1
+   ],
+   [
+    "5.0",
+    1
+   ],
+   [
+    "20.0",
+    1
+   ],
+   [
+    "5102.0",
+    1
+   ]
+  ]
+ },
+ "EX_TIPI": {
+  "exists": true,
+  "type_code": 37,
+  "len": 3,
+  "precision": null,
+  "scale": 0,
+  "comment": null,
+  "default": null,
+  "distinct": 1,
+  "top": [
+   [
+    null,
+    521
+   ]
+  ]
+ },
+ "CEST": {
+  "exists": true,
+  "type_code": 37,
+  "len": 7,
+  "precision": null,
+  "scale": 0,
+  "comment": null,
+  "default": null,
+  "distinct": 5,
+  "top": [
+   [
+    "",
+    490
+   ],
+   [
+    null,
+    26
+   ],
+   [
+    "0601100",
+    3
+   ],
+   [
+    "1708400",
+    1
+   ],
+   [
+    "2110600",
+    1
+   ]
+  ]
+ },
+ "CFOP_ENTRADA": {
+  "exists": true,
+  "type_code": 14,
+  "len": 4,
+  "precision": null,
+  "scale": 0,
+  "comment": null,
+  "default": null,
+  "distinct": 1,
+  "top": [
+   [
+    null,
+    521
+   ]
+  ]
+ },
+ "CFOP": {
+  "exists": true,
+  "type_code": 37,
+  "len": 4,
+  "precision": null,
+  "scale": 0,
+  "comment": null,
+  "default": null,
+  "distinct": 4,
+  "top": [
+   [
+    "5102",
+    493
+   ],
+   [
+    null,
+    23
+   ],
+   [
+    "5405",
+    3
+   ],
+   [
+    "5656",
+    2
+   ]
+  ]
+ },
+ "CST_ENTRADA": {
+  "exists": true,
+  "type_code": 14,
+  "len": 4,
+  "precision": null,
+  "scale": 0,
+  "comment": null,
+  "default": null,
+  "distinct": 1,
+  "top": [
+   [
+    null,
+    521
+   ]
+  ]
+ },
+ "CST": {
+  "exists": true,
+  "type_code": 37,
+  "len": 10,
+  "precision": null,
+  "scale": 0,
+  "comment": null,
+  "default": null,
+  "distinct": 5,
+  "top": [
+   [
+    "040",
+    487
+   ],
+   [
+    "000",
+    27
+   ],
+   [
+    "060",
+    5
+   ],
+   [
+    "020",
+    1
+   ],
+   [
+    "051",
+    1
+   ]
+  ]
+ },
+ "ALIQUOTA": {
+  "exists": true,
+  "type_code": 16,
+  "len": 8,
+  "precision": 15,
+  "scale": -2,
+  "comment": null,
+  "default": null,
+  "distinct": 4,
+  "top": [
+   [
+    "20.5",
+    492
+   ],
+   [
+    "17",
+    24
+   ],
+   [
+    "0",
+    4
+   ],
+   [
+    "21.5",
+    1
+   ]
+  ]
+ },
+ "CSOSN": {
+  "exists": true,
+  "type_code": 37,
+  "len": 60,
+  "precision": null,
+  "scale": 0,
+  "comment": null,
+  "default": null,
+  "distinct": 6,
+  "top": [
+   [
+    "102",
+    487
+   ],
+   [
+    null,
+    23
+   ],
+   [
+    "500",
+    5
+   ],
+   [
+    "101",
+    4
+   ],
+   [
+    "",
+    1
+   ],
+   [
+    "103",
+    1
+   ]
+  ]
+ },
+ "COD_ENTRADA_PIS": {
+  "exists": true,
+  "type_code": 37,
+  "len": 3,
+  "precision": null,
+  "scale": 0,
+  "comment": null,
+  "default": null,
+  "distinct": 3,
+  "top": [
+   [
+    null,
+    519
+   ],
+   [
+    "2",
+    1
+   ],
+   [
+    "73",
+    1
+   ]
+  ]
+ },
+ "COD_SAIDA_PIS": {
+  "exists": true,
+  "type_code": 37,
+  "len": 3,
+  "precision": null,
+  "scale": 0,
+  "comment": null,
+  "default": null,
+  "distinct": 4,
+  "top": [
+   [
+    null,
+    518
+   ],
+   [
+    "01",
+    1
+   ],
+   [
+    "04",
+    1
+   ],
+   [
+    "2",
+    1
+   ]
+  ]
+ },
+ "ALIQ_PIS": {
+  "exists": true,
+  "type_code": 37,
+  "len": 8,
+  "precision": null,
+  "scale": 0,
+  "comment": null,
+  "default": null,
+  "distinct": 4,
+  "top": [
+   [
+    null,
+    518
+   ],
+   [
+    "",
+    1
+   ],
+   [
+    "0,65",
+    1
+   ],
+   [
+    "2",
+    1
+   ]
+  ]
+ },
+ "COD_ENTRADA_COFINS": {
+  "exists": true,
+  "type_code": 37,
+  "len": 3,
+  "precision": null,
+  "scale": 0,
+  "comment": null,
+  "default": null,
+  "distinct": 3,
+  "top": [
+   [
+    null,
+    519
+   ],
+   [
+    "2",
+    1
+   ],
+   [
+    "73",
+    1
+   ]
+  ]
+ },
+ "COD_SAIDA_COFINS": {
+  "exists": true,
+  "type_code": 37,
+  "len": 3,
+  "precision": null,
+  "scale": 0,
+  "comment": null,
+  "default": null,
+  "distinct": 4,
+  "top": [
+   [
+    null,
+    518
+   ],
+   [
+    "01",
+    1
+   ],
+   [
+    "04",
+    1
+   ],
+   [
+    "2",
+    1
+   ]
+  ]
+ },
+ "ALIQ_COFINS": {
+  "exists": true,
+  "type_code": 37,
+  "len": 8,
+  "precision": null,
+  "scale": 0,
+  "comment": null,
+  "default": null,
+  "distinct": 4,
+  "top": [
+   [
+    null,
+    518
+   ],
+   [
+    "",
+    1
+   ],
+   [
+    "2",
+    1
+   ],
+   [
+    "3",
+    1
+   ]
+  ]
+ },
+ "CST_IPI": {
+  "exists": true,
+  "type_code": 14,
+  "len": 3,
+  "precision": null,
+  "scale": 0,
+  "comment": null,
+  "default": null,
+  "distinct": 2,
+  "top": [
+   [
+    null,
+    520
+   ],
+   [
+    "040",
+    1
+   ]
+  ]
+ },
+ "ORIGEM": {
+  "exists": true,
+  "type_code": 37,
+  "len": 1,
+  "precision": null,
+  "scale": 0,
+  "comment": null,
+  "default": null,
+  "distinct": 1,
+  "top": [
+   [
+    null,
+    521
+   ]
+  ]
+ },
+ "IAT": {
+  "exists": true,
+  "type_code": 37,
+  "len": 1,
+  "precision": null,
+  "scale": 0,
+  "comment": null,
+  "default": null,
+  "distinct": 1,
+  "top": [
+   [
+    "A",
+    521
+   ]
+  ]
+ },
+ "INCIDENCIA_PISCOFINS": {
+  "exists": true,
+  "type_code": 37,
+  "len": 30,
+  "precision": null,
+  "scale": 0,
+  "comment": null,
+  "default": null,
+  "distinct": 3,
+  "top": [
+   [
+    "NENHUMA",
+    519
+   ],
+   [
+    "MONOFÁSICA",
+    1
+   ],
+   [
+    "SUBST.TRIBUTÁRIA",
+    1
+   ]
+  ]
+ },
+ "IPPT": {
+  "exists": true,
+  "type_code": 37,
+  "len": 1,
+  "precision": null,
+  "scale": 0,
+  "comment": null,
+  "default": null,
+  "distinct": 1,
+  "top": [
+   [
+    "T",
+    521
+   ]
+  ]
+ },
+ "_related_tables": [
+  "PARTILHA_ICMS",
+  "CFOP2"
+ ]
+}

docs/runs/erp_fiscal_history_analysis.json

@@ -0,0 +1,387 @@
+{
+ "products": 521,
+ "nfce_itens": {
+  "rows": 34946,
+  "date_min": "2018-03-02",
+  "date_max": "2026-08-25"
+ },
+ "nfce_docs": {
+  "rows": 1502,
+  "min": "2022-06-07",
+  "max": "2026-08-25"
+ },
+ "nfce_join": {
+  "items_joined_to_C000025": 33195,
+  "orphan_items": 1751,
+  "agreement_item_vs_product_default": {
+   "CFOP": {
+    "MATCH": 29570,
+    "MISMATCH": 1215,
+    "ITEM_NULL": 2410
+   },
+   "CST": {
+    "MATCH": 17995,
+    "MISMATCH": 12790,
+    "ITEM_NULL": 2410
+   },
+   "GRUPO_ICMS": {
+    "MATCH": 29073,
+    "MISMATCH": 1712,
+    "ITEM_NULL": 2410
+   },
+   "CSOSN": {
+    "ITEM_NULL": 30278,
+    "MATCH": 1976,
+    "MISMATCH": 941
+   },
+   "NCM": {
+    "ITEM_NULL": 30278,
+    "MATCH": 1241,
+    "MISMATCH": 1676
+   },
+   "CEST": {
+    "ITEM_NULL": 30279,
+    "MATCH": 1526,
+    "MISMATCH": 1390
+   },
+   "PIS": {
+    "ITEM_NULL": 30278,
+    "MATCH": 1167,
+    "MISMATCH": 1750
+   }
+  }
+ },
+ "nfce_products_seen": 423,
+ "variability": {
+  "CFOP": 21,
+  "CST": 24,
+  "GRUPO_ICMS": 35,
+  "CSOSN": 7,
+  "CEST": 8,
+  "NCM": 13
+ },
+ "nfce_item_value_distributions": {
+  "CFOP": [
+   [
+    "5102",
+    31527
+   ],
+   [
+    null,
+    2411
+   ],
+   [
+    "5405",
+    951
+   ],
+   [
+    "5656",
+    40
+   ],
+   [
+    "",
+    17
+   ]
+  ],
+  "CST": [
+   [
+    "040",
+    20315
+   ],
+   [
+    "000",
+    11245
+   ],
+   [
+    null,
+    2410
+   ],
+   [
+    "060",
+    974
+   ],
+   [
+    "051",
+    2
+   ]
+  ],
+  "GRUPO_ICMS": [
+   [
+    "102",
+    29073
+   ],
+   [
+    "",
+    3445
+   ],
+   [
+    null,
+    2411
+   ],
+   [
+    "500",
+    17
+   ]
+  ],
+  "CSOSN": [
+   [
+    null,
+    30279
+   ],
+   [
+    "102",
+    3620
+   ],
+   [
+    "500",
+    974
+   ],
+   [
+    "101",
+    72
+   ],
+   [
+    "103",
+    1
+   ]
+  ],
+  "CST_PIS_COFINS": [
+   [
+    null,
+    30278
+   ],
+   [
+    "01",
+    3336
+   ],
+   [
+    "",
+    1332
+   ]
+  ]
+ },
+ "C000032": {
+  "joined": {
+   "JOINED": 4879,
+   "ORPHAN": 26
+  },
+  "cst_vs_product": {
+   "MATCH": 43,
+   "MISMATCH": 400
+  },
+  "cfop_vs_product": {
+   "MATCH": 8
+  }
+ },
+ "C000062": {
+  "joined": {
+   "JOINED": 690,
+   "ORPHAN": 3
+  },
+  "cst_vs_product": {
+   "MATCH": 646,
+   "MISMATCH": 44
+  },
+  "cfop_vs_product": {
+   "MATCH": 634,
+   "MISMATCH": 53
+  }
+ },
+ "C000030_tipo": {
+  "1": 272,
+  "2": 318
+ },
+ "C000030_cfop_first_digit": {
+  "1": 124,
+  "2": 116,
+  "3": 32,
+  "5": 148,
+  "6": 142,
+  "7": 28
+ },
+ "C000030_has_cfops": [
+  "1102",
+  "5102",
+  "5405",
+  "5656",
+  "5929",
+  "6102"
+ ],
+ "C000001_cfop_defaults": [
+  "1949",
+  "5949",
+  "5927"
+ ],
+ "C000004": [
+  "S",
+  "N",
+  "1",
+  "102",
+  "N",
+  "N",
+  "BA"
+ ],
+ "EMISSOR_CRT": [
+  "1"
+ ],
+ "C000062_cfop": {
+  "": 3,
+  "5102": 628,
+  "5202": 11,
+  "5405": 16,
+  "5656": 5,
+  "5916": 1,
+  "5920": 4,
+  "5929": 17,
+  "6949": 1,
+  "7205": 7
+ },
+ "C000062_cst": {
+  "000": 13,
+  "020": 6,
+  "030": 1,
+  "040": 619,
+  "041": 17,
+  "051": 2,
+  "060": 35
+ },
+ "C000062_mva_usage": [
+  693,
+  0,
+  2
+ ],
+ "PRODUTOS_MARGEM_AGREGADA_rows": 0,
+ "C000025_MARGEM_AGREGADA_nonnull": 0,
+ "cest_candidates_history": [
+  {
+   "CODIGO": "000025",
+   "DESCRIPTION": "BOLINHO DE QUEIJO ",
+   "NCM": "04061010",
+   "erp_current_cest": "",
+   "historical_cest": {}
+  },
+  {
+   "CODIGO": "000035",
+   "DESCRIPTION": "QUEIJO ",
+   "NCM": "04061010",
+   "erp_current_cest": "",
+   "historical_cest": {}
+  },
+  {
+   "CODIGO": "000065",
+   "DESCRIPTION": "QUEIJO COLAHO ",
+   "NCM": "04069020",
+   "erp_current_cest": "",
+   "historical_cest": {}
+  },
+  {
+   "CODIGO": "000244",
+   "DESCRIPTION": "QUEIJO",
+   "NCM": "04061010",
+   "erp_current_cest": "",
+   "historical_cest": {}
+  },
+  {
+   "CODIGO": "000257",
+   "DESCRIPTION": "PRAZER DA CARNE",
+   "NCM": "02102000",
+   "erp_current_cest": "",
+   "historical_cest": {}
+  },
+  {
+   "CODIGO": "000271",
+   "DESCRIPTION": "FRUTAS",
+   "NCM": "20099000",
+   "erp_current_cest": "",
+   "historical_cest": {}
+  },
+  {
+   "CODIGO": "000310",
+   "DESCRIPTION": "VODKA ORLOFF",
+   "NCM": "22089000",
+   "erp_current_cest": "",
+   "historical_cest": {}
+  },
+  {
+   "CODIGO": "000311",
+   "DESCRIPTION": "VODKA SMIRNOFF",
+   "NCM": "22089000",
+   "erp_current_cest": "",
+   "historical_cest": {}
+  },
+  {
+   "CODIGO": "000312",
+   "DESCRIPTION": "VODKA NATASHA",
+   "NCM": "22089000",
+   "erp_current_cest": "",
+   "historical_cest": {}
+  },
+  {
+   "CODIGO": "000316",
+   "DESCRIPTION": "SMIRNORFF ICE",
+   "NCM": "22089000",
+   "erp_current_cest": "",
+   "historical_cest": {}
+  },
+  {
+   "CODIGO": "000598",
+   "DESCRIPTION": "CHOP CERVEJA",
+   "NCM": "22030000",
+   "erp_current_cest": "",
+   "historical_cest": {}
+  },
+  {
+   "CODIGO": "000655",
+   "DESCRIPTION": "CACHACA  MOICANA",
+   "NCM": "22084000",
+   "erp_current_cest": "",
+   "historical_cest": {}
+  },
+  {
+   "CODIGO": "000785",
+   "DESCRIPTION": "ACEROLA  KG",
+   "NCM": "20079922",
+   "erp_current_cest": null,
+   "historical_cest": {}
+  },
+  {
+   "CODIGO": "000795",
+   "DESCRIPTION": "GÁS DE PETRÓLEO GLP 13 ",
+   "NCM": "27111910",
+   "erp_current_cest": "0601100",
+   "historical_cest": {
+    "0601100": 33
+   }
+  },
+  {
+   "CODIGO": "000796",
+   "DESCRIPTION": "VASILHAME GÁS PETRÓLEO GLP 13",
+   "NCM": "27111910",
+   "erp_current_cest": "0601100",
+   "historical_cest": {}
+  }
+ ],
+ "shadow_validation": {
+  "items": 2917,
+  "NCM": {
+   "MATCH": 1189,
+   "UNRESOLVED": 57,
+   "MISMATCH": 1671
+  },
+  "CEST": {
+   "UNRESOLVED": 2917
+  },
+  "CFOP": {
+   "UNRESOLVED": 2917
+  },
+  "CST_ICMS": {
+   "UNRESOLVED": 2917
+  },
+  "CSOSN": {
+   "UNRESOLVED": 2917
+  },
+  "PIS_CST": {
+   "UNRESOLVED": 2917
+  }
+ }
+}

docs/runs/erp_fiscal_history_extra.json

@@ -0,0 +1,197 @@
+{
+ "ncm_identity_consistent_items": 1241,
+ "ncm_identity_inconsistent_items": 1676,
+ "agreement_consistent_joins_only": {
+  "CFOP": {
+   "MATCH": 1231,
+   "MISMATCH": 10
+  },
+  "CST": {
+   "MATCH": 1241
+  },
+  "CSOSN": {
+   "MATCH": 1179,
+   "MISMATCH": 62
+  },
+  "CEST": {
+   "MATCH": 1231,
+   "MISMATCH": 9
+  },
+  "PIS": {
+   "MATCH": 1162,
+   "MISMATCH": 79
+  }
+ },
+ "cest_candidates": [
+  {
+   "CODIGO": "000025",
+   "DESCRIPTION": "BOLINHO DE QUEIJO ",
+   "NCM": "04061010",
+   "official_candidates": 4,
+   "historical_cest": {},
+   "historical_in_official_candidates": [],
+   "historical_in_ba_st_mva": [],
+   "product_ncm_matches_item_ncm": null,
+   "verdict": "NO_HISTORY"
+  },
+  {
+   "CODIGO": "000035",
+   "DESCRIPTION": "QUEIJO ",
+   "NCM": "04061010",
+   "official_candidates": 4,
+   "historical_cest": {},
+   "historical_in_official_candidates": [],
+   "historical_in_ba_st_mva": [],
+   "product_ncm_matches_item_ncm": null,
+   "verdict": "NO_HISTORY"
+  },
+  {
+   "CODIGO": "000065",
+   "DESCRIPTION": "QUEIJO COLAHO ",
+   "NCM": "04069020",
+   "official_candidates": 4,
+   "historical_cest": {},
+   "historical_in_official_candidates": [],
+   "historical_in_ba_st_mva": [],
+   "product_ncm_matches_item_ncm": null,
+   "verdict": "NO_HISTORY"
+  },
+  {
+   "CODIGO": "000244",
+   "DESCRIPTION": "QUEIJO",
+   "NCM": "04061010",
+   "official_candidates": 4,
+   "historical_cest": {},
+   "historical_in_official_candidates": [],
+   "historical_in_ba_st_mva": [],
+   "product_ncm_matches_item_ncm": null,
+   "verdict": "NO_HISTORY"
+  },
+  {
+   "CODIGO": "000257",
+   "DESCRIPTION": "PRAZER DA CARNE",
+   "NCM": "02102000",
+   "official_candidates": 2,
+   "historical_cest": {},
+   "historical_in_official_candidates": [],
+   "historical_in_ba_st_mva": [],
+   "product_ncm_matches_item_ncm": null,
+   "verdict": "NO_HISTORY"
+  },
+  {
+   "CODIGO": "000271",
+   "DESCRIPTION": "FRUTAS",
+   "NCM": "20099000",
+   "official_candidates": 2,
+   "historical_cest": {},
+   "historical_in_official_candidates": [],
+   "historical_in_ba_st_mva": [],
+   "product_ncm_matches_item_ncm": null,
+   "verdict": "NO_HISTORY"
+  },
+  {
+   "CODIGO": "000310",
+   "DESCRIPTION": "VODKA ORLOFF",
+   "NCM": "22089000",
+   "official_candidates": 8,
+   "historical_cest": {},
+   "historical_in_official_candidates": [],
+   "historical_in_ba_st_mva": [],
+   "product_ncm_matches_item_ncm": null,
+   "verdict": "NO_HISTORY"
+  },
+  {
+   "CODIGO": "000311",
+   "DESCRIPTION": "VODKA SMIRNOFF",
+   "NCM": "22089000",
+   "official_candidates": 8,
+   "historical_cest": {},
+   "historical_in_official_candidates": [],
+   "historical_in_ba_st_mva": [],
+   "product_ncm_matches_item_ncm": null,
+   "verdict": "NO_HISTORY"
+  },
+  {
+   "CODIGO": "000312",
+   "DESCRIPTION": "VODKA NATASHA",
+   "NCM": "22089000",
+   "official_candidates": 8,
+   "historical_cest": {},
+   "historical_in_official_candidates": [],
+   "historical_in_ba_st_mva": [],
+   "product_ncm_matches_item_ncm": null,
+   "verdict": "NO_HISTORY"
+  },
+  {
+   "CODIGO": "000316",
+   "DESCRIPTION": "SMIRNORFF ICE",
+   "NCM": "22089000",
+   "official_candidates": 8,
+   "historical_cest": {},
+   "historical_in_official_candidates": [],
+   "historical_in_ba_st_mva": [],
+   "product_ncm_matches_item_ncm": null,
+   "verdict": "NO_HISTORY"
+  },
+  {
+   "CODIGO": "000598",
+   "DESCRIPTION": "CHOP CERVEJA",
+   "NCM": "22030000",
+   "official_candidates": 9,
+   "historical_cest": {},
+   "historical_in_official_candidates": [],
+   "historical_in_ba_st_mva": [],
+   "product_ncm_matches_item_ncm": null,
+   "verdict": "NO_HISTORY"
+  },
+  {
+   "CODIGO": "000655",
+   "DESCRIPTION": "CACHACA  MOICANA",
+   "NCM": "22084000",
+   "official_candidates": 3,
+   "historical_cest": {},
+   "historical_in_official_candidates": [],
+   "historical_in_ba_st_mva": [],
+   "product_ncm_matches_item_ncm": null,
+   "verdict": "NO_HISTORY"
+  },
+  {
+   "CODIGO": "000785",
+   "DESCRIPTION": "ACEROLA  KG",
+   "NCM": "20079922",
+   "official_candidates": 2,
+   "historical_cest": {},
+   "historical_in_official_candidates": [],
+   "historical_in_ba_st_mva": [],
+   "product_ncm_matches_item_ncm": null,
+   "verdict": "NO_HISTORY"
+  },
+  {
+   "CODIGO": "000795",
+   "DESCRIPTION": "G\u00c1S DE PETR\u00d3LEO GLP 13 ",
+   "NCM": "27111910",
+   "official_candidates": 10,
+   "historical_cest": {
+    "0601100": 33
+   },
+   "historical_in_official_candidates": [
+    "0601100"
+   ],
+   "historical_in_ba_st_mva": [],
+   "product_ncm_matches_item_ncm": null,
+   "verdict": "CEST_HISTORICALLY_SUPPORTED"
+  },
+  {
+   "CODIGO": "000796",
+   "DESCRIPTION": "VASILHAME G\u00c1S PETR\u00d3LEO GLP 13",
+   "NCM": "27111910",
+   "official_candidates": 10,
+   "historical_cest": {},
+   "historical_in_official_candidates": [],
+   "historical_in_ba_st_mva": [],
+   "product_ncm_matches_item_ncm": null,
+   "verdict": "NO_HISTORY"
+  }
+ ],
+ "cest_historically_supported": 1
+}

docs/runs/local_completion/CONSTRUCAO_apply_summary.json

@@ -0,0 +1,8 @@
+{
+ "name": "CONSTRUCAO",
+ "cells_attempted": 772,
+ "cells_succeeded": 772,
+ "cells_failed": 0,
+ "products_updated": 772,
+ "failures": []
+}

docs/runs/local_completion/CONSTRUCAO_dryrun_summary.json

@@ -0,0 +1,224 @@
+{
+ "name": "CONSTRUCAO",
+ "total_products": 3712,
+ "company": {
+  "uf": "BA",
+  "crt": "1",
+  "contribuinte_ipi": "N",
+  "company_code": "000001",
+  "company_key": "2d8e45d5",
+  "pis_cofins_emission_items": 28934,
+  "pis_cofins_emission_nonblank": 0,
+  "pis_cofins_unused_by_emission": true
+ },
+ "context_entries": 0,
+ "fields": {
+  "CLASSIFICACAO_FISCAL": {
+   "ALREADY_CORRECT": 3698,
+   "MANUAL_INPUT_REQUIRED": 14
+  },
+  "IPI": {
+   "NOT_APPLICABLE": 1283,
+   "ALREADY_CORRECT": 1497,
+   "MANUAL_INPUT_REQUIRED": 932
+  },
+  "EX_TIPI": {
+   "NOT_APPLICABLE": 3698,
+   "MANUAL_INPUT_REQUIRED": 14
+  },
+  "CEST": {
+   "ALREADY_CORRECT": 2826,
+   "NOT_APPLICABLE": 233,
+   "MANUAL_INPUT_REQUIRED": 653
+  },
+  "SITUACAO_TRIBUTARIA": {
+   "ALREADY_CORRECT": 2810,
+   "MANUAL_INPUT_REQUIRED": 902
+  },
+  "CFOP": {
+   "ALREADY_CORRECT": 3693,
+   "MANUAL_INPUT_REQUIRED": 18,
+   "NOT_APPLICABLE": 1
+  },
+  "CFOP_ENTRADA": {
+   "ALREADY_CORRECT": 3672,
+   "MANUAL_INPUT_REQUIRED": 40
+  },
+  "CST": {
+   "NOT_APPLICABLE": 3712
+  },
+  "CST_ENTRADA": {
+   "NOT_APPLICABLE": 3712
+  },
+  "CSOSN": {
+   "ALREADY_CORRECT": 3696,
+   "MANUAL_INPUT_REQUIRED": 16
+  },
+  "ALIQUOTA": {
+   "NOT_APPLICABLE": 3709,
+   "ALREADY_CORRECT": 3
+  },
+  "COD_ORIGEM_MERCADORIA": {
+   "MANUAL_INPUT_REQUIRED": 3711,
+   "ALREADY_CORRECT": 1
+  },
+  "CST_IPI": {
+   "NOT_APPLICABLE": 3712
+  },
+  "COD_ENTRADA_PIS": {
+   "NOT_APPLICABLE": 3712
+  },
+  "COD_SAIDA_PIS": {
+   "NOT_APPLICABLE": 3712
+  },
+  "ALIQ_PIS": {
+   "NOT_APPLICABLE": 3712
+  },
+  "COD_ENTRADA_COFINS": {
+   "NOT_APPLICABLE": 3712
+  },
+  "COD_SAIDA_COFINS": {
+   "NOT_APPLICABLE": 3712
+  },
+  "ALIQ_COFINS": {
+   "NOT_APPLICABLE": 3712
+  },
+  "INCIDENCIA_PISCOFINS": {
+   "ALREADY_CORRECT": 3712
+  },
+  "PISCOFINS": {
+   "ALREADY_CORRECT": 3712
+  },
+  "IAT": {
+   "ALREADY_CORRECT": 3712
+  },
+  "IPPT": {
+   "ALREADY_CORRECT": 3711,
+   "NOT_APPLICABLE": 1
+  }
+ },
+ "reasons": {
+  "CLASSIFICACAO_FISCAL": {
+   "ALREADY_CORRECT|NCM_VALID_IN_DATASET": 3698,
+   "MANUAL_INPUT_REQUIRED|NCM_INVALID": 14
+  },
+  "IPI": {
+   "ALREADY_CORRECT|TIPI_NUMERIC_RATE": 1497,
+   "NOT_APPLICABLE|TIPI_RATE_BLANK_NEVER_ZERO": 1220,
+   "MANUAL_INPUT_REQUIRED|SEVERAL_TIPI_ROWS_FOR_NCM": 918,
+   "NOT_APPLICABLE|TIPI_NT_OR_NON_NUMERIC_NEVER_WRITTEN_TO_NUMERIC_FIELD": 63,
+   "MANUAL_INPUT_REQUIRED|BLOCKED_BY_NCM": 14
+  },
+  "EX_TIPI": {
+   "NOT_APPLICABLE|NO_EX_ROW_FOR_NCM": 2780,
+   "NOT_APPLICABLE|DESCRIPTION_EVIDENCES_NO_EX_BASE_RATE_APPLIES": 918,
+   "MANUAL_INPUT_REQUIRED|BLOCKED_BY_NCM": 14
+  },
+  "CEST": {
+   "ALREADY_CORRECT|ERP_CEST_IS_OFFICIAL_FOR_NCM": 2826,
+   "MANUAL_INPUT_REQUIRED|ERP_CEST_NOT_OFFICIAL_FOR_NCM": 437,
+   "MANUAL_INPUT_REQUIRED|ERP_CEST_BUT_NCM_NOT_IN_CEST_LIST": 202,
+   "NOT_APPLICABLE|DESCRIPTION_MATCHES_NO_OFFICIAL_CEST_ITEM": 169,
+   "NOT_APPLICABLE|NCM_NOT_IN_CEST_LIST": 64,
+   "MANUAL_INPUT_REQUIRED|BLOCKED_BY_NCM": 14
+  },
+  "SITUACAO_TRIBUTARIA": {
+   "ALREADY_CORRECT|DECLARED_VALID_NOT_CONTRADICTED": 2810,
+   "MANUAL_INPUT_REQUIRED|ST_PROVEN_RETENTION_UNKNOWN": 867,
+   "MANUAL_INPUT_REQUIRED|BLANK_OR_INVALID": 21,
+   "MANUAL_INPUT_REQUIRED|BLOCKED_BY_NCM": 14
+  },
+  "CFOP": {
+   "ALREADY_CORRECT|DECLARED_VALID_NOT_CONTRADICTED": 3622,
+   "ALREADY_CORRECT|RULE_PROVEN_EQUALS_DECLARED": 71,
+   "MANUAL_INPUT_REQUIRED|BLOCKED_BY_NCM": 14,
+   "MANUAL_INPUT_REQUIRED|OFFICIAL_ST_TABLE_CONFLICTS_WITH_ERP_ST_DECLARATION": 3,
+   "NOT_APPLICABLE|INPUT_IS_NOT_A_SALE_ITEM": 1,
+   "MANUAL_INPUT_REQUIRED|CFOP_NEEDS_ST_STATUS": 1
+  },
+  "CFOP_ENTRADA": {
+   "ALREADY_CORRECT|DECLARED_VALID_NOT_CONTRADICTED": 3672,
+   "MANUAL_INPUT_REQUIRED|CFOP_ENTRADA_NEEDS_ENTRY_SCOPE": 26,
+   "MANUAL_INPUT_REQUIRED|BLOCKED_BY_NCM": 14
+  },
+  "CST": {
+   "NOT_APPLICABLE|CRT1_SIMPLES_EMISSION_USES_CSOSN": 3712
+  },
+  "CST_ENTRADA": {
+   "NOT_APPLICABLE|CRT1_SIMPLES_EMISSION_USES_CSOSN": 3712
+  },
+  "CSOSN": {
+   "ALREADY_CORRECT|DECLARED_VALID_NOT_CONTRADICTED": 3696,
+   "MANUAL_INPUT_REQUIRED|BLOCKED_BY_NCM": 14,
+   "MANUAL_INPUT_REQUIRED|CSOSN_NEEDS_ICMS_TREATMENT": 2
+  },
+  "ALIQUOTA": {
+   "NOT_APPLICABLE|SIMPLES_CSOSN_HIGHLIGHTS_NO_ICMS_RATE": 3709,
+   "ALREADY_CORRECT|DECLARED_VALID_NOT_CONTRADICTED": 3
+  },
+  "COD_ORIGEM_MERCADORIA": {
+   "MANUAL_INPUT_REQUIRED|ORIGIN_NO_EVIDENCE": 3711,
+   "ALREADY_CORRECT|DECLARED_VALID_NOT_CONTRADICTED": 1
+  },
+  "CST_IPI": {
+   "NOT_APPLICABLE|COMPANY_IS_NOT_AN_IPI_TAXPAYER_C000004.CONTRIBUINTE_IPI": 3712
+  },
+  "COD_ENTRADA_PIS": {
+   "NOT_APPLICABLE|SGV_EMISSION_IGNORES_PIS_COFINS_PRODUCT_FIELDS_SIMPLES_NACIONAL": 3712
+  },
+  "COD_SAIDA_PIS": {
+   "NOT_APPLICABLE|SGV_EMISSION_IGNORES_PIS_COFINS_PRODUCT_FIELDS_SIMPLES_NACIONAL": 3712
+  },
+  "ALIQ_PIS": {
+   "NOT_APPLICABLE|SGV_EMISSION_IGNORES_PIS_COFINS_PRODUCT_FIELDS_SIMPLES_NACIONAL": 3712
+  },
+  "COD_ENTRADA_COFINS": {
+   "NOT_APPLICABLE|SGV_EMISSION_IGNORES_PIS_COFINS_PRODUCT_FIELDS_SIMPLES_NACIONAL": 3712
+  },
+  "COD_SAIDA_COFINS": {
+   "NOT_APPLICABLE|SGV_EMISSION_IGNORES_PIS_COFINS_PRODUCT_FIELDS_SIMPLES_NACIONAL": 3712
+  },
+  "ALIQ_COFINS": {
+   "NOT_APPLICABLE|SGV_EMISSION_IGNORES_PIS_COFINS_PRODUCT_FIELDS_SIMPLES_NACIONAL": 3712
+  },
+  "INCIDENCIA_PISCOFINS": {
+   "ALREADY_CORRECT|DECLARED_VALID_NOT_CONTRADICTED": 3712
+  },
+  "PISCOFINS": {
+   "ALREADY_CORRECT|DECLARED_VALID_NOT_CONTRADICTED": 3712
+  },
+  "IAT": {
+   "ALREADY_CORRECT|DECLARED_VALID_NOT_CONTRADICTED": 3712
+  },
+  "IPPT": {
+   "ALREADY_CORRECT|DERIVED_FROM_PRODUCT_ROLE:C000025.TIPO=VENDA,PURCHASE_DOCUMENT": 3707,
+   "ALREADY_CORRECT|DECLARED_VALID_NOT_CONTRADICTED": 4,
+   "NOT_APPLICABLE|INPUT_OR_SERVICE_HAS_NO_PRODUCTION_INDICATOR": 1
+  }
+ },
+ "manual_inputs": {
+  "COD_ORIGEM_MERCADORIA|origin": 3711,
+  "IPI|ex_tipi": 918,
+  "SITUACAO_TRIBUTARIA|st_withheld": 867,
+  "CEST|cest": 639,
+  "CFOP_ENTRADA|entry_scope": 26,
+  "SITUACAO_TRIBUTARIA|icms_treatment": 21,
+  "CLASSIFICACAO_FISCAL|ncm": 14,
+  "IPI|ncm": 14,
+  "EX_TIPI|ncm": 14,
+  "CEST|ncm": 14,
+  "SITUACAO_TRIBUTARIA|ncm": 14,
+  "CFOP|ncm": 14,
+  "CFOP_ENTRADA|ncm": 14,
+  "CSOSN|ncm": 14,
+  "CFOP|st_status": 4,
+  "CSOSN|icms_treatment": 2
+ },
+ "roles": {
+  "RESALE": 3707,
+  "UNKNOWN": 4,
+  "INPUT": 1
+ },
+ "change_required_cells": 0,
+ "write_eligible_cells": 0
+}

docs/runs/local_completion/CONSTRUCAO_second_pass.json

@@ -0,0 +1,90 @@
+{
+ "name": "CONSTRUCAO",
+ "SECOND_PASS_CHANGE_REQUIRED": 0,
+ "SECOND_PASS_WRITES": 0,
+ "fields": {
+  "CLASSIFICACAO_FISCAL": {
+   "ALREADY_CORRECT": 3698,
+   "MANUAL_INPUT_REQUIRED": 14
+  },
+  "IPI": {
+   "NOT_APPLICABLE": 1283,
+   "ALREADY_CORRECT": 1497,
+   "MANUAL_INPUT_REQUIRED": 932
+  },
+  "EX_TIPI": {
+   "NOT_APPLICABLE": 3698,
+   "MANUAL_INPUT_REQUIRED": 14
+  },
+  "CEST": {
+   "ALREADY_CORRECT": 2826,
+   "NOT_APPLICABLE": 233,
+   "MANUAL_INPUT_REQUIRED": 653
+  },
+  "SITUACAO_TRIBUTARIA": {
+   "ALREADY_CORRECT": 2810,
+   "MANUAL_INPUT_REQUIRED": 902
+  },
+  "CFOP": {
+   "ALREADY_CORRECT": 3693,
+   "MANUAL_INPUT_REQUIRED": 18,
+   "NOT_APPLICABLE": 1
+  },
+  "CFOP_ENTRADA": {
+   "ALREADY_CORRECT": 3672,
+   "MANUAL_INPUT_REQUIRED": 40
+  },
+  "CST": {
+   "NOT_APPLICABLE": 3712
+  },
+  "CST_ENTRADA": {
+   "NOT_APPLICABLE": 3712
+  },
+  "CSOSN": {
+   "ALREADY_CORRECT": 3696,
+   "MANUAL_INPUT_REQUIRED": 16
+  },
+  "ALIQUOTA": {
+   "NOT_APPLICABLE": 3709,
+   "ALREADY_CORRECT": 3
+  },
+  "COD_ORIGEM_MERCADORIA": {
+   "MANUAL_INPUT_REQUIRED": 3711,
+   "ALREADY_CORRECT": 1
+  },
+  "CST_IPI": {
+   "NOT_APPLICABLE": 3712
+  },
+  "COD_ENTRADA_PIS": {
+   "NOT_APPLICABLE": 3712
+  },
+  "COD_SAIDA_PIS": {
+   "NOT_APPLICABLE": 3712
+  },
+  "ALIQ_PIS": {
+   "NOT_APPLICABLE": 3712
+  },
+  "COD_ENTRADA_COFINS": {
+   "NOT_APPLICABLE": 3712
+  },
+  "COD_SAIDA_COFINS": {
+   "NOT_APPLICABLE": 3712
+  },
+  "ALIQ_COFINS": {
+   "NOT_APPLICABLE": 3712
+  },
+  "INCIDENCIA_PISCOFINS": {
+   "ALREADY_CORRECT": 3712
+  },
+  "PISCOFINS": {
+   "ALREADY_CORRECT": 3712
+  },
+  "IAT": {
+   "ALREADY_CORRECT": 3712
+  },
+  "IPPT": {
+   "ALREADY_CORRECT": 3711,
+   "NOT_APPLICABLE": 1
+  }
+ }
+}

docs/runs/local_completion/CONSTRUCAO_verify_summary.json

@@ -0,0 +1,10 @@
+{
+ "name": "CONSTRUCAO",
+ "products_after": 3712,
+ "products_before": 3712,
+ "planned_cells": 772,
+ "post_write_verified": 772,
+ "planned_mismatch": 0,
+ "unplanned_changes": 0,
+ "problems": []
+}

docs/runs/local_completion/MMMODAS_apply_summary.json

@@ -0,0 +1,8 @@
+{
+ "name": "MMMODAS",
+ "cells_attempted": 1,
+ "cells_succeeded": 1,
+ "cells_failed": 0,
+ "products_updated": 1,
+ "failures": []
+}

docs/runs/local_completion/MMMODAS_dryrun_summary.json

@@ -0,0 +1,289 @@
+{
+ "name": "MMMODAS",
+ "total_products": 20997,
+ "company": {
+  "uf": "BA",
+  "crt": "1",
+  "contribuinte_ipi": "N",
+  "company_code": "000001",
+  "company_key": "b89a9205",
+  "pis_cofins_emission_items": 26067,
+  "pis_cofins_emission_nonblank": 0,
+  "pis_cofins_unused_by_emission": true
+ },
+ "context_entries": 0,
+ "fields": {
+  "CLASSIFICACAO_FISCAL": {
+   "ALREADY_CORRECT": 20879,
+   "MANUAL_INPUT_REQUIRED": 118
+  },
+  "IPI": {
+   "NOT_APPLICABLE": 18923,
+   "ALREADY_CORRECT": 1947,
+   "MANUAL_INPUT_REQUIRED": 127
+  },
+  "EX_TIPI": {
+   "NOT_APPLICABLE": 20879,
+   "MANUAL_INPUT_REQUIRED": 118
+  },
+  "CEST": {
+   "NOT_APPLICABLE": 20831,
+   "MANUAL_INPUT_REQUIRED": 163,
+   "ALREADY_CORRECT": 3
+  },
+  "SITUACAO_TRIBUTARIA": {
+   "ALREADY_CORRECT": 20876,
+   "MANUAL_INPUT_REQUIRED": 121
+  },
+  "CFOP": {
+   "ALREADY_CORRECT": 20824,
+   "MANUAL_INPUT_REQUIRED": 169,
+   "NOT_APPLICABLE": 4
+  },
+  "CFOP_ENTRADA": {
+   "ALREADY_CORRECT": 20765,
+   "MANUAL_INPUT_REQUIRED": 232
+  },
+  "CST": {
+   "NOT_APPLICABLE": 20995,
+   "MANUAL_INPUT_REQUIRED": 2
+  },
+  "CST_ENTRADA": {
+   "NOT_APPLICABLE": 20995,
+   "MANUAL_INPUT_REQUIRED": 2
+  },
+  "CSOSN": {
+   "ALREADY_CORRECT": 20821,
+   "MANUAL_INPUT_REQUIRED": 176
+  },
+  "ALIQUOTA": {
+   "NOT_APPLICABLE": 20916,
+   "ALREADY_CORRECT": 79,
+   "MANUAL_INPUT_REQUIRED": 2
+  },
+  "COD_ORIGEM_MERCADORIA": {
+   "MANUAL_INPUT_REQUIRED": 20997
+  },
+  "CST_IPI": {
+   "NOT_APPLICABLE": 20995,
+   "MANUAL_INPUT_REQUIRED": 2
+  },
+  "COD_ENTRADA_PIS": {
+   "NOT_APPLICABLE": 20995,
+   "MANUAL_INPUT_REQUIRED": 2
+  },
+  "COD_SAIDA_PIS": {
+   "ALREADY_CORRECT": 1,
+   "NOT_APPLICABLE": 20994,
+   "MANUAL_INPUT_REQUIRED": 2
+  },
+  "ALIQ_PIS": {
+   "NOT_APPLICABLE": 20995,
+   "MANUAL_INPUT_REQUIRED": 2
+  },
+  "COD_ENTRADA_COFINS": {
+   "NOT_APPLICABLE": 20995,
+   "MANUAL_INPUT_REQUIRED": 2
+  },
+  "COD_SAIDA_COFINS": {
+   "ALREADY_CORRECT": 1,
+   "NOT_APPLICABLE": 20994,
+   "MANUAL_INPUT_REQUIRED": 2
+  },
+  "ALIQ_COFINS": {
+   "NOT_APPLICABLE": 20995,
+   "MANUAL_INPUT_REQUIRED": 2
+  },
+  "INCIDENCIA_PISCOFINS": {
+   "ALREADY_CORRECT": 20995,
+   "MANUAL_INPUT_REQUIRED": 2
+  },
+  "PISCOFINS": {
+   "ALREADY_CORRECT": 20995,
+   "MANUAL_INPUT_REQUIRED": 2
+  },
+  "IAT": {
+   "ALREADY_CORRECT": 20995,
+   "MANUAL_INPUT_REQUIRED": 2
+  },
+  "IPPT": {
+   "ALREADY_CORRECT": 20991,
+   "NOT_APPLICABLE": 4,
+   "MANUAL_INPUT_REQUIRED": 2
+  }
+ },
+ "reasons": {
+  "CLASSIFICACAO_FISCAL": {
+   "ALREADY_CORRECT|NCM_VALID_IN_DATASET": 20879,
+   "MANUAL_INPUT_REQUIRED|NCM_INVALID": 116,
+   "MANUAL_INPUT_REQUIRED|DUPLICATE_KEY_BLOCKED": 2
+  },
+  "IPI": {
+   "NOT_APPLICABLE|TIPI_RATE_BLANK_NEVER_ZERO": 18885,
+   "ALREADY_CORRECT|TIPI_NUMERIC_RATE": 1947,
+   "MANUAL_INPUT_REQUIRED|BLOCKED_BY_NCM": 116,
+   "NOT_APPLICABLE|TIPI_NT_OR_NON_NUMERIC_NEVER_WRITTEN_TO_NUMERIC_FIELD": 38,
+   "MANUAL_INPUT_REQUIRED|SEVERAL_TIPI_ROWS_FOR_NCM": 9,
+   "MANUAL_INPUT_REQUIRED|DUPLICATE_KEY_BLOCKED": 2
+  },
+  "EX_TIPI": {
+   "NOT_APPLICABLE|NO_EX_ROW_FOR_NCM": 20870,
+   "MANUAL_INPUT_REQUIRED|BLOCKED_BY_NCM": 116,
+   "NOT_APPLICABLE|DESCRIPTION_EVIDENCES_NO_EX_BASE_RATE_APPLIES": 9,
+   "MANUAL_INPUT_REQUIRED|DUPLICATE_KEY_BLOCKED": 2
+  },
+  "CEST": {
+   "NOT_APPLICABLE|DESCRIPTION_MATCHES_NO_OFFICIAL_CEST_ITEM": 20793,
+   "MANUAL_INPUT_REQUIRED|BLOCKED_BY_NCM": 116,
+   "MANUAL_INPUT_REQUIRED|SEVERAL_OFFICIAL_CEST_FOR_NCM": 45,
+   "NOT_APPLICABLE|NCM_NOT_IN_CEST_LIST": 38,
+   "ALREADY_CORRECT|ERP_CEST_IS_OFFICIAL_FOR_NCM": 3,
+   "MANUAL_INPUT_REQUIRED|DUPLICATE_KEY_BLOCKED": 2
+  },
+  "SITUACAO_TRIBUTARIA": {
+   "ALREADY_CORRECT|DECLARED_VALID_NOT_CONTRADICTED": 20876,
+   "MANUAL_INPUT_REQUIRED|BLOCKED_BY_NCM": 116,
+   "MANUAL_INPUT_REQUIRED|BLANK_OR_INVALID": 3,
+   "MANUAL_INPUT_REQUIRED|DUPLICATE_KEY_BLOCKED": 2
+  },
+  "CFOP": {
+   "ALREADY_CORRECT|DECLARED_VALID_NOT_CONTRADICTED": 20786,
+   "MANUAL_INPUT_REQUIRED|BLOCKED_BY_NCM": 116,
+   "MANUAL_INPUT_REQUIRED|CFOP_NEEDS_ST_STATUS": 49,
+   "ALREADY_CORRECT|RULE_PROVEN_EQUALS_DECLARED": 38,
+   "NOT_APPLICABLE|INPUT_IS_NOT_A_SALE_ITEM": 4,
+   "MANUAL_INPUT_REQUIRED|CFOP_NEEDS_PRODUCT_ROLE": 2,
+   "MANUAL_INPUT_REQUIRED|DUPLICATE_KEY_BLOCKED": 2
+  },
+  "CFOP_ENTRADA": {
+   "ALREADY_CORRECT|DECLARED_VALID_NOT_CONTRADICTED": 20765,
+   "MANUAL_INPUT_REQUIRED|BLOCKED_BY_NCM": 116,
+   "MANUAL_INPUT_REQUIRED|CFOP_ENTRADA_NEEDS_ENTRY_SCOPE": 110,
+   "MANUAL_INPUT_REQUIRED|CFOP_ENTRADA_NEEDS_PRODUCT_ROLE": 4,
+   "MANUAL_INPUT_REQUIRED|DUPLICATE_KEY_BLOCKED": 2
+  },
+  "CST": {
+   "NOT_APPLICABLE|CRT1_SIMPLES_EMISSION_USES_CSOSN": 20995,
+   "MANUAL_INPUT_REQUIRED|DUPLICATE_KEY_BLOCKED": 2
+  },
+  "CST_ENTRADA": {
+   "NOT_APPLICABLE|CRT1_SIMPLES_EMISSION_USES_CSOSN": 20995,
+   "MANUAL_INPUT_REQUIRED|DUPLICATE_KEY_BLOCKED": 2
+  },
+  "CSOSN": {
+   "ALREADY_CORRECT|DECLARED_VALID_NOT_CONTRADICTED": 20821,
+   "MANUAL_INPUT_REQUIRED|BLOCKED_BY_NCM": 116,
+   "MANUAL_INPUT_REQUIRED|CSOSN_NEEDS_ICMS_TREATMENT": 58,
+   "MANUAL_INPUT_REQUIRED|DUPLICATE_KEY_BLOCKED": 2
+  },
+  "ALIQUOTA": {
+   "NOT_APPLICABLE|SIMPLES_CSOSN_HIGHLIGHTS_NO_ICMS_RATE": 20916,
+   "ALREADY_CORRECT|DECLARED_VALID_NOT_CONTRADICTED": 79,
+   "MANUAL_INPUT_REQUIRED|DUPLICATE_KEY_BLOCKED": 2
+  },
+  "COD_ORIGEM_MERCADORIA": {
+   "MANUAL_INPUT_REQUIRED|ORIGIN_NO_EVIDENCE": 20995,
+   "MANUAL_INPUT_REQUIRED|DUPLICATE_KEY_BLOCKED": 2
+  },
+  "CST_IPI": {
+   "NOT_APPLICABLE|COMPANY_IS_NOT_AN_IPI_TAXPAYER_C000004.CONTRIBUINTE_IPI": 20995,
+   "MANUAL_INPUT_REQUIRED|DUPLICATE_KEY_BLOCKED": 2
+  },
+  "COD_ENTRADA_PIS": {
+   "NOT_APPLICABLE|SGV_EMISSION_IGNORES_PIS_COFINS_PRODUCT_FIELDS_SIMPLES_NACIONAL": 20995,
+   "MANUAL_INPUT_REQUIRED|DUPLICATE_KEY_BLOCKED": 2
+  },
+  "COD_SAIDA_PIS": {
+   "NOT_APPLICABLE|SGV_EMISSION_IGNORES_PIS_COFINS_PRODUCT_FIELDS_SIMPLES_NACIONAL": 20994,
+   "MANUAL_INPUT_REQUIRED|DUPLICATE_KEY_BLOCKED": 2,
+   "ALREADY_CORRECT|DECLARED_VALID_NOT_CONTRADICTED": 1
+  },
+  "ALIQ_PIS": {
+   "NOT_APPLICABLE|SGV_EMISSION_IGNORES_PIS_COFINS_PRODUCT_FIELDS_SIMPLES_NACIONAL": 20994,
+   "MANUAL_INPUT_REQUIRED|DUPLICATE_KEY_BLOCKED": 2,
+   "NOT_APPLICABLE|RATE_NOT_INFORMED_FOR_CST_06": 1
+  },
+  "COD_ENTRADA_COFINS": {
+   "NOT_APPLICABLE|SGV_EMISSION_IGNORES_PIS_COFINS_PRODUCT_FIELDS_SIMPLES_NACIONAL": 20995,
+   "MANUAL_INPUT_REQUIRED|DUPLICATE_KEY_BLOCKED": 2
+  },
+  "COD_SAIDA_COFINS": {
+   "NOT_APPLICABLE|SGV_EMISSION_IGNORES_PIS_COFINS_PRODUCT_FIELDS_SIMPLES_NACIONAL": 20994,
+   "MANUAL_INPUT_REQUIRED|DUPLICATE_KEY_BLOCKED": 2,
+   "ALREADY_CORRECT|DECLARED_VALID_NOT_CONTRADICTED": 1
+  },
+  "ALIQ_COFINS": {
+   "NOT_APPLICABLE|SGV_EMISSION_IGNORES_PIS_COFINS_PRODUCT_FIELDS_SIMPLES_NACIONAL": 20994,
+   "MANUAL_INPUT_REQUIRED|DUPLICATE_KEY_BLOCKED": 2,
+   "NOT_APPLICABLE|RATE_NOT_INFORMED_FOR_CST_06": 1
+  },
+  "INCIDENCIA_PISCOFINS": {
+   "ALREADY_CORRECT|DECLARED_VALID_NOT_CONTRADICTED": 20995,
+   "MANUAL_INPUT_REQUIRED|DUPLICATE_KEY_BLOCKED": 2
+  },
+  "PISCOFINS": {
+   "ALREADY_CORRECT|DECLARED_VALID_NOT_CONTRADICTED": 20995,
+   "MANUAL_INPUT_REQUIRED|DUPLICATE_KEY_BLOCKED": 2
+  },
+  "IAT": {
+   "ALREADY_CORRECT|DECLARED_VALID_NOT_CONTRADICTED": 20995,
+   "MANUAL_INPUT_REQUIRED|DUPLICATE_KEY_BLOCKED": 2
+  },
+  "IPPT": {
+   "ALREADY_CORRECT|DERIVED_FROM_PRODUCT_ROLE:C000025.TIPO=VENDA,PURCHASE_DOCUMENT": 20903,
+   "ALREADY_CORRECT|DECLARED_VALID_NOT_CONTRADICTED": 87,
+   "NOT_APPLICABLE|INPUT_OR_SERVICE_HAS_NO_PRODUCTION_INDICATOR": 4,
+   "MANUAL_INPUT_REQUIRED|DUPLICATE_KEY_BLOCKED": 2,
+   "ALREADY_CORRECT|DERIVED_FROM_PRODUCT_ROLE:C000025.TIPO=VENDA,STOCK_ENTRIES(C000100.ENTRADAS>0)": 1
+  }
+ },
+ "manual_inputs": {
+  "COD_ORIGEM_MERCADORIA|origin": 20995,
+  "CLASSIFICACAO_FISCAL|ncm": 116,
+  "IPI|ncm": 116,
+  "EX_TIPI|ncm": 116,
+  "CEST|ncm": 116,
+  "SITUACAO_TRIBUTARIA|ncm": 116,
+  "CFOP|ncm": 116,
+  "CFOP_ENTRADA|ncm": 116,
+  "CSOSN|ncm": 116,
+  "CFOP_ENTRADA|entry_scope": 110,
+  "CSOSN|icms_treatment": 58,
+  "CFOP|st_status": 49,
+  "CEST|cest": 45,
+  "IPI|ex_tipi": 9,
+  "CFOP_ENTRADA|product_role": 4,
+  "SITUACAO_TRIBUTARIA|icms_treatment": 3,
+  "CFOP|product_role": 2,
+  "CLASSIFICACAO_FISCAL|duplicate_code": 2,
+  "IPI|duplicate_code": 2,
+  "EX_TIPI|duplicate_code": 2,
+  "CEST|duplicate_code": 2,
+  "SITUACAO_TRIBUTARIA|duplicate_code": 2,
+  "CFOP|duplicate_code": 2,
+  "CFOP_ENTRADA|duplicate_code": 2,
+  "CST|duplicate_code": 2,
+  "CST_ENTRADA|duplicate_code": 2,
+  "CSOSN|duplicate_code": 2,
+  "ALIQUOTA|duplicate_code": 2,
+  "COD_ORIGEM_MERCADORIA|duplicate_code": 2,
+  "CST_IPI|duplicate_code": 2,
+  "COD_ENTRADA_PIS|duplicate_code": 2,
+  "COD_SAIDA_PIS|duplicate_code": 2,
+  "ALIQ_PIS|duplicate_code": 2,
+  "COD_ENTRADA_COFINS|duplicate_code": 2,
+  "COD_SAIDA_COFINS|duplicate_code": 2,
+  "ALIQ_COFINS|duplicate_code": 2,
+  "INCIDENCIA_PISCOFINS|duplicate_code": 2,
+  "PISCOFINS|duplicate_code": 2,
+  "IAT|duplicate_code": 2,
+  "IPPT|duplicate_code": 2
+ },
+ "roles": {
+  "RESALE": 20906,
+  "UNKNOWN": 87,
+  "INPUT": 4
+ },
+ "change_required_cells": 0,
+ "write_eligible_cells": 0
+}

docs/runs/local_completion/MMMODAS_second_pass.json

@@ -0,0 +1,105 @@
+{
+ "name": "MMMODAS",
+ "SECOND_PASS_CHANGE_REQUIRED": 0,
+ "SECOND_PASS_WRITES": 0,
+ "fields": {
+  "CLASSIFICACAO_FISCAL": {
+   "ALREADY_CORRECT": 20879,
+   "MANUAL_INPUT_REQUIRED": 118
+  },
+  "IPI": {
+   "NOT_APPLICABLE": 18923,
+   "ALREADY_CORRECT": 1947,
+   "MANUAL_INPUT_REQUIRED": 127
+  },
+  "EX_TIPI": {
+   "NOT_APPLICABLE": 20879,
+   "MANUAL_INPUT_REQUIRED": 118
+  },
+  "CEST": {
+   "NOT_APPLICABLE": 20831,
+   "MANUAL_INPUT_REQUIRED": 163,
+   "ALREADY_CORRECT": 3
+  },
+  "SITUACAO_TRIBUTARIA": {
+   "ALREADY_CORRECT": 20876,
+   "MANUAL_INPUT_REQUIRED": 121
+  },
+  "CFOP": {
+   "ALREADY_CORRECT": 20824,
+   "MANUAL_INPUT_REQUIRED": 169,
+   "NOT_APPLICABLE": 4
+  },
+  "CFOP_ENTRADA": {
+   "ALREADY_CORRECT": 20765,
+   "MANUAL_INPUT_REQUIRED": 232
+  },
+  "CST": {
+   "NOT_APPLICABLE": 20995,
+   "MANUAL_INPUT_REQUIRED": 2
+  },
+  "CST_ENTRADA": {
+   "NOT_APPLICABLE": 20995,
+   "MANUAL_INPUT_REQUIRED": 2
+  },
+  "CSOSN": {
+   "ALREADY_CORRECT": 20821,
+   "MANUAL_INPUT_REQUIRED": 176
+  },
+  "ALIQUOTA": {
+   "NOT_APPLICABLE": 20916,
+   "ALREADY_CORRECT": 79,
+   "MANUAL_INPUT_REQUIRED": 2
+  },
+  "COD_ORIGEM_MERCADORIA": {
+   "MANUAL_INPUT_REQUIRED": 20997
+  },
+  "CST_IPI": {
+   "NOT_APPLICABLE": 20995,
+   "MANUAL_INPUT_REQUIRED": 2
+  },
+  "COD_ENTRADA_PIS": {
+   "NOT_APPLICABLE": 20995,
+   "MANUAL_INPUT_REQUIRED": 2
+  },
+  "COD_SAIDA_PIS": {
+   "ALREADY_CORRECT": 1,
+   "NOT_APPLICABLE": 20994,
+   "MANUAL_INPUT_REQUIRED": 2
+  },
+  "ALIQ_PIS": {
+   "NOT_APPLICABLE": 20995,
+   "MANUAL_INPUT_REQUIRED": 2
+  },
+  "COD_ENTRADA_COFINS": {
+   "NOT_APPLICABLE": 20995,
+   "MANUAL_INPUT_REQUIRED": 2
+  },
+  "COD_SAIDA_COFINS": {
+   "ALREADY_CORRECT": 1,
+   "NOT_APPLICABLE": 20994,
+   "MANUAL_INPUT_REQUIRED": 2
+  },
+  "ALIQ_COFINS": {
+   "NOT_APPLICABLE": 20995,
+   "MANUAL_INPUT_REQUIRED": 2
+  },
+  "INCIDENCIA_PISCOFINS": {
+   "ALREADY_CORRECT": 20995,
+   "MANUAL_INPUT_REQUIRED": 2
+  },
+  "PISCOFINS": {
+   "ALREADY_CORRECT": 20995,
+   "MANUAL_INPUT_REQUIRED": 2
+  },
+  "IAT": {
+   "ALREADY_CORRECT": 20995,
+   "MANUAL_INPUT_REQUIRED": 2
+  },
+  "IPPT": {
+   "ALREADY_CORRECT": 20991,
+   "NOT_APPLICABLE": 4,
+   "MANUAL_INPUT_REQUIRED": 2
+  }
+ }
+}

docs/runs/local_completion/MMMODAS_verify_summary.json

@@ -0,0 +1,25 @@
+{
+ "name": "MMMODAS",
+ "products_after": 20996,
+ "products_before": 20996,
+ "planned_cells": 1,
+ "post_write_verified": 1,
+ "planned_mismatch": 0,
+ "unplanned_changes": 2,
+ "problems": [
+  [
+   "000002",
+   "COD_SAIDA_PIS",
+   "UNPLANNED_CHANGE",
+   null,
+   "06"
+  ],
+  [
+   "000002",
+   "COD_SAIDA_COFINS",
+   "UNPLANNED_CHANGE",
+   null,
+   "06"
+  ]
+ ]
+}

docs/runs/local_completion/RINCAO_apply_summary.json

@@ -0,0 +1,8 @@
+{
+ "name": "RINCAO",
+ "cells_attempted": 148,
+ "cells_succeeded": 148,
+ "cells_failed": 0,
+ "products_updated": 148,
+ "failures": []
+}

docs/runs/local_completion/RINCAO_dryrun_summary.json

@@ -0,0 +1,223 @@
+{
+ "name": "RINCAO",
+ "total_products": 894,
+ "company": {
+  "uf": "BA",
+  "crt": "3",
+  "contribuinte_ipi": "N",
+  "company_code": "000001",
+  "company_key": "df6060d6",
+  "pis_cofins_emission_items": 224355,
+  "pis_cofins_emission_nonblank": 0,
+  "pis_cofins_unused_by_emission": true
+ },
+ "context_entries": 0,
+ "fields": {
+  "CLASSIFICACAO_FISCAL": {
+   "ALREADY_CORRECT": 894
+  },
+  "IPI": {
+   "ALREADY_CORRECT": 349,
+   "NOT_APPLICABLE": 396,
+   "MANUAL_INPUT_REQUIRED": 149
+  },
+  "EX_TIPI": {
+   "NOT_APPLICABLE": 894
+  },
+  "CEST": {
+   "ALREADY_CORRECT": 318,
+   "MANUAL_INPUT_REQUIRED": 323,
+   "NOT_APPLICABLE": 253
+  },
+  "SITUACAO_TRIBUTARIA": {
+   "MANUAL_INPUT_REQUIRED": 52,
+   "ALREADY_CORRECT": 842
+  },
+  "CFOP": {
+   "ALREADY_CORRECT": 892,
+   "MANUAL_INPUT_REQUIRED": 1,
+   "NOT_APPLICABLE": 1
+  },
+  "CFOP_ENTRADA": {
+   "MANUAL_INPUT_REQUIRED": 893,
+   "ALREADY_CORRECT": 1
+  },
+  "CST": {
+   "ALREADY_CORRECT": 894
+  },
+  "CST_ENTRADA": {
+   "MANUAL_INPUT_REQUIRED": 892,
+   "ALREADY_CORRECT": 2
+  },
+  "CSOSN": {
+   "NOT_APPLICABLE": 894
+  },
+  "ALIQUOTA": {
+   "NOT_APPLICABLE": 308,
+   "ALREADY_CORRECT": 585,
+   "MANUAL_INPUT_REQUIRED": 1
+  },
+  "COD_ORIGEM_MERCADORIA": {
+   "MANUAL_INPUT_REQUIRED": 894
+  },
+  "CST_IPI": {
+   "NOT_APPLICABLE": 894
+  },
+  "COD_ENTRADA_PIS": {
+   "MANUAL_INPUT_REQUIRED": 894
+  },
+  "COD_SAIDA_PIS": {
+   "MANUAL_INPUT_REQUIRED": 894
+  },
+  "ALIQ_PIS": {
+   "MANUAL_INPUT_REQUIRED": 893,
+   "ALREADY_CORRECT": 1
+  },
+  "COD_ENTRADA_COFINS": {
+   "MANUAL_INPUT_REQUIRED": 894
+  },
+  "COD_SAIDA_COFINS": {
+   "MANUAL_INPUT_REQUIRED": 894
+  },
+  "ALIQ_COFINS": {
+   "MANUAL_INPUT_REQUIRED": 893,
+   "ALREADY_CORRECT": 1
+  },
+  "INCIDENCIA_PISCOFINS": {
+   "ALREADY_CORRECT": 894
+  },
+  "PISCOFINS": {
+   "ALREADY_CORRECT": 894
+  },
+  "IAT": {
+   "ALREADY_CORRECT": 894
+  },
+  "IPPT": {
+   "ALREADY_CORRECT": 893,
+   "NOT_APPLICABLE": 1
+  }
+ },
+ "reasons": {
+  "CLASSIFICACAO_FISCAL": {
+   "ALREADY_CORRECT|NCM_VALID_IN_DATASET": 894
+  },
+  "IPI": {
+   "NOT_APPLICABLE|TIPI_RATE_BLANK_NEVER_ZERO": 378,
+   "ALREADY_CORRECT|TIPI_NUMERIC_RATE": 349,
+   "MANUAL_INPUT_REQUIRED|SEVERAL_TIPI_ROWS_FOR_NCM": 149,
+   "NOT_APPLICABLE|TIPI_NT_OR_NON_NUMERIC_NEVER_WRITTEN_TO_NUMERIC_FIELD": 18
+  },
+  "EX_TIPI": {
+   "NOT_APPLICABLE|NO_EX_ROW_FOR_NCM": 745,
+   "NOT_APPLICABLE|DESCRIPTION_EVIDENCES_NO_EX_BASE_RATE_APPLIES": 149
+  },
+  "CEST": {
+   "ALREADY_CORRECT|ERP_CEST_IS_OFFICIAL_FOR_NCM": 318,
+   "MANUAL_INPUT_REQUIRED|ERP_CEST_NOT_OFFICIAL_FOR_NCM": 233,
+   "NOT_APPLICABLE|DESCRIPTION_MATCHES_NO_OFFICIAL_CEST_ITEM": 206,
+   "MANUAL_INPUT_REQUIRED|ERP_CEST_BUT_NCM_NOT_IN_CEST_LIST": 89,
+   "NOT_APPLICABLE|NCM_NOT_IN_CEST_LIST": 47,
+   "MANUAL_INPUT_REQUIRED|SEVERAL_OFFICIAL_CEST_FOR_NCM": 1
+  },
+  "SITUACAO_TRIBUTARIA": {
+   "ALREADY_CORRECT|DECLARED_VALID_NOT_CONTRADICTED": 842,
+   "MANUAL_INPUT_REQUIRED|ST_PROVEN_RETENTION_UNKNOWN": 51,
+   "MANUAL_INPUT_REQUIRED|BLANK_OR_INVALID": 1
+  },
+  "CFOP": {
+   "ALREADY_CORRECT|DECLARED_VALID_NOT_CONTRADICTED": 781,
+   "ALREADY_CORRECT|RULE_PROVEN_EQUALS_DECLARED": 111,
+   "MANUAL_INPUT_REQUIRED|CFOP_NEEDS_PRODUCT_ROLE": 1,
+   "NOT_APPLICABLE|INPUT_IS_NOT_A_SALE_ITEM": 1
+  },
+  "CFOP_ENTRADA": {
+   "MANUAL_INPUT_REQUIRED|CFOP_ENTRADA_NEEDS_ENTRY_SCOPE": 667,
+   "MANUAL_INPUT_REQUIRED|CFOP_ENTRADA_NEEDS_PRODUCT_ROLE": 226,
+   "ALREADY_CORRECT|DECLARED_VALID_NOT_CONTRADICTED": 1
+  },
+  "CST": {
+   "ALREADY_CORRECT|DECLARED_VALID_NOT_CONTRADICTED": 894
+  },
+  "CST_ENTRADA": {
+   "MANUAL_INPUT_REQUIRED|CST_NEEDS_ORIGIN": 892,
+   "ALREADY_CORRECT|DECLARED_VALID_NOT_CONTRADICTED": 2
+  },
+  "CSOSN": {
+   "NOT_APPLICABLE|CSOSN_IS_THE_SIMPLES_NACIONAL_CODE_CRT_IS_3": 894
+  },
+  "ALIQUOTA": {
+   "ALREADY_CORRECT|DECLARED_VALID_NOT_CONTRADICTED": 585,
+   "NOT_APPLICABLE|CST_HIGHLIGHTS_NO_ICMS_RATE": 308,
+   "MANUAL_INPUT_REQUIRED|TAXED_ITEM_WITHOUT_ICMS_RATE": 1
+  },
+  "COD_ORIGEM_MERCADORIA": {
+   "MANUAL_INPUT_REQUIRED|ORIGIN_NO_EVIDENCE": 894
+  },
+  "CST_IPI": {
+   "NOT_APPLICABLE|COMPANY_IS_NOT_AN_IPI_TAXPAYER_C000004.CONTRIBUINTE_IPI": 894
+  },
+  "COD_ENTRADA_PIS": {
+   "MANUAL_INPUT_REQUIRED|NO_OFFICIAL_RULE_SOURCE_IN_CORE_DATASETS": 893,
+   "MANUAL_INPUT_REQUIRED|DECLARED_CST_NOT_IN_OFFICIAL_TABLE": 1
+  },
+  "COD_SAIDA_PIS": {
+   "MANUAL_INPUT_REQUIRED|NO_OFFICIAL_RULE_SOURCE_IN_CORE_DATASETS": 816,
+   "MANUAL_INPUT_REQUIRED|DECLARED_CST_NOT_IN_OFFICIAL_TABLE": 78
+  },
+  "ALIQ_PIS": {
+   "MANUAL_INPUT_REQUIRED|NO_OFFICIAL_RULE_SOURCE_IN_CORE_DATASETS": 893,
+   "ALREADY_CORRECT|DECLARED_VALID_NOT_CONTRADICTED": 1
+  },
+  "COD_ENTRADA_COFINS": {
+   "MANUAL_INPUT_REQUIRED|NO_OFFICIAL_RULE_SOURCE_IN_CORE_DATASETS": 893,
+   "MANUAL_INPUT_REQUIRED|DECLARED_CST_NOT_IN_OFFICIAL_TABLE": 1
+  },
+  "COD_SAIDA_COFINS": {
+   "MANUAL_INPUT_REQUIRED|NO_OFFICIAL_RULE_SOURCE_IN_CORE_DATASETS": 816,
+   "MANUAL_INPUT_REQUIRED|DECLARED_CST_NOT_IN_OFFICIAL_TABLE": 78
+  },
+  "ALIQ_COFINS": {
+   "MANUAL_INPUT_REQUIRED|NO_OFFICIAL_RULE_SOURCE_IN_CORE_DATASETS": 893,
+   "ALREADY_CORRECT|DECLARED_VALID_NOT_CONTRADICTED": 1
+  },
+  "INCIDENCIA_PISCOFINS": {
+   "ALREADY_CORRECT|DECLARED_VALID_NOT_CONTRADICTED": 894
+  },
+  "PISCOFINS": {
+   "ALREADY_CORRECT|DECLARED_VALID_NOT_CONTRADICTED": 894
+  },
+  "IAT": {
+   "ALREADY_CORRECT|DECLARED_VALID_NOT_CONTRADICTED": 894
+  },
+  "IPPT": {
+   "ALREADY_CORRECT|DERIVED_FROM_PRODUCT_ROLE:C000025.TIPO=VENDA,PURCHASE_DOCUMENT": 667,
+   "ALREADY_CORRECT|DECLARED_VALID_NOT_CONTRADICTED": 226,
+   "NOT_APPLICABLE|INPUT_OR_SERVICE_HAS_NO_PRODUCTION_INDICATOR": 1
+  }
+ },
+ "manual_inputs": {
+  "COD_ORIGEM_MERCADORIA|origin": 894,
+  "COD_ENTRADA_PIS|pis_cofins_profile": 894,
+  "COD_SAIDA_PIS|pis_cofins_profile": 894,
+  "COD_ENTRADA_COFINS|pis_cofins_profile": 894,
+  "COD_SAIDA_COFINS|pis_cofins_profile": 894,
+  "ALIQ_PIS|pis_cofins_profile": 893,
+  "ALIQ_COFINS|pis_cofins_profile": 893,
+  "CST_ENTRADA|origin": 892,
+  "CFOP_ENTRADA|entry_scope": 667,
+  "CEST|cest": 323,
+  "CFOP_ENTRADA|product_role": 226,
+  "IPI|ex_tipi": 149,
+  "SITUACAO_TRIBUTARIA|st_withheld": 51,
+  "SITUACAO_TRIBUTARIA|icms_treatment": 1,
+  "CFOP|product_role": 1,
+  "ALIQUOTA|icms_rate": 1
+ },
+ "roles": {
+  "RESALE": 667,
+  "UNKNOWN": 226,
+  "INPUT": 1
+ },
+ "change_required_cells": 0,
+ "write_eligible_cells": 0
+}

docs/runs/local_completion/RINCAO_second_pass.json

@@ -0,0 +1,90 @@
+{
+ "name": "RINCAO",
+ "SECOND_PASS_CHANGE_REQUIRED": 0,
+ "SECOND_PASS_WRITES": 0,
+ "fields": {
+  "CLASSIFICACAO_FISCAL": {
+   "ALREADY_CORRECT": 894
+  },
+  "IPI": {
+   "ALREADY_CORRECT": 349,
+   "NOT_APPLICABLE": 396,
+   "MANUAL_INPUT_REQUIRED": 149
+  },
+  "EX_TIPI": {
+   "NOT_APPLICABLE": 894
+  },
+  "CEST": {
+   "ALREADY_CORRECT": 318,
+   "MANUAL_INPUT_REQUIRED": 323,
+   "NOT_APPLICABLE": 253
+  },
+  "SITUACAO_TRIBUTARIA": {
+   "MANUAL_INPUT_REQUIRED": 52,
+   "ALREADY_CORRECT": 842
+  },
+  "CFOP": {
+   "ALREADY_CORRECT": 892,
+   "MANUAL_INPUT_REQUIRED": 1,
+   "NOT_APPLICABLE": 1
+  },
+  "CFOP_ENTRADA": {
+   "MANUAL_INPUT_REQUIRED": 893,
+   "ALREADY_CORRECT": 1
+  },
+  "CST": {
+   "ALREADY_CORRECT": 894
+  },
+  "CST_ENTRADA": {
+   "MANUAL_INPUT_REQUIRED": 892,
+   "ALREADY_CORRECT": 2
+  },
+  "CSOSN": {
+   "NOT_APPLICABLE": 894
+  },
+  "ALIQUOTA": {
+   "NOT_APPLICABLE": 308,
+   "ALREADY_CORRECT": 585,
+   "MANUAL_INPUT_REQUIRED": 1
+  },
+  "COD_ORIGEM_MERCADORIA": {
+   "MANUAL_INPUT_REQUIRED": 894
+  },
+  "CST_IPI": {
+   "NOT_APPLICABLE": 894
+  },
+  "COD_ENTRADA_PIS": {
+   "MANUAL_INPUT_REQUIRED": 894
+  },
+  "COD_SAIDA_PIS": {
+   "MANUAL_INPUT_REQUIRED": 894
+  },
+  "ALIQ_PIS": {
+   "MANUAL_INPUT_REQUIRED": 893,
+   "ALREADY_CORRECT": 1
+  },
+  "COD_ENTRADA_COFINS": {
+   "MANUAL_INPUT_REQUIRED": 894
+  },
+  "COD_SAIDA_COFINS": {
+   "MANUAL_INPUT_REQUIRED": 894
+  },
+  "ALIQ_COFINS": {
+   "MANUAL_INPUT_REQUIRED": 893,
+   "ALREADY_CORRECT": 1
+  },
+  "INCIDENCIA_PISCOFINS": {
+   "ALREADY_CORRECT": 894
+  },
+  "PISCOFINS": {
+   "ALREADY_CORRECT": 894
+  },
+  "IAT": {
+   "ALREADY_CORRECT": 894
+  },
+  "IPPT": {
+   "ALREADY_CORRECT": 893,
+   "NOT_APPLICABLE": 1
+  }
+ }
+}

docs/runs/local_completion/RINCAO_verify_summary.json

@@ -0,0 +1,10 @@
+{
+ "name": "RINCAO",
+ "products_after": 894,
+ "products_before": 894,
+ "planned_cells": 148,
+ "post_write_verified": 148,
+ "planned_mismatch": 0,
+ "unplanned_changes": 0,
+ "problems": []
+}

docs/runs/local_completion/TESTESOFICIAIS_apply_summary.json

@@ -0,0 +1,8 @@
+{
+ "name": "TESTESOFICIAIS",
+ "cells_attempted": 53,
+ "cells_succeeded": 53,
+ "cells_failed": 0,
+ "products_updated": 53,
+ "failures": []
+}

docs/runs/local_completion/TESTESOFICIAIS_dryrun_summary.json

@@ -0,0 +1,248 @@
+{
+ "name": "TESTESOFICIAIS",
+ "total_products": 521,
+ "company": {
+  "uf": "BA",
+  "crt": "1",
+  "contribuinte_ipi": "N",
+  "company_code": "000001",
+  "company_key": "9b1d6541",
+  "pis_cofins_emission_items": 34946,
+  "pis_cofins_emission_nonblank": 3336,
+  "pis_cofins_unused_by_emission": false
+ },
+ "context_entries": 0,
+ "fields": {
+  "CLASSIFICACAO_FISCAL": {
+   "ALREADY_CORRECT": 495,
+   "MANUAL_INPUT_REQUIRED": 26
+  },
+  "IPI": {
+   "NOT_APPLICABLE": 317,
+   "MANUAL_INPUT_REQUIRED": 97,
+   "ALREADY_CORRECT": 107
+  },
+  "EX_TIPI": {
+   "NOT_APPLICABLE": 495,
+   "MANUAL_INPUT_REQUIRED": 26
+  },
+  "CEST": {
+   "NOT_APPLICABLE": 477,
+   "MANUAL_INPUT_REQUIRED": 40,
+   "ALREADY_CORRECT": 4
+  },
+  "SITUACAO_TRIBUTARIA": {
+   "ALREADY_CORRECT": 494,
+   "MANUAL_INPUT_REQUIRED": 27
+  },
+  "CFOP": {
+   "ALREADY_CORRECT": 492,
+   "MANUAL_INPUT_REQUIRED": 22,
+   "NOT_APPLICABLE": 7
+  },
+  "CFOP_ENTRADA": {
+   "MANUAL_INPUT_REQUIRED": 521
+  },
+  "CST": {
+   "NOT_APPLICABLE": 521
+  },
+  "CST_ENTRADA": {
+   "NOT_APPLICABLE": 521
+  },
+  "CSOSN": {
+   "ALREADY_CORRECT": 489,
+   "MANUAL_INPUT_REQUIRED": 32
+  },
+  "ALIQUOTA": {
+   "NOT_APPLICABLE": 493,
+   "ALREADY_CORRECT": 28
+  },
+  "COD_ORIGEM_MERCADORIA": {
+   "MANUAL_INPUT_REQUIRED": 520,
+   "ALREADY_CORRECT": 1
+  },
+  "CST_IPI": {
+   "NOT_APPLICABLE": 521
+  },
+  "COD_ENTRADA_PIS": {
+   "MANUAL_INPUT_REQUIRED": 520,
+   "ALREADY_CORRECT": 1
+  },
+  "COD_SAIDA_PIS": {
+   "MANUAL_INPUT_REQUIRED": 519,
+   "ALREADY_CORRECT": 2
+  },
+  "ALIQ_PIS": {
+   "MANUAL_INPUT_REQUIRED": 519,
+   "ALREADY_CORRECT": 2
+  },
+  "COD_ENTRADA_COFINS": {
+   "MANUAL_INPUT_REQUIRED": 520,
+   "ALREADY_CORRECT": 1
+  },
+  "COD_SAIDA_COFINS": {
+   "MANUAL_INPUT_REQUIRED": 519,
+   "ALREADY_CORRECT": 2
+  },
+  "ALIQ_COFINS": {
+   "MANUAL_INPUT_REQUIRED": 519,
+   "ALREADY_CORRECT": 2
+  },
+  "INCIDENCIA_PISCOFINS": {
+   "ALREADY_CORRECT": 521
+  },
+  "PISCOFINS": {
+   "ALREADY_CORRECT": 521
+  },
+  "IAT": {
+   "ALREADY_CORRECT": 521
+  },
+  "IPPT": {
+   "ALREADY_CORRECT": 514,
+   "NOT_APPLICABLE": 7
+  }
+ },
+ "reasons": {
+  "CLASSIFICACAO_FISCAL": {
+   "ALREADY_CORRECT|NCM_VALID_IN_DATASET": 495,
+   "MANUAL_INPUT_REQUIRED|NCM_INVALID": 23,
+   "MANUAL_INPUT_REQUIRED|NCM_LEGACY_NO_UNAMBIGUOUS_SUCCESSOR": 3
+  },
+  "IPI": {
+   "NOT_APPLICABLE|TIPI_RATE_BLANK_NEVER_ZERO": 297,
+   "ALREADY_CORRECT|TIPI_NUMERIC_RATE": 107,
+   "MANUAL_INPUT_REQUIRED|SEVERAL_TIPI_ROWS_FOR_NCM": 71,
+   "MANUAL_INPUT_REQUIRED|BLOCKED_BY_NCM": 26,
+   "NOT_APPLICABLE|TIPI_NT_OR_NON_NUMERIC_NEVER_WRITTEN_TO_NUMERIC_FIELD": 20
+  },
+  "EX_TIPI": {
+   "NOT_APPLICABLE|NO_EX_ROW_FOR_NCM": 424,
+   "NOT_APPLICABLE|DESCRIPTION_EVIDENCES_NO_EX_BASE_RATE_APPLIES": 71,
+   "MANUAL_INPUT_REQUIRED|BLOCKED_BY_NCM": 26
+  },
+  "CEST": {
+   "NOT_APPLICABLE|DESCRIPTION_MATCHES_NO_OFFICIAL_CEST_ITEM": 444,
+   "NOT_APPLICABLE|NCM_NOT_IN_CEST_LIST": 33,
+   "MANUAL_INPUT_REQUIRED|BLOCKED_BY_NCM": 26,
+   "MANUAL_INPUT_REQUIRED|SEVERAL_OFFICIAL_CEST_FOR_NCM": 13,
+   "ALREADY_CORRECT|ERP_CEST_IS_OFFICIAL_FOR_NCM": 4,
+   "MANUAL_INPUT_REQUIRED|ERP_CEST_NOT_OFFICIAL_FOR_NCM": 1
+  },
+  "SITUACAO_TRIBUTARIA": {
+   "ALREADY_CORRECT|DECLARED_VALID_NOT_CONTRADICTED": 494,
+   "MANUAL_INPUT_REQUIRED|BLOCKED_BY_NCM": 26,
+   "MANUAL_INPUT_REQUIRED|BLANK_OR_INVALID": 1
+  },
+  "CFOP": {
+   "ALREADY_CORRECT|DECLARED_VALID_NOT_CONTRADICTED": 472,
+   "ALREADY_CORRECT|RULE_PROVEN_EQUALS_DECLARED": 20,
+   "MANUAL_INPUT_REQUIRED|BLOCKED_BY_NCM": 20,
+   "NOT_APPLICABLE|INPUT_IS_NOT_A_SALE_ITEM": 7,
+   "MANUAL_INPUT_REQUIRED|CFOP_NEEDS_ST_STATUS": 2
+  },
+  "CFOP_ENTRADA": {
+   "MANUAL_INPUT_REQUIRED|CFOP_ENTRADA_NEEDS_PRODUCT_ROLE": 253,
+   "MANUAL_INPUT_REQUIRED|CFOP_ENTRADA_NEEDS_ENTRY_SCOPE": 242,
+   "MANUAL_INPUT_REQUIRED|BLOCKED_BY_NCM": 26
+  },
+  "CST": {
+   "NOT_APPLICABLE|CRT1_SIMPLES_EMISSION_USES_CSOSN": 521
+  },
+  "CST_ENTRADA": {
+   "NOT_APPLICABLE|CRT1_SIMPLES_EMISSION_USES_CSOSN": 521
+  },
+  "CSOSN": {
+   "ALREADY_CORRECT|DECLARED_VALID_NOT_CONTRADICTED": 489,
+   "MANUAL_INPUT_REQUIRED|BLOCKED_BY_NCM": 26,
+   "MANUAL_INPUT_REQUIRED|CSOSN_NEEDS_ICMS_TREATMENT": 6
+  },
+  "ALIQUOTA": {
+   "NOT_APPLICABLE|SIMPLES_CSOSN_HIGHLIGHTS_NO_ICMS_RATE": 493,
+   "ALREADY_CORRECT|DECLARED_VALID_NOT_CONTRADICTED": 28
+  },
+  "COD_ORIGEM_MERCADORIA": {
+   "MANUAL_INPUT_REQUIRED|ORIGIN_NO_EVIDENCE": 520,
+   "ALREADY_CORRECT|DECLARED_VALID_NOT_CONTRADICTED": 1
+  },
+  "CST_IPI": {
+   "NOT_APPLICABLE|COMPANY_IS_NOT_AN_IPI_TAXPAYER_C000004.CONTRIBUINTE_IPI": 521
+  },
+  "COD_ENTRADA_PIS": {
+   "MANUAL_INPUT_REQUIRED|NO_OFFICIAL_RULE_SOURCE_IN_CORE_DATASETS": 519,
+   "ALREADY_CORRECT|DECLARED_VALID_NOT_CONTRADICTED": 1,
+   "MANUAL_INPUT_REQUIRED|DECLARED_CST_NOT_IN_OFFICIAL_TABLE": 1
+  },
+  "COD_SAIDA_PIS": {
+   "MANUAL_INPUT_REQUIRED|NO_OFFICIAL_RULE_SOURCE_IN_CORE_DATASETS": 518,
+   "ALREADY_CORRECT|DECLARED_VALID_NOT_CONTRADICTED": 2,
+   "MANUAL_INPUT_REQUIRED|DECLARED_CST_NOT_IN_OFFICIAL_TABLE": 1
+  },
+  "ALIQ_PIS": {
+   "MANUAL_INPUT_REQUIRED|NO_OFFICIAL_RULE_SOURCE_IN_CORE_DATASETS": 519,
+   "ALREADY_CORRECT|DECLARED_VALID_NOT_CONTRADICTED": 2
+  },
+  "COD_ENTRADA_COFINS": {
+   "MANUAL_INPUT_REQUIRED|NO_OFFICIAL_RULE_SOURCE_IN_CORE_DATASETS": 519,
+   "ALREADY_CORRECT|DECLARED_VALID_NOT_CONTRADICTED": 1,
+   "MANUAL_INPUT_REQUIRED|DECLARED_CST_NOT_IN_OFFICIAL_TABLE": 1
+  },
+  "COD_SAIDA_COFINS": {
+   "MANUAL_INPUT_REQUIRED|NO_OFFICIAL_RULE_SOURCE_IN_CORE_DATASETS": 518,
+   "ALREADY_CORRECT|DECLARED_VALID_NOT_CONTRADICTED": 2,
+   "MANUAL_INPUT_REQUIRED|DECLARED_CST_NOT_IN_OFFICIAL_TABLE": 1
+  },
+  "ALIQ_COFINS": {
+   "MANUAL_INPUT_REQUIRED|NO_OFFICIAL_RULE_SOURCE_IN_CORE_DATASETS": 519,
+   "ALREADY_CORRECT|DECLARED_VALID_NOT_CONTRADICTED": 2
+  },
+  "INCIDENCIA_PISCOFINS": {
+   "ALREADY_CORRECT|DECLARED_VALID_NOT_CONTRADICTED": 521
+  },
+  "PISCOFINS": {
+   "ALREADY_CORRECT|DECLARED_VALID_NOT_CONTRADICTED": 521
+  },
+  "IAT": {
+   "ALREADY_CORRECT|DECLARED_VALID_NOT_CONTRADICTED": 521
+  },
+  "IPPT": {
+   "ALREADY_CORRECT|DECLARED_VALID_NOT_CONTRADICTED": 264,
+   "ALREADY_CORRECT|DERIVED_FROM_PRODUCT_ROLE:C000025.TIPO=VENDA,STOCK_ENTRIES(C000100.ENTRADAS>0)": 229,
+   "ALREADY_CORRECT|DERIVED_FROM_PRODUCT_ROLE:C000025.TIPO=VENDA,PURCHASE_DOCUMENT": 13,
+   "ALREADY_CORRECT|DERIVED_FROM_PRODUCT_ROLE:C000032.TIPO=COMPOSICAO": 7,
+   "NOT_APPLICABLE|INPUT_OR_SERVICE_HAS_NO_PRODUCTION_INDICATOR": 7,
+   "ALREADY_CORRECT|DERIVED_FROM_PRODUCT_ROLE:PROD_COZINHA=1,RECEITA_INGREDIENTES": 1
+  }
+ },
+ "manual_inputs": {
+  "COD_ORIGEM_MERCADORIA|origin": 520,
+  "COD_ENTRADA_PIS|pis_cofins_profile": 520,
+  "COD_ENTRADA_COFINS|pis_cofins_profile": 520,
+  "COD_SAIDA_PIS|pis_cofins_profile": 519,
+  "ALIQ_PIS|pis_cofins_profile": 519,
+  "COD_SAIDA_COFINS|pis_cofins_profile": 519,
+  "ALIQ_COFINS|pis_cofins_profile": 519,
+  "CFOP_ENTRADA|product_role": 253,
+  "CFOP_ENTRADA|entry_scope": 242,
+  "IPI|ex_tipi": 71,
+  "CLASSIFICACAO_FISCAL|ncm": 26,
+  "IPI|ncm": 26,
+  "EX_TIPI|ncm": 26,
+  "CEST|ncm": 26,
+  "SITUACAO_TRIBUTARIA|ncm": 26,
+  "CFOP_ENTRADA|ncm": 26,
+  "CSOSN|ncm": 26,
+  "CFOP|ncm": 20,
+  "CEST|cest": 14,
+  "CSOSN|icms_treatment": 6,
+  "CFOP|st_status": 2,
+  "SITUACAO_TRIBUTARIA|icms_treatment": 1
+ },
+ "roles": {
+  "UNKNOWN": 264,
+  "RESALE": 242,
+  "OWN_PRODUCTION": 8,
+  "INPUT": 7
+ },
+ "change_required_cells": 0,
+ "write_eligible_cells": 0
+}

docs/runs/local_completion/TESTESOFICIAIS_second_pass.json

@@ -0,0 +1,95 @@
+{
+ "name": "TESTESOFICIAIS",
+ "SECOND_PASS_CHANGE_REQUIRED": 0,
+ "SECOND_PASS_WRITES": 0,
+ "fields": {
+  "CLASSIFICACAO_FISCAL": {
+   "ALREADY_CORRECT": 495,
+   "MANUAL_INPUT_REQUIRED": 26
+  },
+  "IPI": {
+   "NOT_APPLICABLE": 317,
+   "MANUAL_INPUT_REQUIRED": 97,
+   "ALREADY_CORRECT": 107
+  },
+  "EX_TIPI": {
+   "NOT_APPLICABLE": 495,
+   "MANUAL_INPUT_REQUIRED": 26
+  },
+  "CEST": {
+   "NOT_APPLICABLE": 477,
+   "MANUAL_INPUT_REQUIRED": 40,
+   "ALREADY_CORRECT": 4
+  },
+  "SITUACAO_TRIBUTARIA": {
+   "ALREADY_CORRECT": 494,
+   "MANUAL_INPUT_REQUIRED": 27
+  },
+  "CFOP": {
+   "ALREADY_CORRECT": 492,
+   "MANUAL_INPUT_REQUIRED": 22,
+   "NOT_APPLICABLE": 7
+  },
+  "CFOP_ENTRADA": {
+   "MANUAL_INPUT_REQUIRED": 521
+  },
+  "CST": {
+   "NOT_APPLICABLE": 521
+  },
+  "CST_ENTRADA": {
+   "NOT_APPLICABLE": 521
+  },
+  "CSOSN": {
+   "ALREADY_CORRECT": 489,
+   "MANUAL_INPUT_REQUIRED": 32
+  },
+  "ALIQUOTA": {
+   "NOT_APPLICABLE": 493,
+   "ALREADY_CORRECT": 28
+  },
+  "COD_ORIGEM_MERCADORIA": {
+   "MANUAL_INPUT_REQUIRED": 520,
+   "ALREADY_CORRECT": 1
+  },
+  "CST_IPI": {
+   "NOT_APPLICABLE": 521
+  },
+  "COD_ENTRADA_PIS": {
+   "MANUAL_INPUT_REQUIRED": 520,
+   "ALREADY_CORRECT": 1
+  },
+  "COD_SAIDA_PIS": {
+   "MANUAL_INPUT_REQUIRED": 519,
+   "ALREADY_CORRECT": 2
+  },
+  "ALIQ_PIS": {
+   "MANUAL_INPUT_REQUIRED": 519,
+   "ALREADY_CORRECT": 2
+  },
+  "COD_ENTRADA_COFINS": {
+   "MANUAL_INPUT_REQUIRED": 520,
+   "ALREADY_CORRECT": 1
+  },
+  "COD_SAIDA_COFINS": {
+   "MANUAL_INPUT_REQUIRED": 519,
+   "ALREADY_CORRECT": 2
+  },
+  "ALIQ_COFINS": {
+   "MANUAL_INPUT_REQUIRED": 519,
+   "ALREADY_CORRECT": 2
+  },
+  "INCIDENCIA_PISCOFINS": {
+   "ALREADY_CORRECT": 521
+  },
+  "PISCOFINS": {
+   "ALREADY_CORRECT": 521
+  },
+  "IAT": {
+   "ALREADY_CORRECT": 521
+  },
+  "IPPT": {
+   "ALREADY_CORRECT": 514,
+   "NOT_APPLICABLE": 7
+  }
+ }
+}

docs/runs/local_completion/TESTESOFICIAIS_verify_summary.json

@@ -0,0 +1,10 @@
+{
+ "name": "TESTESOFICIAIS",
+ "products_after": 521,
+ "products_before": 521,
+ "planned_cells": 53,
+ "post_write_verified": 53,
+ "planned_mismatch": 0,
+ "unplanned_changes": 0,
+ "problems": []
+}

docs/runs/local_completion/UNIAO_apply_summary.json

@@ -0,0 +1,8 @@
+{
+ "name": "UNIAO",
+ "cells_attempted": 154,
+ "cells_succeeded": 154,
+ "cells_failed": 0,
+ "products_updated": 77,
+ "failures": []
+}

docs/runs/local_completion/UNIAO_dryrun_summary.json

@@ -0,0 +1,251 @@
+{
+ "name": "UNIAO",
+ "total_products": 8942,
+ "company": {
+  "uf": "BA",
+  "crt": "1",
+  "contribuinte_ipi": "N",
+  "company_code": "000001",
+  "company_key": "ded0967a",
+  "pis_cofins_emission_items": 121266,
+  "pis_cofins_emission_nonblank": 0,
+  "pis_cofins_unused_by_emission": true
+ },
+ "context_entries": 0,
+ "fields": {
+  "CLASSIFICACAO_FISCAL": {
+   "ALREADY_CORRECT": 8851,
+   "MANUAL_INPUT_REQUIRED": 91
+  },
+  "IPI": {
+   "MANUAL_INPUT_REQUIRED": 3074,
+   "NOT_APPLICABLE": 3399,
+   "ALREADY_CORRECT": 2469
+  },
+  "EX_TIPI": {
+   "NOT_APPLICABLE": 8851,
+   "MANUAL_INPUT_REQUIRED": 91
+  },
+  "CEST": {
+   "ALREADY_CORRECT": 6636,
+   "NOT_APPLICABLE": 1191,
+   "MANUAL_INPUT_REQUIRED": 1115
+  },
+  "SITUACAO_TRIBUTARIA": {
+   "ALREADY_CORRECT": 8526,
+   "MANUAL_INPUT_REQUIRED": 416
+  },
+  "CFOP": {
+   "ALREADY_CORRECT": 8831,
+   "MANUAL_INPUT_REQUIRED": 108,
+   "NOT_APPLICABLE": 3
+  },
+  "CFOP_ENTRADA": {
+   "ALREADY_CORRECT": 8658,
+   "MANUAL_INPUT_REQUIRED": 284
+  },
+  "CST": {
+   "NOT_APPLICABLE": 8942
+  },
+  "CST_ENTRADA": {
+   "NOT_APPLICABLE": 8942
+  },
+  "CSOSN": {
+   "ALREADY_CORRECT": 8848,
+   "MANUAL_INPUT_REQUIRED": 94
+  },
+  "ALIQUOTA": {
+   "NOT_APPLICABLE": 8883,
+   "ALREADY_CORRECT": 59
+  },
+  "COD_ORIGEM_MERCADORIA": {
+   "MANUAL_INPUT_REQUIRED": 8936,
+   "ALREADY_CORRECT": 6
+  },
+  "CST_IPI": {
+   "NOT_APPLICABLE": 8942
+  },
+  "COD_ENTRADA_PIS": {
+   "NOT_APPLICABLE": 8942
+  },
+  "COD_SAIDA_PIS": {
+   "NOT_APPLICABLE": 8169,
+   "CHANGE_REQUIRED": 77,
+   "ALREADY_CORRECT": 695,
+   "MANUAL_INPUT_REQUIRED": 1
+  },
+  "ALIQ_PIS": {
+   "NOT_APPLICABLE": 8942
+  },
+  "COD_ENTRADA_COFINS": {
+   "NOT_APPLICABLE": 8941,
+   "MANUAL_INPUT_REQUIRED": 1
+  },
+  "COD_SAIDA_COFINS": {
+   "NOT_APPLICABLE": 8169,
+   "CHANGE_REQUIRED": 77,
+   "ALREADY_CORRECT": 694,
+   "MANUAL_INPUT_REQUIRED": 2
+  },
+  "ALIQ_COFINS": {
+   "NOT_APPLICABLE": 8942
+  },
+  "INCIDENCIA_PISCOFINS": {
+   "ALREADY_CORRECT": 8942
+  },
+  "PISCOFINS": {
+   "ALREADY_CORRECT": 8942
+  },
+  "IAT": {
+   "ALREADY_CORRECT": 8942
+  },
+  "IPPT": {
+   "ALREADY_CORRECT": 8939,
+   "NOT_APPLICABLE": 3
+  }
+ },
+ "reasons": {
+  "CLASSIFICACAO_FISCAL": {
+   "ALREADY_CORRECT|NCM_VALID_IN_DATASET": 8851,
+   "MANUAL_INPUT_REQUIRED|NCM_INVALID": 88,
+   "MANUAL_INPUT_REQUIRED|NCM_LEGACY_NO_UNAMBIGUOUS_SUCCESSOR": 3
+  },
+  "IPI": {
+   "NOT_APPLICABLE|TIPI_RATE_BLANK_NEVER_ZERO": 3150,
+   "MANUAL_INPUT_REQUIRED|SEVERAL_TIPI_ROWS_FOR_NCM": 2983,
+   "ALREADY_CORRECT|TIPI_NUMERIC_RATE": 2469,
+   "NOT_APPLICABLE|TIPI_NT_OR_NON_NUMERIC_NEVER_WRITTEN_TO_NUMERIC_FIELD": 249,
+   "MANUAL_INPUT_REQUIRED|BLOCKED_BY_NCM": 91
+  },
+  "EX_TIPI": {
+   "NOT_APPLICABLE|NO_EX_ROW_FOR_NCM": 5868,
+   "NOT_APPLICABLE|DESCRIPTION_EVIDENCES_NO_EX_BASE_RATE_APPLIES": 2983,
+   "MANUAL_INPUT_REQUIRED|BLOCKED_BY_NCM": 91
+  },
+  "CEST": {
+   "ALREADY_CORRECT|ERP_CEST_IS_OFFICIAL_FOR_NCM": 6632,
+   "MANUAL_INPUT_REQUIRED|ERP_CEST_NOT_OFFICIAL_FOR_NCM": 830,
+   "NOT_APPLICABLE|DESCRIPTION_MATCHES_NO_OFFICIAL_CEST_ITEM": 804,
+   "NOT_APPLICABLE|NCM_NOT_IN_CEST_LIST": 387,
+   "MANUAL_INPUT_REQUIRED|ERP_CEST_BUT_NCM_NOT_IN_CEST_LIST": 185,
+   "MANUAL_INPUT_REQUIRED|BLOCKED_BY_NCM": 91,
+   "MANUAL_INPUT_REQUIRED|SEVERAL_OFFICIAL_CEST_FOR_NCM": 9,
+   "ALREADY_CORRECT|SINGLE_DEFENSIBLE_OFFICIAL_CEST": 4
+  },
+  "SITUACAO_TRIBUTARIA": {
+   "ALREADY_CORRECT|DECLARED_VALID_NOT_CONTRADICTED": 8526,
+   "MANUAL_INPUT_REQUIRED|ST_PROVEN_RETENTION_UNKNOWN": 297,
+   "MANUAL_INPUT_REQUIRED|BLOCKED_BY_NCM": 91,
+   "MANUAL_INPUT_REQUIRED|BLANK_OR_INVALID": 28
+  },
+  "CFOP": {
+   "ALREADY_CORRECT|DECLARED_VALID_NOT_CONTRADICTED": 8354,
+   "ALREADY_CORRECT|RULE_PROVEN_EQUALS_DECLARED": 477,
+   "MANUAL_INPUT_REQUIRED|BLOCKED_BY_NCM": 91,
+   "MANUAL_INPUT_REQUIRED|OFFICIAL_ST_TABLE_CONFLICTS_WITH_ERP_ST_DECLARATION": 16,
+   "NOT_APPLICABLE|INPUT_IS_NOT_A_SALE_ITEM": 3,
+   "MANUAL_INPUT_REQUIRED|CFOP_NEEDS_ST_STATUS": 1
+  },
+  "CFOP_ENTRADA": {
+   "ALREADY_CORRECT|DECLARED_VALID_NOT_CONTRADICTED": 8658,
+   "MANUAL_INPUT_REQUIRED|CFOP_ENTRADA_NEEDS_ENTRY_SCOPE": 192,
+   "MANUAL_INPUT_REQUIRED|BLOCKED_BY_NCM": 91,
+   "MANUAL_INPUT_REQUIRED|CFOP_ENTRADA_NEEDS_PRODUCT_ROLE": 1
+  },
+  "CST": {
+   "NOT_APPLICABLE|CRT1_SIMPLES_EMISSION_USES_CSOSN": 8942
+  },
+  "CST_ENTRADA": {
+   "NOT_APPLICABLE|CRT1_SIMPLES_EMISSION_USES_CSOSN": 8942
+  },
+  "CSOSN": {
+   "ALREADY_CORRECT|DECLARED_VALID_NOT_CONTRADICTED": 8848,
+   "MANUAL_INPUT_REQUIRED|BLOCKED_BY_NCM": 91,
+   "MANUAL_INPUT_REQUIRED|CSOSN_NEEDS_ICMS_TREATMENT": 3
+  },
+  "ALIQUOTA": {
+   "NOT_APPLICABLE|SIMPLES_CSOSN_HIGHLIGHTS_NO_ICMS_RATE": 8883,
+   "ALREADY_CORRECT|DECLARED_VALID_NOT_CONTRADICTED": 59
+  },
+  "COD_ORIGEM_MERCADORIA": {
+   "MANUAL_INPUT_REQUIRED|ORIGIN_NO_EVIDENCE": 8936,
+   "ALREADY_CORRECT|DECLARED_VALID_NOT_CONTRADICTED": 6
+  },
+  "CST_IPI": {
+   "NOT_APPLICABLE|COMPANY_IS_NOT_AN_IPI_TAXPAYER_C000004.CONTRIBUINTE_IPI": 8942
+  },
+  "COD_ENTRADA_PIS": {
+   "NOT_APPLICABLE|SGV_EMISSION_IGNORES_PIS_COFINS_PRODUCT_FIELDS_SIMPLES_NACIONAL": 8942
+  },
+  "COD_SAIDA_PIS": {
+   "NOT_APPLICABLE|SGV_EMISSION_IGNORES_PIS_COFINS_PRODUCT_FIELDS_SIMPLES_NACIONAL": 8169,
+   "ALREADY_CORRECT|DECLARED_VALID_NOT_CONTRADICTED": 695,
+   "CHANGE_REQUIRED|SPED_TABLE_4.3.11_ENTRY_960_NCM_22021000": 77,
+   "MANUAL_INPUT_REQUIRED|SPED_TABLES_CONFLICT_FOR_NCM": 1
+  },
+  "ALIQ_PIS": {
+   "NOT_APPLICABLE|SGV_EMISSION_IGNORES_PIS_COFINS_PRODUCT_FIELDS_SIMPLES_NACIONAL": 8181,
+   "NOT_APPLICABLE|RATE_NOT_INFORMED_FOR_CST_06": 487,
+   "NOT_APPLICABLE|RATE_NOT_INFORMED_FOR_CST_04": 274
+  },
+  "COD_ENTRADA_COFINS": {
+   "NOT_APPLICABLE|SGV_EMISSION_IGNORES_PIS_COFINS_PRODUCT_FIELDS_SIMPLES_NACIONAL": 8941,
+   "MANUAL_INPUT_REQUIRED|DECLARED_CST_NOT_IN_OFFICIAL_TABLE": 1
+  },
+  "COD_SAIDA_COFINS": {
+   "NOT_APPLICABLE|SGV_EMISSION_IGNORES_PIS_COFINS_PRODUCT_FIELDS_SIMPLES_NACIONAL": 8169,
+   "ALREADY_CORRECT|DECLARED_VALID_NOT_CONTRADICTED": 694,
+   "CHANGE_REQUIRED|SPED_TABLE_4.3.11_ENTRY_960_NCM_22021000": 77,
+   "MANUAL_INPUT_REQUIRED|DECLARED_CST_NOT_IN_OFFICIAL_TABLE": 1,
+   "MANUAL_INPUT_REQUIRED|SPED_TABLES_CONFLICT_FOR_NCM": 1
+  },
+  "ALIQ_COFINS": {
+   "NOT_APPLICABLE|SGV_EMISSION_IGNORES_PIS_COFINS_PRODUCT_FIELDS_SIMPLES_NACIONAL": 8181,
+   "NOT_APPLICABLE|RATE_NOT_INFORMED_FOR_CST_06": 487,
+   "NOT_APPLICABLE|RATE_NOT_INFORMED_FOR_CST_04": 274
+  },
+  "INCIDENCIA_PISCOFINS": {
+   "ALREADY_CORRECT|DECLARED_VALID_NOT_CONTRADICTED": 8942
+  },
+  "PISCOFINS": {
+   "ALREADY_CORRECT|DECLARED_VALID_NOT_CONTRADICTED": 8942
+  },
+  "IAT": {
+   "ALREADY_CORRECT|DECLARED_VALID_NOT_CONTRADICTED": 8942
+  },
+  "IPPT": {
+   "ALREADY_CORRECT|DERIVED_FROM_PRODUCT_ROLE:C000025.TIPO=VENDA,PURCHASE_DOCUMENT": 8919,
+   "ALREADY_CORRECT|DECLARED_VALID_NOT_CONTRADICTED": 20,
+   "NOT_APPLICABLE|INPUT_OR_SERVICE_HAS_NO_PRODUCTION_INDICATOR": 3
+  }
+ },
+ "manual_inputs": {
+  "COD_ORIGEM_MERCADORIA|origin": 8936,
+  "IPI|ex_tipi": 2983,
+  "CEST|cest": 1024,
+  "SITUACAO_TRIBUTARIA|st_withheld": 297,
+  "CFOP_ENTRADA|entry_scope": 192,
+  "CLASSIFICACAO_FISCAL|ncm": 91,
+  "IPI|ncm": 91,
+  "EX_TIPI|ncm": 91,
+  "CEST|ncm": 91,
+  "SITUACAO_TRIBUTARIA|ncm": 91,
+  "CFOP|ncm": 91,
+  "CFOP_ENTRADA|ncm": 91,
+  "CSOSN|ncm": 91,
+  "SITUACAO_TRIBUTARIA|icms_treatment": 28,
+  "CFOP|st_status": 17,
+  "CSOSN|icms_treatment": 3,
+  "COD_SAIDA_COFINS|pis_cofins_profile": 2,
+  "CFOP_ENTRADA|product_role": 1,
+  "COD_ENTRADA_COFINS|pis_cofins_profile": 1,
+  "COD_SAIDA_PIS|pis_cofins_profile": 1
+ },
+ "roles": {
+  "RESALE": 8919,
+  "UNKNOWN": 20,
+  "INPUT": 3
+ },
+ "change_required_cells": 154,
+ "write_eligible_cells": 154
+}