Skip to content

Commit

Permalink
Improved wording
Browse files Browse the repository at this point in the history
  • Loading branch information
phax committed Dec 11, 2023
1 parent 5053286 commit 51879de
Show file tree
Hide file tree
Showing 4 changed files with 21 additions and 24 deletions.
17 changes: 8 additions & 9 deletions src/eusr/docs/bis/doc-section/2busproc/process.adoc
Original file line number Diff line number Diff line change
@@ -1,7 +1,6 @@
= End User Statistics Reporting Process

The following diagrams provide an overview of the key steps when
Service Providers are reporting End User Statistics:
The following diagrams provide an overview of the key steps when SPs are reporting End User Statistics:

image::./images/eusr-process-simple.png[]

Expand All @@ -17,13 +16,13 @@ image::./images/eusr-process-view.png[]
** A Reporting Period ends at 23:59:59 UTC (inclusive) of the last day.

* Data
** Only Service Providers operating a production Peppol Access Point MUST gather this data and transmit an End User Statistics Report.
** Only SPs operating a production Peppol Access Point MUST gather this data and transmit an End User Statistics Report.
** Only Data for the production network MUST be gathered.
** The following data elements MUST be provided for each End User Statistics Report
*** Number of End Users that have sent a Dataset
*** Number of End Users that have received a Dataset
*** Number of End Users that have sent or received a Dataset
*** Peppol Dataset Type (Document Type ID) and Profile ID (Process ID)
*** Number of distinct End Users that have sent a Dataset
*** Number of distinct End Users that have received a Dataset
*** Number of distinct End Users that have sent or received a Dataset
*** Peppol Dataset Type (Document Type ID) and Process ID
*** End Users Country Code
** Only Dataset exchanges that resulted in a positive transport level
acknowledgment (like AS4 Receipts) MUST be included in the End User Statistics Report.
Expand Down Expand Up @@ -52,14 +51,14 @@ subsets MUST be prepared to be compliant with this specification.
** An End User Statistics Report MUST be transmitted once per Reporting Period.
** An End User Statistics Report MUST be transmitted within the Statistics Report Submitting Period, which is defined external to this document, after the end of the previous Reporting Period.
** The End User Statistics Report MUST be transmitted, even if no other Peppol transactions happened in the Reporting Period.
** In case the End User Statistics Report of one Service Provider is received multiple times for one Reporting Period, only the latest received document will be processed.
** In case the End User Statistics Report of one SP is received multiple times for one Reporting Period, only the latest received document will be processed.
** End User Statistics Reports received after the deadline WILL NOT be processed.

* Data
** Only End User Statistics Reports on the Production environment MUST be transmitted. Data for non-production environments MUST NOT be transmitted.
** Each subset key combination MUST NOT occur more than once in an End User Statistics Report.
** The Reporting Period MUST be part of the End User Statistics Report.
** An identifier uniquely identifying the reporting Service Provider MUST be part of the End User Statistics Report.
** An identifier uniquely identifying the reporting SP MUST be part of the End User Statistics Report.

* Network
** End User Statistics Reports MUST be transmitted via the Peppol eDelivery Network.
Expand Down
6 changes: 3 additions & 3 deletions src/eusr/docs/bis/doc-section/3syntax/subset.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -48,7 +48,7 @@ This subset is identifierd by the `@type` attribute having the value `PerDT-EUC`

* This subset requires one `Key` element with a Meta Scheme ID of `DT` (Dataset Type).
The `@schemeID` attribute of this `Key` element MUST be the Document Type Identifier Scheme
of the exchanged Dataset (usually `busdox-docid-qns`). The value of the `Key` element MUST be
of the exchanged Dataset (usually `busdox-docid-qns` or `peppol-doctype-wildcard`). The value of the `Key` element MUST be
the Dataset Type (Document Type) Identifier value of the exchanged dataset.

* This subset requires one `Key` element with a Meta Scheme ID of `CC`
Expand Down Expand Up @@ -80,7 +80,7 @@ This subset is identified by the `@type` attribute having the value `PerDT-PR`.

* This subset requires one `Key` element with a Meta Scheme ID of `DT` (Dataset Type).
The `@schemeID` attribute of this `Key` element MUST be the Document Type Identifier Scheme
of the exchanged Dataset (usually `busdox-docid-qns`). The value of the `Key` element MUST be
of the exchanged Dataset (usually `busdox-docid-qns` or `peppol-doctype-wildcard`). The value of the `Key` element MUST be
the Dataset Type (Document Type) Identifier value of the exchanged dataset.

* This subset requires one `Key` element with Meta Scheme ID of `PR` (Process ID).
Expand Down Expand Up @@ -118,7 +118,7 @@ This subset is identified by the `@type` attribute having the value `PerDT-PR-EU

* This subset requires one `Key` element with a Meta Scheme ID of `DT` (Dataset Type).
The `@schemeID` attribute of this `Key` element MUST be the Document Type Identifier Scheme
of the exchanged Dataset (usually `busdox-docid-qns`). The value of the `Key` element MUST be
of the exchanged Dataset (usually `busdox-docid-qns` or `peppol-doctype-wildcard`). The value of the `Key` element MUST be
the Dataset Type (Document Type) Identifier value of the exchanged dataset.

* This subset requires one `Key` element with Meta Scheme ID of `PR` (Process ID).
Expand Down
18 changes: 8 additions & 10 deletions src/tsr/docs/bis/doc-section/2busproc/process.adoc
Original file line number Diff line number Diff line change
@@ -1,7 +1,6 @@
= Transaction statistics Reporting Process

The following diagrams provide an overview of the key steps when
Service Providers are reporting Transaction Statistics:
The following diagrams provide an overview of the key steps when SPs are reporting Transaction Statistics:

image::./images/tsr-process-simple.png[]

Expand All @@ -17,15 +16,14 @@ image::./images/tsr-process-view.png[]
** A Reporting Period ends at 23:59:59 UTC (inclusive) of the last day.

* Data
** Only Service Providers operating a production Peppol Access Point MUST gather this data and transmit a Transaction Statistics Report.
** Only SPs operating a production Peppol Access Point MUST gather this data and transmit a Transaction Statistics Report.
** Only data for the production network MUST be gathered.
** The following information elements need to be gathered for each exchanged Dataset:
1. Timing of the exchange
2. Direction of the exchange (incoming or outgoing)
3. Sending Peppol Service Provider
4. Receiving Peppol Service Provider
// NOTE: Process ID was deliberately left out in order to ensure alignment with the IR
5. Peppol Dataset Type (Document Type ID)
3. Sending Peppol Service Provider ID
4. Receiving Peppol Service Provider ID
5. Peppol Dataset Type ID (Document Type ID) and Process ID
6. Transport protocol used
7. Country of sender^*^
8. Country of receiver^**^
Expand All @@ -40,7 +38,7 @@ image::./images/tsr-process-view.png[]

NOTE: ^*^ The Country of sender will be mandatory, once the backing eDEC specification becomes mandatory

NOTE: ^**^ The Country of receiver can only be determined by the receiving Service Provider (C3)
NOTE: ^**^ The Country of receiver can only be determined by the receiving SP (C3)

== Data Aggregation

Expand All @@ -63,15 +61,15 @@ The following aggregations MAY be provided to be compliant to this specification
** A Transaction Statistics Report MUST be transmitted once per Reporting Period.
** A Transaction Statistics Report MUST be transmitted within the Statistics Report Submitting Period after the end of the previous Reporting Period.
** The Transaction Statistics Report MUST be transmitted, even if no other Peppol exchange happened in the Reporting Period.
** In case the Transaction Statistics Report of one Service Provider is received multiple times for one Reporting Period, only the latest received document will be processed.
** In case the Transaction Statistics Report of one SP is received multiple times for one Reporting Period, only the latest received document will be processed.
** Transaction Statistics Reports received after the deadline WILL NOT be processed.

* Data
** Only Transaction Statistics Reports on the Production environment MUST be transmitted.
** Each Transaction Statistics Subtotal MUST NOT occur more than once in a Transaction Statistics Report.
** The data of each Transaction Statistics MUST be reported in the designated elements.
** The Reporting Period MUST be part of the Transaction Statistics Report.
** An identifier uniquely identifying the reporting Service Provider MUST be part of the Transaction Statistics Report.
** An identifier uniquely identifying the reporting SP MUST be part of the Transaction Statistics Report.

* Network
** Transaction Statistics Reports MUST be transmitted via the Peppol eDelivery Network.
Expand Down
4 changes: 2 additions & 2 deletions src/tsr/docs/bis/doc-section/3syntax/subtotal.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -50,7 +50,7 @@ The value of the `Key` element MUST follow the rules of the chosen scheme.
* This subtotal requires one `Key` element with a Meta Scheme ID of `DT`
(Dataset Type).
The `schemeID` attribute of this `Key` element MUST be the Document Type
Identifier Scheme of the exchanged Dataset (usually `busdox-docid-qns`).
Identifier Scheme of the exchanged Dataset (usually `busdox-docid-qns` or `peppol-doctype-wildcard`).
The value of the `Key` element MUST be the Dataset Type (Document Type)
Identifier value of the exchanged Dataset.
* This subtotal requires one `Key` element with a Meta Scheme ID of `PR`
Expand Down Expand Up @@ -91,7 +91,7 @@ The value of the `Key` element MUST follow the rules of the chosen scheme.
* This subtotal requires one `Key` element with a Meta Scheme ID of `DT`
(Dataset Type).
The `schemeID` attribute of this `Key` element MUST be the Document Type
Identifier Scheme of the exchanged Dataset (usually `busdox-docid-qns`).
Identifier Scheme of the exchanged Dataset (usually `busdox-docid-qns` or `peppol-doctype-wildcard`).
The value of the `Key` element MUST be the Dataset Type (Document Type)
Identifier value of the exchanged Dataset.
* This subtotal requires one `Key` element with a Meta Scheme ID of `PR`
Expand Down

0 comments on commit 51879de

Please sign in to comment.