The invoice object contains information such as their currency, invoiceNumber, issueDate, etc.
{
id: "00000000-0000-0000-0000-00000000",
remoteId: "361",
customerId: "593409c0-0ee3-4de2-92ef-48f69c0935e5",
invoiceNumber: "1117",
issueDate: "2023-10-10",
dueDate: "2023-10-10",
paidOnDate: null,
memo: null,
companyId: null,
currency: "USD",
exchangeRate: 1,
totalDiscount: null,
subTotal: null,
invoiceStatus: null,
totalTaxAmount: null,
totalAmount: 100,
balance: 100,
trackingCategories: [],
lineItems: [
{
totalAmount: 100,
accountingItemId: "5009dc24-ffcd-460c-a2c9-71e61814b80c",
remoteId: "1"
},
{
totalAmount: 100
}
],
purchaseOrders: [],
remoteCreatedAt: "2023-11-19T17:00:17.000Z",
remoteUpdatedAt: "2023-11-19T17:00:17.000Z",
remoteDeleted: false,
createdAt: "2024-02-22T11:17:53.264Z",
updatedAt: "2024-02-22T13:54:03.445Z"
}
Properties
id
String
The Alloy-generated unique ID
remoteId
String
The ID of the object in the third-party application.
customerId
String
The ID of the customer associated with the invoice.
invoiceNumber
String
A unique number or code assigned to the invoice for easy reference.
issueDate
Date
The date when the invoice was generated and sent to the customer. Format: YYYY-MM-DD
dueDate
Date
The date by which the payment for the invoice is expected. Format: YYYY-MM-DD
paidOnDate
Date
The date when the invoice was settled or paid by the customer. Format: YYYY-MM-DD
memo
String
Any supplementary notes, comments, or details related to the invoice.
companyId
String
ID of the company the invoice belongs to.
currency
Enum
The type of currency in which the invoice amount is presented. Possible values: AED, AFN, ALL, AMD, ANG, AOA, ARS, AUD, AWG, AZN, BAM, BBD, BDT, BGN, BHD, BIF, BMD, BND, BOB, BOV, BRL, BSD, BTN, BWP, BYN, BZD, CAD, CDF, CHE, CHF, CHW, CLF, CLP, CNY, COP, COU, CRC, CUC, CUP, CVE, CZK, DJF, DKK, DOP, DZD, EGP, ERN, ETB, EUR, FJD, FKP, GBP, GEL, GHS, GIP, GMD, GNF, GTQ, GYD, HKD, HNL, HRK, HTG, HUF, IDR, ILS, INR, IQD, IRR, ISK, JMD, JOD, JPY, KES, KGS, KHR, KMF, KPW, KRW, KWD, KYD, KZT, LAK, LBP, LKR, LRD, LSL, LYD, MAD, MDL, MGA, MKD, MMK, MNT, MOP, MRU, MUR, MVR, MWK, MXN, MXV, MYR, MZN, NAD, NGN, NIO, NOK, NPR, NZD, OMR, PAB, PEN, PGK, PHP, PKR, PLN, PYG, QAR, RON, RSD, RUB, RWF, SAR, SBD, SCR, SDG, SEK, SGD, SHP, SLL, SOS, SRD, SSP, STN, SVC, SYP, SZL, THB, TJS, TMT, TND, TOP, TRY, TTD, TWD, TZS, UAH, UGX, USD, USN, UYI, UYU, UYW, UZS, VES, VND, VUV, WST, XAF, XAG, XAU, XBA, XBB, XBC, XBD, XCD, XDR, XOF, XPD, XPF, XPT, XSU, XTS, XUA, XXX, YER, ZAR, ZMW, ZWL
exchangeRate
Number
The conversion rate used if the invoice involves transactions in foreign currency.
totalDiscount
String
Aggregate reductions or markdowns applied to the invoice.
subTotal
Number
The amount before any taxes, discounts, or additional fees are accounted for.
invoiceStatus
String
The current state of the invoice. Possible values: PAID, DRAFT, SUBMITTED, PARTIALLY_PAID, OPEN, VOID
totalTaxAmount
Number
Overall amount of taxes charged on the invoice.
totalAmount
Number
The complete sum due, after considering all charges, taxes, and discounts.
balance
Number
The outstanding amount remaining to be paid, after any partial payments or credits.
trackingCategories
String[]
An array of tracking category IDs.
lineItems
InvoiceLineItem[]
Detailed breakdown of all the goods or services billed in the invoice, including descriptions, quantities, and prices.
purchaseOrders
String[]
An array of purchase order IDs.
remoteCreatedAt
DateTime
The exact date and time when the item was first added or created in the third-party application.
remoteUpdatedAt
DateTime
The latest date and time when any modifications or updates were made to the item's details in the third-party application.
remoteDeleted
Boolean
Flag to indicate that the record has been deleted in the third-party application.
createdAt
DateTime
Date and time the record has been synced into the data cache.
updatedAt
DateTime
Date and time the record has been updated in the data cache.
Invoice Line Item
{
remoteId: "1",
description: "Line Item",
unitPrice: 2,
quantity: 10,
totalAmount: 20,
currency: null,
exchangeRate: null,
accountingItemId: null,
accountId: "00000000-0000-0000-0000-00000000",
trackingCategoryId: null,
trackingCategoryIds: [],
companyId: null
}
Properties
remoteId
String
The ID of the object in the third-party application.
description
String
A concise overview or detail of the specific good or service listed in the line item.
unitPrice
Number
The cost assigned per individual unit of the good or service.
quantity
Number
The number of units of the particular good or service being invoiced.
totalAmount
Number
The cumulative sum for the line item, typically calculated as unitPrice * quantity.
currency
Enum
The type of currency in which the line item's amount is presented. Possible values: AED, AFN, ALL, AMD, ANG, AOA, ARS, AUD, AWG, AZN, BAM, BBD, BDT, BGN, BHD, BIF, BMD, BND, BOB, BOV, BRL, BSD, BTN, BWP, BYN, BZD, CAD, CDF, CHE, CHF, CHW, CLF, CLP, CNY, COP, COU, CRC, CUC, CUP, CVE, CZK, DJF, DKK, DOP, DZD, EGP, ERN, ETB, EUR, FJD, FKP, GBP, GEL, GHS, GIP, GMD, GNF, GTQ, GYD, HKD, HNL, HRK, HTG, HUF, IDR, ILS, INR, IQD, IRR, ISK, JMD, JOD, JPY, KES, KGS, KHR, KMF, KPW, KRW, KWD, KYD, KZT, LAK, LBP, LKR, LRD, LSL, LYD, MAD, MDL, MGA, MKD, MMK, MNT, MOP, MRU, MUR, MVR, MWK, MXN, MXV, MYR, MZN, NAD, NGN, NIO, NOK, NPR, NZD, OMR, PAB, PEN, PGK, PHP, PKR, PLN, PYG, QAR, RON, RSD, RUB, RWF, SAR, SBD, SCR, SDG, SEK, SGD, SHP, SLL, SOS, SRD, SSP, STN, SVC, SYP, SZL, THB, TJS, TMT, TND, TOP, TRY, TTD, TWD, TZS, UAH, UGX, USD, USN, UYI, UYU, UYW, UZS, VES, VND, VUV, WST, XAF, XAG, XAU, XBA, XBB, XBC, XBD, XCD, XDR, XOF, XPD, XPF, XPT, XSU, XTS, XUA, XXX, YER, ZAR, ZMW, ZWL
exchangeRate
Number
The conversion rate employed if the line item includes a foreign currency transaction.
accountingItemId
String
The ID of the item associated with the invoice line item.
accountId
String
The ID of the account associated with the invoice line item.
trackingCategoryId
String
The ID of the tracking category associated with the invoice line item.
trackingCategoryIds
String[]
An array of tracking category IDs associated with the invoice line item.
companyId
String
ID of the company the invoice line item belongs to.