wiki.groszek.pl

Płace konfiguracja PIT: Różnice pomiędzy wersjami

← poprzednia edycja
Michalp (dyskusja | edycje)
restricted
6814 edycji
 
(Nie pokazano 49 wersji utworzonych przez 3 użytkowników)
Linia 1: Linia 1:
{{Uwaga}}
:Kliknij na łącze w celu uzyskania szczegółowych informacji [[Płace wysyłka e-Deklaracji|o sposobie wysyłki e-Deklaracji]].
{{ViDOKKonfiguracja11}}
===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''.
<gallery>
Plik:place_wycinek_wzorzec_deklaracji_1.png |Rysunek 1. Parametry wzorca deklaracji
</gallery>
==Konfiguracja==
W programie ''Kadry i Płace'' funkcjonalność elektronicznej wysyłki deklaracji PIT realizowana jest przez bibliotekę ''ViDok'', która służy do:
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 [[:Category:Kadry i Płace|Kadry i Płace]] do [http://www.mf.gov.pl/ Ministerstwa Finansów],
* Wysyłania dokumentów przez program [[:Kategoria:Kadry i Płace|Kadry i Płace]] do [http://www.mf.gov.pl/ Ministerstwa Finansów],
* Składania podpisu cyfrowego na dokumentach.
* Składania podpisu cyfrowego na dokumentach.
{{Uwaga}}
{{Uwaga}}
:Od 2014-11-12 zastępuje program eWydruki.
: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.'''


Przyszłe funkcjonalności biblioteki (stan na {{CURRENTYEAR}}-{{CURRENTMONTH}}-{{CURRENTDAY}}):
==Instalacja==
* Komunikacja z platformą [http://epuap.gov.pl/ ePUAP],
#Instalujemy aplikację Kadry i Płace w najnowszej dostępnej wersji.
* Repozytorium dokumentów.
#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).
#Instalujemy najnowszą wersję oprogramowania JAVA w wersji 32-bitowej.


===Elementy biblioteki ViDok===
Zmiany wprowadzone względem wersji wymagającej dogrywania ''pl_podpis.zip'' (wersje od 2019.0.3.11.101 i wyższe):
* ''CertificateTools.dll'' - biblioteka udostępniająca narzędzia do podpisywania cyfrowego,
*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.
* ''CPlusPlusToCSharp.dll'' - biblioteka integracyjna,
*W pliku ''settings32.xml'' ustawiamy domyślnie zostały ścieżki względne do bibliotek DLL dla podpisów.
* ''USWS.dll'' - biblioteka udostępniająca narzędzia do wysyłki dokumentów do Ministerstwa Finansó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.  
* ''USWS.dll.config'' - plik konfiguracyjny dla biblioteki ''ViDok'',
*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.
* ''viDOK_Sig.exe'' - program, który podpisuje deklaracje,
*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.
* Wzorce deklaracji, których nie edytujemy. Ich obecność jest niezbędna do przygotowania PIT-u. 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===
==Konfiguracja==
# Instalujemy [http://www.microsoft.com/en-us/download/details.aspx?id=5555 Microsoft Visual C++ 2010 Redistributable Package (x86)] w wersji 32-bitowej (uzasadnienie w [[Płace FAQ]]),
===USWS.dll.config===
# Dostosowujemy pliku konfiguracyjny ''USWS.dll.config'' według opisu z poniższego paragrafu,
''USWS.dll.config'' jest plikiem konfiguracyjnym biblioteki ViDOK. To w nim ustawiamy najważniejsze parametry wysyłki i podpisu PIT.
# Tworzymy katalogi do:
## Przechowywania wzorców deklaracji. Domyślnie jest to katalog ''\PIT_Wzorce\'' w głównym katalogu programu ''Kadry i Płace'',
## Przechowywania wysłanych deklaracji. Domyślnie jest to katalog ''C:\infosys-pity\PIT_Wyslane\'' w głównym katalogu programu ''Kadry i Płace''.
# Kopiujemy:
## Do katalogu programu ''Kadry i Płace'':
### Pliki:
#### ''CertificateTools.dll'',
#### ''CPlusPlusToCSharp.dll'',
#### ''USWS.dll'',
#### ''USWS.dll.config'',
#### ''viDOK_Sig.exe''.
## Na klienckich stacjach roboczych tworzymy katalog ''infosys-pity'' w lokalizacji ''C:\''. Do nowo utworzonego katalogu kopiujemy z całą zwartością:
### ''sdk_wrapper''.
## Pliki wzorców do katalogu utworzonego w pkt. 3.1.
# 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:
## Uruchamiamy narzędzie ''Certyfikaty'' poprzez wydanie polecenia ''certcertmgr.msc'' w oknie ''Uruchom'' (menu START'' > ''Uruchom'' lub naciskamy kombinację przycisków ''WIN + R''),
## W nowotwartym oknie przechodzimy do gałęzi ''Certyfikaty – bieżący użytkownik'' > ''Osobisty'' > ''Certyfikaty'',
## Z listy zainstalowanych certyfikatów wybrać jeden, który ma zostać wyróżniony przyjazną nazwą,
## Z podręcznego menu (dostępnego po kliknięciu ppm) wybieramy opcję ''Właściwości'',
## 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!),
## 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ę.
# 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.
## ''\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).
# Instalujemy oprogramowanie [https://www.java.com/pl/download/ Java w wersji 7 lub wyżej],
# Uruchamiamy program ''Kadry i Płace''.


====USWS.dll.config====
====Struktura====
 
=====Struktura=====
<syntaxhighlight lang="xml" line="1">
<syntaxhighlight lang="xml" line="1">
<?xml version="1.0" encoding="utf-8" ?>
<?xml version="1.0" encoding="utf-8" ?>
<configuration>
<configuration>
  <system.serviceModel>
<system.serviceModel>
    <bindings>
<bindings>
      <basicHttpBinding>
<basicHttpBinding>
        <binding name="UslugiUBDSoap11">
<binding name="UslugiUBDSoap11">
          <security mode="Transport" />
<security mode="Transport" />
        </binding>
</binding>
        <binding name="UslugiUBDSoap111" />
<binding name="UslugiUBDSoap111" />
        <binding name="UslugiUBDSoap112">
<binding name="UslugiUBDSoap112">
          <security mode="Transport" />
<security mode="Transport" />
        </binding>
</binding>
        <binding name="UslugiUBDSoap113" />
<binding name="UslugiUBDSoap113" />
      </basicHttpBinding>
</basicHttpBinding>
      <customBinding>
<customBinding>
        <binding name="UslugiUBDSoap">
<binding name="UslugiUBDSoap">
          <textMessageEncoding messageVersion="Soap12" />
<textMessageEncoding messageVersion="Soap12" />
          <httpsTransport />
<httpsTransport />
        </binding>
</binding>
        <binding name="UslugiUBDSoap1">
<binding name="UslugiUBDSoap1">
          <textMessageEncoding messageVersion="Soap12" />
<textMessageEncoding messageVersion="Soap12" />
          <httpsTransport />
<httpsTransport />
        </binding>
</binding>
      </customBinding>
</customBinding>
    </bindings>
<wsHttpBinding>
    <client>
<binding name="e3">
      <endpoint address="https://ubd.mf.gov.pl/uslugi/dokumenty"
<security mode="Transport">
        binding="customBinding" bindingConfiguration="UslugiUBDSoap"
<transport clientCredentialType="None" />
        contract="UBD.UslugiUBD" name="UslugiUBDPort" />
</security>
      <endpoint address="https://ubd.mf.gov.pl/uslugi/dokumenty"
</binding>
        binding="basicHttpBinding" bindingConfiguration="UslugiUBDSoap11"
</wsHttpBinding>
        contract="UBD.UslugiUBD" name="UslugiUBD11Port" />
</bindings>
      <endpoint address="https://test-ubd.mf.gov.pl/uslugi/dokumenty"
<client>
        binding="customBinding" bindingConfiguration="UslugiUBDSoap1"
<endpoint address="https://ubd.mf.gov.pl/uslugi/dokumenty"
        contract="UBDTest.UslugiUBD" name="UslugiUBDPortTest" />
binding="customBinding" bindingConfiguration="UslugiUBDSoap"
      <endpoint address="https://test-ubd.mf.gov.pl/uslugi/dokumenty"
contract="UBD.UslugiUBD" name="UslugiUBDPort" />
        binding="basicHttpBinding" bindingConfiguration="UslugiUBDSoap112"
<endpoint address="https://ubd.mf.gov.pl/uslugi/dokumenty"
        contract="UBDTest.UslugiUBD" name="UslugiUBD11Port1" />
binding="basicHttpBinding" bindingConfiguration="UslugiUBDSoap11"
    </client>
contract="UBD.UslugiUBD" name="UslugiUBD11Port" />
  </system.serviceModel>
<endpoint address="https://test-ubd.mf.gov.pl/uslugi/dokumenty"
  <vidokConfigurations>
binding="customBinding" bindingConfiguration="UslugiUBDSoap1"
    <template_path>PIT_WZORCE\</template_path>
contract="UBDTest.UslugiUBD" name="UslugiUBDPortTest" />
    <doc_path>PIT_WYSLANE\</doc_path>
<endpoint address="https://test-ubd.mf.gov.pl/uslugi/dokumenty"
    <certificate_name></certificate_name>
binding="basicHttpBinding" bindingConfiguration="UslugiUBDSoap112"
    <jvm32path>c:\Program Files (x86)\Java\jre1.8.0_25\bin\client\jvm.dll</jvm32path>
contract="UBDTest.UslugiUBD" name="UslugiUBD11Port1" />
    <jvm64path></jvm64path>
<endpoint address="https://Wyszukiwarkaregontest.stat.gov.pl/wsBIR/UslugaBIRzewnPubl.svc"
    <settings32>sdk_wrapper\settings32.xml</settings32>
binding="wsHttpBinding" bindingConfiguration="e3" contract="TestBIR_REGON_WS.IUslugaBIRzewnPubl"
    <settings64></settings64>
name="e3" />
    <workDir></workDir>
</client>
    <RodzajBramki>Edeklaracje</RodzajBramki>
</system.serviceModel>
    <Sig_exe></Sig_exe>
<vidokConfigurations>
  </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>
<sign_timeout>60000</sign_timeout>
<PauseGain>4000</PauseGain>
</vidokConfigurations>
</configuration>
</configuration>
</syntaxhighlight>
</syntaxhighlight>


=====Opis=====
====Opis====
Odwołania do linii w pliku ''USWS.dll.config'':
Odwołania do linii w pliku ''USWS.dll.config'':
: '''27. <endpoint address="https://ubd.mf.gov.pl/uslugi/dokumenty"''' - wpisujemy adres URL '''bramki produkcyjnej''',
: '''34. <endpoint address="https://ubd.mf.gov.pl/uslugi/dokumenty"''' - adres URL '''bramki produkcyjnej''',
: '''30. <endpoint address="https://test-ubd.mf.gov.pl/uslugi/dokumenty"''' - adres URL '''bramki testowej''',
: '''40. <endpoint address="https://test-ubd.mf.gov.pl/uslugi/dokumenty"''' - adres URL '''bramki testowej''',
: '''42. <template_path>'''PIT_Wzorce\'''</template_path>''' - wskazuje nazwę folderu w którym znajdują się wzorce,
: '''52. <template_path>'''PIT_WZORCE\'''</template_path>''' - wskazuje ścieżkę względną do folderu w którym znajdują się wzorce,
: '''43. <doc_path>'''PIT_Wyslane\'''</doc_path>''' - wskazuje lokalizację w której mają być zapisywane wysłane PIT-y,
: '''53. <doc_path>'''C:\infosys_pity\PIT_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,
: '''54. <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,
: '''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,
: '''46. <jvm64path>''' - nieużywana,
: '''56. <jvm64path>''' - nieużywana,
: '''47. <settings32>''' - wskazuje lokalizacje pliku z ustawieniami do modułu podpisującego,
: '''57. <settings32>''' - wskazuje lokalizacje pliku z ustawieniami do modułu podpisującego,
: '''48. <settings64>''' - nieużywana,
: '''58. <settings64>''' - nieużywana,
: '''49. <workDir>''' - lokalizacja, gdzie moduł podpisujący zapisuje pliki,
: '''59. <workDir>''' - lokalizacja, w której 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: ''Edeklaracja'' lub ''UBD''.
: '''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''.
: '''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 ''Kadry i Płace''.
: '''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.
: '''62. <sign_timeout>''' - określany w milisekundach (1000 = 1 sekunda), używany w przypadku kiedy występują problemy z automatycznym zamknięciem aplikacji podpisującej.
: '''63. <PauseGain>''' - określany w milisekundach (1000 = 1 sekunda), używany w przypadku kiedy występują problemy z otwieraniem wygenerowanych PDF w aplikacji Podatki (plik zostaje usunięty zanim zdąży zostać otworzony).


{{Uwaga}}
{{Uwaga}}
Linia 169: Linia 113:
* Kolejność w sekcji ''<vidokConfigurations>'' ma znaczenie.
* Kolejność w sekcji ''<vidokConfigurations>'' ma znaczenie.


====settings32.xml====
===settings32.xml===
<syntaxhighlight lang="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
 
<syntaxhighlight lang="xml" highlight="6">
...
<!-- PKCS11 KIR / Sigillum  -->
<!-- PKCS11 KIR / Sigillum  -->
<HardwareProvider>
<HardwareProvider>
<Name>PKCS#11 Type A</Name>
<Name>PKCS#11 Type A</Name>
<!-- 32bit environment -->
<!-- 32bit environment -->
<URI>file:///P:/PLACEWIN/sdk_wrapper/lib/CCP11s.dll</URI>
<URI>sdk_wrapper_181121/lib/CCP11s.dll</URI>
</HardwareProvider>
</HardwareProvider>
...
</syntaxhighlight>
</syntaxhighlight>


====settings64.xml====
===Certyfikat===
 
===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>''.
<syntaxhighlight lang="xml">
<syntaxhighlight lang="xml">
<!-- PKCS11 KIR / Sigillum  -->
<doc_path>C:\infosys_pity\PIT_WYSLANE\</doc_path>
<HardwareProvider>
<Name>PKCS#11 Type A</Name>
<!-- 64bit environment -->
<URI>file:///P:/PLACEWIN/sdk_wrapper64/lib/CCP11s.dll</URI>
</HardwareProvider>
</syntaxhighlight>
</syntaxhighlight>


====Lokalna, a serwerowa====
{{ViDOKKonfiguracja11|param=deklaracji PIT}}
Jeśli program ''Kadry i Płace'' 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-pity\sdk_wrapper\''.


Zalecamy także umieszczenie folderu ''PIT_WYSLANE'' w katalogu ''C:\infosys-pity\''. 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\PIT_WYSLANE\'' '''</doc_path>'''. Dzięki temu PIT-y będą przechowywane lokalnie.
===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.


==Problemy z przygotowaniem deklaracji==
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).


===1===
===Wybieranie osób do przygotowania deklaracji===
Niektóre wersje środowiska Java/systemu operacyjnego nie pozwalają na wykorzystywanie ścieżek, zawierających znaki kropki, myślnika lub spacji. Należy wówczas utworzyć katalog ''PIT_WYSLANE'' np. w głównym katalogu dysku, i odpowiednio zmienić ścieżki do niego w plikach konfiguracyjnych.
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).


===2===
{{Uwaga}}
W przypadku problemów z przygotowaniem deklaracji PIT i ich wysłaniem należy w pliku ''PLACE.INI'' dodać sekcję:
* 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''.
<syntaxhighlight lang="ini">
[LOG]
ACTLOG=1
SAVESQL=1
</syntaxhighlight>
Uruchomić ponownie program i powtórzyć próbę nieudanej wysyłki. Program utworzy plik ''ACTLOG.TXT'' ze szczegółowym zapisem wykonywanych akcji.
W celu uzyskania pomocy w wyjaśnieniu problemów należy przesłać do analizy pliki:
#Z katalogu programu płacowego:
##''ACTLOG.TXT'',
##''ERRORS_LOG.XML'',
##''SignatureResult.XML''.
#Z katalogu ''PIT_WYSLANE'':
##''viDokLog.txt''.
 
===3===
Jeśli moduł do podpisu cyfrowego (sekcja ''Podpisywanie PIT-ów'') nie wykrywa podpisu cyfrowego, to należy upewnić się, że w plikach ''settings32.xml'' i ''settings64.xml'' są wpisane poprawne ścieżki w parametrze '''<URI>''' do właściwej biblioteki odpowiedniej dla danego podpisu.


===4===
* Jeśli uruchomienie ''viDOK_sig.exe'' z katalogu programu ''Kadry i Płace'' miga i znika, należy uruchomić ''viDOK_sig.exe'' z konsoli CMD (menu START > ''Uruchom'' > ''cmd'' lub nacisnąć kombinację przycisków ''WIN'' + ''R''), przejść do katalogu z programem ''Płace'' i uruchomić), komunikaty zostaną wyświetlone w oknie konsoli przez co widzimy jakie informacje zwraca program,
* ''Abnormal...'' (rys. 1) rozwiązuje zainstalowanie ''NET.Framework 4'', ewentualnie sprawdzić czy jest plik ''USWS.dll.config'' w katalogu z programem ''Płace'',
* Po podpisaniu PIT-u i kliknięciu przycisku ''Zakończ'' zgłaszany jest błąd ''Błąd przygotowania deklaracji PIT-4R (5)...'' (rys. 2). Wgrywamy najnowszą wersję programu ''Płace'' z zakładki ''Program w wersji Beta'' dostępnej na stronie groszek.pl. Gdyby nie zadziałało, instalujemy ''.NET Framework 4'',
* Środowisko Java jest poprawnie wykrywane, ale zwraca ''Abnormal...'' (rys. 3). Sprawdzamy czy nie brakuje katalogu ''lib'' w ''sdk_wrapper'' w katalogu programu ''Płace''.
* Jeśli po kliknięciu przycisku ''Wyślij e-deklaracje'' program zgłasza błąd ''(901) List index out of bounds (9)'', należy w pliku ''USWS.dll.config'' dodać konfigurację wprowadzoną w wersji ''150119.zip'', tj. pomiędzy '''</workDir>''', a '''</vidokConfigurations>''' należy wstawić '''<RodzajBramki>'''Edeklaracje'''</RodzajBramki><Sig_exe></Sig_exe>'''. W przypadku wątpliwości proszę sprawdzić oryginalny ''USWS.dll.config'' z wersji ''150119.zip'' lub wyższej,
* Jeśli program ''Płace'' nie wykrywa PIT-ów przy wysyłce (rys. 4) mimo iż wzorce są w katalogu programu jak i w katalogu ''PIT_WZORCE'', należy spróbować uruchomić program bezpośrednio z pliku ''placewin.exe''. Jeśli pomoże, należy wyciągnąć nowy skrót do programu ''Płace'' (prawdopodobnie przyczyną jest brak we właściwościach skrótu ścieżki ''Rozpocznij w...'' wskazującej na katalog z programem).
<gallery>
<gallery>
Plik:vidok_sig_konsola_abnormal.png|Rysunek 1. viDOK_Sig.exe Abnormal program termination
Plik:place_wycinek_wzorzec_deklaracji_1.png |Rysunek 1. Parametry wzorca deklaracji
Plik:place_komunikat_podpisanie_pitu.png|Rysunek 2. Błąd przygotowania deklaracji PIT-4R (5)...
Plik:place_konsola_java.png|Rysunek 3. Java Abnormal program termination
Plik:brakwzorcow.png|Rysunek 4. Brak wzorców
</gallery>
</gallery>


===5===
==Możliwe statusy dokumentu UPO==
W przypadku problemów z wysyłką deklaracji PIT do serwerów ministerstwa, upewniamy się, czy porty TCP ''80'', ''443'' i ''8080'' nie są blokowane.
{| class="wikitable"
|- style="font-weight:bold;"
! Status
! Opis
|-
| 100-199
| Grupa komunikatów dla dokumentów, które nie nadają się do przetworzenia (wadliwy komunikat SOAP) lub nastąpił krytyczny błąd serwera.
|-
| 200-299
| Grupa komunikatów dla dokumentów poprawnych lub uwzględniających dodatkową interakcję.
|-
| 300-399
| Grupa komunikatów dla dokumentów w trakcie przetwarzania.
|-
| 400-499
| Grupa komunikatów dla dokumentów niepoprawnych ze względu na błędy strukturalne syntaktyki; kolejne statusy wskazują na powód odrzucenia dokumentu.
|}
 
Aktualnie usługa zwraca następujące statusy:
*100 - Błędny komunikat SOAP
*102 – Proszę o ponowne przesłanie żądania UPO
*200 - Przetwarzanie dokumentu zakończone poprawnie, pobierz UPO
*200 - Przesłałeś duplikat, pobrane UPO dotyczy oryginału dokumentu. Przetwarzanie dokumentu zakończone poprawnie, pobierz UPO
*300 - Brak dokumentu
*301 - Dokument w trakcie przetwarzania, sprawdź wynik następnej weryfikacji dokumentu
*302 – Dokument wstępnie przetworzony, sprawdź wynik następnej weryfikacji dokumentu
*303 – Dokument w trakcie weryfikacji podpisu, sprawdź wynik następnej weryfikacji dokumentu
*306 – Dokument w trakcie weryfikacji podpisu, sprawdź wynik następnej weryfikacji dokumentu
*400 - Przetwarzanie dokumentu zakończone błędem
*401 – Weryfikacja negatywna - dokument niezgodny ze schematem xsd
*402 - Brak aktualnego pełnomocnictwa/upoważnienia do podpisywania deklaracji
*403 - Dokument z niepoprawnym podpisem
*404 - Dokument z nieważnym certyfikatem
*405 - Dokument z odwołanym certyfikatem
*406 - Dokument z certyfikatem z nieobsługiwanym dostawcą
*407 - Dokument z certyfikatem z nieprawidłową ścieżką
*408 - Dokument zawiera błędy uniemożliwiające jego przetworzenie
*409 – Dokument zawiera niewłaściwą ilość i/lub rodzaj elementów
*410 – Złożony dokument bez podpisu nie może być korektą
*411 – Weryfikacja negatywna - w systemie jest już złożony dokument z takim identyfikatorem podatkowym
*412 – Weryfikacja negatywna - niezgodność danych autoryzujących z danymi w dokumencie (np. niezgodność NIP, numeru PESEL, daty urodzenia, nazwiska, pierwszego imienia)
*413 – Dokument z certyfikatem bez wymaganych atrybutów
*414 – Weryfikacja negatywna - błąd w danych autoryzujących (np. błąd w nazwisku, pierwszym imieniu, dacie urodzenia, NIP, numerze PESEL, kwocie przychodu)
*415 – Zawartość załącznika niezgodna z deklarowaną listą plików
*416 – Dla tego typu deklaracji załącznik binarny nie jest dozwolony
*417 – Wniosek VAT-REF wymaga przynajmniej jednej z pozycji: VATRefundApplication lub ProRataRateAdjustment
*418 – Dla złożonej deklaracji wymagane jest użycie podpisu kwalifikowanego
*419 – Brak zaznaczenia celu złożenia formularza jako korekty deklaracji (zeznania) lub brak uzasadnienia przyczyny złożenia korekty deklaracji (zeznania)
*420 - Użycie podpisu DaneAutoryzujaceVAP jest dozwolone jedynie dla dokumentu VAP-1
*421 - Dokument VAP-1 można złożyć jedynie z użyciem podpisu DaneAutoryzujaceVAP
*422 – Weryfikacja negatywna - dokument złożony z użyciem danych autoryzujących może złożyć wyłącznie podatnik, będący osobą fizyczną
*423 - Dokument może złożyć wyłącznie podmiot będący osobą fizyczną, niebędący pełnomocnikiem
*424 - Nie podano numeru VAT dostawcy lub numeru faktury, a nie jest to faktura uproszczona
*425 - Kod państwa członkowskiego identyfikacji dostawcy jest niezgodny z kodempaństwa, do którego kierowany jest wniosek
*440 – Paczka/Dokument zbiorczy zawiera deklarację, która została już przesłana
*441 – Przesłany plik przekroczył dopuszczalny rozmiar
*442 – Przesłana paczka znajduje się już w systemie
*443 – Dokument znajduje się już w systemie
*444 – Nie znaleziono płatnika lub podatnika, którego dotyczy zeznanie
*445 – Przesłany plik przekroczył dopuszczalny rozmiar danych po rozpakowaniu
*448 – Błędny plik lub niepoprawna struktura pliku (ZIP)
*452 – Weryfikacja negatywna – nieobsługiwany typ deklaracji
*453 – Weryfikacja negatywna – nieobsługiwany typ deklaracji dla tego kanału
*460 - Nieprawidłowa struktura NIP
*461 - Nieprawidłowa struktura Numeru identyfikacyjnego VAT lub go brak
*462 - Nieprawidłowa struktura Numeru IBAN
*463 - Nieprawidłowa struktura Kodu BIC
*464 - W przypadku wyrejestrowania należy wybrać Cel złożenia równy 2
*465 - W przypadku zmiany państwa członkowskiego identyfikacji konieczne jest podanie jej szczegółów
*466 - Nieprawidłowe podsumowanie kwot
*467 - Kod państwa członkowskiego konsumpcji nie może być taki jak kod państwa stałego miejsca prowadzenia działalności gospodarczej
 
==Biblioteki==
Dla wersji 64-bitowej:
*.NET Framework w wersji 4.8 lub wyższej (wbudowany w Windows 10),
*Microsoft Visual C++ 2015-2022 Redistributable x64
*Microsoft Visual C++ 2015-2022 Redistributable x86
*Visual C++ 2013 Redistributable x64
*java64bit
 
Dla wersji 32-bitowej:
*.NET Framework w wersji 4.8 lub wyższej (wbudowany w Windows 10),
*Microsoft Visual C++ 2015-2022 Redistributable x86
*Visual C++ 2010 Redistributable x86
*java32bit
 
Utworzenie pliku ''USWSjava.config'', który wymusi wykorzystanie Javy 32-bitowej:
<syntaxhighlight lang="xml">
            <?xml version="1.0" encoding="utf-8" ?>
            <configuration>
              <vidokConfigurations>
                <use64bitJava>false</use64bitJava>
              </vidokConfigurations>
            </configuration>
</syntaxhighlight>


[[Category:Kadry i Płace]]
[[Category:Kadry i Płace]]
[[Category:Aneks]]
[[Category:Aneks]]
[[Category:Aneks Publiczny]]
[[Category:Aneks Publiczny]]
Źródło: „https://wiki.groszek.pl/index.php/Płace_konfiguracja_PIT”