FIfiken
invoices

GET /companies/{companySlug}/invoices/drafts

Changed on

Returns all invoice drafts for given company.

Request

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

Query parameters

pageinteger

Returns the number of the page to return. Valid page values are integers from 0 to the total number of pages. Default value is 0.

pageSizeinteger

Defines the number of entries to return on each page. Maximum number of results that can be returned at one time are 100. Default value is 25.

orderReferencestring

Filter based on order reference for a given invoice draft

uuidstring uuid

Filter based on the UUID of the draft.

Response

OK

draftIdinteger

Invoice draft ID

uuidstring

UUID are represented as 32 hexadecimal (base-16) digits, displayed in 5 groups separated by hyphens, in the form 8-4-4-4-12 for a total of 36 characters.

type'invoice' | 'cash_invoice' | 'offer' | 'order_confirmation' | 'credit_note' | 'repeating_invoice'

Type of invoice draft.

lastModifiedDatestring date

Date that the draft was last modified in Fiken, format yyyy-mm-dd.

issueDatestring date

Issue date of the invoice draft, format yyyy-mm-dd

daysUntilDueDateinteger

Days until due date of the invoice draft.

invoiceTextstring

Comment/description printed above the invoice lines

currencystring

ISO 4217 currency code

yourReferencestring
ourReferencestring
orderReferencestring

Reference if sending invoice via EHF.

netinteger

The net amount to be invoiced in the specified currency.

grossinteger

The gross amount to be invoiced in the specified currency.

bankAccountNumberstring
ibanstring
bicstring
paymentAccountstring
createdFromInvoiceIdinteger
projectIdinteger
roundingType'none' | 'round_half' | 'round_whole' | 'round_down_half' | 'round_down_whole'

Type of øreavrunding (rounding) to apply to the total. 'none' means no rounding (default). 'round_half' rounds to nearest 50 øre, 'round_whole' rounds to nearest whole krone, 'round_down_half' rounds down to nearest 50 øre, 'round_down_whole' rounds down to nearest whole krone. Only applicable for NOK currency. Does not change the company's default rounding setting.

startDatestring date

First issue date of the recurring invoice. Only present when type is repeating_invoice.

endDatestring date

Date after which no more invoices are generated. Only present when type is repeating_invoice.

Example response

[
  {
    "draftId": 2888156,
    "uuid": "123e4567-e89b-12d3-a456-426655440000",
    "type": "invoice",
    "lastModifiedDate": "2023-04-03",
    "issueDate": "2018-04-03",
    "daysUntilDueDate": 15,
    "currency": "NOK",
    "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"
      }
    ],
    "net": 4500,
    "gross": 5000,
    "bankAccountNumber": "11112233334",
    "paymentAccount": "1920:10001",
    "customers": [
      {
        "contactId": 2747365,
        "createdDate": "2018-04-03",
        "lastModifiedDate": "2018-04-03",
        "name": "Fiken AS",
        "email": "kontakt@fiken.gmail",
        "organizationNumber": "913312465",
        "customerNumber": 51248,
        "customerAccountCode": "1500:20001",
        "phoneNumber": "62158537",
        "memberNumber": 5464,
        "memberNumberString": "5464",
        "supplierAccountCode": "2400:20001",
        "bankAccountNumber": "11112233334",
        "contactPerson": [
          {
            "contactPersonId": 2747365,
            "name": "Betty Boop",
            "email": "bb@gmail.com",
            "phoneNumber": "98573564",
            "address": {
              "streetAddress": "Karl Johan 34",
              "streetAddressLine2": "H0405",
              "city": "Oslo",
              "postCode": "0550",
              "country": "Norway"
            }
          }
        ],
        "notes": [
          {
            "author": "Betty Boop",
            "note": "Garage 45"
          }
        ],
        "currency": "NOK",
        "language": "Norwegian",
        "inactive": true,
        "daysUntilInvoicingDueDate": 15,
        "discount": 25,
        "address": {
          "streetAddress": "Karl Johan 34",
          "streetAddressLine2": "H0405",
          "city": "Oslo",
          "postCode": "0550",
          "country": "Norway"
        },
        "documents": [
          {
            "uuid": "745b2f15-1234-4408-8bf2-b1d2d7610cb2",
            "filename": "invoice_24760.pdf",
            "identifier": "24760",
            "type": "invoice"
          }
        ]
      }
    ],
    "attachments": [
      {
        "uuid": "745b2f15-1234-4408-8bf2-b1d2d7610cb2",
        "filename": "invoice_24760.pdf",
        "identifier": "24760",
        "type": "invoice"
      }
    ],
    "createdFromInvoiceId": 73408306,
    "projectId": 73408306,
    "roundingType": "none",
    "startDate": "2018-04-03",
    "endDate": "2019-04-03",
    "frequency": {
      "interval": 1,
      "intervalUnit": "MONTH"
    }
  }
]

Changes

  • 2473dacdb89cRevision changes
    • info

      added the optional property /// to the response with the status

    • info

      added the optional property /// to the response with the status

    • info

      added the optional property ///// to the response with the status

    • info

      added the optional property ///// to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      the response optional property /// became read-only for the status

  • dff97b55851eRevision changes
    • info

      added the new optional query request parameter uuid

    • info

      added the optional property /// to the response with the status

    • info

      added the optional write-only property items/customers/items/memberNumberString to the response with the status

    • info

      response property items/customers/items/memberNumber deprecated