Płace konfiguracja PIT

W programie Kadry i Płace funkcjonalność elektronicznej wysyłki deklaracji PIT realizowana jest przez bibliotekę ViDok, która służy do:

• Wysyłania dokumentów przez program Kadry i Płace do Ministerstwa Finansów,
• Składania podpisu cyfrowego na dokumentach.

Uwaga!

Od 2014-11-12 zastępuje program eWydruki.

Od 2019-01-02 pliki do podpisu elektronicznego zostały dodane do paczki płac w wersjach dystrybucyjnych i w automatycznej aktualizacji. Nie trzeba już ręcznie wgrywać paczki pl_podpis.zip.

Instalacja

1. Instalujemy aplikację Kadry i Płace w najnowszej dostępnej wersji.
2. W przypadku braku katalogu: C:\infosys_pity\PIT_WYSLANE\ należy go utworzyć (w przypadku instalacji serwerowych katalog powinien znajdować się lokalnie na stacjach roboczych operatorów).
3. Instalujemy najnowszą wersję oprogramowania JAVA w wersji 32-bitowej.

Zmiany wprowadzone względem wersji wymagającej dogrywania pl_podpis.zip:

• W pliku USWS.dll.config ustawione domyślnie zostały ścieżki względne do katalogów sdk_wrapper i pit_wzorce – teraz te katalogi będą w folderze płac.
• W pliku settings32.xml ustawiamy domyślnie zostały ścieżki względne do bibliotek DLL dla podpisów.
• Katalog sdk_wrapper od teraz będzie nazywany sdk_wrapper_datawydania. Dzięki tej zmianie możemy aktualizować biblioteki podpisu bez usuwania starych wersji.
• W pliku USWS.dll.config ustawiono domyślnie ścieżkę do katalogu pit_wyslane: C:\infosys_pity\PIT_WYSLANE\. W przypadku instalacji serwerowej katalog powinien znajdować się lokalnie na komputerze operatora.
• Dodano biblioteki mfc*.dll - są to biblioteki Microsoft Visual C++ 2017 Redistributable w wersji 32-bitowej. Dzięki tej zmianie nie potrzeba już ręcznie instalować vcredist.

Konfiguracja

USWS.dll.config

USWS.dll.config jest plikiem konfiguracyjnym biblioteki ViDOK. To w nim ustawiamy najważniejsze parametry wysyłki i podpisu PIT.

Struktura

<?xml version="1.0" encoding="utf-8" ?>
<configuration>
<system.serviceModel>
<bindings>
<basicHttpBinding>
<binding name="UslugiUBDSoap11">
<security mode="Transport" />
</binding>
<binding name="UslugiUBDSoap111" />
<binding name="UslugiUBDSoap112">
<security mode="Transport" />
</binding>
<binding name="UslugiUBDSoap113" />
</basicHttpBinding>
<customBinding>
<binding name="UslugiUBDSoap">
<textMessageEncoding messageVersion="Soap12" />
<httpsTransport />
</binding>
<binding name="UslugiUBDSoap1">
<textMessageEncoding messageVersion="Soap12" />
<httpsTransport />
</binding>
</customBinding>
<wsHttpBinding>
<binding name="e3">
<security mode="Transport">
<transport clientCredentialType="None" />
</security>
</binding>
</wsHttpBinding>
</bindings>
<client>
<endpoint address="https://ubd.mf.gov.pl/uslugi/dokumenty"
binding="customBinding" bindingConfiguration="UslugiUBDSoap"
contract="UBD.UslugiUBD" name="UslugiUBDPort" />
<endpoint address="https://ubd.mf.gov.pl/uslugi/dokumenty"
binding="basicHttpBinding" bindingConfiguration="UslugiUBDSoap11"
contract="UBD.UslugiUBD" name="UslugiUBD11Port" />
<endpoint address="https://test-ubd.mf.gov.pl/uslugi/dokumenty"
binding="customBinding" bindingConfiguration="UslugiUBDSoap1"
contract="UBDTest.UslugiUBD" name="UslugiUBDPortTest" />
<endpoint address="https://test-ubd.mf.gov.pl/uslugi/dokumenty"
binding="basicHttpBinding" bindingConfiguration="UslugiUBDSoap112"
contract="UBDTest.UslugiUBD" name="UslugiUBD11Port1" />
<endpoint address="https://Wyszukiwarkaregontest.stat.gov.pl/wsBIR/UslugaBIRzewnPubl.svc"
binding="wsHttpBinding" bindingConfiguration="e3" contract="TestBIR_REGON_WS.IUslugaBIRzewnPubl"
name="e3" />
</client>
</system.serviceModel>
<vidokConfigurations>
<template_path>PIT_WZORCE\</template_path>
<doc_path>C:\infosys_pity\PIT_WYSLANE\</doc_path>
<certificate_name>EDeklaracje</certificate_name>
<jvm32path></jvm32path>
<jvm64path></jvm64path>
<settings32>sdk_wrapper_181121\settings32.xml</settings32>
<settings64></settings64>
<workDir></workDir>
<RodzajBramki>Edeklaracje</RodzajBramki>
<Sig_exe></Sig_exe>
</vidokConfigurations>
</configuration>

Opis

Odwołania do linii w pliku USWS.dll.config:

34. <endpoint address="https://ubd.mf.gov.pl/uslugi/dokumenty" - adres URL bramki produkcyjnej,

40. <endpoint address="https://test-ubd.mf.gov.pl/uslugi/dokumenty" - adres URL bramki testowej,

52. <template_path>PIT_WZORCE\</template_path> - wskazuje ścieżkę względną do folderu w którym znajdują się wzorce,

53. <doc_path>C:\infosys_pity\PIT_WYSLANE\</doc_path> - wskazuje lokalizację w której mają być zapisywane wysłane PIT-y,

54. <certificate_name>EDeklaracje</certificate_name> - przyjazna nazwa zainstalowanego certyfikatu do podpisu cyfrowego,

55. <jvm32path> - wskazuje lokalizację do biblioteki jvm.dll wirtualnej maszyny Javy (domyślna lokalizacji Javy). Ścieżka podawana explicite wtedy i tylko wtedy, gdy program sam nie znajdzie zainstalowanego środowiska Java,

56. <jvm64path> - nieużywana,

57. <settings32> - wskazuje lokalizacje pliku z ustawieniami do modułu podpisującego,

58. <settings64> - nieużywana,

59. <workDir> - lokalizacja, w której moduł podpisujący zapisuje pliki,

60. <RodzajBramki> - wskazuje na typ serwera z jakim program ma się komunikować przy wysyłce deklaracji pojedynczych. Można podawać dwie wartości: Edeklaracje lub UBD.

61. <Sig_exe> - określa lokalizację programu podpisującego. Ścieżka bezwzględna podawana tylko w sytuacji, kiedy program podpisujący nie znajduje się w katalogu programu.

Uwaga!

• Brak którejkolwiek zmiennej, bądź brak folderu wskazanego w zmiennej spowoduje zgłoszenie wyjątku przez bibliotekę,
• Kolejność w sekcji <vidokConfigurations> ma znaczenie.

settings32.xml

W pliku settings32.xml ustawione domyślnie zostały ścieżki względne do bibliotek DLL dla podpisów. Nie ma potrzeby ich modyfikacji. Przykład

...
<HardwareProvider>
<Name>PKCS#11 Type A</Name>
<!-- 32bit environment -->
<URI>file:///C:/info-sys_groszek/place/sdk_wrapper_181121/lib/cmP11.dll</URI>
</HardwareProvider>
...

Instalacja lokalna, a serwerowa

W przypadku gdy aplikacja Kadry i Płace jest zainstalowana na serwerze i uruchamiana jest na stacjach roboczych operatorów zaleca się, aby katalog PIT_WYSLANE umieszczony był lokalnie na stacji roboczej.

Domyślna lokalizacja to C:\infosys_pity\PIT_WYSLANE\. Jej zmiany można dokonać w pliku USWS.dll.config w sekcji <doc_path>.

<doc_path>C:\infosys_pity\PIT_WYSLANE\</doc_path>

Przygotowanie i wysyłanie

Podpisywanie deklaracji PIT

1. Po wybraniu opcji Wyślij dokument – okno wstępne podpisywania, należy kliknąć Podpisz (rys. 1),
2. Po kliknięciu Podpisz – okno do wprowadzenia PIN-u do podpisu (rys. 2),
3. Po wprowadzeniu PIN-u i potwierdzeniu – okno z podsumowaniem (rys. 3),
4. Na zakończenie – podsumowanie wykonanych zadań (rys. 4).

• 
  Rysunek 1. Okno wstępnego podpisywania
• 
  Rysunek 2. Okno uwierzytelniania
• 
  Rysunek 3. Podsumowanie
• 
  Rysunek 4. Podsumowanie wykonanych zadań

Deklaracje PIT-11, PIT-40, PIT-8C

Do przygotowania tych deklaracji można wykorzystywać opcję wysyłki zbiorczej – należy wówczas zaznaczyć opcje wysyłki automatycznej, nie będzie wówczas konieczności potwierdzania wysyłki dla każdej osoby. Deklaracje wysyłane są zbiorczo dla wszystkich wybranych osób, otrzymywany numer referencyjny i potwierdzenie odbioru jest wówczas również identyczne dla wszystkich osób.

W przypadku wysyłania korekt deklaracji, należy wykonywać ich przygotowanie dla pojedynczych osób (opcja wysyłki zbiorczej nie może być zaznaczona, zbiorcze korekty nie są przyjmowane).

Wybieranie osób do przygotowania deklaracji

Po wybraniu opcji wysyłki automatycznej oraz zbiorczego wysyłania PIT, program bez dodatkowych pytań przygotowuje deklaracje dla wszystkich wybranych osób. Jeżeli istnieje potrzeba sprawdzenia i ew. pominięcia niektórych z nich, należy zaznaczyć opcję edycji danych przed drukiem – wówczas dane każdej osoby zostaną pokazane przed przygotowaniem deklaracji, można wybrać ich pominięcie lub drukowanie (przygotowanie danych PIT).

Uwaga!

• W sytuacji zatrudnienia pracownika w kilku miejscach pracy, PIT-y indywidualne są przygotowywane dla najniższego numeru zatrudnienia pracownika - w celu uniknięcia tworzenia podwójnych deklaracji. Zachowanie takie można zmienić wyłączając opcję Łączenia danych wynagrodzeń na PIT w Stałych parametrach systemu.

• 
  Rysunek 1. Parametry wzorca deklaracji

Konfiguracja

Elementy biblioteki ViDok

• CertificateTools.dll - biblioteka udostępniająca narzędzia do podpisywania cyfrowego,
• CPlusPlusToCSharp.dll - biblioteka integracyjna,
• USWS.dll - biblioteka udostępniająca narzędzia do wysyłki dokumentów do Ministerstwa Finansów,
• USWS.dll.config - plik konfiguracyjny dla biblioteki ViDok,
• itextsharp.dll,
• viDOK_Sig.exe - program, który podpisuje deklaracje,
• Wzorce deklaracji, których nie edytujemy. Ich obecność jest niezbędna do przygotowania dokumentu. Nazwa pliku wskazuje na rodzaj dokumentu:
  • PIT11_2014_20.xml,
  • PIT11_2014_21.xml,
  • PIT11_Z_2014_21.xml,
  • PIT11_Z_Pou_2014_21.xml,
  • PIT11_Z_Poz_2014_21.xml,
  • PIT40_2014_19.xml,
  • PIT40_2014_20.xml,
  • PIT40_Z_2014_20.xml,
  • PIT40_Z_Pou_2014_20.xml,
  • PIT40_Z_Poz_2014_20.xml,
  • PIT4R_2014_04.xml,
  • PIT4R_2014_05.xml,
  • PIT8AR_2014_03.xml,
  • PIT8AR_2014_04.xml,
  • PIT8C_2014_06.xml,
  • PIT8C_2014_07.xml,
  • PIT8C_Z_2014_07.xml,
  • PIT8C_Z_Pou_2014_07.xml,
  • PIT8C_Z_Poz_2014_07.xml,
  • PITR_2014_16.xml,
  • PITR_2014_17.xml,
  • PITR_Z_2014_17.xml,
  • PITR_Z_Pou_2014_17.xml,
  • PITR_Z_Poz_2014_17.xml.

Instalacja

1. Instalujemy:
   1. Microsoft Visual C++ 2010 Redistributable Package (x86) w wersji 32-bitowej (uzasadnienie w Płace FAQ),
   2. Microsoft .NET Framework 4.5.
2. Dostosowujemy plik konfiguracyjny USWS.dll.config według opisu z poniższego paragrafu,
3. Tworzymy katalogi do:
   1. Przechowywania wzorców deklaracji. Nazwa katalogu definiowana jest w tagu: <template_path>,
   2. Przechowywania wysłanych deklaracji. Nazwa katalogu definiowana jest w tagu: <doc_path>
4. Kopiujemy:
   1. Do katalogu programu:
      1. Pliki:
         1. CertificateTools.dll,
         2. CPlusPlusToCSharp.dll,
         3. USWS.dll,
         4. USWS.dll.config,
         5. itextsharp.dll,
         6. viDOK_Sig.exe.
   2. Na klienckich stacjach roboczych tworzymy katalog infosys-vidok w lokalizacji C:\. Do nowo utworzonego katalogu kopiujemy z całą zwartością:
      1. sdk_wrapper.
   3. Pliki wzorców do katalogu utworzonego w pkt. 3.1.
5. Podpis cyfrowy. W trakcie instalacji nadajemy przyjazną nazwę identyczną jak zmienna: <certificate_name>EDeklaracje</certificate_name> w pliku konfiguracyjnym. W pliku konfiguracyjnym EDeklaracje. Zmiana przyjaznej nazwy certyfikatu:
   1. Uruchamiamy narzędzie Certyfikaty poprzez wydanie polecenia certcertmgr.msc w oknie Uruchom (menu START > Uruchom lub naciskamy kombinację przycisków WIN + R),
   2. W nowotwartym oknie przechodzimy do gałęzi Certyfikaty – bieżący użytkownik > Osobisty > Certyfikaty,
   3. Z listy zainstalowanych certyfikatów wybrać jeden, który ma zostać wyróżniony przyjazną nazwą,
   4. Z podręcznego menu (dostępnego po kliknięciu ppm) wybieramy opcję Właściwości,
   5. W oknie Właściwości, na zakładce Ogólne w polu Przyjazna nazwa należy wprowadzić wybraną przyjazną nazwę dla certyfikatu. Aby uniknąć dodatkowych czynności, sugerowana jest nazwa EDeklaracje (wielkość liter ma znaczenie!),
   6. Zmiany należy zaakceptować przyciskiem OK, co spowoduje zamknięcie okna Właściwości i powrót do okna Certyfikaty. Na liście certyfikatów osobistych wybrany certyfikat powinien mieć w kolumnie Przyjazna nazwa podaną właśnie wprowadzoną przyjazną nazwę.
6. Jeśli zmienimy ścieżkę do pliku sdk_wrapper\settings32.xml (pkt. 3.2.), to w poniższej sekcji trzeba ustawić prawidłową, bezwzględną ścieżkę do bibliotek DLL.
   1. \sdk_wrapper\settings32.xml, parametr: PKCS#11 Type A ustawiamy w polu <URI> ścieżkę bezwzględną do biblioteki DLL właściwej dla danego podpisu (przykład poniżej).
7. Instalujemy oprogramowanie Java w wersji 7 lub wyżej,
8. Uruchamiamy program.

USWS.dll.config

Struktura

<?xml version="1.0" encoding="utf-8" ?>
<configuration>
  <system.serviceModel>
    <bindings>
      <basicHttpBinding>
        <binding name="UslugiUBDSoap11">
          <security mode="Transport" />
        </binding>
        <binding name="UslugiUBDSoap111" />
        <binding name="UslugiUBDSoap112">
          <security mode="Transport" />
        </binding>
        <binding name="UslugiUBDSoap113" />
      </basicHttpBinding>
      <customBinding>
        <binding name="UslugiUBDSoap">
          <textMessageEncoding messageVersion="Soap12" />
          <httpsTransport />
        </binding>
        <binding name="UslugiUBDSoap1">
          <textMessageEncoding messageVersion="Soap12" />
          <httpsTransport />
        </binding>
      </customBinding>
    </bindings>
    <client>
      <endpoint address="https://ubd.mf.gov.pl/uslugi/dokumenty"
        binding="customBinding" bindingConfiguration="UslugiUBDSoap"
        contract="UBD.UslugiUBD" name="UslugiUBDPort" />
      <endpoint address="https://ubd.mf.gov.pl/uslugi/dokumenty"
        binding="basicHttpBinding" bindingConfiguration="UslugiUBDSoap11"
        contract="UBD.UslugiUBD" name="UslugiUBD11Port" />
      <endpoint address="https://test-ubd.mf.gov.pl/uslugi/dokumenty"
        binding="customBinding" bindingConfiguration="UslugiUBDSoap1"
        contract="UBDTest.UslugiUBD" name="UslugiUBDPortTest" />
      <endpoint address="https://test-ubd.mf.gov.pl/uslugi/dokumenty"
        binding="basicHttpBinding" bindingConfiguration="UslugiUBDSoap112"
        contract="UBDTest.UslugiUBD" name="UslugiUBD11Port1" />
    </client>
  </system.serviceModel>
  <vidokConfigurations>
    <template_path>DOK_WZORCE\</template_path>
    <doc_path>DOK_WYSLANE\</doc_path>
    <certificate_name></certificate_name>
    <jvm32path>c:\Program Files (x86)\Java\jre1.8.0_25\bin\client\jvm.dll</jvm32path>
    <jvm64path></jvm64path>
    <settings32>sdk_wrapper\settings32.xml</settings32>
    <settings64></settings64>
    <workDir></workDir>
    <RodzajBramki>Edeklaracje</RodzajBramki>
    <Sig_exe></Sig_exe>
  </vidokConfigurations>
</configuration>

Opis

Odwołania do linii w pliku USWS.dll.config:

27. <endpoint address="https://ubd.mf.gov.pl/uslugi/dokumenty" - wpisujemy adres URL bramki produkcyjnej,

30. <endpoint address="https://test-ubd.mf.gov.pl/uslugi/dokumenty" - adres URL bramki testowej,

42. <template_path>DOK_Wzorce\</template_path> - wskazuje nazwę folderu w którym znajdują się wzorce,

43. <doc_path>DOK_Wyslane\</doc_path> - wskazuje lokalizację w której mają być zapisywane wysłane PIT-y,

44. <certificate_name>EDeklaracje</certificate_name> - przyjazna nazwa zainstalowanego certyfikatu do podpisu cyfrowego,

45. <jvm32path> - wskazuje lokalizację do biblioteki jvm.dll wirtualnej maszyny Javy (domyślna lokalizacji Javy). Ścieżka podawana explicite wtedy i tylko wtedy, gdy program sam nie znajdzie zainstalowanego środowiska Java,

46. <jvm64path> - nieużywana,

47. <settings32> - wskazuje lokalizacje pliku z ustawieniami do modułu podpisującego,

48. <settings64> - nieużywana,

49. <workDir> - lokalizacja, gdzie moduł podpisujący zapisuje pliki,

50. <RodzajBramki> - wskazuje na typ serwera z jakim program ma się komunikować przy wysyłce deklaracji pojedynczych. Można podawać dwie wartości: Edeklaracje lub UBD.

51. <Sig_exe> - określa lokalizację programu podpisującego. Ścieżka bezwzględna podawana tylko w sytuacji, kiedy program podpisujący nie znajduje się w katalogu programu.

Uwaga!

• Brak którejkolwiek zmiennej, bądź brak folderu wskazanego w zmiennej spowoduje zgłoszenie wyjątku przez bibliotekę,
• Kolejność w sekcji <vidokConfigurations> ma znaczenie.

settings32.xml

<HardwareProvider>
<Name>PKCS#11 Type A</Name>
<!-- 32bit environment -->
<URI>file:///C:/info-sys_groszek/place/sdk_wrapper_181121/lib/cmP11.dll</URI>
</HardwareProvider>

settings64.xml

<!-- PKCS11 KIR / Sigillum  -->
<HardwareProvider>
<Name>PKCS#11 Type A</Name>
<!-- 64bit environment -->
<URI>file:///P:/PLACEWIN/sdk_wrapper64/lib/CCP11s.dll</URI>
</HardwareProvider>

Lokalna, a serwerowa

Jeśli program rodzic jest zainstalowany na serwerze i jest uruchamiany z klienckich stacji roboczych, to zalecamy, aby katalog sdk_wrapper umieszczony był lokalnie. Domyślnie przyjmujemy ścieżkę: C:\infosys-dok\sdk_wrapper\.

Zalecamy także umieszczenie folderu PIT_WYSLANE w katalogu C:\infosys_dok\. W celu korzystania przez program z w/w ścieżki, zmieniamy w sekcji <doc_path> pliku USWS.dll.config ścieżkę bezwzględną, np. <doc_path> C:\infosys_pity\DOK_WYSLANE\ </doc_path>. Dzięki temu dokumenty będą przechowywane lokalnie.