Bulk Add Invoices

Production

https://{{subdomain}}.daftra.com/api2

POST

/invoices/add_bulk.json

Creates multiple invoices in a single request. The request body is a JSON array; each element has the exact same shape as the body of Add New Invoice (an object with an Invoice member plus optional InvoiceItem, Payment, etc.).

Invoices are created one by one and the operation is not atomic — if one element fails validation the others are still created. The response is a JSON array with one result object per submitted invoice, in the same order as the request. A successful element carries the new invoice id and number; a failed element carries an error result with a message, so you must inspect each element to confirm it succeeded.

Per-element fields and defaulting behaviour are identical to Add New Invoice — see that endpoint for the full field reference.

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Query Params

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢200Success

application/json

Bodyapplication/json

Request Example

Shell

JavaScript

Java

Swift

curl --location --globoff 'https://.daftra.com/api2/invoices/add_bulk.json?send=&client_id=&terminal_id=' \
--header 'Accept: application/json' \
--header 'apikey: ' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '[
  {
    "Invoice": {
      "client_id": 7,
      "staff_id": 1,
      "branch_id": 1,
      "client_email": "test@test.tesdttt",
      "store_id": 1,
      "type": 0,
      "currency_code": "USD",
      "date": "2026-06-17",
      "draft": false,
      "discount": 0,
      "discount_amount": 0,
      "deposit": 0,
      "notes": "Thanks for your business"
    },
    "InvoiceItem": [
      {
        "item": "Consulting service",
        "description": "Monthly retainer",
        "unit_price": 100.0,
        "quantity": 2,
        "tax1": null,
        "tax2": null,
        "product_id": 3,
        "discount": 0,
        "discount_type": 2,
        "store_id": 0,
        "lot": [],
        "expiry_date": [],
        "serials": []
      }
    ],
    "Payment": [
      {
        "payment_method": "cash",
        "amount": 200.0
      }
    ],
    "InvoiceCustomField": {},
    "Deposit": {},
    "InvoiceReminder": {},
    "Document": {},
    "DocumentTitle": {}
  },
  {
    "Invoice": {
      "client_id": 6,
      "client_email": "test@test.tesdttt",
      "staff_id": 1,
      "branch_id": 1,
      "store_id": 1,
      "type": 0,
      "currency_code": "USD",
      "date": "2026-06-17",
      "draft": false,
      "discount": 0,
      "discount_amount": 0,
      "deposit": 0,
      "notes": "Thanks for your business"
    },
    "InvoiceItem": [
      {
        "item": "Consulting service",
        "description": "Monthly retainer",
        "unit_price": 100.0,
        "quantity": 2,
        "tax1": null,
        "tax2": null,
        "product_id": 2,
        "discount": 0,
        "discount_type": 2,
        "store_id": 0,
        "lot": [],
        "expiry_date": [],
        "serials": []
      }
    ],
    "Payment": [
      {
        "payment_method": "cash",
        "amount": 200.0
      }
    ],
    "InvoiceCustomField": {},
    "Deposit": {},
    "InvoiceReminder": {},
    "Document": {},
    "DocumentTitle": {}
  }
]'

Response Example

[
    {
        "result": "successful",
        "code": 202,
        "id": 2415,
        "invoice_number": "0700000AAAAA0001",
        "invoice_pos_html": "string"
    }
]

Add New Invoice

Edit Invoices