Obtain Standard Scenic Information from Fliggy

taobao.alitrip.travel.baseinfo.scenics.get

The following important information will be returned after querying from Fliggy based on some key words.

• scenic code from Fliggy(scenicId)
• scenic name
• charging items for each scenic(spuId)
• ticket types for each charging item

They are needed when pushing ticket content to Fliggy.

Scenic Binding

alitrip.ticket.scenic.bind

The foreign key which here refers to scenic code and charging item code from vendor’s system is supported by Fliggy. Vendor can pass through the foreign key instead of Fliggy’s standard ones after binding scenic operation. The API can be ignored if vendor doesn’t need this function.

Charging Item Maintenance

The charging item maintenance interface is designed to maintain item parameters like inventory type and reservation limits. And it supports external merchant codes (out_product_id) as primary keys. If the external merchant codes(out_product_id) is uesd, it will be considered that the out_product_id and the ali_product_id are being associated. Before using the external merchant codes(out_product_id), the association of the scenic id of Alitrip and the scenic id of merchant is necessary.

• Such interface supports both new item release and quantity update. Some parameters for newly-released items are mandatory, but most parameters for item updates are optional. Please see parameter instructions. For one charging item, the merchant can only release one new Alitrip item. If there exists one Alitrip item associated with the charging item, it will be considered that item modification is involved. For the specified charging item, if the merchant doesn’t konw whether he has released one new Alitrip item or not, the interface “alitrip.ticket.scenic.query” or “alitrip.ticket.product.query” will be uesful.

• When a new Alitrip item is released, there exists some default settings: 1)If needed, the merchant is responsible for the freight. 2)If the title, pictures or descriptions are not specified, the released item will use the system default descriptions according to the scenic.

• If E-Logistics is used, please login the E-Logistics System to check the E-Logistics information.

Scenic rule maintenance

alitrip.ticket.rule.upload

This interface mainly used to maintain informations like refund rule, travel information, limits of purchases, how to enter scenic area, what is included in the cost and so on. Each rule must have an external ID (out_rule_id), out_rule_id will be used to maintain price and availability.

notice:

• Rules must be attached to a scenic, that means must be input one of ali_scenic_id and out_scenic_id
• This interface support publish and update rule at the same time. If you want publish a rule, some parameters are required, if you want update a rule, most parameters are optional. If you don’t know whether used the out_rule_id publish a rule, you can query it by use the interface ‘alitrip.ticket.rule.query’. If the result is true, update the rule, otherwise add a new rule.

Maintain price and availability

alitrip.ticket.skus.upload

• One ticket type can use one or more rules (the ID of each rule is different), and one rule can be used to diffent ticket type.
• Inventory of canlendar-based item and inventory of section-based item need using dateInventory structe unified. when you want publish a inventory of canlendar-based item, please upload the price and inventory of every single day. when you want publish a inventory of section-based item, we suggest only upload the price and inventory of bengin date and end date, but if you upload the price and inventory of every single day, the system will merge it automatically (take the price of first day as scetion price, plus the inventory of every single day as scetion inventory).
• This interface supprot add and update the price and inventory of a rule. If you don’t know whether used this rule upload price and inventory, you can query it by use the interface ‘alitrip.ticket.product.query’. If the result is true, update the sku price and inventory, otherwise add a new sku under this ticket type.
• Description of external merchant code (parameter like out_sku_id and out_sku_date_id): these codes will be written to order detail when the user place an order, and user can see these code through order detail.
• If this ticket is a season ticket, ticket type, ticket season, ticket area must be input as parameter while maintain price and availability

Launch/discontinue items

taobao.alitrip.travel.item.shelve
This interface used to launch/discontinue the items of ticket, but currently only supports launch/discontinue items immediately

FAQ