{
 "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
  }
 ]
}