Bills

Get all bills

Returns all bills, optionally filtered by customers, identifiers and other filters. Note this operation uses Pagination.

Request

[PlatformAddress]/api/connector/v1/bills/getAll

{
  "ClientToken": "E0D439EE522F44368DC78E1BFB03710C-D24FB11DBE31D4621C4817E028D9E1D",
  "AccessToken": "C66EF7B239D24632943D115EDE9CB810-EA00F8FD8294692C940F6B5A8F9453D",
  "Client": "Sample Client 1.0.0",
  "Extent": {
    "Items": false
  },
  "ClosedUtc": {
    "StartUtc": "2020-02-05T00:00:00Z",
    "EndUtc": "2020-02-10T00:00:00Z"
  },
  "CreatedUtc": {
    "StartUtc": "2020-02-05T00:00:00Z",
    "EndUtc": "2020-02-10T00:00:00Z"
  },
  "UpdatedUtc": {
    "StartUtc": "2020-02-05T00:00:00Z",
    "EndUtc": "2020-02-10T00:00:00Z"
  },
  "BillIds": [
    "e654f217-d1b5-46be-a820-e93ba568dfac"
  ],
  "CustomerIds": [
    "fe795f96-0b64-445b-89ed-c032563f2bac"
  ],
  "State": "Closed",
  "EnterpriseIds": [
    "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "4d0201db-36f5-428b-8d11-4f0a65e960cc"
  ],
  "Limitation": {
    "Count": 100,
    "Cursor": "e7f26210-10e7-462e-9da8-ae8300be8ab7"
  }
}

Property	Type	Contract	Description
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.
IssuedUtc	Time interval	optional, max length 3 months	Interval in which the Bill was issued.
PaidUtc	Time interval	optional, max length 3 months	Interval in which the Bill was paid.
DueUtc	Time interval	optional, max length 3 months	Interval in which the Bill is due to be paid.
CreatedUtc	Time interval	optional, max length 3 months	Interval in which the Bill was created.
UpdatedUtc	Time interval	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	Bill state	optional	State the bills should be in. If not specified, Open and Closed bills are returned.
Type	Bill type	optional	Type of the bills. If not specified, all types are returned.
CorrectionState	array of Bill correction state	optional	Whether to return regular bills, corrective bills, or both. If BillIds are specified, defaults to both, otherwise defaults to Bill.
Limitation	Limitation	required	Limitation on the quantity of data returned and optional Cursor for the starting point of data.
Extent	Bill 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.
ClosedUtc	Time interval	optional, max length 3 months	Interval in which the Bill was closed. Deprecated! Use IssuedUtc instead.

Bill extent

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!

Property	Type	Contract	Description
Items	boolean	required	Whether the response should contain payments and revenue items. Deprecated! Use orderItems/getAll and payments/getAll with BillIds filter instead.

Bill state

• Open
• Closed

Bill type

• 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.

Response

Property	Type	Contract	Description
Bills	array of Bill	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.

Get bill PDF

Generates a PDF document of the specified bill. If the PDF cannot be returned immediately, retry the call later with the unique event identifier returned by the first invocation as BillPrintEventId.

This operation is subject to the Mews Operations quota "Property Financial Document Print Event Weekly Count". Each bill can be printed or previewed up to 30 times within 7 days. Requests that include an existing BillPrintEventId do not count against this quota.

Request

[PlatformAddress]/api/connector/v1/bills/getPdf

Property	Type	Contract	Description
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	Unique identifier of the Bill to be printed.
BillPrintEventId	string	optional	Identifier of an existing bill print event returned by a previous call. Provide this value to retry retrieval of a pending PDF without consuming its "Property Financial Document Print Event Weekly Count" quota.
PdfTemplate	Bill PDF template type	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.

Bill PDF template type

• 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.

Response

Property	Type	Contract	Description
BillId	string	required	Unique identifier of the printed bill.
Result	Bill PDF result discriminator	required	The result of operation.

Bill PDF result discriminator

Property	Type	Contract	Description
Discriminator	Bill PDF result discriminator	required	Determines type of value.
Value	object	required	Structure of object depends on Discriminator.

Bill PDF result 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

Bill PDF file

Property	Type	Contract	Description
Base64Data	string	required	Base64 encoded PDF file.

Bill print event

Property	Type	Contract	Description
BillPrintEventId	string	required	Unique identifier of print event. Must be used in retry calls to retrieve the PDF.

Add bill

Creates new empty bill assigned to specified account. Note this operation supports Portfolio Access Tokens.

Request

[PlatformAddress]/api/connector/v1/bills/add

Property	Type	Contract	Description
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	Unique identifier of the enterprise. Required when using Portfolio Access Tokens, ignored otherwise.
Bills	array of Bill parameters	required, max 1000 items	Information about bills to be created.

Bill parameters

Property	Type	Contract	Description
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.

Response

Property	Type	Contract	Description
Bills	array of Bill	required	The created bills.

Update bills

Restricted!

This operation is currently in beta-test and as such it is subject to change.

Updates one or more existing bills in the system. Closed bills cannot be updated. Note this operation supports Portfolio Access Tokens.

Request

[PlatformAddress]/api/connector/v1/bills/update

Property	Type	Contract	Description
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	Unique identifier of the enterprise. Required when using Portfolio Access Tokens, ignored otherwise.
BillsUpdates	array of Bill update parameters	required, max 10 items	Information about bills to be updated.

Bill update parameters

Property	Type	Contract	Description
BillId	string	required	Unique identifier of the bill to update.
AccountId	String update value	optional	Unique identifier of the account (Customer or Company) the bill is issued to (or null if the account should not be updated).
AssociatedAccountIds	Associated account IDs update parameters	optional	Unique identifiers of the Customer or Company that are associated to the bill (or null if the account should not be updated).

Associated account IDs update parameters

Has same structure as Array of strings update value.

Property	Type	Contract	Description
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.

Response

Property	Type	Contract	Description
Bills	array of Bill	required	Updated bills.

Bill

Property	Type	Contract	Description
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.
AccountType	Account type	required	A discriminator specifying the type of account, i.e. Customer or Company.
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	Bill state	required	Whether the bill is Open or Closed.
Type	Bill 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	Bill options	optional	Options of the bill.
OwnerData	Bill owner data	optional	Additional information about owner of the bill. Can be a Customer or Company. Persisted at the time of closing of the bill.
AssociatedAccountData	array of Associated account bill data	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	Bill enterprise data	optional	Additional information about the enterprise issuing the bill, including bank account details. Persisted at the time of closing of the bill.
CorrectionState	Bill correction state	required	Whether the bill is a regular bill or a corrective bill.
CorrectionType	Bill correction type	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	array of Accounting item	optional	Deprecated! Use orderItems/getAll with BillId instead.
Payments	array of Accounting item	optional	Deprecated! Use payments/getAll with BillId instead.
OrderItems	array of Order item	optional	The order items (consumed items such as nights or products) on the bill. Deprecated! Use orderItems/getAll with BillId instead.
PaymentItems	array of Payment item	optional	The payment items (such as cash, credit card payments or invoices) on the bill. Deprecated!
AssigneeData	Bill assignee data	optional	Deprecated! Use OwnerData instead.
CompanyDetails	Bill company data	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.

Bill state

• Open
• Closed

Bill type

• 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.

Bill options

Options of the bill.

Property	Type	Contract	Description
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).

Bill assignee data

Property	Type	Contract	Description
Discriminator	Bill associated account data discriminator	required	Determines type of value.
Value	object	required	Structure of object depends on Discriminator.

Bill associated account data discriminator

• BillCustomerData
• BillCompanyData

Bill company data

Property	Type	Contract	Description
Id	string	optional	ID of the Company.
Address	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 (Data Universal Numbering System) number 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.

Bill customer data

Property	Type	Contract	Description
Id	string	required	ID of the Customer to whom the bill was assigned.
Address	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	Title	optional	Title prefix of the customer.
TaxIdentifier	string	optional	Tax identifier of the customer.

Bill owner data

Property	Type	Contract	Description
Discriminator	Bill associated account data discriminator	required	Determines type of value.
Value	object	required	Structure of object depends on Discriminator.

Associated account bill data

Property	Type	Contract	Description
Discriminator	Bill associated account data discriminator	required	Determines type of value.
BillCustomerData	Bill customer data	optional	Associated account bill data for customer.
BillCompanyData	Bill company data	optional	Associated account bill data for company.

Bill enterprise data

Additional information about the enterprise issuing the bill, including bank account details. Persisted at the time of closing of the bill.

Property	Type	Contract	Description
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 correction state

• Bill - Regular bill.
• CorrectiveBill - Corrective bill, i.e. the CorrectionType is either Edit, Cancellation, or ReceivablePaymentsBalance.

Bill correction type

• Cancellation
• Edit
• CreditNote
• Reinstatement
• ReceivablePaymentsBalance

Reissue bill

Restricted!

This operation is currently in beta-test and as such it is subject to change.

Reissues a closed bill or issued invoice. The operation credits the original document with a credit note and carries its items over to a new open bill, which can then be corrected and closed again. A bill can be reissued only once, and the operation rejects payment confirmations, split audit bills, corrective documents other than previously reissued bills, bills with rebated items and – at enterprises that track receivables – paid invoices. Note this operation supports Portfolio Access Tokens.

Request

[PlatformAddress]/api/connector/v1/bills/reissue

Property	Type	Contract	Description
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	Unique identifier of the enterprise. Required when using Portfolio Access Tokens, ignored otherwise.
BillId	string	required	Unique identifier of the closed Bill to reissue.
Reason	string	required, max length 255 characters	Reason for reissuing the bill.
CreditNoteCounterId	string	optional	Unique identifier of the Counter used to number the credit note. Required when the enterprise's legal environment mandates a dedicated credit note counter, and must be omitted otherwise. Retrieve the available counters with Get all counters using Type set to CreditNoteBillCounter – when the enterprise requires one but has none configured, it must first be added in Mews Operations.

Response

Property	Type	Contract	Description
CreditNote	Bill	required	The closed credit note crediting the bill that was reissued. Its CorrectedBillId is the identifier of that bill.
Bill	Bill	required	The new open bill carrying the items of the bill that was reissued. Its CorrectedBillId is the identifier of the credit note.

Delete bill

Removes selected bills. Bill must be empty, otherwise it's not possible to delete it. Note this operation supports Portfolio Access Tokens.

Request

[PlatformAddress]/api/connector/v1/bills/delete

Property	Type	Contract	Description
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	Unique identifier of the enterprise. Required when using Portfolio Access Tokens, ignored otherwise.
BillIds	array of string	required, max 1000 items	Unique identifiers of the Bills to be deleted.

Response

Close bill

Closes a bill so no further modification to it is possible. Note this operation supports Portfolio Access Tokens.

Request

[PlatformAddress]/api/connector/v1/bills/close

Property	Type	Contract	Description
ClientToken	string	required