Pain001
Try the demo ›

Message specification

pain.001.001.04 type reference (part 2 of 3) — InstructionForCreditorAgent1 – TaxPeriod1

Types InstructionForCreditorAgent1 – TaxPeriod1 in pain.001.001.04, defined once each — the view to use for field mapping.

4 min read Last reviewed

Complex types in ISO 20022 pain.001.001.04, generated from the official XSD. Part 2 of 3 — InstructionForCreditorAgent1 – TaxPeriod1.

Part 1 · Part 2 · Part 3

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#

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#

Element Card. Type Constraints
Cd 1..1 ExternalOrganisationIdentification1Code length 1–4
Prtry 1..1 Max35Text length 1–35

Party11Choice#

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

PaymentInstruction6#

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..* CreditTransferTransaction1

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#

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#

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#

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#

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#

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