Standard SFTP-fildropoff och filhämtning

Den här guiden beskriver det standardiserade arbetsflödet för att leverera datafiler till Amili och hämta rapportfiler via SFTP.

Alla SFTP-konton använder SSH-nyckelparautentisering som standard. Dina SFTP-uppgifter (host, port och username) tillhandahålls av Amili när ditt konto konfigureras.

Innehållsförteckning

• Autentisering — Generera ett nyckelpar och registrera din publika nyckel
• Ansluta till SFTP-servern — Testa din anslutning
• Fildropoff — Ladda upp indatafiler för bearbetning
• Filhämtning — Ladda ner och kvittera rapportfiler

Autentisering

SFTP-autentisering sker med ett SSH-nyckelpar. Du genererar nyckelparet och tillhandahåller din publika nyckel till Amili, som registrerar den på ditt konto. Din privata nyckel stannar på ditt system och delas aldrig.

Generera ett nyckelpar

ssh-keygen -t ed25519 -C "din-beskrivning" -f ~/.ssh/amili_sftp

Detta skapar två filer:

• ~/.ssh/amili_sftp — din privata nyckel (håll denna hemlig, dela den aldrig)
• ~/.ssh/amili_sftp.pub — din publika nyckel (skicka denna till Amili)

Registrera din publika nyckel

Skicka innehållet i ~/.ssh/amili_sftp.pub till Amili. Amili registrerar den på ditt konto, varefter du kan ansluta med din privata nyckel.

Ansluta till SFTP-servern

Dina SFTP-uppgifter är:

Inställning	Värde
Host	sftp.amili.se
Port	22
Username	Ditt borgenärsnummer (t.ex. 2001234)
Auth	SSH privat nyckel (~/.ssh/amili_sftp)

Du kan verifiera din anslutning med kommandot sftp:

sftp -i ~/.ssh/amili_sftp <username>@sftp.amili.se

Fildropoff

Ladda upp dina indatafiler till mappen input/ på SFTP-servern. Amilis importjobb övervakar den här mappen och bearbetar filer automatiskt när en uppladdning slutförts.

Exempel

sftp -i ~/.ssh/amili_sftp <username>@sftp.amili.se <<'EOF'
cd input
put /lokal/sökväg/fakturor-2026-04-10.xml
EOF

---

Filhämtning

Amili placerar rapport- och utdatafiler i mappen pickup/. Du har läs- och raderingsåtkomst till den här mappen.

Rekommenderat implementationsmönster

I en automatiserad integration bör filhämtning implementeras enligt följande:

1. Lista alla filer i pickup/
2. För varje fil: ladda ner den, verifiera att nedladdningen lyckades, ta sedan bort den från servern
3. Ta aldrig bort en fil innan du har bekräftat att nedladdningen lyckades

Detta säkerställer att inga filer går förlorade om en överföring avbryts mitt i körningen.

Exempel

# Lista tillgängliga filer
sftp -i ~/.ssh/amili_sftp <username>@sftp.amili.se <<'EOF'
ls pickup/
EOF

# Ladda ner en specifik fil och ta bort den efter hämtning
sftp -i ~/.ssh/amili_sftp <username>@sftp.amili.se <<'EOF'
get pickup/rapport-2026-04-10.xml /lokal/sökväg/rapport-2026-04-10.xml
rm pickup/rapport-2026-04-10.xml
EOF