Konfiguracja połączenia (Plus KSeF)

Opis ogólny

W celu rozpoczęcia pracy z pluginem konieczne jest skonfigurowanie połączenia z systemem KSeF. W tym celu konieczne jest pozyskanie od klienta/dostawcy tokenu autoryzującego, który należy podać w konfiguracji modułu. Wtyczka pozwala na zdefiniowanie wielu połączeń z KSeF (wiele nipów/tokenów). Konfiguracja połączeń znajduje się w module "Zarządzanie konfiguracjami wtyczek" (PCM) w administracji.

Przykładowa konfiguracja

Przykładowy JSON

{
    "nip": "7642569478",
    "tokenAuth": "1D455648146EA3CBC4B1E7DA066457F4DFDF7E286308873C5805EF80BB9604A0",
    "documentClassId": 4,
    "mappings": [
        {
            "ksefParam": "invoiceReferenceNumber",
            "docClassIndex": 5
        },
        {
            "ksefParam": "ksefReferenceNumber",
            "docClassIndex": 6
        },
        {
            "ksefParam": "invoicingDate",
            "docClassIndex": 7
        },
        {
            "ksefParam": "subjectByName",
            "docClassIndex": 9
        },
        {
            "ksefParam": "subjectToName",
            "docClassIndex": 10
        },
        {
            "ksefParam": "net",
            "docClassIndex": 11
        },
        {
            "ksefParam": "vat",
            "docClassIndex": 12
        },
        {
            "ksefParam": "gross",
            "docClassIndex": 13
        },
        {
            "ksefParam": "subjectByNip",
            "docClassIndex": 14
        },
        {
            "ksefParam": "subjectToNip",
            "docClassIndex": 15
        }
    ],
    "ksefSystemType": "TEST"
}

Parametry

Parametr	Opis
Adres URL *	Parametr określający rodzaj systemu z którym ma zostać nawiązanie połączenie. UWAGA: Każdy rodzaj systemów wymaga unikalnego Tokenu autoryzującego.
NIP *	NIP kontrahenta powiązanego z wprowadzonym tokenem
Token autoryzujący *	Wygenerowany (przez klienta) token autoryzujący, służący do połączenia z systemem KSeF. UWAGA: podczas generowania tokena określane są uprawnienia. Wtyczka do poprawnego działania wymaga oznaczenia 2 uprawnień: (Zrzut pochodzi z systemy KSeF) Jeżeli w ramach wdrożenia przewidywane jest tylko pobieranie faktur, to uprawnienie "wystawianie faktur" nie musi być nadane.
Klasa dokumentów do której zostaną zapisane pobrane pliki *	Klasa dokumentów w systemie PlusWorkflow w której będą zapisywane pobierane faktury. Jeżeli założenia biznesowe, wymagają utworzenia procesu dla pobranej faktury, to konieczne jest zdefiniowanie odpowiedniej akcji na klasie dokumentów.
Parametr z systemu KSeF	Element tablicowy, pozwalający na zmapowanie parametrów pobranych z KSeF na indeks w klasie dokumentów. W momencie pobierania faktury z KSeF mamy możliwość przypisania następujących informacji: Numer faktury, Numer KSeF, Data faktury, Znacznik czasowy, Nazwa wystawcy, NIP wystawcy, Nazwa nabywcy, Nip nabywcym Wartość netto, Wartość VAT, Wartość brutto. Wymienione dane pobierane są wraz z fakturą xml z API KSeFa, nie są to dane odczytane bezpośrednio z pliku xml. Pozostałe parametry faktur są możliwe do pobrania przez Zadanie automatyczne "Pobranie danych z faktury KSeF"
Indeks klasy dokumentów	Indeks klasy dokumentów.