@codat/lending 4.0.0 → 4.1.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +10 -1
- package/dist/sdk/models/shared/accountingaccounttransaction.d.ts +7 -0
- package/dist/sdk/models/shared/accountingattachment.d.ts +2 -1
- package/dist/sdk/models/shared/accountingattachment.js +2 -1
- package/dist/sdk/models/shared/accountingbill.d.ts +7 -0
- package/dist/sdk/models/shared/accountingbillcreditnote.d.ts +7 -0
- package/dist/sdk/models/shared/accountingbillpayment.d.ts +7 -0
- package/dist/sdk/models/shared/accountingcreditnote.d.ts +7 -0
- package/dist/sdk/models/shared/accountingdirectcost.d.ts +7 -0
- package/dist/sdk/models/shared/accountingdirectincome.d.ts +7 -0
- package/dist/sdk/models/shared/accountinginvoice.d.ts +7 -0
- package/dist/sdk/models/shared/accountingpayment.d.ts +7 -0
- package/dist/sdk/models/shared/accountingpaymentallocation.d.ts +7 -0
- package/dist/sdk/models/shared/billpaymentlinelink.d.ts +7 -0
- package/dist/sdk/models/shared/directcostprototype.d.ts +7 -0
- package/dist/sdk/models/shared/payment.d.ts +7 -0
- package/dist/sdk/models/shared/paymentallocationpayment.d.ts +7 -0
- package/dist/sdk/models/shared/paymentlinelink.d.ts +7 -0
- package/dist/sdk/sdk.js +3 -3
- package/docs/sdk/models/operations/downloadfilesrequest.md +1 -1
- package/docs/sdk/models/operations/getaccountingagedcreditorsreportrequest.md +1 -1
- package/docs/sdk/models/operations/getaccountingageddebtorsreportrequest.md +1 -1
- package/docs/sdk/models/operations/getaccountingbalancesheetrequest.md +1 -1
- package/docs/sdk/models/operations/getaccountingcashflowstatementrequest.md +1 -1
- package/docs/sdk/models/operations/getaccountingprofitandlossrequest.md +1 -1
- package/docs/sdk/models/shared/accountingaccount.md +2 -2
- package/docs/sdk/models/shared/accountingaccounttransaction.md +15 -15
- package/docs/sdk/models/shared/accountingagedcreditorreport.md +2 -2
- package/docs/sdk/models/shared/accountingageddebtorreport.md +2 -2
- package/docs/sdk/models/shared/accountingattachment.md +5 -4
- package/docs/sdk/models/shared/accountingbalancesheet.md +2 -2
- package/docs/sdk/models/shared/accountingbankaccount.md +2 -2
- package/docs/sdk/models/shared/accountingbanktransaction.md +3 -3
- package/docs/sdk/models/shared/accountingbill.md +23 -23
- package/docs/sdk/models/shared/accountingbillcreditnote.md +24 -24
- package/docs/sdk/models/shared/accountingbillpayment.md +17 -17
- package/docs/sdk/models/shared/accountingcashflowstatement.md +2 -2
- package/docs/sdk/models/shared/accountingcompanyinfo.md +3 -3
- package/docs/sdk/models/shared/accountingcreateaccountresponse.md +2 -2
- package/docs/sdk/models/shared/accountingcreatebankaccountresponse.md +2 -2
- package/docs/sdk/models/shared/accountingcreatebanktransactionsresponse.md +2 -2
- package/docs/sdk/models/shared/accountingcreatedirectcostresponse.md +2 -2
- package/docs/sdk/models/shared/accountingcreatepaymentresponse.md +2 -2
- package/docs/sdk/models/shared/accountingcreatesupplierresponse.md +2 -2
- package/docs/sdk/models/shared/accountingcreatetransferresponse.md +2 -2
- package/docs/sdk/models/shared/accountingcreditnote.md +26 -26
- package/docs/sdk/models/shared/accountingcustomer.md +2 -2
- package/docs/sdk/models/shared/accountingdirectcost.md +18 -18
- package/docs/sdk/models/shared/accountingdirectincome.md +18 -18
- package/docs/sdk/models/shared/accountinginvoice.md +28 -28
- package/docs/sdk/models/shared/accountingjournal.md +3 -3
- package/docs/sdk/models/shared/accountingjournalentry.md +5 -5
- package/docs/sdk/models/shared/accountingpayment.md +17 -17
- package/docs/sdk/models/shared/accountingprofitandlossreport.md +2 -2
- package/docs/sdk/models/shared/accountingsupplier.md +2 -2
- package/docs/sdk/models/shared/accountingtransfer.md +3 -3
- package/docs/sdk/models/shared/agedoutstandingamount.md +2 -2
- package/docs/sdk/models/shared/allocation.md +6 -6
- package/docs/sdk/models/shared/balancesheet.md +1 -1
- package/docs/sdk/models/shared/bankingaccount.md +2 -2
- package/docs/sdk/models/shared/bankingaccountbalance.md +3 -3
- package/docs/sdk/models/shared/bankingtransaction.md +4 -4
- package/docs/sdk/models/shared/bankingtransactioncategory.md +2 -2
- package/docs/sdk/models/shared/bankingtransactionref.md +1 -1
- package/docs/sdk/models/shared/billpaymentline.md +1 -1
- package/docs/sdk/models/shared/billpaymentlinelink.md +6 -6
- package/docs/sdk/models/shared/cashflowstatement.md +2 -2
- package/docs/sdk/models/shared/clientratelimitreachedwebhookdata.md +1 -1
- package/docs/sdk/models/shared/clientratelimitresetwebhookdata.md +1 -1
- package/docs/sdk/models/shared/commercecompanyinfo.md +3 -3
- package/docs/sdk/models/shared/commercecustomer.md +3 -3
- package/docs/sdk/models/shared/commercedispute.md +4 -4
- package/docs/sdk/models/shared/commercelocation.md +2 -2
- package/docs/sdk/models/shared/commerceorder.md +4 -4
- package/docs/sdk/models/shared/commercepayment.md +4 -4
- package/docs/sdk/models/shared/commercepaymentmethod.md +2 -2
- package/docs/sdk/models/shared/commerceproductcategory.md +2 -2
- package/docs/sdk/models/shared/commercetransaction.md +4 -4
- package/docs/sdk/models/shared/company.md +2 -2
- package/docs/sdk/models/shared/connection.md +2 -2
- package/docs/sdk/models/shared/contact.md +1 -1
- package/docs/sdk/models/shared/createbankaccounttransaction.md +1 -1
- package/docs/sdk/models/shared/dataconnectionerror.md +1 -1
- package/docs/sdk/models/shared/dataintegritydates.md +4 -4
- package/docs/sdk/models/shared/dataintegritydetail.md +1 -1
- package/docs/sdk/models/shared/dataintegritystatusinfo.md +1 -1
- package/docs/sdk/models/shared/datastatus.md +1 -1
- package/docs/sdk/models/shared/directcostprototype.md +14 -14
- package/docs/sdk/models/shared/enhancedcashflowtransaction.md +1 -1
- package/docs/sdk/models/shared/enhancedinvoicereportitem.md +5 -5
- package/docs/sdk/models/shared/enhancedreportinfo.md +1 -1
- package/docs/sdk/models/shared/excelstatus.md +1 -1
- package/docs/sdk/models/shared/file.md +1 -1
- package/docs/sdk/models/shared/loansummaryreportinfo.md +1 -1
- package/docs/sdk/models/shared/loansummaryreportitem.md +1 -1
- package/docs/sdk/models/shared/loantransactionsreportinfo.md +1 -1
- package/docs/sdk/models/shared/payment.md +9 -9
- package/docs/sdk/models/shared/paymentallocationpayment.md +10 -10
- package/docs/sdk/models/shared/paymentline.md +1 -1
- package/docs/sdk/models/shared/paymentlinelink.md +6 -6
- package/docs/sdk/models/shared/paymentref.md +4 -4
- package/docs/sdk/models/shared/productvariant.md +3 -3
- package/docs/sdk/models/shared/profitandlossreport.md +2 -2
- package/docs/sdk/models/shared/pulloperation.md +2 -2
- package/docs/sdk/models/shared/pushoperation.md +2 -2
- package/docs/sdk/models/shared/reportitem.md +1 -1
- package/docs/sdk/models/shared/reportitems.md +1 -1
- package/docs/sdks/balancesheet/README.md +1 -1
- package/docs/sdks/bankaccounts/README.md +2 -2
- package/docs/sdks/banktransactions/README.md +1 -1
- package/docs/sdks/cashflow/README.md +1 -1
- package/docs/sdks/codatlendingpayments/README.md +4 -4
- package/docs/sdks/codatlendingsuppliers/README.md +2 -2
- package/docs/sdks/directcosts/README.md +3 -3
- package/docs/sdks/fileupload/README.md +1 -1
- package/docs/sdks/profitandloss/README.md +1 -1
- package/docs/sdks/transfers/README.md +3 -3
- package/package.json +1 -1
|
@@ -20,8 +20,8 @@ A cash flow statement is a financial report that records all cash that is receiv
|
|
|
20
20
|
| Field | Type | Required | Description | Example |
|
|
21
21
|
| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
22
22
|
| `currency` | *string* | :heavy_check_mark: | The currency data type in Codat is the [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) currency code, e.g. _GBP_.<br/><br/>## Unknown currencies<br/><br/>In line with the ISO 4217 specification, the code _XXX_ is used when the data source does not return a currency for a transaction. <br/><br/>There are only a very small number of edge cases where this currency code is returned by the Codat system. | GBP |
|
|
23
|
-
| `earliestAvailableMonth` | *string* | :heavy_minus_sign: | In Codat's data model, dates and times are represented using the <a class="external" href="https://en.wikipedia.org/wiki/ISO_8601" target="_blank">ISO 8601 standard</a>. Date and time fields are formatted as strings; for example:<br/><br/>```<br/>2020-10-08T22:40:50Z<br/>2021-01-01T00:00:00<br/>```<br/><br/><br/><br/>When syncing data that contains `DateTime` fields from Codat, make sure you support the following cases when reading time information:<br/><br/>- Coordinated Universal Time (UTC): `2021-11-15T06:00:00Z`<br/>- Unqualified local time: `2021-11-15T01:00:00`<br/>- UTC time offsets: `2021-11-15T01:00:00-05:00`<br/><br/>> Time zones<br/>> <br/>> Not all dates from Codat will contain information about time zones. <br/>> Where it is not available from the underlying platform, Codat will return these as times local to the business whose data has been synced. | 2022-10-
|
|
24
|
-
| `mostRecentAvailableMonth` | *string* | :heavy_minus_sign: | In Codat's data model, dates and times are represented using the <a class="external" href="https://en.wikipedia.org/wiki/ISO_8601" target="_blank">ISO 8601 standard</a>. Date and time fields are formatted as strings; for example:<br/><br/>```<br/>2020-10-08T22:40:50Z<br/>2021-01-01T00:00:00<br/>```<br/><br/><br/><br/>When syncing data that contains `DateTime` fields from Codat, make sure you support the following cases when reading time information:<br/><br/>- Coordinated Universal Time (UTC): `2021-11-15T06:00:00Z`<br/>- Unqualified local time: `2021-11-15T01:00:00`<br/>- UTC time offsets: `2021-11-15T01:00:00-05:00`<br/><br/>> Time zones<br/>> <br/>> Not all dates from Codat will contain information about time zones. <br/>> Where it is not available from the underlying platform, Codat will return these as times local to the business whose data has been synced. | 2022-10-
|
|
23
|
+
| `earliestAvailableMonth` | *string* | :heavy_minus_sign: | In Codat's data model, dates and times are represented using the <a class="external" href="https://en.wikipedia.org/wiki/ISO_8601" target="_blank">ISO 8601 standard</a>. Date and time fields are formatted as strings; for example:<br/><br/>```<br/>2020-10-08T22:40:50Z<br/>2021-01-01T00:00:00<br/>```<br/><br/><br/><br/>When syncing data that contains `DateTime` fields from Codat, make sure you support the following cases when reading time information:<br/><br/>- Coordinated Universal Time (UTC): `2021-11-15T06:00:00Z`<br/>- Unqualified local time: `2021-11-15T01:00:00`<br/>- UTC time offsets: `2021-11-15T01:00:00-05:00`<br/><br/>> Time zones<br/>> <br/>> Not all dates from Codat will contain information about time zones. <br/>> Where it is not available from the underlying platform, Codat will return these as times local to the business whose data has been synced. | 2022-10-23 00:00:00 +0000 UTC |
|
|
24
|
+
| `mostRecentAvailableMonth` | *string* | :heavy_minus_sign: | In Codat's data model, dates and times are represented using the <a class="external" href="https://en.wikipedia.org/wiki/ISO_8601" target="_blank">ISO 8601 standard</a>. Date and time fields are formatted as strings; for example:<br/><br/>```<br/>2020-10-08T22:40:50Z<br/>2021-01-01T00:00:00<br/>```<br/><br/><br/><br/>When syncing data that contains `DateTime` fields from Codat, make sure you support the following cases when reading time information:<br/><br/>- Coordinated Universal Time (UTC): `2021-11-15T06:00:00Z`<br/>- Unqualified local time: `2021-11-15T01:00:00`<br/>- UTC time offsets: `2021-11-15T01:00:00-05:00`<br/><br/>> Time zones<br/>> <br/>> Not all dates from Codat will contain information about time zones. <br/>> Where it is not available from the underlying platform, Codat will return these as times local to the business whose data has been synced. | 2022-10-23 00:00:00 +0000 UTC |
|
|
25
25
|
| `reportBasis` | [shared.ReportBasis](../../../sdk/models/shared/reportbasis.md) | :heavy_check_mark: | Accounting method used when aggregating the report data. In this case, `Cash`. | |
|
|
26
26
|
| `reportInput` | [shared.ReportInput](../../../sdk/models/shared/reportinput.md) | :heavy_check_mark: | Accounting method used to prepare the cash flow statement. | |
|
|
27
27
|
| `reports` | [shared.CashFlowStatement](../../../sdk/models/shared/cashflowstatement.md)[] | :heavy_check_mark: | Array of cash flow statements. | |
|
|
@@ -18,9 +18,9 @@ Company info provides standard details about a linked company such as their addr
|
|
|
18
18
|
| `baseCurrency` | *string* | :heavy_minus_sign: | Currency set in the accounting platform of the linked company. Used by the currency rate. | |
|
|
19
19
|
| `companyLegalName` | *string* | :heavy_minus_sign: | Registered legal name of the linked company. | |
|
|
20
20
|
| `companyName` | *string* | :heavy_minus_sign: | Name of the linked company. | |
|
|
21
|
-
| `createdDate` | *string* | :heavy_minus_sign: | In Codat's data model, dates and times are represented using the <a class="external" href="https://en.wikipedia.org/wiki/ISO_8601" target="_blank">ISO 8601 standard</a>. Date and time fields are formatted as strings; for example:<br/><br/>```<br/>2020-10-08T22:40:50Z<br/>2021-01-01T00:00:00<br/>```<br/><br/><br/><br/>When syncing data that contains `DateTime` fields from Codat, make sure you support the following cases when reading time information:<br/><br/>- Coordinated Universal Time (UTC): `2021-11-15T06:00:00Z`<br/>- Unqualified local time: `2021-11-15T01:00:00`<br/>- UTC time offsets: `2021-11-15T01:00:00-05:00`<br/><br/>> Time zones<br/>> <br/>> Not all dates from Codat will contain information about time zones. <br/>> Where it is not available from the underlying platform, Codat will return these as times local to the business whose data has been synced. | 2022-10-
|
|
22
|
-
| `financialYearStartDate` | *string* | :heavy_minus_sign: | In Codat's data model, dates and times are represented using the <a class="external" href="https://en.wikipedia.org/wiki/ISO_8601" target="_blank">ISO 8601 standard</a>. Date and time fields are formatted as strings; for example:<br/><br/>```<br/>2020-10-08T22:40:50Z<br/>2021-01-01T00:00:00<br/>```<br/><br/><br/><br/>When syncing data that contains `DateTime` fields from Codat, make sure you support the following cases when reading time information:<br/><br/>- Coordinated Universal Time (UTC): `2021-11-15T06:00:00Z`<br/>- Unqualified local time: `2021-11-15T01:00:00`<br/>- UTC time offsets: `2021-11-15T01:00:00-05:00`<br/><br/>> Time zones<br/>> <br/>> Not all dates from Codat will contain information about time zones. <br/>> Where it is not available from the underlying platform, Codat will return these as times local to the business whose data has been synced. | 2022-10-
|
|
23
|
-
| `ledgerLockDate` | *string* | :heavy_minus_sign: | In Codat's data model, dates and times are represented using the <a class="external" href="https://en.wikipedia.org/wiki/ISO_8601" target="_blank">ISO 8601 standard</a>. Date and time fields are formatted as strings; for example:<br/><br/>```<br/>2020-10-08T22:40:50Z<br/>2021-01-01T00:00:00<br/>```<br/><br/><br/><br/>When syncing data that contains `DateTime` fields from Codat, make sure you support the following cases when reading time information:<br/><br/>- Coordinated Universal Time (UTC): `2021-11-15T06:00:00Z`<br/>- Unqualified local time: `2021-11-15T01:00:00`<br/>- UTC time offsets: `2021-11-15T01:00:00-05:00`<br/><br/>> Time zones<br/>> <br/>> Not all dates from Codat will contain information about time zones. <br/>> Where it is not available from the underlying platform, Codat will return these as times local to the business whose data has been synced. | 2022-10-
|
|
21
|
+
| `createdDate` | *string* | :heavy_minus_sign: | In Codat's data model, dates and times are represented using the <a class="external" href="https://en.wikipedia.org/wiki/ISO_8601" target="_blank">ISO 8601 standard</a>. Date and time fields are formatted as strings; for example:<br/><br/>```<br/>2020-10-08T22:40:50Z<br/>2021-01-01T00:00:00<br/>```<br/><br/><br/><br/>When syncing data that contains `DateTime` fields from Codat, make sure you support the following cases when reading time information:<br/><br/>- Coordinated Universal Time (UTC): `2021-11-15T06:00:00Z`<br/>- Unqualified local time: `2021-11-15T01:00:00`<br/>- UTC time offsets: `2021-11-15T01:00:00-05:00`<br/><br/>> Time zones<br/>> <br/>> Not all dates from Codat will contain information about time zones. <br/>> Where it is not available from the underlying platform, Codat will return these as times local to the business whose data has been synced. | 2022-10-23 00:00:00 +0000 UTC |
|
|
22
|
+
| `financialYearStartDate` | *string* | :heavy_minus_sign: | In Codat's data model, dates and times are represented using the <a class="external" href="https://en.wikipedia.org/wiki/ISO_8601" target="_blank">ISO 8601 standard</a>. Date and time fields are formatted as strings; for example:<br/><br/>```<br/>2020-10-08T22:40:50Z<br/>2021-01-01T00:00:00<br/>```<br/><br/><br/><br/>When syncing data that contains `DateTime` fields from Codat, make sure you support the following cases when reading time information:<br/><br/>- Coordinated Universal Time (UTC): `2021-11-15T06:00:00Z`<br/>- Unqualified local time: `2021-11-15T01:00:00`<br/>- UTC time offsets: `2021-11-15T01:00:00-05:00`<br/><br/>> Time zones<br/>> <br/>> Not all dates from Codat will contain information about time zones. <br/>> Where it is not available from the underlying platform, Codat will return these as times local to the business whose data has been synced. | 2022-10-23 00:00:00 +0000 UTC |
|
|
23
|
+
| `ledgerLockDate` | *string* | :heavy_minus_sign: | In Codat's data model, dates and times are represented using the <a class="external" href="https://en.wikipedia.org/wiki/ISO_8601" target="_blank">ISO 8601 standard</a>. Date and time fields are formatted as strings; for example:<br/><br/>```<br/>2020-10-08T22:40:50Z<br/>2021-01-01T00:00:00<br/>```<br/><br/><br/><br/>When syncing data that contains `DateTime` fields from Codat, make sure you support the following cases when reading time information:<br/><br/>- Coordinated Universal Time (UTC): `2021-11-15T06:00:00Z`<br/>- Unqualified local time: `2021-11-15T01:00:00`<br/>- UTC time offsets: `2021-11-15T01:00:00-05:00`<br/><br/>> Time zones<br/>> <br/>> Not all dates from Codat will contain information about time zones. <br/>> Where it is not available from the underlying platform, Codat will return these as times local to the business whose data has been synced. | 2022-10-23 00:00:00 +0000 UTC |
|
|
24
24
|
| `phoneNumbers` | [shared.PhoneNumber](../../../sdk/models/shared/phonenumber.md)[] | :heavy_minus_sign: | An array of phone numbers. | |
|
|
25
25
|
| `registrationNumber` | *string* | :heavy_minus_sign: | Registration number given to the linked company by the companies authority in the country of origin. In the UK this is Companies House. | |
|
|
26
26
|
| `sourceUrls` | Record<string, *string*> | :heavy_minus_sign: | URL addresses for the accounting source.<br/><br/>For example, for Xero integrations two URLs are returned. These have many potential use cases, such as [deep linking](https://developer.xero.com/documentation/api-guides/deep-link-xero). | |
|
|
@@ -7,13 +7,13 @@
|
|
|
7
7
|
| -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
8
8
|
| `changes` | [shared.PushOperationChange](../../../sdk/models/shared/pushoperationchange.md)[] | :heavy_minus_sign: | Contains a single entry that communicates which record has changed and the manner in which it changed. | |
|
|
9
9
|
| `companyId` | *string* | :heavy_check_mark: | Unique identifier for your SMB in Codat. | 8a210b68-6988-11ed-a1eb-0242ac120002 |
|
|
10
|
-
| `completedOnUtc` | *string* | :heavy_minus_sign: | In Codat's data model, dates and times are represented using the <a class="external" href="https://en.wikipedia.org/wiki/ISO_8601" target="_blank">ISO 8601 standard</a>. Date and time fields are formatted as strings; for example:<br/><br/>```<br/>2020-10-08T22:40:50Z<br/>2021-01-01T00:00:00<br/>```<br/><br/><br/><br/>When syncing data that contains `DateTime` fields from Codat, make sure you support the following cases when reading time information:<br/><br/>- Coordinated Universal Time (UTC): `2021-11-15T06:00:00Z`<br/>- Unqualified local time: `2021-11-15T01:00:00`<br/>- UTC time offsets: `2021-11-15T01:00:00-05:00`<br/><br/>> Time zones<br/>> <br/>> Not all dates from Codat will contain information about time zones. <br/>> Where it is not available from the underlying platform, Codat will return these as times local to the business whose data has been synced. | 2022-10-
|
|
10
|
+
| `completedOnUtc` | *string* | :heavy_minus_sign: | In Codat's data model, dates and times are represented using the <a class="external" href="https://en.wikipedia.org/wiki/ISO_8601" target="_blank">ISO 8601 standard</a>. Date and time fields are formatted as strings; for example:<br/><br/>```<br/>2020-10-08T22:40:50Z<br/>2021-01-01T00:00:00<br/>```<br/><br/><br/><br/>When syncing data that contains `DateTime` fields from Codat, make sure you support the following cases when reading time information:<br/><br/>- Coordinated Universal Time (UTC): `2021-11-15T06:00:00Z`<br/>- Unqualified local time: `2021-11-15T01:00:00`<br/>- UTC time offsets: `2021-11-15T01:00:00-05:00`<br/><br/>> Time zones<br/>> <br/>> Not all dates from Codat will contain information about time zones. <br/>> Where it is not available from the underlying platform, Codat will return these as times local to the business whose data has been synced. | 2022-10-23 00:00:00 +0000 UTC |
|
|
11
11
|
| `data` | [shared.AccountingAccount](../../../sdk/models/shared/accountingaccount.md) | :heavy_minus_sign: | > **Language tip:** Accounts are also referred to as **chart of accounts**, **nominal accounts**, and **general ledger**.<br/><br/>View the coverage for accounts in the <a className="external" href="https://knowledge.codat.io/supported-features/accounting?view=tab-by-data-type&dataType=chartOfAccounts" target="_blank">Data coverage explorer</a>.<br/><br/>## Overview<br/><br/>Accounts are the categories a business uses to record accounting transactions. From the Accounts endpoints, you can retrieve a list of all accounts for a specified company.<br/><br/>The categories for an account include:<br/>* Asset<br/>* Expense<br/>* Income<br/>* Liability<br/>* Equity.<br/><br/>The same account may have a different category based on the integration it is used in. For example, a current account (known as checking in the US) should be categorized as `Asset.Current` for Xero, and `Asset.Bank.Checking` for QuickBooks Online.<br/><br/>At the same time, each integration may have its own requirements to the categories. For example, a Paypal account in Xero is of the `Asset.Bank` category and therefore requires additional properties to be provided.<br/><br/>To determine the list of allowed categories for a specific integration, you can:<br/>- Follow our [Create, update, delete data](https://docs.codat.io/using-the-api/push) guide and use the [Get create account model](https://docs.codat.io/lending-api#/operations/get-create-chartOfAccounts-model).<br/>- Refer to the integration's own documentation.<br/><br/>> **Accounts with no category**<br/>><br/>> If an account is pulled from the chart of accounts and its nominal code does not lie within the category layout for the company's accounts, then the **type** is `Unknown`. The **fullyQualifiedCategory** and **fullyQualifiedName** fields return `null`.<br/>><br/>> This approach gives a true representation of the company's accounts whilst preventing distorting financials such as a company's profit and loss and balance sheet reports. | |
|
|
12
12
|
| `dataConnectionKey` | *string* | :heavy_check_mark: | Unique identifier for a company's data connection. | 2e9d2c44-f675-40ba-8049-353bfcb5e171 |
|
|
13
13
|
| `dataType` | [shared.DataType](../../../sdk/models/shared/datatype.md) | :heavy_minus_sign: | Available Data types | invoices |
|
|
14
14
|
| `errorMessage` | *string* | :heavy_minus_sign: | A message about the error. | |
|
|
15
15
|
| `pushOperationKey` | *string* | :heavy_check_mark: | A unique identifier generated by Codat to represent this single push operation. This identifier can be used to track the status of the push, and should be persisted. | |
|
|
16
|
-
| `requestedOnUtc` | *string* | :heavy_check_mark: | In Codat's data model, dates and times are represented using the <a class="external" href="https://en.wikipedia.org/wiki/ISO_8601" target="_blank">ISO 8601 standard</a>. Date and time fields are formatted as strings; for example:<br/><br/>```<br/>2020-10-08T22:40:50Z<br/>2021-01-01T00:00:00<br/>```<br/><br/><br/><br/>When syncing data that contains `DateTime` fields from Codat, make sure you support the following cases when reading time information:<br/><br/>- Coordinated Universal Time (UTC): `2021-11-15T06:00:00Z`<br/>- Unqualified local time: `2021-11-15T01:00:00`<br/>- UTC time offsets: `2021-11-15T01:00:00-05:00`<br/><br/>> Time zones<br/>> <br/>> Not all dates from Codat will contain information about time zones. <br/>> Where it is not available from the underlying platform, Codat will return these as times local to the business whose data has been synced. | 2022-10-
|
|
16
|
+
| `requestedOnUtc` | *string* | :heavy_check_mark: | In Codat's data model, dates and times are represented using the <a class="external" href="https://en.wikipedia.org/wiki/ISO_8601" target="_blank">ISO 8601 standard</a>. Date and time fields are formatted as strings; for example:<br/><br/>```<br/>2020-10-08T22:40:50Z<br/>2021-01-01T00:00:00<br/>```<br/><br/><br/><br/>When syncing data that contains `DateTime` fields from Codat, make sure you support the following cases when reading time information:<br/><br/>- Coordinated Universal Time (UTC): `2021-11-15T06:00:00Z`<br/>- Unqualified local time: `2021-11-15T01:00:00`<br/>- UTC time offsets: `2021-11-15T01:00:00-05:00`<br/><br/>> Time zones<br/>> <br/>> Not all dates from Codat will contain information about time zones. <br/>> Where it is not available from the underlying platform, Codat will return these as times local to the business whose data has been synced. | 2022-10-23 00:00:00 +0000 UTC |
|
|
17
17
|
| `status` | [shared.PushOperationStatus](../../../sdk/models/shared/pushoperationstatus.md) | :heavy_check_mark: | The current status of the push operation. | |
|
|
18
18
|
| `statusCode` | *number* | :heavy_check_mark: | Push status code. | |
|
|
19
19
|
| `timeoutInMinutes` | *number* | :heavy_minus_sign: | Number of minutes the push operation must complete within before it times out. | |
|