【新版】接口关单开票-回传字段说明

JSON 示例

{
  "id": "FRF100000123",
  "qyid": "ENT0001",
  "hgqydm": "3100960123",
  "nsrsbh": "91310000MA1F1234XX",
  "kplx": "0",
  "fpzl": "028",
  "fpdm": "",
  "fphm": "243170000001234567",
  "sdfphm": "243170000001234567",
  "fpkjlx": "6",
  "fpId": "FP100000456",
  "gfmc": "OCEAN TRADING CO., LTD",
  "gfsh": "",
  "xfmc": "上海某某进出口贸易有限公司",
  "xfsh": "91310000MA1F1234XX",
  "kprq": "2026-10-09 15:31:02",
  "kpsj": "2026-10-09",
  "ssyf": "2026-10",
  "hjje": 10000.00,
  "hjse": 0.00,
  "jshj": "10000.00",
  "hsjbz": "0",
  "fpzt": "01",
  "zfbz": "0",
  "qdbz": "N",
  "zyspmc": "衬衫",
  "zyspsmmc": "*外贸销售货物*",
  "slv": "0.00",
  "goodsLength": "1",
  "bz": "310120260001234567",
  "kpr": "王五",
  "skr": "",
  "fhr": "",
  "ckbgdh": "310120260001234567",
  "orderId": "10001,10002",
  "orderNo": "PO2026001,PO2026002",
  "erpId": "ERPGD001",
  "fullErpId": "ERPGD001,ERPGD002",
  "gdOrderDate": "2026-09-28",
  "lsh": "LOT20261009001",
  "pushState": "",
  "pushTime": "",
  "pushFailReason": "",
  "fpWjId": "FILE88002",
  "ofdFpWjId": "FILE88001",
  "xmlWjId": "",
  "yxtszt": "2",
  "creator": "admin",
  "createDate": "2026-10-09 15:31:05",
  "modifier": "",
  "updateDate": "2026-10-09 15:31:05",
  "goods": [
    {
      "id": "SPXX300000789",
      "fpid": "FRF100000123",
      "xh": 1,
      "mc": "衬衫",
      "smmc": "外贸销售货物",
      "ssflbm": "1040201050000000000",
      "spbh": "",
      "zxbh": "",
      "ggxh": "XL",
      "jldw": "件",
      "sl": 100,
      "dj": 50.00,
      "je": 5000.00,
      "se": 0.00,
      "slv": 0.00,
      "jshj": 5000.00,
      "hsjbz": "0",
      "fphxz": "0",
      "msbs": "0",
      "yhzcbs": "1",
      "slbs": "0",
      "zzstsgl": "",
      "cezskce": "",
      "wbcjzj": 700.00,
      "wbje": 700.00,
      "wbfob": 680.00,
      "ckxse": 5000.00,
      "hl": null,
      "hlrq": "",
      "wbhl": 7.1400,
      "myfob": null,
      "myhl": null,
      "fob": null,
      "wbyby": null,
      "rmbyf": null,
      "wbyf": null,
      "rmbbxf": null,
      "wbbxf": null,
      "rmbzf": null,
      "wbzf": null,
      "mtzldm": ""
    }
  ]
}

发票主信息字段

字段	中文名	说明（含枚举）
id	发票记录ID	主键，商品明细 goods.fpid 与之关联
qyid	企业ID
hgqydm	海关企业代码
nsrsbh	纳税人识别号
kplx	开票类型	0 蓝票（正数）、1 红票（负数）
fpzl	发票种类	004 专票、007 普票、026 电普、028 电专
fpdm	发票代码	数电票为空
fphm	发票号码
sdfphm	数电发票号码	20位
fpkjlx	发票开具类型	2 增值税普票、3 增值税专票、4 电子专票、5 数电普票、6 数电专票、7 数电纸质普票、8 数电纸质专票、51 电子普票
fpId	开票单ID	开票请求记录主键
gfmc	购方名称	外销多为境外企业名称
gfsh	购方税号	境外购方常为空
xfmc	销方名称
xfsh	销方税号
kprq	开票日期时间	yyyy-MM-dd HH:mm:ss
kpsj	开票日期	yyyy-MM-dd（仅日）
ssyf	所属月份	yyyy-MM
hjje	合计金额	不含税
hjse	合计税额
jshj	价税合计	字符串类型
hsjbz	含税价标志	0 全部不含税、1 全部含税、2 部分含税
fpzt	发票状态	01 正常、02 已作废、03 已红冲-全额、04 已红冲-部分、05 红冲中、06 作废中
zfbz	作废标志	0 未作废、1 已作废
qdbz	清单标志	Y 有清单、N 无清单
zyspmc	主要商品名称	取第一行明细名称
zyspsmmc	主要商品税目
slv	税率	各明细行税率去重逗号拼接；免税行显示"免税"、不征税行显示"不征税"
goodsLength	明细行数	字符串，无明细为 "0"
bz	备注	外销票通常含报关单号
kpr	开票人
skr	收款人
fhr	复核人
ckbgdh	出口报关单号	21位
orderId	订单ID	多个逗号分隔（关联关单，去重）
orderNo	订单号	多个逗号分隔（关联关单，去重）
erpId	关单记录ID	一票多关单时仅取其一，全量见 fullErpId
fullErpId	关单记录ID列表	逗号分隔
gdOrderDate	关单订单日期	多关单时任取一行
lsh	业务流水号	ERP 流水号
pushState	推送状态	EBS 回传推送状态，空串表示未推送
pushTime	推送时间	yyyy-MM-dd HH:mm:ss，未推送为空
pushFailReason	推送失败原因
fpWjId	PDF文件ID
ofdFpWjId	OFD文件ID
xmlWjId	XML文件ID	数电票可能为空
yxtszt	邮箱推送状态	0 不推送、1 已推送、2 未推送、3 推送失败
creator	创建人
createDate	创建时间
modifier	修改人
updateDate	修改时间
goods	商品明细	数组，见下表

商品明细（goods）字段

字段	中文名	说明（含枚举）
id	明细ID
fpid	所属发票ID	关联发票主信息 id
xh	序号	行序号
mc	货物名称
smmc	商品和服务名称	税收分类名称
ssflbm	税收分类编码	19位
spbh	商品编号	可能为空
zxbh	自行编号
ggxh	规格型号
jldw	计量单位
sl	数量
dj	单价	不含税单价
je	金额	不含税金额
se	税额
slv	税率	数值
jshj	价税合计
hsjbz	含税价标志	0 不含税、1 含税
fphxz	发票行性质	0 正常行、1 折扣行、2 被折扣行
msbs	免税标识	0 出口退税、1 免税、2 不征税、3 普通零税率、4 非零税率
yhzcbs	优惠政策标识	0 不使用、1 使用
slbs	税率标识	空非零税率、0 出口退税、1 免税、2 不征税、3 普通零税率
zzstsgl	增值税特殊管理	优惠说明，如"免税"、"不征税"
cezskce	差额征税扣除额
wbcjzj	外币成交总价
wbje	外币金额
wbfob	外币离岸价
ckxse	出口销售额	人民币
hl	汇率
hlrq	汇率取值日期
wbhl	外币汇率
myfob	美元离岸价
myhl	美元汇率
fob	FOB价
wbyby	外币运保佣
rmbyf	人民币运费
wbyf	外币运费
rmbbxf	人民币保险费
wbbxf	外币保险费
rmbzf	人民币杂费
wbzf	外币杂费
mtzldm	煤炭种类代码	非煤炭商品为空

【新版】接口关单开票-回传字段说明

JSON 示例#

发票主信息字段#

商品明细（goods）字段#

JSON 示例

发票主信息字段

商品明细（goods）字段