Daftra API
DocsAll EndpointsDaftra Partners
DocsAll EndpointsDaftra Partners
  1. Invoices
  • Welcome
  • Getting Started
  • Authorization
  • All Endpoints
    • Auth
      • Generate Access Token
    • Invoices
      • GET All Invoices
        GET
      • GET Single Invoice
        GET
      • Edit Invoices
        PUT
      • Delete Invoices
        DELETE
      • Add New Invoice
        POST
    • 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 Single Purchase Invoice
      • Edit Purchase Invoices
      • Delete Purchase Invoices
      • Add New Purchase Invoice
    • 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. Invoices

Add New Invoice

Production
https://{{subdomain}}.daftra.com/api2
Production
https://{{subdomain}}.daftra.com/api2
POST
https://{{subdomain}}.daftra.com/api2
/invoices{format}
Invoices
Request Request Example
Shell
JavaScript
Java
Swift
curl --location -g --request POST 'https://.daftra.com/api2/invoices' \
--header 'Accept: application/json' \
--header 'apikey: ' \
--header 'Content-Type: application/json' \
--data-raw '{
    "Invoice": {
        "staff_id": 0,
        "subscription_id": 26,
        "store_id": 0,
        "no": "0700000AAAAA0001",
        "po_number": "26",
        "name": "Darrel Gusikowski-Koch",
        "client_id": 15,
        "is_offline": true,
        "currency_code": "USD",
        "client_business_name": "Example Client",
        "client_first_name": "Example",
        "client_last_name": "Client",
        "client_email": "client@example.com",
        "client_address1": "Florida West Damionworth Warren County 19902 Schmitt Wells Suite 780",
        "client_address2": "West Virginia South Sandrine Union County 681 Huels Branch Apt. 308",
        "client_postal_code": "29515-2869",
        "client_city": "Santiagocester",
        "client_state": "Vermont",
        "client_country_code": "EG",
        "date": "2018-11-07",
        "draft": false,
        "discount": 0,
        "discount_amount": 0,
        "deposit": 0,
        "deposit_type": 0,
        "notes": "fugiat Ut",
        "html_notes": "voluptate nulla",
        "invoice_layout_id": 1,
        "estimate_id": 0,
        "shipping_options": 2,
        "shipping_amount": null,
        "client_active_secondary_address": false,
        "client_secondary_name": "Steven Zulauf",
        "client_secondary_address1": "Wyoming Lake Leilani Franklin County 39823 Jefferson Street Suite 706",
        "client_secondary_address2": "Oregon Dibbertbury Hamilton County 8594 Clark Street Suite 780",
        "client_secondary_city": "North Shyanne",
        "client_secondary_state": "Florida",
        "client_secondary_postal_code": "00967",
        "client_secondary_country_code": "CC",
        "follow_up_status": -30408481,
        "work_order_id": null,
        "requisition_delivery_status": 2,
        "pos_shift_id": -19328427,
        "qr_code_url": "https://yoursite.daftra.com/qr/?d64=QVE1TmIyaGhiV1ZrSUVGemFISmhaZ0lJTVRFMU16WTJRMUlERkRJd01qSXRNVEF0TWpoVU1EQTZNREU2TVRWYUJBRXdCUUV3",
        "invoice_html_url": "https://yoursite.daftra.com/invoices/preview/2621?hash=c06543fe13bd4850b521733687c53259",
        "invoice_pdf_url": "https://yoursite.daftra.com/invoices/view/2621.pdf?hash=c06543fe13bd4850b521733687c53259"
    },
    "InvoiceItem": [
        {
            "invoice_id": -92943453,
            "item": "occaecat",
            "description": "Arto vesco sumptus cinis laudantium subito spoliatio admoveo. Vulticulus cruciamentum eveniet denuo tabgo. Usitas ultio vinum alius teres adfectus confero utilis.",
            "unit_price": 77.59,
            "quantity": 98,
            "tax1": -84040263,
            "tax2": -75708308,
            "product_id": 46741121,
            "col_3": null,
            "col_4": null,
            "col_5": null,
            "discount": -43164040.5194853,
            "discount_type": 2,
            "store_id": 0
        }
    ],
    "Payment": [
        {
            "payment_method": "ad elit Ut dolor adipisicing",
            "amount": 561.89,
            "transaction_id": "payment",
            "treasury_id": -16127808,
            "date": "2025-03-24 21:22:32",
            "staff_id": -86060770
        },
        {
            "payment_method": "ad elit Ut dolor adipisicing",
            "amount": 561.89,
            "transaction_id": "payment",
            "treasury_id": -16127808,
            "date": "2025-03-24 21:22:32",
            "staff_id": -86060770
        }
    ],
    "InvoiceCustomField": {},
    "Deposit": {},
    "InvoiceReminder": {},
    "Document": {},
    "DocumentTitle": {}
}'
Response Response Example
202 - Example 1
{
    "code": 202,
    "result": "successful",
    "id": "2415"
}

Request

Authorization
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
Path Params
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
object 
optional
Invoice
object 
optional
object (InvoiceItemRef) 
optional
InvoiceItem
array [object {14}] 
optional
object (PaymentRef) 
optional
Payment
array[object (SamplePaymentBase) {6}] 
optional
object (InvoiceCustomField) 
optional
InvoiceCustomField
object 
optional
object (Deposit) 
optional
Deposit
object 
optional
object (InvoiceReminder) 
optional
InvoiceReminder
object 
optional
object (Document) 
optional
Document
object 
optional
object (DocumentTitle) 
optional
DocumentTitle
object 
optional
Invoice
object 
required
staff_id
integer 
required
subscription_id
integer 
required
store_id
integer 
required
no
string 
required
po_number
string 
required
name
string 
required
client_id
integer 
required
is_offline
boolean 
required
currency_code
string 
required
client_business_name
string 
required
client_first_name
string 
required
client_last_name
string 
required
client_email
string 
required
client_address1
string 
required
client_address2
string 
required
client_postal_code
string 
required
client_city
string 
required
client_state
string 
required
client_country_code
string 
required
date
string 
required
draft
boolean 
required
discount
integer 
required
discount_amount
integer 
required
deposit
integer 
required
deposit_type
integer 
required
notes
string 
required
html_notes
string 
required
invoice_layout_id
integer 
required
estimate_id
integer 
required
shipping_options
integer 
required
shipping_amount
null 
required
client_active_secondary_address
boolean 
required
client_secondary_name
string 
required
client_secondary_address1
string 
required
client_secondary_address2
string 
required
client_secondary_city
string 
required
client_secondary_state
string 
required
client_secondary_postal_code
string 
required
client_secondary_country_code
string 
required
follow_up_status
integer 
required
work_order_id
null 
required
requisition_delivery_status
integer 
required
pos_shift_id
integer 
required
qr_code_url
string 
required
invoice_html_url
string 
required
invoice_pdf_url
string 
required
InvoiceItem
array [object {14}] 
required
invoice_id
integer 
optional
item
string 
optional
description
string 
optional
unit_price
number 
optional
quantity
integer 
optional
tax1
integer 
optional
tax2
integer 
optional
product_id
integer 
optional
col_3
null 
optional
col_4
null 
optional
col_5
null 
optional
discount
number 
optional
discount_type
integer 
optional
store_id
integer 
optional
Payment
array [object {6}] 
required
payment_method
string 
required
amount
number 
required
transaction_id
string 
required
treasury_id
integer 
required
date
string 
required
staff_id
integer 
required
InvoiceCustomField
object 
required
Deposit
object 
required
InvoiceReminder
object 
required
Document
object 
required
DocumentTitle
object 
required
Examples

Responses

🟢202Accepted
application/json
Created
Body
code
integer 
optional
Example:
202
result
string 
optional
Example:
successful
id
integer 
optional
Example:
2415
🟠400Bad Request
🟠401Unauthorized
🟠403Forbidden
🟠404Record Not Found
Previous
Delete Invoices
Next
GET All Estimates