diff --git a/app/docs/api/oas-purchase-to-pay.mdx b/app/docs/api/oas-purchase-to-pay.mdx index c0906af..cc0002b 100644 --- a/app/docs/api/oas-purchase-to-pay.mdx +++ b/app/docs/api/oas-purchase-to-pay.mdx @@ -3,12 +3,6 @@ title: OAS Purchase to Pay hide_table_of_contents: true --- -:::caution PUBLIC CONSULTATION -This API specification and the JSON Schemas referenced herein are under **public consultation**. - -Feedback and suggestions are welcome to help refine and finalize these documents. -::: - This OpenAPI specification defines a set of APIs for the exchange of the SETU Purchase to Pay V2 messages. SETU has created several standardized messages to facilitate the processes involved in ordering and selecting human resources, assigning the human resource using the assignment, and reporting time and expenses. This includes staffing orders, human resources, assignments, timecards and invoices. The APIs are designed to be implemented primarily by backoffice systems of both the staffing customer and the staffing supplier. This page provides documentation about the OpenAPI specification. The APIs are organized into tags for easy navigation and include descriptions for each set of APIs. The available tags include `Staffing Order`, `Human Resource`, `Assignment`, `Timecard`, and `Invoice`, which include the API calls related to the different sets of SETU Purchase to Pay messages. Additionally, this API specification also provides tags for common processes that our encountered during the use of the Purchase to Pay messages. These processes include the creation, retrieval, update, and deletion of various resources necessary for the purchase-to-pay process. diff --git a/app/docs/purchase-to-pay-v2/OrderingSelection.md b/app/docs/purchase-to-pay-v2/OrderingSelection.md index 46b2d69..4fe71a0 100644 --- a/app/docs/purchase-to-pay-v2/OrderingSelection.md +++ b/app/docs/purchase-to-pay-v2/OrderingSelection.md @@ -1,11 +1,5 @@ # Ordering & Selection and Assignment -:::caution DRAFT VERSION -The SETU Standard for Ordering & Selection, Assignment and Reporting Time & Expenses (Timecard) v2.0 are currently under review. The documentation in this section is a draft and subject to change. - -We expect to release the final documentation at the end of 2024. -::: - :::info DOCUMENTATION The message models can be found in [Semantic Treehouse](https://setu.semantic-treehouse.nl/specifications). There you can also find example messages and validation artifacts in both XML and JSON. diff --git a/app/docs/purchase-to-pay-v2/Public consultation.md b/app/docs/purchase-to-pay-v2/Public consultation.md deleted file mode 100644 index a39903a..0000000 --- a/app/docs/purchase-to-pay-v2/Public consultation.md +++ /dev/null @@ -1,16 +0,0 @@ -### SETU Standards for Purchase to pay v2.0 DRAFT - -In the past period, the working group on SETU v2.0 has worked on the development of the 2.0 version of SETU Standards for Purchase to Pay. We would like to invite you to take note of this and to provide us with comments on the SETU Standard for Purchase to Pay v2.0 DRAFT. It contains the following message specifications: - -- [Staffing Order:](https://setu.semantic-treehouse.nl/message-model-tree/Message_8ce31bab-da16-4e48-aac7-c745b1080bb1?panes=element_tree:Message_8ce31bab-da16-4e48-aac7-c745b1080bb1:v87px1:primary) for matching a human resource to an open position. -- [Human Resource:](https://setu.semantic-treehouse.nl/message-model-tree/Message_da7a87ec-72c9-414e-8da0-e4f942eb1a7c?panes=element_tree:Message_da7a87ec-72c9-414e-8da0-e4f942eb1a7c:q2hhbw:primary) for matching a human resource to an open position. -- [Assignment:](https://setu.semantic-treehouse.nl/message-model-tree/Message_fc07cc98-14b0-4e7c-a52b-3240baa46194?panes=element_tree:Message_fc07cc98-14b0-4e7c-a52b-3240baa46194:51f8vt:primary) for confirming the placement of a human resource to a position. -- [Timecard:](https://setu.semantic-treehouse.nl/message-model-tree/Message_39a2ff1b-43b3-40fc-930e-d85488bb57bb?panes=element_tree:Message_39a2ff1b-43b3-40fc-930e-d85488bb57bb:be72zv:primary) for reporting time & expenses in the staffing industry. - -The specifications can also be accessed via our [SETU standards portal](https://setu.semantic-treehouse.nl/#/Projects) and more information can be found about the public consultation and how to give your reactions: [How to review?](./review-public.md) - -Responses from this public consultation will be considered by SETU, discussed with the working group and, where necessary, the draft versions will be adjusted before they are given the RELEASE status. - -This consultation runs from 5 Nov 2024 to 5 Dec 2024. - -If you have any questions, please send them to info@setu.nl. diff --git a/app/docs/purchase-to-pay-v2/README.md b/app/docs/purchase-to-pay-v2/README.md index 062a1d3..fefdeeb 100644 --- a/app/docs/purchase-to-pay-v2/README.md +++ b/app/docs/purchase-to-pay-v2/README.md @@ -1,13 +1,5 @@ # Purchase to Pay v2.0 -:::caution DRAFT VERSION -The SETU Standard for Ordering & Selection, Assignment and Reporting Time & Expenses (Timecard) v2.0 are currently under review. The documentation in this section is a draft and subject to change. - -A **public consultation** that will be performed for all message specifications around November 2024. During the public consultation interested parties are invited to review the delivered standard and provide review comments. Those responses are considered by the SETU, will be discussed with the working group and, where necessary, the draft version will be adjusted before final publication. - -We expect to release the final documentation at the end of 2024. -::: - :::info DOCUMENTATION The message models can be found in [Semantic Treehouse](https://setu.semantic-treehouse.nl/specifications). There you can also find example messages and validation artifacts in both XML and JSON. @@ -25,4 +17,9 @@ The SETU specified multiple message specifications to exchange purchase to pay i ## Relation to HR Open standard The new 2.0 versions of the 'Purchase to Pay' SETU standards are based on a standardized SETU language in which concepts and relationships with associated terminology and definitions are specified. This SETU language provides building blocks from which to compose messages. The SETU reuses the terminology and data definitions of the latest version 4.3 of the international [HR Open standard](https://www.hropenstandards.org/) as much as possible for its SETU language. Where necessary additional relationships have been established in the SETU language between existing HR Open concepts, or new concepts have been introduced. Definitions have also been improved and made more suitable for the Dutch context. -In addition to the reuse of HR Open v4.3, the insights gained from the development of the SETU Standard for Planning & Scheduling v1.0 have also been used. Where possible, concepts and definitions from that SETU standard have also been applied to the new versions of the 'Purchase to pay' messages to make the new set of SETU standards as uniform as possible. Open change requests from the 1.x versions of the SETU standards have also been processed during the development of this version 2.0 set of standards. \ No newline at end of file +In addition to the reuse of HR Open v4.3, the insights gained from the development of the SETU Standard for Planning & Scheduling v1.0 have also been used. Where possible, concepts and definitions from that SETU standard have also been applied to the new versions of the 'Purchase to pay' messages to make the new set of SETU standards as uniform as possible. Open change requests from the 1.x versions of the SETU standards have also been processed during the development of this version 2.0 set of standards. + +## Public consultation +A public consultation was performed from 5 November 2024 to 5 December 2024. + +Interested parties were invited to review the delivered standards and provide review comments. No responses were received. The final version is released on 17 December 2024. \ No newline at end of file diff --git a/app/docs/purchase-to-pay-v2/SequenceDiagrams.md b/app/docs/purchase-to-pay-v2/SequenceDiagrams.md index cf84a7c..d6c9c5f 100644 --- a/app/docs/purchase-to-pay-v2/SequenceDiagrams.md +++ b/app/docs/purchase-to-pay-v2/SequenceDiagrams.md @@ -1,11 +1,5 @@ # Sequence diagrams -:::caution DRAFT VERSION -The SETU Standard for Ordering & Selection, Assignment and Reporting Time & Expenses (Timecard) v2.0 are currently under review. The documentation in this section is a draft and subject to change. - -We expect to release the final documentation at the end of 2024. -::: - The page contains several sequence diagrams illustrating the communication between the backoffice systems of a staffing supplier and a staffing customer for exchanging the SETU Purchase to Pay messages.