Bills
Last updated
Was this helpful?
Last updated
Was this helpful?
Returns all bills, optionally filtered by customers, identifiers and other filters. Note this operation uses .
[PlatformAddress]/api/connector/v1/bills/getAll
ClientToken
string
required
Token identifying the client application.
AccessToken
string
required
Access token of the client application.
Client
string
required
Name and version of the client application.
EnterpriseIds
array of string
optional, max 1000 items
Unique identifiers of the Enterprises. If not specified, the operation returns data for all enterprises within scope of the Access Token.
ClosedUtc
optional, max length 3 months
Interval in which the Bill
was closed.
PaidUtc
optional, max length 3 months
Interval in which the Bill
was paid.
DueUtc
optional, max length 3 months
Interval in which the Bill
is due to be paid.
CreatedUtc
optional, max length 3 months
Interval in which the Bill
was created.
UpdatedUtc
optional, max length 3 months
Interval in which the Bill
was updated.
BillIds
array of string
optional, max 1000 items
Unique identifiers of the Bills
. Required if no other filter is provided.
CustomerIds
array of string
optional, max 1000 items
Unique identifiers of the Customers
.
State
required
State the bills should be in. If not specified, Open
and Closed
bills are returned.
CorrectionState
optional
Whether to return regular bills, corrective bills, or both. If BillIds
are specified, defaults to both, otherwise defaults to Bill
.
Limitation
required
Limitation on the quantity of data returned and optional Cursor for the starting point of data.
Extent
optional
Extent of data to be returned. E.g. it is possible to specify that together with the bills, payments and revenue items should be also returned. Deprecated! Use orderItems/getAll
and payments/getAll
with BillIds
filter instead.
Extent of data to be returned. E.g. it is possible to specify that together with the bills, payments and revenue items should be also returned. Deprecated!
Items
boolean
required
Whether the response should contain payments and revenue items. Deprecated! Use orderItems/getAll
and payments/getAll
with BillIds
filter instead.
Bills
required
The filtered bills.
Cursor
string
optional
Unique identifier of the last and hence oldest bill returned. This can be used in Limitation
in a subsequent request to fetch the next batch of older bills.
Creates a PDF version of the specified bill. In case it's not possible to return PDF immediately, you must retry the call later while providing the unique event identifier that is returned from the first invocation.
[PlatformAddress]/api/connector/v1/bills/getPdf
ClientToken
string
required
Token identifying the client application.
AccessToken
string
required
Access token of the client application.
Client
string
required
Name and version of the client application.
BillId
string
required
BillPrintEventId
string
optional
PdfTemplate
optional
Bill PDF template type. If not specified, the default template is used.
PrintReason
string
optional, max length 255 characters
The reason for reprinting the bill with different template. Required for France LE.
Detailed
- Detailed overview. Items are grouped by the reservation, item type and price, and consumption date.
Consumption
- Overview by date (no reservation details). Items of the same type and price are grouped by consumption date.
Reservation
- Overview by reservation (no date). Items of the same type and price are grouped by reservation.
OrderItem
- Consumption overview (not fiscal document). Items are grouped by the item type and price without reservation details and consumption date.
Guest
- Overview by guest. Items are grouped by guest, reservation, consumption date, and item type.
BillId
string
required
Unique identifier of the printed bill.
Result
required
Discriminator
required
Determines type of value.
Value
object
required
Structure of object depends on Discriminator
.
BillPdfFile
- PDF version of a Bill
was successfully created, Value
is BillPdfFile
.
BillPrintEvent
- PDF version of a Bill
couldn't be created at this moment (for example bill haven't been reported to authorities yet), Value
is BillPrintEvent
Base64Data
string
required
Base64 encoded PDF file.
BillPrintEventId
string
required
Unique identifier of print event. Must be used in retry calls to retrieve the PDF.
[PlatformAddress]/api/connector/v1/bills/add
ClientToken
string
required
Token identifying the client application.
AccessToken
string
required
Access token of the client application.
Client
string
required
Name and version of the client application.
EnterpriseId
string
optional
Bills
required, max 1000 items
Information about bills to be created.
AccountId
string
required
Unique identifier of the account (Customer
or Company
) the bill is issued to. Company billing may not be enabled for your integration.
AssociatedAccountId
string
optional
Account that has a possible link with the owner of the bill.
Name
string
optional
Name of the newly created bill.
Bills
required
The created bills.
Restricted!This operation is currently in beta-test and as such it is subject to change.
[PlatformAddress]/api/connector/v1/bills/update
ClientToken
string
required
Token identifying the client application.
AccessToken
string
required
Access token of the client application.
Client
string
required
Name and version of the client application.
EnterpriseId
string
optional
BillsUpdates
required, max 10 items
Information about bills to be updated.
BillId
string
required
Unique identifier of the bill to update.
AccountId
optional
Unique identifier of the account (Customer
or Company
) the bill is issued to (or null if the account should not be updated).
AssociatedAccountIds
optional
Unique identifiers of the Customer
or Company
that are associated to the bill (or null if the account should not be updated).
Value
array of string
optional, max 1 item
Unique identifiers of the Customer
or Company
that are associated to the bill. Set to null
to remove all associated accounts. Note that only single associated account is currently supported.
Bills
required
Updated bills.
Id
string
required
Unique identifier of the bill.
Name
string
optional
Name of the bill.
EnterpriseId
string
required
Unique identifier of the Enterprise
.
AccountId
string
required
Unique identifier of the account (Customer
or Company
) the bill is issued to.
AssociatedAccountIds
array of string
optional
Unique identifiers of the Customers
or Companies
that are associated to the bill.
CounterId
string
optional
Unique identifier of the bill Counter
.
State
required
Whether the bill is Open
or Closed
.
Type
required
After a bill is closed, the Bill Type is set to Receipt
or Invoice
. Receipt
indicates that the bill has been fully paid and the balance is zero. Invoice
indicates that the bill has not yet been fully paid but an invoice has been issued. Prior to closing, Bill Type should not be used.
Number
string
optional
Number of the bill.
VariableSymbol
string
optional
Variable symbol of the bill.
CreatedUtc
string
required
Date and time of the bill creation in UTC timezone in ISO 8601 format.
IssuedUtc
string
optional
Date and time of the bill issuance in UTC timezone in ISO 8601 format.
TaxedUtc
string
optional
Taxation date of the bill in UTC timezone in ISO 8601 format.
PaidUtc
string
optional
Date when the bill was paid in UTC timezone in ISO 8601 format.
DueUtc
string
optional
Bill due date and time in UTC timezone in ISO 8601 format.
LastReminderDateUtc
string
optional
Date and time when an email reminder to pay an invoice was last sent, in UTC timezone in ISO 8601 format.
UpdatedUtc
string
required
Date and time when the bill was last updated, in UTC timezone in ISO 8601 format.
PurchaseOrderNumber
string
optional
Unique number of the purchase order from the buyer.
Notes
string
optional
Additional notes.
Options
optional
Options of the bill.
OwnerData
required
AssociatedAccountData
optional
Additional information about the associated account of the bill. Can be a Customer
or Company
. Persisted at the time of closing of the bill. Currently only one account can be associated with a bill, but this may be extended in future.
EnterpriseData
optional
Additional information about the enterprise issuing the bill, including bank account details. Persisted at the time of closing of the bill.
CorrectionState
required
Whether the bill is a regular bill or a corrective bill.
CorrectionType
optional
Type of correction.
CorrectedBillId
string
optional
The ID of the bill that the corrective bill corrects. If the corrected bill was deleted, this field is null
.
CustomerId
string
optional
Unique identifier of the Customer the bill is issued to. Deprecated! Use AccountId
instead.
CompanyId
string
optional
Unique identifier of the Company specified in CompanyDetails or the Company the bill is issued to. Deprecated! Use AssociatedAccountIds
instead.
Revenue
optional
Deprecated! Use orderItems/getAll
with BillId
instead.
Payments
optional
Deprecated! Use payments/getAll
with BillId
instead.
OrderItems
optional
The order items (consumed items such as nights or products) on the bill. Deprecated! Use orderItems/getAll
with BillId
instead.
PaymentItems
optional
The payment items (such as cash, credit card payments or invoices) on the bill. Deprecated!
AssigneeData
required
Deprecated! Use OwnerData
instead.
CompanyDetails
optional
Additional information about the company assigned to the bill. Not the same as the owner. Persisted at the time of closing of the bill. Deprecated! Use AssociatedAccountData
instead.
Open
Closed
Receipt
- Default; the bill has been paid in full; only applicable after the bill is closed.
Invoice
- Bill has not been paid in full but an invoice has been issued to request payment.
Options of the bill.
DisplayCustomer
boolean
required
Display customer information on a bill.
DisplayTaxation
boolean
required
Display taxation detail on a bill.
TrackReceivable
boolean
required
Tracking of payments is enabled for bill, only applicable for BillType
of Invoice
.
DisplayCid
boolean
required
Display CID number on bill, only applicable for BillType
of Invoice
.
Rebated
boolean
required
Whether the bill is rebated (both fully or partially).
Discriminator
required
Determines type of value.
Value
object
required
Structure of object depends on Discriminator
.
BillCustomerData
BillCompanyData
Id
string
optional
ID of the Company
.
Address
optional
Address of the company.
LegalIdentifiers
object
optional
The set of LegalIdentifiers
for the company.
BillingCode
string
optional
A unique code for Mews to list on invoices it sends to the company.
Name
string
required
Name of the company.
FiscalIdentifier
string
optional
Fiscal identifier of the company.
AdditionalTaxIdentifier
string
optional
Additional tax identifier of the company.
DUNS
string
optional
DUNS of the company.
Telephone
string
optional
Company telephone number.
TaxIdentifier
string
optional
Tax identifier of the company.
InvoicingEmail
string
optional
Invoicing email of the company.
Department
string
optional
Department of the company.
Id
string
required
ID of the Customer
to whom the bill was assigned.
Address
optional
Address of the customer.
LegalIdentifiers
object
optional
The set of LegalIdentifiers
for the customer.
BillingCode
string
optional
A unique code for Mews to list on invoices it sends to the customer.
LastName
string
required
Last name of the customer.
FirstName
string
optional
First name of the customer.
SecondLastName
string
optional
Second last name of the customer.
TitlePrefix
optional
Title prefix of the customer.
Discriminator
required
Determines type of value.
Value
object
required
Structure of object depends on Discriminator
.
Discriminator
required
Determines type of value.
BillCustomerData
optional
Associated account bill data for customer.
BillCompanyData
optional
Associated account bill data for company.
Additional information about the enterprise issuing the bill, including bank account details. Persisted at the time of closing of the bill.
AdditionalTaxIdentifier
string
optional
Enterprise additional tax identifier.
CompanyName
string
optional
Enterprise company name.
BankAccount
string
optional
Enterprise bank account.
BankName
string
optional
Enterprise bank name.
Iban
string
optional
Enterprise IBAN (International Bank Account Number).
Bic
string
optional
Enterprise BIC (Bank Identifier Code).
Bill
- Regular bill.
CorrectiveBill
- Corrective bill, i.e. the CorrectionType
is either Edit
, Cancellation
, or ReceivablePaymentsBalance
.
Cancellation
Edit
CreditNote
Reinstatement
ReceivablePaymentsBalance
[PlatformAddress]/api/connector/v1/bills/delete
ClientToken
string
required
Token identifying the client application.
AccessToken
string
required
Access token of the client application.
Client
string
required
Name and version of the client application.
EnterpriseId
string
optional
BillIds
array of string
required, max 1000 items
[PlatformAddress]/api/connector/v1/bills/close
ClientToken
string
required
Token identifying the client application.
AccessToken
string
required
Access token of the client application.
Client
string
required
Name and version of the client application.
EnterpriseId
string
optional
BillId
string
required
Type
required
After a bill is closed, the Bill Type is set to Receipt
or Invoice
. Receipt
indicates that the bill has been fully paid and the balance is zero. Invoice
indicates that the bill has not yet been fully paid but an invoice has been issued. Prior to closing, Bill Type should not be used.
BillCounterId
string
optional
FiscalMachineId
string
optional
Options
optional
Options of the bill. If not provided, both DisplayCustomer and DisplayTaxation are set by default.
TaxedDate
optional
Date of consumption for tax purposes. Can be used only with Type
of Invoice
.
DueDate
optional
Deadline when bill is due to be paid. Can be used only with Type
of Invoice
.
VariableSymbol
optional
Optional unique identifier of requested payment. Can be used only with Type
of Invoice
.
AccountTaxIdentifier
optional
Tax identifier of account to be put on a bill.
PurchaseOrderNumber
optional
Unique number of the purchase order from the buyer.
Notes
optional
Notes to be attached to bill.
AccountAddress
optional
Address of the account to be displayed on bill. Overrides the default one taken from account profile.
AssociatedAccountData
optional, max 1 item
Account data of the associated account on a bill. Currently one object is supported and only populated when the bill is closed.
TaxIdentifier
optional
Tax identifier of account to be put on a bill. Deprecated! Use AccountTaxIdentifier
or AssociatedAccountData
instead.
CompanyTaxIdentifier
optional
Tax identifier of company to be put on a bill. Deprecated! Use AccountTaxIdentifier
or AssociatedAccountData
instead.
Address
optional
Address of the account to be displayed on bill. Overrides the default one taken from account profile. Deprecated! Use AccountAddress
or AssociatedAccountData
instead.
DisplayCustomer
required
Display customer information on a bill.
DisplayTaxation
required
Display taxation detail on a bill.
Id
string
required
Unique identifier of the associated account (Customer
or Company
) the bill is associated to.
TaxIdentifier
optional
Tax identifier of the associated account to be put on a bill.
Address
optional
Address of the associated account to be displayed on bill. Overrides the default one taken from account profile.
Bills
required
The closed bills.
array of
array of
Unique identifier of the to be printed.
Unique identifier of the returned by previous invocation.
Creates new empty bill assigned to specified account. Note this operation supports .
Unique identifier of the enterprise. Required when using , ignored otherwise.
array of
array of
Updates one or more existing bills in the system. Closed bills cannot be updated. Note this operation supports .
Unique identifier of the enterprise. Required when using , ignored otherwise.
array of
Has same structure as .
array of
Additional information about owner of the bill. Can be a or . Persisted at the time of closing of the bill.
array of
array of
array of
array of
array of
Additional information about owner of the bill. Can be a or . Persisted at the time of closing of the bill.
Removes selected bills. Bill must be empty, otherwise it's not possible to delete it. Note this operation supports .
Unique identifier of the enterprise. Required when using , ignored otherwise.
Unique identifiers of the s to be deleted.
Closes a bill so no further modification to it is possible. Note this operation supports .
Unique identifier of the enterprise. Required when using , ignored otherwise.
Unique identifier of the to be closed.
Unique identifier of the to be used for closing. Default one is used when no value is provided.
Unique identifier of the to be used for closing. Default one is used when no value is provided.
array of
array of