Poniższy opis dotyczy integracji – przesyłania dokumentów z Studio System do platformy Tradeshift za pomocą podłączenia SFTP .
- Krok 1: Klucze.
W pierwszym kroku należy wygenerować zestaw kluczy RSA i dodać klucz publiczny po stronie aplikacji WEB Tradeshift.
(Instrukcja do tego etapu znajduje się również pod adresem: http://integrate.tradeshift.com/sftp/ )
- Pobieramy/uruchmiamy PuTTy, generujemy klucz RSA – zapisujemy zarówno klucz publiczny jak i prywatny do pliku.
- Klucz publiczny – widoczny w oknie programu przeklejamy do aplikacji SFTP Uploader na platformie Tradeshift.
- Klucz prywatny zapisany do pliku umieszczamy w katalogu głównym Studio System pod nazwą: tradeshift_sftp_rsa_priv.pk
- Krok 2: Dane serwera/użytkownika SFTP
Z aplikacji SFTP Upload Tradeshift kopiujemy do Studio System adres serwera i nazwę użytkownika, zapisując w tabeli _parametry pod KOD:
TDS_SERV – nazwa/adres serwera
TDS_USER – nazwa użytkownia
- Krok 3: Funkcja SQL zwracająca dane faktury
W bazie custom musi znajdować się funkcja:
[dbo].[PobierzFaktureTradeshift] (’@NUMER’)
Przyjmująca jako parametr identyfikator faktury a zwracająca tabelę z wszystkimi pozycjami danej faktury oraz wierszem nagłówkowym.
Przykładowy plik Excel z fakturą: podstawowaFaktura_v2
Opis wszystkich możliwych kolumn w fakturze: Master_INV_Specification
- Krok 4: Wywołanie
W projekcie znajduje się klasa Tradeshift (App_Integracje), dla obiektu klasy Tradeshift udostępniona jest publicznie metoda: createAndUploadInvoice(String invoiceNumber) – jako parametr należy podać identyfiaktor faktury który zostanie przekazany do procedury z kroku 3.
Dodatkowe informacje:
Przed wysłaniem pliki CSV są zapisywane w App_Import\Tradeshift_Eksport\.
Parametr InvoiceNumber – musi być tożsamy z wartością z kolumny InvoiceNumber zwróconej przez funkcje SQL – jest to też nazwa pliku eksportowanej faktury – wartość liczbowa.
Tabela knwms
Tabela _historia_archiwum
Tabela stanowi archiwum dla zapisów z tabeli _historia. Identyfikator dokumentu (REFNO), kartoteki (NRID), dla której…
Tabela knpal
W tabeli zapisywane są kartoteki palet i opakowań. Pola tabeli knpal: Nazwa kolumnytypszerokośćopisAKTYWNEbit1Oznaczenie aktywności wierszaCENANETTOfloat8Cena…
Tabela _historia
W tabeli _historia zapisywane są informacje o operacjach wykonywanych w programie: dopisanie, edycja i anulowanie…
Tabela dppal
Pozycje dokumentów ewidencja palet i opakowań. Pola tabeli dppal: Nazwa kolumnytypszerokośćopisACHvarchar1Jednoznakowe oznaczenie stanu danego wiersza…
Tabela knusl
Kartoteki usług. Pola tabeli knusl: Nazwa kolumnytypszerokośćopisACHvarchar1Jednoznakowe oznaczenie stanu danego wiersza w tabeli: 0-bufor, 1-zatwierdzony,…