From bf2ed9ec15c51248d6fc1ded9249139abbdeac57 Mon Sep 17 00:00:00 2001 From: Martin Forsberg Date: Wed, 28 Aug 2024 16:50:48 +0200 Subject: [PATCH 01/11] POACC-737 --- .../profiles/28-ordering/process/index.adoc | 2 + .../28-ordering/process/use-case6.adoc | 39 ++++++++ .../profiles/3-order-only/process/index.adoc | 2 + .../3-order-only/process/use-case6.adoc | 39 ++++++++ guides/release-notes/main.adoc | 2 + guides/release-notes/v3.0.14.adoc | 21 ++++ rules/examples/Order use cases/UC6_Order.xml | 99 +++++++++++++++++++ 7 files changed, 204 insertions(+) create mode 100644 guides/profiles/28-ordering/process/use-case6.adoc create mode 100644 guides/profiles/3-order-only/process/use-case6.adoc create mode 100644 guides/release-notes/v3.0.14.adoc create mode 100644 rules/examples/Order use cases/UC6_Order.xml diff --git a/guides/profiles/28-ordering/process/index.adoc b/guides/profiles/28-ordering/process/index.adoc index 6ff89c5a..78c4140c 100644 --- a/guides/profiles/28-ordering/process/index.adoc +++ b/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 diff --git a/guides/profiles/28-ordering/process/use-case6.adoc b/guides/profiles/28-ordering/process/use-case6.adoc new file mode 100644 index 00000000..fd45d863 --- /dev/null +++ b/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. +|==== diff --git a/guides/profiles/3-order-only/process/index.adoc b/guides/profiles/3-order-only/process/index.adoc index 9ef9eace..e3d49ec2 100644 --- a/guides/profiles/3-order-only/process/index.adoc +++ b/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 diff --git a/guides/profiles/3-order-only/process/use-case6.adoc b/guides/profiles/3-order-only/process/use-case6.adoc new file mode 100644 index 00000000..e4805c07 --- /dev/null +++ b/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. +|==== diff --git a/guides/release-notes/main.adoc b/guides/release-notes/main.adoc index ef41bdb7..a14ca3e0 100644 --- a/guides/release-notes/main.adoc +++ b/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[] diff --git a/guides/release-notes/v3.0.14.adoc b/guides/release-notes/v3.0.14.adoc new file mode 100644 index 00000000..dd0401b7 --- /dev/null +++ b/guides/release-notes/v3.0.14.adoc @@ -0,0 +1,21 @@ += Version 3.0.14 +[horizontal] +Release date:: November 2024 + +== BIS documentation + +* BIS Catalogue +** Added and sample file and use case which describes consignment orders and vendor-managed inventory for Order Only and Ordering BIS. + +== Changes to syntax +* Order transaction (T01) + +* Order Response transaction (T76) +* Order Response transaction Advanced (T116) + +* Catalogue transaction (T19) + +== Changes to code lists and validation artefacts + + +== Other diff --git a/rules/examples/Order use cases/UC6_Order.xml b/rules/examples/Order use cases/UC6_Order.xml new file mode 100644 index 00000000..46ace85e --- /dev/null +++ b/rules/examples/Order use cases/UC6_Order.xml @@ -0,0 +1,99 @@ + + + urn:fdc:peppol.eu:poacc:trns:order:3 + urn:fdc:peppol.eu:poacc:bis:order_only:3 + 1 + 2024-08-28 + 05:10:10 + 227 + EUR + + 2024-08-28 + + + C1 + + + + 7300010000001 + + 7300010000001 + + + City Hospital + + + City Hospital 345433 + 7300010000001 + + Eurocity + + SE + + + + + Martin Foggerty + +46555785488 + martin.foggerty@cityhospital.se + + + + + + 987654325 + + 987654325 + + + Harbour street + Dock 45 + Bergen + 5005 + Region West + + Gate 34 + + + NO + + + + The Supplier AB + + + + + 100 + + + 400 + 500 + + + + 1 + 10 + 400 + + 40 + + + Surgical gloves, box of 100 pairs + + 05704066204093 + + + S + 25 + + VAT + + + + + + From 689bf8d277066f55fdd7c08b929a82141dd066ac Mon Sep 17 00:00:00 2001 From: Martin Forsberg Date: Wed, 28 Aug 2024 16:55:59 +0200 Subject: [PATCH 02/11] editorial fix --- guides/profiles/28-ordering/process/use-case6.adoc | 4 ++-- guides/profiles/3-order-only/process/use-case6.adoc | 4 ++-- 2 files changed, 4 insertions(+), 4 deletions(-) diff --git a/guides/profiles/28-ordering/process/use-case6.adoc b/guides/profiles/28-ordering/process/use-case6.adoc index fd45d863..d31613ad 100644 --- a/guides/profiles/28-ordering/process/use-case6.adoc +++ b/guides/profiles/28-ordering/process/use-case6.adoc @@ -1,5 +1,5 @@ [[use-case-6-consignment-order]] -= Use case 6 – Vendor-Managed Inventory with Consignment Ordering += 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. @@ -9,7 +9,7 @@ This use case describes a scenario where the buyer has an on-premise inventory t |6 |Use Case Name -|Vendor-Managed Inventory with Consignment Ordering +|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. diff --git a/guides/profiles/3-order-only/process/use-case6.adoc b/guides/profiles/3-order-only/process/use-case6.adoc index e4805c07..01a231ae 100644 --- a/guides/profiles/3-order-only/process/use-case6.adoc +++ b/guides/profiles/3-order-only/process/use-case6.adoc @@ -1,5 +1,5 @@ [[use-case-6-consignment-order]] -= Use case 6 – Vendor-Managed Inventory with Consignment Ordering += 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. @@ -9,7 +9,7 @@ This use case describes a scenario where the buyer has an on-premise inventory t |6 |Use Case Name -|Vendor-Managed Inventory with Consignment Ordering +|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. From d33acd016a488380fd4b0086d0f910b721f5a026 Mon Sep 17 00:00:00 2001 From: Martin Forsberg Date: Wed, 28 Aug 2024 16:58:32 +0200 Subject: [PATCH 03/11] test --- guides/profiles/28-ordering/process/use-case6.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/guides/profiles/28-ordering/process/use-case6.adoc b/guides/profiles/28-ordering/process/use-case6.adoc index d31613ad..5c847e98 100644 --- a/guides/profiles/28-ordering/process/use-case6.adoc +++ b/guides/profiles/28-ordering/process/use-case6.adoc @@ -2,7 +2,7 @@ = 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 From 83d1a2b72f054e590ec1cdfb116c4082ccaa7571 Mon Sep 17 00:00:00 2001 From: MartinForsberg-Ecru Date: Wed, 28 Aug 2024 20:12:47 +0200 Subject: [PATCH 04/11] updated release notes --- guides/release-notes/v3.0.14.adoc | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/guides/release-notes/v3.0.14.adoc b/guides/release-notes/v3.0.14.adoc index dd0401b7..a16905b7 100644 --- a/guides/release-notes/v3.0.14.adoc +++ b/guides/release-notes/v3.0.14.adoc @@ -7,12 +7,11 @@ Release date:: November 2024 * BIS Catalogue ** Added and sample file and use case which describes consignment orders and vendor-managed inventory for Order Only and Ordering BIS. + == Changes to syntax * Order transaction (T01) - * Order Response transaction (T76) * Order Response transaction Advanced (T116) - * Catalogue transaction (T19) == Changes to code lists and validation artefacts From 50e9a3bc70fca91cdada19d2665be5de698b56a3 Mon Sep 17 00:00:00 2001 From: MartinForsberg-Ecru Date: Mon, 2 Sep 2024 19:34:24 +0200 Subject: [PATCH 05/11] POACC-760 --- project.xml | 6 ++++++ .../TransportHandlingUnitIDschemeID.xml | 21 +++++++++++++++++++ structure/syntax/ubl-despatch-advice.xml | 2 ++ 3 files changed, 29 insertions(+) create mode 100644 structure/codelist/TransportHandlingUnitIDschemeID.xml diff --git a/project.xml b/project.xml index 1644e476..6f645e8b 100644 --- a/project.xml +++ b/project.xml @@ -302,6 +302,12 @@ CodeList-1 structure/codelist/StatusReason.xml + + CodeList-1 + structure/codelist/TransportHandlingUnitIDschemeID.xml + + + native:File diff --git a/structure/codelist/TransportHandlingUnitIDschemeID.xml b/structure/codelist/TransportHandlingUnitIDschemeID.xml new file mode 100644 index 00000000..486f1028 --- /dev/null +++ b/structure/codelist/TransportHandlingUnitIDschemeID.xml @@ -0,0 +1,21 @@ + + + + Transport Handling Unit ID scheme(openPEPPOL) + TransportHandlingUnitIDschemID + 1.0 + OpenPEPPOL + OpenPEPPOL + + + SSCC + Serial Shipping Container Code + Code used to identify a logistic unit + + + ZZZ + Mutually defined + Identifier scheme which is mutually defined by the trading partners + + + \ No newline at end of file diff --git a/structure/syntax/ubl-despatch-advice.xml b/structure/syntax/ubl-despatch-advice.xml index 3548cd19..3e589b29 100644 --- a/structure/syntax/ubl-despatch-advice.xml +++ b/structure/syntax/ubl-despatch-advice.xml @@ -1447,6 +1447,8 @@ Handling unit identifier Identifies the transport handling unit. tir16-061 + TransportHandlingUnitIDschemID + SSCC cbc:TransportHandlingUnitTypeCode From 1940197249baa9dc534bc7a7b5e263b96c2f79ca Mon Sep 17 00:00:00 2001 From: MartinForsberg-Ecru Date: Mon, 2 Sep 2024 19:40:48 +0200 Subject: [PATCH 06/11] Quick-fix of release notes --- guides/release-notes/v3.0.14.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/guides/release-notes/v3.0.14.adoc b/guides/release-notes/v3.0.14.adoc index a16905b7..40022862 100644 --- a/guides/release-notes/v3.0.14.adoc +++ b/guides/release-notes/v3.0.14.adoc @@ -15,6 +15,6 @@ Release date:: November 2024 * Catalogue transaction (T19) == Changes to code lists and validation artefacts - +* Added new codelist with code values SSCC (Serial Shipping Container Code) and ZZZ (Mutually defined) to the optional attribute that indicates the type/scheme for Transport handling unit identifier (in Despatch Advice) == Other From 37f5ce2d370df897419d46e526022f04603d4a00 Mon Sep 17 00:00:00 2001 From: MartinForsberg-Ecru Date: Mon, 2 Sep 2024 19:48:24 +0200 Subject: [PATCH 07/11] Corrected syntax report --- structure/syntax/ubl-despatch-advice.xml | 11 +++++++++-- 1 file changed, 9 insertions(+), 2 deletions(-) diff --git a/structure/syntax/ubl-despatch-advice.xml b/structure/syntax/ubl-despatch-advice.xml index 3e589b29..c30e3841 100644 --- a/structure/syntax/ubl-despatch-advice.xml +++ b/structure/syntax/ubl-despatch-advice.xml @@ -1447,8 +1447,15 @@ Handling unit identifier Identifies the transport handling unit. tir16-061 - TransportHandlingUnitIDschemID - SSCC + 173500538500000016 + + schemeID + Scheme identifier + Scheme identifier for the handling unit identifier + TransportHandlingUnitIDschemID + SSCC + + cbc:TransportHandlingUnitTypeCode From c53c41284ead68f0c111b2a72e3b99d7161f5201 Mon Sep 17 00:00:00 2001 From: MartinForsberg-Ecru Date: Tue, 3 Sep 2024 10:01:16 +0200 Subject: [PATCH 08/11] new attribute set to optional --- structure/syntax/ubl-despatch-advice.xml | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/structure/syntax/ubl-despatch-advice.xml b/structure/syntax/ubl-despatch-advice.xml index c30e3841..050ea9ea 100644 --- a/structure/syntax/ubl-despatch-advice.xml +++ b/structure/syntax/ubl-despatch-advice.xml @@ -1448,13 +1448,13 @@ Identifies the transport handling unit. tir16-061 173500538500000016 - + schemeID Scheme identifier Scheme identifier for the handling unit identifier TransportHandlingUnitIDschemID SSCC - + From 19e94eb13537d7760b9de32553e94af90d3098a8 Mon Sep 17 00:00:00 2001 From: MartinForsberg-Ecru Date: Wed, 11 Sep 2024 11:24:26 +0200 Subject: [PATCH 09/11] POAC-767 updated release notes --- guides/release-notes/v3.0.14.adoc | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/guides/release-notes/v3.0.14.adoc b/guides/release-notes/v3.0.14.adoc index 40022862..65ebb685 100644 --- a/guides/release-notes/v3.0.14.adoc +++ b/guides/release-notes/v3.0.14.adoc @@ -5,7 +5,9 @@ Release date:: November 2024 == BIS documentation * BIS Catalogue -** Added and sample file and use case which describes consignment orders and vendor-managed inventory for Order Only and Ordering BIS. + +* BIS Ordering and Order Only +** Added and sample file and use case which describes consignment orders and vendor-managed inventory == Changes to syntax From 94aa48ffc96451161d7016200336bd65528cbb6f Mon Sep 17 00:00:00 2001 From: MartinForsberg-Ecru Date: Wed, 11 Sep 2024 11:30:48 +0200 Subject: [PATCH 10/11] editorial --- guides/release-notes/v3.0.14.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/guides/release-notes/v3.0.14.adoc b/guides/release-notes/v3.0.14.adoc index 65ebb685..223cd444 100644 --- a/guides/release-notes/v3.0.14.adoc +++ b/guides/release-notes/v3.0.14.adoc @@ -7,7 +7,7 @@ Release date:: November 2024 * BIS Catalogue * BIS Ordering and Order Only -** Added and sample file and use case which describes consignment orders and vendor-managed inventory +** Added sample file and use case which describes consignment orders and vendor-managed inventory == Changes to syntax From 89117c5272e83a6880fd65558c70b465270e29b4 Mon Sep 17 00:00:00 2001 From: MartinForsberg-Ecru Date: Wed, 11 Sep 2024 11:46:20 +0200 Subject: [PATCH 11/11] POACC-760 improved release notes --- guides/release-notes/v3.0.14.adoc | 2 ++ 1 file changed, 2 insertions(+) diff --git a/guides/release-notes/v3.0.14.adoc b/guides/release-notes/v3.0.14.adoc index 223cd444..02c0c415 100644 --- a/guides/release-notes/v3.0.14.adoc +++ b/guides/release-notes/v3.0.14.adoc @@ -14,6 +14,8 @@ Release date:: November 2024 * 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. * Catalogue transaction (T19) == Changes to code lists and validation artefacts