Update an Invoice - Bookeeping.ai Docs

PATCH

invoices

{id}

Update an Invoice

curl --request PATCH \
  --url https://api.bookeeping.ai/public-api/v1/invoices/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "purchaseOrderId": "<string>",
  "discount": {},
  "invoiceDate": "2023-11-07T05:31:56Z",
  "dueDate": "2023-11-07T05:31:56Z",
  "lineItems": [
    {}
  ],
  "payViaStripeAccountConnectionId": "<string>",
  "note": "<string>",
  "counterParty": "<string>",
  "invoiceId": "<string>",
  "currency": "<string>"
}
'

{
  "message": "<string>",
  "metaData": {
    "warnings": [
      "<string>"
    ]
  },
  "data": {
    "_id": "<string>",
    "projectId": "<string>",
    "status": "DRAFT",
    "invoiceId": "<string>",
    "discount": {},
    "amount": 123,
    "invoiceDate": "2023-11-07T05:31:56Z",
    "dueDate": "2023-11-07T05:31:56Z",
    "currency": "<string>",
    "lineItems": [
      {}
    ],
    "note": "<string>",
    "calculated": {
      "grandTotal": 123,
      "tax": 123,
      "discount": 123,
      "subTotal": 123
    },
    "attachments": [
      "<string>"
    ],
    "createdAt": "2023-11-07T05:31:56Z",
    "updatedAt": "2023-11-07T05:31:56Z",
    "purchaseOrderId": "<string>",
    "counterParty": {
      "_id": "<string>",
      "accountName": "<string>",
      "accountNumber": "<string>",
      "email": "jsmith@example.com",
      "phone": "<string>",
      "type": "customer",
      "otherEmails": [
        "jsmith@example.com"
      ],
      "address": {}
    },
    "convertedAmount": 123,
    "convertedCurrency": "<string>",
    "sendDate": "2023-11-07T05:31:56Z",
    "sendBy": "<string>",
    "cancellationReason": "<string>",
    "cancellationDate": "2023-11-07T05:31:56Z",
    "cancellationBy": "<string>",
    "paidMarkedBy": "<string>",
    "paidMarkedDate": "2023-11-07T05:31:56Z",
    "attachedTransactionId": "<string>",
    "payViaStripeAccountConnectionId": "<string>"
  }
}

Authorizations

Authorization

string

header

required

API key for authentication. Get your key from the Dashboard > Settings > API Access.

Path Parameters

string

required

The id of the invoice. Expected to be a valid object id like 666666666666666666666666

Body

application/json

purchaseOrderId

string | null

discount

object

Global discount, after applying the line item discounts

invoiceDate

string<date-time>

The date of the invoice

dueDate

string<date-time>

The date of the due date

lineItems

object[]

The line items of the invoice

payViaStripeAccountConnectionId

string | null

The id of the pay via stripe account connection. Expected to be a valid object id like 666666666666666666666666

note

string

The notes of the invoice

counterParty

string

The id of the counterparty. Expected to be a valid object id like 666666666666666666666666

invoiceId

The id of the invoice or 'INCREMENTAL' to auto generate the invoice id

currency

string

Response

Update an Invoice executed successfully

message

string

Success message

metaData

object

Show child attributes

metaData.warnings

string[]

Any validation warnings

data

object

Show child attributes

data._id

string

required

The id of the invoice

data.projectId

string

required

The id of the project

data.status

enum<string>

required

The status of the invoice

Available options:

DRAFT,

SENT,

PAID,

OVERDUE,

CANCELLED

data.invoiceId

string

required

The number of the invoice eg. 0001, 0002, etc.

data.discount

object

required

Global discount, after applying the line item discounts

data.amount

number

required

The amount of the invoice

data.invoiceDate

string<date-time>

required

The date of the invoice

data.dueDate

string<date-time>

required

The date of the due date

data.currency

string

required

The currency of the invoice

data.lineItems

object[]

required

The line items of the invoice

data.note

string

required

The notes of the invoice

data.calculated

object

required

Show child attributes

data.calculated.grandTotal

number

required

The grand total of the invoice

data.calculated.tax

number

required

The tax of the invoice

data.calculated.discount

number

required

The discount of the invoice

data.calculated.subTotal

number

required

The sub total of the invoice

data.attachments

string[]

required

The attachments of the invoice

data.createdAt

string<date-time>

required

The date of the creation

data.updatedAt

string<date-time>

required

The date of the last update

data.purchaseOrderId

string | null

data.counterParty

object

Show child attributes

data.counterParty._id

string

required

The id of the counterparty

data.counterParty.accountName

string | null

data.counterParty.accountNumber

string | null

data.counterParty.email

string<email> | null

data.counterParty.phone

string | null

data.counterParty.type

enum<string> | null

Available options:

customer,

vendor,

both

data.counterParty.otherEmails

string<email>[] | null

data.counterParty.address

object

The address of the counterparty

data.convertedAmount

number | null

data.convertedCurrency

string | null

data.sendDate

string<date-time> | null

data.sendBy

string | null

data.cancellationReason

string | null

data.cancellationDate

string<date-time> | null

data.cancellationBy

string | null

data.paidMarkedBy

string | null

data.paidMarkedDate

string<date-time> | null

data.attachedTransactionId

string | null

data.payViaStripeAccountConnectionId

string | null

The id of the pay via stripe account connection. Expected to be a valid object id like 666666666666666666666666

Send an InvoiceOnly invoices in draft status can be sent.

⌘I

Update an Invoice

curl --request PATCH \
  --url https://api.bookeeping.ai/public-api/v1/invoices/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "purchaseOrderId": "<string>",
  "discount": {},
  "invoiceDate": "2023-11-07T05:31:56Z",
  "dueDate": "2023-11-07T05:31:56Z",
  "lineItems": [
    {}
  ],
  "payViaStripeAccountConnectionId": "<string>",
  "note": "<string>",
  "counterParty": "<string>",
  "invoiceId": "<string>",
  "currency": "<string>"
}
'

{
  "message": "<string>",
  "metaData": {
    "warnings": [
      "<string>"
    ]
  },
  "data": {
    "_id": "<string>",
    "projectId": "<string>",
    "status": "DRAFT",
    "invoiceId": "<string>",
    "discount": {},
    "amount": 123,
    "invoiceDate": "2023-11-07T05:31:56Z",
    "dueDate": "2023-11-07T05:31:56Z",
    "currency": "<string>",
    "lineItems": [
      {}
    ],
    "note": "<string>",
    "calculated": {
      "grandTotal": 123,
      "tax": 123,
      "discount": 123,
      "subTotal": 123
    },
    "attachments": [
      "<string>"
    ],
    "createdAt": "2023-11-07T05:31:56Z",
    "updatedAt": "2023-11-07T05:31:56Z",
    "purchaseOrderId": "<string>",
    "counterParty": {
      "_id": "<string>",
      "accountName": "<string>",
      "accountNumber": "<string>",
      "email": "jsmith@example.com",
      "phone": "<string>",
      "type": "customer",
      "otherEmails": [
        "jsmith@example.com"
      ],
      "address": {}
    },
    "convertedAmount": 123,
    "convertedCurrency": "<string>",
    "sendDate": "2023-11-07T05:31:56Z",
    "sendBy": "<string>",
    "cancellationReason": "<string>",
    "cancellationDate": "2023-11-07T05:31:56Z",
    "cancellationBy": "<string>",
    "paidMarkedBy": "<string>",
    "paidMarkedDate": "2023-11-07T05:31:56Z",
    "attachedTransactionId": "<string>",
    "payViaStripeAccountConnectionId": "<string>"
  }
}

Routes

Authorizations

Path Parameters

Body

Response