Att använda e-transport

Skicka och hämta filer manuellt

Logga in

1. Från e-transports startsida väljer du att logga in genom att klicka på "Klicka här för att logga in".

• ebi-minimikrav

Uppfylls inte kraven visas ett felmeddelande.

• ebi-felmeddelande

Din dator kopplas upp mot Skatteverkets säkra webbserver.

2. Du ombeds att "visa" ditt certifikat för att en krypterad, säker förbindelse ska kunna upprättas. Ditt person- eller organisationsnummer som ingår i certifikatet visar att du är behörig i e-transportsystemet.

Så här ser det ut i Internet Explorer:

3. Välj det certifikat som du ska logga in med och klicka OK.

Välja leveransmetod

Efter påloggning kommer du vidare till en sida som visar vilken leveransmetod som får användas.

• leveransmetod

 
Det finns två leveransmetoder:

• att hämta filer från Skatteverket
• att lämna filer till Skatteverket.

Leveransmetoden som finns tillgänglig beror på vilket avtal som skrivits mellan din organisation och Skatteverket. Om du är behörig att hämta filer visas knappen Hämta filer, och om du är behörig att lämna filer visas knappen Lämna filer. Om du har behörighet att lämna filer kan du även lista filer som redan lämnats in till Skatteverkets mottagningstjänst.

• Att lista lämnade filer

Hämta filer manuellt

1. Klicka på Hämta filer och följande fönster öppnas:
 

 
2. Välj den Produkt som du vill hämta — tillgängliga produkter finns i listbox.
3. Välj vilken kategori av filer som ska hanteras. Default är Nya filer angivet i fönstret, men du har möjlighet att välja Alla filer eller Raderade filer.
4. Välj sorteringsordning på filer som ska listas. Default är Datum sorteringsordning, men du kan välja att ange Från d.v.s. avsändare eller Storlek där den största filen anges först.
5. Klicka på Lista filer. Ett fönster med önskade filer öppnas. Saknas filer enligt valt alternativ visas enbart rubriker i fönstret.

Exempel vid val Nya filer — normal kund: 

 Exempel vid val Nya filer — kunder med beställningscertifikat (idag enbart kunder mot NAVET): 

6. I fönstren Nya filer för hämtning och Alla filer som finns för hämtning kan du göra valen

• hämta enstaka genom att klicka på filnamnet i kolumnen Hämta enstaka (t.ex. ascii-8bit.txt ) — eller
• hämta samtliga filer som ingår i ett "meddelande" genom att klicka på Hämta i kolumnen Hämta zip.

• Meddelande

I kolumnen Status visas om filen är ny eller om den redan har hämtats. Filer sparas i tre dagar efter att de har hämtats ut. Det gör det möjligt att hämta filer flera gånger om något skulle gå fel i överföring eller när filen sparas. Den tidpunkt då filen har tagits emot av Skatteverkets mottagningstjänst visas i kolumnen Datum.

Att spara filen

När du klickat på Hämta eller på filnamnet för den enstaka fil du vill hämta visas dialogrutan Filhämtning. 

Beroende av om du ska hämta en enstaka fil eller hämta zip visas olika dialogrutor med val om filen ska öppnas eller spara.  

1. Klicka på Spara eller Öppna.
2. I "Spara som"-dialogrutan väljer du var i ditt filsystem filen ska sparas. Ge filen, om du så vill, ett mer passande namn och klicka på Spara. 

3. Dialogfönstret Hämtningen är slutförd öppnas och du kan välja att öppna fil/mapp eller att stänga fönstret. 

4. Filen får nu status Hämtad i översiktsfönstret Filer för hämtning. 

Efter hämtningen hamnar du åter i Val av leveransmetod och kan du fortsätta att hämta/lämna filer. Någon kvittens på att hämtningen har gått bra lämnas inte. 

• Val av leveransmetod

Lämna filer manuellt

1. Klicka på Lämna filer. Du får upp en dialogruta där du kan välja för vilken produkt du vill lämna filer. 

2. Välj en produkt och klicka på Visa. 

3. Klicka på Bläddra för att få upp dialogrutan Välj filtyp.

Om listboxen Leta i: inte pekar mot rätt mapp/katalog för den fil  du ska lämna, leta efter rätt mapp och markera den fil som ska lämnas in. 

4. klicka på Öppna. Kontrollera att rätt fil är vald
5. Klicka på Skicka fil(er). Filen skickas nu till Skatteverkets mottagningstjänst. Hur lång tid överföringen tar är beroende av filens storlek och nätets kapacitet. 

När filen emottagits av Skatteverkets mottagningstjänst lämnas en kvittens.
Någon kontroll av att filen är korrekt görs inte. I kvittensen finns en meddelandeidentitet som du använder vid kontakt med Skatteverket. 

• meddelandeidentitet

6. Notera meddelandeidentiteten eller skriv ut sidan om du framöver behöver kontakta Skatteverket angående meddelandet.
7. Stäng Kvittens fönstret. Du kommer nu åter till Välj leveransmetod. 

• Leveransmetod

Lista lämnade filer

1. Klicka på Visa lämnade filer i fönstret Lämna fil(er). Följande dialogruta öppnas i nytt fönster: 

Förklaring till kolumnerna:

Meddelande id: meddelandets SHS-identitet
Produkt:Vad meddelandet är klassificerat som
Skapad: När meddelandet togs emot
Status: Vilken status meddelandet har fått i SHS-systemet (exempelvis "klar").

• "klar" innebär att filen mottagits av meddelandehanteringssystemet.
• "levererad" innebär att filen hämtats ut av verksamhetssystemet

Felmeddelande: Kortfattad beskrivning av eventuella fel.

2. Stäng fönstret genom att klicka på X i fönstrets övre högra hörn.

Filerna ligger kvar ca tre dagar efter att Skatteverkets mottagande verksamhetssystem hämtat ut filen. 

Lämna in och hämta filer med automatik

e-transport kan automatiseras med hjälp av ett kommandobaserat verktyg som stödjer http/https GET och POST samt SSL. Som ett exempel på en möjlig tredjeparts produkt använder vi cURL. cURL är en freeware, andra exempel på freeware är wget och pavuk.

Skatteverket tar inget ansvar för cURL eller någon annan av dessa produkter. Vid problem får användaren vända sig till leverantören.

Användarens certifikat måste bifogas som en parameter i klientanropet. Certifikat som används vid automatiserad hantering har ett annat format mot det som används vid manuell hantering. Information hur man går tillväga för att skapa ett certifikat för automatiserad överföring beskrivs senare i detta dokument.

• certifikat

Filer kan hämtas från och skickas till en bestämd produkt. Varje produkt har en unik identitet som måste anges vid anrop till e-transport. Produktidentiteten beställs från Skatteverket efter det att avtal tecknats.

Lämna in filer till e-transport med automatik

För att skicka filer till e-transport används HTTP PUT eller POST. Formaten för URL är:

Hämta filer med automatik från e-transport  

Generellt

För att hämta filer används HTTP GET. Formaten för URL är:

Transaktionsidentiteten är inte obligatorisk. Användarens certifikat måste bifogas som en parameter i klientanropet. Certifikatet som används vid automatiserad hantering har ett annat format mot det som används vid manuell hantering. Hur man skapar ett certifikat för automatiserad överföring beskrivs senare i detta dokument.

För att kunna hämta en fil eller snarare ett meddelande, som kan innehålla en eller flera filer, måste transaktionsidentiteten ingå i URL:en. Att hämta filer sker i två steg. I det första steget görs en fråga om det finns några filer att hämta för en specifik produkt. Svaret returnerar transaktionsidentiteter på separata rader. Varje transaktionsidentitet motsvarar ett meddelande som kan innehålla en eller flera filer.

Exempel när cURL används:

Win32-miljö

I win32-miljö kan man hämta filer med automatik på olika sätt. Ex. via bat-filer, VB-skript eller via programmering. Vi ger endast exempel på lösning via bat-filer.

Exempel på bat-fil i win32-miljö som använder cURL och hämtar samtliga filer:

Hämta filer med original filnamn

Det kan ibland finnas behov av att behålla originalfilnamnet i samband med hämtning av filer från Skatteverket. Nedan beskrivs hur man gör för att hämta filerna där filnamnet bibehålls. 

Exempel när cURL används:

Använda metainformation för att selektera hämtning av filer

Det kan finnas önskemål att selektera uttaget och inte hämta alla filer för en viss produkt. Detta kan ex. röra sig om olika förvaltningar inom en kommun som ska hämta olika filer för samma produkt eller olika avdelningar inom ett företag.

Skatteverkets olika verksamhetssystem har möjlighet att bifoga metainformation tillsammans med själva filerna. Denna metainformation kan användas för att selektera uttaget i samband med listningen som görs för att se vilka filer som finns att hämta. Om ni ser att det finns behov att använda metainformation, tag i så fall kontakt med er kontaktperson hos Skatteverket.

Exempel när cURL används och metainformation används för att selektera hämtningen

Certifikathantering

Certifikat utfärdas av en extern godkänd part, certifikatutfärdare (CA), till exempel Expisoft AB Länk till annan webbplats., i ett format för att installeras i en webbläsare t.ex. .p12, .pfx. För att få dem att fungera med cURL eller annan programvara för automatik måste certifikaten göras om till ett annat format s.k. PEM-format.

För att göra denna omvandling behövs en tredjeparts produkt till exempel openssl. Denna kan hämtas hem antingen från www.openssl.org Länk till annan webbplats, öppnas i nytt fönster. eller andra webbplatser ex. https://curl.se Länk till annan webbplats. som färdiga exekverbara paket för olika operativsystem eller som källkod vilken då måste kompileras i kundens miljö.

För att bryta isär en .p12-fil till ett certifikat och en privat nyckel ska följande kommando köras:

Exempel på verktyg med länk till webbplats

cURL - curl.haxx.se Länk till annan webbplats, öppnas i nytt fönster.
wget - www.gnu.org Länk till annan webbplats, öppnas i nytt fönster.
pavuk - www.pavuk.org Länk till annan webbplats, öppnas i nytt fönster.
webMethods - www.webmethods.com Länk till annan webbplats, öppnas i nytt fönster.