Complex types in ISO 20022 pain.001.001.05, generated from the official XSD. Part 2 of 3: InstructionForCreditorAgent1 – TaxPeriod1.
Each type is defined once here. The message structure repeats a party or address block under every party; this view does not, which is what you want when mapping source fields.
A choice type means the children are alternatives: supply one, not all. Cardinality in bold is required.
InstructionForCreditorAgent1#
| Element | Card. | Type | Constraints |
|---|---|---|---|
Cd | 0..1 | Instruction3Code | 4 codes |
InstrInf | 0..1 | Max140Text | length 1–140 |
LocalInstrument2Choice (choice: supply one)#
| Element | Card. | Type | Constraints |
|---|---|---|---|
Cd | 1..1 | ExternalLocalInstrument1Code | length 1–35 |
Prtry | 1..1 | Max35Text | length 1–35 |
NameAndAddress10#
| Element | Card. | Type | Constraints |
|---|---|---|---|
Nm | 1..1 | Max140Text | length 1–140 |
Adr | 1..1 | PostalAddress6 |
OrganisationIdentification8#
| Element | Card. | Type | Constraints |
|---|---|---|---|
AnyBIC | 0..1 | AnyBICIdentifier | pattern [A-Z]{6,6}[A-Z2-9][A-NP-Z0-9]([A-Z0-9]{3… |
Othr | 0..* | GenericOrganisationIdentification1 |
OrganisationIdentificationSchemeName1Choice (choice: supply one)#
| Element | Card. | Type | Constraints |
|---|---|---|---|
Cd | 1..1 | ExternalOrganisationIdentification1Code | length 1–4 |
Prtry | 1..1 | Max35Text | length 1–35 |
Party11Choice (choice: supply one)#
| Element | Card. | Type | Constraints |
|---|---|---|---|
OrgId | 1..1 | OrganisationIdentification8 | |
PrvtId | 1..1 | PersonIdentification5 |
PartyIdentification43#
| Element | Card. | Type | Constraints |
|---|---|---|---|
Nm | 0..1 | Max140Text | length 1–140 |
PstlAdr | 0..1 | PostalAddress6 | |
Id | 0..1 | Party11Choice | |
CtryOfRes | 0..1 | CountryCode | pattern [A-Z]{2,2} |
CtctDtls | 0..1 | ContactDetails2 |
PaymentIdentification1#
| Element | Card. | Type | Constraints |
|---|---|---|---|
InstrId | 0..1 | Max35Text | length 1–35 |
EndToEndId | 1..1 | Max35Text | length 1–35 |
PaymentInstruction9#
| Element | Card. | Type | Constraints |
|---|---|---|---|
PmtInfId | 1..1 | Max35Text | length 1–35 |
PmtMtd | 1..1 | PaymentMethod3Code | 3 codes |
BtchBookg | 0..1 | BatchBookingIndicator | |
NbOfTxs | 0..1 | Max15NumericText | pattern [0-9]{1,15} |
CtrlSum | 0..1 | DecimalNumber | 17 decimals max |
PmtTpInf | 0..1 | PaymentTypeInformation19 | |
ReqdExctnDt | 1..1 | ISODate | |
PoolgAdjstmntDt | 0..1 | ISODate | |
Dbtr | 1..1 | PartyIdentification43 | |
DbtrAcct | 1..1 | CashAccount24 | |
DbtrAgt | 1..1 | BranchAndFinancialInstitutionIdentification5 | |
DbtrAgtAcct | 0..1 | CashAccount24 | |
InstrForDbtrAgt | 0..1 | Max140Text | length 1–140 |
UltmtDbtr | 0..1 | PartyIdentification43 | |
ChrgBr | 0..1 | ChargeBearerType1Code | 4 codes |
ChrgsAcct | 0..1 | CashAccount24 | |
ChrgsAcctAgt | 0..1 | BranchAndFinancialInstitutionIdentification5 | |
CdtTrfTxInf | 1..* | CreditTransferTransaction6 |
PaymentTypeInformation19#
| Element | Card. | Type | Constraints |
|---|---|---|---|
InstrPrty | 0..1 | Priority2Code | 2 codes |
SvcLvl | 0..1 | ServiceLevel8Choice | |
LclInstrm | 0..1 | LocalInstrument2Choice | |
CtgyPurp | 0..1 | CategoryPurpose1Choice |
PersonIdentification5#
| Element | Card. | Type | Constraints |
|---|---|---|---|
DtAndPlcOfBirth | 0..1 | DateAndPlaceOfBirth | |
Othr | 0..* | GenericPersonIdentification1 |
PersonIdentificationSchemeName1Choice (choice: supply one)#
| Element | Card. | Type | Constraints |
|---|---|---|---|
Cd | 1..1 | ExternalPersonIdentification1Code | length 1–4 |
Prtry | 1..1 | Max35Text | length 1–35 |
PostalAddress6#
| Element | Card. | Type | Constraints |
|---|---|---|---|
AdrTp | 0..1 | AddressType2Code | 6 codes |
Dept | 0..1 | Max70Text | length 1–70 |
SubDept | 0..1 | Max70Text | length 1–70 |
StrtNm | 0..1 | Max70Text | length 1–70 |
BldgNb | 0..1 | Max16Text | length 1–16 |
PstCd | 0..1 | Max16Text | length 1–16 |
TwnNm | 0..1 | Max35Text | length 1–35 |
CtrySubDvsn | 0..1 | Max35Text | length 1–35 |
Ctry | 0..1 | CountryCode | pattern [A-Z]{2,2} |
AdrLine | 0..7 | Max70Text | length 1–70 |
Purpose2Choice (choice: supply one)#
| Element | Card. | Type | Constraints |
|---|---|---|---|
Cd | 1..1 | ExternalPurpose1Code | length 1–4 |
Prtry | 1..1 | Max35Text | length 1–35 |
ReferredDocumentInformation3#
| Element | Card. | Type | Constraints |
|---|---|---|---|
Tp | 0..1 | ReferredDocumentType2 | |
Nb | 0..1 | Max35Text | length 1–35 |
RltdDt | 0..1 | ISODate |
ReferredDocumentType1Choice (choice: supply one)#
| Element | Card. | Type | Constraints |
|---|---|---|---|
Cd | 1..1 | DocumentType5Code | 15 codes |
Prtry | 1..1 | Max35Text | length 1–35 |
ReferredDocumentType2#
| Element | Card. | Type | Constraints |
|---|---|---|---|
CdOrPrtry | 1..1 | ReferredDocumentType1Choice | |
Issr | 0..1 | Max35Text | length 1–35 |
RegulatoryAuthority2#
| Element | Card. | Type | Constraints |
|---|---|---|---|
Nm | 0..1 | Max140Text | length 1–140 |
Ctry | 0..1 | CountryCode | pattern [A-Z]{2,2} |
RegulatoryReporting3#
| Element | Card. | Type | Constraints |
|---|---|---|---|
DbtCdtRptgInd | 0..1 | RegulatoryReportingType1Code | 3 codes |
Authrty | 0..1 | RegulatoryAuthority2 | |
Dtls | 0..* | StructuredRegulatoryReporting3 |
RemittanceAmount2#
| Element | Card. | Type | Constraints |
|---|---|---|---|
DuePyblAmt | 0..1 | ActiveOrHistoricCurrencyAndAmount | |
DscntApldAmt | 0..* | DiscountAmountAndType1 | |
CdtNoteAmt | 0..1 | ActiveOrHistoricCurrencyAndAmount | |
TaxAmt | 0..* | TaxAmountAndType1 | |
AdjstmntAmtAndRsn | 0..* | DocumentAdjustment1 | |
RmtdAmt | 0..1 | ActiveOrHistoricCurrencyAndAmount |
RemittanceInformation7#
| Element | Card. | Type | Constraints |
|---|---|---|---|
Ustrd | 0..* | Max140Text | length 1–140 |
Strd | 0..* | StructuredRemittanceInformation9 |
RemittanceLocation2#
| Element | Card. | Type | Constraints |
|---|---|---|---|
RmtId | 0..1 | Max35Text | length 1–35 |
RmtLctnMtd | 0..1 | RemittanceLocationMethod2Code | 6 codes |
RmtLctnElctrncAdr | 0..1 | Max2048Text | length 1–2048 |
RmtLctnPstlAdr | 0..1 | NameAndAddress10 |
ServiceLevel8Choice (choice: supply one)#
| Element | Card. | Type | Constraints |
|---|---|---|---|
Cd | 1..1 | ExternalServiceLevel1Code | length 1–4 |
Prtry | 1..1 | Max35Text | length 1–35 |
StructuredRegulatoryReporting3#
| Element | Card. | Type | Constraints |
|---|---|---|---|
Tp | 0..1 | Max35Text | length 1–35 |
Dt | 0..1 | ISODate | |
Ctry | 0..1 | CountryCode | pattern [A-Z]{2,2} |
Cd | 0..1 | Max10Text | length 1–10 |
Amt | 0..1 | ActiveOrHistoricCurrencyAndAmount | |
Inf | 0..* | Max35Text | length 1–35 |
StructuredRemittanceInformation9#
| Element | Card. | Type | Constraints |
|---|---|---|---|
RfrdDocInf | 0..* | ReferredDocumentInformation3 | |
RfrdDocAmt | 0..1 | RemittanceAmount2 | |
CdtrRefInf | 0..1 | CreditorReferenceInformation2 | |
Invcr | 0..1 | PartyIdentification43 | |
Invcee | 0..1 | PartyIdentification43 | |
AddtlRmtInf | 0..3 | Max140Text | length 1–140 |
SupplementaryData1#
| Element | Card. | Type | Constraints |
|---|---|---|---|
PlcAndNm | 0..1 | Max350Text | length 1–350 |
Envlp | 1..1 | SupplementaryDataEnvelope1 |
TaxAmount1#
| Element | Card. | Type | Constraints |
|---|---|---|---|
Rate | 0..1 | PercentageRate | 10 decimals max |
TaxblBaseAmt | 0..1 | ActiveOrHistoricCurrencyAndAmount | |
TtlAmt | 0..1 | ActiveOrHistoricCurrencyAndAmount | |
Dtls | 0..* | TaxRecordDetails1 |
TaxAmountAndType1#
| Element | Card. | Type | Constraints |
|---|---|---|---|
Tp | 0..1 | TaxAmountType1Choice | |
Amt | 1..1 | ActiveOrHistoricCurrencyAndAmount |
TaxAmountType1Choice (choice: supply one)#
| Element | Card. | Type | Constraints |
|---|---|---|---|
Cd | 1..1 | ExternalTaxAmountType1Code | length 1–4 |
Prtry | 1..1 | Max35Text | length 1–35 |
TaxAuthorisation1#
| Element | Card. | Type | Constraints |
|---|---|---|---|
Titl | 0..1 | Max35Text | length 1–35 |
Nm | 0..1 | Max140Text | length 1–140 |
TaxInformation3#
| Element | Card. | Type | Constraints |
|---|---|---|---|
Cdtr | 0..1 | TaxParty1 | |
Dbtr | 0..1 | TaxParty2 | |
AdmstnZn | 0..1 | Max35Text | length 1–35 |
RefNb | 0..1 | Max140Text | length 1–140 |
Mtd | 0..1 | Max35Text | length 1–35 |
TtlTaxblBaseAmt | 0..1 | ActiveOrHistoricCurrencyAndAmount | |
TtlTaxAmt | 0..1 | ActiveOrHistoricCurrencyAndAmount | |
Dt | 0..1 | ISODate | |
SeqNb | 0..1 | Number | 0 decimals max |
Rcrd | 0..* | TaxRecord1 |
TaxParty1#
| Element | Card. | Type | Constraints |
|---|---|---|---|
TaxId | 0..1 | Max35Text | length 1–35 |
RegnId | 0..1 | Max35Text | length 1–35 |
TaxTp | 0..1 | Max35Text | length 1–35 |
TaxParty2#
| Element | Card. | Type | Constraints |
|---|---|---|---|
TaxId | 0..1 | Max35Text | length 1–35 |
RegnId | 0..1 | Max35Text | length 1–35 |
TaxTp | 0..1 | Max35Text | length 1–35 |
Authstn | 0..1 | TaxAuthorisation1 |
TaxPeriod1#
| Element | Card. | Type | Constraints |
|---|---|---|---|
Yr | 0..1 | ISODate | |
Tp | 0..1 | TaxRecordPeriod1Code | 18 codes |
FrToDt | 0..1 | DatePeriodDetails |
