Create a Claim

Path

POST /claims

Request Body

application/json

object

Contains all the customer data. Multiple customers can be provided.

customerNumber

string

Max length: 40

This is the identifier of the customer. Provided by the client.

clientId

string

Max length: 16

This is the identifier of the client. If a client has multiple business lines, this field can be used for the separation of business lines.

identificationNumber

string

Max length: 128

This is the social security number of the customer or company registration number, when the customer is a company.

title

string

Max length: 32

This is the title of the customer. It will likely be used in mails or letters.

gender

string

Max length: 20

Enum:

MALE

FEMALE

DIVERSE

This is the gender of the customer. * `MALE` - The customer's gender is male. * `FEMALE` - The customer's gender is female. * `DIVERSE` - The customer's gender is diverse. * `null` - The customer's gender is unknown.

firstName

string

Max length: 128

This is for the first name(s) of the customer, separated by either dashes or spaces.

lastName

string

Max length: 256

This is for the last name(s) of the customer, separated by either dashes or spaces.

companyName

string

Max length: 256

This is the company name of the customer, separated by either dashes or spaces.

dateOfBirth

string

yyyy-MM-dd

Max length: 10

This is the date of birth of the customer. It is needed for legal checks, eg. is the customer underaged.

type

string

Max length: 20

Enum:

PRIVATE

COMPANY

Represents the type of a customer. * `PRIVATE` - The customer is a private individual. * `COMPANY` - The customer is a company.

preferredLanguage

string

Max length: 2

This is the language in which the customer wants to be contacted, according to ISO 3166-1 alpha 2.

dateOfDeath

string

yyyy-MM-dd

Max length: 10

This is the date of death of the customer.

array

These are the addresses of the customer and his/her further contact persons.

array

List of contact channels of the customer.

array

List of bank accounts of the customer

array

Contains all known contacts needed for the collection process.

firstName

string

Max length: 128

This is for the first name(s) of the contact, separated by either dashes or spaces.

lastName

string

Max length: 256

This is for the last name(s) of the contact, separated by either dashes or spaces.

type

string

Max length: 20

Enum:

SPOUSE

GENERAL_PARTNER

LAWYER

LEGAL_GUARDIAN

MANAGING_DIRECTOR

EMPLOYEE

INSOLVENCY_ADMINISTRATOR

GARNISHEE

BAILIFF

GUARANTOR

The type represents the relationship between contact and custome.

liable

boolean

Max length: 5

This indicates whether a person is liable or not. In this way, non-liable persons such as lawyers or keepers can also be handed over.

object

An address of a contact or customer.

array

List of contact channeles of the contact.

array

List of contracts including invoives as base for the claims

contractNumber

string

Max length: 40

A client-assigned contract number associated with this claim. There may be several claims for the same contract number. If no contract number is available the invoice number or customer number could be used based on your business

description

string

Max length: 256

The description of the contract.

category

string

Max length: 128

This field can be used to group claims at the contract level (from the company's point of view).

startDate

string

yyyy-MM-dd

Max length: 10

The date when the contract has been created.

endDate

string

yyyy-MM-dd

Max length: 10

The date when the contract has been terminated.

array

Contains all the invoices. Multiple invoices can be provided.

invoiceNumber

string

Max length: 40

The invoice number assigned by the client for each invoice.

referenceNumber

string

Max length: 40

Can be used to specify an additional reference number. For example, if the accounting system prints a different document number than the invoice number on the invoice for teh customer.

invoiceDate

string

yyyy-MM-dd

Max length: 10

The invoice date represents the specific date on which the invoice was created or issued and indicates the time on which the claim arose.

remainingAmount

number

Max length: 12

This is the outstanding amount of the principal claim which needs to be collected by the Debt Collection Agency. A positive amount indicates a claim against the debtor. Negative amounts or 0 amounts are not allowed.

originalAmount

number

Max length: 12

This is the original amount of the principal claim. A positive amount indicates a claim against the debtor. Negative amounts or 0 amounts are not allowed.

taxRate

number

Max length: 12

The tax rate that was used.

currency

string

Max length: 3

This reflects all relevant currencies in ISO-4217.

dueDate

string

yyyy-MM-dd

Max length: 10

The original due date of the claim.

placementDate

string

yyyy-MM-dd

Max length: 10

The date when the client sent the claim to the debt collection agency.

object

Costs are occuring debts to pay by the customer.

dunningDate

string

yyyy-MM-dd

Max length: 10

The date when the first dunning was sent to the debtor.

secondDunningDate

string

yyyy-MM-dd

Max length: 10

The date when the second dunning was sent to the debtor.

legalBase

string

Max length: 40

This is a German specific requirement. Depending on the legalBase ("Ursprungsgeschäftsart") the period of sending a case to court differs. Please discuss possibilities with German collection team. The default value is an empty field.

description

string

Max length: 256

This is a free text field, which can be used to describe the claim in more detail or to provide further information.

disputed

boolean

Max length: 5

This field can be used to mark a claim as disputed by the client. The default value is "false".

array

A list of addtional properties, which belongs to the invoice.

array

A list of addtional properties, which belongs to the contract/claim.

object

This objekt provides fields for the industry utilities on teh contract level.

energy

string

Max length: 20

the energy type that is the subject of the contract

consumptionStartDate

string

yyyy-MM-dd

Max length: 10

date on which consumption began

consumptionEndDate

string

yyyy-MM-dd

Max length: 10

date on which consumption ended

object

meterNumber

string

Max length: 50

meter number belonging to the contract

isDisconnected

boolean

Max length: 10

array

Contains all additional costs for the client.

currency

string

Max length: 3

This reflects all relevant currencies in ISO-4217.

remainingAmount

number

Max length: 12

This is the outstanding amount of the cost which needs to be collected by the Debt Collection Agency. A positive amount indicates a claim against the debtor. Negative amounts or 0 amounts are not allowed.

originalAmount

number

Max length: 12

This is the original amount of the cost. A positive amount indicates a claim against the debtor. Negative amounts or 0 amounts are not allowed.

taxRate

number

Max length: 12

The tax rate that was used.

date

string

yyyy-MM-dd

Max length: 10

The date when the costs occurred.

description

string

Max length: 256

This is a description of the costs.

invoiceNumber

string

Max length: 40

The invoice number assigned by the customer to the invoice to which the costs are to be allocated. If the costs cannot be allocated to a specific invoice, the field can be left blank (`null`).

type

string

Max length: 20

Enum:

CHARGEBACK

REMINDER_FEE

COMPENSATION

INTEREST_BEARING_COMPENSATION

LOAN_FEE

COSTS_OF_TURNING_OFF

BLOCKING_FINE

Represents the type of a cost.

array

Contains all interest.

invoiceNumber

string

Max length: 40

The invoice number assigned by the customer to the invoice to which the costs are to be allocated. If the interest cannot be allocated to a specific invoice, the field can be left blank (`null`).

currency

string

Max length: 3

This reflects all relevant currencies in ISO-4217.

originalAmount

number

Max length: 12

This is the original amount of the interest. A positive amount indicates a claim against the debtor. Negative amounts or 0 amounts are not allowed.

remainingAmount

number

Max length: 12

This is the outstanding amount of the interest which needs to be collected by the Debt Collection Agency. A positive amount indicates a claim against the debtor. Negative amounts or 0 amounts are not allowed.

fromDate

string

yyyy-MM-dd

Max length: 10

The date when the interest occurred.

toDate

string

yyyy-MM-dd

Max length: 10

When the interest rate has changed over time, an end date can be communicated here.

capitalized

boolean

Max length: 10

This information is particularly important in the context of loans, especially in Nordic countries, where creditors have the ability to charge interest on claims that are marked as capitalized, commonly known as compound interest.

description

string

Max length: 256

This is a description of the interest.

industry

string

Max length: 20

Enum:

UTILITY

If the claim can be assigned to a specific industry, this can be entered in this field. Depending on the selected industry, there are specific fields that are available and must be partially filled.

array

A list of addtional properties, which belongs to the claim.

Responses

Successful Request

Request Example

    
        {
 "customer": {
  "customerNumber": "B1140280585",
  "gender": "female",
  "title": "Ms.",
  "firstName": "Bianka",
  "lastName": "Hilll",
  "dateOfBirth": "1946-01-01",
  "type": "PRIVATE",
  "addresses": [
   {
    "street": "640 Carrie Crest",
    "zipCode": "56695-0518",
    "city": "West Mattiemouth",
    "countryCode": "TZ",
    "type": "billing"
   }
  ]
 },
 "contracts": [
  {
   "contractNumber": "V8157366331",
   "startDate": "2018-06-23",
   "endDate": "2023-06-23",
   "invoices": [
    {
     "invoiceNumber": "I5408705335",
     "invoiceDate": "2023-06-23",
     "remainingAmount": 100,
     "originalAmount": 120,
     "currency": "EUR"
    }
   ]
  }
 ]
}

Response Example

    
        {
 "requestId": "8ec4f2b1-964b-42fd-9b1a-abd9274af9c1"
}