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.