nanoq Nanoq

DRAFT SPEC: CustomerBalanceService

Provider

Accounting System

Method

RetrieveCustomerBalance

Description

This method is intended for use by Arbejdsgiver Registret (AR) to query the accounting system about individual (CPR) Tax payable balance..

Production URL: Prisme

Under development.

Production URL: XAL

Not applicable.

Test URL: Prisme

http://test.erp.gl/CustomerBalance/CustomerBalanceService.svc

Test URL: XAL

Not applicable.

Input

RestSkatRequest object. This object has 2 properties: a Credentials object consisting of a username and password, and an array of FUJCalculateBalanceInputContract objects, which consist of:

  • CPRnumber
  • TaxYear
  • DueMonth
  • DueYear

Name

Type

Format

Allow Null

Username

String

 

No

Password

String

 

No

CPRNumber

string

No

TaxYear

Integer

No

DueMonth

Integer

Optional filter

Yes

DueYear

Integer

Optional filter

Yes

Output

RetrieveCustomerBalanceResponse object. This object has one property, an array of CustomerBalanceReceipt objects, which consist of a CPR Number, a balance statement and an Error object. Error objects have 2 properties, an ErrorType and a Message.

Name

Type

Format

Notes

CPRNumber

String

10 characters

Individual CPR number

Amount

Integer

Remaining deficit tax owed by the individual

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.

 
 

 
 

© Copyright KIMIK iT A/S