Sepa Formate

Aus succestWiki
Wechseln zu: Navigation, Suche

SEPA Formate

Mit dem Release 2017.04 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>-Tag folgender Loader hinzugefügt werden:

   
      <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> angepasst werden. Unter dem <LoaderDirectory> und dem <LoaderLogfileDirectory> werden die Dateien nur zwischengespeichert um anschließend in das "SUCCEST-TCR\LoadingFiles"-Verzeichniss des TCR's verschoben zu werden.

Für den Loader muss anschließend noch ein Loadingsystem unter dem <TargetLoaderMatrix>-Tag erstellt werden

         
      <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}--> wichtig und muss als erstes nach dem <rec>-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. {$customer_name}, entsprechen bis auf die folgenden Zeichen: {,$ & }, den Aktivitätsvariablen und werden aus der Aktivität bzw. dem Testfall heraus mit Inhalt gefüllt.

Hinweis:

  • 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 <id>-Tags angepasst werden.
  • Stellen Sie sicher, die Platzhalter mit Ihren Aktivitätsvariablen zu ersetzen


PAIN 001 - Vorlage

<?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:

Bild 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.

Bild 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