pyiso20022 is a library for generating ISO20022 messages in Python.
Project description
PYISO20022 - an ISO 20022 Message Generator
A package of classes to support payment message generation (for ISO 20022 payment messages).
These are the type of payments messages used in SWIFT for payment schemes such as TARGET2, CHAPS, CBPR+, MEPS+ etc. You may hear them refered to as PACS messages.
You may also use these messages if you intitate payments from your company into a larger financial institution, in this scenario you will be generating PAIN (thats Payment Initiation) messages.
Using pyiso20022 package
Install this package and some others...
pip install pyiso20022
pip install xsdata[cli,lxml,soap]
Then use this code to parse a PAIN message...:
from xsdata.formats.dataclass.parsers import XmlParser
from pyiso20022.pain.pain_001_001_08 import *
import sys
parser = XmlParser()
# Read in a file, you can get an example PAIN (Payment Initiation) message from:
# https://developer.gs.com/docs/services/transaction-banking/pain001sample/
with open("example_files/gs_pain/pain001_001_08.xml", "rb") as xml_file:
doc: Document = parser.parse(xml_file, Document, )
# Print out the Post Code.
print(doc.cstmr_cdt_trf_initn.pmt_inf[0].dbtr.pstl_adr.pst_cd)
or...
Create a MX (ISO20022) payment message programatically:
This is an example of how to create a realistic PACS.008 MX payment message.
(it should write out a file called: my_pacs_008_from_code.xml
)
Depending on your setup you may need a different or even no wrapper element (I've used here, but yours might be called something different etc)
from pyiso20022.pacs.pacs_008_001_08 import *
import pyiso20022.head.head_001_001_02 as hd
from xsdata.formats.dataclass.serializers import XmlSerializer
from xsdata.formats.dataclass.serializers.config import SerializerConfig
import uuid
from lxml import etree
from xsdata.models.datatype import XmlDateTime
clr_sys = ClearingSystemIdentification3Choice(cd="STG")
the_sttlinf = SettlementInstruction7(sttlm_mtd=SettlementMethod1Code("CLRG"),
clr_sys=clr_sys)
# Create the Group Header
grp_header = GroupHeader93(msg_id="MIDTheMessageId",
nb_of_txs=1,
cre_dt_tm=XmlDateTime.from_string("2019-01-01T00:00:00"),
sttlm_inf=the_sttlinf)
pmt_id = PaymentIdentification7(instr_id="IXWEDRFTGHJK5",
end_to_end_id="E2EDRFGHJK7",
tx_id="TIDRFGHJ54678",
uetr=str(uuid.uuid4()))
zero_amt = ActiveOrHistoricCurrencyAndAmount(ccy="GBP", value=0)
bic_1 = FinancialInstitutionIdentification18("BARCGB22")
bic_2 = FinancialInstitutionIdentification18("VODAGB23")
agt = BranchAndFinancialInstitutionIdentification6(fin_instn_id=bic_1)
instd_agt = BranchAndFinancialInstitutionIdentification6(fin_instn_id=bic_2)
instg_agt = BranchAndFinancialInstitutionIdentification6(fin_instn_id=bic_1)
chrgs_inf = Charges7(amt=zero_amt, agt=agt)
ult_pstl = PostalAddress24(bldg_nm="10",
strt_nm="Cheapside",
twn_nm="London",
ctry="GB")
dbtr_pstl = PostalAddress24(bldg_nm="11",
strt_nm="Farside",
twn_nm="York",
ctry="GB")
ult_debtr = PartyIdentification135(nm="Mr Ulti Debtor",
pstl_adr=ult_pstl)
initg_pty = PartyIdentification135(nm="Ms Initd Party",
pstl_adr=ult_pstl)
reg_debtr = PartyIdentification135(nm="Mrs Reg Debtor",
pstl_adr=dbtr_pstl)
instr_for_nxt_agt = InstructionForNextAgent1(instr_inf="HOLD")
instd_amt = ActiveOrHistoricCurrencyAndAmount(ccy="GBP", value=555.01)
intra_bk_st_amt = ActiveCurrencyAndAmount(ccy="GBP", value=555.01)
purp = Purpose2Choice(cd="PHON")
rem_loc = RemittanceLocation7(rmt_id="BUSINESS DEBIT")
rmt_inf = RemittanceInformation16(ustrd=["INVOICE 123456"])
cdtrtx = CreditTransferTransaction39(pmt_id=pmt_id,
chrg_br=ChargeBearerType1Code("SHAR"),
intr_bk_sttlm_dt="2019-01-01",
intr_bk_sttlm_amt=intra_bk_st_amt,
instd_amt=instd_amt,
chrgs_inf=[chrgs_inf],
instg_agt=instg_agt,
instd_agt=instd_agt,
ultmt_dbtr=ult_debtr,
initg_pty=initg_pty,
dbtr=reg_debtr,
dbtr_agt=instg_agt,
cdtr_agt=instd_agt,
instr_for_nxt_agt=[instr_for_nxt_agt],
purp=purp,
rltd_rmt_inf=[rem_loc],
rmt_inf=rmt_inf)
f2f_cust_cred_trans = FitoFicustomerCreditTransferV08(grp_hdr=grp_header,
cdt_trf_tx_inf=[cdtrtx])
doc = Document(fito_ficstmr_cdt_trf=f2f_cust_cred_trans)
# Create the AppHdr
fr_fiid = hd.FinancialInstitutionIdentification18(bicfi="BARCGB22")
fr_bafii = hd.BranchAndFinancialInstitutionIdentification6(fin_instn_id=fr_fiid)
fr_party44 = hd.Party44Choice(fiid=fr_bafii)
to_fiid = hd.FinancialInstitutionIdentification18(bicfi="BARCGB22")
to_bafii = hd.BranchAndFinancialInstitutionIdentification6(fin_instn_id=to_fiid)
to_party44 = hd.Party44Choice(fiid=to_bafii)
header = hd.AppHdr(fr=fr_party44,
to=to_party44,
biz_msg_idr="MIDRFGHJKL",
msg_def_idr="pacs.008.001.08",
biz_svc="boe.chaps.enh.01",
cre_dt="2019-01-01T00:00:00",
prty="NORM")
config_subs = SerializerConfig(pretty_print=True, xml_declaration=False)
serializer_subs = XmlSerializer(config=config_subs)
ns_map_header: dict[None, str] = {
None: "urn:iso:std:iso:20022:tech:xsd:head.001.001.02"
}
ns_map_doc: dict[None, str] = {
None: "urn:iso:std:iso:20022:tech:xsd:pacs.008.001.08"
}
header_el: str = serializer_subs.render(header, ns_map=ns_map_header)
doc_el: str = serializer_subs.render(doc, ns_map=ns_map_doc)
msg_root = etree.Element('MSGRoot')
msg_root.append(etree.fromstring(header_el))
msg_root.append(etree.fromstring(doc_el))
msg_full = etree.tostring(msg_root, pretty_print=True,
xml_declaration=True, encoding='UTF-8')
with open("my_pacs_008_from_code.xml", "w") as xml_file:
xml_file.write(str(msg_full, encoding='utf-8'))
Message types?
Currently only supports PACS & PAIN messages as well as HEAD (header documents for the PACS).
Source of truth?
If you want the original source of truth for all things ISO 20022 schema related then check out www.iso20022.org
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for pyiso20022-0.1.5-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 9fb1537078162ebb49ae453d9fe2c8ed5dcd9be424041d63feb40a557b97cc49 |
|
MD5 | aca89d05b8739908de90a7d2ce762ddc |
|
BLAKE2b-256 | 0a890a9ca213f09728879c1b407245e604e049f016f85c0fd70f0352d30ea0c7 |