Pomoc techniczna: api@saldeosmart.pl

Funkcje SaldeoPULPIT

Monitorowanie katalogu skanów
Podgląd dokumentu z programu księgowego
Synchronizacja danych - dodawanie firmy, kontrahenci, kategorie, rejestry itp.

dodawanie firmy (od 1.5.0)
dodawanie i aktualizowanie kontrahentów (od 1.5.0)
dodawanie i aktualizowanie kategorii (od 1.5.0)
dodawanie i aktualizowanie form płatności (od 1.6.0)
dodawanie i aktualizowanie rejestrów (od 1.6.0)

Pobieranie dokumentów z Saldeo do importu (od 1.6.0)
Przesyłanie zwrotnie do Saldeo numerów księgowych nadanych w programie księgowym (od 1.7.0)

Instalacja SaldeoSYNC

Należy dodać zmienną środowiskową w Windows - SALDEODESKTOP_HOME - na wartość katalogu gdzie zainstalowany jest SaldeoPULPIT (np. c:\Program Files\SaldeoPULPIT
Konfiguracja bibliotek - katalog SaldeoPULPIT/libs

Provider - plik jar dla providera (np. Optima) - link wyspecyfikowany w sekcji dotyczącej konkretnego programu księgowego
Driver JDBC dla bazy danych (np. MSSQL - http://s3-eu-west-1.amazonaws.com/saldeo.pl/drivers/ms-sqljdbc4.jar)

Dodanie plików konfiguracyjnych

Dla SaledoSYNC musimy wskazać zmienną środowiskową SALDEOSYNC_HOME na wartość katalogu gdzie umieścimy pliki

saldeosync-connection.conf
saldeosync-configuration-ID.conf

oraz katalog LIBS

Lokalizacja logów

Logi aplikacji SaldeoPULPIT znajdują się w c:\Users\<user>\AppData\Roaming\SaldeoDesktop

Konfiguracja użytkownika

Użytkownik musi posiadać prawo do uruchamiania modułu SaldeoSYNC - takie prawo posiada administrator (konto główne)

Konfiguracja modułu SaldeoSYNC

Dodanie plików konfiguracyjnych

UWAGA! - pliki konfiguracyjne należy zapisać używając kodowania UTF-8 (bez BOM).

Moduł konfiguruje się poprzez dodanie dwóch plików konfiguracyjnych:

saldeosync-connection.conf - realizowane lokalnie na dysku gdzie zainstalowane jest SaldeoPULPIT
saldeosync-configuration-<id>.conf, gdzie <id> to unikalny identyfikator połączenia, wymagania co do id: małe litery i cyfry, bez spacji(białych znaków) i znaków specjalnych

UWAGA: Ten plik jest tworzony na podstawie danych otrzymanych od klienta wymaganych do połączenia z daną bazą danych; następnie konfiguracja powinna zostać przesłana do BrainSHARE IT - zostaje umieszczona na serwerze i SaldeoPULPIT pobierze ją automatycznie.

UWAGA! - pliki konfiguracyjne należy zapisać używając kodowania UTF-8 (bez BOM). stosując edytor notepad++ należy zwrócić uwagę by był zapisany w formacie UTF-8 (bez BOM), gdyż stosowanie tylko kodowania UTF-8 zawiera ukryte znaczniki kolejności bajtów co powoduje błędy np. Brak możliwości odczytania domyślnego adresu e-mail firmy. Skutkuje to błędem przy zakładaniu (przeniesieniu) firmy do programu SaldeoSMART - brak podanego adresu firmy.

saldeosync-connection.conf

Plik saldeosync-connection.conf może posiadać dwa wpisy:

conf.id=<id> ← wymagany element, gdzie <id> to unikalny identyfikator połączenia i odpowiada <id> w nazwie drugiego pliku
conf.url=<lokalizacja> ← opcjonalny element, jeżeli istnieje w tej lokalizacji będzie znajdował się plik saldeosync-configuration-<id>.conf, w przeciwnym przypadku plik ten będzie poszukiwany na serwerze plików programu SaldeoSMART:

Przykładowe konfiguracje:

conf.id=ID_ALIAS
czyli plik saldeosync-configuration-ID_ALIAS.conf będzie odczytywany z adresu: http://s3-eu-west-1.amazonaws.com/saldeo.pl/connections/saldeosync-configuration-ID_ALIAS.conf
conf.id=asd4387t6
conf.url=file:\\\C:\\Program Files (x86)\\SaldeoPULPIT\\\
czyli plik saldeosync-configuration-asd4387t6.conf będzie odczytywany z lokalizacji:
C:\Program Files (x86)\SaldeoPULPIT\saldeosync-configuration-asd4387t6.conf

W pliku saldeosync-configuration-<id>.conf definiowane są lokalizacje i połączenia baz danych programów księgowych i systemów ERP. Konfiguracja ta jest umieszczana na serwerze i SaldeoPULPIT w czasie uruchomienia pobiera sam konfigurację.

Aby przygotować taką konfigurację, należy określić jej parametry (namiary na bazę danych/katalog z danymi, użytkownika, hasło lub inne potrzebne dane do połączenia)

Przykładowy plik konfiguracyjny można pobrać z poniższego linku:

saldeosync-configuration-example.conf

Parametry (wymagane są pogrubione):

default.company.email=firma@saldeo.pl, domyślny adres email, który będzie użyty w przypadku braku wartości email dla dodawanej firmy

CONNECTION.[N]=<SOURCE>, gdzie N rozpoczyna się od 1 i jest kolejną liczbą naturalną

<SOURCE>.provider=<PROVIDER>, COMARCHOPTIMA, STREAMSOFT_ALA

<SOURCE>.db.driver=com.microsoft.sqlserver.jdbc.SQLServerDriver
<SOURCE>.db.connection.url=jdbc:sqlserver://192.168.1.252:1433;databasename=master
<SOURCE>.db.user=saldeoSync

<SOURCE>.period=1m, 1m=1 minuta, lub 1h=1 godzina, wartość jest dowolna

<SOURCE>.SYNCHRONIZED_CONTRACTORS.times=1, mnożnik dla synchronizacji kontrahentów, wartość 1 oznacza, że za każdym razem z częstotliwością period będzie pobierana lista

<SOURCE>.SYNCHRONIZED_CATEGORIES.times=1, mnożnik, działanie analogiczne jak przy kontrahentach

Wersje baz danych i providerów:

http://s3-eu-west-1.amazonaws.com/saldeo.pl/saldeosync-versions.conf

Lista dostępnych providerów:

http://s3-eu-west-1.amazonaws.com/saldeo.pl/saldeosync-provider.conf

Lista operacji

Ustawienie silnika MSSQL

http://www.microsoft.com/en-us/download/details.aspx?id=22985

Wymaganie: posiadanie SQL Management Studio i prawa administratora w MSSQL oraz do Zarządzanie komputerem:

1. Włączenie nasłuchiwania:

a) Narzędzia Administracyjne → Zarządzanie komputerem → Usługi i aplikacje → SQL Server Configuration Manager → SQL Server Network Configuration → Protocols for OPTIMA → TCP/IP properties → IP Addresses → IPAll → Enabled: Yes, Dynamic Port [], Port: 1433

b) SQL Server Services → Restart service

Powinno być włączone nasłuchiwanie na porcie bazy danych (netstat -an - 1433)

2. Dodanie użytkownika wraz z hasłem lub ustawienie hasła dla domyślnego użytkownika (np. Insert - sa):

Najczęściej systemy posiadają wbudowanego użytkownika, który automatycznie posiada w trybie tylko do odczytu dostęp do wymaganych tabel do poprawnego działania.

UWAGA: Pojawia się czasami pytanie czy należy "wystawić" bazę danych na publiczne IP? - oczywiście taka czynność nie jest wymagana ani wręcz wskazana.

Dostęp do bazy jest tylko i wyłącznie realizowane przez SaldeoPULPIT wewnątrz sieci lokalnej w firmie dla celów synchronizacji danych.

Alternatywa: Alternatywnym sposobem jest dodanie nowego użytkownika dedykowanego do połączenia z SaldeoSYNC.

Jednakże dodanie nowej bazy danych (firmy w Optima, Insert, itd.) wiąże się z ustawieniem (dodaniem) nowego mapowania użytkownika na login w konkretnej bazie, co w przypadku dużej rotacji lub braku dostępu do administracji bazy danych może być uciążliwe. Stąd zaleca się wykorzystanie domyślnego użytkownika.

W przypadku decyzji o dodaniu nowego użytkownika do MSSQL, należy wykonać następujące kroki.

Logujemy się do SQL Server Management Studio

Security → Logins → New login… → SQL Server Authentication

Password i Confirmation password: ...

Provider Comarch Optima

Połączenie za pomocą usera i hasła

Parametry (wymagane są pogrubione)

<OPTIMA>.db.driver=com.microsoft.sqlserver.jdbc.SQLServerDriver
<OPTIMA>.db.connection.url=jdbc:sqlserver://192.168.1.252:1433;databasename=master
<OPTIMA>.db.user=saldeoSync

<OPTIMA>.db.conf=CDN_KNF_Konfig
<OPTIMA>.db.password=saldeoSyncPass

<OPTIMA>.category.synchronizeAll=false lub true - synchronizacja kategorii Ogólnych

W celu importowania kategorii ogólnych z Optimy do SaldeoSMART w pliku konfiguracyjnym należy umieścić wpis:

OPTIMA.category.synchronizeAll=false { true }

Brak tego propertisa oznacza to samo co: OPTIMA.category.synchronizeAll=false

w tym przypadku importujemy tylko kategorie szczegółowe.

Przesyłanie danych paczkami, w przypadku dużej ilości (kilkadziesiąt tysięcy)

paczkowanie dla kontrahentów lub artykułów (domyślnie jest zawsze 5000):

// w taki sposób dla operacji merge artykułów zostały nadpisany fetch size ze 100 na 34
OPTIMA.fetch.size.SYNCHRONIZED_ARTICLES=34
// podobnie dla operacji merge-a kontrahentów
OPTIMA.fetch.size.SYNCHRONIZED_CONTRACTORS=50
// można to nadpisać w taki sposób, wtedy jest to dla wszystkich operacji
OPTIMA.fetch.size=100

-------------------------------------------------------------------------------------

Provider-y:

Lista

-------------------------------------------------------------------------------------

Driver

sqljdbc4.jar (działa DLL z autoryzacją Windows)

ms-sqljdbc4.jar

-------------------------------------------------------------------------------------

Przykładowa konfiguracja DEMO

conf.id=optima-demo

URL:

http://s3-eu-west-1.amazonaws.com/saldeo.pl/connections/saldeosync-configuration-optima-demo.conf

Domyślny użytkownik: CDNGosc, pass: <puste> Od wersji Optimy 2017.xx użytkownik ten jest nieaktywny należy korzystać lub założyć innego według poniższych wytycznych.

Uwaga!!!

Aby poprawnie przenosiły się numery zwrotne użytkownikowi CDNGość należy dodać uprawnienie DATAREADER na bazie w MS SQL dla każdej bazy (firmy).

Dostęp użytkownika do obiektów bazodanowych

Wymagane jest aby użytkownik miał dostęp typu select dla (wersja 1.1.0):

master, aby nawiązać połączenie
CDN_KNF_Konfiguracja.CDN.KonfigCDN
CDN_KNF_Konfiguracja.CDN.Bazy
<BAZA_FIRMY>.CDN.Firma
<BAZA_FIRMY>.CDN.Kontrahenci
<BAZA_FIRMY>.CDN.Kategorie
<BAZA_FIRMY>.CDN.SchematPlatnosci
<BAZA_FIRMY>.CDN.BnkZapisy
<BAZA_FIRMY>.CDN.grupy
<BAZA_FIRMY>.CDN.FormyPlatnosci
<BAZA_FIRMY>.CDN.BnkRachunki

Jednym ze sposobów uruchomienia dostępu do bazy danych jest (o ile nie jest to użytkownik CDNGosc, który automatycznie jest w każdej nowo tworzonej bazie przez Optime):

CDN_KNF_Konfiguracja → Security → Users - dodanie użytkownika o nazwie saldeoSync
dodanie database role membership - db_datareader
tą operację należy wykonać dla każdej bazy (firmy) -

Połączenie korzystające z uwierzytelniania windows (dostępne jest od Optima Provider 1.2.1)

Parametry (wymagane są pogrubione)

<OPTIMA>.db.driver=com.microsoft.sqlserver.jdbc.SQLServerDriver

<OPTIMA>.use.windows.auth=true
<OPTIMA>.db.connection.url=jdbc:sqlserver://192.168.1.252;databasename=master;integratedSecurity=true

<OPTIMA>.db.conf=CDN_KNF_Konfig

-------------------------------------------------------------------------------------

Provider-y:

Lista

-------------------------------------------------------------------------------------

Driver

Przetestowany i działa z www.saldeo.pl/saldeo-sync/sqljdbc4.jar, nie działa z ms-sqljdbc4.jar.

-------------------------------------------------------------------------------------

Biblioteki dll

https://docs.google.com/document/d/1eyenNfHVAmEex1eJGxLlaVWkWTfKOM9g1CYQT5lSBWo/edit#heading=h.9zwengqst9dg

Provider Insert Rachmistrz, Rewizor, Navireo

W przypadku korzystania z dwóch programów zarówno Rachmistrz jak i Rewizor dla każdego wprowadzamy sekcję połączenia w pliku konfiguracyjnym z osobna. Obsługę Navireo zapewnia provider dla Rewizor-a, nie wymaga przy tym żadnych dodatkowych ustawień.

!!!WAŻNE!!! Jeżeli łączymy się tylko z jednym programem INSERT, np. rachmistrz lub rewizor w pliku saldeosync-configuration-id.conf nie wolno umieszczać wpisów dla obu programów. Jeśli skonfigurujemy połączenie do nieużywanego programu i w MS SQL nie ma baz tegoż programu moduł SYNC nie uruchamia się.

Parametry (wymagane są pogrubione)

(dla rewizora)

CONNECTION.1=NAZWA_POLACZENIA

NAZWA_POLACZENIA.provider=INSERT_REWIZOR

NAZWA_POLACZENIA.db.driver=com.microsoft.sqlserver.jdbc.SQLServerDriver

NAZWA_POLACZENIA.db.connection.url=jdbc:sqlserver://adres IP i port;databasename=MASTER

NAZWA_POLACZENIA.db.user=

NAZWA_POLACZENIA.db.password=

NAZWA_POLACZENIA.period=1m

NAZWA_POLACZENIA.SYNCHRONIZED_CONTRACTORS.times=1

NAZWA_POLACZENIA.SYNCHRONIZED_CATEGORIES.times=1

// Parametr paczkowania dla operacji merge-a kontrahentów
REWIZOR.fetch.size.SYNCHRONIZED_CONTRACTORS=500
// dodatkowo aby pominąć bazy z innymi prefiksami do pliku z konfiguracją można dodać property:

NAZWA_POLACZENIA.skip.db.prefix=prefix1,prefix2... (lista prefiksów rozdzielona przecinkami)

(dla Rachmistrza)

CONNECTION.2=NAZWA_POLACZENIA

NAZWA_POLACZENIA.provider=INSERT_RACHMISTRZ

NAZWA_POLACZENIA.db.driver=com.microsoft.sqlserver.jdbc.SQLServerDriver

NAZWA_POLACZENIA.db.connection.url=jdbc:sqlserver://adres IP i port;databasename=MASTER

NAZWA_POLACZENIA.db.user=

NAZWA_POLACZENIA.db.password=

NAZWA_POLACZENIA.period=1m

NAZWA_POLACZENIA.SYNCHRONIZED_CONTRACTORS.times=1

NAZWA_POLACZENIA.SYNCHRONIZED_CATEGORIES.times=1

// Parametr paczkowania dla operacji merge-a kontrahentów
RACHMISTRZ.fetch.size.SYNCHRONIZED_CONTRACTORS=500

// dodatkowo aby pominąć bazy z innymi prefiksami do pliku z konfiguracją można dodać property:

NAZWA_POLACZENIA.skip.db.prefix=prefix1,prefix2... (lista prefiksów rozdzielona przecinkami)

-------------------------------------------------------------------------------------

Provider-y:

Lista

-------------------------------------------------------------------------------------

Driver SQL:

SQL JDBC

-------------------------------------------------------------------------------------

Domyślny użytkownik: sa, pass: <puste>

Wymagane jest aby użytkownik miał dostęp typu select dla (wersja 1.0.2):

master..sysdatabases
[BAZA_FIRMY].sys.Objects
[BAZA_FIRMY].dbo.net_Info
[BAZA_FIRMY].dbo.adr__Ewid
[BAZA_FIRMY].dbo.sl_Kategoria
[BAZA_FIRMY].dbo.kh__Kontrahent
[BAZA_FIRMY].dbo.rb__RachBankowy
[BAZA_FIRMY].dbo.sl_Panstwo

oraz dostęp do funkcji:

OBJECT_ID

Provider Streamsoft Ala

Parametry (wymagane są pogrubione):

<STREAMSOFT_ALA>.db.driver=org.paradox.Driver

<STREAMSOFT_ALA>.provider=STREAMSOFT_ALA

<STREAMSOFT_ALA>.db.path=c:\\streamsoft\\Dane

<STREAMSOFT_ALA>.db.contractors.path=C:\\streamsoft\\Kontrahenci - gdy baza kontrahentów jest wspólna dla wszystkich firm

<STREAMSOFT_ALA>.period=1m

<STREAMSOFT_ALA>.SYNCHRONIZED_CONTRACTORS.times=1

-------------------------------------------------------------------------------------

Provider-y:

Lista

-------------------------------------------------------------------------------------

Driver

ParadoxDriver-1.0.1.jar

Provider Reset R2Ksiega SQL

Połączenie za pomocą usera i hasła

Parametry (wymagane są pogrubione)

<R2_SQL>.provider=RESET_R2KSIEGA_SQL

<R2_SQL>.db.driver=com.microsoft.sqlserver.jdbc.SQLServerDriver
<R2_SQL>.db.connection.url=jdbc:sqlserver://192.168.1.252:1433;databasename=master
<R2_SQL>.db.user=saldeoSync
<R2_SQL>.db.password=saldeoSyncPass

<R2_SQL>.db.name=ksiega

<R2_SQL>.period=1m

UWAGA: w związku z niejednoznacznie używanym prefiksem nazw baz danych, od wersji provider-a 2.0.3 umożliwiono - opcjonalnie - wymuszenie określonego prefiksu baz danych R2X bądź R2F. Aby wymusić łączenie się z określonym prefiksem baz danych w konfiguracji dodajemy parametr i podajemy jego nazwę.

<R2_SQL>.db.prefix.name= <PREFIX>

-------------------------------------------------------------------------------------

Provider-y:

Lista

-------------------------------------------------------------------------------------

Driver

Ms-sqljdbc4.jar lub sqljdbc4.jar, ale tylko jeden z tych 2 powyższych.

-------------------------------------------------------------------------------------

Dostęp użytkownika do obiektów bazodanowych

Wymagane jest aby użytkownik miał dostęp typu SELECT do:

R2F_ksiega_bin.dbo.FIRM
R2F_ksiega_bin.dbo.VERSION
R2F_ksiega_<BAZA_FIRMY>.dbo.KONTRAH

Połączenie korzystające z uwierzytelniania windows

Parametry (wymagane są pogrubione)

<R2_SQL>.db.driver=com.microsoft.sqlserver.jdbc.SQLServerDriver

<R2_SQL>.use.windows.auth=true
<R2_SQL>.db.connection.url=jdbc:sqlserver://192.168.1.252;databasename=master;integratedSecurity=true

Provider Sage Symfonia FiK

Parametry

(wymagane są pogrubione):

<SAGE_FK>.db.path=C:\\Symfonia\\FK_bazy

<SAGE_FK>.username=saldeo

<SAGE_FK>.password=saldeo

<SAGE_FK>.license=14-9928BD

<SAGE_FK>.jni4net.filename=geminiDLL.j4n.dll

Opcjonalne, do synchronizacji towarów, nazwa serwera Pervasive

<SAGE_FK>.server.name=

Opcjonalne, domyślna wartość jak niżej:

<SAGE_FK>.jni4net.path=C:\\Program Files (x86)\\SaldeoPULPIT\\libs

w każdej firmie należy założyć użytkownika o danych z pól username i password w konfiguracji (6. Ustawienia -> Dane o firmie -> Użytkownicy)
pole “license” - numer licencji Symfonii (prawdopodobnie w Pomoc -> O programie)

Przykładowa konfiguracja (klucz licencji dla wersji demo):

CONNECTION.1=SAGE_FK
SAGE_FK.provider=SAGE_FK
SAGE_FK.db.path=C:\\Symfonia\\FK_bazy
SAGE_FK.username=saldeo
SAGE_FK.password=saldeo
SAGE_FK.license=14-9928BD
SAGE_FK.jni4net.filename=geminiDLL.j4n.dll
SAGE_FK.period=1m

Konfiguracja dla DEMO

conf.id=symfonia-demo

URL konfiguracji:

http://s3-eu-west-1.amazonaws.com/saldeo.pl/connections/saldeosync-configuration-symfonia-demo.conf

-------------------------------------------------------------------------------------

Provider-y:

Lista

-------------------------------------------------------------------------------------

Ustawienie bazy nie Pervasive

Jeśli Symfonia nie korzysta z bazy Pervasive, to należy zmienić konfigurację bazy danych. W lokalizacji C:\Program Files (x86)\Common Files\Sage\OsaldeoCX uruchomić W32MKSET.exe. W oknie “Categories” wybrać “File Settings”. W dolnym oknie “Settings” zmienić wartości:

Open Files na 16000
Handles na 16000
Record Locks per Client na 16000

Wymagany jest restart bazy (lub komputera)

Biblioteki

Wszystkie dodatkowe biblioteki są dostępne pod adresem:

2.0.1: włącznie z numerami zwrotnymi

http://s3-eu-west-1.amazonaws.com/saldeo.pl/drivers/libs-sage-provider-2.0.1.zip

Należy je rozpakować i przekopiować do SALDEODESKTOP_HOME/libs.

W przypadku dll-ek, należy sprawdzić czy nie zostały one domyślnie zablokowane przez Windows przy rozpakowywaniu. Trzeba zaznaczyć i kliknąć na właściwości pliku, a następnie odblokuj, zapisz i OK.

UWAGA: Odblokowanie może odbywać się tylko poza katalogiem z ograniczonym dostępem “Administratora” (np. odblokowanie nie zadziała w katalogu C:\Program Files\SaldeoPULPIT).

Wymagania:

SaldeoPULPIT musi działać na 32-bitowej Javie, powód - pliki DLL są 32-bitowe - dodatkowo w instalatorze SaldeoPULPIT został utworzony plik BAT, który można skonfigurować w taki sposób aby uruchamiał Java 32-bit (w przypadku jeżeli na komputerze standardowa jest 64-bit)
Jeśli w katalogu “C:\Program Files (x86)\Common Files\Sage\OCX\" nie ma pliku “WBTRV32.DLL”, trzeba go skopiować z katalogu gdzie zainstalowana jest Symfonia, np. "C:\Symfonia"
jeżeli pojawia się błąd w rodzaju:

Exception in thread "main" System.Runtime.InteropServices.COMException (0x80040154): Pobranie fabryki klasy COM dla składnika o identyfikatorze CLSID

{3F708029-4714-4733-97EE-9E1B591F6DE0} nie powiod│o siŕ z powodu nastŕpuj╣cego b│ŕdu: 80040154 Klasa niezarejestrowana. (Wyj╣tek od HRESULT: 0x8004015

4 (REGDB_E_CLASSNOTREG)).

w geminiDLL.Gemini.version()

w geminiDLL.__Gemini.version0(IntPtr __envp, JniLocalHandle __obj)

at geminidll.Gemini.version(Native Method)

oznacza, że nie ma obiektu integracji, który można pobrać z ftp://ftp.symfonia.pl/pub/symfonia/hotline/install/ITG/

Tryb debug - lista firm i dane jednej firmy (od wersji 1.1.0):

wszystko trzeba odpalać z katalogu libs/, (tam gdzie są jary providerów i ich zależności), lub w katalogu o ścieżce z “jni4net.path”
do katalogu skopiować plik EXE saldeo pulpit i zmienić mu rozszerzenie na JAR, (chodzi o plik po instalacji, nie instalator!)
w tym katalogu trzeba stworzyć plik z konfiguracją o nazwie symfonia-debug-config.txt, konfiguracja jest taka sama jak normalna, tylko trzeba usunąć przedrostki np.: "SAGE_FK.db.path=C:\\Symfonia" zamienić na "db.path=C:\\Symfonia"
w katalogu w trunk providera w katalogu /debug jest skrypt .bat odpalający, skopiować go do libs/ i stamtąd odpalać
skrypt przyjmuje jako parametr COMPANY_PROGRAM_ID firmy

Provider Symfonia - Forte

Parametry (wymagane są pogrubione)

<FORTE>.db.driver=com.microsoft.sqlserver.jdbc.SQLServerDriver

<FORTE>.db.connection.url=jdbc:sqlserver://127.0.0.1:1433;databasename=master

<FORTE>.db.user=Nazwa_Użytkownika

<FORTE>.db.password=Hasło

-------------------------------------------------------------------------------------

Provider-y:

Lista

-------------------------------------------------------------------------------------

Driver SQL:

SQL JDBC

-------------------------------------------------------------------------------------

Przykładowa konfiguracja Symfonia FORTE :

CONNECTION.1=SYMFONIA_FORTE
SYMFONIA_FORTE.provider=SYMFONIA_FORTE
SYMFONIA_FORTE.db.driver=com.microsoft.sqlserver.jdbc.SQLServerDriver
SYMFONIA_FORTE.db.connection.url=jdbc:sqlserver://127.0.0.1:1433;databasename=master
SYMFONIA_FORTE.db.user=admin
SYMFONIA_FORTE.db.password=haslo
SYMFONIA_FORTE.period=1m
SYMFONIA_FORTE.SYNCHRONIZED_CONTRACTORS.times=1
SYMFONIA_FORTE.SYNCHRONIZED_CATEGORIES.times=1
SYMFONIA_FORTE.SYNCHRONIZED_DOCUMENTS.times=1

Provider Symfonia - ERP

Parametry (wymagane są pogrubione)

<ERP>.db.driver=com.microsoft.sqlserver.jdbc.SQLServerDriver

<ERP>.db.connection.url=jdbc:sqlserver://127.0.0.1:1433;databasename=master

<ERP>.db.user=Nazwa_Użytkownika

<ERP>.db.password=Hasło

-------------------------------------------------------------------------------------

Provider-y:

Lista

-------------------------------------------------------------------------------------

Driver SQL:

SQL JDBC

-------------------------------------------------------------------------------------

Przykładowa konfiguracja Symfonia ERP :

CONNECTION.1=SYMFONIA_ERP
SYMFONIA_ERP.provider=SYMFONIA_ERP
SYMFONIA_ERP.db.driver=com.microsoft.sqlserver.jdbc.SQLServerDriver
SYMFONIA_ERP.db.connection.url=jdbc:sqlserver://127.0.0.1:1433;databasename=master
SYMFONIA_ERP.db.user=Admin
SYMFONIA_ERP.db.password=haslo
SYMFONIA_ERP.period=1m
SYMFONIA_ERP.SYNCHRONIZED_CONTRACTORS.times=1
SYMFONIA_ERP.SYNCHRONIZED_CATEGORIES.times=1
SYMFONIA_ERP.SYNCHRONIZED_DOCUMENTS.times=1

Provider Assecco - Wapro Fakir, Kaper

Parametry (wymagane są pogrubione)

<WAPRO>.db.driver=com.microsoft.sqlserver.jdbc.SQLServerDriver
<WAPRO>.db.connection.url=jdbc:sqlserver://192.168.0.1:1433;databasename=master
<WAPRO>.db.user=sa

<WAPRO>.db.password=

<WAPRO>.db.conf=<nazwa_bazy_danych>

-------------------------------------------------------------------------------------

Provider-y:

Lista

-------------------------------------------------------------------------------------

Driver SQL:

SQL JDBC

-------------------------------------------------------------------------------------

Domyślny użytkownik: sa, pass: <puste>

Przykładowa konfiguracja FAKIR :

CONNECTION.1=WAPRO_FAKIR
WAPRO_FAKIR.provider=WAPRO_FAKIR
WAPRO_FAKIR.db.driver=com.microsoft.sqlserver.jdbc.SQLServerDriver
WAPRO_FAKIR.db.connection.url=jdbc:sqlserver://127.0.0.1:1433;databasename=master
WAPRO_FAKIR.db.user=sa
WAPRO_FAKIR.db.password=
WAPRO_FAKIR.db.conf=WAPRO_DEMO
WAPRO_FAKIR.period=1m
WAPRO_FAKIR.SYNCHRONIZED_CONTRACTORS.times=1
WAPRO_FAKIR.SYNCHRONIZED_CATEGORIES.times=1

Przykładowa konfiguracja KAPER :

CONNECTION.1=WAPRO_KAPER
WAPRO_KAPER.provider=WAPRO_KAPER
WAPRO_KAPER.db.driver=com.microsoft.sqlserver.jdbc.SQLServerDriver
WAPRO_KAPER.db.connection.url=jdbc:sqlserver://127.0.0.1:1433;databasename=master
WAPRO_KAPER.db.user=sa
WAPRO_KAPER.db.password=
WAPRO_KAPER.db.conf=WAPRO_DEMO
WAPRO_KAPER.period=1m
WAPRO_KAPER.SYNCHRONIZED_CONTRACTORS.times=1
WAPRO_KAPER.SYNCHRONIZED_CATEGORIES.times=1

Provider CHUDZIKIEWICZ - bcKPR

Synchronizacja obejmuje automatyczne zakładanie firm w SALDEO i pobieranie dokumentów do wskazanego folderu w SaldeoPULPIT..

Parametry (wymagane są pogrubione):

<CHUDZIKIEWICZ>.provider=CHUDZIKIEWICZ

<CHUDZIKIEWICZ>.period=1m

<CHUDZIKIEWICZ>.program.path=<Katalog programu z bazami>

-------------------------------------------------------------------------------------

Przykładowa konfiguracja:

CONNECTION.1=CHUDZIKIEWICZ
CHUDZIKIEWICZ.provider=CHUDZIKIEWICZ
CHUDZIKIEWICZ.period=1m
CHUDZIKIEWICZ.program.path=C:\\KPR_2018

------------------------------------------------------------------------------------

Provider-y:

Lista

Provider Comarch XL Vateri

Parametry (wymagane są pogrubione):

<COMARCH_XL_VATERI>.db.driver=com.microsoft.sqlserver.jdbc.SQLServerDriver

<COMARCH_XL_VATERI>.db.connection.url=jdbc:sqlserver://192.168.1.252:1433;databasename=master

<COMARCH_XL_VATERI>.db.user=<user>

<COMARCH_XL_VATERI>.db.password=<password>

-------------------------------------------------------------------------------------

Przykładowa konfiguracja:

CONNECTION.1=COMARCH_XL_VATERI
COMARCH_XL_VATERI.provider=COMARCH_XL
COMARCH_XL_VATERI.db.driver=com.microsoft.sqlserver.jdbc.SQLServerDriver
COMARCH_XL_VATERI.db.connection.url=jdbc:sqlserver://192.168.1.252:1433;databasename=master
COMARCH_XL_VATERI.db.user=saldeoSync
COMARCH_XL_VATERI.db.password=saldeoSyncPassword
COMARCH_XL_VATERI.db.conf.exclude=comarch_xl1, comarch_xl2,...n
COMARCH_XL_VATERI.period=1m
COMARCH_XL_VATERI.settings.contractor.synchronize.types=0,8,24
COMARCH_XL_VATERI.SYNCHRONIZED_CONTRACTORS.times=1
COMARCH_XL_VATERI.SYNCHRONIZED_CATEGORIES.times=1

Konfiguracja importu kontrahentów z COMARCH ERP XL

W celu pobrania danych kontrahentów w ustawieniach w pliku konfiguracji umieszczamy wpis:

COMARCH_XL_VATERI.settings.contractor.synchronize.types=0,8,24

gdzie odpowiedni cyfry oznaczają:

0 - brak określonego typu kontrahenta

8 - dostawca

16 - odbiorca

24 - dostawca/odbiorca

-------------------------------------------------------------------------------------

Provider-y:

Lista

Od wersji providera 2.0.1 moduł synchronizujący umożliwia podłączenie wielu baz firm z programu COMARCH ERP XL.

Jeśli nie chcemy synchronizować wszystkich baz należy w pliku konfiguracyjnym SALDEOSYNC-ID.CONF umieścić wpis:

db.conf.exclude=

Po znaku = wypisać nazwy baz, które mają być pominięte podczas synchronizacji. Kolejne nazwy oddzielamy przecinkiem.

-------------------------------------------------------------------------------------

Driver SQL:

SQL JDBC

-------------------------------------------------------------------------------------

Wersja demonstracyjna importera VAT jest dostępna pod poniższym adresem:

Veteri-demo dla XL 2017

Tabele:

Operacja	Nazwa tabeli	Uwagi
Wersja bazy	<xl>.CDN.SystemCDN	SELECT SYS_Wartosc FROM comarch_xl.CDN.SystemCDN WHERE SYS_ID = 3
Lista firm	<xl>.CDN.Firma	Oddziały mogą być podpiąte pod jedno Frm_GIDFirma, dlatego jest GROUP BY na Frm_GIDFirma i z tego MAX(Frm_GIDNumer)
Detale firmy	<xl>CDN.Firma	FROM <xl>.CDN.Firma WHERE Frm_GIDNumer = (SELECT MAX(Frm_GIDNumer) FROM <xl>.CDN.Firma WHERE Frm_GIDFirma=?
Lista kontrahentów	<xl>.CDN.KntKarty	WHERE Knt_GIDFirma = ?
Lista form płatności	<xl>.CDN.Konfig	WHERE Kon_Numer=736
Lista kategorii	<xl>.CDN.Wymiary	WHERE WMR_Kategoria<>0
Lista kategorii	<xl>.CDN.Konta - dla kategorii materializowanych z plnu kont	WHERE KKS_Konto LIKE ? AND KKS_GIDFirma=? AND KKS_Analityka=1 typy: WMR_Typ = 3(zmaterializowane), 2(SQL), 4(CODES_PLAN);
Lista rejestrów	<xl>.CDN.Nazwy	WHERE Naz_GIDTyp=576 AND Naz_GIDFirma=?
Numer zwrotny	<xl>.CDN.TraNag (FROM <xl>.CDN.Atrybuty AS a JOIN <xl>.CDN.AtrybutyKlasy AS k ON a.Atr_AtkId=k.AtK_ID JOIN <xl>.CDN.TraNag AS t ON t.TrN_GIDNumer=a.Atr_ObiNumer JOIN <xl>.CDN.KntKarty AS kk ON t.TrN_KntNumer = kk.Knt_GIDNumer JOIN <xl>.CDN.TrNOpisy AS op ON t.TrN_GIDTyp = op.TnO_TrnTyp AND t.TrN_GIDNumer = op.TnO_TrnNumer)	Wszystkie dokumenty z ustawionym atrybutem ‘SALDEO_ID’
Wymiary	<xl>.CDN.Wymiary	WHERE WMR_Kategoria=0
Projekty	<xl>.CDN.PrjStruktura	WHERE PRJ_GIDFirma = ?
Struktura kosztów	<xl>.CDN.FrmStruktura	WHERE FRS_StrTyp=1000 AND FRS_Warstwa=2 AND FRS_GIDFirma=?
Lokalizacje	<xl>.CDN.Slowniki	WHERE SLW_Kategoria='Lokalizacje' AND SLW_Aktywny=1 AND SLW_Archiwalny=0

Provider SSYNC RAKS

Informacje wstępne:

tworzymy konfigurację ręcznie - nie ma konfiguratora w SD/SA
provider umożliwia założenie firmy i synchronizowanie kontrahentów

Wymagania

SaldeoPULPIT lub SaldeoAGENT
jaybird.jar - sterownik do bazy Firebird - ze strony FirebirdSQL
saldeosync-raks-5.0.0.jar - sterownik do baz danych programu RAKS SQL utworzony przez Brainshare IT
Firebird 4.0 - tak jak wymaga producent RAKS SQL
bazy danych RAKS SQL muszą być w strukturach baz danych w wersji ODS 13.0
Prawidłowo ustawiona konfiguracja do połączenia

Konfiguracja połączenia

Analogicznie jak przy innych integracjach, tworzymy plik konfiguracyjny połączenia saldeosync-configuration-<NAZWA>.conf gdzie nazwa wg. preferencji własnych, ta sama nazwa powinna zostać ustawiona dla połączenia w pliku saldeosync-connection.conf

default.company.email=pawel.sierakowski-test@brainshare.pl

CONNECTION.1=<NAZWA_POLACZENIA>

<NAZWA_POLACZENIA>.provider=RAKS

<NAZWA_POLACZENIA>.db.driver=org.firebirdsql.jdbc.FBDriver

<NAZWA_POLACZENIA>.db.connection.url=jdbc\:firebirdsql\://<HOST>\:<PORT>/<ŚCIEŻKA_BAZY_GLOWNEJ>

<NAZWA_POLACZENIA>.db.user=<LOGIN>

<NAZWA_POLACZENIA>.db.password=<HASLO>

<NAZWA_POLACZENIA>.period=1m

<NAZWA_POLACZENIA>.SYNCHRONIZED_CATEGORIES.times=1

<NAZWA_POLACZENIA>.SYNCHRONIZED_CONTRACTORS.times=1

UWAGI:

NAZWA_POLACZENIA → np. RAKS
HOST → nazwa hosta lub adres IP
PORT → port po którym jest nawiązywane połączenie z serwerem bazy
- domyślnie będzie to 3050
ŚCIEŻKA_BAZY_GLOWNEJ → ścieżka do bazy konfiguracyjnej RAKS SQL domyślnie to: RAKS3000.FDB
- Przykładowa ścieżka domyślna przy instalacji to: C\Programy\Raks\Data\RAKS3000.FDB
- UWAGA: podając ścieżkę należy zachować formatowanie: C\:\\Programy\\Raks\\Data\\RAKS3000.FDB
LOGIN → login do bazy danych Firebird
- domyślnie będzie to SYSDBA
HASLO → hasło bazy danych
- domyślnie będzie to “masterkey”

Przykładowa konfiguracja:

default.company.email=saldeo@nobody.com

CONNECTION.1=RAKS

RAKS.provider=RAKS

RAKS.db.driver=org.firebirdsql.jdbc.FBDriver

RAKS.db.connection.url=jdbc\:firebirdsql\://172.16.60.65\:3050/C\:\\Programy\\Raks\\Data\\RAKS3000.FDB

RAKS.db.user=SYSDBA

RAKS.db.password=masterkey

RAKS.period=1m

RAKS.SYNCHRONIZED_CATEGORIES.times=1

RAKS.SYNCHRONIZED_CONTRACTORS.times=1

Na koniec w pliku: saldeosync-connection.conf

conf.id=<NAZWA>

conf.url=file:\\\C:\\Program Files (x86)\\SaldeoPULPIT\\

Gdzie nazwa odpowiada temu co podaliśmy w nazwie pliku: saldeosync-configuration-<NAZWA>.conf

Uwierzytelnianie windows providerów

Dostępne tylko dla niektórych providerów

Wymagane jest dodanie biblioteki sqljdbc_auth.dll do systemowego patha w zależności od architektury oraz użytej wersji JAVA .

Wersja dla systemu x64 to:

http://s3-eu-west-1.amazonaws.com/saldeo.pl/drivers/mssql/auth/x64/sqljdbc_auth.dll

Wersja dla systemu x86 to:
http://s3-eu-west-1.amazonaws.com/saldeo.pl/drivers/mssql/auth/x86/sqljdbc_auth.dll

Gdzie należy wrzucić tą bibliotekę

Np.: dla instalacji Windows 7 zainstalowanej na dysku C:

lokalizacja/architektura systemu	x86	x64
C:\Windows\System32	wersja 32-bitowa	wersja 64 bitowa
C:\Windows\SysWOW64	nie wymagane	wersja 32 bitowa

Zmiany w dokumentacji - metryczka

Data zmiany	Oznaczenie wersji providera	Autor	Opis zmian
19.07.2018	2.0.0	Paweł Sierakowski	Dodano nową integrację z programem bcKPR
24.07.2018	2.4.0	Paweł Sierakowski	Aktualizacja provider-a Provider Comarch Optima do wersji 2.4.0
31.07.2018	2.0.1	Paweł Sierakowski	Aktualizacja provider-a do Provider CHUDZIKIEWICZ - bcKPR, zmiany: poprawienie kopiowania nazwy firmy przy jej zakładaniu w SALDEO
03.08.2018	2.1.0	Paweł Sierakowski	Aktualizacja provider-a do RESET2 KSIEGA i FK zmiany: w opcjach synchronizacji umożliwiono pobieranie numeru zwrotnego z programu księgowego
24.08.2018	2.1.1	Paweł Sierakowski	Aktualizacja provider-a do RESET2 KSIEGA i FK zmiany: poprawa oznaczania nazwy rejestru w przekazywanym numerze zwrotnym
08.07.2019	2.4.2	Grzegorz Ćwiklak	Aktualizacja providera dla Comarch ERP Optima do wersji 2.4.2 Aktualizacja providera dla Symfonia Forte i Symfonia ERP do wersji 2.4.1
19.08.2020	4.x.x	Wojciech Kubiak	Zmiana linków providerów na najnowsze
12.05.2025	5.0.0	Kamila Gonet	Dodanie Provider SSYNC RAKS

Funkcje SaldeoPULPIT

Instalacja SaldeoSYNC

oraz katalog LIBS

Lokalizacja logów

Konfiguracja użytkownika

Konfiguracja modułu SaldeoSYNC

Dodanie plików konfiguracyjnych

saldeosync-connection.conf

Ustawienie silnika MSSQL

Provider Comarch Optima

Połączenie za pomocą usera i hasła

Provider-y:

Driver

Przykładowa konfiguracja DEMO

Dostęp użytkownika do obiektów bazodanowych

Połączenie korzystające z uwierzytelniania windows (dostępne jest od Optima Provider 1.2.1)

Provider-y:

Driver

Biblioteki dll

Provider Insert Rachmistrz, Rewizor, Navireo

Parametry (wymagane są pogrubione)

Provider-y:

Driver SQL:

Domyślny użytkownik: sa, pass: <puste>

Provider Streamsoft Ala

Parametry (wymagane są pogrubione):

Provider-y:

Driver

Provider Reset R2Ksiega SQL

Połączenie za pomocą usera i hasła

Parametry (wymagane są pogrubione)

Provider-y:

Driver

Dostęp użytkownika do obiektów bazodanowych

Połączenie korzystające z uwierzytelniania windows

Parametry (wymagane są pogrubione)

Provider Sage Symfonia FiK

Parametry

Przykładowa konfiguracja (klucz licencji dla wersji demo):

Konfiguracja dla DEMO

Provider-y:

Ustawienie bazy nie Pervasive

Biblioteki

Wymagania:

Tryb debug - lista firm i dane jednej firmy (od wersji 1.1.0):

Provider Symfonia - Forte

Parametry (wymagane są pogrubione)

Provider-y:

Driver SQL:

Przykładowa konfiguracja Symfonia FORTE :

Parametry (wymagane są pogrubione)

Provider-y:

Driver SQL:

Przykładowa konfiguracja Symfonia ERP :

Provider Assecco - Wapro Fakir, Kaper

Parametry (wymagane są pogrubione)

Provider-y:

Driver SQL:

Domyślny użytkownik: sa, pass: <puste>

Przykładowa konfiguracja FAKIR :

Przykładowa konfiguracja KAPER :

Provider CHUDZIKIEWICZ - bcKPR

Parametry (wymagane są pogrubione):

Przykładowa konfiguracja:

Provider-y:

Provider Comarch XL Vateri

Parametry (wymagane są pogrubione):

Przykładowa konfiguracja:

Provider-y:

Driver SQL:

Wersja demonstracyjna importera VAT jest dostępna pod poniższym adresem:

Provider SSYNC RAKS

Informacje wstępne:

Wymagania

Konfiguracja połączenia

Uwierzytelnianie windows providerów

Zmiany w dokumentacji - metryczka

Powiązane artykuły