A document sent to request payment for goods or services.
Example
{
"id": "a7298cb7-a0f2-46b7-9fa0-e0a75c91a0eb",
"companyName": "Palermo Consulting",
"companyStreetAddress": "123 Main St",
"number": "CN-0001",
"statusId": "applied",
"billTo": "Acme",
"creditNoteFor": "INV-0001",
"issuedOn": "2024-01-01",
"poNumber": "PO-123",
"notes": "Thank you for your business!",
"emailSubject": "Invoice",
"emails": ["[email protected]"],
"ccEmails": ["[email protected]"],
"emailBody": "Thank you for your business!",
"emailFromName": "Palermo Consulting",
"replyTo": "[email protected]",
"sendBcc": true,
"sentOn": "2022-12-31",
"currency": "USD",
"subtotal": 750,
"taxRate": 0.1,
"totalTax": 43.33,
"total": 693.33,
"appliedCredit": 693.33,
"remainingCredit": 0,
"createdAt": "2023-01-01T00:00:00.000Z",
"lines": [
{
"id": "49a97b8a-47f3-42fc-8ab2-7720782f117c",
"lineNumber": 1,
"item": "Income",
"description": "Software Development",
"quantity": 5,
"rate": 100,
"amount": 500,
"taxable": true,
"invoiceItem": {
"id": "ccba4f62-8ed8-4417-9677-df6999bc2358",
"name": "Income"
},
"project": {
"id": "faa719de-acfe-464c-b3b9-0cb4676bf1fb",
"name": "Company Website"
}
},
{
"id": "0fc82e24-d57f-4965-b332-29548e554bf6",
"lineNumber": 2,
"item": "Expense",
"description": "Expenses (per diem)",
"quantity": 5,
"rate": 50,
"amount": 250,
"taxable": false,
"invoiceItem": {
"id": "ebcb4544-d9e3-491f-a749-35e950aa692c",
"name": "Expense"
},
"project": null
}
],
"invoices": [
{
"id": "73ca355c-8c4d-4d21-936a-f776d6981911",
"number": "INV-0001",
"amount": 693.33
}
],
"client": {
"id": "27c4c542-5c87-4bc1-90a3-b67b40430be9",
"name": "Acme"
},
"projects": [
{
"id": "faa719de-acfe-464c-b3b9-0cb4676bf1fb",
"name": "Company Website"
}
]
}
Attributes
Name | Type | Description |
---|---|---|
id | uuid | The unique identifier for the object. |
companyName | string | Name of the company issuing the credit note. |
companyStreetAddress | string | Street address of the company issuing the credit note. |
number | string | Number assigned to the credit note. |
statusId | string | Status of the credit note. Can be either "draft" , "open" or "applied" . |
billTo | string | Name of the entity credited by the credit note. |
creditNoteFor | string | Description of the products or services being credited. |
issuedOn | date | Date when the credit note was issued. Will be in the form YYYY-MM-DD . |
poNumber | string | Purchase order number associated with the credit note. |
notes | string | Additional notes or messages included in the credit note. |
emailSubject | string | Subject line for the email containing the credit note. |
emails | array of strings | Array of comma-separated email addresses to which the credit note is sent. |
ccEmails | array of strings | Array of comma-separated email addresses to be cc'ed on the credit note email. |
emailBody | string | Body content of the email containing the credit note. |
emailFromName | string | Name displayed as the sender of the credit note email. |
replyTo | string | Email address to which replies to the credit note email are directed. |
sendBcc | string | Boolean indicating whether to send a blind carbon copy of the credit note email. |
sentOn | date | Date when the credit note email was sent. Will be in the form YYYY-MM-DD . |
currency | string | Currency in which the credit note is denominated. |
subtotal | number | Subtotal amount before taxes. |
taxRate | number | Tax rate applied to the credit note. |
totalTax | number | Total tax amount calculated for the credit note. |
total | number | Total amount due including taxes and discounts. |
appliedCredit | number | The amount of credit applied from the credit note towards invoices. |
remainingCredit | number | The remaining amount of credit available on the credit note after applying it towards invoices. |
createdAt | timestamp | The timestamp when the object was created. |
client | object | A simple object to the related client. See attributes. |
projects | array of objects | An array of related projects. See attributes. |
lines | array of objects | An array of the line items included in the credit note. See attributes. |
invoices | array of objects | An array of the invoices that this credit note is applied to. See attributes. |
Client attributes
Name | Type | Description |
---|---|---|
id | uuid | The unique identifier for the object. |
name | string | The name of the client. |
Project attributes
Name | Type | Description |
---|---|---|
id | uuid | The unique identifier for the object. |
name | string | The name of the project. |
Credit Note Line attributes
Name | Type | Description |
---|---|---|
id | uuid | The unique identifier for the object. |
lineNumber | number | Sequential number assigned to the line item within the credit note. |
item | string | Category or type of item being credited. This value is automatically set to the related invoice item's name when the credit note is published. |
details | string | Specific details or additional information about the item or service being credited. |
quantity | number | Quantity of the item or service being credited. |
rate | number | Unit price or rate for each unit of the item or service. |
amount | number | Total amount for the line item. |
taxable | boolean | Boolean indicating whether the line item is subject to taxation. |
invoiceItem | object | A simple object to the related invoice item. See attributes . |
project | object | A simple object to the related project. See attributes . |
## Invoice attributes
Name | Type | Description |
---|---|---|
id | uuid | The unique identifier for the object. |
number | string | Number assigned to the invoice. |
amount | number | The credit applied to the invoice. |