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>