Provider
|
Accounting System
|
Method
|
SubmitFees
|
Description
|
This method is intended for use by Arbejdsgiver Registret (AR) to submit fees to the accounting system for Posting (Bogføring).
|
Production URL: Prisme
|
Under development.
|
Production URL: XAL
|
https://services.sulinal.nanoq.gl/MonthlyTaxReportService.asmx
|
Test URL: Prisme
|
Under development.
|
Test URL: XAL
|
Not applicable.
|
Input
|
SubmitFeesRequest object. This object has 2 properties: a Credentials object consisting of a username and password, and an array of Fee objects, which consist of:
- FeeId
- GERnumber
- Year
- Month
- FeeAmount
- ApprovedDate - new for Prisme
|
Name
|
Type
|
Format
|
Allow Null
|
Username
|
String
|
|
No
|
Password
|
String
|
|
No
|
FeeId
|
String
|
36 character GUID
|
No
|
GERnumber
|
String
|
Unique identifier of the employer from the Greenlandic Employer Registry
|
No
|
Year
|
4 digit number
|
The year for which the fee applies
|
No
|
Month
|
2 digit number
|
The month for which the fee applies
|
No
|
FeeAmount
|
Whole number
|
The amount in DKK of the fee
|
No
|
ApprovedDate
|
Date
|
The date on which the Fee was approved for posting by a Tax worker.
|
No
|
Output
|
SubmitFeesResponse object. This object has one property, an array of FeeReceipt objects,
which consist of a FeeId, a Status, and an Error object. Error objects have 2 properties,
an ErrorType and a Message.
For each receipt, AR first checks if the Status is Error. If so, the submission of the fee with the associated FeeId
is understood to have failed, and will be processed accordingly.
If Status is not Error, the fee with the associated FeeId is updated in AR
with the Status contained in the FeeReceipt.
|
Name
|
Type
|
Format
|
Notes
|
FeeId
|
String
|
36 character GUID.
|
Unique identifier of the Fee in AR.
|
Status
|
String
|
Enum - Error, Received, Posted or RolledBack.
|
- Error: Submission failed and the error should be handled based on Error.ErrorType.
- Received: The accounting system acknowleges receipt of the fee, but it has not been Posted/rolled back yet.
- Posted: The fee is posted in the accounting system.
- RolledBack: The monthly report is rolled back in the accounting system (not applicable to SubmitFees).
|
ErrorType
|
String
|
Enum - InvalidOrNoEntity, InvalidValue or ServiceUnavailable
|
- InvalidOrNoEntity: The submitted object is not recognized as a Fee.
- InvalidValue: The submitted Fee has invalid values.
- ServiceUnavailable: A 'catch-all' error indicating a system error in the accounting system.
|
Message
|
String
|
|
An optional message containing information about the error.
|
|
|
Method
|
RollBackFees
|
Description
|
This method is intended for use by Arbejdsgiver Registret (AR) to roll back (tilbageføre) fees in the accounting system.
Remark: This method is under development, therefore this specification is subject to change.
|
Production URL: Prisme
|
Under development.
|
Production URL: XAL
|
https://services.sulinal.nanoq.gl/MonthlyTaxReportService.asmx
|
Test URL: Prisme
|
Under development.
|
Test URL: XAL
|
Not applicable.
|
Input
|
RollBackFeesRequest object. This object has 2 properties: a Credentials object consisting of a username and password,
and an array of FeeId strings.
|
Name
|
Type
|
Format
|
Allow Null
|
Username
|
String
|
|
No
|
Password
|
String
|
|
No
|
FeeId
|
String
|
36 character GUID
|
No
|
Output
|
RollBackFeeResponse object. This object has one property, an array of FeeRollBackReceipt objects,
which consist of a FeeId, a Status, and an Error object. Error objects have 2 properties,
an ErrorType and a Message.
For each receipt, AR first checks if the Status is Error. If so, the rollback of the fee with the associated FeeId
is understood to have failed, and will be processed accordingly.
If Status is not Error, the monthly report with the associated MonthlyTaxReportId is updated in AR
with the Status contained in the MonthlyTaxReportReceipt.
|
Name
|
Type
|
Format
|
Notes
|
FeeId
|
String
|
36 character GUID.
|
Unique identifier of the Fee in AR.
|
Status
|
String
|
Enum - Error, Received, Posted or RolledBack.
|
- Error: Submission failed and the error should be handled based on Error.ErrorType.
- Received: The accounting system acknowleges receipt of the FeeId, but it has not been Posted/rolled back yet.
- Posted: The fee is posted in the accounting system (not applicanle to rollback).
- RolledBack: The fee is rolled back in the accounting system.
|
ErrorType
|
String
|
Enum - InvalidOrNoEntity, InvalidValue or ServiceUnavailable
|
- InvalidOrNoEntity: The submitted FeeId is not recognized as a Fee.
- InvalidValue: The submitted Fee has invalid values (not applicanle to rollback).
- ServiceUnavailable: A 'catch-all' error indicating a system error in the accounting system.
|
Message
|
String
|
|
An optional message containing information about the error.
|
|
|
If fees (or rollbacks) are submitted and the sender never gets the response, the sender will natually want to send theese again since the sender have no valid proof that they were received. Therefore if fees are sent again and these already have been received, the methods will not return with an error response, but instead return with a received response, but will not create them - since they already are created.