Fiken MCP by usefulapi

The Fiken user this connection acts as (name and email). A cheap check that the sign-in works. Fiken: GET /user.

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

The Fiken companies this connection can access, with their slug (needed as companySlug in every other tool), organization number and VAT type. Companies created after you approved access must be added under Fiken > Rediger konto > Sikkerhet > Apper du har gitt tilgang til. Fiken: GET /companies.

{
  "type": "object",
  "properties": {
    "page": {
      "description": "Page number, starting at 0 (default 0).",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "pageSize": {
      "description": "Items per page, 1-100 (default 25).",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "sortBy": {
      "description": "Sort order (default name asc).",
      "type": "string",
      "enum": [
        "createdDate asc",
        "createdDate desc",
        "name asc",
        "name desc",
        "organizationNumber asc",
        "organizationNumber desc"
      ]
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

One company: name, organization number, VAT type, address, accounting start date and whether the API module is active. Fiken: GET /companies/{companySlug}.

{
  "type": "object",
  "properties": {
    "companySlug": {
      "type": "string",
      "minLength": 1,
      "description": "The company's slug: the `slug` field from fiken_list_companies (for example swagger-test-company)."
    }
  },
  "required": [
    "companySlug"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

The bookkeeping accounts (kontoplan) of the current year. Filter with range, e.g. "3000-3999, 1920". Fiken: GET /companies/{companySlug}/accounts.

{
  "type": "object",
  "properties": {
    "companySlug": {
      "type": "string",
      "minLength": 1,
      "description": "The company's slug: the `slug` field from fiken_list_companies (for example swagger-test-company)."
    },
    "page": {
      "description": "Page number, starting at 0 (default 0).",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "pageSize": {
      "description": "Items per page, 1-100 (default 25).",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "fromAccount": {
      "description": "First account number to include, e.g. 3000.",
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "toAccount": {
      "description": "Last account number to include, e.g. 3999.",
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "range": {
      "description": "Comma-separated account numbers or ranges, e.g. \"1000-1500, 2000, 7000-7004\".",
      "type": "string"
    }
  },
  "required": [
    "companySlug"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Closing balance of every bookkeeping account on a date (amounts in cents). Fiken: GET /companies/{companySlug}/accountBalances.

{
  "type": "object",
  "properties": {
    "companySlug": {
      "type": "string",
      "minLength": 1,
      "description": "The company's slug: the `slug` field from fiken_list_companies (for example swagger-test-company)."
    },
    "page": {
      "description": "Page number, starting at 0 (default 0).",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "pageSize": {
      "description": "Items per page, 1-100 (default 25).",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "date": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "The balance date (YYYY-MM-DD)."
    },
    "fromAccount": {
      "description": "First account number to include.",
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "toAccount": {
      "description": "Last account number to include.",
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    }
  },
  "required": [
    "companySlug",
    "date"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

The company's bank accounts as registered in Fiken. Fiken: GET /companies/{companySlug}/bankAccounts.

{
  "type": "object",
  "properties": {
    "companySlug": {
      "type": "string",
      "minLength": 1,
      "description": "The company's slug: the `slug` field from fiken_list_companies (for example swagger-test-company)."
    },
    "page": {
      "description": "Page number, starting at 0 (default 0).",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "pageSize": {
      "description": "Items per page, 1-100 (default 25).",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "inactive": {
      "description": "true = only inactive bank accounts, false = only active ones.",
      "type": "boolean"
    }
  },
  "required": [
    "companySlug"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Bank account balances, optionally on a given date (amounts in cents). Fiken: GET /companies/{companySlug}/bankBalances.

{
  "type": "object",
  "properties": {
    "companySlug": {
      "type": "string",
      "minLength": 1,
      "description": "The company's slug: the `slug` field from fiken_list_companies (for example swagger-test-company)."
    },
    "page": {
      "description": "Page number, starting at 0 (default 0).",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "pageSize": {
      "description": "Items per page, 1-100 (default 25).",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "date": {
      "description": "Balance date (YYYY-MM-DD).",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    }
  },
  "required": [
    "companySlug"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Customers and suppliers. Filter by name, organization number, email, customer/supplier flag or modification date. contactId in the result is the id other tools take as customerId/contactId. Fiken: GET /companies/{companySlug}/contacts.

{
  "type": "object",
  "properties": {
    "companySlug": {
      "type": "string",
      "minLength": 1,
      "description": "The company's slug: the `slug` field from fiken_list_companies (for example swagger-test-company)."
    },
    "page": {
      "description": "Page number, starting at 0 (default 0).",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "pageSize": {
      "description": "Items per page, 1-100 (default 25).",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "name": {
      "description": "Exact name.",
      "type": "string"
    },
    "organizationNumber": {
      "description": "Exact organization number.",
      "type": "string"
    },
    "email": {
      "description": "Exact email.",
      "type": "string"
    },
    "customerNumber": {
      "description": "Customer number.",
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "supplierNumber": {
      "description": "Supplier number.",
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "customer": {
      "description": "true = only customers.",
      "type": "boolean"
    },
    "supplier": {
      "description": "true = only suppliers.",
      "type": "boolean"
    },
    "inactive": {
      "description": "true = only inactive contacts, false = only active.",
      "type": "boolean"
    },
    "group": {
      "description": "Customer group, exact match.",
      "type": "string"
    },
    "lastModifiedGe": {
      "description": "Modified on or after (YYYY-MM-DD).",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "sortBy": {
      "description": "Sort order.",
      "type": "string",
      "enum": [
        "lastModified asc",
        "lastModified desc",
        "createdDate asc",
        "createdDate desc"
      ]
    }
  },
  "required": [
    "companySlug"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

One customer or supplier with address, contact persons, notes and account codes. Fiken: GET /companies/{companySlug}/contacts/{contactId}.

{
  "type": "object",
  "properties": {
    "companySlug": {
      "type": "string",
      "minLength": 1,
      "description": "The company's slug: the `slug` field from fiken_list_companies (for example swagger-test-company)."
    },
    "contactId": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "The contactId from fiken_list_contacts."
    }
  },
  "required": [
    "companySlug",
    "contactId"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Issued (final) invoices with sale lines, amounts in cents and settled status. Filter by issue date, due date, customer and whether settled. Fiken: GET /companies/{companySlug}/invoices.

{
  "type": "object",
  "properties": {
    "companySlug": {
      "type": "string",
      "minLength": 1,
      "description": "The company's slug: the `slug` field from fiken_list_companies (for example swagger-test-company)."
    },
    "page": {
      "description": "Page number, starting at 0 (default 0).",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "pageSize": {
      "description": "Items per page, 1-100 (default 25).",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "issueDateGe": {
      "description": "Issued on or after (YYYY-MM-DD).",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "issueDateLe": {
      "description": "Issued on or before (YYYY-MM-DD).",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "dueDateGe": {
      "description": "Due on or after (YYYY-MM-DD).",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "dueDateLe": {
      "description": "Due on or before (YYYY-MM-DD).",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "lastModifiedGe": {
      "description": "Modified on or after (YYYY-MM-DD).",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "customerId": {
      "description": "Only invoices to this contactId.",
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "settled": {
      "description": "true = only settled (paid) invoices, false = only unsettled ones.",
      "type": "boolean"
    },
    "orderReference": {
      "description": "Order reference.",
      "type": "string"
    }
  },
  "required": [
    "companySlug"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

One issued invoice with lines, customer, amounts in cents, settled status and payment/credit-note links. Fiken: GET /companies/{companySlug}/invoices/{invoiceId}.

{
  "type": "object",
  "properties": {
    "companySlug": {
      "type": "string",
      "minLength": 1,
      "description": "The company's slug: the `slug` field from fiken_list_companies (for example swagger-test-company)."
    },
    "invoiceId": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "The invoiceId from fiken_list_invoices."
    }
  },
  "required": [
    "companySlug",
    "invoiceId"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Drafts of invoices, offers, order confirmations and credit notes that are not issued yet (a draft has a draftId, an invoice has an invoiceId). Fiken: GET /companies/{companySlug}/invoices/drafts.

{
  "type": "object",
  "properties": {
    "companySlug": {
      "type": "string",
      "minLength": 1,
      "description": "The company's slug: the `slug` field from fiken_list_companies (for example swagger-test-company)."
    },
    "page": {
      "description": "Page number, starting at 0 (default 0).",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "pageSize": {
      "description": "Items per page, 1-100 (default 25).",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "orderReference": {
      "description": "Order reference.",
      "type": "string"
    },
    "uuid": {
      "description": "The draft's UUID.",
      "type": "string"
    }
  },
  "required": [
    "companySlug"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Issued credit notes. Fiken: GET /companies/{companySlug}/creditNotes.

{
  "type": "object",
  "properties": {
    "companySlug": {
      "type": "string",
      "minLength": 1,
      "description": "The company's slug: the `slug` field from fiken_list_companies (for example swagger-test-company)."
    },
    "page": {
      "description": "Page number, starting at 0 (default 0).",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "pageSize": {
      "description": "Items per page, 1-100 (default 25).",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "issueDateGe": {
      "description": "Issued on or after (YYYY-MM-DD).",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "issueDateLe": {
      "description": "Issued on or before (YYYY-MM-DD).",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "lastModifiedGe": {
      "description": "Modified on or after (YYYY-MM-DD).",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "customerId": {
      "description": "Only credit notes to this contactId.",
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "settled": {
      "description": "true = only settled, false = only unsettled.",
      "type": "boolean"
    }
  },
  "required": [
    "companySlug"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Issued offers (tilbud). Fiken: GET /companies/{companySlug}/offers.

{
  "type": "object",
  "properties": {
    "companySlug": {
      "type": "string",
      "minLength": 1,
      "description": "The company's slug: the `slug` field from fiken_list_companies (for example swagger-test-company)."
    },
    "page": {
      "description": "Page number, starting at 0 (default 0).",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "pageSize": {
      "description": "Items per page, 1-100 (default 25).",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    }
  },
  "required": [
    "companySlug"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Issued order confirmations. Fiken: GET /companies/{companySlug}/orderConfirmations.

{
  "type": "object",
  "properties": {
    "companySlug": {
      "type": "string",
      "minLength": 1,
      "description": "The company's slug: the `slug` field from fiken_list_companies (for example swagger-test-company)."
    },
    "page": {
      "description": "Page number, starting at 0 (default 0).",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "pageSize": {
      "description": "Items per page, 1-100 (default 25).",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    }
  },
  "required": [
    "companySlug"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

The product register with unit price in cents, income account and VAT type. productId is what an invoice-draft line takes. Fiken: GET /companies/{companySlug}/products.

{
  "type": "object",
  "properties": {
    "companySlug": {
      "type": "string",
      "minLength": 1,
      "description": "The company's slug: the `slug` field from fiken_list_companies (for example swagger-test-company)."
    },
    "page": {
      "description": "Page number, starting at 0 (default 0).",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "pageSize": {
      "description": "Items per page, 1-100 (default 25).",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "name": {
      "description": "Exact product name.",
      "type": "string"
    },
    "productNumber": {
      "description": "Exact product number (varenummer).",
      "type": "string"
    },
    "active": {
      "description": "true = only active products, false = only inactive.",
      "type": "boolean"
    },
    "lastModifiedGe": {
      "description": "Modified on or after (YYYY-MM-DD).",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    }
  },
  "required": [
    "companySlug"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

One product. Fiken: GET /companies/{companySlug}/products/{productId}.

{
  "type": "object",
  "properties": {
    "companySlug": {
      "type": "string",
      "minLength": 1,
      "description": "The company's slug: the `slug` field from fiken_list_companies (for example swagger-test-company)."
    },
    "productId": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "The productId from fiken_list_products."
    }
  },
  "required": [
    "companySlug",
    "productId"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Sales registered without an invoice (cash, card, Vipps and other direct sales), with amounts in cents. Fiken: GET /companies/{companySlug}/sales.

{
  "type": "object",
  "properties": {
    "companySlug": {
      "type": "string",
      "minLength": 1,
      "description": "The company's slug: the `slug` field from fiken_list_companies (for example swagger-test-company)."
    },
    "page": {
      "description": "Page number, starting at 0 (default 0).",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "pageSize": {
      "description": "Items per page, 1-100 (default 25).",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "dateGe": {
      "description": "Sale date on or after (YYYY-MM-DD).",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "dateLe": {
      "description": "Sale date on or before (YYYY-MM-DD).",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "lastModifiedGe": {
      "description": "Modified on or after (YYYY-MM-DD).",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "saleNumber": {
      "description": "Sale number.",
      "type": "string"
    },
    "settled": {
      "description": "true = only settled sales, false = only unsettled.",
      "type": "boolean"
    },
    "contactId": {
      "description": "Only sales to this contactId.",
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    }
  },
  "required": [
    "companySlug"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

One sale with lines, payments and settlement status. Fiken: GET /companies/{companySlug}/sales/{saleId}.

{
  "type": "object",
  "properties": {
    "companySlug": {
      "type": "string",
      "minLength": 1,
      "description": "The company's slug: the `slug` field from fiken_list_companies (for example swagger-test-company)."
    },
    "saleId": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "The saleId from fiken_list_sales."
    }
  },
  "required": [
    "companySlug",
    "saleId"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Purchases and supplier bills with amounts in cents and paid status. Fiken: GET /companies/{companySlug}/purchases.

{
  "type": "object",
  "properties": {
    "companySlug": {
      "type": "string",
      "minLength": 1,
      "description": "The company's slug: the `slug` field from fiken_list_companies (for example swagger-test-company)."
    },
    "page": {
      "description": "Page number, starting at 0 (default 0).",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "pageSize": {
      "description": "Items per page, 1-100 (default 25).",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "dateGe": {
      "description": "Purchase date on or after (YYYY-MM-DD).",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "dateLe": {
      "description": "Purchase date on or before (YYYY-MM-DD).",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "lastModifiedGe": {
      "description": "Modified on or after (YYYY-MM-DD).",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "paid": {
      "description": "true = only paid purchases, false = only unpaid.",
      "type": "boolean"
    },
    "contactId": {
      "description": "Only purchases from this supplier contactId.",
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "sortBy": {
      "description": "Sort order.",
      "type": "string",
      "enum": [
        "date asc",
        "date desc"
      ]
    }
  },
  "required": [
    "companySlug"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

One purchase with lines, payments and attachments list. Fiken: GET /companies/{companySlug}/purchases/{purchaseId}.

{
  "type": "object",
  "properties": {
    "companySlug": {
      "type": "string",
      "minLength": 1,
      "description": "The company's slug: the `slug` field from fiken_list_companies (for example swagger-test-company)."
    },
    "purchaseId": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "The purchaseId from fiken_list_purchases."
    }
  },
  "required": [
    "companySlug",
    "purchaseId"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

General-ledger journal entries (bilag) with their postings. Fiken: GET /companies/{companySlug}/journalEntries.

{
  "type": "object",
  "properties": {
    "companySlug": {
      "type": "string",
      "minLength": 1,
      "description": "The company's slug: the `slug` field from fiken_list_companies (for example swagger-test-company)."
    },
    "page": {
      "description": "Page number, starting at 0 (default 0).",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "pageSize": {
      "description": "Items per page, 1-100 (default 25).",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "dateGe": {
      "description": "Entry date on or after (YYYY-MM-DD).",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "dateLe": {
      "description": "Entry date on or before (YYYY-MM-DD).",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "lastModifiedGe": {
      "description": "Modified on or after (YYYY-MM-DD).",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    }
  },
  "required": [
    "companySlug"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Ledger transactions (one per bookkeeping event) with their entries. Fiken: GET /companies/{companySlug}/transactions.

{
  "type": "object",
  "properties": {
    "companySlug": {
      "type": "string",
      "minLength": 1,
      "description": "The company's slug: the `slug` field from fiken_list_companies (for example swagger-test-company)."
    },
    "page": {
      "description": "Page number, starting at 0 (default 0).",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "pageSize": {
      "description": "Items per page, 1-100 (default 25).",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "createdDateGe": {
      "description": "Created on or after (YYYY-MM-DD).",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "createdDateLe": {
      "description": "Created on or before (YYYY-MM-DD).",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "lastModifiedGe": {
      "description": "Modified on or after (YYYY-MM-DD).",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    }
  },
  "required": [
    "companySlug"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Projects with number, name and completion status. Fiken: GET /companies/{companySlug}/projects.

{
  "type": "object",
  "properties": {
    "companySlug": {
      "type": "string",
      "minLength": 1,
      "description": "The company's slug: the `slug` field from fiken_list_companies (for example swagger-test-company)."
    },
    "page": {
      "description": "Page number, starting at 0 (default 0).",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "pageSize": {
      "description": "Items per page, 1-100 (default 25).",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "completed": {
      "description": "true = only completed projects, false = only open ones.",
      "type": "boolean"
    },
    "name": {
      "description": "Project name.",
      "type": "string"
    }
  },
  "required": [
    "companySlug"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Registered hours (Fiken Timeføring). Fiken: GET /companies/{companySlug}/timeEntries.

{
  "type": "object",
  "properties": {
    "companySlug": {
      "type": "string",
      "minLength": 1,
      "description": "The company's slug: the `slug` field from fiken_list_companies (for example swagger-test-company)."
    },
    "page": {
      "description": "Page number, starting at 0 (default 0).",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "pageSize": {
      "description": "Items per page, 1-100 (default 25).",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "dateGe": {
      "description": "Date on or after (YYYY-MM-DD).",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "dateLe": {
      "description": "Date on or before (YYYY-MM-DD).",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "projectId": {
      "description": "Only this project.",
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "timeUserId": {
      "description": "Only this time-tracking user.",
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "invoiced": {
      "description": "true = only invoiced hours, false = only uninvoiced.",
      "type": "boolean"
    }
  },
  "required": [
    "companySlug"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Documents waiting in the company's inbox (receipts and bills uploaded for bookkeeping). Fiken: GET /companies/{companySlug}/inbox.

{
  "type": "object",
  "properties": {
    "companySlug": {
      "type": "string",
      "minLength": 1,
      "description": "The company's slug: the `slug` field from fiken_list_companies (for example swagger-test-company)."
    },
    "page": {
      "description": "Page number, starting at 0 (default 0).",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "pageSize": {
      "description": "Items per page, 1-100 (default 25).",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "status": {
      "description": "Whether the document is already used for a posting.",
      "type": "string",
      "enum": [
        "all",
        "unused",
        "used"
      ]
    },
    "name": {
      "description": "File name.",
      "type": "string"
    },
    "sortBy": {
      "description": "Sort order.",
      "type": "string",
      "enum": [
        "createdDate asc",
        "createdDate desc",
        "name asc",
        "name desc"
      ]
    }
  },
  "required": [
    "companySlug"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Create a customer and/or supplier contact. Set customer=true to invoice it later. The new contactId comes back in `id`. Fiken: POST /companies/{companySlug}/contacts.

{
  "type": "object",
  "properties": {
    "companySlug": {
      "type": "string",
      "minLength": 1,
      "description": "The company's slug: the `slug` field from fiken_list_companies (for example swagger-test-company)."
    },
    "name": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200,
      "description": "Contact name."
    },
    "email": {
      "description": "Email address.",
      "type": "string",
      "maxLength": 200
    },
    "organizationNumber": {
      "description": "Brreg organization number.",
      "type": "string",
      "maxLength": 200
    },
    "phoneNumber": {
      "description": "Phone number.",
      "type": "string",
      "maxLength": 20
    },
    "customer": {
      "description": "true if the contact is a customer (needed before you can invoice it).",
      "type": "boolean"
    },
    "supplier": {
      "description": "true if the contact is a supplier.",
      "type": "boolean"
    },
    "bankAccountNumber": {
      "description": "Bank account number (11 digits).",
      "type": "string",
      "maxLength": 11
    },
    "currency": {
      "description": "Default invoice currency, ISO 4217 (NOK, EUR, ...).",
      "type": "string",
      "pattern": "^[A-Z]{3}$"
    },
    "language": {
      "description": "Language of documents sent to this contact.",
      "type": "string",
      "enum": [
        "NORWEGIAN",
        "ENGLISH"
      ]
    },
    "daysUntilInvoicingDueDate": {
      "description": "Default days until the due date.",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "discount": {
      "description": "Default discount in percent.",
      "type": "number",
      "minimum": 0,
      "maximum": 100
    },
    "address": {
      "description": "Postal address.",
      "type": "object",
      "properties": {
        "streetAddress": {
          "type": "string"
        },
        "streetAddressLine2": {
          "type": "string"
        },
        "city": {
          "type": "string"
        },
        "postCode": {
          "type": "string"
        },
        "country": {
          "type": "string",
          "description": "Country name as Fiken expects it, e.g. Norway (required in an address)."
        }
      },
      "required": [
        "country"
      ]
    }
  },
  "required": [
    "companySlug",
    "name"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Add a product or service to the product register, for use on invoice lines. incomeAccount is a revenue account such as 3000 (see fiken_list_accounts). Fiken: POST /companies/{companySlug}/products.

{
  "type": "object",
  "properties": {
    "companySlug": {
      "type": "string",
      "minLength": 1,
      "description": "The company's slug: the `slug` field from fiken_list_companies (for example swagger-test-company)."
    },
    "name": {
      "type": "string",
      "minLength": 1,
      "description": "Product name."
    },
    "unitPrice": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991,
      "description": "Net unit price (excl. VAT), an integer in cents (100000 = 1000.00 kr)."
    },
    "incomeAccount": {
      "type": "string",
      "pattern": "^\\d{4}(:\\d{5})?$",
      "description": "Revenue account that receives the income, e.g. 3000."
    },
    "vatType": {
      "type": "string",
      "enum": [
        "NONE",
        "HIGH",
        "MEDIUM",
        "RAW_FISH",
        "LOW",
        "EXEMPT_IMPORT_EXPORT",
        "EXEMPT",
        "OUTSIDE",
        "EXEMPT_REVERSE"
      ],
      "description": "VAT type, HIGH (25 %) is the most common."
    },
    "active": {
      "default": true,
      "description": "Whether the product is in use.",
      "type": "boolean"
    },
    "productNumber": {
      "description": "Your product number (varenummer).",
      "type": "string"
    },
    "stock": {
      "description": "Stock count.",
      "type": "number"
    },
    "note": {
      "description": "Note.",
      "type": "string",
      "maxLength": 200
    }
  },
  "required": [
    "companySlug",
    "name",
    "incomeAccount",
    "vatType"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Create a DRAFT of an invoice, offer or order confirmation. A draft is not issued, not booked and not sent; it can be edited or deleted in Fiken. The draft's id comes back in `id`. To issue it use fiken_issue_invoice_from_draft (type invoice only). Amounts are integers in cents. Fiken: POST /companies/{companySlug}/invoices/drafts.

{
  "type": "object",
  "properties": {
    "companySlug": {
      "type": "string",
      "minLength": 1,
      "description": "The company's slug: the `slug` field from fiken_list_companies (for example swagger-test-company)."
    },
    "type": {
      "default": "invoice",
      "description": "Kind of document the draft becomes.",
      "type": "string",
      "enum": [
        "invoice",
        "cash_invoice",
        "offer",
        "order_confirmation"
      ]
    },
    "customerId": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "The contactId of the customer (a contact with customer=true)."
    },
    "daysUntilDueDate": {
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991,
      "description": "Days from the issue date until the invoice is due."
    },
    "issueDate": {
      "description": "Issue date, default today (YYYY-MM-DD).",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "invoiceText": {
      "description": "Text printed above the lines.",
      "type": "string"
    },
    "yourReference": {
      "description": "The customer's reference.",
      "type": "string"
    },
    "ourReference": {
      "description": "Your reference.",
      "type": "string"
    },
    "orderReference": {
      "description": "Order reference, needed for EHF.",
      "type": "string"
    },
    "currency": {
      "description": "ISO 4217 currency (default NOK).",
      "type": "string",
      "pattern": "^[A-Z]{3}$"
    },
    "bankAccountNumber": {
      "description": "Bank account number to pay into.",
      "type": "string"
    },
    "paymentAccount": {
      "description": "Payment account code, e.g. 1920:10001.",
      "type": "string"
    },
    "contactPersonId": {
      "description": "Contact person id of the customer.",
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "projectId": {
      "description": "Project id.",
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "lines": {
      "minItems": 1,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "productId": {
            "description": "productId from fiken_list_products (supplies price, VAT and income account).",
            "type": "integer",
            "minimum": -9007199254740991,
            "maximum": 9007199254740991
          },
          "description": {
            "description": "Line description.",
            "type": "string",
            "maxLength": 200
          },
          "unitPrice": {
            "type": "integer",
            "minimum": -9007199254740991,
            "maximum": 9007199254740991,
            "description": "Net price per unit, an integer in cents (100000 = 1000.00 kr)."
          },
          "quantity": {
            "type": "number",
            "description": "Number of units."
          },
          "vatType": {
            "description": "VAT type (defaults from the product).",
            "type": "string",
            "enum": [
              "NONE",
              "HIGH",
              "MEDIUM",
              "RAW_FISH",
              "LOW",
              "EXEMPT_IMPORT_EXPORT",
              "EXEMPT",
              "OUTSIDE",
              "EXEMPT_REVERSE"
            ]
          },
          "discount": {
            "description": "Line discount in percent.",
            "type": "number",
            "minimum": 0,
            "maximum": 100
          },
          "comment": {
            "description": "Comment printed on the line.",
            "type": "string",
            "maxLength": 200
          },
          "incomeAccount": {
            "description": "Income account, if the line has no product.",
            "type": "string"
          }
        },
        "required": [
          "quantity"
        ]
      },
      "description": "The document lines."
    }
  },
  "required": [
    "companySlug",
    "customerId",
    "daysUntilDueDate",
    "lines"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

IRREVERSIBLE. Turns an invoice draft into a real invoice: it gets the next invoice number and is booked in the ledger (accounts receivable and revenue, VAT). An issued invoice cannot be deleted, only corrected with a credit note. It is NOT sent to the customer: use fiken_send_invoice for that. Only call this when the user has clearly asked to issue this exact draft. Fiken: POST /companies/{companySlug}/invoices/drafts/{draftId}/createInvoice.

{
  "type": "object",
  "properties": {
    "companySlug": {
      "type": "string",
      "minLength": 1,
      "description": "The company's slug: the `slug` field from fiken_list_companies (for example swagger-test-company)."
    },
    "draftId": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "The draftId from fiken_list_invoice_drafts or fiken_create_invoice_draft."
    }
  },
  "required": [
    "companySlug",
    "draftId"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

IRREVERSIBLE. Delivers an issued invoice to the customer by email, EHF, eFaktura, SMS or physical letter (a letter costs extra and goes to Norwegian addresses only). A sent message cannot be recalled and Fiken records the invoice as sent. Only call this when the user has clearly asked to send this exact invoice to this recipient. method lists delivery channels in priority order; Fiken uses the first one that works. Fiken: POST /companies/{companySlug}/invoices/send.

{
  "type": "object",
  "properties": {
    "companySlug": {
      "type": "string",
      "minLength": 1,
      "description": "The company's slug: the `slug` field from fiken_list_companies (for example swagger-test-company)."
    },
    "invoiceId": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "The invoiceId of an ISSUED invoice (from fiken_list_invoices)."
    },
    "method": {
      "minItems": 1,
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "email",
          "ehf",
          "efaktura",
          "sms",
          "letter",
          "auto"
        ]
      },
      "description": "Delivery channels in priority order, e.g. [\"email\"]. \"auto\" picks from what the customer has registered."
    },
    "includeDocumentAttachments": {
      "default": true,
      "description": "Include the invoice's attachments (not for letters).",
      "type": "boolean"
    },
    "recipientName": {
      "description": "Recipient name.",
      "type": "string"
    },
    "recipientEmail": {
      "description": "Recipient email (defaults to the customer's).",
      "type": "string"
    },
    "message": {
      "description": "Message sent along with the invoice.",
      "type": "string"
    },
    "emailSendOption": {
      "description": "How an email carries the invoice.",
      "type": "string",
      "enum": [
        "document_link",
        "attachment",
        "auto"
      ]
    },
    "mergeInvoiceAndAttachments": {
      "description": "Merge invoice and attachments into one PDF (with emailSendOption=attachment).",
      "type": "boolean"
    },
    "organizationNumber": {
      "description": "Recipient organization number (EHF); defaults to the customer's.",
      "type": "string"
    },
    "mobileNumber": {
      "description": "Recipient mobile number (SMS); defaults to the customer's.",
      "type": "string"
    }
  },
  "required": [
    "companySlug",
    "invoiceId",
    "method"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}