Daftra API
DocsAll EndpointsDaftra Partners
DocsAll EndpointsDaftra Partners
  1. Purchase Invoices
  • Welcome
  • Getting Started
  • Authorization
  • All Endpoints
    • Auth
      • Generate Access Token
    • Invoices
      • GET All Invoices
      • GET Single Invoice
      • Edit Invoices
      • Delete Invoices
      • Add New Invoice
    • Estimates
      • GET All Estimates
      • GET Single Estimate
      • Edit Estimates
      • Delete Estimates
      • Add New Estimate
    • Credit Notes
      • GET All Credit Notes
      • GET Single Credit Note
      • Edit Credit Notes
      • Delete Credit Notes
      • Add New Credit Note
    • Refund Receipts
      • GET All Refund Receipts
      • GET Single Refund Receipt
      • Edit Refund Receipts
      • Delete Refund Receipts
      • Add New Refund Receipt
    • Clients
      • GET All Clients
      • GET Single Client
      • Edit Clients
      • Delete Clients
      • Add New Client
    • Suppliers
      • GET All Suppliers
      • GET Single Supplier
      • Edit Suppliers
      • Delete Suppliers
      • Add New Supplier
    • Work Orders
      • GET Single Work Order
      • Edit Work Orders
      • Delete Work Orders
      • GET All Work Orders
      • Add New Work Order
    • Client Appointments
      • GET All Client Appointments
      • GET Single Client Appointment
      • Edit Client Appointments
      • Delete Client Appointments
      • Add New Client Appointment
    • Invoice Appointments
      • GET All Invoice Appointments
      • GET Single Invoice Appointment
      • Edit Invoice Appointments
      • Delete Invoice Appointments
      • Add New Invoice Appointment
    • Estimate Appointments
      • GET All Estimate Appointments
      • GET Single Estimate Appointment
      • Edit Estimate Appointments
      • Delete Estimate Appointments
      • Add New Estimate Appointment
    • Work Order Appointments
      • GET All Work Order Appointments
      • GET Single Work Order Appointment
      • Edit Work Order Appointments
      • Delete Work Order Appointments
      • Add New Work Order Appointment
    • Notes
      • GET All Notes
      • GET Single Note
      • Edit Notes
      • Delete Notes
      • Add New Note
    • Time Tracking
      • GET All Time Tracking
      • GET Single Time Tracking
      • Edit Time Tracking
      • Delete Time Tracking
      • Add New Time Tracking
    • Invoice Payments
      • GET All Invoice Payments
      • GET Single Invoice Payment
      • Edit Invoice Payments
      • Delete Invoice Payments
      • Add New Invoice Payment
    • Client Payments
      • GET All Client Payments
      • GET Single Client Payment
      • Edit Client Payments
      • Delete Client Payments
      • Add New Client Payment
    • Products
      • GET All Products
      • GET Single Product
      • Edit Products
      • Delete Products
      • Add New Product
    • Journals
      • GET All Journals
      • GET Single Journal
      • Edit Journals
      • Delete Journals
      • Add New Journal
    • Journal Accounts
      • GET All Journal Accounts
      • GET Single Journal Account
      • Edit Journal Accounts
      • Delete Journal Accounts
      • Add New Journal Account
    • Journal Cats
      • GET All Journal Cats
      • GET Single Journal Cat
      • Edit Journal Cats
      • Delete Journal Cats
      • Add New Journal Cat
    • Expenses
      • GET All Expenses
      • GET Single Expens
      • Edit Expenses
      • Delete Expenses
      • Add New Expens
    • Incomes
      • GET All Incomes
      • GET Single Income
      • Edit Incomes
      • Delete Incomes
      • Add New Income
    • Taxes
      • GET All Taxes
      • GET Single Taxe
      • Edit Taxes
      • Delete Taxes
      • Add New Taxe
    • Purchase Invoices
      • GET All Purchase Invoices
        GET
      • GET Single Purchase Invoice
        GET
      • Edit Purchase Invoices
        PUT
      • Delete Purchase Invoices
        DELETE
      • Add New Purchase Invoice
        POST
    • Purchase Refunds
      • GET All Purchase Refunds
      • GET Single Purchase Refund
      • Edit Purchase Refunds
      • Delete Purchase Refunds
      • Add New Purchase Refund
    • Stock Transactions
      • GET All Stock Transactions
      • GET Single Stock Transaction
      • Edit Stock Transactions
      • Delete Stock Transactions
      • Add New Stock Transaction
    • Stores
      • GET All Stores
      • GET Single Store
      • Edit Stores
      • Delete Stores
      • Add New Store
    • Treasuries
      • GET All Treasuries
      • GET Single Treasury
      • Edit Treasuries
      • Delete Treasuries
      • Add New Treasury
    • Product Categories
      • GET All Product Categories
      • GET Single Product Category
    • Staff
      • GET All Staff
      • GET Single Staff
    • Client-attendance-log
      • Add New Client-attendance-log
    • Follow Up Actions
      • GET All Follow Up Actions
      • GET Single Follow Up Action
      • Delete Follow Up Action
    • Follow Up Statuses
      • GET All Follow Up Statuses
      • GET Single Follow Up Status
      • Delete Follow Up Status
    • General Listing
      • GET General Listing
    • Site
      • GET Site Info
  1. Purchase Invoices

Edit Purchase Invoices

Production
https://{{subdomain}}.daftra.com/api2
Production
https://{{subdomain}}.daftra.com/api2
PUT
https://{{subdomain}}.daftra.com/api2
/purchase_invoices/{id}{format}
Purchase Invoices
Request Request Example
Shell
JavaScript
Java
Swift
curl --location -g --request PUT 'https://.daftra.com/api2/purchase_invoices/' \
--header 'Accept: application/json' \
--header 'apikey: ' \
--header 'Content-Type: application/json' \
--data-raw '{
    "PurchaseOrder": {
        "id": 98,
        "staff_id": 0,
        "no": "987",
        "supplier_id": 0,
        "is_offline": true,
        "currency_code": "USD",
        "supplier_business_name": "string",
        "supplier_first_name": "string",
        "supplier_last_name": "string",
        "supplier_email": "user@example.com",
        "supplier_address1": "string",
        "supplier_address2": "string",
        "supplier_postal_code": "string",
        "supplier_city": "string",
        "supplier_state": "string",
        "supplier_country_code": "str",
        "date": "2019-08-24",
        "draft": true,
        "Supplier_active_secondary_address": true,
        "Supplier_secondary_country_code": "string",
        "Supplier_secondary_name": "string",
        "Supplier_secondary_address1": "string",
        "Supplier_secondary_address2": "string",
        "Supplier_secondary_city": "string",
        "Supplier_secondary_state": "string",
        "Supplier_secondary_postal_code": "string",
        "is_received": true,
        "received_date": "2019-10-30 12:59:30"
    },
    "PurchaseOrderItem": [
        {
            "product_id": 0,
            "org_name": "string",
            "description": "string",
            "unit_price": 0,
            "quantity": 0,
            "tax1": 0,
            "tax2": 0,
            "purchase_order_id": 0,
            "item": "string",
            "col_3": null,
            "col_4": null,
            "col_5": null,
            "discount": 0,
            "discount_type": "1 => Percentage",
            "store_id": "The Purchase Order store id"
        }
    ]
}'
Response Response Example
200 - Example 1
{
    "code": 200,
    "result": "successful"
}

Request

Authorization
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
Path Params
id
string 
required
format
string 
required
Header Params
Accept
string 
optional
Default:
application/json
Content-Type
string 
optional
Default:
application/json
apikey
string 
deprecated
You can find/generate your apikey(s) from inside your Daftra Account
Default:
{{apikey}}
Body Params application/json
PurchaseOrder
object 
PurchaseOrderBase
optional
id
integer <int64>
optional
Unique Identifier
Example:
98
staff_id
integer <int32>
optional
Staff user submitting the request
no
string 
optional
Purchase invoice user identifier
<= 255 characters
Example:
987
supplier_id
integer <int64>
optional
Supplier REF#, you can get it through the Suppliers API
is_offline
boolean 
optional
0 : if it is an online order / 1 : if it is an offline order
currency_code
string 
optional
3 Digit currency code following ISO 4217 standard
<= 3 characters
Example:
USD
supplier_business_name
string 
optional
Supplier business name
<= 255 characters
supplier_first_name
string 
optional
Supplier first name
<= 255 characters
supplier_last_name
string 
optional
Supplier last name
<= 255 characters
supplier_email
string <email>
optional
Supplier email
<= 255 characters
supplier_address1
string 
optional
Supplier address line 1
<= 255 characters
supplier_address2
string 
optional
Supplier address line 2
<= 255 characters
supplier_postal_code
string 
optional
Supplier postal code
<= 10 characters
supplier_city
string 
optional
Supplier City
<= 100 characters
supplier_state
string 
optional
Supplier State
<= 100 characters
supplier_country_code
string 
optional
Supplier Country code
<= 3 characters
date
string <date>
optional
Date of the purchase invoice
draft
boolean 
optional
1 : if it is only a draft and doesn't affect the stock, 0 : not a draft and will affect the stock
Supplier_active_secondary_address
boolean 
optional
Supplier_secondary_country_code
string 
optional
Supplier 2 country code
<= 255 characters
Supplier_secondary_name
string 
optional
Supplier 2 name
<= 255 characters
Supplier_secondary_address1
string 
optional
Supplier 2 address line 1
<= 255 characters
Supplier_secondary_address2
string 
optional
Supplier 2 address line 2
<= 255 characters
Supplier_secondary_city
string 
optional
Supplier 2 City
<= 255 characters
Supplier_secondary_state
string 
optional
Supplier 2 State
<= 255 characters
Supplier_secondary_postal_code
string 
optional
Supplier 2 Postal code
<= 255 characters
is_received
boolean 
optional
0: the supplies are not received /1 the supplies are received
received_date
string <date-time>
optional
Date for when it was received
Example:
2019-10-30 12:59:30
PurchaseOrderItem
array [object {15}] 
optional
product_id
integer <int32>
optional
Product Ref #
org_name
string <>
optional
Name of the category that this item is following
description
string <>
optional
Description of the item
unit_price
number <double>
optional
Unit price of the item
quantity
integer <int32>
optional
Quantity of the item in the order
tax1
number <double>
optional
Tax 1 value applied on this item
tax2
number <double>
optional
Tax 2 value applied on this item
purchase_order_id
integer 
optional
Purchase Order Ref #
item
string 
optional
Name of the product
col_3
string  | null 
optional
additional data to be appear in the Purchase Order layout
Default:
null
col_4
string  | null 
optional
additional data to be appear in the Purchase Order layout
Default:
null
col_5
string  | null 
optional
additional data to be appear in the Purchase Order layout
Default:
null
discount
number <double>
optional
discount amount
discount_type
enum<integer> 
optional
discount type
Allowed values:
1 => Percentage2 => Absolute
store_id
integer <int64>
optional
The store which this item belongs to get it from GET STORE API if it's not set the Purchase Order store is used
Default:
The Purchase Order store id
Example:
0
Examples

Responses

🟢200OK
application/json
OK
Body
code
integer 
optional
Example:
200
result
string 
optional
Example:
successful
🟠400Bad Request
🟠401Unauthorized
🟠403Forbidden
🟠404Record Not Found
Previous
GET Single Purchase Invoice
Next
Delete Purchase Invoices