Update Invoice

PATCH

https://api.coperniq.io/v1/invoices/:invoice_id

PATCH

/v1/invoices/:invoice_id

1 const url = 'https://api.coperniq.io/v1/invoices/1';
2 const options = {
3   method: 'PATCH',
4   headers: {'x-api-key': '<apiKey>', 'Content-Type': 'application/json'},
5   body: '{}'
6 };
7 
8 try {
9   const response = await fetch(url, options);
10   const data = await response.json();
11   console.log(data);
12 } catch (error) {
13   console.error(error);
14 }

1 {
2   "id": 1,
3   "invoiceNumber": 1,
4   "status": "DRAFT",
5   "amount": 1.1,
6   "amountPaid": 1.1,
7   "calculationMethod": "string",
8   "createdAt": "2024-01-15T09:30:00Z",
9   "updatedAt": "2024-01-15T09:30:00Z",
10   "description": "string",
11   "basedOnId": 1,
12   "basedOnUid": 1,
13   "dueDate": "2024-01-15T09:30:00Z",
14   "isArchived": true,
15   "sharedWithPortal": true,
16   "percentage": 1.1,
17   "baseAmount": 1.1,
18   "account": {
19     "id": 1,
20     "title": "string"
21   },
22   "record": {
23     "id": 1,
24     "uid": 1,
25     "title": "string"
26   },
27   "lineItems": [
28     {
29       "id": 1,
30       "catalogItemId": 1,
31       "quantity": 1,
32       "unitCost": 1.1,
33       "unitPrice": 1.1,
34       "description": "string",
35       "catalogItem": {
36         "id": 1,
37         "name": "string",
38         "manufacturer": "string",
39         "sku": "string",
40         "type": "PRODUCT"
41       }
42     }
43   ]
44 }

Update an existing invoice. Supports partial updates.

Updatable fields:

calculationMethod: Must be “LINE_ITEMS” or “PERCENTAGE”
lineItems: Array of line items if calculationMethod is “LINE_ITEMS”
percentage: Percentage if calculationMethod is “PERCENTAGE”
dueDate: ISO 8601 datetime string
description: Invoice description

Update an existing invoice. Supports partial updates. Updatable fields: - `calculationMethod`: Must be "LINE_ITEMS" or "PERCENTAGE" - `lineItems`: Array of line items if calculationMethod is "LINE_ITEMS" - `percentage`: Percentage if calculationMethod is "PERCENTAGE" - `dueDate`: ISO 8601 datetime string - `description`: Invoice description

Authentication

x-api-keystring

API Key authentication via header

Path parameters

invoice_idintegerRequired

Invoice identifier

Request

This endpoint expects an object.

statusenumOptional

Invoice status

lineItemslist of objectsOptional

Flat array of line items (LINE_ITEMS only). May be combined with sections (a catalogItemId may appear only once across both).

sectionslist of objectsOptional

Grouped line items with named sections (LINE_ITEMS only). May be combined with lineItems (ungrouped items).

dueDatestringOptionalformat: "date-time"

Due date (ISO 8601 datetime string)

descriptionstring or nullOptional

Invoice description

Response

Invoice updated successfully

idinteger

Invoice identifier

invoiceNumberinteger

Unique invoice number

statusenum

Invoice status

amountdouble

Total invoice amount

amountPaiddouble

Amount paid

calculationMethodstring

Calculation method (e.g., LINE_ITEMS)

createdAtstringformat: "date-time"

Creation timestamp

updatedAtstringformat: "date-time"

Last update timestamp

descriptionstring or nullOptional

Invoice description

basedOnIdinteger or nullOptional

ID of the record this invoice is based on

basedOnUidinteger or nullOptional

UID of the record this invoice is based on

dueDatestringOptionalformat: "date-time"

Due date

isArchivedbooleanOptional

Whether the invoice is archived

sharedWithPortalbooleanOptional

Whether the invoice is shared with portal

percentagedouble or nullOptional

Percentage if applicable

baseAmountdouble or nullOptional

Base amount if applicable

accountobject or nullOptional

recordobject or nullOptional

lineItemslist of objectsOptional

Errors

400

Bad Request Error

401

Unauthorized Error

404

Not Found Error