Skip to content

Commit

Permalink
Merge pull request #102 from OpenPEPPOL/2024-q2-dev
Browse files Browse the repository at this point in the history
2024 q2 dev
  • Loading branch information
jerouris authored May 22, 2024
2 parents 7cee448 + c2a5f51 commit c80f6fa
Show file tree
Hide file tree
Showing 92 changed files with 853 additions and 202 deletions.
10 changes: 5 additions & 5 deletions guides/methodology/snippets/snippet-01.xml
Original file line number Diff line number Diff line change
Expand Up @@ -30,14 +30,14 @@
<cac:BuyerCustomerParty>
<cac:Party>
<cac:PartyIdentification>
<cbc:ID schemeID="SE:ORGNR">5541277711</cbc:ID>
<cbc:ID schemeID="SE:ORGNR">5541277710</cbc:ID>
</cac:PartyIdentification>
<cac:PartyName>
<cbc:Name>City Hospital</cbc:Name>
</cac:PartyName>
<cac:PartyLegalEntity>
<cbc:RegistrationName>City Hospital 345433</cbc:RegistrationName>
<cbc:CompanyID schemeID="SE:ORGNR">5541277711</cbc:CompanyID>
<cbc:CompanyID schemeID="SE:ORGNR">5541277710</cbc:CompanyID>
<cac:RegistrationAddress>
<cbc:CityName>Eurocity</cbc:CityName>
<cac:Country>
Expand Down Expand Up @@ -108,9 +108,9 @@
<!-- tag::invoicee[] -->
<cac:AccountingCustomerParty>
<cac:Party>
<cbc:EndpointID schemeID="SE:ORGNR">5544332211</cbc:EndpointID>
<cbc:EndpointID schemeID="SE:ORGNR">5544332215</cbc:EndpointID>
<cac:PartyIdentification>
<cbc:ID schemeID="SE:ORGNR">5544332211</cbc:ID>
<cbc:ID schemeID="SE:ORGNR">5544332215</cbc:ID>
</cac:PartyIdentification>
<cac:PartyName>
<cbc:Name>Swedish Hospitals</cbc:Name>
Expand All @@ -130,7 +130,7 @@
</cac:PostalAddress>
<cac:PartyLegalEntity>
<cbc:RegistrationName>Swedish Hospitals AB</cbc:RegistrationName>
<cbc:CompanyID>5544332211</cbc:CompanyID>
<cbc:CompanyID>5544332215</cbc:CompanyID>
<cac:RegistrationAddress>
<cbc:CityName>Stockholm</cbc:CityName>
<cac:Country>
Expand Down
1 change: 1 addition & 0 deletions guides/profiles/1-catalogueonly/process/usecase5.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -22,6 +22,7 @@ Customer/Buyer
|*Assumptions* a|
1. The Seller has previously sent a catalogue to the Buyer which has been accepted.
2. The Seller needs to send a new article to update the previous catalogue.
3. One of the rows handle deposit.

|*The flow* a|
1. The Seller identifies the article to be added
Expand Down
9 changes: 6 additions & 3 deletions guides/profiles/18-punchout/transport/index.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -7,19 +7,22 @@ The Peppol BIS BIS is specified independent of a transport network but it is des
[[the-peppol-network]]
== The Peppol network

The Peppol transport network is a four corner transport network that allows senders end receivers to exchange messages from one service provider to another by using a single identifier for the parties.
The Peppol transport network is a four corner transport network that allows senders and receivers to exchange messages from one service provider to another by using a single identifier for the parties.

There are some challenges related to the delay of message transfer when using an asynchronous exchange model like the Peppol network. The user who created the shopping cart will have to wait for the message to be received in the purchasing system and there is no specified maximum time limit set for this. When the message is received, it will need to be directed to an identified user or user session. There is no business term in the shopping cart for this purpose other than the Buyer reference identifier (tir77-045). Before using this BIS together with an asynchronous transfer model, the parties should agree on time limits and reference mechanisms.

Details about the Peppol network can be found at [PeppolTransp]

[[synchronous-message-transfer]]
== Synchronous message transfer

It is recognized that the use of Punch Out often requires synchronous methods for retrieving that data directly from the sellers shopping cart into the buyers purchasing system.
It is recognized that the use of Punch Out often requires synchronous methods for retrieving that data directly from the sellers shopping cart into the buyers purchasing system.
Several methods are available including the following:

* Direct database connections with HTTP using database interface specifications.
* File download using Wget, HTTP, FTP or similar technology.

The following clauses only briefly introduce these transfer mechanism.
The following clauses only briefly introduce examples of transfer mechanisms.
Analysis of what is the most suitable methods and technical specification are not in scope for this BIS and are not provided by Peppol.

[[direct-http-database-connections]]
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -22,6 +22,7 @@ Customer/Buyer.
|*Assumptions* a|
1. The Seller has previously sent a catalogue to the Buyer which has been accepted.
2. The Seller needs to send a new article to update the previous catalogue.
3. One of the rows handle deposit.

|*The flow* a|
1. The Seller identifies the article to be added.
Expand Down
2 changes: 2 additions & 0 deletions guides/release-notes/main.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -15,6 +15,8 @@ IMPORTANT: Changes in code lists are also reflected by changes in the validation

:leveloffset: +1

include::v3.0.13.adoc[]

include::v3.0.12.adoc[]

include::v3.0.11.adoc[]
Expand Down
32 changes: 32 additions & 0 deletions guides/release-notes/v3.0.13.adoc
Original file line number Diff line number Diff line change
@@ -0,0 +1,32 @@
= Version 3.0.13
[horizontal]
Release date:: May 2024

== BIS documentation

* BIS Catalogue
** Clarified the use of item identifiers. Previously unclear in the description if "either one of" or "at least one of" Sellers Identifier or Standard Identifier must be stated. It is now clear that it is "at least one of". This change is in line with existing validation rules of the existence of the identifiers.
** Statement that Manufacturers item identifier must be stated if it exists is deleted since it was unclear how to interpret the statement and to impossible to verify.
** Updated use case 5 to describe the use of deposits using RequiredRelatedItem

== Changes to syntax
* Order transaction (T01)

* Order Response transaction (T76)
* Order Response transaction Advanced (T116)

* Catalogue transaction (T19)
** Added possibility (by use of a code) to indicate if an item is non-returnable after purchase. The element cac:TransactionConditions/cbc:ActionCode on item-level is used and the code is added to the codelist "Transaction condition code (OpenPeppol)", together with the previous code to indicate if an item is contracted (CT). The element cbc:ActionCode was previously fixed to the value 'CT' since it was the only allowed code, but with this change, it can be used for both purposes.
** Time may be given with time zone information.

== Changes to code lists and validation artefacts

* Update of PEPPOL-COMMON-R049 which validates identifiers using ICD/EAS 0007. The change is adding validation of the check number of a Swedish Organization number.

* Added rule to check that an OrderResponse with ResponseTypeCode CA (accepted with amendment on line level) actually has order response lines. The rule is introduced with severity warning and will be changed to severity fatal in next release. The rule is added to both T76 (Order Responseand) and T116 (Order Response Advanced).

* Added rule to check that an OrderResponse with ResponseTypeCode AP or RE should not have order response lines. The rule is introduced with severity warning and will be changed to severity fatal in next release. The rule is added to both T76 (Order Responseand) and T116 (Order Response Advanced).

* Added rule to check that an OrderResponse with ResponseTypeCode AB must not have order response lines. The rule is introduced with severity error. The rule is added to both T76 (Order Responseand) and T116 (Order Response Advanced).

== Other
9 changes: 6 additions & 3 deletions guides/shared/datatypes/time.adoc
Original file line number Diff line number Diff line change
@@ -1,11 +1,14 @@

= Time

Time shall be in accordance to the “Extended time format” as specified by {ISO8601}, format [hh]:[mm]:[ss].

Time shall be in accordance to the “Extended time format” as specified by {ISO8601}, +
- format without time zone [hh]:[mm]:[ss] +
- format with UTC timezone [hh]:[mm]:[ss]Z +
- format for other zones [hh]:[mm]:[ss]±[hh:mm] with zone is given as difference from UTC.

====
IMPORTANT: Time shall *not* include timezone information. Decimal fraction on seconds SHALL not be used.
IMPORTANT: Time may include timezone information. +
Decimal fraction on seconds SHALL not be used.
====


Expand Down
2 changes: 1 addition & 1 deletion guides/shared/snippets/snippet-oa-vat.xml
Original file line number Diff line number Diff line change
Expand Up @@ -31,7 +31,7 @@
<cac:Party>
<cbc:EndpointID schemeID="GLN">5790000436095</cbc:EndpointID>
<cac:PartyIdentification>
<cbc:ID schemeID="0007">5541277711</cbc:ID>
<cbc:ID schemeID="0007">5541277710</cbc:ID>
</cac:PartyIdentification>

<cac:PostalAddress>
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -8,9 +8,7 @@ Item identification must be sent using the identifiers described below.
* Manufacturers item identification which is necessary when the same product is bought from several suppliers.
* Buyers item identification

Either Sellers item identification or Standard item identification must be sent.
Manufacturer’s item identification shall be sent if available.
Buyers item identification can be used if known.
At least one of Sellers item identification or Standard item identification must be sent.
Which identifier to use depends on what is known at the time of catalogue exchange or what is commonly used in the relevant business sector.

.Example 1, Seller item identification
Expand Down
7 changes: 5 additions & 2 deletions project.xml
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="UTF-8"?>
<Project xmlns="urn:fdc:difi.no:2017:vefa:structure:Project-1">
<Name>Peppol BIS version 3 - November 2023 Release</Name>
<Name>Peppol BIS version 3 - May 2024 Release</Name>
<!-- Introduction -->
<Documentation path="">INTRODUCTION</Documentation>
<Documentation path="compliance/">BIS compliance</Documentation>
Expand Down Expand Up @@ -270,6 +270,10 @@
<Type>CodeList-1</Type>
<Path>structure/codelist/UNCL5387.xml</Path>
</Resource>
<Resource>
<Type>CodeList-1</Type>
<Path>structure/codelist/TransactionConditions.xml</Path>
</Resource>
<Resource>
<Type>CodeList-1</Type>
<Path>structure/codelist/UNCL4219.xml</Path>
Expand All @@ -278,7 +282,6 @@
<Type>CodeList-1</Type>
<Path>structure/codelist/UNECERec19.xml</Path>
</Resource>

<Resource>
<Type>CodeList-1</Type>
<Path>structure/codelist/UNECERec20-11e.xml</Path>
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,7 @@
<cac:Party>
<cbc:EndpointID schemeID="0088">7300010000001</cbc:EndpointID>
<cac:PartyIdentification>
<cbc:ID schemeID="0007">5541277711</cbc:ID>
<cbc:ID schemeID="0007">5541277710</cbc:ID>
</cac:PartyIdentification>
<cac:PartyLegalEntity>
<cbc:RegistrationName>City Hospital 345433</cbc:RegistrationName>
Expand All @@ -27,7 +27,7 @@
<cac:Party>
<cbc:EndpointID schemeID="0088">7302347231110</cbc:EndpointID>
<cac:PartyIdentification>
<cbc:ID schemeID="0007">5546577799</cbc:ID>
<cbc:ID schemeID="0007">5546577791</cbc:ID>
</cac:PartyIdentification>
<cac:PartyName>
<cbc:Name>The Supplier AB</cbc:Name>
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -21,14 +21,14 @@
<cac:Party>
<cbc:EndpointID schemeID="0088">7300010000001</cbc:EndpointID>
<cac:PartyIdentification>
<cbc:ID schemeID="0007">5541277711</cbc:ID>
<cbc:ID schemeID="0007">5541277710</cbc:ID>
</cac:PartyIdentification>
<cac:PartyName>
<cbc:Name>City Hospital</cbc:Name>
</cac:PartyName>
<cac:PartyLegalEntity>
<cbc:RegistrationName>City Hospital 345433</cbc:RegistrationName>
<cbc:CompanyID schemeID="0007">5541277711</cbc:CompanyID>
<cbc:CompanyID schemeID="0007">5541277710</cbc:CompanyID>
<cac:RegistrationAddress>
<cbc:CityName>Eurocity</cbc:CityName>
<cac:Country>
Expand All @@ -47,7 +47,7 @@
<cac:Party>
<cbc:EndpointID schemeID="0088">7302347231110</cbc:EndpointID>
<cac:PartyIdentification>
<cbc:ID schemeID="0007">5546577799</cbc:ID>
<cbc:ID schemeID="0007">5546577791</cbc:ID>
</cac:PartyIdentification>
<cac:PostalAddress>
<cbc:StreetName>Harbour street</cbc:StreetName>
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -18,7 +18,7 @@
<cac:Party>
<cbc:EndpointID schemeID="0088">7302347231110</cbc:EndpointID>
<cac:PartyIdentification>
<cbc:ID schemeID="0007">5546577799</cbc:ID>
<cbc:ID schemeID="0007">5546577791</cbc:ID>
</cac:PartyIdentification>
<cac:PartyLegalEntity>
<cbc:RegistrationName>The Supplier AB</cbc:RegistrationName>
Expand All @@ -29,7 +29,7 @@
<cac:Party>
<cbc:EndpointID schemeID="0088">7300010000001</cbc:EndpointID>
<cac:PartyIdentification>
<cbc:ID schemeID="0007">5541277711</cbc:ID>
<cbc:ID schemeID="0007">5541277710</cbc:ID>
</cac:PartyIdentification>
<cac:PartyLegalEntity>
<cbc:RegistrationName>City Hospital</cbc:RegistrationName>
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -23,11 +23,11 @@
<cac:Party>
<cbc:EndpointID schemeID="0088">7300010000001</cbc:EndpointID>
<cac:PartyIdentification>
<cbc:ID schemeID="0007">5541277711</cbc:ID>
<cbc:ID schemeID="0007">5541277710</cbc:ID>
</cac:PartyIdentification>
<cac:PartyLegalEntity>
<cbc:RegistrationName>City Hospital 345433</cbc:RegistrationName>
<cbc:CompanyID schemeID="0007">5541277711</cbc:CompanyID>
<cbc:CompanyID schemeID="0007">5541277710</cbc:CompanyID>
<cac:RegistrationAddress>
<cbc:CityName>Eurocity</cbc:CityName>
<cac:Country>
Expand All @@ -46,7 +46,7 @@
<cac:Party>
<cbc:EndpointID schemeID="0088">7302347231110</cbc:EndpointID>
<cac:PartyIdentification>
<cbc:ID schemeID="0007">5546577799</cbc:ID>
<cbc:ID schemeID="0007">5546577791</cbc:ID>
</cac:PartyIdentification>
<cac:PartyName>
<cbc:Name>The Supplier AB</cbc:Name>
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -20,14 +20,14 @@
<cac:Party>
<cbc:EndpointID schemeID="0088">7300010000001</cbc:EndpointID>
<cac:PartyIdentification>
<cbc:ID schemeID="0007">5541277711</cbc:ID>
<cbc:ID schemeID="0007">5541277710</cbc:ID>
</cac:PartyIdentification>
<cac:PartyName>
<cbc:Name>City Hospital</cbc:Name>
</cac:PartyName>
<cac:PartyLegalEntity>
<cbc:RegistrationName>City Hospital 345433</cbc:RegistrationName>
<cbc:CompanyID schemeID="0007">5541277711</cbc:CompanyID>
<cbc:CompanyID schemeID="0007">5541277710</cbc:CompanyID>
<cac:RegistrationAddress>
<cbc:CityName>Eurocity</cbc:CityName>
<cac:Country>
Expand All @@ -46,7 +46,7 @@
<cac:Party>
<cbc:EndpointID schemeID="0088">7302347231110</cbc:EndpointID>
<cac:PartyIdentification>
<cbc:ID schemeID="0007">5546577799</cbc:ID>
<cbc:ID schemeID="0007">5546577791</cbc:ID>
</cac:PartyIdentification>
<cac:PostalAddress>
<cbc:StreetName>Harbour street</cbc:StreetName>
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -21,7 +21,7 @@
<cac:Party>
<cbc:EndpointID schemeID="0088">7302347231110</cbc:EndpointID>
<cac:PartyIdentification>
<cbc:ID schemeID="0007">5546577799</cbc:ID>
<cbc:ID schemeID="0007">5546577791</cbc:ID>
</cac:PartyIdentification>
<cac:PartyLegalEntity>
<cbc:RegistrationName>The Supplier AB</cbc:RegistrationName>
Expand All @@ -32,7 +32,7 @@
<cac:Party>
<cbc:EndpointID schemeID="0088">7300010000001</cbc:EndpointID>
<cac:PartyIdentification>
<cbc:ID schemeID="0007">5541277711</cbc:ID>
<cbc:ID schemeID="0007">5541277710</cbc:ID>
</cac:PartyIdentification>
<cac:PartyLegalEntity>
<cbc:RegistrationName>City Hospital</cbc:RegistrationName>
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,7 @@
<cac:Party>
<cbc:EndpointID schemeID="0088">7300010000001</cbc:EndpointID>
<cac:PartyIdentification>
<cbc:ID schemeID="0007">5541277711</cbc:ID>
<cbc:ID schemeID="0007">5541277710</cbc:ID>
</cac:PartyIdentification>
<cac:PartyLegalEntity>
<cbc:RegistrationName>City Hospital 345433</cbc:RegistrationName>
Expand All @@ -27,7 +27,7 @@
<cac:Party>
<cbc:EndpointID schemeID="0088">7302347231110</cbc:EndpointID>
<cac:PartyIdentification>
<cbc:ID schemeID="0007">5546577799</cbc:ID>
<cbc:ID schemeID="0007">5546577791</cbc:ID>
</cac:PartyIdentification>
<cac:PartyName>
<cbc:Name>The Supplier AB</cbc:Name>
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -21,14 +21,14 @@
<cac:Party>
<cbc:EndpointID schemeID="0088">7300010000001</cbc:EndpointID>
<cac:PartyIdentification>
<cbc:ID schemeID="0007">5541277711</cbc:ID>
<cbc:ID schemeID="0007">5541277710</cbc:ID>
</cac:PartyIdentification>
<cac:PartyName>
<cbc:Name>City Hospital</cbc:Name>
</cac:PartyName>
<cac:PartyLegalEntity>
<cbc:RegistrationName>City Hospital 345433</cbc:RegistrationName>
<cbc:CompanyID schemeID="0007">5541277711</cbc:CompanyID>
<cbc:CompanyID schemeID="0007">5541277710</cbc:CompanyID>
<cac:RegistrationAddress>
<cbc:CityName>Eurocity</cbc:CityName>
<cac:Country>
Expand All @@ -47,7 +47,7 @@
<cac:Party>
<cbc:EndpointID schemeID="0088">7302347231110</cbc:EndpointID>
<cac:PartyIdentification>
<cbc:ID schemeID="0007">5546577799</cbc:ID>
<cbc:ID schemeID="0007">5546577791</cbc:ID>
</cac:PartyIdentification>
<cac:PostalAddress>
<cbc:StreetName>Harbour street</cbc:StreetName>
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -18,7 +18,7 @@
<cac:Party>
<cbc:EndpointID schemeID="0088">7302347231110</cbc:EndpointID>
<cac:PartyIdentification>
<cbc:ID schemeID="0007">5546577799</cbc:ID>
<cbc:ID schemeID="0007">5546577791</cbc:ID>
</cac:PartyIdentification>
<cac:PartyLegalEntity>
<cbc:RegistrationName>The Supplier AB</cbc:RegistrationName>
Expand All @@ -29,7 +29,7 @@
<cac:Party>
<cbc:EndpointID schemeID="0088">7300010000001</cbc:EndpointID>
<cac:PartyIdentification>
<cbc:ID schemeID="0007">5541277711</cbc:ID>
<cbc:ID schemeID="0007">5541277710</cbc:ID>
</cac:PartyIdentification>
<cac:PartyLegalEntity>
<cbc:RegistrationName>City Hospital</cbc:RegistrationName>
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,7 @@
<cac:Party>
<cbc:EndpointID schemeID="0088">7300010000001</cbc:EndpointID>
<cac:PartyIdentification>
<cbc:ID schemeID="0007">5541277711</cbc:ID>
<cbc:ID schemeID="0007">5541277710</cbc:ID>
</cac:PartyIdentification>
<cac:PartyLegalEntity>
<cbc:RegistrationName>City Hospital 345433</cbc:RegistrationName>
Expand All @@ -27,7 +27,7 @@
<cac:Party>
<cbc:EndpointID schemeID="0088">7302347231110</cbc:EndpointID>
<cac:PartyIdentification>
<cbc:ID schemeID="0007">5546577799</cbc:ID>
<cbc:ID schemeID="0007">5546577791</cbc:ID>
</cac:PartyIdentification>
<cac:PartyName>
<cbc:Name>The Supplier AB</cbc:Name>
Expand Down
Loading

0 comments on commit c80f6fa

Please sign in to comment.