2017-07-07

數據中心訂單處理請求API

標簽(空格分隔): API文檔 數據中心 出票完成訂單


See my About page for details.
1.應用場景


各公司業(yè)務系統(tǒng)出票完成的訂單調用該API,由數據中心分析判斷是否需要在關聯公司創(chuàng)建訂單

2.接口調用請求說明:

http請求方式:POST<br />
請求URL:待定<br />
支持格式:JSON

3.調用示例:

<pre><code>
{ticket_order:
{"company_id": "LMBJ"
,"token": "2977727d3c2d047d7a58f186f4d57738"
,"category": "1"
,"status": "1"
,"client_order_id": "1001"
,"client_parent_order_id": "1000"
,"title": "北京香港20人團"
,"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.入參說明
--

ticket_order參數說明
參數 | 說明
------------------------| ---------------
company_id | 公司代碼:由平臺統(tǒng)一分配
token | 調用接口憑證:MD5(company_id + client_order_id + create_time + 密碼(統(tǒng)一分配))
category | 訂單分類:出票單,改期單,退票單,廢票單
status | 狀態(tài):1(已出票)當前只推送已出票的訂單
client_order_id | 各業(yè)務系統(tǒng)唯一訂單號:
client_parent_order_id | 原始訂單號(改期/退票對應的原單號)
title | 訂單團號
type | 訂單分類:1國內散客,2國內團隊,3國際散客,4國際團隊,5境外電子散客,6境外電子團隊,7計劃外
customer | 客戶信息:各公司的業(yè)務系統(tǒng)的客戶id和客戶名稱
格式:{"id": "8001","name": "任逍遙國際旅行社"}
creator | 創(chuàng)建人的員工id和員工姓名
格式:{"id": "101","name": "張三"}
create_time | 創(chuàng)建時間 timestamp
issue_time | 出票時間 timestamp
supplier_id | 供應商編號
supplier_name | 供應商名稱
supplier_type | 供應商分類:1臨時供應商 2固定供應商
gross_profit | 利潤
passenger_number | 乘客數量
capital_account_id | 支付方式編號
capital_account_name | 支付方式名稱
offer | 總應收
payment_amount | 總應付
return_amount | 總后返
adjust_amount | 調整金額
supplier_order | 供應商交易單號(第三方采購時)
adjust_price_remark | 票臺調價備注
desk_issue_time | 待出票時間 timestamp
foreign_currency_json | 外幣信息 示例:{"amount": "1000","Category": "港幣"}
issue_receivable | 實收金額
issue_payable | 實付金額
sales | 銷售的員工id和員工姓名
issuer | 出票人的員工id和員工姓名

pnr參數說明
參數 | 說明
------------------------| ---------------
code | PNR小編碼
number_of_people | 人數
type | 分類:1應付供應商 2應收客戶
body | PNR文本信息
big_code | PNR大編碼

passenger參數說明
參數 | 說明
------------------------| ---------------
name | 乘客姓名
gender | 乘客性別
certificate_type | 證件類型:身份證/護照/....
certificate_number | 證件號
issuing_country | 證件發(fā)行國
period_of_validity | 證件有效期
nationality | 國籍
birthday | 出生年月日
ticket_numbers | 票號 示例:["999-1112265894","999-1112265895"]

segment參數說明
參數 | 說明
------------------------| ---------------
flight_number | 航班號
space | 艙位
departure_place_code | 出發(fā)機場三字碼
arrival_place_code | 到達機場三字碼
departure_terminal | 出發(fā)航站樓
arrival_terminal | 到達航站樓
number_of_place | 座位數
departure_time | 出發(fā)時間
arrival_time | 到達時間

price
參數 | 說明
------------------------| ---------------
type | 分類:1成人,2兒童,3嬰兒
pay_amount | 總應付
tax | 稅金
discount | 折扣金額
rebates | 返點
return_money | 返錢金額
after_rebates | 后返點
after_return_money | 后返錢
number_of_people | 人數
ticket_price | 票面價
issue_fare | 出票價:為最終出票時付給航司的價格(票面價-優(yōu)惠價)
after_issue_fare | 后返出票價
pay_price | 應付單價
total_amount | 總價
agent_fee | 代理費
adjust_fee | 調整價格
cost | 退票費
handling_cost | 手續(xù)費
zvalue | Z值

5.返回值

正確時的返回JSON數據包結果:
<code>{"errcode":0,"errmsg":"ok"}</code>
錯誤時的返回JSON數據包結果:
<code>{"errcode":1,"errmsg":"invalid supplier name"}</code>

最后編輯于
?著作權歸作者所有,轉載或內容合作請聯系作者
平臺聲明:文章內容(如有圖片或視頻亦包括在內)由作者上傳并發(fā)布,文章內容僅代表作者本人觀點,簡書系信息發(fā)布平臺,僅提供信息存儲服務。

推薦閱讀更多精彩內容

  • Spring Cloud為開發(fā)人員提供了快速構建分布式系統(tǒng)中一些常見模式的工具(例如配置管理,服務發(fā)現,斷路器,智...
    卡卡羅2017閱讀 134,991評論 19 139
  • CREATE TABLE IF NOT EXISTS ecs_order_info (order_id mediu...
    cookie口閱讀 15,769評論 0 16
  • 不道飄零成久別,卿似秋風,儂似蕭蕭葉,葉落寒階生暗泣,秋風一去無消息。 倘有悲秋寒蜨蝶,飛到天涯,...
    WDS_BEN閱讀 258評論 0 0
  • 那年夏天,我懷揣著媽媽給的300元,還有大表哥給的50元“創(chuàng)業(yè)基金”,搭乘小表哥裝貨的大卡車,輾轉來到岳陽...
    黎璃曉閱讀 263評論 0 0