Create a receipt

post

https://api.billin.net/v1/invoices/sales-receipts

Endpoint to create a receipt

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

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.

Depending on where you have your tax domicile (Basque Country or the rest of Spain) you will have to send some data or others

serieId

string

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

serialCode

string

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

code

number

0 to 1000000000

Code/Number of the document

mask

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"

issuedDate

string

The date when the documen was issued

reference

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

comments

string

Comments of the document

currency

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

isPaid

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.

paidAmount

number

Paid amount

retentionAmount

number

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

retentionPercentage

number

Percentage of retention

showProductReference

boolean

Defaults to false

True if product reference should be shown in Pdf

operationDescription

string

length ≤ 250

The description of the operation

operationDate

string

The date of the operation

taxRegime

string

enum

length between 2 and 2

The tax regime of the operation

naturalPerson

boolean

(Bizkaia businesses) The counterparty is a natural person

epigraphIAE

string

enum

length ≤ 7

(Bizkaia businesses) IAE code in the Spanish Tax Office

chargingCriterionIRPF

boolean

(Bizkaia businesses) True if your business activity is covered by the system whereby you can compute income and expenses at the time the services or products are actually received or paid for, even if the accrual has occurred at another time.

customIRPF

number

(Bizkaia businesses). If IRPF computed is different from VAT Tax Base, it is mandatory to indicate the value of Amount income IRPF. Required if chargingCriterionIRPF is true.

lines

array of objects

required

length ≥ 1

Lines of the document

lines*

Responses

201

400

401