|
Provider
|
eTax_webservice
|
|
Method
|
RequestETaxCardOnGER
|
|
Description
|
This webservice accepts requests for electronic tax cards.
TaxYear must be a future calender year open for requests
GER number must exist in eTax Employer register (page 60)
Any subsequent call on this GER number and TaxYear will overwrite any previous request
data completely.
A successful call to this webservice is no guarantee for that the taxpayers receive
an electronic tax card. It is just a proof of a successful web request.
|
|
Sample URL
|
https://aka.nanoq.gl/etax_webservice/ETaxCard.asmx?op=RequestETaxCardOnGER
|
|
Status
|
Released for production.
|
|
Input
|
|
|
Name
|
Type
|
Format
|
Allow Null
|
|
UserId
|
String
|
|
No
|
|
PassWord
|
String
|
|
No
|
|
TaxYear
|
String
|
4 digits e.g. 2012 or 2013. Only the next tax year is valid.
|
No
|
|
GER
|
String
|
8 digits E.g.
|
No
|
|
ETaxCardRequests
|
Array of ETaxCardRequest
|
Struct {
string CPR, // 10 digits,
string Department, // 10 alfa - employer_department
string EmployeeId, // 15 alfa - employers_employee_code
string Note // 50 alfa - employers_Employee_note
}
|
Only CPR is mandatory.
If department, employeeid or note is too long, the string will be truncated.
If a CPR number is provided more than once in the requests, subsequent occurances
are ignored.
|
|
|
|
|
|
|
Output
|
|
|
Name
|
Type
|
Format
|
Notes
|
|
RequestETaxCardOnGERResponse
|
RequestETaxCardOnGERResponse
|
Class {
ETaxCardRequest[] FailedRequests
string ResultMessage
//ResultMessage:
OK -> request received and accepted
INVALID_TAXYEAR -> the requested taxyear can't be accepted at this moment
INVALID_GERNR -> There is no employer with this GER number
}
|
A ResultMessage = OK does not indicate that all ETaxCardRequests were recorded.
FailedRequests contains all failed ETaxCardRequests and can contain none, some or
all of the original ETaxCardRequests.
Failed ETaxCardRequests are failed because the person is not recorded as a tax payer
in the requested tax year.
|
|
|
|
|
|
|
|
|
|
Exception Output
|
|
|
Type
|
Format
|
|
String
|
”Exception - ” + message
|
|
Test version
|
A test version of this web service can be found on the following url:
https://aka.nanoq.gl/etax_webservice/ETaxCard.asmx?op=RequestETaxCardOnGER_Test
Input for TaxYear should be next year.
Only GER nr. '12121212' is accepted.
Any CPR number is accepted.
Proper input for UserId, PassWord must be provided when calling this web method.
|