@mojaloop/api-snippets 17.6.0 → 17.7.0-snapshot.1

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

@@ -4,10 +4,22 @@ description: |
 type: object
 properties:
   AnyBIC:
+    description: >
+      AnyBIC
+
+      Business identification code of the organisation.
     $ref: ./AnyBICDec2014Identifier.yaml
   LEI:
+    description: >
+      LEI
+
+      Legal entity identification as an alternate identification for a party.
     $ref: ./LEIIdentifier.yaml
   Othr:
+    description: >
+      Other
+
+      Unique identification of an organisation, as assigned by an institution, using an identification scheme.
     $ref: ./GenericOrganisationIdentification1.yaml
 example:
   AnyBIC: BICFI

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

@@ -4,10 +4,22 @@ description: |
 type: object
 properties:
   AnyBIC:
+    description: >
+      AnyBIC
+
+      Business identification code of the organisation.
     $ref: ./AnyBICDec2014Identifier.yaml
   LEI:
+    description: >
+      LEI
+
+      Legal entity identification as an alternate identification for a party.
     $ref: ./LEIIdentifier.yaml
   Othr:
+    description: >
+      Other
+
+      Unique identification of an organisation, as assigned by an institution, using an identification scheme.
     $ref: ./GenericOrganisationIdentification3.yaml
 example:
   AnyBIC: BICFI

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

@@ -4,8 +4,16 @@ description: |
 type: object
 properties:
   Cd:
+    description: >
+      Code
+
+      Name of the identification scheme, in a coded form as published in an external list.
     $ref: ./ExternalOrganisationIdentification1Code.yaml
   Prtry:
+    description: >
+      Proprietary
+
+      Name of the identification scheme, in a free text form.
     $ref: ./Max35Text.yaml
 oneOf:
   - required:

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

@@ -4,8 +4,16 @@ description: |
 type: object
 properties:
   ChanlTp:
+    description: >
+      ChannelType
+
+      Method used to contact the financial institution's contact for the specific tax region.
     $ref: ./Max4Text.yaml
   Id:
+    description: >
+      Identifier
+
+      Communication value such as phone number or email address.
     $ref: ./Max128Text.yaml
 required:
   - ChanlTp

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

@@ -9,71 +9,22 @@ required:
   - GrpHdr
 example:
   GrpHdr:
-    MsgId: 123
+    MsgId: 12345
     CreDtTm: '2020-01-01T00:00:00Z'
-    NbOfTxs: 1
-    SttlmInf:
-      SttlmMtd: INDA
-      SttlmDt: '2020-01-01'
-      SttlmTmIndctn: RTGS
-      SttlmTmReq: '2020-01-01T00:00:00Z'
-      SttlmAcct:
-        Id:
-          Othr:
-            Id: 123
-            SchmeNm:
-              Cd: IBAN
-            Issr: BIC
-      ClrSys:
-        Prtry: 123
-      InstgAgt:
-        FinInstnId:
-          BICFI: 123
-      InstdAgt:
-        FinInstnId:
-          BICFI: 123
-    InstgAgt:
-      FinInstnId:
-        BICFI: 123
-    InstdAgt:
-      FinInstnId:
-        BICFI: 123
-    IntrBkSttlmAmt:
-      Amt: 123
-      Ccy: EUR
-    IntrBkSttlmDt: '2020-01-01'
-    TxSts: ACCP
-    StsRsnInf:
-      Orgtr:
-        Id:
-          Othr:
-            Id: 123
-            SchmeNm:
-              Cd: IBAN
-            Issr: BIC
-      Rsn:
-        Cd: 123
-        Prtry: 123
     TxInfAndSts:
-      OrgnlInstrId: 123
-      OrgnlEndToEndId: 123
-      TxSts: ACCP
+      StsId: 12345
+      OrgnlInstrId: 12345
+      OrgnlEndToEndId: 12345
+      OrgnlTxId: 12345
+      OrgnlUETR: 123e4567-e89b-12d3-a456-426614174000
+      TxSts: RJCT
       StsRsnInf:
-        Orgtr:
-          Id:
-            Othr:
-              Id: 123
-              SchmeNm:
-                Cd: IBAN
-              Issr: BIC
-        Rsn:
-          Cd: 123
-          Prtry: 123
-      ChrgsInf:
-        Amt: 123
-        Ccy: EUR
-      IntrBkSttlmAmt:
-        Amt: 123
-        Ccy: EUR
-      IntrBkSttlmDt: '2020-01-01'
-      SttlmTmIndctn: RTGS
+        Rsn: RSN
+        AddtlInf: ADDITIONAL
+      AccptncDtTm: '2020-01-01T00:00:00Z'
+      AcctSvcrRef: ACCTSVCRREF
+      ClrSysRef: CLRSYSREF
+      ExctnConf: 1234567890ABCDEF
+      SplmtryData:
+        PlcAndNm: PLACE
+        Envlp: ENVELOPE

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

@@ -4,8 +4,16 @@ description: |
 type: object
 properties:
   OrgId:
+    description: >
+      Organisation
+
+      Unique and unambiguous way to identify an organisation.
     $ref: ./OrganisationIdentification29.yaml
   PrvtId:
+    description: >
+      PrivateIdentification
+
+      Unique and unambiguous identification of a person, for example a passport.
     $ref: ./PersonIdentification13.yaml
 oneOf:
   - required:

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

@@ -1,11 +1,19 @@
 title: Party40Choice
 description: |
-  Nature or use of the account.
+   Identification of a person, an organisation or a financial institution.
 type: object
 properties:
   Pty:
+    description: >
+      Party
+
+      Identification of a person or an organisation.
     $ref: ./PartyIdentification135.yaml
   Agt:
+    description: >
+      Agent
+
+      Identification of a financial institution.
     $ref: ./BranchAndFinancialInstitutionIdentification6.yaml
 oneOf:
   - required:

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

@@ -1,11 +1,19 @@
 title: Party52Choice
 description: |
-  Nature or use of the account.
+  NOTE: Unsure on the description.
 type: object
 properties:
   OrgId:
+    description: >
+      Organisation
+
+      Unique and unambiguous way to identify an organisation.
     $ref: ./OrganisationIdentification39.yaml
   PrvtId:
+    description: >
+      Person
+
+      Unique and unambiguous identification of a person, for example a passport
     $ref: ./PersonIdentification18.yaml
 oneOf:
   - required:

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

@@ -4,26 +4,61 @@ description: |
 type: object
 properties:
   Nm:
+    description: >
+      Name
+
+      Name by which a party is known and which is usually used to identify that party.
     $ref: ./Max140Text.yaml
   PstlAdr:
+    description: >
+      PostalAddress
+
+      Information that locates and identifies a specific address, as defined by postal services.
     $ref: ./PostalAddress24.yaml
   Id:
+    description: >
+      Identification
+
+      Unique and unambiguous way to identify an organisation.
     $ref: ./Party38Choice.yaml
   CtryOfRes:
+    description: >
+      CountryOfResidence
+      Country in which a person resides (the place of a person's home). In the case of a company,
+      it is the country from which the affairs of that company are directed.
     $ref: ./CountryCode.yaml
   CtctDtls:
+    description: >
+      ContactDetails
+
+      Set of elements used to indicate how to contact the party.
     $ref: ./Contact4.yaml
 example:
   Nm: John Doe
   PstlAdr:
-    Ctry: BE
-    AdrLine:
-      - Rue du Marché 45
-      - Brussels
-      - BE
+    AdrTp: ADDR
+    Dept: Dept
+    SubDept: SubDept
+    StrtNm: StrtNm
+    BldgNb: BldgNb
+    BldgNm: BldgNm
+    Flr: Flr
+    PstBx: PstBx
+    Room: Room
+    PstCd: PstCd
+    TwnNm: TwnNm
+    TwnLctnNm: TwnLctnNm
+    DstrctNm: DstrctNm
+    CtrySubDvsn: CtrySubDvsn
+    Ctry: Ctry
+    AdrLine: AdrLine
   Id:
     OrgId:
-      AnyBIC: CCCCUS33
+      Othr:
+        Id: 123
+        SchmeNm:
+          Prtry: DfspId
+
   CtryOfRes: BE
   CtctDtls:
     NmPrfx: Mr
@@ -31,4 +66,5 @@ example:
     PhneNb: +123-123-321
     MobNb: +123-123-321
     FaxNb: +123-123-321
-    EmailAdr:
+    EmailAdr: example@example.com
+

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

@@ -4,14 +4,35 @@ description: |
 type: object
 properties:
   Nm:
+    description: >
+      Name
+
+      Name by which a party is known and which is usually used to identify that party.
     $ref: ./Max140Text.yaml
   PstlAdr:
+    description: >
+      Postal Address
+
+      Information that locates and identifies a specific address, as defined by postal services.
     $ref: ./PostalAddress27.yaml
   Id:
+    description: >
+      Identification
+
+      Unique and unambiguous identification of a party.
     $ref: ./Party52Choice.yaml
   CtryOfRes:
+    description: >
+      Country of Residence
+
+      Country in which a person resides (the place of a person's home).
+      In the case of a company, it is the country from which the affairs of that company are directed.
     $ref: ./CountryCode.yaml
   CtctDtls:
+    description: >
+      Contact Details
+
+      Set of elements used to indicate how to contact the party.
     $ref: ./Contact13.yaml
 example:
   Nm: John Doe

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

@@ -4,14 +4,53 @@ description: |
 type: object
 properties:
   InstrId:
+    description: >
+      InstructionIdentification
+
+      Definition: Unique identification, as assigned by an instructing party for an instructed party, to
+      unambiguously identify the instruction.
+
+      Usage: The instruction identification is a point to point reference that can be used between the
+      instructing party and the instructed party to refer to the individual instruction. It can be included in
+      several messages related to the instruction.
     $ref: ./Max35Text.yaml
   EndToEndId:
+    description: >
+      EndToEndIdentification
+
+      Definition: Unique identification, as assigned by the initiating party, to unambiguously identify the
+      transaction. This identification is passed on, unchanged, throughout the entire end-to-end chain.
+
+      Usage: The end-to-end identification can be used for reconciliation or to link tasks relating to the
+      transaction. It can be included in several messages related to the transaction.
+
+      Usage: In case there are technical limitations to pass on multiple references, the end-to-end
+      identification must be passed on throughout the entire end-to-end chain.
     $ref: ./Max35Text.yaml
   TxId:
+    description: >
+      TransactionIdentification
+
+      Definition: Unique identification, as assigned by the first instructing agent, to unambiguously identify the
+      transaction that is passed on, unchanged, throughout the entire interbank chain.
+
+      Usage: The transaction identification can be used for reconciliation, tracking or to link tasks relating to
+      the transaction on the interbank level.
+
+      Usage: The instructing agent has to make sure that the transaction identification is unique for a preagreed period.
     $ref: ./Max35Text.yaml
   UETR:
+    description: >
+      UETR
+
+      Universally unique identifier to provide an end-to-end reference of a payment transaction.
     $ref: ./UUIDv4Identifier.yaml
   ClrSysRef:
+    description: >
+      ClearingSystemReference
+
+      Unique reference, as assigned by a clearing system, to unambiguously identify the
+      instruction.
     $ref: ./Max35Text.yaml
 required:
   - EndToEndId

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

@@ -4,14 +4,38 @@ description: |
 type: object
 properties:
   InstrPrty:
+    description: >
+      InstructionPriority
+
+      Indicator of the urgency or order of importance that the instructing party would like the
+      instructed party to apply to the processing of the instruction.
     $ref: ./Priority2Code.yaml
   ClrChanl:
+    description: >
+      ClearingChannel
+
+      Specifies the clearing channel to be used to process the payment instruction.
     $ref: ./ClearingChannel2Code.yaml
   SvcLvl:
+    description: >
+      ServiceLevel
+
+      Agreement under which or rules under which the transaction should be processed.
     $ref: ./ServiceLevel8Choice.yaml
   LclInstrm:
+    description: >
+      LocalInstrument
+
+      Definition: User community specific instrument.
+
+      Usage: This element is used to specify a local instrument, local clearing option and/or further qualify the
+      service or service level.
     $ref: ./LocalInstrument2Choice.yaml
   CtgyPurp:
+    description: >
+      CategoryPurpose
+
+      Specifies the high level purpose of the instruction based on a set of pre-defined categories.
     $ref: ./CategoryPurpose1Choice.yaml
 example:
   InstrPrty: NORM

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

@@ -4,8 +4,16 @@ description: |
 type: object
 properties:
   DtAndPlcOfBirth:
+    description: >
+      DateAndPlaceOfBirth
+
+      Date and place of birth of a person.
     $ref: ./DateAndPlaceOfBirth1.yaml
   Othr:
+    description: >
+      Other
+
+      Unique identification of a person, as assigned by an institution, using an identification scheme.
     $ref: ./GenericPersonIdentification1.yaml
 example:
   DtAndPlcOfBirth:

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

@@ -4,8 +4,16 @@ description: |
 type: object
 properties:
   DtAndPlcOfBirth:
+    description: >
+      DateAndPlaceOfBirth
+
+      Date and place of birth of a person.
     $ref: ./DateAndPlaceOfBirth1.yaml
   Othr:
+    description: >
+      Other
+
+      Unique identification of a person, as assigned by an institution, using an identification scheme.
     $ref: ./GenericPersonIdentification2.yaml
 example:
   DtAndPlcOfBirth:

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

@@ -4,8 +4,16 @@ description: |
 type: object
 properties:
   Cd:
+    description: >
+      Code
+
+      Name of the identification scheme, in a coded form as published in an external list
     $ref: ./ExternalPersonIdentification1Code.yaml
   Prtry:
+    description: >
+      Proprietary
+
+      Name of the identification scheme, in a free text form
     $ref: ./Max35Text.yaml
 oneOf:
   - required:

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

@@ -4,8 +4,16 @@ description: |
 type: object
 properties:
   Tp:
+    description: |
+      Type
+
+      Type of the proxy identification.
     $ref: ./ProxyAccountType1Choice.yaml
   Id:
+    description: |
+      Identification
+
+      Identification used to indicate the account identification under another specified name.
     $ref: ./Max2048Text.yaml
 required:
   - Id

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

@@ -1,11 +1,21 @@
 title: ProxyAccountType1Choice
 type: object
 description: |
-  NOTE: Unsure on description.
+  ProxyAccountType1Choice
+
+  Specifies the scheme used for the identification of an account alias.
 properties:
   Cd:
+    description: |
+      Code
+
+      Name of the identification scheme, in a coded form as published in an external list.
     $ref: ./ExternalProxyAccountType1Code.yaml
   Prtry:
+    description: |
+      Proprietary
+
+      Name of the identification scheme, in a free text form.
     $ref: ./Max35Text.yaml
 oneOf:
   - required:

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

@@ -9,8 +9,16 @@ description: >
 type: object
 properties:
   Cd:
+    description: |
+      Code
+
+      Underlying reason for the payment transaction, as published in an external purpose code list.
     $ref: ./ExternalPurpose1Code.yaml
   Prtry:
+    description: |
+      Proprietary
+
+      Purpose, in a proprietary form.
     $ref: ./Max35Text.yaml
 oneOf:
   - required:

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

@@ -4,8 +4,16 @@ description: |
 type: object
 properties:
   Nm:
+    description: |
+      Name
+
+      Name of the entity requiring the regulatory reporting information.
     $ref: ./Max140Text.yaml
   Ctry:
+    description: |
+      Country
+
+      Country of the entity that requires the regulatory reporting information.
     $ref: ./CountryCode.yaml
 example:
   Nm: Swiss National Bank

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

@@ -4,11 +4,29 @@ description: |
 type: object
 properties:
   DbtCdtRptgInd:
+    description: >
+      DebitCreditReportingIndicator
+
+      Identifies whether the regulatory reporting information applies to the debit side,
+      to the credit side or to both debit and credit sides of the transaction.
     $ref: ./RegulatoryReportingType1Code.yaml
   Authrty:
+    description: |
+      Authority
+
+      Entity requiring the regulatory reporting information.
     $ref: ./RegulatoryAuthority2.yaml
   Dtls:
-    $ref: ./StructuredRegulatoryReporting3.yaml
+    description: >
+      Details
+
+      Identifies whether the regulatory reporting information applies to the debit side,
+      to the credit side or to both debit and credit sides of the transaction.
+    anyOf:
+      - $ref: ./StructuredRegulatoryReporting3.yaml
+      - items:
+          $ref: ./StructuredRegulatoryReporting3.yaml
+        type: array
 example:
   DbtCdtRptgInd: CRED
   Authrty:

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

@@ -4,8 +4,17 @@ description: |
 type: object
 properties:
   Cd:
+    description: >
+      Code
+
+      Specifies a pre-agreed service or level of service between the parties,
+      as published in an external service level code list.
     $ref: ./ExternalServiceLevel1Code.yaml
   Prtry:
+    description: >
+      Proprietary
+
+      Specifies a pre-agreed service or level of service between the parties, as a proprietary code.
     $ref: ./Max35Text.yaml
 oneOf:
   - required:

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

@@ -1,11 +1,18 @@
 title: SettlementInstruction15
 description: |
-  NOTE: Unsure on description.
+  Specifies the details on how the settlement of the original transaction(s) between the
+  instructing agent and the instructed agent was completed.
 type: object
 properties:
   SttlmMtd:
+    description: >
+      SettlementMethod
+
+      Method used to settle the (batch of) payment instructions.
     $ref: ./SettlementMethod1Code.yaml
   PmtTpInf:
+    description: |
+      PaymentTypeInformation
     $ref: ./PaymentTypeInformation28.yaml
 required:
   - SttlmMtd

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

@@ -4,8 +4,16 @@ description: |
 type: object
 properties:
   Cd:
+    description: >
+      Code
+
+      Reason for the status, as published in an external reason code list.
     $ref: ./ExternalStatusReason1Code.yaml
   Prtry:
+    description: >
+      Proprietary
+
+      Reason for the status, in a proprietary form.
     $ref: ./Max35Text.yaml
 oneOf:
   - required:

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

@@ -4,10 +4,22 @@ description: |
 type: object
 properties:
   Orgtr:
+    description:
+      Originator
+
+      Party that issues the status.
     $ref: ./PartyIdentification272.yaml
   Rsn:
+    description:
+      Reason
+
+      Specifies the reason for the status report.
     $ref: ./StatusReason6Choice.yaml
   AddtlInf:
+    description:
+      AdditionalInformation
+
+      Additional information about the status report.
     $ref: ./Max105Text.yaml
 example:
   Orgtr: