Skip to content

Commit 46ba86f

Browse files
author
Codat Pipeline Bot
committed
FOR-621: Update datetime component to reflect offset changes (#40)
1 parent bc61c87 commit 46ba86f

2 files changed

Lines changed: 49 additions & 26 deletions

File tree

‎json/Codat-Bank-Feeds.json‎

Lines changed: 19 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -3961,7 +3961,7 @@
39613961
"transactions": [
39623962
{
39633963
"id": "716422529",
3964-
"date": "2023-08-22T10:21:00Z",
3964+
"date": "2023-08-22T10:21:00",
39653965
"description": "Repayment of Credit Card",
39663966
"counterparty": "Bank of Example",
39673967
"reference": "Ref-12345",
@@ -3972,7 +3972,7 @@
39723972
},
39733973
{
39743974
"id": "716422530",
3975-
"date": "2023-08-22T10:22:00Z",
3975+
"date": "2023-08-22T10:22:00",
39763976
"description": "Amazon Purchase",
39773977
"counterparty": "Amazon",
39783978
"reference": "Ref-12346",
@@ -3983,7 +3983,7 @@
39833983
},
39843984
{
39853985
"id": "716422531",
3986-
"date": "2023-08-22T10:23:00Z",
3986+
"date": "2023-08-22T10:23:00",
39873987
"description": "Office Supplies",
39883988
"counterparty": "Office Mart",
39893989
"reference": "Ref-12347",
@@ -4001,23 +4001,23 @@
40014001
"transactions": [
40024002
{
40034003
"id": "716422529",
4004-
"date": "2023-08-22T10:21:00Z",
4004+
"date": "2023-08-22T10:21:00",
40054005
"description": "Repayment of Credit Card",
40064006
"amount": 100,
40074007
"balance": 100,
40084008
"transactionType": "Credit"
40094009
},
40104010
{
40114011
"id": "716422530",
4012-
"date": "2023-08-22T10:22:00Z",
4012+
"date": "2023-08-22T10:22:00",
40134013
"description": "Amazon Purchase",
40144014
"amount": -100,
40154015
"balance": 0,
40164016
"transactionType": "Debit"
40174017
},
40184018
{
40194019
"id": "716422531",
4020-
"date": "2023-08-22T10:23:00Z",
4020+
"date": "2023-08-22T10:23:00",
40214021
"description": "Office Supplies",
40224022
"amount": -60,
40234023
"balance": -60,
@@ -4032,21 +4032,21 @@
40324032
"transactions": [
40334033
{
40344034
"id": "716422529",
4035-
"date": "2023-08-22T10:21:00Z",
4035+
"date": "2023-08-22T10:21:00",
40364036
"description": "Repayment of Credit Card",
40374037
"amount": 100,
40384038
"transactionType": "Credit"
40394039
},
40404040
{
40414041
"id": "716422530",
4042-
"date": "2023-08-22T10:22:00Z",
4042+
"date": "2023-08-22T10:22:00",
40434043
"description": "Amazon Purchase",
40444044
"amount": -100,
40454045
"transactionType": "Debit"
40464046
},
40474047
{
40484048
"id": "716422531",
4049-
"date": "2023-08-22T10:23:00Z",
4049+
"date": "2023-08-22T10:23:00",
40504050
"description": "Office Supplies",
40514051
"amount": -60,
40524052
"transactionType": "Debit"
@@ -4060,7 +4060,7 @@
40604060
"transactions": [
40614061
{
40624062
"id": "716422529",
4063-
"date": "2023-08-22T10:21:00Z",
4063+
"date": "2023-08-22T10:21:00",
40644064
"description": "Repayment of Credit Card",
40654065
"counterparty": "Bank of Example",
40664066
"reference": "Ref-12345",
@@ -4070,7 +4070,7 @@
40704070
},
40714071
{
40724072
"id": "716422530",
4073-
"date": "2023-08-22T10:22:00Z",
4073+
"date": "2023-08-22T10:22:00",
40744074
"description": "Amazon Purchase",
40754075
"counterparty": "Amazon",
40764076
"reference": "Ref-12346",
@@ -4080,7 +4080,7 @@
40804080
},
40814081
{
40824082
"id": "716422531",
4083-
"date": "2023-08-22T10:23:00Z",
4083+
"date": "2023-08-22T10:23:00",
40844084
"description": "Office Supplies",
40854085
"counterparty": "Office Mart",
40864086
"reference": "Ref-12347",
@@ -5165,7 +5165,13 @@
51655165
"example": "716422529"
51665166
},
51675167
"date": {
5168-
"$ref": "#/components/schemas/DateTime"
5168+
"title": "Local date time",
5169+
"type": "string",
5170+
"examples": [
5171+
"2023-08-22T10:21:00",
5172+
"2023-08-22"
5173+
],
5174+
"description": "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:\n\n```\n2023-08-22T10:21:00\n2023-08-22\n```\n\nWhen pushing bank transaction data to Codat, the date is treated as a local date. This means:\n\n- The date/time is used exactly as provided, without any timezone conversion.\n- If a timezone offset is included (e.g., `2023-08-22T10:21:00-05:00`), the offset will be ignored and only the local date/time portion will be used.\n- We recommend providing dates without a timezone suffix for clarity (e.g., `2023-08-22T10:21:00` rather than `2023-08-22T10:21:00Z`)."
51695175
},
51705176
"description": {
51715177
"type": "string",

‎yaml/Codat-Bank-Feeds.yaml‎

Lines changed: 30 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -2692,7 +2692,7 @@ paths:
26922692
accountId: 49cd5a42-b311-4750-9361-52e2ed1d4653
26932693
transactions:
26942694
- id: '716422529'
2695-
date: '2023-08-22T10:21:00Z'
2695+
date: '2023-08-22T10:21:00'
26962696
description: Repayment of Credit Card
26972697
counterparty: Bank of Example
26982698
reference: Ref-12345
@@ -2701,7 +2701,7 @@ paths:
27012701
balance: 100
27022702
transactionType: Credit
27032703
- id: '716422530'
2704-
date: '2023-08-22T10:22:00Z'
2704+
date: '2023-08-22T10:22:00'
27052705
description: Amazon Purchase
27062706
counterparty: Amazon
27072707
reference: Ref-12346
@@ -2710,7 +2710,7 @@ paths:
27102710
balance: 0
27112711
transactionType: Debit
27122712
- id: '716422531'
2713-
date: '2023-08-22T10:23:00Z'
2713+
date: '2023-08-22T10:23:00'
27142714
description: Office Supplies
27152715
counterparty: Office Mart
27162716
reference: Ref-12347
@@ -2723,19 +2723,19 @@ paths:
27232723
accountId: 49cd5a42-b311-4750-9361-52e2ed1d4653
27242724
transactions:
27252725
- id: '716422529'
2726-
date: '2023-08-22T10:21:00Z'
2726+
date: '2023-08-22T10:21:00'
27272727
description: Repayment of Credit Card
27282728
amount: 100
27292729
balance: 100
27302730
transactionType: Credit
27312731
- id: '716422530'
2732-
date: '2023-08-22T10:22:00Z'
2732+
date: '2023-08-22T10:22:00'
27332733
description: Amazon Purchase
27342734
amount: -100
27352735
balance: 0
27362736
transactionType: Debit
27372737
- id: '716422531'
2738-
date: '2023-08-22T10:23:00Z'
2738+
date: '2023-08-22T10:23:00'
27392739
description: Office Supplies
27402740
amount: -60
27412741
balance: -60
@@ -2745,17 +2745,17 @@ paths:
27452745
accountId: 49cd5a42-b311-4750-9361-52e2ed1d4653
27462746
transactions:
27472747
- id: '716422529'
2748-
date: '2023-08-22T10:21:00Z'
2748+
date: '2023-08-22T10:21:00'
27492749
description: Repayment of Credit Card
27502750
amount: 100
27512751
transactionType: Credit
27522752
- id: '716422530'
2753-
date: '2023-08-22T10:22:00Z'
2753+
date: '2023-08-22T10:22:00'
27542754
description: Amazon Purchase
27552755
amount: -100
27562756
transactionType: Debit
27572757
- id: '716422531'
2758-
date: '2023-08-22T10:23:00Z'
2758+
date: '2023-08-22T10:23:00'
27592759
description: Office Supplies
27602760
amount: -60
27612761
transactionType: Debit
@@ -2764,23 +2764,23 @@ paths:
27642764
accountId: 49cd5a42-b311-4750-9361-52e2ed1d4653
27652765
transactions:
27662766
- id: '716422529'
2767-
date: '2023-08-22T10:21:00Z'
2767+
date: '2023-08-22T10:21:00'
27682768
description: Repayment of Credit Card
27692769
counterparty: Bank of Example
27702770
reference: Ref-12345
27712771
amount: 100
27722772
balance: 100
27732773
transactionType: Credit
27742774
- id: '716422530'
2775-
date: '2023-08-22T10:22:00Z'
2775+
date: '2023-08-22T10:22:00'
27762776
description: Amazon Purchase
27772777
counterparty: Amazon
27782778
reference: Ref-12346
27792779
amount: -100
27802780
balance: 0
27812781
transactionType: Debit
27822782
- id: '716422531'
2783-
date: '2023-08-22T10:23:00Z'
2783+
date: '2023-08-22T10:23:00'
27842784
description: Office Supplies
27852785
counterparty: Office Mart
27862786
reference: Ref-12347
@@ -3570,7 +3570,24 @@ components:
35703570
description: 'Identifier for the bank account transaction, unique for the company in the accounting software.'
35713571
example: '716422529'
35723572
date:
3573-
$ref: '#/components/schemas/DateTime'
3573+
title: Local date time
3574+
type: string
3575+
examples:
3576+
- '2023-08-22T10:21:00'
3577+
- '2023-08-22'
3578+
description: |-
3579+
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:
3580+
3581+
```
3582+
2023-08-22T10:21:00
3583+
2023-08-22
3584+
```
3585+
3586+
When pushing bank transaction data to Codat, the date is treated as a local date. This means:
3587+
3588+
- The date/time is used exactly as provided, without any timezone conversion.
3589+
- If a timezone offset is included (e.g., `2023-08-22T10:21:00-05:00`), the offset will be ignored and only the local date/time portion will be used.
3590+
- We recommend providing dates without a timezone suffix for clarity (e.g., `2023-08-22T10:21:00` rather than `2023-08-22T10:21:00Z`).
35743591
description:
35753592
type: string
35763593
nullable: true

0 commit comments

Comments
 (0)