Browse Documentation
- Report
- Overview
- Organizations
- GET Get Organisation
- POST Update Organisation
- Invoices
- POST Create Invoice
- GET Get Invoice
- PUT Update Invoice
- DELETE Delete Invoice
- POST Approve Invoice
- POST Add Attachment
- DELETE Delete Attachment from Invoice
- POST Send Invoice
- POST Pay Invoice
- Purchases
- POST Create Purchase
- GET Get Purchase
- PUT Update Purchase
- DELETE Delete Purchase
- POST Approve Purchase
- POST Add Attachment to Purchase
- DELETE Delete Attachment from Purchase
- POST Pay Purchase
- Pos sales
- GET Get POS Sales
- POST Create POS Sale
- PUT Update POS Sale
- DELETE Delete POS Sale
- POST Add POSSales Payment
- Offers
- POST Create Offer
- GET Get Offer
- PUT Update Offer
- DELETE Delete Offer
- POST Add Attachment to Offer
- DELETE Delete Attachment from Offer
- POST Send Offer
- POST Convert to Invoice
- Items
- POST Create Item
- GET Get Item
- POST Update Item
- POST Add Item Picture
- DELETE Delete Item Picture
- Item categories
- Contacts
- POST Create Contact
- GET Get Contact
- PUT Update Contact
- Account types
- GET Account Types
- Accounts
- POST Create Account
- GET Get Account
- Financial accounts
- Taxes
- POST Create Tax
- GET Get Tax
- Invoice template
- GET Get Template
- POST Update Invoice Template
- POST Upload Template Logo
- POST Create New Invoice Template
- DELETE Delete Invoice Temaplate
- Inbox
- POST Upload Attachment
- GET Get Attachments
- DELETE Delete Attachment
- Payments
- DELETE Delete Payment
- Journals
- GET Get journals
- Banks
- GET List banks
- Team
- POST Create Team Member
- GET List Team Members
- DELETE Remove Team Members
POST Create purchase
Create a new Purchase
POST
/purchases
To create purchases you will need an access token, for questions regarding how to obtain an access token click on this link.
Parameters
Parameter | Type | Description |
supplier_id | required | String | The supplier you are sending the purchase to |
issued_date | required | Date YYYY-MM-DD | The date the invoice was issued |
due_date | required | Date YYYY-MM-DD | The expiration date of the purchase |
reference | String | Any name that you wish to use as a reference |
remarks | String | Remarks |
Items | required | Array[object] | Items to be added to the invoice |
items[title] | required | String | Item title |
items[description] | String | Description of the item |
items[quantity] | required | Int | Item Quantity |
items[price] | required | Float|Int | Item Price |
items[tax_id] | required | String | Item Tax ID |
items[include_tax] | required | Int | Enter 1 if you want the tax to be included and 0 if the tax to be excluded |
items[gl_account] | required | String | The account to charge the item |
A POST request is expected to be sent to the above endpoint where the content body must be JSON string containing all parameters that are needed to create a new invoice. The below example demonstrates how to create a new Purchase.
- curl -s -H "Content-Type: application/json" -H "Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOixMiJ9.eyJleHAiOjE1MDM4NDQzMzIsIm5iZiI6MTQ4ODIwOTUzMiwiaWF0IjoxNDg4MjA5NTMyLCJidXNpbmVzcyI6NjIsInVzZXIiOjEwLCJjbGllbnQiOjJ9.kTVtfmMLOEBsBxKSeJupQ2RP0wo6kPyqWFxQvcuU5nk7hRKlw-mcurK0IlMXrWxa8ktab0Yquc5j9s1w" \
- -XPOST \
- -d '{
- "purchase":{
- "supplier_id":"1b908f34bbe258f96ab6932ca832a2a4dee09c73",
- "issued_date":"2016-09-25",
- "due_date":"2016-09-28",
- "reference":"Slimzy",
- "remarks":"Satisfactory",
- "items":[
- {
- "title":"Macmillan Advanced Mathematics",
- "description":"Mathematics textbook",
- "quantity":1,
- "price":3500,
- "tax_id":"ec8fedb21ef20208ebf708d83c3de936327f98ee",
- "include_tax":0,
- "gl_account": "372ac9a718661f26d34ba886d739d0dcbdfd0de6"
- },
- {
- "title":"Oxford Mathematical set",
- "description":"School accessories",
- "quantity":2,
- "price":900,
- "tax_id":"be8b5a387dbdfb42c7b897dd4b032019163a088f",
- "include_tax":0,
- "gl_account": "372ac9a718661f26d34ba886d739d0dcbdfd0de6"
- }
- ]
- }
- }' \
- https://app.accounteer.com/api/v0.1/purchases
Response
{ "data": [ { "id": "162126addae2d39873058fcb7a619b96ecd5e704", "organization_id": "520e391aa7e3bceccc5e2a9729fe0c60404140dc", "supplier_id": "b4df480b298db729344e27d0bc8f236b294e18df", "total_amount": 3675, "total_base_amount": 3500, "total_tax_amount": 175, "currency": "EUR", "issued_date": "2017-05-28", "due_date": "2017-05-29", "status": "DRAFT", "reference": "Temitope", "items": [ { "title": "Okeke Physics TextBook", "description": "Okeke Physics", "quantity": 1, "item_base_amount": 1500, "tax_id": 1b908f34bbe258f96ab6932ca832a2a4dee09c73, "tax_name": "5%", "tax_percentage": 5, "account_id": "53fa00e35def06ef89003af73ab0379c809d4b11", "gl_account": "2150 Holding account", "line_base_amount": 1500, "line_tax_amount": 75, "line_total_amount": 1575 }, { "title": "Macmillian Mathematics", "description": "Mathematics", "quantity": 2, "item_base_amount": 2000, "tax_id": 1b908f34bbe258f96ab6932ca832a2a4dee09c73, "tax_name": "5%", "tax_percentage": 5, "account_id": "53fa00e35def06ef89003af73ab0379c809d4b11", "gl_account": "2150 Holding account", "line_base_amount": 2000, "line_tax_amount": 100, "line_total_amount": 2100 }] } ] }