wiki.groszek.pl

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

← poprzednia edycja
Nie podano opisu zmian
 
(Nie pokazano 37 wersji utworzonych przez 2 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]].
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.'''
==Instalacja==
#Instalujemy aplikację Kadry i Płace w najnowszej dostępnej wersji.
#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.
Zmiany wprowadzone względem wersji wymagającej dogrywania ''pl_podpis.zip'' (wersje od 2019.0.3.11.101 i wyższe):
*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====
<syntaxhighlight lang="xml" line="1">
<?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>
<sign_timeout>60000</sign_timeout>
<PauseGain>4000</PauseGain>
</vidokConfigurations>
</configuration>
</syntaxhighlight>
====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.
: '''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}}
* Brak którejkolwiek zmiennej, bądź brak folderu wskazanego w zmiennej spowoduje zgłoszenie wyjątku przez bibliotekę,
* Kolejność w sekcji ''<vidokConfigurations>'' ma znaczenie.


Przyszłe funkcjonalności biblioteki (stan na {{CURRENTYEAR}}-{{CURRENTMONTH}}-{{CURRENTDAY}}):
===settings32.xml===
* Komunikacja z platformą [http://epuap.gov.pl/ ePUAP],
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
* Repozytorium dokumentów.
 
<syntaxhighlight lang="xml" highlight="6">
...
<!-- PKCS11 KIR / Sigillum  -->
<HardwareProvider>
<Name>PKCS#11 Type A</Name>
<!-- 32bit environment -->
<URI>sdk_wrapper_181121/lib/CCP11s.dll</URI>
</HardwareProvider>
...
</syntaxhighlight>
 
===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">
<doc_path>C:\infosys_pity\PIT_WYSLANE\</doc_path>
</syntaxhighlight>


{{ViDOKKonfiguracja11|param=deklaracji PIT}}
{{ViDOKKonfiguracja11|param=deklaracji PIT}}
Linia 29: Linia 154:
</gallery>
</gallery>


{{ViDOKKonfiguracja2|list={{ViDOKKonfiguracja2WzorcePIT}}}}
==Możliwe statusy dokumentu UPO==
{| 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.
|}


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


===1===
==Biblioteki==
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.
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


===2===
Dla wersji 32-bitowej:
W przypadku problemów z przygotowaniem deklaracji PIT i ich wysłaniem należy w pliku ''PLACE.INI'' dodać sekcję:
*.NET Framework w wersji 4.8 lub wyższej (wbudowany w Windows 10),
<syntaxhighlight lang="ini">
*Microsoft Visual C++ 2015-2022 Redistributable x86
[LOG]
*Visual C++ 2010 Redistributable x86
ACTLOG=1
*java32bit
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===
Utworzenie pliku ''USWSjava.config'', który wymusi wykorzystanie Javy 32-bitowej:
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.
<syntaxhighlight lang="xml">
 
            <?xml version="1.0" encoding="utf-8" ?>
===4===
            <configuration>
* 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,
              <vidokConfigurations>
* ''Abnormal...'' (rys. 1) rozwiązuje zainstalowanie ''NET.Framework 4'', ewentualnie sprawdzić czy jest plik ''USWS.dll.config'' w katalogu z programem ''Płace'',
                <use64bitJava>false</use64bitJava>
* 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'',
              </vidokConfigurations>
* Środowisko Java jest poprawnie wykrywane, ale zwraca ''Abnormal...'' (rys. 3). Sprawdzamy czy nie brakuje katalogu ''lib'' w ''sdk_wrapper'' w katalogu programu ''Płace''.
            </configuration>
* 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>
Plik:vidok_sig_konsola_abnormal.png|Rysunek 1. viDOK_Sig.exe Abnormal program termination
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>
 
===5===
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.
 
===6 Zmiana algorytmu szyfrującego z SHA-1 na SHA256===
 
Aby dokonać zmiany należy w pliku settings32.xml odkomentować sekcje zgodnie z poniższym:
<syntaxhighlight lang="ini">
...
</CryptoProviders>
<Algorithms>
            <CanonicalizationAlgorithm>http://www.w3.org/TR/2001/REC-xml-c14n-20010315</CanonicalizationAlgorithm>
            <DigestAlgorithm>SHA256</DigestAlgorithm>
</Algorithms>
…
</syntaxhighlight>
</syntaxhighlight>


Źródło: „https://wiki.groszek.pl/index.php/Płace_konfiguracja_PIT”