invantive documentation
Invantive Support ForumsLog In / Sign Up

FinancialInvoiceByNumber: Fortnox Financial Invoice by Number

read only REST

  • Catalog: Fortnox
  • Schema: FinanceInvoices
  • Label: Financial Invoice by Number

Retrieve a single invoice payment

Retrieves the status and balance of an invoice sent to Fortnox Finans. You need to supply the invoice number in Fortox to retrieve the invoice.

Note that invoices sent with the old "Noxbox" platform will not have the "ServiceName" property in the response. This new property is added to the response if the invoice is sent with the new finance service.

Response explanation for Service and ServiceName

Service:

 LEDGERBASE: if the invoice is sent by using the old "Noxbox" platform, or the new finance service with the subtypes "Service Full" or "Service Light". These services are explained above in the "Fortnox Finans services" section
 REMINDER: If the invoice is sent by the new finance service, with the service Reminder Service

ServiceName (only provided for new finance service invoices):

 SERVICE_FULL: Ledgerbase service with automatic reminders is used
 SERVICE_LIGHT: Ledgerbase service without automatic reminders is used.
 REMINDER_SERVICE: Reminder service is used

Can only retrieve data.

Summary

Retrieves the status and balance of an invoice sent to Fortnox Finans. You need to supply the invoice number in Fortox to retrieve the invoice.

Note that invoices sent with the old "Noxbox" platform will not have the "ServiceName" property in the response. This new property is added to the response if the invoice is sent with the new finance service.

Response explanation for Service and ServiceName

Service:

  • LEDGERBASE: if the invoice is sent by using the old "Noxbox" platform, or the new finance service with the subtypes "Service Full" or "Service Light". These services are explained above in the "Fortnox Finans services" section
  • REMINDER: If the invoice is sent by the new finance service, with the service Reminder Service

ServiceName (only provided for new finance service invoices):

  • SERVICE_FULL: Ledgerbase service with automatic reminders is used
  • SERVICE_LIGHT: Ledgerbase service without automatic reminders is used.
  • REMINDER_SERVICE: Reminder service is used

API Source

  • Endpoint: /3/noxfinansinvoices/{Number}
  • Operation: get /3/noxfinansinvoices/{Number}

Performance Characteristics

Characteristic Value
Average access latency (ms) 356
Full scan rows per minute 85,000
Point query rows per minute 168

The result can be cached on the client.

Parameters

Name Data Type Required Default Documentation
financialyear `` Selects what financial year that should be used (does not work on every table).
financialyeardate `` Selects by date, what financial year that should be used (does not work on every table).
fromdate `` Defines a selection based on a start date. Only available for invoices, orders, offers, vouchers and supplierinvoices (does not work on every table).
lastmodified `` Retrieves all records since the provided timestamp (does not work on every table).
Number `` The Fortnox invoice number
todate `` Defines a selection based on an end date. Only available for invoices, orders, offers, vouchers and supplierinvoices (does not work on every table).

Table Columns

The columns of the table FinancialInvoiceByNumber are shown below. Each column has an SQL data type. A new non-null value must be provided for every required column at all times during insert and update.

Name Data Type Label Required Marks Documentation
NoxFinansInvoice_BalanceIncludeFees double Nox Finans Invoice Balance Include Fees filters on the platform, writable, NoxFinansInvoice.BalanceIncludeFees
NoxFinansInvoice_BalanceIncludeFeesCurrency double Nox Finans Invoice Balance Include Fees Currency filters on the platform, writable, NoxFinansInvoice.BalanceIncludeFeesCurrency
NoxFinansInvoice_CurrentCapitalBalance double Nox Finans Invoice Current Capital Balance filters on the platform, writable, NoxFinansInvoice.CurrentCapitalBalance
NoxFinansInvoice_CurrentCapitalBalanceCurrency double Nox Finans Invoice Current Capital Balance Currency filters on the platform, writable, NoxFinansInvoice.CurrentCapitalBalanceCurrency
NoxFinansInvoice_InvoiceDocumentURL varchar2 Nox Finans Invoice Document URL filters on the platform, writable, NoxFinansInvoice.InvoiceDocumentURL
NoxFinansInvoice_InvoiceNumber int32 Nox Finans Invoice Number filters on the platform, writable, NoxFinansInvoice.InvoiceNumber
NoxFinansInvoice_NextEvent varchar2 Nox Finans Invoice Next Event filters on the platform, writable, NoxFinansInvoice.NextEvent
NoxFinansInvoice_NextEventDate datetime Nox Finans Invoice Next Event Date filters on the platform, writable, NoxFinansInvoice.NextEventDate
NoxFinansInvoice_OCRNumber varchar2 Nox Finans Invoice Ocr Number filters on the platform, writable, NoxFinansInvoice.OCRNumber
NoxFinansInvoice_Service varchar2 Nox Finans Invoice Service filters on the platform, writable, NoxFinansInvoice.Service
NoxFinansInvoice_ServiceName varchar2 Nox Finans Invoice Service Name filters on the platform, writable, NoxFinansInvoice.ServiceName
NoxFinansInvoice_Status varchar2 Nox Finans Invoice Status filters on the platform, writable, NoxFinansInvoice.Status
NoxFinansInvoice__url varchar2 Nox Finans Invoice URL filters on the platform, writable, NoxFinansInvoice.@url

Release Notes

What changed per release in the tables, columns, attributes and capabilities of the driver: