Sepa Formate: Unterschied zwischen den Versionen

Aus succestWiki
Wechseln zu: Navigation, Suche
K
Zeile 354: Zeile 354:
  
 
'''WICHTIG:'''
 
'''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.
+
Sollten zwei CAMT-Testfallaktivitäten an einem Tag ausgeführt werden, so müssen die in Abbildung 1 rot markierten Felder 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.
 
Der hier gezeigte Ausschnitt wurde bereits mit dem Inhalt der Aktivitäten befüllt.
−
[[Datei:Camt-Testfall.png|thumb|Abbildung 1: CAMT-Testfallaktivitäten]]
+
<gallery>
 +
Datei:Camt-Testfall.png|Abb. 1: CAMT-Testfallaktivitäten
 +
</gallery>
 +
 
 
<syntaxhighlight lang="xml">
 
<syntaxhighlight lang="xml">
 
<BkToCstmrDbtCdtNtfctn>
 
<BkToCstmrDbtCdtNtfctn>

Version vom 21. März 2018, 15:13 Uhr

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

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

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 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 drei Zeichen: {$}, 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 <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:

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 müssen die in Abbildung 1 rot markierten Felder 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.

<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