v2

latestOpenAPI 3.0.0Apache 2.02026-07-2638645559.8 KB

Purchases

Create a purchase

Create a new purchase with an Organization. Relationship store notes, metadata and accounting settings parameters

post/apps/{appId}/purchases

Path parameters

appIdinteger required

The identifier of the Sinao application you are using. Each application corresponds to a company and an accounting. A user can have several Sinao applications. To retrieve the identifiers of its applications, you must call the endpoint /apps.

Query parameters

invoicestring binary

Invoice or receipt file (pdf or image)

account_idinteger

supplier_organization_idinteger

titlestring

supplier_namestring

amountinteger

amount_taxinteger

amount_reverse_taxinteger

currencystring

vat_detailobject

billed_atstring date

commentinteger

{"stackTrail":"paths:/apps/{appId}/purchases:post:parameters:13:schema:items","oasType":"schema","type":"unknown"}

vat_repayment'payment' | 'billing'

payment_deadline_atstring date nullable

expected_payment_deadline_atstring date nullable

payment_account_numberstring nullable

payment_routing_numberstring nullable

payment_swiftstring nullable

payment_ibanstring nullable

amortization_periodinteger nullable

author_user_idinteger nullable

completed_atstring date nullable

employee_idinteger nullable

Account Employee id of the purchase

employee_namestring nullable

Employee id of the purchase

mileage_allowance_idinteger nullable

mileage allowance id of the purchase

is_expense_reportboolean

Response

Success

idinteger

status'new' | 'completed' | 'paid'

titlestring

Name visible on the accounting entries of the purchase

supplier_namestring

amountinteger

Amount without taxes in cents

amount_taxinteger

Amount of taxes in cents

amount_reverse_taxinteger

Reverse charge amount - Intra-community VAT (amount_tax must be 0)

amount_net_foreign_currencyinteger

Amount without taxes in cents

foreign_currencystring

Amount of taxes in cents

vat_detailobject

VAT breakdown

commentstring

free field

picturestring

Purchase picture

tagsstring[]

vat_repayment'payment' | 'billing'

In France, depending on the type of purchase (product or service), VAT is not payable at the same time. VAT on products is due on the date of the invoice, while VAT on services is due on the date of payment thereof

md5string

Md5 hash of the initial file sent

billed_atstring date-time

Date of invoice

completed_atstring date-time

Date on which the account, supplier, amount and billed_at fields were completed

accounted_atstring date-time

Date on which the accounting entries were generated

paid_atstring date-time

Date on which the invoice was fully paid

payment_deadline_atstring date-time

Payment deadline

expected_payment_deadline_atstring date-time

Payment deadline

payment_account_numberstring

Payment Account number

payment_routing_numberstring

Payment Routing number

payment_swiftstring

Payment SWIFT

payment_ibanstring

Payment IBAN

is_lateboolean

The payment deadline has passed and full payment has not been received

will_be_late_atstring date-time

Date the payment will be late. Is false if payment has been made