chore: establish project baseline
This commit is contained in:
OpenCode
@@ -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
|
||||
}
|
||||
]
|
||||
}
|
||||
Reference in New Issue
Block a user