POST api/v1/SelfCheckin/CreateInvoice

开发票

请求信息(Request)

URI 参数

None.

Body 参数

发票信息

SelfCheckinInvoiceDTO
名称描述类型备注
ID

integer

None.
HotelId

酒店ID

 integer

None.
HotelName

酒店名称

 string

None.
RoomNumber

房间号

 string

None.
RegOrderId

登记单ID

 integer

None.
PmsRegOrderId

pms登记单ID

 string

None.
InvoiceApiType

开发票接口类型

 integer

None.
GuestName

姓名

 string

None.
PhoneNumber

登记单电话

 string

None.
Buyername

购方名称

 string

None.
Taxnum

购方税号

 string

None.
Phone

购方手机(开票成功会短信提醒购方)

 string

None.
Address

购方地址

 string

None.
Account

购方银行账号

 string

None.
Telephone

购方电话

 string

None.
Clerk

开票员

 string

None.
Saletaxnum

销方税号

 string

None.
Kptype

开票类型:1,正票;2,红票

 integer

None.
Message

备注信息

 string

None.
Fpqqlsh

提交成功则返回发票请求流水号

 string

None.
C_status

开票状态

 SelfCheckinInvoiceStatus

None.
C_statusName

开票状态名称

 string

None.
C_msg

开票信息，成功或者失败的信息

 string

None.
CreateTime

创建时间

 date

None.
Fpdm

对应蓝票发票代码 红票必填，不满12 位请左补 0

 string

None.
Fphm

对应蓝票发票号码 红票必填，不满8 位请左补 0

 string

None.
Tsfs

推 送 方 式 :-1, 不 推送;0,邮箱;1,手机(默认);2,邮箱、手机

 string

None.
Email

推送邮箱（tsfs 为 0或 2 时，此项为必填）

 string

None.
BillInfoNo

红字信息表编号 专票冲红时，此项必填

 string

None.
Goodsname

商品名称

 string

None.
Num

数量；数量、单价必须都不填，或者都必填，不可只填一个；当数量、单价都不填时，不含税金额、税额、含税金额都必填。建议保留小数点后8位。

 integer

None.
Price

decimal number

None.
Hsbz

单价含税标志，0:不含税,1:含税

 string

None.
Taxrate

税率

 decimal number

None.
Spbm

税收分类编码

 string

None.
Taxfreeamt

不含税金额

 decimal number

None.
Tax

税额

 decimal number

None.
Taxamt

含税金额

 decimal number

None.

请求格式

application/json, text/json

Sample: 
{
  "ID": 1,
  "HotelId": 2,
  "HotelName": "sample string 3",
  "RoomNumber": "sample string 4",
  "RegOrderId": 5,
  "PmsRegOrderId": "sample string 6",
  "InvoiceApiType": 7,
  "GuestName": "sample string 8",
  "PhoneNumber": "sample string 9",
  "Buyername": "sample string 10",
  "Taxnum": "sample string 11",
  "Phone": "sample string 12",
  "Address": "sample string 13",
  "Account": "sample string 14",
  "Telephone": "sample string 15",
  "Clerk": "sample string 16",
  "Saletaxnum": "sample string 17",
  "Kptype": 18,
  "Message": "sample string 19",
  "Fpqqlsh": "sample string 20",
  "C_status": 0,
  "C_statusName": "sample string 21",
  "C_msg": "sample string 22",
  "CreateTime": "2025-11-06T04:08:02.2826874+08:00",
  "Fpdm": "sample string 24",
  "Fphm": "sample string 25",
  "Tsfs": "sample string 26",
  "Email": "sample string 27",
  "BillInfoNo": "sample string 28",
  "Goodsname": "sample string 29",
  "Num": 30,
  "Price": 31.0,
  "Hsbz": "sample string 32",
  "Taxrate": 33.0,
  "Spbm": "sample string 34",
  "Taxfreeamt": 35.0,
  "Tax": 36.0,
  "Taxamt": 37.0
}

application/xml, text/xml

Sample: 
<SelfCheckinInvoiceDTO xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/WLife.Application.DTOs">
  <Account>sample string 14</Account>
  <Address>sample string 13</Address>
  <BillInfoNo>sample string 28</BillInfoNo>
  <Buyername>sample string 10</Buyername>
  <C_msg>sample string 22</C_msg>
  <C_status>None</C_status>
  <C_statusName>sample string 21</C_statusName>
  <Clerk>sample string 16</Clerk>
  <CreateTime>2025-11-06T04:08:02.2826874+08:00</CreateTime>
  <Email>sample string 27</Email>
  <Fpdm>sample string 24</Fpdm>
  <Fphm>sample string 25</Fphm>
  <Fpqqlsh>sample string 20</Fpqqlsh>
  <Goodsname>sample string 29</Goodsname>
  <GuestName>sample string 8</GuestName>
  <HotelId>2</HotelId>
  <HotelName>sample string 3</HotelName>
  <Hsbz>sample string 32</Hsbz>
  <ID>1</ID>
  <InvoiceApiType>7</InvoiceApiType>
  <Kptype>18</Kptype>
  <Message>sample string 19</Message>
  <Num>30</Num>
  <Phone>sample string 12</Phone>
  <PhoneNumber>sample string 9</PhoneNumber>
  <PmsRegOrderId>sample string 6</PmsRegOrderId>
  <Price>31</Price>
  <RegOrderId>5</RegOrderId>
  <RoomNumber>sample string 4</RoomNumber>
  <Saletaxnum>sample string 17</Saletaxnum>
  <Spbm>sample string 34</Spbm>
  <Tax>36</Tax>
  <Taxamt>37</Taxamt>
  <Taxfreeamt>35</Taxfreeamt>
  <Taxnum>sample string 11</Taxnum>
  <Taxrate>33</Taxrate>
  <Telephone>sample string 15</Telephone>
  <Tsfs>sample string 26</Tsfs>
</SelfCheckinInvoiceDTO>

application/x-www-form-urlencoded

Sample:

Failed to generate the sample for media type 'application/x-www-form-urlencoded'. Cannot use formatter 'JQueryMvcFormUrlEncodedFormatter' to write type 'SelfCheckinInvoiceDTO'.

响应信息(Response)

资源描述

RequestResultOfSelfCheckinInvoiceDTO
名称描述类型备注
Data

SelfCheckinInvoiceDTO

None.
Status

状态(0：成功，1：失败)

 integer

None.
Message

导致失败的相关消息

 string

None.
Total

集合总数，用于分页时使用

 integer

None.

响应格式

application/json, text/json

Sample: 
{
  "Data": {
    "ID": 1,
    "HotelId": 2,
    "HotelName": "sample string 3",
    "RoomNumber": "sample string 4",
    "RegOrderId": 5,
    "PmsRegOrderId": "sample string 6",
    "InvoiceApiType": 7,
    "GuestName": "sample string 8",
    "PhoneNumber": "sample string 9",
    "Buyername": "sample string 10",
    "Taxnum": "sample string 11",
    "Phone": "sample string 12",
    "Address": "sample string 13",
    "Account": "sample string 14",
    "Telephone": "sample string 15",
    "Clerk": "sample string 16",
    "Saletaxnum": "sample string 17",
    "Kptype": 18,
    "Message": "sample string 19",
    "Fpqqlsh": "sample string 20",
    "C_status": 0,
    "C_statusName": "sample string 21",
    "C_msg": "sample string 22",
    "CreateTime": "2025-11-06T04:08:02.295322+08:00",
    "Fpdm": "sample string 24",
    "Fphm": "sample string 25",
    "Tsfs": "sample string 26",
    "Email": "sample string 27",
    "BillInfoNo": "sample string 28",
    "Goodsname": "sample string 29",
    "Num": 30,
    "Price": 31.0,
    "Hsbz": "sample string 32",
    "Taxrate": 33.0,
    "Spbm": "sample string 34",
    "Taxfreeamt": 35.0,
    "Tax": 36.0,
    "Taxamt": 37.0
  },
  "Status": 1,
  "Message": "sample string 2",
  "Total": 3
}

application/xml, text/xml

Sample: 
<RequestResultOfSelfCheckinInvoiceDTO6NgmDdgv xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/WLife.Application">
  <Message>sample string 2</Message>
  <Status>1</Status>
  <Total>3</Total>
  <Data xmlns:d2p1="http://schemas.datacontract.org/2004/07/WLife.Application.DTOs">
    <d2p1:Account>sample string 14</d2p1:Account>
    <d2p1:Address>sample string 13</d2p1:Address>
    <d2p1:BillInfoNo>sample string 28</d2p1:BillInfoNo>
    <d2p1:Buyername>sample string 10</d2p1:Buyername>
    <d2p1:C_msg>sample string 22</d2p1:C_msg>
    <d2p1:C_status>None</d2p1:C_status>
    <d2p1:C_statusName>sample string 21</d2p1:C_statusName>
    <d2p1:Clerk>sample string 16</d2p1:Clerk>
    <d2p1:CreateTime>2025-11-06T04:08:02.295322+08:00</d2p1:CreateTime>
    <d2p1:Email>sample string 27</d2p1:Email>
    <d2p1:Fpdm>sample string 24</d2p1:Fpdm>
    <d2p1:Fphm>sample string 25</d2p1:Fphm>
    <d2p1:Fpqqlsh>sample string 20</d2p1:Fpqqlsh>
    <d2p1:Goodsname>sample string 29</d2p1:Goodsname>
    <d2p1:GuestName>sample string 8</d2p1:GuestName>
    <d2p1:HotelId>2</d2p1:HotelId>
    <d2p1:HotelName>sample string 3</d2p1:HotelName>
    <d2p1:Hsbz>sample string 32</d2p1:Hsbz>
    <d2p1:ID>1</d2p1:ID>
    <d2p1:InvoiceApiType>7</d2p1:InvoiceApiType>
    <d2p1:Kptype>18</d2p1:Kptype>
    <d2p1:Message>sample string 19</d2p1:Message>
    <d2p1:Num>30</d2p1:Num>
    <d2p1:Phone>sample string 12</d2p1:Phone>
    <d2p1:PhoneNumber>sample string 9</d2p1:PhoneNumber>
    <d2p1:PmsRegOrderId>sample string 6</d2p1:PmsRegOrderId>
    <d2p1:Price>31</d2p1:Price>
    <d2p1:RegOrderId>5</d2p1:RegOrderId>
    <d2p1:RoomNumber>sample string 4</d2p1:RoomNumber>
    <d2p1:Saletaxnum>sample string 17</d2p1:Saletaxnum>
    <d2p1:Spbm>sample string 34</d2p1:Spbm>
    <d2p1:Tax>36</d2p1:Tax>
    <d2p1:Taxamt>37</d2p1:Taxamt>
    <d2p1:Taxfreeamt>35</d2p1:Taxfreeamt>
    <d2p1:Taxnum>sample string 11</d2p1:Taxnum>
    <d2p1:Taxrate>33</d2p1:Taxrate>
    <d2p1:Telephone>sample string 15</d2p1:Telephone>
    <d2p1:Tsfs>sample string 26</d2p1:Tsfs>
  </Data>
</RequestResultOfSelfCheckinInvoiceDTO6NgmDdgv>