Create Invoice | Coperniq API

Create a new invoice.

Required fields:

recordId: Project or account ID (the record must exist first)
calculationMethod: Must be “LINE_ITEMS” or “PERCENTAGE”

Conditionally required:

lineItems: Required when calculationMethod is “LINE_ITEMS” (at least one item)
percentage: Required when calculationMethod is “PERCENTAGE”

Optional fields:

issueDate: ISO 8601 datetime string
dueDate: ISO 8601 datetime string
status: Initial invoice status (defaults to DRAFT)
description: Invoice description

Create a new invoice. Required fields: - `recordId`: Project or account ID (the record must exist first) - `calculationMethod`: Must be "LINE_ITEMS" or "PERCENTAGE" Conditionally required: - `lineItems`: Required when `calculationMethod` is "LINE_ITEMS" (at least one item) - `percentage`: Required when `calculationMethod` is "PERCENTAGE" Optional fields: - `issueDate`: ISO 8601 datetime string - `dueDate`: ISO 8601 datetime string - `status`: Initial invoice status (defaults to DRAFT) - `description`: Invoice description

Authentication

x-api-keystring

API Key authentication via header

Request

This endpoint expects an object.

recordIdintegerRequired>=1

Project or account ID

calculationMethodenumRequired

Calculation method

Allowed values:

lineItemslist of objectsOptional

Required when calculationMethod is LINE_ITEMS. Array of line items (at least one required).

percentagedoubleOptional>=0

Required when calculationMethod is PERCENTAGE.

statusenumOptional

Initial invoice status (defaults to DRAFT)

issueDatestringOptionalformat: "date-time"

Issue date (ISO 8601 datetime string)

dueDatestringOptionalformat: "date-time"

Due date (ISO 8601 datetime string)

descriptionstring or nullOptional

Invoice description

Response

Invoice created successfully

idinteger

Invoice identifier

uidinteger

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 null

Invoice description

typeenum or null

Invoice type

Allowed values:

basedOnIdinteger or null

ID of the record this invoice is based on

basedOnUidinteger or null

UID of the record this invoice is based on

dueDatestringformat: "date-time"

Due date

isArchivedboolean

Whether the invoice is archived

sharedWithPortalboolean

Whether the invoice is shared with portal

percentagedouble or null

Percentage if applicable

baseAmountdouble or null

Base amount if applicable

accountobject or null

recordobject or null

lineItemslist of objects

Errors

400

Bad Request Error

401

Unauthorized Error

1	const url = 'https://api.coperniq.io/v1/invoices';
2	const options = {
3	method: 'POST',
4	headers: {'x-api-key': '<apiKey>', 'Content-Type': 'application/json'},
5	body: '{"recordId":1,"calculationMethod":"LINE_ITEMS"}'
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	"uid": 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	"type": "INVOICE",
12	"basedOnId": 1,
13	"basedOnUid": 1,
14	"dueDate": "2024-01-15T09:30:00Z",
15	"isArchived": true,
16	"sharedWithPortal": true,
17	"percentage": 1.1,
18	"baseAmount": 1.1,
19	"account": {
20	"id": 1,
21	"title": "string"
22	},
23	"record": {
24	"id": 1,
25	"uid": 1,
26	"title": "string"
27	},
28	"lineItems": [
29	{
30	"id": 1,
31	"catalogItemId": 1,
32	"quantity": 1,
33	"unitCost": 1.1,
34	"unitPrice": 1.1,
35	"description": "string",
36	"catalogItem": {
37	"id": 1,
38	"name": "string",
39	"manufacturer": "string",
40	"sku": "string",
41	"type": "PRODUCT"
42	}
43	}
44	]
45	}