Finance and accounting

When it comes to integrating Ulyses Cloud with Accounting Management Systems (or similar) there will be specific endpoints we may use to get the information needed to feed them.

Common operations

Invoices

Ulyses Cloud generates an invoice whenever a folio is closed. Other PMS name Ulyses Cloud invoices as Bills or closed folios. Invoices count for an essential part of all accounting systems, their fuel. Without them, accounting systems become useless. Our API allow you to get the list of invoices issued during a time range or we can get an specific invoices by an id. In both cases we get a complete detail of each invoice (header, list of products) . We recommend to limit the number of records by applying a filter in which we specify a time span of a week or two.

Proforma

Users can request a proforma invoice when a reservation has been confirmed but havent checked in yet. In short, Ulyses Cloud knows a proforma invoice as the confirmation of the products that have been contracted. A proforma invoice never shows the products that have been added during the stay. The following endpoint can be useful in cases in which a system needs to know all products contracted and the total amount of the reservation. The amount of proformas we will retrieve will depend on the payment type selected in the reservation roomstay. Therefore, we can expect getting a higher number proformas if we have selected "Pay Guest Agency" than if we have selected "Pay Guest" or "Pay Agency" as the number of intermediates has grown as well. Ultimately, the number of "Bill to"'s will be relevant as well since it can be different on a daily basis and this could make increase the number of companies in the reservation.

Revenue

Ulyses Cloud products counts into revenue whenever a folio product (line of a folio) has a date lower or equal than the business date. In other words, for Ulyses Cloud revenue means consumption. The following operation will provide the property's revenue based on a date range and product. The idea is to retrieve the revenue produced an specific time range and apply filters by product or product type afterwards.

For example, if we need to know the revenues generated by all Accomodations in January 2019 we will get the revenue for the period needed first and we will apply a product type filter afterwards. As opposite, if we need to know the revenues that comes from our parking we will request the revenues for the period and we will apply a product filter afterwards.

Payments

Payments are known in Ulyses Cloud as the collection of products of type payment added in folios throughtout a period. Therefore, the following operation will provide the property's list of payments generated during a time frame. Once we get the response we will be able to filter the content depending on the payment form and amounts. To add payments for the total amount of a room stay we will suse the following endpoint

Pay in advance

Ulyses Cloud know pay-in-advance as payments in which the posting time is lower than the business date of the invoice. Ulyses Connector API provides a list of payments in advance that have been created during an specific time range. We can also add partial payments or pay a roomstay easily.

AR Statements

Ulyses Cloud allows users to make credit payments. No matter if users add payments manually or close folios by means of this payment form (credit), all of these are collected and send to their correspondent debtors later on. When these have got paid users will change the status of these transactions. Ulyses Cloud allows to get the full list of paid transactions throughout an specific period.

Deposits

Ulyses Cloud gives its users the ability to create deposits. Deposits are payments that have been done prior to reservation arrival's and which can be applied directly in reservations. All deposits are products of type Deposit and Ulyses Connector API provides the current list of deposits created. The result can be filtered depending on the status.