Create an expense

Endpoint to create an expense

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
  • If you only send the lines field, Billin will calculate the totals. If, on the other hand, you want to send all the values so that Billin does not calculate anything, you must send the fields taxLines and total.

  • Province is mandatory for Spain country.

string

The id of the serie. If provided together with serialCode, the serieId will be used

string

Serial Code of the document. If provided together with serieId, the serieId will be used

visualLines
array of objects

Visual Lines of the document

visualLines
string

Comments of the document

string
enum
required

Currency used on the document

boolean
Defaults to false

True if the document is paid. In the case of sending this value to true, a payment will be created with the same date and for the total value of the document.

number

Amount of retention. If this property is set it will override retentionPercentage if it is also set

number

Percentage of retention

string
required
length ≤ 30

Invoice number

string
required

The date when the documen was issued

string

Due date of the document

lines
array of objects
required
length ≥ 1

Lines of the expense

lines*
taxLines
array of objects

Tax lines of the expense. If not provided, they will be calculated from the lines

taxLines
total
object

The total of the expense. If not provided, it will be calculated from the lines and tax lines

string
enum

Type of the document

contact
object
required

Contact of the document

Responses

Language
Credentials
Bearer
JWT
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json