Sepa Formate

Aus succestWiki
Wechseln zu: Navigation, Suche

SEPA Formate

Mit dem Release 2017R04 unterstützt succest drei verschiedene Datei Formate.

  • PAIN 001 (CustomerCreditTransferInitiation)
  • PAIN 008 (CustomerDirectDebitInitiation)
  • CAMT 054 (BankToCustomerDebitCreditNotification)

Aktuell werden die Versionen 3.0 & 3.1 der Anlage 3 des EBICS DFÜ-Abkommens unterstützt.

Voraussetzung

Damit man mit succest SEPA-Dateien in den entsprechenden Formaten erzeugen kann, müssen folgende Voraussetzungen getroffen sein.

Ladedatei

Für jedes SEPA-Datei Format muss ein Ladeobjekt erzeugt werden.

Als Beispiel wurden die Ladeobjekte:

    SEPASCT  - Für PAIN 001
    SEPASDD  - Für PAIN 008
    SEPACAMT - Für CAMT 054

erzeugt.

Anpassung der Konfigurationsdateien

Konfigurationsdatei WorkflowConfiguration

Die Workflowkonfiguration muss um die folgenden Einträge erweitert werden:

<Assignment>
  <MigObject>SEPASCT</MigObject>
  <PersisterClass>TestcaseRepositoryAPI.Persisters.PersistLoaderDataSEPACreditTransferFile</PersisterClass>
</Assignment>
<Assignment>
  <MigObject>SEPASDD</MigObject>
  <PersisterClass>TestcaseRepositoryAPI.Persisters.PersistLoaderDataSEPADirectDebitFile</PersisterClass>
</Assignment>
<Assignment>
  <MigObject>SEPACAMT</MigObject>
  <PersisterClass>TestcaseRepositoryAPI.Persisters.PersistLoaderDataCAMTFile</PersisterClass>
</Assignment>

Der Wert der als <MigObject> angegeben ist, muss den zuvor erstellten Ladedateien entsprechen.

Konfigurationsdatei LoadingSystemConfiguration

Der Loadingsystemkonfiguration muss unter dem <Loader></syntaxhighlight lang="xml" inline>-Tag folgender Loader hinzugefügt werden: <syntaxhighlight lang="xml"> <Loader Name="SEPA"> <Uri>sepa://SEPA</Uri> <LoaderDirectory>D:\SUCCEST-TCR\TempLoadingFiles</LoaderDirectory> <LoaderLogfileDirectory>D:\SUCCEST-TCR\TempLoadingFiles\Logs</LoaderLogfileDirectory> <UseUnixLineFeed>False</UseUnixLineFeed> <UseByteOrderMarks>False</UseByteOrderMarks> <Encoding>default</Encoding> <IsDummyMode>False</IsDummyMode> </Loader> Bei der Konfiguration des Loaders, darf alles, bis auf die <Uri></syntaxhighlight lang="xml" inline> angepasst werden. Unter dem <syntaxhighlight lang="xml" inline><LoaderDirectory></syntaxhighlight lang="xml" inline> und dem <syntaxhighlight lang="xml" inline><LoaderLogfileDirectory></syntaxhighlight lang="xml" inline> werden die Dateien nur zwischengespeichert um anschließend in das "SUCCEST-TCR\LoadingFiles"-Verzeichniss des TCR verschoben zu werden. Für den Loader muss anschließend noch ein Loadingsystem unter dem <syntaxhighlight lang="xml" inline><TargetLoaderMatrix></syntaxhighlight lang="xml" inline>-Tag erstellt werden <syntaxhighlight lang="xml"> <LoadingSystem> <Uri>sepa://SEPA</Uri> <TargetSystems> <TargetSystemUri>sepa://SEPA</TargetSystemUri> </TargetSystems> </LoadingSystem>

Template erstellen

Damit die SEPA-Dateien richtig erzeugt werden, benötigt es passende Erzeugunsvorlagen.

Bei der Erstellung der Vorlage ist die Zeile <!-- {$TestCaseId:N};{$Id:N} --&gt;</syntaxhighlight lang="xml" inline> wichtig und muss als erstes nach dem <syntaxhighlight lang="xml" inline><rec></syntaxhighlight lang="xml" inline>-Tag folgen, der weitere Inhalt der Vorlage hängt von dem jeweiligen SEPA-Format ab und kann nach belieben, sofern es der jeweilige SEPA-Standard zulässt, angepasst werden. Die Platzhalter, wie z. B. <syntaxhighlight lang="xml" inline>{$customer_name}</syntaxhighlight lang="xml" inline>, entsprechen bis auf die folgenden drei Zeichen: <syntaxhighlight lang="xml" inline>{$}</syntaxhighlight lang="xml" inline>, den Aktivitätsvariablen und werden aus der Aktivität bzw. dem Testfall heraus mit Inhalt gefüllt. '''Hinweise:''' * Die hier gezeigten Vorlagen können in eine leere XML-Datei kopiert und unter dem "SUCCEST-TCR\Templates"-Verzeichniss abgespeichert werden. Das TCR erkennt diese dann automatisch. * Zur Sicherheit sollte der Inhalt des <syntaxhighlight lang="xml" inline><id></syntaxhighlight lang="xml" inline>-Tags angepasst werden. * Stellen Sie sicher, die Platzhalter mit Ihren Aktivitätsvariablen zu ersetzen. ==== PAIN 001 - Vorlage ==== <syntaxhighlight lang="xml"> <?xml version="1.0" encoding="utf-8"?> <root> <version>1</version> <textTemplateType>GenerationTemplate</textTemplateType> <id>c2dc220e-b2d0-413b-bd4f-88cfa3809f90</id> <recs> <rec> <!-- {$TestCaseId:N};{$Id:N}--> <Document xmlns="urn:iso:std:iso:20022:tech:xsd:pain.001.001.03" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="urn:iso:std:iso:20022:tech:xsd:pain.001.001.03 pain.001.001.03.xsd"> <CstmrCdtTrfInitn> <GrpHdr> <MsgId></MsgId> <CreDtTm></CreDtTm> <NbOfTxs></NbOfTxs> <CtrlSum></CtrlSum> <InitgPty> <Nm>{$customer_name}</Nm> </InitgPty> </GrpHdr> <PmtInf> <PmtInfId></PmtInfId> <PmtMtd></PmtMtd> <NbOfTxs></NbOfTxs> <CtrlSum></CtrlSum> <PmtTpInf> <SvcLvl> <Cd></Cd> </SvcLvl> </PmtTpInf> <ReqdExctnDt>{$execution_date:yyyy-MM-dd}</ReqdExctnDt> <Dbtr> <Nm>{$debitor_name}</Nm> </Dbtr> <DbtrAcct> <Id> <IBAN>{$debitor_iban}</IBAN> </Id> </DbtrAcct> <DbtrAgt> <FinInstnId> <BIC>{$debitor_bic}</BIC> </FinInstnId> </DbtrAgt> <ChrgBr></ChrgBr> <CdtTrfTxInf> <PmtId> <EndToEndId></EndToEndId> </PmtId> <Amt> <InstdAmt Ccy="EUR">{$amount:0.00/CI:en-US}</InstdAmt> </Amt> <CdtrAgt> <FinInstnId> <BIC>{$creditor_bic}</BIC> </FinInstnId> </CdtrAgt> <Cdtr> <Nm>{$creditor_name}</Nm> </Cdtr> <CdtrAcct> <Id> <IBAN>{$creditor_iban}</IBAN> </Id> </CdtrAcct> <RmtInf> <Ustrd>{$usage1} {$usage2} {$usage3}</Ustrd> </RmtInf> </CdtTrfTxInf> </PmtInf> </CstmrCdtTrfInitn> </Document> </rec> </recs> <loadingObject>SEPASCT</loadingObject> <availableInActivities> <activity></activity> </availableInActivities> <fields /> <internal.recs /> </root>


PAIN 008 - Vorlage

<?xml version="1.0" encoding="utf-8"?>
<root>
  <version>1</version>
  <textTemplateType>GenerationTemplate</textTemplateType>
  <id>a6e190f2-ab46-4f26-828f-def849c5410b</id>
  <recs>
    <rec>
	<!--       {$TestCaseId:N};{$Id:N}-->
      <Document xmlns="urn:iso:std:iso:20022:tech:xsd:pain.008.001.02" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="urn:iso:std:iso:20022:tech:xsd:pain.008.001.02 pain.008.001.02.xsd">
        <CstmrDrctDbtInitn>
          <GrpHdr>
            <MsgId></MsgId>
            <CreDtTm></CreDtTm>
            <NbOfTxs></NbOfTxs>
            <CtrlSum></CtrlSum>
            <InitgPty>
              <Nm>{$customer_name}</Nm>
            </InitgPty>
          </GrpHdr>
          <PmtInf>
            <PmtInfId></PmtInfId>
            <PmtMtd></PmtMtd>
            <NbOfTxs></NbOfTxs>
            <CtrlSum></CtrlSum>
            <PmtTpInf>
              <SvcLvl>
                <Cd></Cd>
              </SvcLvl>
              <LclInstrm>
                <Cd>{$DDBusinessType}</Cd>
              </LclInstrm>
              <SeqTp>{$SeqTp}</SeqTp>
            </PmtTpInf>
            <ReqdColltnDt>{$execution_date:yyyy-MM-dd}</ReqdColltnDt>
            <Cdtr>
              <Nm>{$creditor_name}</Nm>
            </Cdtr>
            <CdtrAcct>
              <Id>
                <IBAN>{$creditor_iban}</IBAN>
              </Id>
            </CdtrAcct>
            <CdtrAgt>
              <FinInstnId>
                <BIC>{$creditor_bic}</BIC>
              </FinInstnId>
            </CdtrAgt>
            <ChrgBr></ChrgBr>
            <CdtrSchmeId>
              <Id>
                <PrvtId>
                  <Othr>
                    <Id>{$believerId}</Id>
                    <SchmeNm>
                      <Prtry></Prtry>
                    </SchmeNm>
                  </Othr>
                </PrvtId>
              </Id>
            </CdtrSchmeId>
            <DrctDbtTxInf>
              <PmtId>
                <EndToEndId></EndToEndId>
              </PmtId>
              <InstdAmt Ccy="EUR">{$amount:0.00/CI:en-US}</InstdAmt>
              <DrctDbtTx>
                <MndtRltdInf>
                  <MndtId>{$believerId}</MndtId>
                  <DtOfSgntr>{$DateOfMandatSignature:yyyy-MM-dd}</DtOfSgntr>
                </MndtRltdInf>
              </DrctDbtTx>
              <DbtrAgt>
                <FinInstnId>
                  <BIC>{$debitor_bic}</BIC>
                </FinInstnId>
              </DbtrAgt>
              <Dbtr>
                <Nm>{$debitor_name}</Nm>
              </Dbtr>
              <DbtrAcct>
                <Id>
                  <IBAN>{$debitor_iban}</IBAN>
                </Id>
              </DbtrAcct>
              <RmtInf>
                <Ustrd>{$usage1} {$usage2} {$usage3}</Ustrd>
              </RmtInf>
            </DrctDbtTxInf>
          </PmtInf>
        </CstmrDrctDbtInitn>
      </Document>
    </rec>
  </recs>
  <loadingObject>SEPASDD</loadingObject>
  <availableInActivities>
    <activity></activity>
  </availableInActivities>
  <fields/>
  <internal.recs />
</root>


CAMT 054 - Vorlage

<?xml version="1.0" encoding="utf-8"?>
<root>
  <version>1</version>
  <textTemplateType>GenerationTemplate</textTemplateType>
  <id>2028b1ca-b5ca-4dd4-8c2e-00caa7de24cc</id>
  <recs>
    <rec>
      <!--       {$TestCaseId:N};{$Id:N}-->
      <Document xmlns="urn:iso:std:iso:20022:tech:xsd:camt.054.001.02" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="urn:iso:std:iso:20022:tech:xsd:camt.054.001.02 camt.054.001.02.xsd">
        <BkToCstmrDbtCdtNtfctn>
          <GrpHdr>
            <MsgId></MsgId>
            <CreDtTm></CreDtTm>
          </GrpHdr>
          <Ntfctn>
            <Id></Id>
            <CreDtTm></CreDtTm>
            <Acct>
              <Id>
                <IBAN>{$customer_iban}</IBAN>
              </Id>
              <Ccy>EUR</Ccy>
              <Ownr>
                <Nm>{$customer_name}</Nm>
              </Ownr>
            </Acct>
            <Ntry>
              <Amt Ccy="EUR"></Amt>
              <CdtDbtInd>{$CreditDebitCode}</CdtDbtInd>
              <Sts></Sts>
              <BkTxCd />
              <NtryDtls>
                <TxDtls>
                  <Refs>
                    <EndToEndId></EndToEndId>
                    <MndtId></MndtId>
                  </Refs>
                  <AmtDtls>
                    <TxAmt>
                      <Amt Ccy="EUR">{$amount:0.00/CI:en-US}</Amt>
                    </TxAmt>
                  </AmtDtls>
                  <BkTxCd></BkTxCd>
                  <RltdPties>
                    <Dbtr>
                      <Nm>{$debitor_name}</Nm>
                    </Dbtr>
                    <DbtrAcct>
                      <Id>
                        <IBAN>{$debitor_iban}</IBAN>
                      </Id>
                    </DbtrAcct>
                    <Cdtr>
                      <Nm>{$creditor_name}</Nm>
                    </Cdtr>
                    <CdtrAcct>
                      <Id>
                        <IBAN>{$creditor_iban}</IBAN>
                      </Id>
                    </CdtrAcct>
                  </RltdPties>
                  <RmtInf>
                    <Ustrd>{$usage1} {$usage2} {$usage3}</Ustrd>
                  </RmtInf>
                </TxDtls>
              </NtryDtls>
            </Ntry>
          </Ntfctn>
        </BkToCstmrDbtCdtNtfctn>
      </Document>
    </rec>
  </recs>
  <loadingObject>SEPACAMT</loadingObject>
  <availableInActivities>
    <activity></activity>
  </availableInActivities>
  <fields />
  <internal.recs />
</root>

Hinweis: Bei der Ausführung eines CAMT-Testfalls gibt es folgendes zu beachten:

Abbildung 1 zeigt zwei CAMT-Testfallaktivitäten, die an einem Tag ausgeführt werden sollen. Die rot umrandeten Eingabefelder entsprechen dem folgendem Ausschnitt aus unserer oben gezeigten Vorlage.

WICHTIG: Sollten zwei CAMT-Testfallaktivitäten an einem Tag ausgeführt werden, so muss der hier gezeigte Teil der Testfallaktivitäten bzw. der damit verbundene XML-Teil identisch sein, sonst führt dies zu einem Fehler.

Der hier gezeigte Ausschnitt wurde bereits mit dem Inhalt der Aktivitäten befüllt.

Abbildung 1: CAMT-Testfallaktivitäten
<BkToCstmrDbtCdtNtfctn>
  <GrpHdr>
     <MsgId/>
     <CreDtTm/>
  </GrpHdr>
  <Ntfctn>
     <Id/>
     <CreDtTm/>
     <Acct>
	<Id>
	   <IBAN>DE02500604148020448680</IBAN>
	</Id>
	<Ccy>EUR</Ccy>
	<Ownr>
	   <Nm>Harry H.</Nm>
	</Ownr>
     </Acct>
     <Ntry>
	<Amt Ccy="EUR">2000</Amt>
	<CdtDbtInd>CRDT</CdtDbtInd>
	<Sts>BOOK</Sts>
	<BkTxCd />
	<NtryDtls>
        ...

Aktivität erstellen

Um eine Aktivität zu erstellen schauen Sie bitte unter: Erstellung und Pflege von fachlichen Aktivitäten