华为MetaERP # Oracle EBS R12 eBTax API 税务数据导入完整方案## 核心前置认知eBTax **没有独立的标准 Open Interface 开放表（不像 AP

Oracle EBS R12 eBTax API 税务数据导入完整方案核心前置认知eBTax没有独立的标准 Open Interface 开放表不像 AP_INVOICES_INTERFACE。 官方支持两条导入路径标准路径推荐直接调用ZX_API_PUB.Calculate_Tax Save_Tax适用外部单据导入、迁移、客制系统同步复用系统原生计税规则自动匹配税制、税率、管辖权。不推荐路径ZX 接口表导入ZX_TRANSACTIONS_INTERFACE该接口表在 R12.1/R12.2 存在但 Oracle 文档标注仅内部迁移工具使用外部开发极少采用坑极多。导入分两类业务诉求务必区分 ✅ 诉求 A外部传入业务交易信息由 eBTax 引擎自动计税标准集成首选 ZX_API_PUB ✅ 诉求 B历史存量迁移已经算好税额强制写入指定税行不走规则引擎历史迁移场景风险极高一、方案一API 导入Calculate_Tax Save_Tax【标准推荐】适用场景外部系统推送采购 / 销售单据携带交易日期、参与方、地点、行金额、产品税分类由 eBTax 内部 Tax Rule 自动计算税额保证和前台手工录入计税逻辑完全一致。整体流程外部源数据 → 程序组装 TRX_HDR_REC / TRX_LINES_TBL → ZX_API_PUB.Calculate_Tax引擎自动计税 → ZX_API_PUB.Save_Tax持久化ZX_TRANSACTIONS、ZX_LINES → 更新业务单据 TAX_CONTROL_ID完整导入模板可改造为并发程序批量导入DECLARE -- eBTax API标准结构 p_trx_hdr_rec ZX_API_PUB.TRX_HDR_REC_TYPE; p_trx_lines_tbl ZX_API_PUB.TRX_LINES_TBL_TYPE; x_tax_lines_tbl ZX_API_PUB.TAX_LINES_TBL_TYPE; x_return_status VARCHAR2(1); x_msg_count NUMBER; x_msg_data VARCHAR2(4000); -- 业务变量从外部接口表/临时表读取 l_invoice_id NUMBER : 200001; -- AP发票主键 l_invoice_num VARCHAR2(150) : IMP-00001; l_supplier_party_id NUMBER : 100123; l_org_party_id NUMBER : 100001; BEGIN -- 1.清空结构 p_trx_lines_tbl.DELETE; -- 2.填充税务交易头 p_trx_hdr_rec.EVENT_CLASS_CODE : AP_INVOICE; p_trx_hdr_rec.APPLICATION_ID : 200; p_trx_hdr_rec.ENTITY_CODE : AP_INVOICES; p_trx_hdr_rec.TRX_ID : l_invoice_id; p_trx_hdr_rec.TRX_NUMBER : l_invoice_num; p_trx_hdr_rec.TRANSACTION_DATE : TO_DATE(2026-08-01,YYYY-MM-DD); p_trx_hdr_rec.DOCUMENT_DATE : TO_DATE(2026-08-01,YYYY-MM-DD); p_trx_hdr_rec.CURRENCY_CODE : CNY; p_trx_hdr_rec.PARTY_TYPE_CODE : SUPPLIER; p_trx_hdr_rec.PARTY_ID : l_supplier_party_id; p_trx_hdr_rec.BILL_TO_PARTY_ID : l_org_party_id; -- 关键地点供给地点判定依赖 p_trx_hdr_rec.SHIP_FROM_LOCATION_ID : NULL; p_trx_hdr_rec.SHIP_TO_LOCATION_ID : NULL; -- 3.填充交易行多条行可以循环追加 p_trx_lines_tbl(1).TRX_LINE_ID : 300001; -- AP_INVOICE_LINE_ID p_trx_lines_tbl(1).LINE_AMOUNT : 50000; p_trx_lines_tbl(1).PRODUCT_TAX_CLS_CODE : CN_VAT_13; p_trx_lines_tbl(1).QUANTITY : 1; -- 4.调用引擎自动计税 ZX_API_PUB.Calculate_Tax( p_trx_hdr_rec p_trx_hdr_rec, p_trx_lines_tbl p_trx_lines_tbl, x_tax_lines_tbl x_tax_lines_tbl, x_return_status x_return_status, x_msg_count x_msg_count, x_msg_data x_msg_data ); IF x_return_status S THEN DBMS_OUTPUT.PUT_LINE(计税失败:||x_msg_data); RETURN; END IF; -- 5.持久化税务数据 ZX_API_PUB.Save_Tax( p_trx_hdr_rec p_trx_hdr_rec, p_trx_lines_tbl p_trx_lines_tbl, p_tax_lines_tbl x_tax_lines_tbl, x_return_status x_return_status, x_msg_count x_msg_count, x_msg_data x_msg_data ); IF x_return_status S THEN DBMS_OUTPUT.PUT_LINE(导入成功ZX TRANSACTION_ID ||p_trx_hdr_rec.TRANSACTION_ID); -- 【必须】回填业务单据TAX_CONTROL_ID建立关联 UPDATE AP_INVOICES_ALL SET TAX_CONTROL_ID p_trx_hdr_rec.TRANSACTION_ID WHERE INVOICE_ID l_invoice_id; COMMIT; ELSE DBMS_OUTPUT.PUT_LINE(保存税数据失败:||x_msg_data); ROLLBACK; END IF; EXCEPTION WHEN OTHERS THEN DBMS_OUTPUT.PUT_LINE(异常:||SQLERRM); ROLLBACK; END; /批量导入架构建议创建临时中转表存储外部待导入单据头、行并发程序循环读取临时表每行单据执行上面逻辑增加状态字段NEW/SUCCESS/ERROR失败信息落地增加异常重跑机制建议单据维度 COMMIT避免大批量锁表。优点完全复用 eBTax 规则引擎计税结果和前台 100% 一致自动生成正确税行、可抵扣金额、管辖权信息支持后续 Reverse_Tax 修改、红冲Oracle 官方支持升级 R12.2 版本兼容性最好。缺点外部系统不能强制指定税额税额由规则自动算出 适合实时集成不适合历史迁移历史税额与系统规则计算结果不一致场景。二、方案二历史存量迁移场景已有税额强制导入税行重要警告ZX_API_PUB.Calculate_Tax不支持人工强制传入自定义税额。 Calculate_Tax 内部税额完全由规则引擎计算外部无法覆盖。两种备选方案处理历史迁移方式 AZX_TRANSACTIONS_INTERFACE 接口表Oracle 内部接口向ZX_TRANSACTIONS_INTERFACE、ZX_LINES_INTERFACE插入数据运行标准并发请求Import Transaction Tax Data并发程序读取接口表写入 ZX_TRANSACTIONS / ZX_LINES。重大风险一定要知悉该接口文档稀少Oracle 不对外主推需要手动填充大量判定因子、Jurisdiction_ID、Tax_Rate_ID不会自动校验 Tax Recovery 抵扣规则容易造成进项税数据错乱导入失败调试困难没有标准错误日志视图部分 R12.2 补丁版本接口表结构存在差异。方式 B受控直接插入极限兜底严格限制生产使用开发红线仅历史期初迁移日常业务导入禁止使用需要同时维护 ZX_TRANSACTIONS ZX_LINES ZX_TRX_LOCATIONS 同时手动更新业务单据 TAX_CONTROL_ID。 风险不会刷新 ZX_DETERMINATION_RESULTS 缓存税务审计、模拟器无法识别无法正常使用 Reverse_Tax 冲销升级补丁可能破坏数据一致性。最优建议历史迁移尽量在切换期初一次性导入切换完成后新业务全部走 ZX_API_PUB。三、导入高频报错与排查1. Calculate_Tax 返回空 x_tax_lines_tbl无税行EVENT_CLASS_CODE 编码错误缺失 SHIP_TO/BILL_TO 地点无法推导 Place of Supply交易日期超出税率有效区间Product Tax Classification 代码不匹配 调试手段eBTax 税务模拟器录入相同参数复现。2. Save_Tax 报错Transaction already exists同一业务 TRX_ID 已经存在有效的 ZX 税务交易 导入前先查询 TAX_CONTROL_ID存在则优先 Reverse_Tax不要重复 Save。3. 导入成功AP/AR 界面看不到税额忘记执行UPDATE AP_INVOICES_ALL SET TAX_CONTROL_ID TRANSACTION_ID4. 批量导入性能问题不要超大事务一次性提交关闭不必要的调试 DBMS_OUTPUT确认 ZX 系列表索引健康大批量导入可考虑临时清理 ZX_DETERMINATION_RESULTS 缓存测试环境。四、导入场景标准规范总结业务场景推荐方案禁止操作外部系统实时同步新单据ZX_API_PUB CalculateSave_Tax直接 Insert ZX 表历史期初存量迁移已有既定税额ZX_INTERFACE 接口表 / 一次性受控插入日常业务使用直插导入后需要支持修改、取消、红冲ZX_API_PUB 流程接口表直插方式抵扣逻辑容易异常