artipa.BusinessPortalClient (ABPClient) je aplikace pro výměnu EDI souborů se servery artipa.BusinessPortal (ABP). Jedná se o jednoduchého klienta, který se spouští z příkazové řádky. Odesílá zprávy připravené v odchozím adresáři a stahuji příchozí zprávy ze serveru.

Klient komunikuje s REST API na serveru abpapi.artipa.cz pomocí https a autentizuje se API klíčem z konfiguračního souboru.

API klíč je nutné získat od poskytovatele EDI služeb artipa.software.

Přepínače pro spuštění jsou -d (download), -u (upload). Přepínače lze použít samostatně nebo v kombinaci.

Struktura adresářů vypadá následovně:

  • /bin – samotná aplikace abpclient a konfigurační soubor config.json
  • /data – obsahuje adresáře pro edi soubory (lze změnit v config.json)
  • /log – obsahuje logy

Instalace

  1. Stáhněte zip pro příslušnou platformu (viz sekce Download níže)
  2. Rozbalte zip do instalačního adresáře dle vašeho výběru (např. C:AbpClient nebo /opt/abpclient)
  3. Spusťte terminál nebo příkazovou řádku a přejděte do AbpClientbin resp /opt/abpclient/bin
  4. Spusťte příkaz:
    ./AbpClient -k [APIKey] API klíč obdržíte od Poskytovatele artipa
  5. Spusťte příkaz:
    ./AbpClient -d (Linux/macOS) nebo AbpClient.exe -d (Windows) (V adresáři data/in by se měl objevit soubor test.txt)
  6. Možnosti spuštění:
    -d Stáhne soubory ze serveru do data/in
    -u Odešle soubory z data/out (odeslané soubry se přesunou do adresáře data/sent)
  7. Pokud se aplikace spouští načasovanou úlohou, ujistit se, že tato úloha spouští přímo soubor binabpclient.exe s parametry -u -d a process běží v kontextu adresáře /bin (protože cesty v konfiguraci a programu jsou zadány relativně)

Download