Merge branch '2024-q4-dev' into POACC-477

guides/profiles/28-ordering/process/index.adoc

@@ -59,4 +59,6 @@ include::use-case4.adoc[]
 
 include::use-case5.adoc[]
 
+include::use-case6.adoc[]
+
 :leveloffset: -1

guides/profiles/28-ordering/process/use-case6.adoc

@@ -0,0 +1,39 @@
+[[use-case-6-consignment-order]]
+= Use case 6 – Vendor-managed inventory with consignment ordering
+
+This use case describes a scenario where the buyer has an on-premise inventory that is regularly refilled and managed by the seller. When items are withdrawn from the inventory, a consignment order is automatically sent to the seller.
+
+[cols="1s,5",options="header"]
+|====
+|Use Case number
+|6
+
+|Use Case Name
+|Vendor-managed inventory with consignment ordering
+
+|Use Case Description
+|A hospital is using a vendor-managed inventory. A consigment order is issued by they buyer when items are withdrawn.
+
+|Parties involved
+|Buyer +
+Seller +
+
+
+|Assumptions
+|The buyer has an inventory which is managed by the seller. The seller keeps track on available quantity and replenish when necessary. +
+
+|The flow
+|The buyer withdraws 10 boxes of surgical gloves from the inventory. +
+The buyer registers the purchase by scanning the barcodes of the boxes. +
+A consignment order is automatically issued (with type code 227) and is sent to the seller. +
+The seller receives the order and sends an order response with an acknowledgment. +
+The seller updates the record of available quantity. 
+
+|Result
+|The buyer uses the withdrawn items. +
+The seller has an updated record of available quantity. +
+If the invoice has an order reference, the invoice can be matched automatically.
+
+|XML example file
+|See Appendix A for a sample file illustrating Use Case 6 in the download section on the main page.
+|====

guides/profiles/3-order-only/process/index.adoc

@@ -37,4 +37,6 @@ include::use-case4.adoc[]
 
 include::use-case5.adoc[]
 
+include::use-case6.adoc[]
+
 :leveloffset: -1

guides/profiles/3-order-only/process/use-case6.adoc

@@ -0,0 +1,39 @@
+[[use-case-6-consignment-order]]
+= Use case 6 – Vendor-managed inventory with consignment ordering
+
+This use case describes a scenario where the buyer has an on-premise inventory that is regularly refilled and managed by the seller. When items are withdrawn from the inventory, a consignment order is automatically sent to the seller.
+
+[cols="1s,5",options="header"]
+|====
+|Use Case number
+|6
+
+|Use Case Name
+|Vendor-managed inventory with consignment ordering
+
+|Use Case Description
+|A hospital is using a vendor-managed inventory. A consigment order is issued by they buyer when items are withdrawn.
+
+|Parties involved
+|Buyer +
+Seller +
+
+
+|Assumptions
+|The buyer has an inventory which is managed by the seller. The seller keeps track on available quantity and replenish when necessary +
+
+|The flow
+|The buyer withdraws 10 boxes of surgical gloves from the inventory. +
+The buyer registers the purchase by scanning the barcodes of the boxes. +
+A consignment order is automatically issued (with type code 227) and is sent to the seller. +
+The seller receives the order. +
+The seller updates the record of available quantity. 
+
+|Result
+|The buyer uses the withdrawn items. +
+The seller has an updated record of available quantity. +
+If the invoice has an order reference, the invoice can be matched automatically.
+
+|XML example file
+|See Appendix A for a sample file illustrating Use Case 6 in the download section on the main page.
+|====

guides/release-notes/main.adoc

@@ -15,6 +15,8 @@ IMPORTANT: Changes in code lists are also reflected by changes in the validation
 
 :leveloffset: +1
 
+include::v3.0.14.adoc[]
+
 include::v3.0.13.adoc[]
 
 include::v3.0.12.adoc[]

guides/release-notes/v3.0.14.adoc

@@ -9,16 +9,14 @@ Release date:: November 2024
 * BIS Ordering and Order Only
 ** Added sample file and use case which describes consignment orders and vendor-managed inventory
 
-* BIS Despatch Advice
-** Optional party Delivery Party added to align with Order.
-
 == Changes to syntax
 * Order transaction (T01)
 * Order Response transaction (T76)
 * Order Response transaction Advanced (T116)
 * Despatch Advice (T16)
 ** Optional attribute added to indicate the scheme of the Transport Handling Unit identifier. 
-** Optional element group Delivery Party added.
+** Optional party Delivery Party added to align with Order.
+
 * Catalogue transaction (T19)
 
 == Changes to code lists and validation artefacts

project.xml

@@ -302,6 +302,12 @@
         <Type>CodeList-1</Type>
         <Path>structure/codelist/StatusReason.xml</Path>
     </Resource>
+    <Resource>
+        <Type>CodeList-1</Type>
+        <Path>structure/codelist/TransportHandlingUnitIDschemeID.xml</Path>
+    </Resource>
+
+
     <!-- Files -->
     <Resource>
         <Type>native:File</Type>

rules/examples/Order use cases/UC6_Order.xml

@@ -0,0 +1,99 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<Order xmlns:xs="http://www.w3.org/2001/XMLSchema"
+    xmlns="urn:oasis:names:specification:ubl:schema:xsd:Order-2"
+    xmlns:cac="urn:oasis:names:specification:ubl:schema:xsd:CommonAggregateComponents-2"
+    xmlns:cbc="urn:oasis:names:specification:ubl:schema:xsd:CommonBasicComponents-2">
+  <cbc:CustomizationID>urn:fdc:peppol.eu:poacc:trns:order:3</cbc:CustomizationID>
+  <cbc:ProfileID>urn:fdc:peppol.eu:poacc:bis:order_only:3</cbc:ProfileID>
+  <cbc:ID>1</cbc:ID>
+  <cbc:IssueDate>2024-08-28</cbc:IssueDate>
+  <cbc:IssueTime>05:10:10</cbc:IssueTime>
+  <cbc:OrderTypeCode>227</cbc:OrderTypeCode>
+  <cbc:DocumentCurrencyCode>EUR</cbc:DocumentCurrencyCode>
+  <cac:ValidityPeriod>
+    <cbc:EndDate>2024-08-28</cbc:EndDate>
+  </cac:ValidityPeriod>
+  <cac:Contract>
+    <cbc:ID>C1</cbc:ID>
+  </cac:Contract>
+  <cac:BuyerCustomerParty>
+    <cac:Party>
+      <cbc:EndpointID schemeID="0088">7300010000001</cbc:EndpointID>
+      <cac:PartyIdentification>
+        <cbc:ID schemeID="0088">7300010000001</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="0088">7300010000001</cbc:CompanyID>
+        <cac:RegistrationAddress>
+          <cbc:CityName>Eurocity</cbc:CityName>
+          <cac:Country>
+            <cbc:IdentificationCode>SE</cbc:IdentificationCode>
+          </cac:Country>
+        </cac:RegistrationAddress>
+      </cac:PartyLegalEntity>
+      <cac:Contact>
+        <cbc:Name>Martin Foggerty</cbc:Name>
+        <cbc:Telephone>+46555785488</cbc:Telephone>
+        <cbc:ElectronicMail>[email protected]</cbc:ElectronicMail>
+      </cac:Contact>
+    </cac:Party>
+  </cac:BuyerCustomerParty>
+  <cac:SellerSupplierParty>
+    <cac:Party>
+      <cbc:EndpointID schemeID="0192">987654325</cbc:EndpointID>
+      <cac:PartyIdentification>
+        <cbc:ID schemeID="0192">987654325</cbc:ID>
+      </cac:PartyIdentification>
+      <cac:PostalAddress>
+        <cbc:StreetName>Harbour street</cbc:StreetName>
+        <cbc:AdditionalStreetName>Dock 45</cbc:AdditionalStreetName>
+        <cbc:CityName>Bergen</cbc:CityName>
+        <cbc:PostalZone>5005</cbc:PostalZone>
+        <cbc:CountrySubentity>Region West</cbc:CountrySubentity>
+        <cac:AddressLine>
+          <cbc:Line>Gate 34</cbc:Line>
+        </cac:AddressLine>
+        <cac:Country>
+          <cbc:IdentificationCode>NO</cbc:IdentificationCode>
+        </cac:Country>
+      </cac:PostalAddress>
+      <cac:PartyLegalEntity>
+        <cbc:RegistrationName>The Supplier AB</cbc:RegistrationName>
+      </cac:PartyLegalEntity>
+    </cac:Party>
+  </cac:SellerSupplierParty>
+  <cac:TaxTotal>
+	<cbc:TaxAmount currencyID="EUR">100</cbc:TaxAmount>
+  </cac:TaxTotal>
+  <cac:AnticipatedMonetaryTotal>
+    <cbc:LineExtensionAmount currencyID="EUR">400</cbc:LineExtensionAmount>
+    <cbc:PayableAmount currencyID="EUR">500</cbc:PayableAmount>
+  </cac:AnticipatedMonetaryTotal>
+  <cac:OrderLine>
+    <cac:LineItem>
+      <cbc:ID>1</cbc:ID>
+      <cbc:Quantity unitCode="NAR">10</cbc:Quantity>
+      <cbc:LineExtensionAmount currencyID="EUR">400</cbc:LineExtensionAmount>
+      <cac:Price>
+        <cbc:PriceAmount currencyID="EUR">40</cbc:PriceAmount>
+      </cac:Price>
+       <cac:Item>
+        <cbc:Name>Surgical gloves, box of 100 pairs</cbc:Name>
+        <cac:StandardItemIdentification>
+          <cbc:ID schemeID="0160">05704066204093</cbc:ID>
+        </cac:StandardItemIdentification>
+        <cac:ClassifiedTaxCategory>
+          <cbc:ID>S</cbc:ID>
+          <cbc:Percent>25</cbc:Percent>
+          <cac:TaxScheme>
+            <cbc:ID>VAT</cbc:ID>
+          </cac:TaxScheme>
+        </cac:ClassifiedTaxCategory>
+        </cac:Item>
+    </cac:LineItem>
+  </cac:OrderLine>
+ </Order>

structure/codelist/TransportHandlingUnitIDschemeID.xml

@@ -0,0 +1,21 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<CodeList xmlns="urn:fdc:difi.no:2017:vefa:structure:CodeList-1">
+
+    <Title>Transport Handling Unit ID scheme(openPEPPOL)</Title>
+    <Identifier>TransportHandlingUnitIDschemID</Identifier>
+    <Version>1.0</Version>
+    <Agency>OpenPEPPOL</Agency>
+    <Subset>OpenPEPPOL</Subset>
+
+    <Code>
+        <Id>SSCC</Id>
+        <Name>Serial Shipping Container Code</Name>
+        <Description>Code used to identify a logistic unit</Description>
+    </Code>
+    <Code>
+        <Id>ZZZ</Id>
+        <Name>Mutually defined</Name>
+        <Description>Identifier scheme which is mutually defined by the trading partners</Description>
+    </Code>
+
+</CodeList>

structure/syntax/ubl-despatch-advice.xml

@@ -1591,6 +1591,15 @@
 						<Name>Handling unit identifier</Name>
 						<Description>Identifies the transport handling unit.</Description>
 						<Reference type="BUSINESS_TERM">tir16-061</Reference>
+						<Value type="EXAMPLE">173500538500000016</Value>
+						<Attribute usage="optional">
+							<Term>schemeID</Term>
+							<Name>Scheme identifier</Name>
+							<Description>Scheme identifier for the handling unit identifier</Description>
+							<Reference type="CODE_LIST">TransportHandlingUnitIDschemID</Reference>
+							<Value type="EXAMPLE">SSCC</Value>
+						</Attribute>
+
 					</Element>
 					<Element cardinality="0..1">
 						<Term>cbc:TransportHandlingUnitTypeCode</Term>