Korekty, realizacja, scalanie i konwersja

Zanim zaczniesz szukać przycisków. Korekta, realizacja, scalanie i zamknięcie reszty nie mają na dziś interfejsu — są dostępne wyłącznie przez API. W panelu klikalne są: edycja, zatwierdzenie, akceptacja i odrzucenie, powielenie, wydruk, praca na pozycjach oraz dwie ikony w pasku dokumentu — Utwórz zamówienie i Kopiuj jako inny typ dokumentu. Reguły opisane niżej obowiązują tak samo — po prostu wywołuje je integracja albo automatyzacja, nie człowiek z myszką.

Krok po kroku

Każda operacja w panelu zaczyna się tak samo: otwórz Dokumenty, kliknij wiersz dokumentu — panel przełączy się na zakładkę Szczegóły dokumentu, a nad dokumentem pojawi się pasek ikon. Ikony bez napisów; nazwę zobaczysz w dymku po najechaniu.

Powielenie

1. Otwórz dokument i kliknij ikonę kopii (dymek: Powiel). Ikony nie ma, gdy typ nie pozwala na powielanie albo brakuje ci uprawnienia.
2. Odczytaj komunikat Powielono → # z numerem wewnętrznym nowego dokumentu roboczego.
3. Wróć na zakładkę Dokumenty i otwórz ten dokument, żeby uzupełnić pozycje i zatwierdzić.

To samo da się zrobić bez otwierania dokumentu: w menu ⋮ na końcu wiersza jest pozycja Powiel, a przy zaznaczeniu kilku wierszy — Powiel zaznaczone.

Konwersja na inny typ

1. Otwórz dokument i kliknij ikonę z dymkiem Kopiuj jako inny typ dokumentu.
2. W polu Szukaj... wpisz kod albo nazwę typu docelowego. Lista pokazuje wyłącznie typy aktywne.
3. Kliknij typ na liście (albo naciśnij Enter, żeby wziąć pierwszy z brzegu).
4. Poczekaj na komunikat Dokument skonwertowany — panel otworzy nowy dokument.

Utworzenie zamówienia

1. Upewnij się, że dokument ma przypisanego klienta i przynajmniej jedną pozycję z ilością > 0.
2. Otwórz dokument i kliknij ikonę koszyka (dymek: Utwórz zamówienie).
3. Odczytaj komunikat Zamówienie utworzone z numerem — panel przenosi cię na listę zamówień, wprost na to zamówienie.

Korekta i realizacja — przez API

1. Otwórz Ustawienia → Dokumenty → Typy dokumentów, wejdź w typ źródłowy i w panelu Operacje sprawdź, że Korekty (odpowiednio Realizacja) są włączone, a pole Kod typu korekty (Kod typu realizacji) zawiera kod typu, który w tej firmie istnieje — np. KFS.
2. Sprawdź status dokumentu źródłowego: korekta wymaga Zatwierdzony, Zrealizowany albo Wysłany, realizacja — Zatwierdzony albo W realizacji.
3. Wywołaj POST /api/documents/list/<id>/correct/ albo POST /api/documents/list/<id>/realize/. Puste ciało żądania oznacza operację pełną.
4. Dla operacji częściowej podaj w ciele listę pozycji: {"lines": [{"line_id": 12, "quantity": 5}]}. Ilość jest opcjonalna — bez niej bierze się całą ilość z pozycji.
5. Wróć do dokumentu źródłowego w panelu i rozwiń sekcję Powiązania (kliknij Kliknij aby załadować) — powstały dokument jest tam widoczny.

Scalanie wywołuje się przez POST /api/documents/list/merge/ z listą document_ids, a zamknięcie reszty — przez POST /api/documents/list/<id>/close-remaining/.

Korekta

Wymaga, żeby typ na to pozwalał i miał wskazany typ korekty. Dokument źródłowy musi być Zatwierdzony, Zrealizowany albo Wysłany.

Gotowe pary: FS→KFS, FZ→KFZ (zaliczkowa), PAR→KPAR, FZK→KFZK (zakupu), WZ→KWZ, PZ→KPZ.

Uwaga: FZ to Faktura Zaliczkowa, a faktura zakupu ma kod FZK. Dwa różne dokumenty o myląco podobnych kodach.

• Pełna — kopiuje wszystkie pozycje z odwróconym znakiem ilości i przestawia źródło na Skorygowany.
• Częściowa — obejmuje tylko wskazane pozycje i nie zmienia statusu źródła.
• Do jednego dokumentu może istnieć tylko jedna aktywna korekta pełna: Dokument już posiada pełną korektę.
• Typ bez korekt: Korekta nie jest dozwolona dla tego typu dokumentu.

Realizacja

Zamienia dokument zlecający na wykonawczy. Gotowe łańcuchy: ZS→WZ, ZZ→PZ, PRO→FS, OF→ZS.

Źródło musi być Zatwierdzony albo W realizacji. Realizacja może być pełna albo częściowa, jeśli typ na to pozwala. System pilnuje, żeby nie zrealizować więcej niż zostało — z uwzględnieniem tolerancji ustawionej na typie.

Odmowy mówią wprost: typ nie może być realizowany, typ nie pozwala na częściową realizację, albo nie ma pozycji do zrealizowania.

Zamknięcie reszty

Gdy realizacja była częściowa, a reszta nie przyjdzie — można zamknąć pozostałą ilość. Działa tylko dla dokumentów częściowo zrealizowanych i potwierdzonych; komunikaty odmowy podają aktualny status realizacji i status dokumentu.

Scalanie

Łączy kilka dokumentów w jeden dokument typu docelowego. Warunki — wszystkie naraz:

• co najmniej dwa dokumenty,
• ten sam typ,
• ten sam kontrahent,
• ta sama waluta,
• ta sama firma,
• status Zatwierdzony albo Zrealizowany,
• typ z włączonym scalaniem i wskazanym typem docelowym.

Pozycje są przepisywane bez grupowania. Dokumenty źródłowe nie są anulowane ani zmieniane.

Powielanie

Powiel tworzy nowy dokument roboczy tego samego typu. Odmowy: typ nie pozwala na powielanie albo typ jest nieaktywny.

Konwersja

Kopiuj jako inny typ dokumentu przepisuje dokument na inny typ; w notatkach zostaje ślad, z czego powstał. Odmowy: brak wskazanego typu docelowego, typ nieznaleziony, typ z innej firmy, typ nieaktywny.

Utworzenie zamówienia

Utwórz zamówienie zakłada zamówienie z pozycji dokumentu. Wymaga przypisanego klienta i przynajmniej jednej pozycji z ilością > 0. W komentarzu zamówienia zostaje informacja, z jakiego dokumentu powstało.

Odmowy: dokument nie należy do aktywnej firmy, dokument musi mieć przypisanego klienta, dokument nie ma pozycji do skopiowania.

Działa też w drugą stronę: z zamówienia można wystawić dokument wybranego typu.