Nie každá integrácia prebieha cez priame API prepojenie. Pre systémy, ktoré pracujú s výmenou súborov, ponúka PSB SFTP integráciu. PSB periodicky sťahuje súbory z Vášho SFTP servera (From SFTP) alebo umiestňuje prijaté dokumenty na Váš SFTP server (To SFTP). Oba toky sa konfigurujú cez SFTP hooky.

SFTP pripojenie môžete vytvoriť cez platformu v sekcii Verbindingen > Nieuwe Algemene verbinding > SFTP Connector. Kľúče pripojenia, ktoré tu vygenerujete, budete neskôr potrebovať pri konfigurácii hooku.

S From SFTP PSB periodicky sťahuje súbory z Vášho SFTP servera a spracováva ich ako dokumenty. Je to praktické, ak Váš zdrojový systém exportuje súbory do priečinka na SFTP serveri, napríklad faktúry vo formáte UBL alebo XML.

From SFTP pracuje s piatimi priečinkami na Vašom SFTP serveri:

PSB štandardne kontroluje každých 15 minút, či sa v readDirectory nachádzajú nové súbory. Tento interval je konfigurovateľný.

From SFTP hook má nasledujúcu action:

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

Hook musí obsahovať aj publishTopic, ktorý určuje, ako sa stiahnuté súbory majú spracovať, napríklad SendInvoice na odosielanie faktúr.

{
  "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"]
}

Pri každom cykle PSB skontroluje readDirectory, presunie súbory do pending, spracuje ich a potom ich umiestni do success alebo error. Súbory, ktoré už boli predtým spracované, sa presunú do duplicateDirectory.

S To SFTP PSB automaticky umiestňuje prijaté dokumenty na Váš SFTP server. Je to ideálne, ak Váš systém spracováva súbory z priečinka namiesto cez API webhook.

Pri To SFTP potrebujete iba inboxDirectory:

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

Každý prijatý dokument sa umiestni ako súbor do inboxDirectory. Voliteľne môžete zadať targetDocumentTypeId na automatickú transformáciu dokumentov do špecifického formátu pred umiestnením na SFTP server.

Oba SFTP toky používajú MD5 fingerprint na overenie servera. Fingerprint sa nachádza za znakom # v hook action a zabezpečuje, že PSB sa pripojí iba k správnemu SFTP serveru. Tým sa predchádza útokom typu man-in-the-middle.

MD5 fingerprint Vášho SFTP servera nájdete v konfigurácii servera alebo pripojením cez SFTP klienta. Formát je séria hexadecimálnych párov oddelených dvojbodkami, napríklad aa:bb:cc:dd:ee:ff:00:11:22:33:44:55:66:77:88:99.

Organizácia, ktorá odosiela faktúry zo svojho ERP systému a chce importovať prijaté faktúry:

1. Odosielanie (From SFTP): ERP systém exportuje UBL faktúry do /sftp/outbox. PSB ich každých 15 minút stiahne a odošle cez Peppol.
2. Prijímanie (To SFTP): PSB umiestňuje prijaté faktúry do /sftp/inbox. ERP systém periodicky číta priečinok a importuje dokumenty.

Oba toky fungujú nezávisle a môžu byť konfigurované samostatne.

SFTP integrácia sa v praxi často používa pri prepojeniach s Unit4 ERP CR a ERP7, kde je výmena súborov cez SFTP priečinok štandardná metóda výmeny faktúrových dokumentov.

Uistite sa, že SFTP používateľ má práva na zápis vo všetkých nakonfigurovaných priečinkoch. PSB musí mať možnosť presúvať súbory medzi priečinkami. Skontrolujte tiež, či firewall Vášho SFTP servera povoľuje prichádzajúce pripojenia z IP adries eConnect.

Štandardný interval sťahovania je 15 minút. Ak potrebujete kratší alebo dlhší interval, kontaktujte TechSupport.

Chcete vedieť viac o výmene dokumentov cez PSB? Pozrite si prehľad multi-channel doručovania alebo si prečítajte, ako nastavíte webhooky na notifikácie v reálnom čase.