EDI – Stöd under utvecklingsfasen
På denna sida läggs kontinuerligt ut information som kan vara till hjälp för företag och systemleverantörer som utvecklar EDI-system.
Att tänka på vid utveckling av EDI-system
Systemet som ditt företag utvecklar ska ha den funktionalitet som behövs för att kunna lämna korrekta uppgifter till Tullverket. Till exempel:
- aggregera varuposter
- hantera reservrutiner i systemet
- ge en överblick över "påbörjade – ej avslutade" ärenden
- beräkna till exempel tullvärde och statistiskt värde korrekt
- säkerställa att informationen som visas när meddelandet signeras verkligen är det som skickas till Tullverket
- tydligt se skillnad på samt kunna skicka och ta emot testärenden respektive produktionsärenden, till exempel en testindikator.
- hantera utväxlingsloggar, dvs. meddelandelogg (arkiv), kommunikationslogg och överföringslogg
- enkelt förstå status på ärenden och felkoder så att de som köper systemet enkelt kan förklara sina problem vid eventuell kontakt med it-stöd
- använda begrepp som Tullverket använder i de tekniska specifikationerna och deklarationshandledningarna.
Läsanvisning för tekniska specifikationer
Tekniska specifikationer beskriver vad EDI-meddelanden ska innehålla och hur de ska vara uppbyggda. Systemet som ditt företag utvecklar ska följa Tullverkets tekniska specifikationer.
Börja med att ta del av specifikationerna för
- Kuvertspecifikation (SCTS-ENV)
- Svarsmeddelandespecifikation (SCTS-RESP)
- Kodlistor (SCTS-CL)
- Riktlinjer för säkerhet
- Riktlinjer för EDI-kommunikation
- Teknisk specifikation för aktuella tullprocedurer och parallellt med specifikationerna tar du även del av deklarationshandledning för aktuellt meddelande.
EDI – Säkerhet
Tullverket använder ett PKI-baserat säkerhetskoncept för det elektroniska informationsutbytet via EDI. Systemet som utvecklas ska uppfylla säkerhetsvillkoren enligt framtagna riktlinjer.
EDI – Kommunikation
Tullverket tillhandahåller i dagsläget möjligheten att lämna uppgifter elektroniskt via OFTP2 över TLS. För att lämna uppgifter via OFTP2 används Internet. Ert system ska följa RFC5024 som beskriver protokollet för OFTP version 2.
Deklarationshandledningar
Deklarationshandledningarna använder du som komplement till de tekniska specifikationerna för aktuellt meddelande.
Referensdata fildistribution
Denna tjänst ger dig möjlighet att ladda hem aktuella kodlistor för att använda i ditt företags system. Många koder innehåller både svenska och engelska beskrivningar, och vissa koder innehåller ett av språken.
Referensdata söksystem
I den här tjänsten kan du söka information om koder som du behöver i tullhanteringen. Tjänsten finns både på svenska och engelska.
Tulltaxan fildistribution
Tullverkets centrala databas för Tulltaxan uppdateras varje natt med uppgifter direkt från EU-kommissionen. Du som är prenumerant av Tulltaxan fildistribution kan hämta ändringar själv via internet och på så sätt hålla ditt eget system uppdaterat.
Teknisk dokumentation finns här:
Utväxlingsloggar
EDI-systemet bör ha utväxlingsloggar, dvs. meddelandelogg (arkiv), kommunikationslogg och överföringslogg. Dessa bör av praktiska och juridiska skäl vara åtkomliga under överenskommen tid. Dessa funktioner och loggar är nödvändiga för att Tullverket vid eventuella fel eller driftstörningar ska kunna ge stöd i felsökning.
Utväxlingsloggar:
- En meddelandelogg avser ett arkiv av vilka meddelanden som skickats och tagits emot.
- En kommunikationslogg ska innehålla information som gör att man kan spåra de virtuella filerna (OFTP) och kommunikationskvittenserna samt eventuella OFTP-felkoder som utväxlats.
- En överföringslogg bör innehålla uppgifter om Avsändare, Mottagare, Datum, Tid, Meddelandetyp, Överföringsreferens/MessageId och Status.
Koppling mellan Överföringsreferens/MessageId och virtuellt filnamn (OFTP) bör finnas, till exempel i överföringsloggen, så att det går att koppla ihop poster i meddelandeloggen med händelser i kommunikationsloggen (vad sändes när).
Lokalt referensnummer (LRN), LRN-serie
LRN
Alla elektroniska meddelanden (deklarationer eller anmälningar) som skickas till Tullverket ska ges ett LRN (Lokalt Referensnummer). Detta LRN ska vara unikt (samma LRN ska inte användas i olika meddelandeflöden). LRN används som referensnummer för meddelandet till dess Tullverket accepterat uppgifterna i meddelandet och tilldelat ett MRN (Master Reference Number).
LRN uppges som referens om du t.ex. kontaktar Tullverkets it-support och vill fråga om en deklaration eller anmälan som ännu inte fått ett MRN. Det kan även vara bra att ha LRN tillhands vid kontakter med TullSvar eller personal vid tullklareringsexpeditioner.
Formatkrav
EU-lagstiftningen föreskriver att LRN ska användas av samtliga medlemsstater vid informationsutbyte med näringslivet. Däremot är det upp till varje medlemsstat att bestämma vilket format LRN ska ha. I Sverige har vi valt att använda ett bestämt format för LRN som inleds med en bokstavskombination (LRN-serie) och följs av ett löpnummer och en checksiffra, enligt formatet XYZ000001C (C = checksiffra). Undantaget är i NCTS (Transit) där landskod och årtal inleder LRN och därefter samma format som för övriga meddelandeflöden.
Hur det unika LRN sätts samman och hur dess checksiffra beräknas Pdf, 226.6 kB.
Tilldelning av LRN-serie
När ett företag får sin EDI-registrering beviljad av Tullverket blir företaget även tilldelad en LRN-serie. Denna serie inleds av två eller tre bokstäver och ska användas för att generera LRN som sedan ska anges på deklarationer och anmälningar som skickas till Tullverket. Det går att ansöka om fler LRN-serier om behov finns. När befintlig LRN-serie börjar ta slut bör företaget i god tid ansöka om en ny serie.
Tullverkets företagstestmiljö
Tullverket erbjuder en företagstestmiljö där ditt företag kan testa EDI-meddelanden med eget testdata. Testmiljön är tillgänglig dygnet runt och utan tidsbegränsning. Här finns allmän information om testuppgifter och begränsningar i företagstestmiljön för både systemutvecklare och uppgiftslämnare.
Testindikator
För att kunna styra ifall ett specifikt EDI-meddelande ska till Tullverkets produktionsmiljö eller företagstestmiljö måste testindikator användas på korrekt sätt. Även vid mottag av meddelanden måste systemet ta hänsyn till testindikator så ingen sammanblandning kan ske. Utelämnad testindikator eller värdet ”0” innebär produktionsmiljö. Övriga giltiga värden innebär företagstestmiljö (för närvarande används enbart värdet ”1”). För mer information se aktuell teknisk specifikation.
Det finns fördelar med att ni utvecklar system som kan hantera test och produktion på samma EDI-anslutning.
Stöd vid felsökning
Tullverket kan ge stöd i tullspecifika tekniska frågor, i övrigt utgår vi från att ditt företag har kunskaper i till exempel meddelandeformat och kommunikationsprotokoll samt de tekniska lösningarna som används för kommunikation och säkerhet.
Om ditt företag har behov av stöd vid felsökning förväntar vi oss att
- ni utser en kontaktperson för testprocessen som samordnar er kontakt med EDI-testfunktionen
- ni, vid behov, kan tillhandahålla en beskrivning av till exempel systemkonfiguration och kommunikationslösning för systemet
- systemet har utväxlingsloggar
- ni använder begrepp som Tullverket använder i de tekniska specifikationerna och deklarationshandledningarna.
På gång inom tullområdet
Omställning pågår till en helt digitaliserad tullhantering. Det innebär att dagens EDI-system behöver anpassas och investeringar behövs i ett nytt systemstöd.