Nox Finans Invoice

This best practice example describes how to create an invoice in Fortnox and transfer it to Nox Finans ledger and factoring services.

 

Important before you start

Please note that you need to get a special sandbox instance of Fortnox to test Nox Finans services, if you are using a production sandbox, it will send out invoices and start reminder process and charge you for the service.

 

Types of services

A Fortnox user can let Nox Finans handle their customer ledger. Nox Finans offers currently four types of services

 

Ledgerbase

Service means that Nox Finans are sending invoices to end customer and coverage customer ledger with reminders and collection.

 

Reminder

Service means that the client sends the invoice to end customer. Client later sends invoices that have been over due to Nox Finans who coverage the ledger by sending reminders and collections to end customer.

 

Factoring Loan

Service means that client send an invoice to Nox Finans who using the invoice as collateral to borrow money to client.

 

Factoring Sell

Service means that client send an invoice to Nox Finans who buys the invoice and pay money for the invoice to client.

 

Precondition

 

General

  • Scope of your application registered to Fortnox must contain “Invoice Noxfinans”
  • Nox Finans services must have been activated in client database

Invoices

  • Invoice must have been created in Fortnox (Manually or by API)
  • Invoice must have an open balance >0
  • Invoice date is not allowed to be older than two years
  • Currency of Invoice must be in SEK
  • Invoice contains at least name, address, zip and city
  • Invoice must contain one invoice records
  • Interest invoices are not permitted to be sent to Nox Finans

Credit invoices

  • Credit Invoice in Fortnox must have a connection to a debit invoice
  • Debit invoice must have a open balance >= credit invoice amount

Retrieve a Nox Finans Invoice

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

Examples

Request

curl -X "GET" "https://api.fortnox.se/3/noxfinansinvoices/72" \
     -H "Access-Token: 61cf63ae-4ab9-4a95-9db5-753781c4f41f" \
     -H "Client-Secret: 3Er4kHXZTJ" \
     -H "Content-Type: application/json" \
     -H "Accept: application/json"

Response

{
 "NoxFinansInvoice": {
 "@url": "https://api.fortnox.se/3/noxfinansinvoices/72",
 "BalanceIncludeFees": 67.84,
 "BalanceIncludeFeesCurrency": 67.84,
 "CurrentCapitalBalance": 67.84,
 "CurrentCapitalBalanceCurrency": 67.84,
 "InvoiceDocumentURL": "https://doc.noxfinans.se/documents/f0206b41-bc35-48c6-b630-7dd3a02ca5e2.pdf",
 "InvoiceNumber": "72",
 "NextEvent": "COLLECTION",
 "NextEventDate": "2015-06-25",
 "OCRNumber": "002638100105050",
 "Service": "LEDGERBASE",
 "Status": "PAUSED"
 }
}

Send a Nox Finans invoice

When sending an invoice to Nox Finans you will get the invoice status returned if everything succeeded, if there was any problems an error will be returned.

Please note that it can take 1 min to several hours before you will get back status, ocr number and link to PDF document, meanwhile the invoice will have status UNKNOWN or NOT_AUTHORIZED.

Nox Finans is today only accept invoices in SEK.

Examples

Request

curl -X "GET" "https://api.fortnox.se/3/noxfinansinvoices" \
     -H "Access-Token: 61cf63ae-4ab9-4a95-9db5-753781c4f41f" \
     -H "Client-Secret: 3Er4kHXZTJ" \
     -H "Content-Type: application/json" \
     -H "Accept: application/json"
     -d $'{
 "NoxFinansInvoice": {
  "InvoiceNumber": "7201",
  "SendMethod": "LETTER",
  "Service": "LEDGERBASE"
  }
}

Response

{
 "NoxFinansInvoice": {
 "@url": "https://api.fortnox.se/3/noxfinansinvoices/7201",
 "BalanceIncludeFees": null,
 "BalanceIncludeFeesCurrency": null,
 "CurrentCapitalBalance": null,
 "CurrentCapitalBalanceCurrency": null,
 "InvoiceDocumentURL": "https://doc.noxfinans.se/documents/",
 "InvoiceNumber": "7201",
 "NextEvent": null,
 "NextEventDate": null,
 "OCRNumber": null,
 "Service": "LEDGERBASE",
 "Status": "UNKNOWN"
 }
}

Actions

Name Description
Pause Temporarily pause an invoice up to 60 days. Pause means that Nox Finans reminder process will stop for the invoice. Pause can be made for all invoices that not have status OPEN.
Stop Removes the invoice from Nox Finans process.

For information about how to use actions, please read this article.

Properties

Name Description
BalanceIncludeFees float, read-only
Balance fees in currency in SEK
BalanceIncludeFeesCurrency float, read-only
Balance fees in currency (today is only SEK available)
CurrentCapitalBalance float, read-only
Capital amount balance in SEK
CurrentCapitalBalanceCurrency float, read-only
Capital amount balance in currency (today is only SEK available)
InvoiceDocumentURL string, read-only
URL to PDF document for invoice
InvoiceNumber integer, read-only
Invoice number in Fortnox
NextEvent float, read-only
INVOICEREMINDER
REMINDER
COLLECTION
EXECUTIONCONTROLL
MONITORING
NextEventDate Date, read-only
OCRNumber string, read-only
OCR number generated by Nox Finans.
Service string
LEDGERBASE
REIMDER
FACTORING_LOAN
FACTORING_SELL
SendMethod string
EMAIL = EmailNONE = Nox Finans do not distribute invoice (can not be selected on Reminder service)
LETTER = Send by letter
Status string, read-only
UNKOWN = Not yet confirmed by Nox Finans
NOT_AUTHORIZED = Factoring invoice waiting approval
OPEN = Open
PAUSED = Invoice pause
CLOSED  = Invoice is closed

Best Practice

Send invoices

Distribution method

When sending an invoice to Nox Finans user shall input a valid distribution method.

LETTER means that Nox Finans will send invoice by letter to end customer (For service reminder this is the only option)

 

EMAIL means that Nox Finans will send invoice by email to end customer

 

NONE means that Nox Finans will coverage customer ledger but will not send out any invoices. This functions shall be used if client have an agreement with Nox Finans to distribute the invoice by them self .

 

Service

LEDGERBASE, REMINDER, FACTORING_LOAN, or FACTORING_SELL

Post

Url:

https://api.fortnox.se/3/noxfinansinvoices/

Request

{    “NoxFinansInvoice”: {            “InvoiceNumber”: “7200”,            “SendMethod”: “LETTER”,            “Service”: “LEDGERBASE”

   }

}

 

Response
If request is successful Nox Finans response information about invoice, otherwise error message. Please note that most of the response is null data. It takes Nox Finans from some min to several hours to confirm, meanwhile the invoice have status UNKNOWN or NOT_AUTHORIZED.

{  “NoxFinansInvoice”: {    “@url”: “https://api.fortnox.se/3/noxfinansinvoices/7200”,    “BalanceIncludeFees”: null,    “BalanceIncludeFeesCurrency”: null,

   “CurrentCapitalBalance”: null,

   “CurrentCapitalBalanceCurrency”: null,

   “InvoiceDocumentURL”: null,

   “InvoiceNumber”: “7200”,

   “NextEvent”: null,

   “NextEventDate”: null,

   “OCRNumber”: null,

   “Service”: “LEDGERBASE”,

   “Status”: “UNKNOWN”

 }

}

 

Request status of invoice

GET

Url:

https://api.fortnox.se/3/noxfinansinvoices/(INVOICENUMBER)

 

Response

If an invoice are confirmed Nox Finans will return information of balance of invoice with and without possible reminder fees. Response also contain url to invoice PDF, current status and generated ocr number.

 

Response if invoice is confirmed

{
 “NoxFinansInvoice”: {
   “@url”: “https://api.fortnox.se/3/noxfinansinvoices/7200”,
   “BalanceIncludeFees”: 693.75,
   “BalanceIncludeFeesCurrency”: 693.75,
   “CurrentCapitalBalance”: 693.75,
   “CurrentCapitalBalanceCurrency”: 693.75,
   “InvoiceDocumentURL”: “https://doc.noxfinans.se/documents/de8a3bbb-184e-4329-8e81-32d4edcba9f4.pdf”,
   “InvoiceNumber”: “7200”,
   “NextEvent”: “INVOICEREMINDER”,
   “NextEventDate”: “2017-05-10”,
   “OCRNumber”: “002638101082357”,
   “Service”: “LEDGERBASE”,
   “Status”: “OPEN”
 }
}

 

Response if invoice is waiting confirmation

{  “ErrorInformation”: {    “error”: 1,    “message”: “Fakturan bearbetas i Nox Finans. Prova igen om en stund.”,    “code”: 2002866

 }

}

 

Paus Fortnox invoice

PUT

Url:

https://api.fortnox.se/3/noxfinansinvoices/{InvoiceId}/pause

Request Body:

{

“date” : “2018-02-28”,

“onHoldCode” : “NOX”

}