外围系统调用 Oracle EBS 写入正式凭证/单据 · 接口分类清单适用版本Oracle E-Business Suite R12 / R12.2 | 集成原则优先走公共 API 或标准接口表 标准导入并发程序禁止直写基表⚠️ 关键约束EBS 数据分布在数千张相互依赖的表中且有校验、工作流触发器。直接 DML 基表会绕过所有逻辑几乎必然导致数据损坏、并发请求失败、客制化不受支持。Oracle 对绝大多数业务操作都提供了公共 PL/SQL API这是程序化数据操纵的唯一受支持方式。每次 API 调用前必须通过FND_GLOBAL.APPS_INITIALIZE初始化用户/职责/应用上下文涉及多 OU 时需再调用MO_GLOBAL.SET_POLICY_CONTEXT。一、外围系统调用 EBS 的 4 种主要方式调用方式机理与适用场景典型入口方式APL/SQL 公共 API(Public Wrapper API)在 APPS 模式下发布的官方 Package覆盖 EBS 99% 以上的业务单据创建/更新/过账/冲销。可在并发程序、自定义程序、Form 个性化中直接调用同库集成首选。AP_INVOICES_PKG、AP_VENDOR_PUB_PKG、OE_ORDER_PUB、HZ_CUST_ACCOUNT_V2PUB、GL_JOURNAL_IMPORT_PUB等命名规律通常为MODULE_ENTITY_PUB。方式B接口表 标准导入并发程序外围系统把数据写入 EBS 开放接口表*_INTERFACE / *_INT再由 EBS 标准并发程序校验并导入基表。适合批量、异构系统、定时场景是非侵入式 Open Interface 设计的核心。GL_INTERFACE→ Journal ImportAP_INVOICES_INTERFACE→ Payables Open Interface ImportOE_HEADERS_IFACE_ALL / OE_LINES_IFACE_ALL→ Order ImportPO_HEADERS_INTERFACE→ Import Standard Purchase OrdersAP_SUPPLIERS_INT→ Supplier Open Interface Import。方式CSOA GatewaySOAP / RESTOracle Integration Repository 中的 PL/SQL API、并发程序、请求集、接口表都可经 Integrated SOA Gateway 暴露成 SOAP WSDL财务模块在 R12.2 起可通过 ISG 部署为 REST 服务。适合跨网络、跨技术栈的外围异构系统。财务服务 API 集合Oracle General Ledger API、Accounts Payable API、Accounts Receivable API、Cash Management API、Fixed Assets API、Purchasing API、Expenses API、Projects API 等均提供 OpenAPI 描述并通过 ISG 暴露 REST 端点。方式D并发程序 / 请求集(Concurrent Program)把定制化的 PL/SQL 存储过程注册为并发程序由外围系统提交请求并轮询完成状态。常与方式 B 配合使用先写接口表再提交标准导入并发程序。客制化可执行文件 并发程序定义标准导入类并发程序Journal Import、Payables Open Interface Import、AutoInvoice Master、Order Import、Import Standard Purchase Orders、Supplier Open Interface Import等。补充通过 Microsoft BizTalk Adapter for Oracle EBS 等适配器可以把上述 PL/SQL API、接口表/视图、并发程序、请求集统一以 WCF / SOAP 形式暴露给 .NET 等外围客户端适配器底层使用 ODP.NET 与 EBS 通信。二、财务模块GL / AP / AR / FA / CM模块业务对象接口表 / API / 并发程序调用方式关键参数 / 说明目标基表GL会计凭证日记账GL_INTERFACEGL_JOURNAL_IMPORT_PUB.DO_JOURNAL_IMPORT/ Journal Import 并发程序BACp_source_name,p_group_id,p_set_of_books_idR12 后为 ledger_idGL_JE_BATCHES / GL_JE_HEADERS / GL_JE_LINESGL帐套 / 分类帐GL_SET_OF_BOOKS_PKG.CREATE_SOBAp_sob_name,p_chart_of_accounts_id通过 Application Developer 职责使用 FNDLOADGL_SETS_OF_BOOKSAP应付发票AP_INVOICES_INTERFACE / AP_INVOICE_LINES_INTERFACE Payables Open Interface ImportBC仅支持 STANDARD/CREDIT金额0 用 STANDARD0 用 CREDITPREPAYMENT/DEBIT/MIXED 需导入后再 UPDATE 正式表AP_INVOICES_ALL / AP_INVOICE_DISTRIBUTIONS_ALLAP付款 / 付款历史AP_RECONCILIATION_PKG.INSERT_PAYMENT_HISTORY等A结合付款并发程序与银行对账付款调度与历史表AR应收发票事务处理AR_INVOICE_API_PUB.CREATE_INVOICE/RA_INTERFACE_LINES_ALL AutoInvoiceABCp_trx_header_rec,p_trx_line_tbl接口表通过描述性弹性域 Line Transaction Flexfield 关联RA_CUSTOMER_TRX_ALL / RA_CUSTOMER_TRX_LINES_ALLAR收款AR_RECEIPT_API_PUB.CREATE_CASH/ Lockbox 接口AR_INTERIM_CASH_RECEIPTS_ALLABp_receipt_method_id,p_amount,p_receipt_date标准 Lockbox 需预先定义 Format收款与现金应用表AR客户主数据见第四节HZ_PARTY_V2PUB.*A—TCA 表族FA固定资产新增FA_MASS_ADDITIONS 资产导入并发程序B接口表FA_INV_INTERFACE / FA_PRODUCTION_INTERFACEFA_ADDITIONS_B / FA_BOOKSCM银行 / 现金头寸Cash Management APIISG 暴露COracle Cash Management API 集合银行与现金头寸表三、分销 / 供应链模块OM / INV / WSH / PO模块业务对象接口表 / API / 并发程序调用方式关键参数 / 说明目标基表OM销售订单头/行OE_HEADERS_IFACE_ALL / OE_LINES_IFACE_ALL / OE_ACTIONS_IFACE_ALL Order Import 并发程序或OE_ORDER_PUB.PROCESS_ORDERBAC必填org_id,order_source_id,orig_sys_document_ref,orig_sys_line_ref,ordered_date,order_type_id,sold_to_org_id,ship_to_org_id,invoice_to_org_id,price_list_id,transactional_curr_code,operation_code(INSERT/UPDATE/DELETE)行必填inventory_item_id,ordered_quantity,order_quantity_uomOE_ORDER_HEADERS_ALL / OE_ORDER_LINES_ALLOM→AR销售开票推送RA_INTERFACE_LINES_ALLOM 发运确认后触发BAutoInvoice 读取生成应收发票收入、税金、折扣全部存储于此AR 事务处理表WSH交货DeliveryWSH_DELIVERIES_PUB.DELIVERY_ACTIONp_action_code CONFIRMA发运确认后写入WSH_DELIVERY_DETAILS并联动MTL_MATERIAL_TRANSACTIONS生成 COGSWSH_DELIVERIES_ALL / WSH_DELIVERY_DETAILSINV库存事务出库/转移INV_REPLENISH_DETAIL_PUB.LINE_DETAILS_PUB等库存公共 APIA挑库、发运、库存冲减等x_transaction_temp_id等回参MTL_MATERIAL_TRANSACTIONSPO采购订单头/行/分配PO_HEADERS_INTERFACE / PO_LINES_INTERFACE / PO_DISTRIBUTIONS_INTERFACE Import Standard Purchase Orders 并发程序BC外围系统先把数据写入接口表再由并发程序导入参数含 Default Buyer、Approved Status、Batch Id 等PO_HEADERS_ALL / PO_LINES_ALL / PO_DISTRIBUTIONS_ALLPO采购申请PO_REQUISITIONS_INTERFACE_ALL / PO_REQ_DIST_INTERFACE_ALL 导入并发程序B—PO_REQUISITION_HEADERS_ALL / LINES_ALL / DISTRIBUTIONS_ALL四、供应商与主数据AP / PO / AR / INV模块主数据对象接口表 / API调用方式说明AP/PO供应商头VendorAP_VENDOR_PUB_PKG.CREATE_VENDOR / UPDATE_VENDOR / VALIDATE_VENDOR11.5.10 起可用AP_SUPPLIERS_INT Supplier Open Interface ImportABR12 中供应商建模为 TCA PartyAP_SUPPLIER_INT_REJECTIONS存放错误行AP/PO供应商地点SiteAP_VENDOR_PUB_PKG.CREATE_VENDOR_SITE / UPDATE_VENDOR_SITEAP_SUPPLIER_SITES_INT Supplier Sites Open Interface ImportAB导入目标PO_VENDOR_SITES_ALL / AP_SUPPLIER_SITES_ALLAP/PO供应商联系人AP_VENDOR_PUB_PKG.CREATE_VENDOR_CONTACT / UPDATE_VENDOR_CONTACTR12 起联系人不再通过接口表导入须走 API可注册为并发程序A11i 时代用AP_SUP_SITE_CONTACT_INTR12 已废弃该接口表路径AP/PO供应商 NoteAP_NOTES_PUB.CREATE_NOTEA—AR客户主数据Party / Account / Site / ProfileHZ_PARTY_V2PUB.*、HZ_CUST_ACCOUNT_V2PUB.CREATE_CUST_ACCOUNT等 TCA APIAC调用前必须FND_GLOBAL.APPS_INITIALIZE设置 user_id / resp_id / resp_appl_idAPI 返回x_return_status / x_msg_count / x_msg_dataAR客户导入批量RA_CUSTOMERS_INTERFACE_ALL / RA_CONTACT_PHONES_INT_ALL / RA_CUSTOMER_PROFILES_INT_ALLB—INV物料主数据ItemMTL_SYSTEM_ITEMS_INTERFACE / MTL_ITEM_REVISIONS_INTERFACE / MTL_ITEM_CATEGORIES_INTERFACE Import Items 并发程序B错误表MTL_INTERFACE_ERRORS目标MTL_SYSTEM_ITEMS_B / _TL五、外围系统集成落地的 6 条工程建议接口发现登录 EBS进入Integrated SOA Gateway → Integration Repository按模块筛选 Public API / Interface Table / Concurrent Program以官方元数据为准避免凭记忆拼包名。环境初始化任何 PL/SQL API 调用前都要FND_GLOBAL.APPS_INITIALIZE(user_id, resp_id, resp_appl_id)多 OU 场景再MO_GLOBAL.SET_POLICY_CONTEXT(S, org_id)。缺这一步会得到莫名其妙的 profile / org 错误。错误处理API 的x_return_status不等于FND_API.G_RET_STS_SUCCESS时用FND_MSG_PUB.GET循环取出x_msg_count条消息接口表方式有专属 reject 表如AP_SUPPLIER_INT_REJECTIONS、MTL_INTERFACE_ERRORS。批量场景选 B 而非 A大批量异构数据接入优先用接口表 标准导入并发程序可分批Batch Size 默认 1000、可重跑、有错误隔离实时单笔才考虑直接 API 或 REST。REST vs SOAP财务模块在 R12.2 通过 ISG 提供 REST 端点如/webservices/rest/gl/journals其余模块/老版本多用 SOAP WSDL。跨公网建议走 OIC 或 API 网关做协议转换与安全加固。禁止直写基表即便在同一个数据库中也不要直接 INSERT/UPDATE*_ALL基表这会绕过校验、工作流与并发依赖导致数据不一致且 Oracle 不支持。 使用说明本清单为速查分类具体 Package 过程名、参数签名、并发程序参数以你所在 EBS 版本的 Integration Repository 与对应模块 Open Interface / API Manual 为准如财务参考 115apug.pdf、制造参考 115mfgapi.pdf、OM 参考 115omapi.pdf。R12 与 11i 在供应商、客户等 TCA 模型上有差异迁移客制化时需特别注意
外围系统调用 Oracle EBS 写入正式凭证/单据 · 接口分类清单适用版本Oracle E-Business Suite R12 / R12.2 | 集成原则优先走公共 API 或标准接口表 标准导入并发程序禁止直写基表⚠️ 关键约束EBS 数据分布在数千张相互依赖的表中且有校验、工作流触发器。直接 DML 基表会绕过所有逻辑几乎必然导致数据损坏、并发请求失败、客制化不受支持。Oracle 对绝大多数业务操作都提供了公共 PL/SQL API这是程序化数据操纵的唯一受支持方式。每次 API 调用前必须通过FND_GLOBAL.APPS_INITIALIZE初始化用户/职责/应用上下文涉及多 OU 时需再调用MO_GLOBAL.SET_POLICY_CONTEXT。一、外围系统调用 EBS 的 4 种主要方式调用方式机理与适用场景典型入口方式APL/SQL 公共 API(Public Wrapper API)在 APPS 模式下发布的官方 Package覆盖 EBS 99% 以上的业务单据创建/更新/过账/冲销。可在并发程序、自定义程序、Form 个性化中直接调用同库集成首选。AP_INVOICES_PKG、AP_VENDOR_PUB_PKG、OE_ORDER_PUB、HZ_CUST_ACCOUNT_V2PUB、GL_JOURNAL_IMPORT_PUB等命名规律通常为MODULE_ENTITY_PUB。方式B接口表 标准导入并发程序外围系统把数据写入 EBS 开放接口表*_INTERFACE / *_INT再由 EBS 标准并发程序校验并导入基表。适合批量、异构系统、定时场景是非侵入式 Open Interface 设计的核心。GL_INTERFACE→ Journal ImportAP_INVOICES_INTERFACE→ Payables Open Interface ImportOE_HEADERS_IFACE_ALL / OE_LINES_IFACE_ALL→ Order ImportPO_HEADERS_INTERFACE→ Import Standard Purchase OrdersAP_SUPPLIERS_INT→ Supplier Open Interface Import。方式CSOA GatewaySOAP / RESTOracle Integration Repository 中的 PL/SQL API、并发程序、请求集、接口表都可经 Integrated SOA Gateway 暴露成 SOAP WSDL财务模块在 R12.2 起可通过 ISG 部署为 REST 服务。适合跨网络、跨技术栈的外围异构系统。财务服务 API 集合Oracle General Ledger API、Accounts Payable API、Accounts Receivable API、Cash Management API、Fixed Assets API、Purchasing API、Expenses API、Projects API 等均提供 OpenAPI 描述并通过 ISG 暴露 REST 端点。方式D并发程序 / 请求集(Concurrent Program)把定制化的 PL/SQL 存储过程注册为并发程序由外围系统提交请求并轮询完成状态。常与方式 B 配合使用先写接口表再提交标准导入并发程序。客制化可执行文件 并发程序定义标准导入类并发程序Journal Import、Payables Open Interface Import、AutoInvoice Master、Order Import、Import Standard Purchase Orders、Supplier Open Interface Import等。补充通过 Microsoft BizTalk Adapter for Oracle EBS 等适配器可以把上述 PL/SQL API、接口表/视图、并发程序、请求集统一以 WCF / SOAP 形式暴露给 .NET 等外围客户端适配器底层使用 ODP.NET 与 EBS 通信。二、财务模块GL / AP / AR / FA / CM模块业务对象接口表 / API / 并发程序调用方式关键参数 / 说明目标基表GL会计凭证日记账GL_INTERFACEGL_JOURNAL_IMPORT_PUB.DO_JOURNAL_IMPORT/ Journal Import 并发程序BACp_source_name,p_group_id,p_set_of_books_idR12 后为 ledger_idGL_JE_BATCHES / GL_JE_HEADERS / GL_JE_LINESGL帐套 / 分类帐GL_SET_OF_BOOKS_PKG.CREATE_SOBAp_sob_name,p_chart_of_accounts_id通过 Application Developer 职责使用 FNDLOADGL_SETS_OF_BOOKSAP应付发票AP_INVOICES_INTERFACE / AP_INVOICE_LINES_INTERFACE Payables Open Interface ImportBC仅支持 STANDARD/CREDIT金额0 用 STANDARD0 用 CREDITPREPAYMENT/DEBIT/MIXED 需导入后再 UPDATE 正式表AP_INVOICES_ALL / AP_INVOICE_DISTRIBUTIONS_ALLAP付款 / 付款历史AP_RECONCILIATION_PKG.INSERT_PAYMENT_HISTORY等A结合付款并发程序与银行对账付款调度与历史表AR应收发票事务处理AR_INVOICE_API_PUB.CREATE_INVOICE/RA_INTERFACE_LINES_ALL AutoInvoiceABCp_trx_header_rec,p_trx_line_tbl接口表通过描述性弹性域 Line Transaction Flexfield 关联RA_CUSTOMER_TRX_ALL / RA_CUSTOMER_TRX_LINES_ALLAR收款AR_RECEIPT_API_PUB.CREATE_CASH/ Lockbox 接口AR_INTERIM_CASH_RECEIPTS_ALLABp_receipt_method_id,p_amount,p_receipt_date标准 Lockbox 需预先定义 Format收款与现金应用表AR客户主数据见第四节HZ_PARTY_V2PUB.*A—TCA 表族FA固定资产新增FA_MASS_ADDITIONS 资产导入并发程序B接口表FA_INV_INTERFACE / FA_PRODUCTION_INTERFACEFA_ADDITIONS_B / FA_BOOKSCM银行 / 现金头寸Cash Management APIISG 暴露COracle Cash Management API 集合银行与现金头寸表三、分销 / 供应链模块OM / INV / WSH / PO模块业务对象接口表 / API / 并发程序调用方式关键参数 / 说明目标基表OM销售订单头/行OE_HEADERS_IFACE_ALL / OE_LINES_IFACE_ALL / OE_ACTIONS_IFACE_ALL Order Import 并发程序或OE_ORDER_PUB.PROCESS_ORDERBAC必填org_id,order_source_id,orig_sys_document_ref,orig_sys_line_ref,ordered_date,order_type_id,sold_to_org_id,ship_to_org_id,invoice_to_org_id,price_list_id,transactional_curr_code,operation_code(INSERT/UPDATE/DELETE)行必填inventory_item_id,ordered_quantity,order_quantity_uomOE_ORDER_HEADERS_ALL / OE_ORDER_LINES_ALLOM→AR销售开票推送RA_INTERFACE_LINES_ALLOM 发运确认后触发BAutoInvoice 读取生成应收发票收入、税金、折扣全部存储于此AR 事务处理表WSH交货DeliveryWSH_DELIVERIES_PUB.DELIVERY_ACTIONp_action_code CONFIRMA发运确认后写入WSH_DELIVERY_DETAILS并联动MTL_MATERIAL_TRANSACTIONS生成 COGSWSH_DELIVERIES_ALL / WSH_DELIVERY_DETAILSINV库存事务出库/转移INV_REPLENISH_DETAIL_PUB.LINE_DETAILS_PUB等库存公共 APIA挑库、发运、库存冲减等x_transaction_temp_id等回参MTL_MATERIAL_TRANSACTIONSPO采购订单头/行/分配PO_HEADERS_INTERFACE / PO_LINES_INTERFACE / PO_DISTRIBUTIONS_INTERFACE Import Standard Purchase Orders 并发程序BC外围系统先把数据写入接口表再由并发程序导入参数含 Default Buyer、Approved Status、Batch Id 等PO_HEADERS_ALL / PO_LINES_ALL / PO_DISTRIBUTIONS_ALLPO采购申请PO_REQUISITIONS_INTERFACE_ALL / PO_REQ_DIST_INTERFACE_ALL 导入并发程序B—PO_REQUISITION_HEADERS_ALL / LINES_ALL / DISTRIBUTIONS_ALL四、供应商与主数据AP / PO / AR / INV模块主数据对象接口表 / API调用方式说明AP/PO供应商头VendorAP_VENDOR_PUB_PKG.CREATE_VENDOR / UPDATE_VENDOR / VALIDATE_VENDOR11.5.10 起可用AP_SUPPLIERS_INT Supplier Open Interface ImportABR12 中供应商建模为 TCA PartyAP_SUPPLIER_INT_REJECTIONS存放错误行AP/PO供应商地点SiteAP_VENDOR_PUB_PKG.CREATE_VENDOR_SITE / UPDATE_VENDOR_SITEAP_SUPPLIER_SITES_INT Supplier Sites Open Interface ImportAB导入目标PO_VENDOR_SITES_ALL / AP_SUPPLIER_SITES_ALLAP/PO供应商联系人AP_VENDOR_PUB_PKG.CREATE_VENDOR_CONTACT / UPDATE_VENDOR_CONTACTR12 起联系人不再通过接口表导入须走 API可注册为并发程序A11i 时代用AP_SUP_SITE_CONTACT_INTR12 已废弃该接口表路径AP/PO供应商 NoteAP_NOTES_PUB.CREATE_NOTEA—AR客户主数据Party / Account / Site / ProfileHZ_PARTY_V2PUB.*、HZ_CUST_ACCOUNT_V2PUB.CREATE_CUST_ACCOUNT等 TCA APIAC调用前必须FND_GLOBAL.APPS_INITIALIZE设置 user_id / resp_id / resp_appl_idAPI 返回x_return_status / x_msg_count / x_msg_dataAR客户导入批量RA_CUSTOMERS_INTERFACE_ALL / RA_CONTACT_PHONES_INT_ALL / RA_CUSTOMER_PROFILES_INT_ALLB—INV物料主数据ItemMTL_SYSTEM_ITEMS_INTERFACE / MTL_ITEM_REVISIONS_INTERFACE / MTL_ITEM_CATEGORIES_INTERFACE Import Items 并发程序B错误表MTL_INTERFACE_ERRORS目标MTL_SYSTEM_ITEMS_B / _TL五、外围系统集成落地的 6 条工程建议接口发现登录 EBS进入Integrated SOA Gateway → Integration Repository按模块筛选 Public API / Interface Table / Concurrent Program以官方元数据为准避免凭记忆拼包名。环境初始化任何 PL/SQL API 调用前都要FND_GLOBAL.APPS_INITIALIZE(user_id, resp_id, resp_appl_id)多 OU 场景再MO_GLOBAL.SET_POLICY_CONTEXT(S, org_id)。缺这一步会得到莫名其妙的 profile / org 错误。错误处理API 的x_return_status不等于FND_API.G_RET_STS_SUCCESS时用FND_MSG_PUB.GET循环取出x_msg_count条消息接口表方式有专属 reject 表如AP_SUPPLIER_INT_REJECTIONS、MTL_INTERFACE_ERRORS。批量场景选 B 而非 A大批量异构数据接入优先用接口表 标准导入并发程序可分批Batch Size 默认 1000、可重跑、有错误隔离实时单笔才考虑直接 API 或 REST。REST vs SOAP财务模块在 R12.2 通过 ISG 提供 REST 端点如/webservices/rest/gl/journals其余模块/老版本多用 SOAP WSDL。跨公网建议走 OIC 或 API 网关做协议转换与安全加固。禁止直写基表即便在同一个数据库中也不要直接 INSERT/UPDATE*_ALL基表这会绕过校验、工作流与并发依赖导致数据不一致且 Oracle 不支持。 使用说明本清单为速查分类具体 Package 过程名、参数签名、并发程序参数以你所在 EBS 版本的 Integration Repository 与对应模块 Open Interface / API Manual 为准如财务参考 115apug.pdf、制造参考 115mfgapi.pdf、OM 参考 115omapi.pdf。R12 与 11i 在供应商、客户等 TCA 模型上有差异迁移客制化时需特别注意
