@mojaloop/api-snippets 17.6.0 → 17.6.1

package/fspiop/v2_0_ISO20022/openapi3/components/schemas/TaxParty2.yaml

@@ -4,12 +4,28 @@ description: |
 type: object
 properties:
   TaxId:
+    description: |
+      TaxIdentification
+
+      Tax identification number of the debtor.
     $ref: ./Max35Text.yaml
   RegnId:
+    description: |
+      RegistrationIdentification
+
+      Unique identification, as assigned by an organisation, to unambiguously identify a party.
     $ref: ./Max35Text.yaml
   TaxTp:
+    description: |
+      TaxType
+
+      Type of tax payer.
     $ref: ./Max35Text.yaml
   Authstn:
+    description: |
+      Authorisation
+
+      Details of the authorised tax paying party.
     $ref: ./TaxAuthorisation1.yaml
 example:
   TaxId: 123456789

package/fspiop/v2_0_ISO20022/openapi3/components/schemas/TaxPeriod3.yaml

@@ -3,12 +3,24 @@ description: |
   Period of time details related to the tax payment.
 type: object
 properties:
-  Yr:
-    $ref: ./ISOYear.yaml
-  Tp:
-    $ref: ./TaxRecordPeriod1Code.yaml
   FrToDt:
     $ref: ./DatePeriod2.yaml
+    description: |
+      FromToDate
+
+      Range of time between a start date and an end date for which the tax report is provided.
+  Tp:
+    $ref: ./TaxRecordPeriod1Code.yaml
+    description: |
+      Type
+
+      Identification of the period related to the tax payment.
+  Yr:
+    $ref: ./ISOYear.yaml
+    description: |
+      Year
+
+      Year related to the tax payment.
 example:
   Yr: 2020
   Tp: MM01

package/fspiop/v2_0_ISO20022/openapi3/components/schemas/TaxRecord3.yaml

@@ -3,24 +3,60 @@ description: |
   Set of elements used to define the tax record.
 type: object
 properties:
-  Tp:
+  AddtlInf:
+    $ref: ./Max140Text.yaml
+    description: |
+      AdditionalInformation
+
+      Further details of the tax record.
+  CertId:
     $ref: ./Max35Text.yaml
+    description: |
+      CertificateIdentification
+
+      Identification number of the tax report as assigned by the taxing authority.
   Ctgy:
     $ref: ./Max35Text.yaml
+    description: |
+      Category
+
+      Specifies the tax code as published by the tax authority.
   CtgyDtls:
     $ref: ./Max35Text.yaml
+    description: |
+      CategoryDetails
+
+      Provides further details of the category tax code.
   DbtrSts:
     $ref: ./Max35Text.yaml
-  CertId:
-    $ref: ./Max35Text.yaml
+    description: |
+      DebtorStatus
+
+      Code provided by local authority to identify the status of the party that has drawn up the settlement document.
   FrmsCd:
     $ref: ./Max35Text.yaml
+    description: |
+      FormsCode
+
+      Identifies, in a coded form, on which template the tax report is to be provided.
   Prd:
     $ref: ./TaxPeriod3.yaml
+    description: |
+      Period
+
+      Set of elements used to provide details on the period of time related to the tax payment.
   TaxAmt:
     $ref: ./TaxAmount3.yaml
-  AddtlInf:
-    $ref: ./Max140Text.yaml
+    description: |
+      TaxAmount
+
+      Set of elements used to provide information on the amount of the tax record.
+  Tp:
+    $ref: ./Max35Text.yaml
+    description: |
+      Type
+
+      High level code to identify the type of tax details.
 example:
   Tp: VAT
   Ctgy: A

package/fspiop/v2_0_ISO20022/openapi3/components/schemas/TaxRecordDetails3.yaml

@@ -4,8 +4,16 @@ description: |
 type: object
 properties:
   Prd:
+    description: |
+      Period
+
+      Set of elements used to provide details on the period of time related to the tax payment.
     $ref: ./TaxPeriod3.yaml
   Amt:
+    description: |
+      Amount
+
+      Underlying tax amount related to the specified period.
     $ref: ./ActiveOrHistoricCurrencyAndAmount.yaml
 required:
   - Amt

package/fspiop/v2_0_ISO20022/openapi3/components/schemas/VerificationReason1Choice.yaml

@@ -2,8 +2,17 @@ title: VerificationReason1Choice
 type: object
 properties:
   Cd:
+    description: >
+      Code
+
+      Reason why the verified identification information is incorrect, as published in an external
+      reason code list.
     $ref: ./ExternalVerificationReason1Code.yaml
   Prtry:
+    description: >
+      Proprietary
+
+      Reason why the verified identification information is incorrect, in a free text form.
     $ref: ./Max35Text.yaml
 oneOf:
   - required:

package/fspiop/v2_0_ISO20022/openapi3/components/schemas/VerificationReport4.yaml

@@ -2,28 +2,76 @@ title: VerificationReport4
 type: object
 properties:
   OrgnlId:
+    description: >
+      OriginalIdentification
+
+      Unique identification, as assigned by a sending party, to unambiguously identify the party
+      and account identification information group within the original message.
     $ref: ./Max35Text.yaml
   Vrfctn:
+    description: >
+      Verification
+
+      Identifies whether the party and/or account information received is correct.
+      Boolean value.
     $ref: ./IdentificationVerificationIndicator.yaml
   Rsn:
+    description: >
+      Reason.
+
+      Specifies the reason why the verified identification information is incorrect.
     $ref: ./VerificationReason1Choice.yaml
   OrgnlPtyAndAcctId:
+    description: >
+      OriginalPartyAndAccountIdentification
+
+      Provides party and/or account identification information as given in the original message.
     $ref: ./IdentificationInformation4.yaml
   UpdtdPtyAndAcctId:
+    description: >
+      UpdatedPartyAndAccountIdentification
+
+      Provides party and/or account identification information.
     $ref: ./IdentificationInformation4.yaml
 required:
   - OrgnlId
   - Vrfctn
 example:
-  OrgnlId: 123456789
+  OrgnlId: 1234567890123456789012345678901234
   Vrfctn: true
-  Rsn:
-    Cd: AGNT
   OrgnlPtyAndAcctId:
-    Id: 123456789
-    SchmeNm:
-      Cd: CCPT
+    Nm: John Doe
+    PstlAdr:
+      AdrTp: ADDR
+      Dept: Dept
+      SubDept: SubDept
+      StrtNm: 1234 Elm St
+      BldgNb: 1234
+      PstCd: 12345
+      TwnNm: Anytown
+      CtrySubDvsn: CA
+      Ctry: US
+    Id:
+      OrgId:
+        AnyBIC: ABCDUS33
+        Othr:
+          Id: 123456789
+          Issr: ABA
   UpdtdPtyAndAcctId:
-    Id: 123456789
-    SchmeNm:
-      Cd: CCPT
+    Nm: John Doe
+    PstlAdr:
+      AdrTp: ADDR
+      Dept: Dept
+      SubDept: SubDept
+      StrtNm: 1234 Elm St
+      BldgNb: 1234
+      PstCd: 12345
+      TwnNm: Anytown
+      CtrySubDvsn: CA
+      Ctry: US
+    Id:
+      OrgId:
+        AnyBIC: ABCDUS33
+        Othr:
+          Id: 123456789
+          Issr: ABA

package/fspiop/v2_0_ISO20022/openapi3/openapi.yaml

@@ -1,4 +1,4 @@
-openapi: 3.0.2
+openapi: 3.1.0
 info:
   version: v2.0-iso20022-draft
   title: Open API for FSP Interoperability (FSPIOP) - the ISO 20022 message version