Issue and send

We reserve the right to change this documentation

Verison: 1.0 (read more)

Issue and send dunning

In order to send out a dunning, the original invoice you want to dun must be sent out via !SendRegning.no. The original invoice must also be dunnable.

You can also find more information about when you can add to dunning fee/interest here

The default value for due days is 14.

Delivery method

A dunning must be printed out and sent to the recipient by paper mail.

The reason for this is the wording in the Act relating to overdue payments, which says:

Demand can be sent electronically if the debtor has expressly accepted the use of such communication.

The Norwegian Consumer Council says the following about this:

The Norwegian Consumer Council is in doubt whether it is desirable that demands can be sent electronically, even if the debtor has expressly accepted this.

The lawyers/auditors we have had contact with regarding this, say quite clearly that if there is to be some weight to the demand, a dunning should be sent on paper.

It is however possible to only issue dunning, print it and send manually. This can be achieved by skipping shipment object. Note that the price for issuing a dunning is the same as the price for the cheapest shipment option available for dunnings, as SendRegning’s business model is based on sending documents.

1
POST /dunnings/

Request

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
{
    "invoiceNumber" :  1,
    "interest" :  true,
    "dunningFee" :  true,
    "debtCollectionNotice" :  true,
    "dunningText" :  "dunning text",
    "shipment": {
        "paper": {},
        "sms": [
            {
                "mobileNumber": "47111111",
                "message": "smstext1"
            },
            {
                "mobileNumber": "90091705",
                "message": "smstext2"
            }
        ],
        "copy": {
            "email": [
                {
                    "address": "copy@sendregning.no",
                    "htmlContent": "copycustommessage"
                },
                {
                    "address": "copy2@sendregning.no",
                    "htmlContent": "copy2custommessage"
                }
            ]
        }
    }
}

Response

HTTP/1.1 200 OK

Name Description Required Type Limitation
invoiceNumber Invoice number. Invoice must be dunnable yes Integer
interest Whether interest will be calculated and added to the dunning or not.
Interest will be calculated from the due date of the original invoice to the due date of the dunning.
yes Boolean
dunningFee Defines whether dunning fee should be added.
- It is only possible to add a dunning fee twice. I.e. if you add a dunning fee to 1st DUNNING and 2nd DUNNING, you are not allowed to add a dunning fee when sending 3rd DUNNING or a DEBT COLLECTION NOTICE.
- It must be past at least 14 days overdue for the original invoice or last sent dunning before a dunning with a dunning fee can be sent.
yes Boolean
debtCollectionNotice Is dunning a debt collection notice yes Boolean
dunningText Dunning text Text field with space for a message to the recipient of the dunning. If this element is omitted, and you send out a dunning except for DEBT COLLECTION NOTICE, the following standard text will be used:
`Vi kan dessverre ikke se å ha mottatt Deres betaling for denne regning.`

If the element is omitted, and you send out a DEBT COLLECTION NOTICE, the following standard text will be used:
`Dersom vi ikke har mottatt Deres betaling innen forfall, overføres regningen til inkasso.`

NOTE: This text is printed instead of what you may have specified in the 'invoiceText' element when sending the original invoice.
no String
shipment Contains the different shipment option wanted. One or more of the different option must be chosen. You add the options you want by adding the associated property. no Object
paper Sending dunning on paper is mandatory. Leave object empty to send to address specified on recipient. If address is specified original invoice will be updated with it. yes Object
address1 conditioned String 64 characters
address2 conditioned String 64 characters
zip If paper object is not empty, then this field is mandatory. conditioned String 8 characters
city If paper object is not empty, then this field is mandatory. conditioned String 64 characters
country If paper object is not empty, then this field is mandatory. conditioned String 64 characters
email List of emails objects Array
address Email address of the receiver of this invoice. yes String 64 characters
htmlContent Message that will be used in the email sent. String 120 characters
sms List of sms objects Array
mobileNumber A valid mobileNumber to send the invoice to. yes String 8 characters
message A message that will be added along the link. yes String 140 characters
copy Copy shipment options Object
email List of emails objects Array
address Email address of the receiver of this invoice. yes String 64 characters
htmlContent Message that will be used in the email sent. String 120 characters