|
Provider
|
Accounting System
|
|
Method
|
SubmitMonthlyTaxReports
|
|
Description
|
This method is intended for use by Arbejdsgiver Registret (AR) to submit monthly tax reports 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
|
SubmitMonthlyTaxReportRequest object. This object has 2 properties: a Credentials object consisting of a username and password, and an array of MonthlyTaxReport objects, which consist of:
- MonthlyTaxReportId
- GERnumber
- MunicipalityCode
- Year
- Month
- IsEstimate
- Aincome
- Atax
- AMA
- PensionIncome
- PensionTax
- CatchSaleIncome
- CatchSaleTax
|
|
Name
|
Type
|
Format
|
Allow Null
|
|
Username
|
String
|
|
No
|
|
Password
|
String
|
|
No
|
|
MonthlyTaxReportId
|
String
|
36 character GUID
|
No
|
|
GERnumber
|
String
|
Unique identifier of the employer from the Greenlandic Employer Registry
|
No
|
|
MunicipalityCode |
String |
The municipality code from CVR |
No |
|
Year
|
4 digit number
|
The year for which the tax report applies
|
No
|
|
Month
|
2 digit number
|
The month for which the tax report applies
|
No
|
|
IsEstimate
|
Boolean
|
Indicates that this report is an estimate, i.e. not a formal submission by the employer
|
No
|
|
Aincome
|
Whole number
|
|
Yes
|
|
Atax
|
Whole number
|
|
Yes
|
|
AMA
|
Whole number
|
|
Yes
|
|
PensionIncome
|
Whole number
|
|
Yes
|
|
PensionTax
|
Whole number
|
|
Yes
|
|
CatchSaleIncome
|
Whole number
|
|
Yes
|
|
CatchSaleTax
|
Whole number
|
|
Yes
|
|
Output
|
SubmitMonthlyTaxReportsResponse object. This object has one property, an array of MonthlyTaxReportReceipt objects,
which consist of a MonthlyTaxReportId, 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 monthly report with the associated MonthlyTaxReportId
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
|
|
MonthlyTaxReportId
|
String
|
36 character GUID.
|
Unique identifier of the MonthlyTaxReport 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 monthly report, but it has not been Posted/rolled back yet.
- Posted: The monthly report is posted in the accounting system.
- RolledBack: The monthly report is rolled back in the accounting system.
|
|
ErrorType
|
String
|
Enum - InvalidOrNoEntity, InvalidValue or ServiceUnavailable
|
- InvalidOrNoEntity: The submitted object is not recognized as a MonthlyTaxReport.
- InvalidValue: The submitted MonthlyTaxReport 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
|
RollBackMonthlyTaxReports
|
|
Description
|
This method is intended for use by Arbejdsgiver Registret (AR) to roll back (tilbageføre) monthly tax reports to the accounting system. Both estimtes and non-estimates can be rolled back.
|
|
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
|
RollBackMonthlyTaxReportRequest object. This object has 2 properties: a Credentials object consisting of a username and password,
and an array of MonthlyTaxReportId strings.
|
|
Name
|
Type
|
Format
|
Allow Null
|
|
Username
|
String
|
|
No
|
|
Password
|
String
|
|
No
|
|
MonthlyTaxReportId
|
String
|
36 character GUID
|
No
|
|
Output
|
RollBackMonthlyTaxReportsResponse object. This object has one property, an array of MonthlyTaxReportRollBackReceipt objects,
which consist of a MonthlyTaxReportId, 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 monthly report with the associated MonthlyTaxReportId
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
|
|
MonthlyTaxReportId
|
String
|
36 character GUID.
|
Unique identifier of the MonthlyTaxReport 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 MonthlyTaxReportId, but it has not been Posted/rolled back yet.
- Posted: The monthly report is posted in the accounting system (not applicanle to rollback).
- RolledBack: The monthly report is rolled back in the accounting system.
|
|
ErrorType
|
String
|
Enum - InvalidOrNoEntity, InvalidValue or ServiceUnavailable
|
- InvalidOrNoEntity: The submitted MonthlyTaxReportId is not recognized as a MonthlyTaxReport.
- InvalidValue: The submitted MonthlyTaxReport 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.
|
|
|
|
|
Method
|
InitiatePaymentStatusRequest
|
|
Description
|
This method is intended for use by Arbejdsgiver Registret (AR) to query the accounting system as to whether the taxes on a given report have been fully paid by the employer. Reports that have not been paid ar flagged in the accounting system for followup via MonthlyTaxReportCallbackService.ReportFullyPaid() upn payment.
|
|
Production URL: Prisme
|
Not Implemented
|
|
Production URL: XAL
|
https://services.sulinal.nanoq.gl/MonthlyTaxReportService.asmx
|
|
Test URL: Prisme
|
Not Implemented
|
|
Test URL: XAL
|
https://testservices.sulinal.nanoq.gl/MonthlyTaxReportService.asmx
|
|
Input
|
A Credentials object consisting of a username and password,
and an array of MonthlyTaxReportId strings.
|
|
Name
|
Type
|
Format
|
Allow Null
|
|
Username
|
String
|
|
No
|
|
Password
|
String
|
|
No
|
|
guids
|
String[]
|
36 character GUID array
|
No
|
|
Output
|
PaymentStatusResponse object. This object has two properties, an optional Error object and an array of PaymentStatus objects,
which consist of a MonthlyTaxReportGuid and Paid boolean (is/is not fully paid). |
|
Name
|
Type
|
Format
|
Notes
|
|
MonthlyTaxReportGuid
|
String
|
36 character GUID.
|
Unique identifier of the MonthlyTaxReport in AR.
|
|
Paid
|
Boolean
|
|
If true, the report is fully paid by the employer. If false, report is not paid AND the accounting system flags the report for asynchronous follow-up.
|
|
ErrorType
|
String
|
Enum - InvalidOrNoEntity, InvalidValue or ServiceUnavailable
|
- InvalidOrNoEntity: The submitted MonthlyTaxReportId is not recognized as a MonthlyTaxReport.
- InvalidValue: The submitted MonthlyTaxReport 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 monthly reports (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 monthly reports 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.