Merge pull request #76 from digipost/share-docs-spesific-org

Specify allowed organisation numbers for document sharing

datatypes-examples.xml

@@ -394,6 +394,7 @@
 <share-documents-request xmlns="http://api.digipost.no/schema/datatypes">
     <max-share-duration-seconds>1209600</max-share-duration-seconds>
     <purpose>We require to see your latest pay slip in order to grant you a loan.</purpose>
+    <allowed-origin-organisation-numbers>984661185</allowed-origin-organisation-numbers>
 </share-documents-request>
 
 <share-documents-request-documents-shared xmlns="http://api.digipost.no/schema/datatypes">

datatypes.xsd

@@ -430,6 +430,7 @@
         <xs:sequence>
             <xs:element name="max-share-duration-seconds" type="xs:long"/>
             <xs:element name="purpose" type="xs:string"/>
+            <xs:element maxOccurs="10" minOccurs="0" name="allowed-origin-organisation-numbers" type="xs:string"/>
         </xs:sequence>
     </xs:complexType>
     <xs:complexType final="extension restriction" name="shareDocumentsRequestDocumentsShared">

readme.md

@@ -1096,13 +1096,15 @@ A request for a user to share one or more documents
 |----|----|--------|-----------|
 |maxShareDurationSeconds|Long|yes|This is the maximum duration in which you are allowed to access the user's documents from they are shared with you|
 |purpose|String|yes|This text should explain why you need to process the recipient's documents in a short and understandable way.|
+|allowedOriginOrganisationNumbers|Set|no|Only documents received from any of the specified organisations will be possible for the user to share.|
 
 ### XML
 
 ```xml
 <share-documents-request xmlns="http://api.digipost.no/schema/datatypes">
     <max-share-duration-seconds>1209600</max-share-duration-seconds>
     <purpose>We require to see your latest pay slip in order to grant you a loan.</purpose>
+    <allowed-origin-organisation-numbers>984661185</allowed-origin-organisation-numbers>
 </share-documents-request>
 ```
 

src/main/java/no/digipost/api/datatypes/types/share/ShareDocumentsRequest.java

@@ -12,6 +12,8 @@
 import no.digipost.api.datatypes.DataType;
 import no.digipost.api.datatypes.documentation.Description;
 
+import java.util.Set;
+
 @XmlRootElement(name = "share-documents-request")
 @Value
 @AllArgsConstructor
@@ -31,9 +33,14 @@ public class ShareDocumentsRequest implements DataType {
     @Description("This text should explain why you need to process the recipient's documents in a short and understandable way.")
     String purpose;
 
+    @XmlElement(name="allowed-origin-organisation-numbers", required = false)
+    @Description("Only documents received from any of the specified organisations will be possible for the user to share.")
+    Set<String> allowedOriginOrganisationNumbers;
+
     public static final ShareDocumentsRequest EXAMPLE = new ShareDocumentsRequest(
             14 * 24 * 60 * 60L,
-            "We require to see your latest pay slip in order to grant you a loan."
+            "We require to see your latest pay slip in order to grant you a loan.",
+            Set.of("984661185")
     );
 
 }