Filtransport

Tjänsten Filtransport används för att hämta resultatfiler och lämna infiler. Detta kan även göras via kundapplikationen. Organisationscertifikat krävs vid filöverföring pgm-pgm. Information om XML-scheman och termbeskrivningar för filer som lämnas och hämtas i SPAR finns i menyn under fliken XML-scheman.

Version

Nuvarande version av Filtransport är v3. Den nås på följande URL: https://ext-filer.statenspersonadressregister.se/v3.

Lämna fil

Lämning av fil görs som HTTP POST med Content-Type “multipart/form-data”, enligt RFC 2388.

För korrekt hantering av stora filer, rekommenderas att alltid sätta HTTP-header “Transfer‑Encoding: chunked”. För mer info om krav på filnamn och komprimering av filer, se fliken Filer i menyn.

Vid problem av uppladdning av filer större än 4kB men inte filer som är mindre, pröva lägga till HTTP-header “Excpect: 100-continue”.

Utifrån den lämnade filen skapar SPAR en resultatfil som måste hämtas inom 60 dagar från det att filen skapades.

Verifiering av infil

När en infil lämnas in i SPAR-tjänsten verifieras att filen har rätt format i enlighet med XML-schemat. Det innebär dock inte att de personnummer som finns i filen ger träffar i SPAR, utan endast att de är korrekta på så sätt att de innehåller godkända siffror.

Begränsningar

Filer som lämnas i SPAR-tjänster via pgm-pgm får inte vara större än 100 Mbyte. Filer kan lämnas i zip-format. Alla utfiler levereras i zip-format.

Gränssnitt

För att integrera med tjänsten används HTTP POST, PUT samt GET med URL-parametrar och -värden, se fullständig gränssnittsbeskrivning i menyn under fliken Gränssnitt. Exempel på test av gränssnittet finns i menyn under fliken Testa Filtransport.

Information om gränssnittet för den äldre versionen Filtransport v2 finns i gränssnittsmanualen under fliken Äldre scheman.

Fråga

Ett exempel på en fråga med HTTP GET är:

ext-filer.statenspersonadressregister.se/v3/utfil/?filstatus=NY

där filstatus är URL-parameter och NY är URL-parametervärde.

Svar

Svar levereras i JSON-format och listar i det här exemplet de filer som aktören begärt uppgifter om:

{
    "utfiler": [
        {
            "uppdragId": "14584",
            "filnamn": "SPARAvisering_20200806170822_SPAR500001-14584.xml.zip",
            "status": "NY",
            "url": "/utfil/SPARAvisering_20200806170822_SPAR500001-14584.xml.zip",
            "skapadDatum": "2020-08-06"
        },
        {
            "uppdragId": "14584",
            "filnamn": "SPARAvisering_20200909104007_SPAR500001-14584.xml.zip",
            "status": "NY",
            "url": "/utfil/SPARAvisering_20200909104007_SPAR500001-14584.xml.zip",
            "skapadDatum": "2020-09-09"
        }
    ],
    "uuid": "a30c10dc-17a2-47e5-8d04-a1bb742a610f"
}