Niet elke integratie verloopt via een directe API-koppeling. Voor systemen die werken met bestandsuitwisseling biedt de PSB SFTP-integratie. De PSB haalt periodiek bestanden op van je SFTP-server (From SFTP) of plaatst ontvangen documenten op je SFTP-server (To SFTP). Beide flows worden geconfigureerd via SFTP-hooks.

Je kunt een SFTP-verbinding aanmaken via het platform onder Verbindingen > Nieuwe Algemene verbinding > SFTP Connector. De verbindingssleutels die je hier genereert heb je later nodig bij de hook-configuratie.

Met From SFTP haalt de PSB periodiek bestanden op van jouw SFTP-server en verwerkt ze als documenten. Dit is handig als je bronsysteem bestanden exporteert naar een map op een SFTP-server, bijvoorbeeld facturen in UBL- of XML-formaat.

From SFTP werkt met vijf mappen op je SFTP-server:

De PSB controleert standaard elke 15 minuten of er nieuwe bestanden in de readDirectory staan. Dit interval is configureerbaar.

Een From SFTP hook heeft de volgende action:

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

De hook moet ook een publishTopic bevatten dat aangeeft hoe de opgehaalde bestanden moeten worden verwerkt, bijvoorbeeld SendInvoice voor het verzenden van facturen. Naast het primaire publishTopic zijn ook de bijbehorende supporting topics vereist, zodat de hook bestanden naar de juiste statusmap kan verplaatsen:

Bestanden met een tussentijdse *Retry-status (bijv. InvoiceSentRetry) blijven in de pendingDirectory totdat een definitieve status volgt.

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

Bij elke poll controleert de PSB de readDirectory, verplaatst bestanden naar pending, verwerkt ze en plaatst ze daarna in success of error. Bestanden die al eerder zijn verwerkt, worden naar de duplicateDirectory verplaatst.

Met To SFTP plaatst de PSB ontvangen documenten automatisch op jouw SFTP-server. Dit is ideaal als je systeem bestanden uit een map verwerkt in plaats van via een API-webhook.

Bij To SFTP heb je alleen een inboxDirectory nodig:

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

Elk ontvangen document wordt als bestand in de inboxDirectory geplaatst. Je kunt optioneel een targetDocumentTypeId opgeven om documenten automatisch te laten transformeren naar een specifiek formaat voordat ze op de SFTP-server worden geplaatst.

Beide SFTP-flows gebruiken een MD5-fingerprint voor serververificatie. De fingerprint staat achter het #-teken in de hook-action en zorgt ervoor dat de PSB alleen verbinding maakt met de juiste SFTP-server. Dit voorkomt man-in-the-middle aanvallen.

Je vindt de MD5-fingerprint van je SFTP-server in de serverconfiguratie of door verbinding te maken via een SFTP-client. Het formaat is een reeks hexadecimale paren gescheiden door dubbele punten, bijvoorbeeld aa:bb:cc:dd:ee:ff:00:11:22:33:44:55:66:77:88:99.

Een SFTP-aflevering en een daaropvolgende ERP-ingestie (bijvoorbeeld To-SFTP richting Unit4 ERP CR) zijn twee losse, onafhankelijk werkende hooks -- geen enkele keten met één gedeelde status.

Een document dat in eConnect als "gedownload" staat, bevestigt dat de afleverende hook het bestand heeft opgehaald of geplaatst. Het zegt op zichzelf niets over of het ERP het bestand daarna succesvol heeft ingelezen.

Voor elke hook afzonderlijk is er monitoring via de topics HookSentError (definitief falen) en HookSentRetry (tussentijdse herpoging). Richt per hook een monitoring-actie in op deze topics via een mailhook of een secundaire webhook. Zo krijg je proactief een melding bij een mislukte aflevering of ingestie aan de betreffende kant.

Een organisatie die facturen verstuurt vanuit hun ERP-systeem en ontvangen facturen wil importeren:

1. Verzenden (From SFTP): het ERP-systeem exporteert UBL-facturen naar /sftp/outbox. De PSB haalt ze elke 15 minuten op en verstuurt ze via Peppol.
2. Ontvangen (To SFTP): de PSB plaatst ontvangen facturen in /sftp/inbox. Het ERP-systeem leest de map periodiek uit en importeert de documenten.

Beide flows draaien onafhankelijk van elkaar en kunnen afzonderlijk worden geconfigureerd.

SFTP-integratie wordt in de praktijk veel ingezet bij koppelingen met Unit4 ERP CR en ERP7, waar bestandsuitwisseling via een SFTP-map de standaardmethode is voor het uitwisselen van factuurdocumenten.

Zorg ervoor dat de SFTP-gebruiker schrijfrechten heeft op alle geconfigureerde mappen. De PSB moet bestanden kunnen verplaatsen tussen de mappen. Controleer ook of de firewall van je SFTP-server inkomende verbindingen toestaat vanaf de eConnect IP-adressen.

Het pull-interval van 15 minuten is standaard. Als je een korter of langer interval nodig hebt, neem dan contact op met TechSupport.

Meer weten over documentuitwisseling via de PSB? Bekijk het overzicht van multi-channel levering of lees hoe je webhooks instelt voor real-time notificaties.