Výměna dokumentů přes SFTP: From SFTP (pull), To SFTP (push), struktura složek a konfigurace.
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.
Kromě primárního publishTopic jsou potřeba odpovídající supporting topics, aby hook přesouval soubory do správné stavové složky:
SendInvoiceInvoiceSent, InvoiceSentErrorReceiveInvoiceInvoiceReceived, InvoiceReceivedErrorSoubory s mezistavem *Retry (např. InvoiceSentRetry) zůstávají v pendingDirectory, dokud nepřijde konečný stav.
{
"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?inboxDirectory=/inbox#aa:bb:cc:dd:ee:ff",
"topics": ["InvoiceReceived"]
}
Každý přijatý dokument se umístí jako soubor do inboxDirectory. Ve výchozím stavu To SFTP nahrává po dokumentu, ne jako periodickou ZIP dávku. Periodický hromadný přenos vyžaduje samostatný batch hook. Volitelně targetDocumentTypeId filtruje konkrétní typ dokumentu. Nejde o automatickou transformaci.
Pokud odesílatel nemůže dát PDF a XML do samostatných složek (oba soubory přijdou do stejné SFTP složky), použijte query parametr fileNameFilter na SFTP hoocích. Parametr je před otiskem (#) v action hooku.
Nastavte dva From SFTP hooky na stejném hostu a složce:
.xmlSendInvoiceInvoiceSent, InvoiceSentError.pdfReceiveAttachmentAttachmentReceived, AttachmentReceivedErrorPDF hook může být read-and-delete: stačí readDirectory a PSB soubor po zpracování smaže místo přesunu. Můžete také použít stejné stavové složky (pending, success, error, duplicate) jako u XML hooku.
Po stažení obou souborů join hook spojí XML a PDF do jednoho dokumentu (SendInvoiceJoined). Viz Join hooks.
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.
Doručení SFTP a následný ingest do ERP (například To SFTP směrem k Unit4 ERP CR) jsou dva samostatné, nezávisle pracující hooky — ne jeden řetězec se sdíleným stavem.
Dokument označený v eConnect jako stažený potvrzuje jen, že doručující hook soubor vyzvedl nebo uložil. Sám o sobě neříká, zda ERP soubor potom úspěšně načetl.
Pro každý hook zvlášť je monitoring přes topicy HookSentError (konečné selhání) a HookSentRetry (mezikrok). Nastavte pro každý hook monitorovací akci na tyto topicy, přes mail hook nebo druhý webhook.
Organizace, která odesílá faktury ze svého ERP systému a chce importovat přijaté faktury:
/sftp/outbox. PSB je každých 15 minut stáhne a odešle přes Peppol./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.
Fingerprint patří k hostiteli Vašeho SFTP serveru a zajišťuje, že se PSB připojuje pouze k zamýšlenému serveru. Tím omezíte riziko útoků man-in-the-middle. Formát je série hexadecimálních párů oddělených dvojtečkami, jak je popsáno v dokumentaci.
S From SFTP PSB periodicky stahuje soubory z Vašich složek a zpracovává je jako dokumenty (například export faktur do readDirectory). S To SFTP PSB umisťuje přijaté dokumenty do Vašeho inboxDirectory, aby je systém mohl číst ze složky místo přes webhook.
Uživatel musí mít možnost zapisovat do všech nakonfigurovaných složek a přesouvat soubory, protože PSB přesouvá soubory mezi mimo jiné read, pending, success a error. Zkontrolujte také, zda firewall Vašeho SFTP serveru povoluje příchozí připojení z IP adres eConnect.
Ne. Stažený potvrzuje jen, že doručující hook (To SFTP) soubor vyzvedl nebo uložil na SFTP server. Následný ingest do ERP je samostatný, nezávislý hook. Nastavte monitoring zvlášť pro každý hook přes HookSentError a HookSentRetry.
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.
Podívejte se na API dokumentaci