develop #38

Merged
bboterm merged 451 commits from develop into main 2025-11-19 14:28:14 +00:00
2 changed files with 1966 additions and 361 deletions
Showing only changes of commit 2bb61cbe98 - Show all commits

View File

@ -18,14 +18,14 @@ paths:
content:
application/json:
schema:
$ref: "#/components/schemas/TransactionItemsPostRequestBody"
$ref: "#/components/schemas/unavailable"
responses:
"201":
description: Created
content:
application/json:
schema:
$ref: "#/components/schemas/TransactionItemsPostResponseBody"
$ref: "#/components/schemas/unavailable"
/fiko/transactionitems/bulk:
post:
summary: Add one ore more finanicial transaction items in bulk.
@ -59,6 +59,15 @@ paths:
format: uuid
example: 75174a9d-fff4-4682-b66b-ebd93cbe7ea3
description: The id of the transaction item.
- in: query
name: transactionType
schema:
type: array
items:
type: string
example: [sales]
explode: false
description: Possible types of the transaction ('sales').
- in: query
name: sourceName
schema:
@ -142,6 +151,15 @@ paths:
type: string
example: HTM-MND-20
description: The product code of the transaction.
- in: query
name: status
schema:
type: array
items:
type: string
example: [created, succeeded, failed, returned to trx-db, returned to src, re-entered]
explode: false
description: Possible statuses of the transaction ('created', 'succeeded', 'failed', 'returned to trx-db', 'returned to src', 're-entered').
- in: query
name: aggregationReference
schema:
@ -154,15 +172,6 @@ paths:
type: string
example: U4F-123456
description: The accounting system reference of the transaction. %00 is searching for NULL-values.
- in: query
name: highestProcessingFailureStatus
schema:
type: array
items:
type: string
example: [open]
explode: false
description: Find the highest processing failure status of the transaction. %00 is searching for NULL-values.
responses:
"200":
description: OK
@ -171,8 +180,9 @@ paths:
schema:
$ref: "#/components/schemas/TransactionItemsGetResponseBody"
post:
summary: Add a finanicial transaction item.
description: Add a finanicial transaction item.
summary: DEPRECATED. Add a finanicial transaction item.
description: DEPRECATED. This API is deprecated. Use bulk-insert instead.
deprecated: true
tags:
- Transactions v2
requestBody:
@ -317,9 +327,18 @@ paths:
type: array
items:
type: string
example: [created, succeeded, failed]
example: [create, update]
explode: false
description: The action of the event.
- in: query
name: status
schema:
type: array
items:
type: string
example: [created, succeeded, failed, returned to trx-db, returned to src, re-entered]
explode: false
description: The status of the transaction item.
- in: query
name: description
schema:
@ -361,75 +380,53 @@ paths:
example: 9834b346-d68c-438d-9bd5-6716422c2657
description: The id of the transaction item.
- in: query
name: department
name: timestampBefore
schema:
type: string
example: 900
description: The department (element 1) of the processing failure.
example: 2022-01-01 00:00:00
description: The timestamp before the event occured.
- in: query
name: costCenter
name: timestampAfter
schema:
type: string
example: 2022-01-01 00:00:00
description: The timestamp after the event occured.
- in: query
name: element
schema:
type: string
example: contraAccount
description: The element on which the validation failed.
- in: query
name: value
schema:
type: string
example: 84955
description: The cost center (element 3) of the processing failure.
description: The value of th element on which the validation failed.
- in: query
name: costType
name: reasonCode
schema:
type: string
example: 619031
description: The cost type (element 2) of the processing failure.
example: "002"
description: The code of the validation failure reason.
- in: query
name: documentDate
name: reasonDescription
schema:
type: string
format: date
example: 2024-10-04
description: The document date of the processing failure.
example: Contra account does not exist.
description: The description of the validation failure reason.
- in: query
name: documentCode
name: resolved
schema:
type: boolean
example: true
description: Whether the failure is resolved.
- in: query
name: change
schema:
type: string
example: VERK_FACTUUR
description: The document code of the processing failure.
- in: query
name: accountingPeriod
schema:
type: string
example: 2024/10
description: The accounting period of the processing failure.
- in: query
name: transactionDescription
schema:
type: string
example: Dagkaart
description: The transaction description of the processing failure.
- in: query
name: contraAccount
schema:
type: string
example: 220.10419
description: The contra account of the processing failure.
- in: query
name: status
schema:
type: array
items:
type: string
example: [open, rejected]
explode: false
description: The status of the processing failure.
- in: query
name: minOccurences
schema:
type: integer
example: 1
description: Minimum number of occurences.
- in: query
name: maxOccurences
schema:
type: integer
example: 3
description: Maximum number of occurences.
example: Adapt config
description: Description of what was changed to resolve the failure.
responses:
"200":
description: OK
@ -464,60 +461,6 @@ paths:
application/json:
schema:
$ref: "#/components/schemas/ProcessingFailuresPatchResponseBody"
/processingfailures/{processingFailureId}/processingfailureinstances:
parameters:
- in: path
name: processingFailureId
schema:
type: string
format: uuid
example: 37a8095b-19db-498f-9349-5f37d21c5bdf
required: true
description: The id of the processing failure.
post:
summary: Add a processing failure instance to a processing failure.
description: Add a processing failure instance to a processing failure.
tags:
- Failures v2
requestBody:
content:
application/json:
schema:
$ref: "#/components/schemas/ProcessingFailureInstancesPostRequestBody"
responses:
"201":
description: Created
content:
application/json:
schema:
$ref: "#/components/schemas/ProcessingFailureInstancesPostResponseBody"
/processingfailureinstances/{processingFailureInstanceId}:
parameters:
- in: path
name: processingFailureInstanceId
schema:
type: string
format: uuid
example: 37a8095b-19db-498f-9349-5f37d21c5bdf
required: true
description: The id of the processing failure instance.
patch:
summary: Update processing failure instance.
description: Update processing failure instance.
tags:
- Failures v2
requestBody:
content:
application/json:
schema:
$ref: "#/components/schemas/ProcessingFailureInstancesPatchRequestBody"
responses:
"200":
description: OK
content:
application/json:
schema:
$ref: "#/components/schemas/ProcessingFailureInstancesPatchResponseBody"
/productmetadata:
get:
summary: Find product metadata.
@ -1364,19 +1307,6 @@ paths:
application/json:
schema:
$ref: "#/components/schemas/ConcessionsGetResponseBody"
/failurereasons:
get:
summary: Get all failure reasons.
description: Get all failure reasons.
tags:
- References v2
responses:
"200":
description: OK
content:
application/json:
schema:
$ref: "#/components/schemas/FailureReasonsGetResponseBody"
components:
securitySchemes:
bearerToken:
@ -1397,6 +1327,11 @@ components:
transactionItemId:
type: string
example: afce35b2-1dff-4ace-98d0-4b9ac405c87d
transactionType:
type: string
enum:
- sales
example: sales
sourceName:
type: string
example: Verkoopengine
@ -1437,7 +1372,18 @@ components:
example: debit
productCode:
type: string
nullable: true
example: HTM-MND-20
status:
type: string
enum:
- created
- succeeded
- failed
- returned to trx-db
- returned to src
- re-entered
example: created
aggregationReference:
type: string
nullable: true
@ -1448,6 +1394,7 @@ components:
example: U4F-123456
required:
- transactionItemId
- transactionType
- sourceName
- transactionId
- name
@ -1458,7 +1405,7 @@ components:
- amountTax
- occurredOn
- type
- productCode
- status
href:
type: string
nullable: true
@ -1467,6 +1414,11 @@ components:
TransactionItemsPostRequestBody:
type: object
properties:
transactionType:
type: string
enum:
- sales
example: sales
sourceName:
type: string
example: Verkoopengine
@ -1507,8 +1459,20 @@ components:
example: debit
productCode:
type: string
nullable: true
example: HTM-MND-20
status:
type: string
enum:
- created
- succeeded
- failed
- returned to trx-db
- returned to src
- re-entered
example: created
required:
- transactionType
- sourceName
- transactionId
- name
@ -1519,7 +1483,7 @@ components:
- amountTax
- occurredOn
- type
- productCode
- status
TransactionItemsPostResponseBody:
type: object
properties:
@ -1537,6 +1501,11 @@ components:
items:
type: object
properties:
transactionType:
type: string
enum:
- sales
example: sales
sourceName:
type: string
example: Verkoopengine
@ -1577,9 +1546,11 @@ components:
example: debit
productCode:
type: string
nullable: true
example: HTM-MND-20
required:
- sourceName
- transactionType
- transactionId
- name
- quantity
@ -1591,19 +1562,121 @@ components:
- type
- productCode
TransactionItemsBulkPostResponseBody:
type: object
properties:
summary:
type: object
properties:
created:
type: integer
example: 15
updated:
type: integer
example: 2
total:
type: integer
example: 17
required:
- created
- updated
- total
required:
- summary
TransactionItemsBulkBadRequestResponseBody:
type: object
properties:
type:
type: string
format: url
example: https://htm.nl/api/v1/probs/fiko/validationerror
title:
type: string
example: Transaction validation failed.
detail:
type: string
example: One ore more transactions in the request are invalid.
instance:
type: string
example: urn:uuid:4017fabc-1b28-11e8-accf-0ed5f89f718b
errors:
type: array
items:
type: object
properties:
transactionItemId:
detail:
type: string
format: uuid
example: afce35b2-1dff-4ace-98d0-4b9ac405c87d
example: Transaction is a duplicate of a transaction already in the system.
pointer:
type: string
example: "#/transactionItems/0"
transactionId:
type: string
example: 1ad109d3-fd7d-4b6f-872b-220d492f385f
transactionLineId:
type: string
example: fee907dd-e59d-44f5-a63b-bbdec38f79b7
required:
- transactionItemId
- detail
- pointer
- transactionId
required:
- type
- title
- detail
- instance
TransactionItemsPatchRequestBody:
type: object
properties:
name:
type: string
nullable: true
example: HTM Maandkorting 20%
quantity:
type: integer
nullable: true
example: 1
taxCode:
type: string
nullable: true
example: V21
amountExclTax:
type: integer
nullable: true
example: 100
amountInclTax:
type: integer
nullable: true
example: 121
amountTax:
type: integer
nullable: true
example: 21
occurredOn:
type: string
nullable: true
format: date-time
example: 2024-10-04T00:00:00Z
type:
type: string
nullable: true
enum:
- debit
- credit
example: debit
productCode:
type: string
nullable: true
example: HTM-MND-20
status:
type: string
enum:
- created
- succeeded
- failed
- returned to trx-db
- returned to src
- re-entered
example: created
aggregationReference:
type: string
nullable: true
@ -1624,57 +1697,36 @@ components:
ProcessingFailuresPostRequestBody:
type: object
properties:
department:
timestamp:
type: string
nullable: true
example: 900
costCenter:
format: date-time
example: 2022-01-01 00:00:00
element:
type: string
example: costCenter
value:
type: string
nullable: true
example: 84955
costType:
reasonCode:
type: string
example: "002"
reasonDescription:
type: string
example: Contra account does not exist.
resolved:
type: boolean
example: false
change:
type: string
nullable: true
example: 619031
documentDate:
type: string
format: date
nullable: true
example: 2022-01-01
documentCode:
type: string
nullable: true
example: VERK_FACTUUR
accountingPeriod:
type: string
nullable: true
example: 2024/10
transactionDescription:
type: string
nullable: true
example: Dagkaart
contraAccountNumber:
type: string
nullable: true
example: 220.10419
status:
type: string
enum:
- open
- returned to trx-db
- returned to src
example: open
occurence:
type: integer
example: 1
processingFailureInstances:
type: array
items:
$ref: "#/components/schemas/ProcessingFailureInstancesPostRequestBody"
example: Adapt config
required:
- status
- occurence
- processingFailureInstances
- timestamp
- element
- value
- reasonCode
- reasonDescription
- resolved
ProcessingFailuresPostResponseBody:
type: object
properties:
@ -1700,86 +1752,38 @@ components:
type: string
format: uuid
example: 2d77d978-7141-499a-84ad-93fad8ee03ce
department:
type: string
nullable: true
example: 900
costCenter:
type: string
nullable: true
example: 84955
costType:
type: string
nullable: true
example: 619031
documentDate:
type: string
format: date
nullable: true
example: 2022-01-01
documentCode:
type: string
nullable: true
example: VERK_FACTUUR
accountingPeriod:
type: string
nullable: true
example: 2024/10
transactionDescription:
type: string
nullable: true
example: Dagkaart
contraAccountNumber:
type: string
nullable: true
example: 220.10419
status:
type: string
enum:
- open
- returned to trx-db
- returned to src
example: open
occurence:
type: integer
example: 1
processingFailureInstances:
type: array
items:
type: object
properties:
processingFailureInstanceId:
type: string
format: uuid
example: 9afa9a6b-5b6a-4b0a-9c9e-4b0a5b6a4b0a
timestamp:
type: string
format: date-time
example: 2022-01-01 00:00:00
failureReason:
$ref: "#/components/schemas/FailureReason"
element:
type: string
example: costCenter
occurence:
type: integer
example: 1
value:
type: string
example: 84955
reasonCode:
type: string
example: "002"
reasonDescription:
type: string
example: Contra account does not exist.
resolved:
type: boolean
example: false
change:
type: string
nullable: true
example: Adapt config
required:
- processingFailureInstanceId
- timestamp
- failureReason
- element
- occurence
required:
- processingFailureId
- transactionItemId
- status
- occurence
- processingFailureInstances
- timestamp
- element
- value
- reasonCode
- reasonDescription
- resolved
href:
type: string
nullable: true
@ -1788,18 +1792,14 @@ components:
ProcessingFailuresPatchRequestBody:
type: object
properties:
status:
resolved:
type: boolean
nullable: true
example: true
change:
type: string
enum:
- open
- returned to trx-db
- returned to src
nullable: true
example: returned to trx-db
occurence:
type: integer
nullable: true
example: 2
example: Adapt config
ProcessingFailuresPatchResponseBody:
type: object
properties:
@ -1809,65 +1809,6 @@ components:
example: 37a8095b-19db-498f-9349-5f37d21c5bdf
required:
- processingFailureId
ProcessingFailureInstancesPostRequestBody:
type: object
properties:
timestamp:
type: string
format: date-time
example: 2022-01-01 00:00:00
failureReasonId:
type: integer
example: 1
element:
type: string
example: costCenter
occurence:
type: integer
example: 1
change:
type: string
nullable: true
example: Adapt config
required:
- timestamp
- failureReason
- element
- occurence
ProcessingFailureInstancesPostResponseBody:
type: object
properties:
processingFailureInstanceId:
type: string
format: uuid
example: 37a8095b-19db-498f-9349-5f37d21c5bdf
required:
- processingFailureInstanceId
ProcessingFailureInstancesPatchRequestBody:
type: object
properties:
timestamp:
type: string
format: date-time
nullable: true
example: 2022-01-01 00:00:00
occurence:
type: integer
nullable: true
example: 1
change:
type: string
nullable: true
example: Adapt config
ProcessingFailureInstancesPatchResponseBody:
type: object
properties:
processingFailureInstanceId:
type: string
format: uuid
example: 37a8095b-19db-498f-9349-5f37d21c5bdf
required:
- processingFailureInstanceId
TransactionAuditTrailsPostRequestBody:
type: object
properties:
@ -1879,6 +1820,12 @@ components:
format: date-time
example: 2022-01-01 00:00:00
action:
type: string
enum:
- create
- update
example: create
status:
type: string
enum:
- created
@ -1886,6 +1833,7 @@ components:
- failed
- returned to trx-db
- returned to src
- re-entered
example: created
description:
type: string
@ -1900,6 +1848,7 @@ components:
- user
- timestamp
- action
- status
TransactionAuditTrailsPostResponseBody:
type: object
properties:
@ -1933,6 +1882,12 @@ components:
format: date-time
example: 2022-01-01 00:00:00
action:
type: string
enum:
- create
- update
example: create
status:
type: string
enum:
- created
@ -1940,6 +1895,7 @@ components:
- failed
- returned to trx-db
- returned to src
- re-entered
example: created
description:
type: string
@ -1956,6 +1912,7 @@ components:
- user
- timestamp
- action
- status
href:
type: string
nullable: true
@ -2824,18 +2781,6 @@ components:
nullable: true
description: URI for pagination.
example: null
FailureReasonsGetResponseBody:
type: object
properties:
failureReasons:
type: array
items:
$ref: '#/components/schemas/FailureReason'
href:
type: string
nullable: true
description: URI for pagination.
example: null
ContraAccountMetadata:
type: object
properties:
@ -2917,22 +2862,6 @@ components:
- rejectionProcessing
- rejectionInfo
- validFrom
FailureReason:
type: object
properties:
failureReasonId:
type: integer
example: 2
reasonCode:
type: string
example: "002"
reasonDesc:
type: string
example: Contra account does not exist
required:
- failureReasonId
- reasonCode
- reasonDesc
rfc9457:
type: object
properties:

File diff suppressed because it is too large Load Diff