= [wiki:DeployerGuide Przewodnik wdrożeniowca] > Synchronizacja dokumentów = #dokument

[wiki:DeployerGuide/Customization/Integration Strona główna Integracji][[br]]
[wiki:DeployerGuide/Customization/Integration/Import Strona główna sekcji importu danych]

=== Menu ===
 1. [#wstep Wstęp]
 2. [#dokumenty Dokumenty]
 3. [#pozycje Pozycje (linie) dokumentów]
 4. [#zalaczniki Załączniki]

== Wstęp ==
Synchronizacja dokumentów składa się dwóch elementów:
 * Pobierania nagłówków
 * Pobierania pozycji (linii) dokumentów
 * Pobierania załączników

[#dokument Powrót do menu]

== Nagłówki dokumentów == #dokumenty
System eDokumenty pozwala na synchronizację różnego rodzaju dokumentów, w tym:
 * Faktur (z pozycjami)
 * Dokumentów WZ i PZ
 * Zamówień
 * Pism
 * Umów
 * Emaili (dokumentów typu email - czyli zarchiwizowanej w postaci dokumentu korespondencji email. Nie należy mylić z wiadomościami email w skrzynce pocztowej)
 * Notatek służbowych
 * Inne dokumenty
 * Dokumentów Customowych (poprzez mapowanie cech)

Typy dokumentów zdefiniowane są w bazie eDokumentów w tabeli types_of_documents:
||Typ dokumentu||Oznaczenie||
||Pismo||Paper||
||Faktura VAT||VatNote||
||Umowa||Contract||
||Uchwała||Resolution||
||Notatka służbowa||Note||
||Email||Email||
||inne||Other||
||Płatność||FKPayment||
||Zapotrzebowanie||Demand||
||Zamówienie||OrderDocument||
||Przyjęcie zewnętrzne||PZDocument||
||Wydanie zewnętrzne||WZDocument||
||Oferta||OfferDocument||
||Dokument Customowy||CustomDocument||

Przy wykorzystaniu mapowania dokumentu należy pamiętać o zachowaniu wielkości znaków, czyli pisać VatNote zamiast vatnote lub VATNOTE.

Konfiguracja pobierania dla każdego typu dokumentu jest taka sama. jedyną różnicą są pola wystawiane dla każdego typu dokumentu.
Cechą wspólną wszystkich są kolumny, które muszą być wystawione w widoku.

=== Widoki ===
Do pobierania nagłówków dokumentów należy utworzyć perspektywy:
 * '''bs_documents_view'''
 * '''bs_modified_documents_view'''

Przykładowy widok bs_documents_view może mieć postać (w zależności od typu dokumentu, który podlega importu).

[[Image(doc_001.png)]][[BR]]''Rys. 1. Przykład widoku dokumentów''[[BR]]

Wymagane kolumny w widoku:
W definicji widoku zaleca się następujących kolumn (pogrubione kolumny są wymagane):
||Kolumna||Typ danych||Ograniczenia||Opis||Wymagalność||
||'''bs_document_id'''||bigint||PRIMARY KEY (UNIQUE, NOT NULL)||Kolumna z identyfikatorem numerycznym typu całkowitego. ||Kolumna wymagana.'''Nazwa kolumny nie może być zmieniona'''||
||'''bs_contact_id'''||bigint||NOT NULL||Identyfikator kontrahenta, którego dotyczy dokument||Kolumna wymagana||
||'''number'''||varchar(n)||NOT NULL (UNIQUE)||Skrót nazwy kontrahenta||Opcjonalna, służyć może jako kolumna szablonowa do porównań istnienia kontrahentów||
||dctype||varchar(n)||NOT NULL ||Typ dokumentu np. FVS, FZ||||
||state_||smallint||NOT NULL|| Rodzaj dokumentu (1 - przychodzacy, 2 - wychodzacy, 3 - wewnętrzny). Może być zastąpiony w mapie dokumentów. ||