创建收支记录

记录一条新的收入或支出分录。分录关联到什么,由请求本身推断:

  • reservation_code,记到一张订单上;
  • property_id,记到某个房间上;
  • 两个都不传,记为房东账号级别的分录(不与任何房间或订单绑定;仅主账号可用)。

reservation_codeproperty_id 互斥。

关联订单的分录属于整张订单。多房订单(一个 reservation_code 下有多个 stay_code)会按各房间的房费收入比例摊到每一间,无法只挂在其中一间上,读回来时也一律显示订单自身的编号。要给每个房间记不同的金额——按房间核算的税费、业主分账、清洁费——请改用 property_id 一个房间记一条,代价是这样的分录不与订单关联。

stay_code 仍作为 reservation_code 的废弃别名接受:任何入住单号都会被归一到它所属的订单,不报错也不告警,因此并不会把分录记到那一个入住单上。

direction 字段决定这条分录是 income 还是 expense,进而决定 item_idGET /income_itemsGET /expense_items)和 payment_method_idGET /income_methodsGET /expense_methods)用哪本字典。amount 一律传正数,正负号由 direction 推导。currency 随金额一起传,除非传了订单——那种情况下它继承自订单;如果你仍然传了,它必须与订单的货币一致。

Body Params
integer

要把分录记到哪个房间的 ID。全额计入该房间。与 reservation_code 互斥。两个都不传则记为房东账号级别的分录。

string

要把分录记到哪张订单的 reservation_code(由 GET /reservations 返回)。分录属于整张订单;多房订单会按各房间的房费收入比例摊到每一间,无法只挂在其中一间上。与 property_id 互斥。两个都不传则记为房东账号级别的分录。

string
deprecated

reservation_code 的废弃别名,仅为向后兼容保留。入住单号会被归一到它所属的订单,因此分录记在整张订单上,读回来时显示的是订单号,而不是你提交的那个入住单号。要把金额记到某一个房间,请用 property_id

string
enum
required

此条目代表收到的钱 (income) 还是花费的钱 (expense)。

Allowed:
number
required

条目的绝对数量。始终提供正数;符号由 direction

string

amount 一起传的货币代码。除非传了 reservation_code(或已废弃的 stay_code),否则必填;关联订单的分录继承订单的货币,传入不一致的值会被拒绝。更多信息见 Supported Currencies

integer
required

商品分类的id。当 direction=income 时,必须是来自 GET /income_items 的有效 ID;当 direction=expense 时,必须是来自 GET /expense_items 的有效 ID。

integer
required

支付方式的id。当 direction=income 时,必须是来自 GET /income_methods 的有效 ID;当 direction=expense 时,必须是来自 GET /expense_methods 的有效 ID。

string

当行动发生时。接受 ISO 8601 (ZZPH0ZZ)。默认为当前时间。如果设置为未来时间,则会创建状态为 outstanding 的条目;否则为paid

string

自由格式注释(最多 500 个字符)。

Response

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json