數(shù)據(jù)中心訂單處理請求API
標(biāo)簽(空格分隔): API文檔 數(shù)據(jù)中心 出票完成訂單
See my About page for details.
1.應(yīng)用場景
各公司業(yè)務(wù)系統(tǒng)出票完成的訂單調(diào)用該API放钦,由數(shù)據(jù)中心分析判斷是否需要在關(guān)聯(lián)公司創(chuàng)建訂單
2.接口調(diào)用請求說明:
http請求方式:POST<br />
請求URL:待定<br />
支持格式:JSON
3.調(diào)用示例:
<pre><code>
{ticket_order:
{"company_id": "LMBJ"
,"token": "2977727d3c2d047d7a58f186f4d57738"
,"category": "1"
,"status": "1"
,"client_order_id": "1001"
,"client_parent_order_id": "1000"
,"title": "北京香港20人團(tuán)"
,"type": "國際散客"
,"customer": "{"id": "8001","name": "任逍遙國際旅行社"}"
,"creator": "{"id": "101","name": "張三"}"
,"create_time": "2017-06-30 11:43:00"
,"issue_time": "2017-06-30 15:43:00"
,"supplier_id": "900"
,"supplier_name": "在路上北京"
,"supplier_type": "1"
,"gross_profit": "100"
,"passenger_number": "1"
,"capital_account_id": "601"
,"capital_account_name": "在路上北京BSP"
,"offer": "700"
,"payment_amount": "600"
,"return_amount": "0"
,"adjust_amount": "0"
,"supplier_order": "0"
,"adjust_price_remark": ""
,"desk_issue_time": "2017-06-30 15:43:00"
,"foreign_currency_json": {"amount": "0","Category": ""}
,"issue_receivable": "700"
,"issue_payable": "600"
,"sales": {“id": "103","name": "李雙雙"}
,"issuer": {“id": "105","name": "張雙雙"}}
pnr: [{
"code": "XT60TR"
"number_of_people": "1"
"type": "1"
"body": "....."
"big_code": "ET6305"
"passenger": [{
"name": "張晶晶"
"gender": "女"
"certificate_type": "身份證"
"certificate_number": "0102345645646546546"
"nationality": "中國"
"issuing_country": "中國"
"birthday": "1990-01-01"
"period_of_validity": "2020-02-15"
"ticket_numbers": "["999-1112265894"]"}]
"segment": "[{
"flight_number": "CA951"
,"space": "A"
,"departure_terminal": "北京"
,"arrival_terminal": "香港"
,"number_of_place": "1"
"departure_time": "2017-10-01 11:00"
"arrival_time": "2017-10-01 15:30"
,"departure_place_code": "PEK"
,"arrival_place_code": "HKG"}]
"price": "[{
"type": "1"
"pay_amount": "600"
,"tax": "50"
,"discount": "0"
,"rebates": "0"
,"return_money": "0"
,"after_rebates": "0"
,"after_return_money": "0"
,"number_of_people": "1"
,"ticket_price": "650"
,"issue_fare": "0"
,"after_issue_fare": "0"
,"pay_price": "550"
,"total_amount": "0"
,"agent_fee": "0"
,"adjust_fee": "0"
,"category": "1"
,"cost": "0"
,"handling_cost": "0"
,"zvalue": "0"}]
}]}
</code></pre>
4.入?yún)⒄f明
--
ticket_order參數(shù)說明
參數(shù) | 說明
------------------------| ---------------
company_id | 公司代碼:由平臺統(tǒng)一分配
token | 調(diào)用接口憑證:MD5(company_id + client_order_id + create_time + 密碼(統(tǒng)一分配))
category | 訂單分類:出票單,改期單,退票單,廢票單
status | 狀態(tài):1(已出票)當(dāng)前只推送已出票的訂單
client_order_id | 各業(yè)務(wù)系統(tǒng)唯一訂單號:
client_parent_order_id | 原始訂單號(改期/退票對應(yīng)的原單號)
title | 訂單團(tuán)號
type | 訂單分類:1國內(nèi)散客次绘,2國內(nèi)團(tuán)隊(duì)遇汞,3國際散客卵洗,4國際團(tuán)隊(duì),5境外電子散客心肪,6境外電子團(tuán)隊(duì)锭亏,7計(jì)劃外
customer | 客戶信息:各公司的業(yè)務(wù)系統(tǒng)的客戶id和客戶名稱
格式:{"id": "8001","name": "任逍遙國際旅行社"}
creator | 創(chuàng)建人的員工id和員工姓名
格式:{"id": "101","name": "張三"}
create_time | 創(chuàng)建時(shí)間 timestamp
issue_time | 出票時(shí)間 timestamp
supplier_id | 供應(yīng)商編號
supplier_name | 供應(yīng)商名稱
supplier_type | 供應(yīng)商分類:1臨時(shí)供應(yīng)商 2固定供應(yīng)商
gross_profit | 利潤
passenger_number | 乘客數(shù)量
capital_account_id | 支付方式編號
capital_account_name | 支付方式名稱
offer | 總應(yīng)收
payment_amount | 總應(yīng)付
return_amount | 總后返
adjust_amount | 調(diào)整金額
supplier_order | 供應(yīng)商交易單號(第三方采購時(shí))
adjust_price_remark | 票臺調(diào)價(jià)備注
desk_issue_time | 待出票時(shí)間 timestamp
foreign_currency_json | 外幣信息 示例:{"amount": "1000","Category": "港幣"}
issue_receivable | 實(shí)收金額
issue_payable | 實(shí)付金額
sales | 銷售的員工id和員工姓名
issuer | 出票人的員工id和員工姓名
pnr參數(shù)說明
參數(shù) | 說明
------------------------| ---------------
code | PNR小編碼
number_of_people | 人數(shù)
type | 分類:1應(yīng)付供應(yīng)商 2應(yīng)收客戶
body | PNR文本信息
big_code | PNR大編碼
passenger參數(shù)說明
參數(shù) | 說明
------------------------| ---------------
name | 乘客姓名
gender | 乘客性別
certificate_type | 證件類型:身份證/護(hù)照/....
certificate_number | 證件號
issuing_country | 證件發(fā)行國
period_of_validity | 證件有效期
nationality | 國籍
birthday | 出生年月日
ticket_numbers | 票號 示例:["999-1112265894","999-1112265895"]
segment參數(shù)說明
參數(shù) | 說明
------------------------| ---------------
flight_number | 航班號
space | 艙位
departure_place_code | 出發(fā)機(jī)場三字碼
arrival_place_code | 到達(dá)機(jī)場三字碼
departure_terminal | 出發(fā)航站樓
arrival_terminal | 到達(dá)航站樓
number_of_place | 座位數(shù)
departure_time | 出發(fā)時(shí)間
arrival_time | 到達(dá)時(shí)間
price
參數(shù) | 說明
------------------------| ---------------
type | 分類:1成人,2兒童硬鞍,3嬰兒
pay_amount | 總應(yīng)付
tax | 稅金
discount | 折扣金額
rebates | 返點(diǎn)
return_money | 返錢金額
after_rebates | 后返點(diǎn)
after_return_money | 后返錢
number_of_people | 人數(shù)
ticket_price | 票面價(jià)
issue_fare | 出票價(jià):為最終出票時(shí)付給航司的價(jià)格(票面價(jià)-優(yōu)惠價(jià))
after_issue_fare | 后返出票價(jià)
pay_price | 應(yīng)付單價(jià)
total_amount | 總價(jià)
agent_fee | 代理費(fèi)
adjust_fee | 調(diào)整價(jià)格
cost | 退票費(fèi)
handling_cost | 手續(xù)費(fèi)
zvalue | Z值
5.返回值
正確時(shí)的返回JSON數(shù)據(jù)包結(jié)果:
<code>{"errcode":0,"errmsg":"ok"}</code>
錯誤時(shí)的返回JSON數(shù)據(jù)包結(jié)果:
<code>{"errcode":1,"errmsg":"invalid supplier name"}</code>