Create a purchase

post

https://api.piriod.com/purchases/

This endpoint creates a Purchase for a given supplier with status draft. After creating the Purchase, use the finalize resource to complete the issuance process.

Body Params

date

required

Closing date of this purchase

discount

float

Defaults to 0

A positive number representing the amount or percentage of the discount

discount_scheme

string

enum

Defaults to %

Can be $ or %. $ apply amount as discount. % apply percentage as discount.

Allowed:

document

string

required

The ID of the document type this subscription should create.

due_date

date

The deadline for the purchase.

lines

array of objects

required

List of Purchase Line objects which represents the items for which this purchase is being charged.

lines*

note

string

A simple text with a 100 characters as max length.

metadata

json

A freely usable key/value object. Useful for storing custom information.

number

int32

Defaults to 0

The specific number for this Purchase. If left at 0, the number will be automatically assigned according to the sequence.

supplier

string

required

ID of related Supplier object.

tax_settings

object

Fields used to define tax aspects specific to the different electronic invoicing regulations of each country.

test_mode

boolean

Defaults to false

Determines whether the Purchase is for test use or not

Responses

200200

400400