FIfiken
recurring invoices

POST /companies/{companySlug}/recurringInvoices

Changed on

Creates a recurring invoice for a single customer. This corresponds to "Repeterende faktura" in Fiken. The number series for recurring invoices must already exist; if it does not, create the first recurring invoice in Fiken Web.

Request

  • Base URL
    https://api.fiken.no/api/v2
  • URL
    https://api.fiken.no/api/v2/companies/{companySlug}/recurringInvoices
  • Auth
    OAuth 2
    Authorization code: https://fiken.no/oauth/authorize
    Token URL: https://fiken.no/oauth/token

Request body

uuidstring

Optional UUID. If not provided, the API will generate one.

customerIdinteger required

customerId = contactId where customer = true

contactPersonIdinteger

Id of the contact person. Must be associated with the provided customer.

startDatestring date required

First issue date of the recurring invoice.

endDatestring date

Optional date after which no more invoices are generated.

daysUntilDueDateinteger required

Days until due date for each generated invoice.

currencystring

ISO 4217 currency code. Defaults to "NOK" if unspecified.

bankAccountNumberstring required
ibanstring
bicstring
invoiceTextstring

Comment/description printed above the invoice lines.

yourReferencestring
ourReferencestring
orderReferencestring

Reference if sending invoice via EHF.

Example request

{
  "uuid": "123e4567-e89b-12d3-a456-426655440000",
  "customerId": 7340852,
  "contactPersonId": 8588156,
  "startDate": "2018-04-03",
  "endDate": "2019-04-03",
  "daysUntilDueDate": 14,
  "frequency": {
    "interval": 1,
    "intervalUnit": "MONTH"
  },
  "currency": "NOK",
  "bankAccountNumber": "11112233334",
  "lines": [
    {
      "invoiceishDraftLineId": 2888156,
      "lastModifiedDate": "2018-04-03",
      "description": "Goatskin, with extra-long suede cuffs",
      "unitPrice": 4550,
      "quantity": 5,
      "discount": 25,
      "comment": "One size fits all",
      "incomeAccount": "3000"
    }
  ]
}

Response

Created

Changes