FpML全称是Financial products Markup Language，它是一种基于XML的标准化语言，专门用来描述金融衍生品交易信息，比如利率互换、远期、期权等。在监管报送和交易对手对账中，很多机构要求用FpML XML格式上传交易数据。我们只要把内部系统的交易对象序列化成符合FpML Schema的XML文件，就能完成数据交换。
FpML XML的基本结构
FpML文档通常以<FpML>为根节点，里面包含交易主体、产品定义和交易条款。下面是一段简化的利率互换FpML片段，展示了主要标签的写法。
<?xml version="1.0" encoding="UTF-8"?>
<FpML xmlns="http://www.fpml.org/FpML-5/confirmation" version="5.0">
<trade>
<tradeHeader>
<partyTradeIdentifier>
<partyReference href="partyA"/>
<tradeId>TRADE0001</tradeId>
</partyTradeIdentifier>
</tradeHeader>
<interestRateSwap>
<swapStream>
<fixedStream>
<currency>USD</currency>
<fixedRate>0.02</fixedRate>
</fixedStream>
</swapStream>
</interestRateSwap>
</trade>
<party id="partyA">
<partyId>BANK_A</partyId>
</party>
</FpML>
如何处理交易数据上传
处理金融衍生品交易数据上传一般分为四个步骤：数据抽取、格式转换、校验和传输。下面用Python示例说明如何把内部字典转成FpML并做基础校验。
1. 数据抽取与转换
我们从数据库或接口拿到交易记录，整理成统一字典，再用模板或库生成XML。
import dicttoxml
from xml.dom.minidom import parseString
trade = {
'tradeHeader': {'tradeId': 'TRADE0001'},
'interestRateSwap': {'fixedRate': 0.02, 'currency': 'USD'}
}
xml_bytes = dicttoxml.dicttoxml(trade, custom_root='FpML', attr_type=False)
dom = parseString(xml_bytes)
print(dom.toprettyxml())
2. 校验与上传
上传前要用FpML官方XSD做 schema 校验，避免被接收方拒收。校验通过后，通过HTTPS接口提交文件。
import requests
def upload_fpml(xml_text, url):
headers = {'Content-Type': 'application/xml'}
resp = requests.post(url, data=xml_text.encode('utf-8'), headers=headers)
if resp.status_code == 200:
print('上传成功')
else:
print('上传失败', resp.status_code)
upload_fpml(dom.toprettyxml(), 'https://ipipp.com/api/fpml/upload')
常见问题与建议
- 字段缺失：FpML要求不少必填项，生成时要对照Schema逐个检查。
- 命名空间错误：根节点要带正确xmlns，否则校验不通过。
- 编码问题：统一用UTF-8，防止中文或特殊字符乱码。
只要理清FpML XML的结构和上传链路，金融衍生品交易数据报送就能稳定跑起来。