gustavosantos/GTI_GERENCIADOR_FISCAL
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
d21a9d1140105e49dbd746ac6e818b20109cceb8
GTI_GERENCIADOR_FISCAL/fiscal/docs/ERP_FISCAL_FIELD_MAP_V1.json
T
gti d21a9d1140 Add 'fiscal/' from commit '102ba84500dbd9655a0471288c3e278652593ca9' 
git-subtree-dir: fiscal
git-subtree-mainline: d95165fc8f
git-subtree-split: 102ba84500
2026-09-29 14:43:23 -03:00

537 lines
14 KiB
JSON
Raw Blame History

{
"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 View Git Blame Copy Permalink