Pain001
Try the demo ›

Message specification

pain.001.001.03 type reference (part 2 of 2) — NameAndAddress10 – TaxRecordDetails1

Types NameAndAddress10 – TaxRecordDetails1 in pain.001.001.03, defined once each — the view to use for field mapping.

4 min read Last reviewed

Complex types in ISO 20022 pain.001.001.03, generated from the official XSD. Part 2 of 2 — NameAndAddress10 – TaxRecordDetails1.

Part 1 · Part 2

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.

NameAndAddress10#

Element Card. Type Constraints
Nm 1..1 Max140Text length 1–140
Adr 1..1 PostalAddress6

OrganisationIdentification4#

Element Card. Type Constraints
BICOrBEI 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

Party6Choice#

Element Card. Type Constraints
OrgId 1..1 OrganisationIdentification4
PrvtId 1..1 PersonIdentification5

PartyIdentification32#

Element Card. Type Constraints
Nm 0..1 Max140Text length 1–140
PstlAdr 0..1 PostalAddress6
Id 0..1 Party6Choice
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

PaymentInstructionInformation3#

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 PartyIdentification32
DbtrAcct 1..1 CashAccount16
DbtrAgt 1..1 BranchAndFinancialInstitutionIdentification4
DbtrAgtAcct 0..1 CashAccount16
UltmtDbtr 0..1 PartyIdentification32
ChrgBr 0..1 ChargeBearerType1Code 4 codes
ChrgsAcct 0..1 CashAccount16
ChrgsAcctAgt 0..1 BranchAndFinancialInstitutionIdentification4
CdtTrfTxInf 1..* CreditTransferTransactionInformation10

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

RemittanceAmount1#

Element Card. Type Constraints
DuePyblAmt 0..1 ActiveOrHistoricCurrencyAndAmount
DscntApldAmt 0..1 ActiveOrHistoricCurrencyAndAmount
CdtNoteAmt 0..1 ActiveOrHistoricCurrencyAndAmount
TaxAmt 0..1 ActiveOrHistoricCurrencyAndAmount
AdjstmntAmtAndRsn 0..* DocumentAdjustment1
RmtdAmt 0..1 ActiveOrHistoricCurrencyAndAmount

RemittanceInformation5#

Element Card. Type Constraints
Ustrd 0..* Max140Text length 1–140
Strd 0..* StructuredRemittanceInformation7

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

StructuredRemittanceInformation7#

Element Card. Type Constraints
RfrdDocInf 0..* ReferredDocumentInformation3
RfrdDocAmt 0..1 RemittanceAmount1
CdtrRefInf 0..1 CreditorReferenceInformation2
Invcr 0..1 PartyIdentification32
Invcee 0..1 PartyIdentification32
AddtlRmtInf 0..3 Max140Text length 1–140

TaxAmount1#

Element Card. Type Constraints
Rate 0..1 PercentageRate 10 decimals max
TaxblBaseAmt 0..1 ActiveOrHistoricCurrencyAndAmount
TtlAmt 0..1 ActiveOrHistoricCurrencyAndAmount
Dtls 0..* TaxRecordDetails1

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

TaxRecord1#

Element Card. Type Constraints
Tp 0..1 Max35Text length 1–35
Ctgy 0..1 Max35Text length 1–35
CtgyDtls 0..1 Max35Text length 1–35
DbtrSts 0..1 Max35Text length 1–35
CertId 0..1 Max35Text length 1–35
FrmsCd 0..1 Max35Text length 1–35
Prd 0..1 TaxPeriod1
TaxAmt 0..1 TaxAmount1
AddtlInf 0..1 Max140Text length 1–140

TaxRecordDetails1#

Element Card. Type Constraints
Prd 0..1 TaxPeriod1
Amt 1..1 ActiveOrHistoricCurrencyAndAmount