Ne každá integrace probíhá přes přímé API propojení. Pro systémy, které pracují s výměnou souborů, nabízí PSB SFTP integraci. PSB periodicky stahuje soubory z Vašeho SFTP serveru (From SFTP) nebo umisťuje přijaté dokumenty na Váš SFTP server (To SFTP). Oba toky se konfigurují přes SFTP hooky.

SFTP připojení můžete vytvořit přes platformu v sekci Verbindingen > Nieuwe Algemene verbinding > SFTP Connector. Klíče připojení, které zde vygenerujete, budete později potřebovat při konfiguraci hooku.

S From SFTP PSB periodicky stahuje soubory z Vašeho SFTP serveru a zpracovává je jako dokumenty. Je to praktické, pokud Váš zdrojový systém exportuje soubory do složky na SFTP serveru, například faktury ve formátu UBL nebo XML.

From SFTP pracuje s pěti složkami na Vašem SFTP serveru:

PSB standardně kontroluje každých 15 minut, zda se v readDirectory nacházejí nové soubory. Tento interval je konfigurovatelný.

From SFTP hook má následující action:

sftp://gebruiker:wachtwoord@host:poort?readDirectory=/upload&pendingDirectory=/pending&duplicateDirectory=/duplicate&successDirectory=/success&errorDirectory=/error#md5-fingerprint

Hook musí obsahovat i publishTopic, který určuje, jak se stažené soubory mají zpracovat, například SendInvoice pro odesílání faktur.

{
  "action": "sftp://user:pass@sftp.bedrijf.nl:22?readDirectory=/out&pendingDirectory=/out/pending&duplicateDirectory=/out/duplicate&successDirectory=/out/success&errorDirectory=/out/error#aa:bb:cc:dd:ee:ff",
  "topics": [],
  "publishTopics": ["SendInvoice"]
}

Při každém cyklu PSB zkontroluje readDirectory, přesune soubory do pending, zpracuje je a poté je umístí do success nebo error. Soubory, které již byly dříve zpracovány, se přesunou do duplicateDirectory.

S To SFTP PSB automaticky umísťuje přijaté dokumenty na Váš SFTP server. Je to ideální, pokud Váš systém zpracovává soubory ze složky místo přes API webhook.

Při To SFTP potřebujete pouze inboxDirectory:

{
  "action": "sftp://user:pass@sftp.bedrijf.nl:22?dirs=/inbox#aa:bb:cc:dd:ee:ff",
  "topics": ["InvoiceReceived"]
}

Každý přijatý dokument se umístí jako soubor do inboxDirectory. Volitelně můžete zadat targetDocumentTypeId pro automatickou transformaci dokumentů do specifického formátu před umístěním na SFTP server.

Oba SFTP toky používají MD5 fingerprint pro ověření serveru. Fingerprint se nachází za znakem # v hook action a zajišťuje, že PSB se připojí pouze ke správnému SFTP serveru. Tím se předchází útokům typu man-in-the-middle.

MD5 fingerprint Vašeho SFTP serveru naleznete v konfiguraci serveru nebo připojením přes SFTP klienta. Formát je série hexadecimálních párů oddělených dvojtečkami, například aa:bb:cc:dd:ee:ff:00:11:22:33:44:55:66:77:88:99.

Organizace, která odesílá faktury ze svého ERP systému a chce importovat přijaté faktury:

1. Odesílání (From SFTP): ERP systém exportuje UBL faktury do /sftp/outbox. PSB je každých 15 minut stáhne a odešle přes Peppol.
2. Přijímání (To SFTP): PSB umísťuje přijaté faktury do /sftp/inbox. ERP systém periodicky čte složku a importuje dokumenty.

Oba toky fungují nezávisle a mohou být konfigurovány samostatně.

SFTP integrace se v praxi často používá u propojení s Unit4 ERP CR a ERP7, kde je výměna souborů přes SFTP složku standardní metoda výměny fakturačních dokumentů.

Ujistěte se, že SFTP uživatel má práva na zápis ve všech nakonfigurovaných složkách. PSB musí mít možnost přesouvat soubory mezi složkami. Zkontrolujte také, zda firewall Vašeho SFTP serveru povoluje příchozí připojení z IP adres eConnect.

Standardní interval stahování je 15 minut. Pokud potřebujete kratší nebo delší interval, kontaktujte TechSupport.

Chcete vědět více o výměně dokumentů přes PSB? Podívejte se na přehled multi-channel doručování nebo si přečtěte, jak nastavíte webhooky pro notifikace v reálném čase.