journal entries

GET /companies/{companySlug}/journalEntries

Changed on

Returns all general journal entries (posteringer) for the specified company.

Request

  • Base URL
    https://api.fiken.no/api/v2
  • Auth
    OAuth 2
    Authorization codehttps://fiken.no/oauth/authorize
    Token URLhttps://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.

datestring date

Dates are represented as strings formatted as YYYY-MM-DD. Example: January 1st, 1970: "1970-01-01"

dateLestring date

Filter based on date less than or equal to parameter value. Dates are represented as strings formatted as YYYY-MM-DD. Example: January 1st, 1970: "1970-01-01"

dateLtstring date

Filter based on date strictly less than parameter value. Dates are represented as strings formatted as YYYY-MM-DD. Example: January 1st, 1970: "1970-01-01"

dateGestring date

Filter based on date greater than or equal to parameter value. Dates are represented as strings formatted as YYYY-MM-DD. Example: January 1st, 1970: "1970-01-01"

dateGtstring date

Filter based on date strictly greater than parameter value Dates are represented as strings formatted as YYYY-MM-DD. Example: January 1st, 1970: "1970-01-01"

lastModifiedstring date

Filter based on date of last modification. Returns results that were last modified on the date provided as a parameter value. Dates are represented as strings formatted as YYYY-MM-DD. Example: January 1st, 1970: "1970-01-01"

lastModifiedLestring date

Returns results that have been last modified before or on the date provided as a parameter value. Dates are represented as strings formatted as YYYY-MM-DD. Example: January 1st, 1970: "1970-01-01"

lastModifiedLtstring date

Returns results that have been last modified strictly before the date provided as a parameter value. Dates are represented as strings formatted as YYYY-MM-DD. Example: January 1st, 1970: "1970-01-01"

lastModifiedGestring date

Returns results that have been last modified after or on the date provided as a parameter value. Dates are represented as strings formatted as YYYY-MM-DD. Example: January 1st, 1970: "1970-01-01"

lastModifiedGtstring date

Returns results that have been last modified strictly after the date provided as a parameter value. Dates are represented as strings formatted as YYYY-MM-DD. Example: January 1st, 1970: "1970-01-01"

createdDatestring date

Dates are represented as strings formatted as YYYY-MM-DD. Example: January 1st, 1970: "1970-01-01"

createdDateLestring date

Returns results that were created before or on the date provided as a parameter value. Dates are represented as strings formatted as YYYY-MM-DD. Example: January 1st, 1970: "1970-01-01"

createdDateLtstring date

Returns results that were created strictly before the date provided as a parameter value. Dates are represented as strings formatted as YYYY-MM-DD. Example: January 1st, 1970: "1970-01-01"

createdDateGestring date

Returns results that were created after or on the date provided as a parameter value. Dates are represented as strings formatted as YYYY-MM-DD. Example: January 1st, 1970: "1970-01-01"

createdDateGtstring date

Returns results that were created strictly after the date provided as a parameter value. Dates are represented as strings formatted as YYYY-MM-DD. Example: January 1st, 1970: "1970-01-01"

transactionTypestring

Returns only journal entries belonging to a transaction of the given type. Exact match on the value returned in transactionType, for example Inngående balanse. See transactionType on journalEntry for possible values. An unknown value gives 400.

Response

OK

journalEntryIdinteger
createdDatestring date

Date that journal entry was created in Fiken, format yyyy-mm-dd

lastModifiedDatestring date

Date that journal entry was last modified in Fiken, format yyyy-mm-dd.

transactionIdinteger
offsetTransactionIdinteger

If a journal entry has been cancelled this provides the id of the balancing transaction

transactionTypestring

Type of the transaction this journal entry belongs to. The type is a property of the transaction, so all journal entries in the same transaction have the same type. Same value as type on transaction. Possible values: Salg, Kjøp, Fri, Åpningsbalanse, Annullering, Import, Kreditert salg, Kreditert kjøp, Bankomkostning, Inngående balanse, Mva-oppgjør, Årsavslutning (system), Bankrenter, Intern overføring, Personlig innskudd/uttak, Innskudd av kontanter (mynter og sedler), Uttak av kontanter (mynter og sedler), Forskuddsskatt, Kontantutlegg, Lønn, Betaling av forskuddstrekk, Betaling av arbeidsgiveravgift, Forever Bonus, Årsavslutning (egne), PayPal PoS, Endring av eiendel, Betaling av finansskatt, Diverse (fra mal), Gjeld, Betaling av utleggstrekk for dekning av skatt, Kjørebok, Skatteoppgjør, Tolldeklarasjon, Verdipapir, Betalingsoppgjør, Avstemming, Varetelling.

journalEntryNumberinteger
descriptionstring required

We add the flag 'Fri postering registrert via API: '. This must be taken into account in the max length of the description

datestring date required

Example response

[
  {
    "createdDate": "2018-04-03",
    "lastModifiedDate": "2018-04-03",
    "transactionType": "Inngående balanse",
    "journalEntryNumber": 18,
    "description": "Purchase, Schweigaards Gate 34 AS (invoice nr 26083)",
    "date": "2018-04-03",
    "lines": [
      {
        "amount": 310000,
        "account": "2400:20079",
        "vatCode": "1",
        "lastModifiedDate": "2018-04-03"
      }
    ],
    "attachments": [
      {
        "uuid": "745b2f15-1234-4408-8bf2-b1d2d7610cb2",
        "filename": "invoice_24760.pdf",
        "identifier": "24760",
        "type": "invoice"
      }
    ]
  }
]

Changes

    • info

      added the new optional query request parameter transactionType

    • 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