API Reference

Create a quote

post
https://api.billin.net/v1/quotes

Endpoint to create a quote

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.

  • There are two fields to send the serial number, either by filling in the serialCode field or the serialId field. In case of sending both, the serialId field has priority.

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

number
0 to 1000000000

Code/Number of the document

number
0 to 1000000000

Mask used on the code of the document. The complete invoice identifier number is built from the serial code and the code. For example, for a serial code "F2023" and a code "1" the full identifier number that will appear in the PDF will be "F20231". The mask allows for leading zeros to be included when constructing the complete ID number in the PDF. If we put a mask of 3, the full ID number will be "F2023001"

string

The date when the documen was issued

string

The reference of the document

visualLines
array of objects

Visual Lines of the document

visualLines
taxLines
array of objects

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

taxLines
string

Comments of the document

string
enum
required

Currency used on the document

total
object

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

number

Paid amount

number

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

number

Percentage of retention

boolean
Defaults to false

True if product reference should be shown in Pdf

lines
array of objects
required
length ≥ 1

Lines of the document

lines*
string

Due date of the quote

additionalExpenses
array of objects
Defaults to []

Additional expenses of the quote

additionalExpenses
string

The id of the template to use for the quote

contact
object
required

Contact of the quote

boolean

Check this if you want to show the lines without taxes in the PDF visualization in Billin's web app

string
enum
Defaults to PENDING

Status of the quote

Allowed:
Responses

Updated about 2 years ago

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

Updated about 2 years ago