Webservice (REST API)

Webservice (REST API) til test kan tilgås på:

https://api.tse3pindberet.tfe.skat.dk/

https://in.s3.tse3pindberet.tfe.skat.dk/

https://out.s3.tse3pindberet.tfe.skat.dk/

Kom godt i gang med brug af Webservice (REST API) via referenceklienten:

https://github.com/skat/geni-reference-groovy

Læs mere om udviklerværktøjet referenceklienten i afsnit 2.2.

Webservice på TFE virker på samme måde, som i produktion. I kan se mere under afsnit 2.3.

FTPS Gateway

FTPS Gateway bliver i år opgraderet og derfor vil der være nogle ændringer i den forbindelse. Den nye FTPS Gateway er allerede implementeret i forbindelse med indberetning til TFE.

Ændring af port er sket til følgende:

Tidligere FTPS Gateway TFE (skal ikke anvendes mere)

Den nye FTPS Gateway TFE 

IP address of the FTP Gateway server

secureftpgatewaytest.skat.dk

secureftpgatewaytest.skat.dk

Port number on the Gateway server for inbound FTP connections

6371

6381

Port range on the Gateway server for inbound FTP data connections

35000 - 35100

36000-36100

Login

Any username/password or anonymous

Any username/password

Certificate:

Use a valid OCES certificate; either personal, employee or Company

Use a valid OCES certificate; either personal, employee or Company

Tilkobling kræver både et OCES certifikat og brugernavn/kode. Brugernavnet er en sammensætning af CVR-nummer og enten RID- eller UID-værdien i OCESII-certifikatet:

Virksomhedscertifikater (VOCES): CVR_xxxxxxxx_UID_yyyy…y

Medarbejdercertifikater (MOCES): CVR_xxxxxxxx_RID_yyyy…y

Eksempel: CVR_19552101_RID_60134540 

Den nye FTPS Gateway er som udgangspunkt funktionelt uændret, men de skærpede krav omkring sikkerhed betyder, at der kræves mindre ændringer i jeres system som følger: 

  • FPTS-protokol understøtter nu kun TLS 1.2

  • FTPS-adgang kræver ud over certifikat en identificering med brugernavn og brugerkode

  • FTPS-adgang ser via ny port 6381

  • Det er ikke længere muligt at dele udbakke (/out) imellem flere certifikater (med samme CVR-nummer)

  • Indbakke struktur - I vil kun se de foldere, som afspejler de aktuelle tilladelser (grupper/roller), som er gældende for OCES-certifikatet

  • Indsendte filer skal være unikt navngivet (filnavn som tidligere er indsendt afvises)

  • Certifikater skal forhåndsregistreres, dette løses dog indtil videre ved automatisk replikering fra den gamle FTPS-løsning 

Den nye FTPS Gateway forsøger specifikt af afhjælpe de driftsmæssige uhensigtsmæssigheder, som kunne opleves i den nuværende FTPS Gateway. Grupper/roller i det centrale sikkerhedssystem replikeres jævnligt (hver time) og evt. udfald af forbindelse påvirker ikke driften. 

Udfald af forbindelsen til backend systemer påvirker ikke driften, udover at levering af filer til backend systemer bliver midlertidigt udsat, hvilket også bevirker status _1/_2 filer bliver midlertidigt udsat. Der sendes således ikke status_0 filer, hvis backend system ikke er  tilgængeligt eller hvis filen ikke er behandlet indenfor 6 timer. 

I kan teste nu i TFE. 

I kan finde mere information i vejledning på www.skat.dk/ekapital under Sådan indberetter du. I kan f.eks. læse om hvordan I finder brugernavn og brugerkode og hvilke fejltekster der udgår.  

 

FTPs gatewayen på TFE virker på samme måde, som i produktion. I kan se mere under afsnit 3.2