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",
    "BillIds": [
        "e654f217-d1b5-46be-a820-e93ba568dfac"
    ],
    "CustomerIds": [
        "fe795f96-0b64-445b-89ed-c032563f2bac"
    ],
    "State": "Closed",
    "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"
    },
    "DueUtc": null,
    "PaidUtc": null,
    "Extent": {
        "Items": false
    },
    "Limitation":{
        "Cursor": "e7f26210-10e7-462e-9da8-ae8300be8ab7",
        "Count": 100
    }
}
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.
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
string
optional
​Bill state the bills should be in. If not specified Open and Closed bills are returned.
ClosedUtc
​Time interval​
optional, max length 3 months
Interval in which the Bill was closed.
CreatedUtc
​Time interval​
optional, max length 3 months
Interval in which the Bill was created.
DueUtc
​Time interval​
optional , max length 3 months
Interval in which the Bill is due to be paid.
PaidUtc
​Time interval​
optional, max length 3 months
Interval in which the Bill was paid.
Extent
​Bill extent​
required
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.
Limitation
​Limitation​
required
Limitation on the quantity of bill data returned.
Time interval
Property
Type
Contract
Description
StartUtc
string
required
Start of the interval in UTC timezone in ISO 8601 format.
EndUtc
string
required
End of the interval in UTC timezone in ISO 8601 format.
Bill state
Open
Closed
Bill extent
Property
Type
Contract
Description
Items
bool
required
Whether the response should contain payments and revenue items.
Response
{
    "Bills": [
        {
            "Id": "26afba60-06c3-455b-92db-0e3983be0b1d",
            "AccountId": "fe795f96-0b64-445b-89ed-c032563f2bac",
            "CustomerId": "fe795f96-0b64-445b-89ed-c032563f2bac",
            "CompanyId": null,
            "CounterId": null,
            "State": "Closed",
            "Type": "Invoice",
            "Number": "29",
            "VariableSymbol": null,
            "CreatedUtc": "2017-01-31T10:48:06Z",
            "IssuedUtc": "2017-01-31T10:58:06Z",
            "TaxedUtc": null,
            "PaidUtc": null,
            "DueUtc": null,
            "Notes": "",
            "Options": {
                "DisplayCustomer": true,
                "DisplayTaxation": true,
                "TrackReceivable": true,
                "DisplayCid": false
            },
            "OrderItems": [],
            "PaymentItems": [],
            "AssigneeData": {
                "Discriminator": "BillCustomerData",
                "Value": {
                    "ItalianFiscalCode": null
                }
            }
        }
    ],
    "Cursor": "8d02142f-31cf-4115-90bf-ae5200c7a1ba"
}
Property
Type
Contract
Description
Bills
array of Bill​
required
The filtered bills.
Cursor
string
required
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.
Bill
Property
Type
Contract
Description
Id
string
required
Unique identifier of the bill.
AccountId
string
required
Unique identifier of the account (for example Customer) the bill is issued to.
CustomerId
string
optional
Unique identifier of the Customer the bill is issued to.
CompanyId
string
optional
Unique identifier of the Company the bill is issued to.
CounterId
string
optional
Unique identifier of the bill Counter.
State
string Bill state​
required
State of the bill.
Type
string Bill type​
required
Type of the bill.
Number
string
required
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
required
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.
Notes
string
optional
Additional notes.
Options
​Bill options​
required
Options of the bill.
OrderItems
array of Order item​
required
The order items (consumed items such as nights or products) on the bill.
PaymentItems
array of Payment item​
required
The payment items (such as cash, credit card payments or invoices) on the bill.
AssigneeData
​Bill assignee data​
optional
Additional information about assignee of the bill. Persisted at the time of closing of the bill.
Bill type
A bill is either a Receipt which means that it has been fully paid, or Invoice that is supposed to be paid in the future.
Receipt - the bill has already been fully paid.
Invoice - the bill is supposed to be paid in the future. Before closing it is balanced with an invoice payment.
Bill options
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 Invoice.
DisplayCid
boolean
required
Display CID number on bill, only applicable for Invoice.
Bill assignee data
Property
Type
Contract
Description
Discriminator
string Bill assignee data discriminator​
required
Determines type of value.
Value
object
required
Structure of object depends on Bill assignee data discriminator.
Bill assignee data discriminator
BillCustomerData - Assignee data specific to a customer.
BillCompanyData - Assignee data specific to a company.
Bill customer data
Property
Type
Contract
Description
ItalianFiscalCode
string
optional
Italian fiscal code.
Bill company data
Add bill
Creates new empty bill assigned to specified account.
Request
[PlatformAddress]/api/connector/v1/bills/add
{
    "ClientToken": "E0D439EE522F44368DC78E1BFB03710C-D24FB11DBE31D4621C4817E028D9E1D",
    "AccessToken": "C66EF7B239D24632943D115EDE9CB810-EA00F8FD8294692C940F6B5A8F9453D",
    "Client": "Sample Client 1.0.0",
    "Bills": [
        {
            "AccountId": "a5786a7b-a388-43cc-a838-abd7007b5ff7"
        }
    ]
}
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.
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 (for example Customer) the bill is issued to.
Response
{
    "Bills": [
        {
            "Id": "177966b7-f3d9-42b7-ba49-abd80057329b",
            "AccountId": "fe795f96-0b64-445b-89ed-c032563f2bac",
            "CustomerId": "a5786a7b-a388-43cc-a838-abd7007b5ff7",
            "CompanyId": null,
            "CounterId": null,
            "State": "Open",
            "Type": "Receipt",
            "Number": null,
            "VariableSymbol": null,
            "CreatedUtc": "2020-06-12T05:17:28Z",
            "IssuedUtc": null,
            "TaxedUtc": null,
            "PaidUtc": null,
            "DueUtc": null,
            "Notes": null,
            "OrderItems": [],
            "PaymentItems": []
        }
    ]
}
Property
Type
Contract
Description
Bills
array of Bill​
required
The created bills.
Delete bill
Removes selected bills. Bill must be empty, otherwise it's not possible to delete it.
Request
[PlatformAddress]/api/connector/v1/bills/delete
{
    "ClientToken": "E0D439EE522F44368DC78E1BFB03710C-D24FB11DBE31D4621C4817E028D9E1D",
    "AccessToken": "C66EF7B239D24632943D115EDE9CB810-EA00F8FD8294692C940F6B5A8F9453D",
    "Client": "Sample Client 1.0.0",
    "BillIds": [
        "177966b7-f3d9-42b7-ba49-abd80057329b"
    ]
}
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.
BillIds
array of string
required
Unique identifiers of the Bills to be deleted.
Response
{}
Close bill
Closes a bill so no further modification to it is possible.
Request
[PlatformAddress]/api/connector/v1/bills/close
{
    "ClientToken": "E0D439EE522F44368DC78E1BFB03710C-D24FB11DBE31D4621C4817E028D9E1D",
    "AccessToken": "C66EF7B239D24632943D115EDE9CB810-EA00F8FD8294692C940F6B5A8F9453D",
    "Client": "Sample Client 1.0.0",
    "BillId": "44eba542-193e-47c7-8077-abd7008eb206",
    "Type": "Receipt",
    "BillCounterId": "84b25778-c1dd-48dc-8c00-ab3a00b6df14",
    "FiscalMachineId": null,
    "Options": {
        "DisplayCustomer": {
            "Value": false
        },
        "DisplayTaxation": null
    },
    "TaxedDate": {
        "Value": "2020-07-07"
    },
    "DueDate": {
        "Value": "2020-07-14"
    },
    "VariableSymbol": {
        "Value": "5343"
    },
    "TaxIdentifier": {
        "Value": "446768"
    },
    "Notes": {
        "Value": "Bill closing note"
    }
}
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 closed.
Type
string Bill type​
required
Specifies the mode bill should be closed in.
BillCounterId
string
optional
Unique identifier of the Counter to be used for closing. Default one is used when no value is provided.
FiscalMachineId
string
optional
Unique identifier of the Fiscal Machine to be used for closing. Default one is used when no value is provided.
Options
​Bill options parameters​
optional
Options of the bill. If not provided both DisplayCustomer and DisplayTaxation are set by default.
TaxedDate
​String update value​
optional
Date of consumption for tax purposes. Can be used only with Bill type Invoice.
DueDate
​String update value​
optional
Deadline when Bill is due to be paid. Can be used only with Bill type Invoice.
VariableSymbol
​String update value​
optional
Optional unique identifier of requested payment. Can be used only with Bill type Invoice.
TaxIdentifier
​String update value​
optional
Tax identifier of account to be put on a bill.
Notes
​String update value​
optional
Notes to be attached to bill.
Address
​Address parameters​
optional
Address of the account to be displayed on bill. Overrides the default one taken from account profile.
Bill options parameters
Property
Type
Contract
Description
DisplayCustomer
​Bool update value​
required
Display customer information on a bill.
DisplayTaxation
​Bool update value​
required
Display taxation detail on a bill.
String update value
Property
Type
Contract
Description
Value
string
optional
Value which is to be updated.
Bool update value
Property
Type
Contract
Description
Value
bool
optional
Value which is to be updated.
Response
{
    "Bills": [
        {
            "Id": "44eba542-193e-47c7-8077-abd7008eb206",
            "CustomerId": "7eaf9da6-7229-454a-8cb0-abd700804bd2",
            "CompanyId": null,
            "CounterId": "84b25778-c1dd-48dc-8c00-ab3a00b6df14",
            "State": "Closed",
            "Type": "Receipt",
            "Number": "84",
            "VariableSymbol": null,
            "CreatedUtc": "2020-06-11T08:39:32Z",
            "IssuedUtc": "2020-06-25T08:49:38Z",
            "TaxedUtc": "2020-06-25",
            "PaidUtc": null,
            "DueUtc": null,
            "Notes": null,
            "Options": {
                "DisplayCustomer": false,
                "DisplayTaxation": true,
                "TrackReceivable": false,
                "DisplayCid": false
            },
            "OrderItems": [],
            "PaymentItems": []
        }
    ]
}
Property
Type
Contract
Description
Bills
array of Bill​
required
The closed bill.
Get bill PDF
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.
Request
[PlatformAddress]/api/connector/v1/bills/getPdf
{
    "ClientToken": "E0D439EE522F44368DC78E1BFB03710C-D24FB11DBE31D4621C4817E028D9E1D",
    "AccessToken": "C66EF7B239D24632943D115EDE9CB810-EA00F8FD8294692C940F6B5A8F9453D",
    "Client": "Sample Client 1.0.0",
    "BillId": "44eba542-193e-47c7-8077-abd7008eb206",
    "BillPrintEventId": null
}
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
Unique identifier of the Bill print event returned by previous invocation.
Response
{
    "BillId": "44eba542-193e-47c7-8077-abd7008eb206",
    "Result": {
        "Discriminator": "BillPdfFile",
        "Value": {
            "Base64Data": "JVBER....."
        }
    }
}
Property
Type
Contract
Description
BillId
string
required
The unique identifier of printed Bill.
Result
object Bill PDF result​
required
The result of operation.
Bill PDF result
Property
Type
Contract
Description
Discriminator
string Bill PDF result discriminator​
required
Determines type of result.
Value
object
required
Structure of object depends on Bill PDF result discriminator.
Bill PDF result discriminator
BillPdfFile - PDF version of a Bill was successfully created, Value is Bill PDF file.
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 Bill print event.
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.

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.
`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`	string	optional	Bill state the bills should be in. If not specified `Open` and `Closed` bills are returned.
`ClosedUtc`	Time interval	optional, max length 3 months	Interval in which the Bill was closed.
`CreatedUtc`	Time interval	optional, max length 3 months	Interval in which the Bill was created.
`DueUtc`	Time interval	optional , max length 3 months	Interval in which the Bill is due to be paid.
`PaidUtc`	Time interval	optional, max length 3 months	Interval in which the Bill was paid.
`Extent`	Bill extent	required	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.
`Limitation`	Limitation	required	Limitation on the quantity of bill data returned.

Property	Type	Contract	Description
`StartUtc`	string	required	Start of the interval in UTC timezone in ISO 8601 format.
`EndUtc`	string	required	End of the interval in UTC timezone in ISO 8601 format.

Property	Type	Contract	Description
`Items`	bool	required	Whether the response should contain payments and revenue items.

Property	Type	Contract	Description
`Bills`	array of Bill	required	The filtered bills.
`Cursor`	string	required	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.

Property	Type	Contract	Description
`Id`	string	required	Unique identifier of the bill.
`AccountId`	string	required	Unique identifier of the account (for example Customer) the bill is issued to.
`CustomerId`	string	optional	Unique identifier of the Customer the bill is issued to.
`CompanyId`	string	optional	Unique identifier of the Company the bill is issued to.
`CounterId`	string	optional	Unique identifier of the bill Counter.
`State`	string Bill state	required	State of the bill.
`Type`	string Bill type	required	Type of the bill.
`Number`	string	required	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	required	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.
`Notes`	string	optional	Additional notes.
`Options`	Bill options	required	Options of the bill.
`OrderItems`	array of Order item	required	The order items (consumed items such as nights or products) on the bill.
`PaymentItems`	array of Payment item	required	The payment items (such as cash, credit card payments or invoices) on the bill.
`AssigneeData`	Bill assignee data	optional	Additional information about assignee of the bill. Persisted at the time of closing 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 `Invoice`.
`DisplayCid`	boolean	required	Display CID number on bill, only applicable for `Invoice`.

Property	Type	Contract	Description
`Discriminator`	string Bill assignee data discriminator	required	Determines type of value.
`Value`	object	required	Structure of object depends on Bill assignee data discriminator.

Property	Type	Contract	Description
`ItalianFiscalCode`	string	optional	Italian fiscal code.

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.
`Bills`	array of Bill parameters	required, max 1000 items	Information about bills to be created.

Property	Type	Contract	Description
`AccountId`	string	required	Unique identifier of the account (for example Customer) the bill is issued to.

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

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.
`BillIds`	array of string	required	Unique identifiers of the Bills to be deleted.

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 closed.
`Type`	string Bill type	required	Specifies the mode bill should be closed in.
`BillCounterId`	string	optional	Unique identifier of the Counter to be used for closing. Default one is used when no value is provided.
`FiscalMachineId`	string	optional	Unique identifier of the Fiscal Machine to be used for closing. Default one is used when no value is provided.
`Options`	Bill options parameters	optional	Options of the bill. If not provided both `DisplayCustomer` and `DisplayTaxation` are set by default.
`TaxedDate`	String update value	optional	Date of consumption for tax purposes. Can be used only with Bill type `Invoice`.
`DueDate`	String update value	optional	Deadline when Bill is due to be paid. Can be used only with Bill type `Invoice`.
`VariableSymbol`	String update value	optional	Optional unique identifier of requested payment. Can be used only with Bill type `Invoice`.
`TaxIdentifier`	String update value	optional	Tax identifier of account to be put on a bill.
`Notes`	String update value	optional	Notes to be attached to bill.
`Address`	Address parameters	optional	Address of the account to be displayed on bill. Overrides the default one taken from account profile.

Property	Type	Contract	Description
`DisplayCustomer`	Bool update value	required	Display customer information on a bill.
`DisplayTaxation`	Bool update value	required	Display taxation detail on a bill.

Property	Type	Contract	Description
`Value`	string	optional	Value which is to be updated.

Property	Type	Contract	Description
`Value`	bool	optional	Value which is to be updated.

Property	Type	Contract	Description
`Bills`	array of Bill	required	The closed bill.

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	Unique identifier of the Bill print event returned by previous invocation.

Property	Type	Contract	Description
`BillId`	string	required	The unique identifier of printed Bill.
`Result`	object Bill PDF result	required	The result of operation.

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

Property	Type	Contract	Description
`Base64Data`	string	required	BASE64 encoded PDF file.

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

Availability blocks

Business segments

Last modified 4mo ago