Definition des Konfigurationspunkts (Einkaufsdokumente aus KSeF importieren)

Mit der Version 2024.0.0 steht Ihnen ein neuer Typ des ACD-Punkts zur Verfügung, der bei der Kooperation mit KSeF verwendet wird – Einkaufsdokumente aus KSeF importieren.

 

Karteireiter Kooperationsmodus

Um einen neuen Konfigurationspunkt vom Typ Einkaufsdokumente aus KSeF importieren anzulegen, fügen Sie über das Symbol im Feld Automatische Generierung von Dokumenten einen neuen Konfigurationspunkt hinzu und anschließend wählen Sie aus der Liste der Arbeitsmodi die Option Einkaufsdokumente aus KSeF importieren aus.

Konfigurationspunkt des Typs Einkaufsdokumente aus KSeF importieren, Karteireiter Kooperationsmodus

 

Karteireiter Allgemein

Das Aussehen des Karteireiters Allgemein unterscheidet sich je nach Betriebsmodus von Comarch DMS.

Im Single-Company-Modus sind folgende Felder verfügbar:

  • Punktname – geben Sie einen Namen ein, unter welchem der Konfigurationspunkt auf der Liste der Punkte angezeigt werden soll;
  • Workflow-Typ – wählen Sie einen Workflow-Typ aus, mit welchem Dokumente mit KSeF-Daten erzeugt werden sollen.

Für Comarch DMS im Single-Company-Modus wird die Kommunikation mit KSeF auf der Basis von den Daten, die im Karteireiter KSeF, [Einstellungen] erfasst wurden: USt.-IdNr. des Unternehmens und Token zur Authentifizierung (siehe Integrationen („Integracje“, ehemalige Registerkarte „KSeF“))

 

Konfigurationspunkt des Typs Einkaufsdokumente aus KSeF importieren, Karteireiter Allgemein für Comarch DMS im Single-Company-Modus

 

Im Multi-Company-Modus sind folgende Felder verfügbar:

  • Punktname – geben Sie einen Namen ein, unter welchem der Konfigurationspunkt auf der Liste der Punkte angezeigt werden soll;
  • Organisation – geben Sie ein Unternehmen für die Kommunikation mit KSeF ein – anhand von der USt.-IdNr. und/oder dem Token, die im Karteireiter Verbindungen zu ERP-Systemen in den [Einstellungen] (siehe Verbindung mit ERP) festgelegt wurden. Anfragen, die in den Karteireitern Liste und Steuerelemente erstellt wurden, werden auch im Datenbankkontext der betroffenen Firma ausgeführt.
  • Workflow-Typ – wählen Sie einen Workflow-Typ aus, mit welchem Dokumente mit KSeF-Daten erzeugt werden sollen.

 

Konfigurationspunkt des Typs Einkaufsdokumente aus KSeF importieren, Karteireiter Allgemein für Comarch DMS im MultiCompany-Modus

 

Karteireiter Liste

Analog zu den anderen Betriebsmodi der Konfigurationspunkte soll unter dem Karteireiter Liste mit einer SQL-Abfrage eine Dokumentenliste für ACD ermittelt werden.

 

Achtung

In Version 2024.3.0 wurde die SQL-Abfrage, die die Liste der Dokumente anzeigt, geändert (siehe Beispiel unten).

Die SQL-Abfrage, die auf der Registerkarte „Liste“ in der Konfiguration der ACD- Punktes des Typs „Einkaufsdokumente aus KSeF importieren“ eingegeben wird, unterscheidet sich von den SQL-Abfragen für andere ACD-Punktetypen und auch von der SQL-Abfrage, die zuvor in der ACD- Punktes des Typs „Einkaufsdokumente aus KSeF importieren“ eingegeben wurde.

 

Beispiel: Exemplarische Anfrage zur Ermittlung der Dokumentenliste.

BEGIN TRY
select d.KSD_ID, NULL, KSD_NumerFaktury
from do.KS_Documents d 
left join do.KS_WorkAPProcess W on d.KSD_ID = KSW_DocumentID /* Tabelle der verarbeiteten Dokumente*/ 
left join do.KS_DocumentHeaders dh on d.KSD_ID = dh.KSH_DocumentId
left join do.KS_DocumentContractors dc on d.KSD_ID = dc.KSC_DocumentID
where KSW_APDId=@PointId@ -- ACD Punkt-ID 
and KSW_OperatorID=@IdOperatorDMS@ /* Zusatzbedingung, damit der Operator in der Liste die von ihm selbst bearbeiteten Dokumente sieht*/
and ((@InvoiceStatus@ = 0 and KSW_Status <> 5 and KSW_Archival = 0) OR (@InvoiceStatus@ = 1 and KSW_Archival = 1) OR
(@InvoiceStatus@ = 2 and KSW_Status = 5) OR @InvoiceStatus@ = 3)
and (nullif(@SearchText@,'') is null OR (@SearchText@ <> '' and KSD_NumerFaktury LIKE @SearchText@ + '%'))
and (@Nip@ is null OR dc.KSC_PodatnikNIP = @Nip@)
and (@DateFrom@ is null or dh.KSH_DataWytworzeniaFa >= @DateFrom@)
and (@DateTo@ is null or dh.KSH_DataWytworzeniaFa <= @DateTo@)
and (@GrossAmountFrom@ is null or KSD_SumaBrutto >= @GrossAmountFrom@)
and (@GrossAmountTo@ is null or KSD_SumaBrutto <= @GrossAmountTo@)
and (@InvoiceType@ is null or KSD_RodzajFaktury = @InvoiceType@)
END TRY 
BEGIN CATCH 
DECLARE @ErrorMessage varchar(max) = ‘Bei der Abfrage ist ein Fehler aufgetreten: ' + ERROR_MESSAGE(); 
THROW 50001, @ErrorMessage ,1; 
END CATCH

 

Konfigurationspunkt des Typs Einkaufsdokumente aus KSeF importieren, Karteireiter Liste

 

Karteireiter Steuerelemente

Im Karteireiter Steuerelemente sollen über SQL-Anfragen die Werten ermittelt werden, welche in den einzelnen Steuerelementen nach der Verarbeitung eines Dokuments angezeigt werden.

Ab der Version 2024.3.0 kann der Benutzer eine pdf-Datei eines KSeF-Dokuments in die Steuerung des Typs „ Anhang“ einfügen. Dazu muss er in der Konfiguration des ACD-Punktes vom Typ „Einkaufsdokumente aus KSeF importieren“ folgende Schritte nacheinander durchführen:

  • Auf der Registerkarte „Allgemein“ im Feld „Workflow-Typ“ die Workflow-Art auswählen, in der sich die Steuerung des Typs „ Anhang“ befindet;
  • Wählen Sie auf der Registerkarte „Steuerelemente“ ein Steuerelement des Typs „ Anhang “ und geben Sie in das Feld auf der rechten Seite des Fensters eine SQL-Abfrage ein – im folgenden Beispiel wird der Dateiname der Name der Rechnung sein:
Select KSD_SourceContent,

CASE

WHEN KSD_NumerFaktury LIKE '%/%' THEN CONCAT(REPLACE(KSD_NumerFaktury, '/', '_'), '.pdf')

ELSE CONCAT(KSD_NumerFaktury, '.pdf')

END AS modified_column

from do.KS_Documents

where KSD_ID=@Id1@

 

Achtung

Bei Verwendung der obigen Abfrage wird das Zeichen / im Rechnungsnamen durch _ ersetzt.

 

Achtung

Bitte beachten Sie, dass im Gegensatz zu anderen SQL-Abfragen bei der Eingabe einer Abfrage für ein Steuerelement des Typs „ Anhang“ auf der Registerkarte „Steuerelemente“ bei der Konfiguration eines ACD-Punktes des Typs „Einkaufsdokumente aus KSeF importieren“ der Ausdruck „.pdf“ hinzugefügt werden muss, wie im obigen Beispiel gezeigt.

 

Eingabe einer Abfrage für eine Steuerelement des Typs Anhang innerhalb der Registerkarte „Steuerelemente“ bei der Konfiguration eines ACD-Punktes des Typs „ Einkaufsdokumente aus KSeF importieren”

 

Konfigurationspunkt des Typs Einkaufsdokumente aus KSeF importieren, Karteireiter Steuerelemente

 

Karteireiter Berechtigungen

Im Karteireiter Berechtigungen geben Sie die Mitarbeiter an, die für die Verarbeitung von Dokumenten innerhalb des Punktes berechtigt sein sollen. Die Berechtigungen können nur über die Angabe von Mitarbeitern hinzugefügt werden; es ist nicht möglich, eine Abteilung oder eine Position anzugeben und dadurch die Berechtigungen den zugehörigen Mitarbeitern zuzuteilen.

Für den Typ des Konfigurationstyps Einkaufsdokumente aus KSeF importieren finden Sie unter dem Karteireiter Berechtigungen die zusätzliche Spalte Bearbeiten eines Dokuments.

Wird für einen Mitarbeiter die Checkbox in dieser Spalte aktiviert, kann der Mitarbeiter Steuerelement-Werten direkt am ACD-Punkt ändern.

 

Konfigurationspunkt des Typs Einkaufsdokumente aus KSeF importieren, Karteireiter Berechtigungen, SingleCompany-Modus

 

Konfigurationspunkt des Typs Einkaufsdokumente aus KSeF importieren, Karteireiter Berechtigungen, MultiCompany-Modus

 

Achtung
Durch das Hinzufügen eines Benutzers zu Berechtigungen für den Konfigurationspunkt werden dem Benutzer die Berechtigungen für die Registerkarte ACD zugeteilt (in den Mitarbeiter-Eigenschaften, Tab Berechtigungen, Rubrik Funktionalitäten wird der Parameter für automatische Generierung von Dokumenten auf JA gesetzt)

Jeder Karteireiter enthält das Symbol [Export], mit dem ein ACD-Punkt zum Festplattenspeicher exportiert werden kann (siehe Export des ACD-Punkts) Ähnlich wie ACD-Punkte anderer Typen kann auch der Konfigurationspunkt vom Typ Einkaufsdokumente aus KSeF importieren importiert werden (siehe Import der Einkaufsdokumente aus KSeF).