v2

latestOpenAPI 3.0.0Apache 2.02026-07-2638645559.8 KB

Purchases

Update a purchase

Update a purchase by id

post/apps/{appId}/purchases/{id}

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.

idinteger required

ID of purchase

Query parameters

account_idinteger

Auto-calculated by sales_lines total

supplier_organization_idinteger

titlestring

supplier_namestring

amountinteger

Auto-calculated by sales_lines total

amount_taxinteger

amount_reverse_taxinteger

currencystring

vat_detailobject

billed_atstring date

commentstring

{"stackTrail":"paths:/apps/{appId}/purchases/{id}: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

account_idinteger

amountinteger

author_user_idinteger nullable

Author id of the invoice

employee_user_idinteger nullable

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