@codat/lending 0.1.0

package/docs/models/shared/commercepaymentmethod.md

@@ -0,0 +1,16 @@
+# CommercePaymentMethod
+
+A Payment Method represents the payment method(s) used to make payments.
+
+Explore our [data coverage](https://knowledge.codat.io/supported-features/commerce?view=tab-by-data-type&dataType=commerce-paymentMethods) for this data type.
+
+
+## Fields
+
+| Field                                                             | Type                                                              | Required                                                          | Description                                                       | Example                                                           |
+| ----------------------------------------------------------------- | ----------------------------------------------------------------- | ----------------------------------------------------------------- | ----------------------------------------------------------------- | ----------------------------------------------------------------- |
+| `id`                                                              | *string*                                                          | :heavy_check_mark:                                                | A unique, persistent identifier for this record                   | 13d946f0-c5d5-42bc-b092-97ece17923ab                              |
+| `modifiedDate`                                                    | *string*                                                          | :heavy_minus_sign:                                                | N/A                                                               | 2022-10-23T00:00:00.000Z                                          |
+| `name`                                                            | *string*                                                          | :heavy_minus_sign:                                                | The name of the PaymentMethod                                     | Alipay                                                            |
+| `sourceModifiedDate`                                              | *string*                                                          | :heavy_minus_sign:                                                | N/A                                                               | 2022-10-23T00:00:00.000Z                                          |
+| `status`                                                          | [PaymentMethodStatus](../../models/shared/paymentmethodstatus.md) | :heavy_minus_sign:                                                | Status of the Payment Method                                      | Active                                                            |

package/docs/models/shared/commercepaymentmethods.md

@@ -0,0 +1,14 @@
+# CommercePaymentMethods
+
+OK
+
+
+## Fields
+
+| Field                                                                   | Type                                                                    | Required                                                                | Description                                                             |
+| ----------------------------------------------------------------------- | ----------------------------------------------------------------------- | ----------------------------------------------------------------------- | ----------------------------------------------------------------------- |
+| `links`                                                                 | [Links](../../models/shared/links.md)                                   | :heavy_check_mark:                                                      | N/A                                                                     |
+| `pageNumber`                                                            | *number*                                                                | :heavy_check_mark:                                                      | N/A                                                                     |
+| `pageSize`                                                              | *number*                                                                | :heavy_check_mark:                                                      | N/A                                                                     |
+| `results`                                                               | [CommercePaymentMethod](../../models/shared/commercepaymentmethod.md)[] | :heavy_minus_sign:                                                      | N/A                                                                     |
+| `totalResults`                                                          | *number*                                                                | :heavy_check_mark:                                                      | N/A                                                                     |

package/docs/models/shared/commercepayments.md

@@ -0,0 +1,14 @@
+# CommercePayments
+
+OK
+
+
+## Fields
+
+| Field                                                       | Type                                                        | Required                                                    | Description                                                 |
+| ----------------------------------------------------------- | ----------------------------------------------------------- | ----------------------------------------------------------- | ----------------------------------------------------------- |
+| `links`                                                     | [Links](../../models/shared/links.md)                       | :heavy_check_mark:                                          | N/A                                                         |
+| `pageNumber`                                                | *number*                                                    | :heavy_check_mark:                                          | N/A                                                         |
+| `pageSize`                                                  | *number*                                                    | :heavy_check_mark:                                          | N/A                                                         |
+| `results`                                                   | [CommercePayment](../../models/shared/commercepayment.md)[] | :heavy_minus_sign:                                          | N/A                                                         |
+| `totalResults`                                              | *number*                                                    | :heavy_check_mark:                                          | N/A                                                         |

package/docs/models/shared/commerceproduct.md

@@ -0,0 +1,18 @@
+# CommerceProduct
+
+A Product is an item in the company's inventory, and includes information about the price and quantity of all products, and variants thereof, available for sale.
+
+Explore our [data coverage](https://knowledge.codat.io/supported-features/commerce?view=tab-by-data-type&dataType=commerce-products) for this data type.
+
+
+
+## Fields
+
+| Field                                                                                                       | Type                                                                                                        | Required                                                                                                    | Description                                                                                                 | Example                                                                                                     |
+| ----------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------- |
+| `categorization`                                                                                            | *string*                                                                                                    | :heavy_minus_sign:                                                                                          | Retail category that the product is assigned to                                                             | Hardware                                                                                                    |
+| `description`                                                                                               | *string*                                                                                                    | :heavy_minus_sign:                                                                                          | Description of the product recorded in the commerce or point of sale platform.                              | 1tb Western Digital Hard Drive                                                                              |
+| `id`                                                                                                        | *string*                                                                                                    | :heavy_check_mark:                                                                                          | A unique, persistent identifier for this record                                                             | 13d946f0-c5d5-42bc-b092-97ece17923ab                                                                        |
+| `isGiftCard`                                                                                                | *boolean*                                                                                                   | :heavy_minus_sign:                                                                                          | Whether the product represents a gift card or voucher that<br/>can be redeemed in the commerce or POS platform<br/> |                                                                                                             |
+| `name`                                                                                                      | *string*                                                                                                    | :heavy_minus_sign:                                                                                          | Name of the product in the commerce or POS system                                                           | Hard Drive                                                                                                  |
+| `variants`                                                                                                  | [ProductVariant](../../models/shared/productvariant.md)[]                                                   | :heavy_minus_sign:                                                                                          | N/A                                                                                                         |                                                                                                             |

package/docs/models/shared/commerceproductcategories.md

@@ -0,0 +1,14 @@
+# CommerceProductCategories
+
+OK
+
+
+## Fields
+
+| Field                                                                       | Type                                                                        | Required                                                                    | Description                                                                 |
+| --------------------------------------------------------------------------- | --------------------------------------------------------------------------- | --------------------------------------------------------------------------- | --------------------------------------------------------------------------- |
+| `links`                                                                     | [Links](../../models/shared/links.md)                                       | :heavy_check_mark:                                                          | N/A                                                                         |
+| `pageNumber`                                                                | *number*                                                                    | :heavy_check_mark:                                                          | N/A                                                                         |
+| `pageSize`                                                                  | *number*                                                                    | :heavy_check_mark:                                                          | N/A                                                                         |
+| `results`                                                                   | [CommerceProductCategory](../../models/shared/commerceproductcategory.md)[] | :heavy_minus_sign:                                                          | N/A                                                                         |
+| `totalResults`                                                              | *number*                                                                    | :heavy_check_mark:                                                          | N/A                                                                         |

package/docs/models/shared/commerceproductcategory.md

@@ -0,0 +1,17 @@
+# CommerceProductCategory
+
+Product categories are used to classify a group of products together, either by type (e.g. "Furniture"), or sometimes by tax profile.
+
+Explore our [data coverage](https://knowledge.codat.io/supported-features/commerce?view=tab-by-data-type&dataType=commerce-productCategories) for this data type.
+
+
+## Fields
+
+| Field                                                                                                    | Type                                                                                                     | Required                                                                                                 | Description                                                                                              | Example                                                                                                  |
+| -------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------- |
+| `ancestorRefs`                                                                                           | [CommerceRecordRef](../../models/shared/commercerecordref.md)[]                                          | :heavy_minus_sign:                                                                                       | A collection of parent product categories implicitly ordered with the immediate parent last in the list. |                                                                                                          |
+| `hasChildren`                                                                                            | *boolean*                                                                                                | :heavy_minus_sign:                                                                                       | A boolean indicating whether there are other product categories beneath this one in the hierarchy.       |                                                                                                          |
+| `id`                                                                                                     | *string*                                                                                                 | :heavy_minus_sign:                                                                                       | The unique identifier of the product category                                                            | "102"                                                                                                    |
+| `modifiedDate`                                                                                           | *string*                                                                                                 | :heavy_minus_sign:                                                                                       | N/A                                                                                                      | 2022-10-23T00:00:00.000Z                                                                                 |
+| `name`                                                                                                   | *string*                                                                                                 | :heavy_minus_sign:                                                                                       | The name of the product category                                                                         | Entertainment                                                                                            |
+| `sourceModifiedDate`                                                                                     | *string*                                                                                                 | :heavy_minus_sign:                                                                                       | N/A                                                                                                      | 2022-10-23T00:00:00.000Z                                                                                 |

package/docs/models/shared/commerceproducts.md

@@ -0,0 +1,14 @@
+# CommerceProducts
+
+OK
+
+
+## Fields
+
+| Field                                                       | Type                                                        | Required                                                    | Description                                                 |
+| ----------------------------------------------------------- | ----------------------------------------------------------- | ----------------------------------------------------------- | ----------------------------------------------------------- |
+| `links`                                                     | [Links](../../models/shared/links.md)                       | :heavy_check_mark:                                          | N/A                                                         |
+| `pageNumber`                                                | *number*                                                    | :heavy_check_mark:                                          | N/A                                                         |
+| `pageSize`                                                  | *number*                                                    | :heavy_check_mark:                                          | N/A                                                         |
+| `results`                                                   | [CommerceProduct](../../models/shared/commerceproduct.md)[] | :heavy_minus_sign:                                          | N/A                                                         |
+| `totalResults`                                              | *number*                                                    | :heavy_check_mark:                                          | N/A                                                         |

package/docs/models/shared/commercerecordref.md

@@ -0,0 +1,9 @@
+# CommerceRecordRef
+
+
+## Fields
+
+| Field                                                 | Type                                                  | Required                                              | Description                                           | Example                                               |
+| ----------------------------------------------------- | ----------------------------------------------------- | ----------------------------------------------------- | ----------------------------------------------------- | ----------------------------------------------------- |
+| `id`                                                  | *string*                                              | :heavy_check_mark:                                    | The unique identitifer of the record being referenced | 13d946f0-c5d5-42bc-b092-97ece17923ab                  |
+| `type`                                                | *string*                                              | :heavy_check_mark:                                    | The type of record being referenced.                  |                                                       |

package/docs/models/shared/commercereport.md

@@ -0,0 +1,54 @@
+# CommerceReport
+
+## Structure
+
+Assess reports follow a consistent structure. Reports contain four sections of information:
+
+### 1. Report definition
+
+Information such as:
+
+  1. The report info (e.g. enhanced_profit_and_loss).
+  2. The display name of the report (e.g. Enhanced Profit and Loss).
+  
+### 2. Dimension info
+
+Information about the dimension contained in the reports such as:
+
+  1. The type of dimension (e.g. datetime, recordRef).
+  2. The display name of the dimension (e.g. Period, Category type, Category sub type).
+  3. The details about each item within the dimension (e.g. displayName:"Jan 2022", start:"...", end:"...", id:"...", name:"...").
+
+### 3. Measure info
+
+Information about the measures contained in the report such as:
+
+  1. The display name of the measure (e.g. value of account, percentage change).
+  2. The type of the measure (e.g. currency, percentage).
+  3. The unit of the measure (e.g. %, GBP).
+  
+### 4. The data for the report
+
+When the *includeDisplayName* parameter is set to *true*, it shows the *dimensionDisplayName* and *itemDisplayName* to make the data human-readable. The default setting for *includeDisplayName* is *false*.
+
+
+## Displaying the report
+
+Reports can be rendered as follows (ordering is implicit rather than explicit):
+
+![A table showing an example of how a report can be rendered](https://files.readme.io/1fa20ca-Report1.png)
+
+# Data model
+
+## Dimensions
+
+
+## Fields
+
+| Field                                                                       | Type                                                                        | Required                                                                    | Description                                                                 |
+| --------------------------------------------------------------------------- | --------------------------------------------------------------------------- | --------------------------------------------------------------------------- | --------------------------------------------------------------------------- |
+| `dimensions`                                                                | [CommerceReportDimension](../../models/shared/commercereportdimension.md)[] | :heavy_minus_sign:                                                          | N/A                                                                         |
+| `errors`                                                                    | [CommerceReportError](../../models/shared/commercereporterror.md)[]         | :heavy_minus_sign:                                                          | N/A                                                                         |
+| `measures`                                                                  | [CommerceReportMeasure](../../models/shared/commercereportmeasure.md)[]     | :heavy_minus_sign:                                                          | N/A                                                                         |
+| `reportData`                                                                | [CommerceReportComponent](../../models/shared/commercereportcomponent.md)[] | :heavy_minus_sign:                                                          | N/A                                                                         |
+| `reportInfo`                                                                | Record<string, *string*>                                                    | :heavy_minus_sign:                                                          | N/A                                                                         |

package/docs/models/shared/commercereportcomponent.md

@@ -0,0 +1,13 @@
+# CommerceReportComponent
+
+
+## Fields
+
+| Field                                                                       | Type                                                                        | Required                                                                    | Description                                                                 |
+| --------------------------------------------------------------------------- | --------------------------------------------------------------------------- | --------------------------------------------------------------------------- | --------------------------------------------------------------------------- |
+| `components`                                                                | [CommerceReportComponent](../../models/shared/commercereportcomponent.md)[] | :heavy_minus_sign:                                                          | N/A                                                                         |
+| `dimension`                                                                 | *number*                                                                    | :heavy_minus_sign:                                                          | N/A                                                                         |
+| `dimensionDisplayName`                                                      | *string*                                                                    | :heavy_minus_sign:                                                          | N/A                                                                         |
+| `item`                                                                      | *number*                                                                    | :heavy_minus_sign:                                                          | N/A                                                                         |
+| `itemDisplayName`                                                           | *string*                                                                    | :heavy_minus_sign:                                                          | N/A                                                                         |
+| `measures`                                                                  | [ReportComponentMeasure](../../models/shared/reportcomponentmeasure.md)[]   | :heavy_minus_sign:                                                          | N/A                                                                         |

package/docs/models/shared/commercereportdimension.md

@@ -0,0 +1,11 @@
+# CommerceReportDimension
+
+
+## Fields
+
+| Field                                                                                 | Type                                                                                  | Required                                                                              | Description                                                                           |
+| ------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------- |
+| `displayName`                                                                         | *string*                                                                              | :heavy_minus_sign:                                                                    | N/A                                                                                   |
+| `index`                                                                               | *number*                                                                              | :heavy_minus_sign:                                                                    | N/A                                                                                   |
+| `items`                                                                               | [CommerceReportDimensionItems](../../models/shared/commercereportdimensionitems.md)[] | :heavy_minus_sign:                                                                    | N/A                                                                                   |
+| `type`                                                                                | *string*                                                                              | :heavy_minus_sign:                                                                    | N/A                                                                                   |

package/docs/models/shared/commercereportdimensionitems.md

@@ -0,0 +1,8 @@
+# CommerceReportDimensionItems
+
+
+## Fields
+
+| Field              | Type               | Required           | Description        |
+| ------------------ | ------------------ | ------------------ | ------------------ |
+| `index`            | *number*           | :heavy_minus_sign: | N/A                |

package/docs/models/shared/commercereporterror.md

@@ -0,0 +1,10 @@
+# CommerceReportError
+
+
+## Fields
+
+| Field                      | Type                       | Required                   | Description                |
+| -------------------------- | -------------------------- | -------------------------- | -------------------------- |
+| `details`                  | Record<string, *string*[]> | :heavy_minus_sign:         | N/A                        |
+| `message`                  | *string*                   | :heavy_minus_sign:         | N/A                        |
+| `type`                     | *string*                   | :heavy_minus_sign:         | N/A                        |

package/docs/models/shared/commercereportmeasure.md

@@ -0,0 +1,11 @@
+# CommerceReportMeasure
+
+
+## Fields
+
+| Field              | Type               | Required           | Description        |
+| ------------------ | ------------------ | ------------------ | ------------------ |
+| `displayName`      | *string*           | :heavy_minus_sign: | N/A                |
+| `index`            | *number*           | :heavy_minus_sign: | N/A                |
+| `type`             | *string*           | :heavy_minus_sign: | N/A                |
+| `units`            | *string*           | :heavy_minus_sign: | N/A                |

package/docs/models/shared/commercetransaction.md

@@ -0,0 +1,28 @@
+# CommerceTransaction
+
+Details of all financial transactions recorded in the commerce or point of sale system are added to the Transactions data type. For example, payments, service charges, and fees.
+
+You can use data from the Transactions endpoints to calculate key metrics, such as:  
+- Transaction volumes  
+- Average transaction volume  
+- Average transaction value  
+- Returns  
+- Payouts
+
+Explore our [data coverage](https://knowledge.codat.io/supported-features/commerce?view=tab-by-data-type&dataType=commerce-transactions) for this data type.
+
+
+## Fields
+
+| Field                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | Type                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | Required                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | Example                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
+| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `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-23T00:00:00.000Z                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
+| `currency`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          | *string*                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            | :heavy_minus_sign:                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  | 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                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
+| `id`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | *string*                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            | :heavy_check_mark:                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  | A unique, persistent identifier for this record                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     | 13d946f0-c5d5-42bc-b092-97ece17923ab                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
+| `modifiedDate`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      | *string*                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            | :heavy_minus_sign:                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  | N/A                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 | 2022-10-23T00:00:00.000Z                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
+| `sourceCreatedDate`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 | *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-23T00:00:00.000Z                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
+| `sourceModifiedDate`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | *string*                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            | :heavy_minus_sign:                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  | N/A                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 | 2022-10-23T00:00:00.000Z                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
+| `subType`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           | *string*                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            | :heavy_minus_sign:                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  | Non-standardised transaction type data from the commerce platform                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   | CardPayment                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
+| `totalAmount`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       | *number*                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            | :heavy_minus_sign:                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  | The total transaction amount                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        | 194.12                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
+| `transactionSourceRef`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              | [TransactionSourceRef](../../models/shared/transactionsourceref.md)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 | :heavy_minus_sign:                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  | Link to the source event which triggered this transaction                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
+| `type`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              | [TransactionType](../../models/shared/transactiontype.md)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           | :heavy_minus_sign:                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  | The type of the platform transaction:  <br/>- `Unknown`  <br/>- `FailedPayout` — Failed transfer of funds from the seller's merchant account to their bank account.  <br/>- `Payment` — Credit and debit card payments.  <br/>- `PaymentFee` — Payment provider's fee on each card payment.  <br/>- `PaymentFeeRefund` — Payment provider's fee that has been refunded to the seller.  <br/>- `Payout` — Transfer of funds from the seller's merchant account to their bank account.  <br/>- `Refund` — Refunds to a customer's credit or debit card.  <br/>- `Transfer` — Secure transfer of funds to the seller's bank account.                                                                                                                                                                                                   |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |

package/docs/models/shared/commercetransactions.md

@@ -0,0 +1,14 @@
+# CommerceTransactions
+
+OK
+
+
+## Fields
+
+| Field                                                               | Type                                                                | Required                                                            | Description                                                         |
+| ------------------------------------------------------------------- | ------------------------------------------------------------------- | ------------------------------------------------------------------- | ------------------------------------------------------------------- |
+| `links`                                                             | [Links](../../models/shared/links.md)                               | :heavy_check_mark:                                                  | N/A                                                                 |
+| `pageNumber`                                                        | *number*                                                            | :heavy_check_mark:                                                  | N/A                                                                 |
+| `pageSize`                                                          | *number*                                                            | :heavy_check_mark:                                                  | N/A                                                                 |
+| `results`                                                           | [CommerceTransaction](../../models/shared/commercetransaction.md)[] | :heavy_minus_sign:                                                  | N/A                                                                 |
+| `totalResults`                                                      | *number*                                                            | :heavy_check_mark:                                                  | N/A                                                                 |

package/docs/models/shared/companies.md

@@ -0,0 +1,14 @@
+# Companies
+
+OK
+
+
+## Fields
+
+| Field                                       | Type                                        | Required                                    | Description                                 |
+| ------------------------------------------- | ------------------------------------------- | ------------------------------------------- | ------------------------------------------- |
+| `links`                                     | [Links](../../models/shared/links.md)       | :heavy_check_mark:                          | N/A                                         |
+| `pageNumber`                                | *number*                                    | :heavy_check_mark:                          | N/A                                         |
+| `pageSize`                                  | *number*                                    | :heavy_check_mark:                          | N/A                                         |
+| `results`                                   | [Company](../../models/shared/company.md)[] | :heavy_minus_sign:                          | N/A                                         |
+| `totalResults`                              | *number*                                    | :heavy_check_mark:                          | N/A                                         |

package/docs/models/shared/company.md

@@ -0,0 +1,22 @@
+# Company
+
+In Codat, a company represents a business sharing access to their data. Each company can have multiple [connections](https://docs.codat.io/lending-api#/schemas/Connection) to different data sources such as one connection to [Xero](https://docs.codat.io/integrations/accounting/xero/accounting-xero) for accounting data, two connections to [Plaid](https://docs.codat.io/integrations/banking/plaid/banking-plaid) for two bank accounts and a connection to [Zettle](https://docs.codat.io/integrations/commerce/zettle/commerce-zettle) for POS data.
+
+Typically each company is one of your customers.
+
+When you create a company, you can specify a `name` and we will automatically generate a unique `id` for the company. You can also add a `description` to store any additional information about the company.
+
+
+## Fields
+
+| Field                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | Type                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | Required                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | Example                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
+| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `created`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           | *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-23T00:00:00.000Z                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
+| `createdByUserName`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 | *string*                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            | :heavy_minus_sign:                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  | N/A                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
+| `dataConnections`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   | [Connection](../../models/shared/connection.md)[]                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   | :heavy_minus_sign:                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  | N/A                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
+| `description`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       | *string*                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            | :heavy_minus_sign:                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  | Additional information about the company. This can be used to store foreign IDs, references, etc.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   | Requested early access to the new financing scheme.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
+| `id`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | *string*                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            | :heavy_check_mark:                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  | Unique identifier for your SMB in Codat.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            | 8a210b68-6988-11ed-a1eb-0242ac120002                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
+| `lastSync`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          | *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-23T00:00:00.000Z                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
+| `name`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              | *string*                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            | :heavy_check_mark:                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  | The name of the company                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             | Codat Ltd.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
+| ~~`platform`~~                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      | *string*                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            | :heavy_minus_sign:                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  | : warning: ** DEPRECATED **: This will be removed in a future release, please migrate away from it as soon as possible.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             | Xero                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
+| `redirect`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          | *string*                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            | :heavy_check_mark:                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  | The `redirect` [Link URL](https://docs.codat.io/auth-flow/authorize-hosted-link) enabling the customer to start their auth flow journey for the company.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            | https://link.codat.io/company/27628208-459c-46a2-a705-5641ce25f739                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |

package/docs/models/shared/companyrequestbody.md

@@ -0,0 +1,9 @@
+# CompanyRequestBody
+
+
+## Fields
+
+| Field                                                                                             | Type                                                                                              | Required                                                                                          | Description                                                                                       | Example                                                                                           |
+| ------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------- |
+| `description`                                                                                     | *string*                                                                                          | :heavy_minus_sign:                                                                                | Additional information about the company. This can be used to store foreign IDs, references, etc. | Requested early access to the new financing scheme.                                               |
+| `name`                                                                                            | *string*                                                                                          | :heavy_check_mark:                                                                                | Name of company being connected.                                                                  | Bank of Dave                                                                                      |