List all invoices

Retrieves a list of invoices. The invoices are returned sorted by document number with the lowest number appearing first.

Examples

Request

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

Response

{
    "Invoices": [
        {
            "@url": "https://api.fortnox.se/3/invoices/1",
            "Balance": 1250,
            "Booked": false,
            "Cancelled": false,
            "Currency": "SEK",
            "CurrencyRate": "1",
            "CurrencyUnit": 1,
            "CustomerName": "Kund 100048",
            "CustomerNumber": "100048",
            "DocumentNumber": "1",
            "DueDate": "2014-12-12",
            "ExternalInvoiceReference1": "",
            "ExternalInvoiceReference2": "",
            "InvoiceDate": "2014-11-11",
            "NoxFinans": true,
            "OCR": "133",
            "Project": "",
            "Sent": false,
            "TermsOfPayment": "60",
            "Total": 1250,
            "WayOfDelivery": ""
        },

       [...] 

        {
            "@url": "https://api.fortnox.se/3/invoices/3",
            "Balance": 0,
            "Booked": false,
            "Cancelled": true,
            "Currency": "SEK",
            "CurrencyRate": "1",
            "CurrencyUnit": 1,
            "CustomerName": "Kund 100048",
            "CustomerNumber": "100048",
            "DocumentNumber": "3",
            "DueDate": "2015-01-01",
            "ExternalInvoiceReference1": "",
            "ExternalInvoiceReference2": "",
            "InvoiceDate": "2014-12-02",
            "OCR": "332",
            "Project": "",
            "Sent": false,
            "TermsOfPayment": "30",
            "Total": 5500,
            "WayOfDelivery": ""
        }
    ],
    "MetaInformation": {
        "@CurrentPage": 1,
        "@TotalPages": 3,
        "@TotalResources": 203
    }
}

Using Guzzle

Request

// Include Guzzle. If using Composer:
// require 'vendor/autoload.php';

use GuzzleHttp\Client;
use GuzzleHttp\Exception\RequestException;

function send_request() {
    // Invoices (GET https://api.fortnox.se/3/invoices)

    $client = new Client();
    $request = $client->createRequest('GET', 'https://api.fortnox.se/3/invoices');

    try {
        $request->addHeaders([
            'Access-Token'=>'61cf63ae-4ab9-4a95-9db5-753781c4f41f',
            'Client-Secret'=>'3Er4kHXZTJ',
            'Content-Type'=>'application/json',
            'Accept'=>'application/json',
        ]);

        $response = $client->send($request);
        echo "Response HTTP : " . $response->getStatusCode();
    }
    catch (RequestException $e) {
        echo "HTTP Request failed\n";
        echo $e->getRequest();
        if ($e->hasResponse()) {
            echo $e->getResponse();
        }
    }
}

Response

{
    "Invoices": [
        {
            "@url": "https://api.fortnox.se/3/invoices/1",
            "Balance": 1250,
            "Booked": false,
            "Cancelled": false,
            "Currency": "SEK",
            "CurrencyRate": "1",
            "CurrencyUnit": 1,
            "CustomerName": "Kund 100048",
            "CustomerNumber": "100048",
            "DocumentNumber": "1",
            "DueDate": "2014-12-12",
            "ExternalInvoiceReference1": "",
            "ExternalInvoiceReference2": "",
            "InvoiceDate": "2014-11-11",
            "OCR": "133",
            "Project": 0,
            "Sent": false,
            "TermsOfPayment": "60",
            "Total": 1250,
            "WayOfDelivery": ""
        },

       [...] 

        {
            "@url": "https://api.fortnox.se/3/invoices/3",
            "Balance": 0,
            "Booked": false,
            "Cancelled": true,
            "Currency": "SEK",
            "CurrencyRate": "1",
            "CurrencyUnit": 1,
            "CustomerName": "Kund 100048",
            "CustomerNumber": "100048",
            "DocumentNumber": "3",
            "DueDate": "2015-01-01",
            "ExternalInvoiceReference1": "",
            "ExternalInvoiceReference2": "",
            "InvoiceDate": "2014-12-02",
            "OCR": "332",
            "Project": 0,
            "Sent": false,
            "TermsOfPayment": "30",
            "Total": 5500,
            "WayOfDelivery": ""
        }
    ],
    "MetaInformation": {
        "@CurrentPage": 1,
        "@TotalPages": 3,
        "@TotalResources": 203
    }
}

Request

require 'net/http'

def send_request
  # Invoices (GET )

  begin
    uri = URI('https://api.fortnox.se/3/invoices')

    # Create client
    http = Net::HTTP.new(uri.host, uri.port)

    # Create Request
    req =  Net::HTTP::Get.new(uri)
    # Add headers
    req.add_field "Access-Token", "61cf63ae-4ab9-4a95-9db5-753781c4f41f"
    # Add headers
    req.add_field "Client-Secret", "3Er4kHXZTJ"
    # Add headers
    req.add_field "Content-Type", "application/json"
    # Add headers
    req.add_field "Accept", "application/json"

    # Fetch Request
    res = http.request(req)
    puts "Response HTTP Status Code: #{res.code}"
    puts "Response HTTP Response Body: #{res.body}"
  rescue Exception => e
    puts "HTTP Request failed (#{e.message})"
  end
end

Response

{
    "Invoices": [
        {
            "@url": "https://api.fortnox.se/3/invoices/1",
            "Balance": 1250,
            "Booked": false,
            "Cancelled": false,
            "Currency": "SEK",
            "CurrencyRate": "1",
            "CurrencyUnit": 1,
            "CustomerName": "Kund 100048",
            "CustomerNumber": "100048",
            "DocumentNumber": "1",
            "DueDate": "2014-12-12",
            "ExternalInvoiceReference1": "",
            "ExternalInvoiceReference2": "",
            "InvoiceDate": "2014-11-11",
            "OCR": "133",
            "Project": 0,
            "Sent": false,
            "TermsOfPayment": "60",
            "Total": 1250,
            "WayOfDelivery": ""
        },

       [...] 

        {
            "@url": "https://api.fortnox.se/3/invoices/3",
            "Balance": 0,
            "Booked": false,
            "Cancelled": true,
            "Currency": "SEK",
            "CurrencyRate": "1",
            "CurrencyUnit": 1,
            "CustomerName": "Kund 100048",
            "CustomerNumber": "100048",
            "DocumentNumber": "3",
            "DueDate": "2015-01-01",
            "ExternalInvoiceReference1": "",
            "ExternalInvoiceReference2": "",
            "InvoiceDate": "2014-12-02",
            "OCR": "332",
            "Project": 0,
            "Sent": false,
            "TermsOfPayment": "30",
            "Total": 5500,
            "WayOfDelivery": ""
        }
    ],
    "MetaInformation": {
        "@CurrentPage": 1,
        "@TotalPages": 3,
        "@TotalResources": 203
    }
}

Request

# Install the Python Requests library:
# `pip install requests`

import requests

def send_request():
    # Invoices (GET https://api.fortnox.se/3/invoices)

    try:
        r = requests.get(
            url="https://api.fortnox.se/3/invoices",
            headers = {
                "Access-Token":"61cf63ae-4ab9-4a95-9db5-753781c4f41f",
                "Client-Secret":"3Er4kHXZTJ",
                "Content-Type":"application/json",
                "Accept":"application/json",
            },
        )
        print('Response HTTP Status Code : {status_code}'.format(status_code=r.status_code))
        print('Response HTTP Response Body : {content}'.format(content=r.content))
    except requests.exceptions.RequestException as e:
        print('HTTP Request failed')

Response

{
    "Invoices": [
        {
            "@url": "https://api.fortnox.se/3/invoices/1",
            "Balance": 1250,
            "Booked": false,
            "Cancelled": false,
            "Currency": "SEK",
            "CurrencyRate": "1",
            "CurrencyUnit": 1,
            "CustomerName": "Kund 100048",
            "CustomerNumber": "100048",
            "DocumentNumber": "1",
            "DueDate": "2014-12-12",
            "ExternalInvoiceReference1": "",
            "ExternalInvoiceReference2": "",
            "InvoiceDate": "2014-11-11",
            "OCR": "133",
            "Project": 0,
            "Sent": false,
            "TermsOfPayment": "60",
            "Total": 1250,
            "WayOfDelivery": ""
        },

       [...] 

        {
            "@url": "https://api.fortnox.se/3/invoices/3",
            "Balance": 0,
            "Booked": false,
            "Cancelled": true,
            "Currency": "SEK",
            "CurrencyRate": "1",
            "CurrencyUnit": 1,
            "CustomerName": "Kund 100048",
            "CustomerNumber": "100048",
            "DocumentNumber": "3",
            "DueDate": "2015-01-01",
            "ExternalInvoiceReference1": "",
            "ExternalInvoiceReference2": "",
            "InvoiceDate": "2014-12-02",
            "OCR": "332",
            "Project": 0,
            "Sent": false,
            "TermsOfPayment": "30",
            "Total": 5500,
            "WayOfDelivery": ""
        }
    ],
    "MetaInformation": {
        "@CurrentPage": 1,
        "@TotalPages": 3,
        "@TotalResources": 203
    }
}

Using our .NET SDK

Request

InvoiceConnector connector = new InvoiceConnector();
Invoices result = connector.Find();

Retrieve an invoice

Retrieves the details of an invoice. You need to supply the unique document number that was returned when the invoice was created or retrieved from the list of invoices.

Examples

Request

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

Response

{
    "Invoice": {
        "@url": "https://api.fortnox.se/3/invoices/203",
        "@urlTaxReductionList": "https://api.fortnox.se/3/taxreductions?filter=invoices&referencenumber=203",
        "Address1": "",
        "Address2": "",
        "AdministrationFee": 0,
        "AdministrationFeeVAT": 0,
        "Balance": 2106,
        "BasisTaxReduction": 0,
        "Booked": false,
        "Cancelled": false,
        "City": "",
        "Comments": "",
        "ContractReference": 0,
        "ContributionPercent": 37.740000000000002,
        "ContributionValue": 600,
        "CostCenter": "",
        "Country": "",
        "Credit": "false",
        "CreditInvoiceReference": "0",
        "Currency": "SEK",
        "CurrencyRate": 1,
        "CurrencyUnit": 1,
        "CustomerName": "Kund 100092",
        "CustomerNumber": "100092",
        "DeliveryAddress1": "",
        "DeliveryAddress2": "",
        "DeliveryCity": "",
        "DeliveryCountry": "",
        "DeliveryDate": null,
        "DeliveryName": "",
        "DeliveryZipCode": "",
        "DocumentNumber": "203",
        "DueDate": "2015-02-07",
        "EDIInformation": {
            "EDIGlobalLocationNumber": "",
            "EDIGlobalLocationNumberDelivery": "",
            "EDIInvoiceExtra1": "",
            "EDIInvoiceExtra2": "",
            "EDIOurElectronicReference": "",
            "EDIYourElectronicReference": ""
        },
        "EUQuarterlyReport": false,
        "EmailInformation": {
            "EmailAddressBCC": null,
            "EmailAddressCC": null,
            "EmailAddressFrom": null,
            "EmailAddressTo": "",
            "EmailBody": "Faktura nummer {no} bifogas ",
            "EmailSubject": "Detta \u00e4r din faktura"
        },
        "ExternalInvoiceReference1": "",
        "ExternalInvoiceReference2": "",
        "Freight": 95,
        "FreightVAT": 23.75,
        "Gross": 1590,
        "HouseWork": false,
        "InvoiceDate": "2015-01-08",
        "InvoicePeriodEnd": "",
        "InvoicePeriodStart": "",
        "InvoiceReference": "0",
        "InvoiceRows": [
            {
                "AccountNumber": 3011,
                "ArticleNumber": "66892",
                "ContributionPercent": 37.740000000000002,
                "ContributionValue": 600,
                "CostCenter": null,
                "DeliveredQuantity": "10.00",
                "Description": "USB-minne 32GB",
                "Discount": 0,
                "DiscountType": "PERCENT",
                "HouseWork": false,
                "HouseWorkHoursToReport": null,
                "HouseWorkType": null,
                "Price": 159,
                "PriceExcludingVAT": 159,
                "Project": "",
                "Total": 1590,
                "TotalExcludingVAT": 1590,
                "Unit": "st",
                "VAT": 25
            }
        ],
        "InvoiceType": "INVOICE",
        "Labels": [
            {
                "Id": 5
            },
            {
                "Id": 11
            }
        ],
        "Language": "SV",
        "LastRemindDate": null,
        "Net": 1590,
        "NotCompleted": false,
        "NoxFinans": true,
        "OCR": "20354",
        "OfferReference": "0",
        "OrderReference": "0",
        "OrganisationNumber": "",
        "OurReference": "Jocke",
        "PaymentWay": "",
        "Phone1": "",
        "Phone2": "",
        "PriceList": "A",
        "PrintTemplate": "st",
        "Project": "",
        "Remarks": "",
        "Reminders": 0,
        "RoundOff": -0.25,
        "Sent": false,
        "TaxReduction": null,
        "TermsOfDelivery": "",
        "TermsOfPayment": "30",
        "Total": 2106,
        "TotalToPay": 2106,
        "TotalVAT": 421.25,
        "VATIncluded": false,
        "VoucherNumber": null,
        "VoucherSeries": null,
        "VoucherYear": null,
        "WayOfDelivery": "",
        "YourOrderNumber": "",
        "YourReference": "",
        "ZipCode": ""
    }
}

Using Guzzle

Request

// Include Guzzle. If using Composer:
// require 'vendor/autoload.php';

use GuzzleHttp\Client;
use GuzzleHttp\Exception\RequestException;

function send_request() {
    // Invoices (GET https://api.fortnox.se/3/invoices/203)

    $client = new Client();
    $request = $client->createRequest('GET', 'https://api.fortnox.se/3/invoices/203');

    try {
        $request->addHeaders([
            'Access-Token'=>'61cf63ae-4ab9-4a95-9db5-753781c4f41f',
            'Client-Secret'=>'3Er4kHXZTJ',
            'Content-Type'=>'application/json',
            'Accept'=>'application/json',
        ]);

        $response = $client->send($request);
        echo "Response HTTP : " . $response->getStatusCode();
    }
    catch (RequestException $e) {
        echo "HTTP Request failed\n";
        echo $e->getRequest();
        if ($e->hasResponse()) {
            echo $e->getResponse();
        }
    }
}

Response

{
    "Invoice": {
        "@url": "https://api.fortnox.se/3/invoices/203",
        "@urlTaxReductionList": "https://api.fortnox.se/3/taxreductions?filter=invoices&referencenumber=203",
        "Address1": "",
        "Address2": "",
        "AdministrationFee": 0,
        "AdministrationFeeVAT": 0,
        "Balance": 2106,
        "BasisTaxReduction": 0,
        "Booked": false,
        "Cancelled": false,
        "City": "",
        "Comments": "",
        "ContractReference": 0,
        "ContributionPercent": 37.740000000000002,
        "ContributionValue": 600,
        "CostCenter": "",
        "Country": "",
        "Credit": "false",
        "CreditInvoiceReference": "0",
        "Currency": "SEK",
        "CurrencyRate": 1,
        "CurrencyUnit": 1,
        "CustomerName": "Kund 100092",
        "CustomerNumber": "100092",
        "DeliveryAddress1": "",
        "DeliveryAddress2": "",
        "DeliveryCity": "",
        "DeliveryCountry": "",
        "DeliveryDate": null,
        "DeliveryName": "",
        "DeliveryZipCode": "",
        "DocumentNumber": "203",
        "DueDate": "2015-02-07",
        "EDIInformation": {
            "EDIGlobalLocationNumber": "",
            "EDIGlobalLocationNumberDelivery": "",
            "EDIInvoiceExtra1": "",
            "EDIInvoiceExtra2": "",
            "EDIOurElectronicReference": "",
            "EDIYourElectronicReference": ""
        },
        "EUQuarterlyReport": false,
        "EmailInformation": {
            "EmailAddressBCC": null,
            "EmailAddressCC": null,
            "EmailAddressFrom": null,
            "EmailAddressTo": "",
            "EmailBody": "Faktura nummer {no} bifogas ",
            "EmailSubject": "Detta \u00e4r din faktura"
        },
        "ExternalInvoiceReference1": "",
        "ExternalInvoiceReference2": "",
        "Freight": 95,
        "FreightVAT": 23.75,
        "Gross": 1590,
        "HouseWork": false,
        "InvoiceDate": "2015-01-08",
        "InvoicePeriodEnd": "",
        "InvoicePeriodStart": "",
        "InvoiceReference": "0",
        "InvoiceRows": [
            {
                "AccountNumber": 3011,
                "ArticleNumber": "66892",
                "ContributionPercent": 37.740000000000002,
                "ContributionValue": 600,
                "CostCenter": null,
                "DeliveredQuantity": "10.00",
                "Description": "USB-minne 32GB",
                "Discount": 0,
                "DiscountType": "PERCENT",
                "HouseWork": false,
                "HouseWorkHoursToReport": null,
                "HouseWorkType": null,
                "Price": 159,
                "Project": null,
                "Total": 1590,
                "Unit": "st",
                "VAT": 25
            }
        ],
        "InvoiceType": "INVOICE",
        "Labels": [
            {
                "Id": 5
            },
            {
                "Id": 11
            }
        ],
        "Language": "SV",
        "LastRemindDate": null,
        "Net": 1590,
        "NotCompleted": false,
        "OCR": "20354",
        "OfferReference": "0",
        "OrderReference": "0",
        "OrganisationNumber": "",
        "OurReference": "Jocke",
        "PaymentWay": "",
        "Phone1": "",
        "Phone2": "",
        "PriceList": "A",
        "PrintTemplate": "st",
        "Project": 0,
        "Remarks": "",
        "Reminders": 0,
        "RoundOff": -0.25,
        "Sent": false,
        "TaxReduction": null,
        "TermsOfDelivery": "",
        "TermsOfPayment": "30",
        "Total": 2106,
        "TotalToPay": 2106,
        "TotalVAT": 421.25,
        "VATIncluded": false,
        "VoucherNumber": null,
        "VoucherSeries": null,
        "VoucherYear": null,
        "WayOfDelivery": "",
        "YourOrderNumber": "",
        "YourReference": "",
        "ZipCode": ""
    }
}

Request

require 'net/http'

def send_request
  # Invoices (GET )

  begin
    uri = URI('https://api.fortnox.se/3/invoices/203')

    # Create client
    http = Net::HTTP.new(uri.host, uri.port)

    # Create Request
    req =  Net::HTTP::Get.new(uri)
    # Add headers
    req.add_field "Access-Token", "61cf63ae-4ab9-4a95-9db5-753781c4f41f"
    # Add headers
    req.add_field "Client-Secret", "3Er4kHXZTJ"
    # Add headers
    req.add_field "Content-Type", "application/json"
    # Add headers
    req.add_field "Accept", "application/json"

    # Fetch Request
    res = http.request(req)
    puts "Response HTTP Status Code: #{res.code}"
    puts "Response HTTP Response Body: #{res.body}"
  rescue Exception => e
    puts "HTTP Request failed (#{e.message})"
  end
end

Response

{
    "Invoice": {
        "@url": "https://api.fortnox.se/3/invoices/203",
        "@urlTaxReductionList": "https://api.fortnox.se/3/taxreductions?filter=invoices&referencenumber=203",
        "Address1": "",
        "Address2": "",
        "AdministrationFee": 0,
        "AdministrationFeeVAT": 0,
        "Balance": 2106,
        "BasisTaxReduction": 0,
        "Booked": false,
        "Cancelled": false,
        "City": "",
        "Comments": "",
        "ContractReference": 0,
        "ContributionPercent": 37.740000000000002,
        "ContributionValue": 600,
        "CostCenter": "",
        "Country": "",
        "Credit": "false",
        "CreditInvoiceReference": "0",
        "Currency": "SEK",
        "CurrencyRate": 1,
        "CurrencyUnit": 1,
        "CustomerName": "Kund 100092",
        "CustomerNumber": "100092",
        "DeliveryAddress1": "",
        "DeliveryAddress2": "",
        "DeliveryCity": "",
        "DeliveryCountry": "",
        "DeliveryDate": null,
        "DeliveryName": "",
        "DeliveryZipCode": "",
        "DocumentNumber": "203",
        "DueDate": "2015-02-07",
        "EDIInformation": {
            "EDIGlobalLocationNumber": "",
            "EDIGlobalLocationNumberDelivery": "",
            "EDIInvoiceExtra1": "",
            "EDIInvoiceExtra2": "",
            "EDIOurElectronicReference": "",
            "EDIYourElectronicReference": ""
        },
        "EUQuarterlyReport": false,
        "EmailInformation": {
            "EmailAddressBCC": null,
            "EmailAddressCC": null,
            "EmailAddressFrom": null,
            "EmailAddressTo": "",
            "EmailBody": "Faktura nummer {no} bifogas ",
            "EmailSubject": "Detta \u00e4r din faktura"
        },
        "ExternalInvoiceReference1": "",
        "ExternalInvoiceReference2": "",
        "Freight": 95,
        "FreightVAT": 23.75,
        "Gross": 1590,
        "HouseWork": false,
        "InvoiceDate": "2015-01-08",
        "InvoicePeriodEnd": "",
        "InvoicePeriodStart": "",
        "InvoiceReference": "0",
        "InvoiceRows": [
            {
                "AccountNumber": 3011,
                "ArticleNumber": "66892",
                "ContributionPercent": 37.740000000000002,
                "ContributionValue": 600,
                "CostCenter": null,
                "DeliveredQuantity": "10.00",
                "Description": "USB-minne 32GB",
                "Discount": 0,
                "DiscountType": "PERCENT",
                "HouseWork": false,
                "HouseWorkHoursToReport": null,
                "HouseWorkType": null,
                "Price": 159,
                "Project": null,
                "Total": 1590,
                "Unit": "st",
                "VAT": 25
            }
        ],
        "InvoiceType": "INVOICE",
        "Labels": [
            {
                "Id": 5
            },
            {
                "Id": 11
            }
        ],
        "Language": "SV",
        "LastRemindDate": null,
        "Net": 1590,
        "NotCompleted": false,
        "OCR": "20354",
        "OfferReference": "0",
        "OrderReference": "0",
        "OrganisationNumber": "",
        "OurReference": "Jocke",
        "PaymentWay": "",
        "Phone1": "",
        "Phone2": "",
        "PriceList": "A",
        "PrintTemplate": "st",
        "Project": 0,
        "Remarks": "",
        "Reminders": 0,
        "RoundOff": -0.25,
        "Sent": false,
        "TaxReduction": null,
        "TermsOfDelivery": "",
        "TermsOfPayment": "30",
        "Total": 2106,
        "TotalToPay": 2106,
        "TotalVAT": 421.25,
        "VATIncluded": false,
        "VoucherNumber": null,
        "VoucherSeries": null,
        "VoucherYear": null,
        "WayOfDelivery": "",
        "YourOrderNumber": "",
        "YourReference": "",
        "ZipCode": ""
    }
}

Request

# Install the Python Requests library:
# `pip install requests`

import requests

def send_request():
    # Invoices (GET https://api.fortnox.se/3/invoices/203)

    try:
        r = requests.get(
            url="https://api.fortnox.se/3/invoices/203",
            headers = {
                "Access-Token":"81cf63ae-4ab9-4b95-9db5-754780c4f61f",
                "Client-Secret":"7Er4jHXZVJ",
                "Content-Type":"application/json",
                "Accept":"application/json",
            },
        )
        print('Response HTTP Status Code : {status_code}'.format(status_code=r.status_code))
        print('Response HTTP Response Body : {content}'.format(content=r.content))
    except requests.exceptions.RequestException as e:
        print('HTTP Request failed')

Response

{
    "Invoice": {
        "@url": "https://api.fortnox.se/3/invoices/203",
        "@urlTaxReductionList": "https://api.fortnox.se/3/taxreductions?filter=invoices&referencenumber=203",
        "Address1": "",
        "Address2": "",
        "AdministrationFee": 0,
        "AdministrationFeeVAT": 0,
        "Balance": 2106,
        "BasisTaxReduction": 0,
        "Booked": false,
        "Cancelled": false,
        "City": "",
        "Comments": "",
        "ContractReference": 0,
        "ContributionPercent": 37.740000000000002,
        "ContributionValue": 600,
        "CostCenter": "",
        "Country": "",
        "Credit": "false",
        "CreditInvoiceReference": "0",
        "Currency": "SEK",
        "CurrencyRate": 1,
        "CurrencyUnit": 1,
        "CustomerName": "Kund 100092",
        "CustomerNumber": "100092",
        "DeliveryAddress1": "",
        "DeliveryAddress2": "",
        "DeliveryCity": "",
        "DeliveryCountry": "",
        "DeliveryDate": null,
        "DeliveryName": "",
        "DeliveryZipCode": "",
        "DocumentNumber": "203",
        "DueDate": "2015-02-07",
        "EDIInformation": {
            "EDIGlobalLocationNumber": "",
            "EDIGlobalLocationNumberDelivery": "",
            "EDIInvoiceExtra1": "",
            "EDIInvoiceExtra2": "",
            "EDIOurElectronicReference": "",
            "EDIYourElectronicReference": ""
        },
        "EUQuarterlyReport": false,
        "EmailInformation": {
            "EmailAddressBCC": null,
            "EmailAddressCC": null,
            "EmailAddressFrom": null,
            "EmailAddressTo": "",
            "EmailBody": "Faktura nummer {no} bifogas ",
            "EmailSubject": "Detta \u00e4r din faktura"
        },
        "ExternalInvoiceReference1": "",
        "ExternalInvoiceReference2": "",
        "Freight": 95,
        "FreightVAT": 23.75,
        "Gross": 1590,
        "HouseWork": false,
        "InvoiceDate": "2015-01-08",
        "InvoicePeriodEnd": "",
        "InvoicePeriodStart": "",
        "InvoiceReference": "0",
        "InvoiceRows": [
            {
                "AccountNumber": 3011,
                "ArticleNumber": "66892",
                "ContributionPercent": 37.740000000000002,
                "ContributionValue": 600,
                "CostCenter": null,
                "DeliveredQuantity": "10.00",
                "Description": "USB-minne 32GB",
                "Discount": 0,
                "DiscountType": "PERCENT",
                "HouseWork": false,
                "HouseWorkHoursToReport": null,
                "HouseWorkType": null,
                "Price": 159,
                "Project": null,
                "Total": 1590,
                "Unit": "st",
                "VAT": 25
            }
        ],
        "InvoiceType": "INVOICE",
        "Labels": [
            {
                "Id": 5
            },
            {
                "Id": 11
            }
        ],
        "Language": "SV",
        "LastRemindDate": null,
        "Net": 1590,
        "NotCompleted": false,
        "OCR": "20354",
        "OfferReference": "0",
        "OrderReference": "0",
        "OrganisationNumber": "",
        "OurReference": "Jocke",
        "PaymentWay": "",
        "Phone1": "",
        "Phone2": "",
        "PriceList": "A",
        "PrintTemplate": "st",
        "Project": 0,
        "Remarks": "",
        "Reminders": 0,
        "RoundOff": -0.25,
        "Sent": false,
        "TaxReduction": null,
        "TermsOfDelivery": "",
        "TermsOfPayment": "30",
        "Total": 2106,
        "TotalToPay": 2106,
        "TotalVAT": 421.25,
        "VATIncluded": false,
        "VoucherNumber": null,
        "VoucherSeries": null,
        "VoucherYear": null,
        "WayOfDelivery": "",
        "YourOrderNumber": "",
        "YourReference": "",
        "ZipCode": ""
    }
}

Using our .NET SDK

Request

InvoiceConnector connector = new InvoiceConnector();
Invoice result = connector.Get("203");

Create an invoice

The created invoice will be returned if everything succeeded, if there was any problems an error will be returned.

You must specify a customer to create an invoice. It’s possible to create an invoice without rows, although we encourage you to add them if you can.

Predefined values will be used for properties where it applies, the values can be changed in the settings for the Fortnox account. Predefined values will always be overwritten by values provided through the API.

Examples

Request

curl -X "POST" "https://api.fortnox.se/3/invoices" \
     -H "Access-Token: 61cf63ae-4ab9-4a95-9db5-753781c4f41f" \
     -H "Client-Secret: 3Er4kHXZTJ" \
     -H "Content-Type: application/json" \
     -H "Accept: application/json" \
     -d $'{
  "Invoice": {
    "CustomerNumber": "100",
    "InvoiceRows": [
      {
        "ArticleNumber": "66892",
        "DeliveredQuantity": "10.00"
      }
    ]
  }
}'

Response

{
    "Invoice": {
        "@url": "https://api.fortnox.se/3/invoices/204",
        "@urlTaxReductionList": "https://api.fortnox.se/3/taxreductions?filter=invoices&referencenumber=204",
        "Address1": "Bryttjorp",
        "Address2": "",
        "AdministrationFee": "0,00",
        "AdministrationFeeVAT": 0,
        "Balance": 1988,
        "BasisTaxReduction": 0,
        "Booked": false,
        "Cancelled": false,
        "City": "TORS\u00c5S",
        "Comments": "",
        "ContractReference": 0,
        "ContributionPercent": 37.740000000000002,
        "ContributionValue": 600,
        "CostCenter": "",
        "Country": "",
        "Credit": "false",
        "CreditInvoiceReference": 0,
        "Currency": "SEK",
        "CurrencyRate": 1,
        "CurrencyUnit": 1,
        "CustomerName": "Lars-Eric Lindfors",
        "CustomerNumber": "100",
        "DeliveryAddress1": "",
        "DeliveryAddress2": "",
        "DeliveryCity": "",
        "DeliveryCountry": "",
        "DeliveryDate": null,
        "DeliveryName": "",
        "DeliveryZipCode": "",
        "DocumentNumber": "204",
        "DueDate": "2015-02-11",
        "EDIInformation": {
            "EDIGlobalLocationNumber": "",
            "EDIGlobalLocationNumberDelivery": "",
            "EDIInvoiceExtra1": "",
            "EDIInvoiceExtra2": "",
            "EDIOurElectronicReference": "",
            "EDIYourElectronicReference": ""
        },
        "EUQuarterlyReport": false,
        "EmailInformation": {
            "EmailAddressBCC": null,
            "EmailAddressCC": null,
            "EmailAddressFrom": null,
            "EmailAddressTo": "",
            "EmailBody": "Faktura nummer {no} bifogas ",
            "EmailSubject": "Detta \u00e4r din faktura"
        },
        "ExternalInvoiceReference1": "",
        "ExternalInvoiceReference2": "",
        "Freight": "0,00",
        "FreightVAT": 0,
        "Gross": 1590,
        "HouseWork": false,
        "InvoiceDate": "2015-01-12",
        "InvoicePeriodEnd": "",
        "InvoicePeriodStart": "",
        "InvoiceReference": 0,
        "InvoiceRows": [
            {
                "AccountNumber": 3011,
                "ArticleNumber": "66892",
                "ContributionPercent": 37.740000000000002,
                "ContributionValue": 600,
                "CostCenter": "",
                "DeliveredQuantity": "10.00",
                "Description": "USB-minne 32GB",
                "Discount": 0,
                "DiscountType": "PERCENT",
                "HouseWork": false,
                "HouseWorkHoursToReport": null,
                "HouseWorkType": null,
                "Price": 159,
                "PriceExcludingVAT": 159,
                "Project": "",
                "Total": 1590,
                "TotalExcludingVAT": 1590,
                "Unit": "st",
                "VAT": 25
            }
        ],
        "InvoiceType": "INVOICE",
        "Labels": [
            {
                "Id": 5
            },
            {
                "Id": 11
            }
        ],
        "Language": "SV",
        "LastRemindDate": null,
        "Net": 1590,
        "NotCompleted": false,
        "NoxFinans": true,
        "OCR": "20453",
        "OfferReference": 0,
        "OrderReference": 0,
        "OrganisationNumber": "",
        "OurReference": "",
        "PaymentWay": "",
        "Phone1": "0486-1682774",
        "Phone2": "",
        "PriceList": "A",
        "PrintTemplate": "st",
        "Project": "",
        "Remarks": "",
        "Reminders": 0,
        "RoundOff": 0.5,
        "Sent": false,
        "TaxReduction": null,
        "TermsOfDelivery": "",
        "TermsOfPayment": "30",
        "Total": 1988,
        "TotalToPay": 1988,
        "TotalVAT": 397.5,
        "VATIncluded": false,
        "VoucherNumber": null,
        "VoucherSeries": null,
        "VoucherYear": null,
        "WayOfDelivery": "",
        "YourOrderNumber": "",
        "YourReference": "",
        "ZipCode": "385 31"
    }
}

Using Guzzle

Request

// Include Guzzle. If using Composer:
// require 'vendor/autoload.php';

use GuzzleHttp\Client;
use GuzzleHttp\Post\PostBody;
use GuzzleHttp\Stream\StreamInterface;
use GuzzleHttp\Exception\RequestException;

function send_request() {
    // Invoices (POST https://api.fortnox.se/3/invoices)

    $client = new Client();
    $request = $client->createRequest('POST', 'https://api.fortnox.se/3/invoices');
    $postBody = $request->getBody();

    try {
        $request->addHeaders([
            'Access-Token'=>'61cf63ae-4ab9-4a95-9db5-753781c4f41f',
            'Client-Secret'=>'3Er4kHXZTJ',
            'Content-Type'=>'application/json',
            'Accept'=>'application/json',
        ]);
        $body = [
            "Invoice" => [
                "InvoiceRows" => [
                    [
                        "DeliveredQuantity" => "10.00",
                        "ArticleNumber" => "66892"
                    ]
                ],
                "CustomerNumber" => "100"
            ]
        ];
        $request->setBody(GuzzleHttp\Stream\Stream::factory(json_encode($body)));

        $response = $client->send($request);
        echo "Response HTTP : " . $response->getStatusCode();
    }
    catch (RequestException $e) {
        echo "HTTP Request failed\n";
        echo $e->getRequest();
        if ($e->hasResponse()) {
            echo $e->getResponse();
        }
    }
}

Response

{
    "Invoice": {
        "@url": "https://api.fortnox.se/3/invoices/204",
        "@urlTaxReductionList": "https://api.fortnox.se/3/taxreductions?filter=invoices&referencenumber=204",
        "Address1": "Bryttjorp",
        "Address2": "",
        "AdministrationFee": "0,00",
        "AdministrationFeeVAT": 0,
        "Balance": 1988,
        "BasisTaxReduction": 0,
        "Booked": false,
        "Cancelled": false,
        "City": "TORS\u00c5S",
        "Comments": "",
        "ContractReference": 0,
        "ContributionPercent": 37.740000000000002,
        "ContributionValue": 600,
        "CostCenter": "",
        "Country": "",
        "Credit": "false",
        "CreditInvoiceReference": 0,
        "Currency": "SEK",
        "CurrencyRate": 1,
        "CurrencyUnit": 1,
        "CustomerName": "Lars-Eric Lindfors",
        "CustomerNumber": "100",
        "DeliveryAddress1": "",
        "DeliveryAddress2": "",
        "DeliveryCity": "",
        "DeliveryCountry": "",
        "DeliveryDate": null,
        "DeliveryName": "",
        "DeliveryZipCode": "",
        "DocumentNumber": "204",
        "DueDate": "2015-02-11",
        "EDIInformation": {
            "EDIGlobalLocationNumber": "",
            "EDIGlobalLocationNumberDelivery": "",
            "EDIInvoiceExtra1": "",
            "EDIInvoiceExtra2": "",
            "EDIOurElectronicReference": "",
            "EDIYourElectronicReference": ""
        },
        "EUQuarterlyReport": false,
        "EmailInformation": {
            "EmailAddressBCC": null,
            "EmailAddressCC": null,
            "EmailAddressFrom": null,
            "EmailAddressTo": "",
            "EmailBody": "Faktura nummer {no} bifogas ",
            "EmailSubject": "Detta \u00e4r din faktura"
        },
        "ExternalInvoiceReference1": "",
        "ExternalInvoiceReference2": "",
        "Freight": "0,00",
        "FreightVAT": 0,
        "Gross": 1590,
        "HouseWork": false,
        "InvoiceDate": "2015-01-12",
        "InvoicePeriodEnd": "",
        "InvoicePeriodStart": "",
        "InvoiceReference": 0,
        "InvoiceRows": [
            {
                "AccountNumber": 3011,
                "ArticleNumber": "66892",
                "ContributionPercent": 37.740000000000002,
                "ContributionValue": 600,
                "CostCenter": "",
                "DeliveredQuantity": "10.00",
                "Description": "USB-minne 32GB",
                "Discount": 0,
                "DiscountType": "PERCENT",
                "HouseWork": false,
                "HouseWorkHoursToReport": null,
                "HouseWorkType": null,
                "Price": 159,
                "Project": 0,
                "Total": 1590,
                "Unit": "st",
                "VAT": 25
            }
        ],
        "InvoiceType": "INVOICE",
        "Labels": [
            {
                "Id": 5
            },
            {
                "Id": 11
            }
        ],
        "Language": "SV",
        "LastRemindDate": null,
        "Net": 1590,
        "NotCompleted": false,
        "OCR": "20453",
        "OfferReference": 0,
        "OrderReference": 0,
        "OrganisationNumber": "",
        "OurReference": "",
        "PaymentWay": "",
        "Phone1": "0486-1682774",
        "Phone2": "",
        "PriceList": "A",
        "PrintTemplate": "st",
        "Project": 0,
        "Remarks": "",
        "Reminders": 0,
        "RoundOff": 0.5,
        "Sent": false,
        "TaxReduction": null,
        "TermsOfDelivery": "",
        "TermsOfPayment": "30",
        "Total": 1988,
        "TotalToPay": 1988,
        "TotalVAT": 397.5,
        "VATIncluded": false,
        "VoucherNumber": null,
        "VoucherSeries": null,
        "VoucherYear": null,
        "WayOfDelivery": "",
        "YourOrderNumber": "",
        "YourReference": "",
        "ZipCode": "385 31"
    }
}

Request

require 'net/http'
require 'json'

def send_request
  # Invoices (POST )

  begin
    uri = URI('https://api.fortnox.se/3/invoices')

    # Create client
    http = Net::HTTP.new(uri.host, uri.port)

    dict = {
            "Invoice" => {
                "InvoiceRows" => [
                    {
                        "DeliveredQuantity" => "10.00",
                        "ArticleNumber" => "66892"
                    }
                ],
                "CustomerNumber" => "100"
            }
        }
    body = JSON.dump(dict)

    # Create Request
    req =  Net::HTTP::Post.new(uri)
    # Add headers
    req.add_field "Access-Token", "61cf63ae-4ab9-4a95-9db5-753781c4f41f"
    # Add headers
    req.add_field "Client-Secret", "3Er4kHXZTJ"
    # Add headers
    req.add_field "Content-Type", "application/json"
    # Add headers
    req.add_field "Accept", "application/json"
    # Set header and body
    req.add_field "Content-Type", "application/json"
    req.body = body

    # Fetch Request
    res = http.request(req)
    puts "Response HTTP Status Code: #{res.code}"
    puts "Response HTTP Response Body: #{res.body}"
  rescue Exception => e
    puts "HTTP Request failed (#{e.message})"
  end
end

Response

{
    "Invoice": {
        "@url": "https://api.fortnox.se/3/invoices/204",
        "@urlTaxReductionList": "https://api.fortnox.se/3/taxreductions?filter=invoices&referencenumber=204",
        "Address1": "Bryttjorp",
        "Address2": "",
        "AdministrationFee": "0,00",
        "AdministrationFeeVAT": 0,
        "Balance": 1988,
        "BasisTaxReduction": 0,
        "Booked": false,
        "Cancelled": false,
        "City": "TORS\u00c5S",
        "Comments": "",
        "ContractReference": 0,
        "ContributionPercent": 37.740000000000002,
        "ContributionValue": 600,
        "CostCenter": "",
        "Country": "",
        "Credit": "false",
        "CreditInvoiceReference": 0,
        "Currency": "SEK",
        "CurrencyRate": 1,
        "CurrencyUnit": 1,
        "CustomerName": "Lars-Eric Lindfors",
        "CustomerNumber": "100",
        "DeliveryAddress1": "",
        "DeliveryAddress2": "",
        "DeliveryCity": "",
        "DeliveryCountry": "",
        "DeliveryDate": null,
        "DeliveryName": "",
        "DeliveryZipCode": "",
        "DocumentNumber": "204",
        "DueDate": "2015-02-11",
        "EDIInformation": {
            "EDIGlobalLocationNumber": "",
            "EDIGlobalLocationNumberDelivery": "",
            "EDIInvoiceExtra1": "",
            "EDIInvoiceExtra2": "",
            "EDIOurElectronicReference": "",
            "EDIYourElectronicReference": ""
        },
        "EUQuarterlyReport": false,
        "EmailInformation": {
            "EmailAddressBCC": null,
            "EmailAddressCC": null,
            "EmailAddressFrom": null,
            "EmailAddressTo": "",
            "EmailBody": "Faktura nummer {no} bifogas ",
            "EmailSubject": "Detta \u00e4r din faktura"
        },
        "ExternalInvoiceReference1": "",
        "ExternalInvoiceReference2": "",
        "Freight": "0,00",
        "FreightVAT": 0,
        "Gross": 1590,
        "HouseWork": false,
        "InvoiceDate": "2015-01-12",
        "InvoicePeriodEnd": "",
        "InvoicePeriodStart": "",
        "InvoiceReference": 0,
        "InvoiceRows": [
            {
                "AccountNumber": 3011,
                "ArticleNumber": "66892",
                "ContributionPercent": 37.740000000000002,
                "ContributionValue": 600,
                "CostCenter": "",
                "DeliveredQuantity": "10.00",
                "Description": "USB-minne 32GB",
                "Discount": 0,
                "DiscountType": "PERCENT",
                "HouseWork": false,
                "HouseWorkHoursToReport": null,
                "HouseWorkType": null,
                "Price": 159,
                "Project": 0,
                "Total": 1590,
                "Unit": "st",
                "VAT": 25
            }
        ],
        "InvoiceType": "INVOICE",
        "Labels": [
            {
                "Id": 5
            },
            {
                "Id": 11
            }
        ],
        "Language": "SV",
        "LastRemindDate": null,
        "Net": 1590,
        "NotCompleted": false,
        "OCR": "20453",
        "OfferReference": 0,
        "OrderReference": 0,
        "OrganisationNumber": "",
        "OurReference": "",
        "PaymentWay": "",
        "Phone1": "0486-1682774",
        "Phone2": "",
        "PriceList": "A",
        "PrintTemplate": "st",
        "Project": 0,
        "Remarks": "",
        "Reminders": 0,
        "RoundOff": 0.5,
        "Sent": false,
        "TaxReduction": null,
        "TermsOfDelivery": "",
        "TermsOfPayment": "30",
        "Total": 1988,
        "TotalToPay": 1988,
        "TotalVAT": 397.5,
        "VATIncluded": false,
        "VoucherNumber": null,
        "VoucherSeries": null,
        "VoucherYear": null,
        "WayOfDelivery": "",
        "YourOrderNumber": "",
        "YourReference": "",
        "ZipCode": "385 31"
    }
}

Request

# Install the Python Requests library:
# `pip install requests`

import requests
import json

def send_request():
    # Invoices (POST https://api.fortnox.se/3/invoices)

    try:
        r = requests.post(
            url="https://api.fortnox.se/3/invoices",
            headers = {
                "Access-Token":"61cf63ae-4ab9-4a95-9db5-753781c4f41f",
                "Client-Secret":"3Er4kHXZTJ",
                "Content-Type":"application/json",
                "Accept":"application/json",
            },
            data = json.dumps({
                "Invoice": {
                    "InvoiceRows": [
                        {
                            "DeliveredQuantity": "10.00",
                            "ArticleNumber": "66892"
                        }
                    ],
                    "CustomerNumber": "100"
                }
            })
        )
        print('Response HTTP Status Code : {status_code}'.format(status_code=r.status_code))
        print('Response HTTP Response Body : {content}'.format(content=r.content))
    except requests.exceptions.RequestException as e:
        print('HTTP Request failed')

Response

{
    "Invoice": {
        "@url": "https://api.fortnox.se/3/invoices/204",
        "@urlTaxReductionList": "https://api.fortnox.se/3/taxreductions?filter=invoices&referencenumber=204",
        "Address1": "Bryttjorp",
        "Address2": "",
        "AdministrationFee": "0,00",
        "AdministrationFeeVAT": 0,
        "Balance": 1988,
        "BasisTaxReduction": 0,
        "Booked": false,
        "Cancelled": false,
        "City": "TORS\u00c5S",
        "Comments": "",
        "ContractReference": 0,
        "ContributionPercent": 37.740000000000002,
        "ContributionValue": 600,
        "CostCenter": "",
        "Country": "",
        "Credit": "false",
        "CreditInvoiceReference": 0,
        "Currency": "SEK",
        "CurrencyRate": 1,
        "CurrencyUnit": 1,
        "CustomerName": "Lars-Eric Lindfors",
        "CustomerNumber": "100",
        "DeliveryAddress1": "",
        "DeliveryAddress2": "",
        "DeliveryCity": "",
        "DeliveryCountry": "",
        "DeliveryDate": null,
        "DeliveryName": "",
        "DeliveryZipCode": "",
        "DocumentNumber": "204",
        "DueDate": "2015-02-11",
        "EDIInformation": {
            "EDIGlobalLocationNumber": "",
            "EDIGlobalLocationNumberDelivery": "",
            "EDIInvoiceExtra1": "",
            "EDIInvoiceExtra2": "",
            "EDIOurElectronicReference": "",
            "EDIYourElectronicReference": ""
        },
        "EUQuarterlyReport": false,
        "EmailInformation": {
            "EmailAddressBCC": null,
            "EmailAddressCC": null,
            "EmailAddressFrom": null,
            "EmailAddressTo": "",
            "EmailBody": "Faktura nummer {no} bifogas ",
            "EmailSubject": "Detta \u00e4r din faktura"
        },
        "ExternalInvoiceReference1": "",
        "ExternalInvoiceReference2": "",
        "Freight": "0,00",
        "FreightVAT": 0,
        "Gross": 1590,
        "HouseWork": false,
        "InvoiceDate": "2015-01-12",
        "InvoicePeriodEnd": "",
        "InvoicePeriodStart": "",
        "InvoiceReference": 0,
        "InvoiceRows": [
            {
                "AccountNumber": 3011,
                "ArticleNumber": "66892",
                "ContributionPercent": 37.740000000000002,
                "ContributionValue": 600,
                "CostCenter": "",
                "DeliveredQuantity": "10.00",
                "Description": "USB-minne 32GB",
                "Discount": 0,
                "DiscountType": "PERCENT",
                "HouseWork": false,
                "HouseWorkHoursToReport": null,
                "HouseWorkType": null,
                "Price": 159,
                "Project": 0,
                "Total": 1590,
                "Unit": "st",
                "VAT": 25
            }
        ],
        "InvoiceType": "INVOICE",
        "Labels": [
            {
                "Id": 5
            },
            {
                "Id": 11
            }
        ],
        "Language": "SV",
        "LastRemindDate": null,
        "Net": 1590,
        "NotCompleted": false,
        "OCR": "20453",
        "OfferReference": 0,
        "OrderReference": 0,
        "OrganisationNumber": "",
        "OurReference": "",
        "PaymentWay": "",
        "Phone1": "0486-1682774",
        "Phone2": "",
        "PriceList": "A",
        "PrintTemplate": "st",
        "Project": 0,
        "Remarks": "",
        "Reminders": 0,
        "RoundOff": 0.5,
        "Sent": false,
        "TaxReduction": null,
        "TermsOfDelivery": "",
        "TermsOfPayment": "30",
        "Total": 1988,
        "TotalToPay": 1988,
        "TotalVAT": 397.5,
        "VATIncluded": false,
        "VoucherNumber": null,
        "VoucherSeries": null,
        "VoucherYear": null,
        "WayOfDelivery": "",
        "YourOrderNumber": "",
        "YourReference": "",
        "ZipCode": "385 31"
    }
}

Using our .NET SDK

Request

InvoiceConnector connector = new InvoiceConnector();

List<InvoiceRow> rows = new List<InvoiceRow>();
rows.Add(new InvoiceRow() { ArticleNumber = "66892", DeliveredQuantity = "10" });

Invoice result = connector.Create(new Invoice() { CustomerNumber = "100", InvoiceRows = rows });

Update an invoice

The updated invoice will be returned if everything succeeded, if there was any problems an error will be returned.

You need to supply the document number of the invoice that you want to update.

Note that when updating rows you’ll need to provide all the rows of the invoice, only providing the updates will overwrite the current rows resulting in the old ones being removed.

Examples

Request

curl -X "PUT" "https://api.fortnox.se/3/invoices/204" \
     -H "Access-Token: 61cf63ae-4ab9-4a95-9db5-753781c4f41f" \
     -H "Client-Secret: 3Er4kHXZTJ" \
     -H "Content-Type: application/json" \
     -H "Accept: application/json" \
     -d $'{
  "Invoice": {
	"Freight": "99"
  }
}'

Response

{
    "Invoice": {
        "@url": "https://api.fortnox.se/3/invoices/204",
        "@urlTaxReductionList": "https://api.fortnox.se/3/taxreductions?filter=invoices&referencenumber=204",
        "Address1": "Bryttjorp",
        "Address2": "",
        "AdministrationFee": 0,
        "AdministrationFeeVAT": 0,
        "Balance": 2111,
        "BasisTaxReduction": 0,
        "Booked": false,
        "Cancelled": false,
        "City": "TORS\u00c5S",
        "Comments": "",
        "ContractReference": 0,
        "ContributionPercent": 37.740000000000002,
        "ContributionValue": 600,
        "CostCenter": "",
        "Country": "",
        "Credit": "false",
        "CreditInvoiceReference": "0",
        "Currency": "SEK",
        "CurrencyRate": 1,
        "CurrencyUnit": 1,
        "CustomerName": "Lars-Eric Lindfors",
        "CustomerNumber": "100",
        "DeliveryAddress1": "",
        "DeliveryAddress2": "",
        "DeliveryCity": "",
        "DeliveryCountry": "",
        "DeliveryDate": null,
        "DeliveryName": "",
        "DeliveryZipCode": "",
        "DocumentNumber": "204",
        "DueDate": "2015-02-11",
        "EDIInformation": {
            "EDIGlobalLocationNumber": "",
            "EDIGlobalLocationNumberDelivery": "",
            "EDIInvoiceExtra1": "",
            "EDIInvoiceExtra2": "",
            "EDIOurElectronicReference": "",
            "EDIYourElectronicReference": ""
        },
        "EUQuarterlyReport": false,
        "EmailInformation": {
            "EmailAddressBCC": null,
            "EmailAddressCC": null,
            "EmailAddressFrom": null,
            "EmailAddressTo": "",
            "EmailBody": "Faktura nummer {no} bifogas ",
            "EmailSubject": "Detta \u00e4r din faktura"
        },
        "ExternalInvoiceReference1": "",
        "ExternalInvoiceReference2": "",
        "Freight": 99,
        "FreightVAT": 24.75,
        "Gross": 1590,
        "HouseWork": false,
        "InvoiceDate": "2015-01-12",
        "InvoicePeriodEnd": "",
        "InvoicePeriodStart": "",
        "InvoiceReference": "0",
        "InvoiceRows": [
            {
                "AccountNumber": 3011,
                "ArticleNumber": "66892",
                "ContributionPercent": 37.740000000000002,
                "ContributionValue": 600,
                "CostCenter": "",
                "DeliveredQuantity": "10.00",
                "Description": "USB-minne 32GB",
                "Discount": 0,
                "DiscountType": "PERCENT",
                "HouseWork": false,
                "HouseWorkHoursToReport": null,
                "HouseWorkType": null,
                "Price": 159,
                "PriceExcludingVAT": 159,
                "Project": "",
                "Total": 1590,
                "TotalExcludingVAT": 1590,
                "Unit": "st",
                "VAT": 25
            }
        ],
        "InvoiceType": "INVOICE",
        "Labels": [
            {
                "Id": 5
            },
            {
                "Id": 11
            }
        ],
        "Language": "SV",
        "LastRemindDate": null,
        "Net": 1590,
        "NotCompleted": false,
        "NoxFinans": true,
        "OCR": "20453",
        "OfferReference": "0",
        "OrderReference": "0",
        "OrganisationNumber": "",
        "OurReference": "",
        "PaymentWay": "",
        "Phone1": "0486-1682774",
        "Phone2": "",
        "PriceList": "A",
        "PrintTemplate": "st",
        "Project": "",
        "Remarks": "",
        "Reminders": 0,
        "RoundOff": -0.25,
        "Sent": false,
        "TaxReduction": null,
        "TermsOfDelivery": "",
        "TermsOfPayment": "30",
        "Total": 2111,
        "TotalToPay": 2111,
        "TotalVAT": 422.25,
        "VATIncluded": false,
        "VoucherNumber": null,
        "VoucherSeries": null,
        "VoucherYear": null,
        "WayOfDelivery": "",
        "YourOrderNumber": "",
        "YourReference": "",
        "ZipCode": "385 31"
    }
}

Using Guzzle

Request

// Include Guzzle. If using Composer:
// require 'vendor/autoload.php';

use GuzzleHttp\Client;
use GuzzleHttp\Post\PostBody;
use GuzzleHttp\Stream\StreamInterface;
use GuzzleHttp\Exception\RequestException;

function send_request() {
    // Invoice (PUT https://api.fortnox.se/3/invoices/204)

    $client = new Client();
    $request = $client->createRequest('PUT', 'https://api.fortnox.se/3/invoices/204');
    $postBody = $request->getBody();

    try {
        $request->addHeaders([
            'Access-Token'=>'61cf63ae-4ab9-4a95-9db5-753781c4f41f',
            'Client-Secret'=>'3Er4kHXZTJ',
            'Content-Type'=>'application/json',
            'Accept'=>'application/json',
        ]);
        $body = [
            "Invoice" => [
                "Freight" => "99"
            ]
        ];
        $request->setBody(GuzzleHttp\Stream\Stream::factory(json_encode($body)));

        $response = $client->send($request);
        echo "Response HTTP : " . $response->getStatusCode();
    }
    catch (RequestException $e) {
        echo "HTTP Request failed\n";
        echo $e->getRequest();
        if ($e->hasResponse()) {
            echo $e->getResponse();
        }
    }
}

Response

{
    "Invoice": {
        "@url": "https://api.fortnox.se/3/invoices/204",
        "@urlTaxReductionList": "https://api.fortnox.se/3/taxreductions?filter=invoices&referencenumber=204",
        "Address1": "Bryttjorp",
        "Address2": "",
        "AdministrationFee": 0,
        "AdministrationFeeVAT": 0,
        "Balance": 2111,
        "BasisTaxReduction": 0,
        "Booked": false,
        "Cancelled": false,
        "City": "TORS\u00c5S",
        "Comments": "",
        "ContractReference": 0,
        "ContributionPercent": 37.740000000000002,
        "ContributionValue": 600,
        "CostCenter": "",
        "Country": "",
        "Credit": "false",
        "CreditInvoiceReference": "0",
        "Currency": "SEK",
        "CurrencyRate": 1,
        "CurrencyUnit": 1,
        "CustomerName": "Lars-Eric Lindfors",
        "CustomerNumber": "100",
        "DeliveryAddress1": "",
        "DeliveryAddress2": "",
        "DeliveryCity": "",
        "DeliveryCountry": "",
        "DeliveryDate": null,
        "DeliveryName": "",
        "DeliveryZipCode": "",
        "DocumentNumber": "204",
        "DueDate": "2015-02-11",
        "EDIInformation": {
            "EDIGlobalLocationNumber": "",
            "EDIGlobalLocationNumberDelivery": "",
            "EDIInvoiceExtra1": "",
            "EDIInvoiceExtra2": "",
            "EDIOurElectronicReference": "",
            "EDIYourElectronicReference": ""
        },
        "EUQuarterlyReport": false,
        "EmailInformation": {
            "EmailAddressBCC": null,
            "EmailAddressCC": null,
            "EmailAddressFrom": null,
            "EmailAddressTo": "",
            "EmailBody": "Faktura nummer {no} bifogas ",
            "EmailSubject": "Detta \u00e4r din faktura"
        },
        "ExternalInvoiceReference1": "",
        "ExternalInvoiceReference2": "",
        "Freight": 99,
        "FreightVAT": 24.75,
        "Gross": 1590,
        "HouseWork": false,
        "InvoiceDate": "2015-01-12",
        "InvoicePeriodEnd": "",
        "InvoicePeriodStart": "",
        "InvoiceReference": "0",
        "InvoiceRows": [
            {
                "AccountNumber": 3011,
                "ArticleNumber": "66892",
                "ContributionPercent": 37.740000000000002,
                "ContributionValue": 600,
                "CostCenter": "",
                "DeliveredQuantity": "10.00",
                "Description": "USB-minne 32GB",
                "Discount": 0,
                "DiscountType": "PERCENT",
                "HouseWork": false,
                "HouseWorkHoursToReport": null,
                "HouseWorkType": null,
                "Price": 159,
                "Project": 0,
                "Total": 1590,
                "Unit": "st",
                "VAT": 25
            }
        ],
        "InvoiceType": "INVOICE",
        "Labels": [
            {
                "Id": 5
            },
            {
                "Id": 11
            }
        ],
        "Language": "SV",
        "LastRemindDate": null,
        "Net": 1590,
        "NotCompleted": false,
        "OCR": "20453",
        "OfferReference": "0",
        "OrderReference": "0",
        "OrganisationNumber": "",
        "OurReference": "",
        "PaymentWay": "",
        "Phone1": "0486-1682774",
        "Phone2": "",
        "PriceList": "A",
        "PrintTemplate": "st",
        "Project": 0,
        "Remarks": "",
        "Reminders": 0,
        "RoundOff": -0.25,
        "Sent": false,
        "TaxReduction": null,
        "TermsOfDelivery": "",
        "TermsOfPayment": "30",
        "Total": 2111,
        "TotalToPay": 2111,
        "TotalVAT": 422.25,
        "VATIncluded": false,
        "VoucherNumber": null,
        "VoucherSeries": null,
        "VoucherYear": null,
        "WayOfDelivery": "",
        "YourOrderNumber": "",
        "YourReference": "",
        "ZipCode": "385 31"
    }
}

Request

require 'net/http'
require 'json'

def send_request
  # Invoice (PUT )

  begin
    uri = URI('https://api.fortnox.se/3/invoices/204')

    # Create client
    http = Net::HTTP.new(uri.host, uri.port)

    dict = {
            "Invoice" => {
                "Freight" => "99"
            }
        }
    body = JSON.dump(dict)

    # Create Request
    req =  Net::HTTP::Put.new(uri)
    # Add headers
    req.add_field "Access-Token", "61cf63ae-4ab9-4a95-9db5-753781c4f41f"
    # Add headers
    req.add_field "Client-Secret", "3Er4kHXZTJ"
    # Add headers
    req.add_field "Content-Type", "application/json"
    # Add headers
    req.add_field "Accept", "application/json"
    # Set header and body
    req.add_field "Content-Type", "application/json"
    req.body = body

    # Fetch Request
    res = http.request(req)
    puts "Response HTTP Status Code: #{res.code}"
    puts "Response HTTP Response Body: #{res.body}"
  rescue Exception => e
    puts "HTTP Request failed (#{e.message})"
  end
end

Response

{
    "Invoice": {
        "@url": "https://api.fortnox.se/3/invoices/204",
        "@urlTaxReductionList": "https://api.fortnox.se/3/taxreductions?filter=invoices&referencenumber=204",
        "Address1": "Bryttjorp",
        "Address2": "",
        "AdministrationFee": 0,
        "AdministrationFeeVAT": 0,
        "Balance": 2111,
        "BasisTaxReduction": 0,
        "Booked": false,
        "Cancelled": false,
        "City": "TORS\u00c5S",
        "Comments": "",
        "ContractReference": 0,
        "ContributionPercent": 37.740000000000002,
        "ContributionValue": 600,
        "CostCenter": "",
        "Country": "",
        "Credit": "false",
        "CreditInvoiceReference": "0",
        "Currency": "SEK",
        "CurrencyRate": 1,
        "CurrencyUnit": 1,
        "CustomerName": "Lars-Eric Lindfors",
        "CustomerNumber": "100",
        "DeliveryAddress1": "",
        "DeliveryAddress2": "",
        "DeliveryCity": "",
        "DeliveryCountry": "",
        "DeliveryDate": null,
        "DeliveryName": "",
        "DeliveryZipCode": "",
        "DocumentNumber": "204",
        "DueDate": "2015-02-11",
        "EDIInformation": {
            "EDIGlobalLocationNumber": "",
            "EDIGlobalLocationNumberDelivery": "",
            "EDIInvoiceExtra1": "",
            "EDIInvoiceExtra2": "",
            "EDIOurElectronicReference": "",
            "EDIYourElectronicReference": ""
        },
        "EUQuarterlyReport": false,
        "EmailInformation": {
            "EmailAddressBCC": null,
            "EmailAddressCC": null,
            "EmailAddressFrom": null,
            "EmailAddressTo": "",
            "EmailBody": "Faktura nummer {no} bifogas ",
            "EmailSubject": "Detta \u00e4r din faktura"
        },
        "ExternalInvoiceReference1": "",
        "ExternalInvoiceReference2": "",
        "Freight": 99,
        "FreightVAT": 24.75,
        "Gross": 1590,
        "HouseWork": false,
        "InvoiceDate": "2015-01-12",
        "InvoicePeriodEnd": "",
        "InvoicePeriodStart": "",
        "InvoiceReference": "0",
        "InvoiceRows": [
            {
                "AccountNumber": 3011,
                "ArticleNumber": "66892",
                "ContributionPercent": 37.740000000000002,
                "ContributionValue": 600,
                "CostCenter": "",
                "DeliveredQuantity": "10.00",
                "Description": "USB-minne 32GB",
                "Discount": 0,
                "DiscountType": "PERCENT",
                "HouseWork": false,
                "HouseWorkHoursToReport": null,
                "HouseWorkType": null,
                "Price": 159,
                "Project": 0,
                "Total": 1590,
                "Unit": "st",
                "VAT": 25
            }
        ],
        "InvoiceType": "INVOICE",
        "Labels": [
            {
                "Id": 5
            },
            {
                "Id": 11
            }
        ],
        "Language": "SV",
        "LastRemindDate": null,
        "Net": 1590,
        "NotCompleted": false,
        "OCR": "20453",
        "OfferReference": "0",
        "OrderReference": "0",
        "OrganisationNumber": "",
        "OurReference": "",
        "PaymentWay": "",
        "Phone1": "0486-1682774",
        "Phone2": "",
        "PriceList": "A",
        "PrintTemplate": "st",
        "Project": 0,
        "Remarks": "",
        "Reminders": 0,
        "RoundOff": -0.25,
        "Sent": false,
        "TaxReduction": null,
        "TermsOfDelivery": "",
        "TermsOfPayment": "30",
        "Total": 2111,
        "TotalToPay": 2111,
        "TotalVAT": 422.25,
        "VATIncluded": false,
        "VoucherNumber": null,
        "VoucherSeries": null,
        "VoucherYear": null,
        "WayOfDelivery": "",
        "YourOrderNumber": "",
        "YourReference": "",
        "ZipCode": "385 31"
    }
}

Request

# Install the Python Requests library:
# `pip install requests`

import requests
import json

def send_request():
    # Invoice (PUT https://api.fortnox.se/3/invoices/204)

    try:
        r = requests.put(
            url="https://api.fortnox.se/3/invoices/204",
            headers = {
                "Access-Token":"61cf63ae-4ab9-4a95-9db5-753781c4f41f",
                "Client-Secret":"3Er4kHXZTJ",
                "Content-Type":"application/json",
                "Accept":"application/json",
            },
            data = json.dumps({
                "Invoice": {
                    "Freight": "99"
                }
            })
        )
        print('Response HTTP Status Code : {status_code}'.format(status_code=r.status_code))
        print('Response HTTP Response Body : {content}'.format(content=r.content))
    except requests.exceptions.RequestException as e:
        print('HTTP Request failed')

Response

{
    "Invoice": {
        "@url": "https://api.fortnox.se/3/invoices/204",
        "@urlTaxReductionList": "https://api.fortnox.se/3/taxreductions?filter=invoices&referencenumber=204",
        "Address1": "Bryttjorp",
        "Address2": "",
        "AdministrationFee": 0,
        "AdministrationFeeVAT": 0,
        "Balance": 2111,
        "BasisTaxReduction": 0,
        "Booked": false,
        "Cancelled": false,
        "City": "TORS\u00c5S",
        "Comments": "",
        "ContractReference": 0,
        "ContributionPercent": 37.740000000000002,
        "ContributionValue": 600,
        "CostCenter": "",
        "Country": "",
        "Credit": "false",
        "CreditInvoiceReference": "0",
        "Currency": "SEK",
        "CurrencyRate": 1,
        "CurrencyUnit": 1,
        "CustomerName": "Lars-Eric Lindfors",
        "CustomerNumber": "100",
        "DeliveryAddress1": "",
        "DeliveryAddress2": "",
        "DeliveryCity": "",
        "DeliveryCountry": "",
        "DeliveryDate": null,
        "DeliveryName": "",
        "DeliveryZipCode": "",
        "DocumentNumber": "204",
        "DueDate": "2015-02-11",
        "EDIInformation": {
            "EDIGlobalLocationNumber": "",
            "EDIGlobalLocationNumberDelivery": "",
            "EDIInvoiceExtra1": "",
            "EDIInvoiceExtra2": "",
            "EDIOurElectronicReference": "",
            "EDIYourElectronicReference": ""
        },
        "EUQuarterlyReport": false,
        "EmailInformation": {
            "EmailAddressBCC": null,
            "EmailAddressCC": null,
            "EmailAddressFrom": null,
            "EmailAddressTo": "",
            "EmailBody": "Faktura nummer {no} bifogas ",
            "EmailSubject": "Detta \u00e4r din faktura"
        },
        "ExternalInvoiceReference1": "",
        "ExternalInvoiceReference2": "",
        "Freight": 99,
        "FreightVAT": 24.75,
        "Gross": 1590,
        "HouseWork": false,
        "InvoiceDate": "2015-01-12",
        "InvoicePeriodEnd": "",
        "InvoicePeriodStart": "",
        "InvoiceReference": "0",
        "InvoiceRows": [
            {
                "AccountNumber": 3011,
                "ArticleNumber": "66892",
                "ContributionPercent": 37.740000000000002,
                "ContributionValue": 600,
                "CostCenter": "",
                "DeliveredQuantity": "10.00",
                "Description": "USB-minne 32GB",
                "Discount": 0,
                "DiscountType": "PERCENT",
                "HouseWork": false,
                "HouseWorkHoursToReport": null,
                "HouseWorkType": null,
                "Price": 159,
                "Project": 0,
                "Total": 1590,
                "Unit": "st",
                "VAT": 25
            }
        ],
        "InvoiceType": "INVOICE",
        "Labels": [
            {
                "Id": 5
            },
            {
                "Id": 11
            }
        ],
        "Language": "SV",
        "LastRemindDate": null,
        "Net": 1590,
        "NotCompleted": false,
        "OCR": "20453",
        "OfferReference": "0",
        "OrderReference": "0",
        "OrganisationNumber": "",
        "OurReference": "",
        "PaymentWay": "",
        "Phone1": "0486-1682774",
        "Phone2": "",
        "PriceList": "A",
        "PrintTemplate": "st",
        "Project": 0,
        "Remarks": "",
        "Reminders": 0,
        "RoundOff": -0.25,
        "Sent": false,
        "TaxReduction": null,
        "TermsOfDelivery": "",
        "TermsOfPayment": "30",
        "Total": 2111,
        "TotalToPay": 2111,
        "TotalVAT": 422.25,
        "VATIncluded": false,
        "VoucherNumber": null,
        "VoucherSeries": null,
        "VoucherYear": null,
        "WayOfDelivery": "",
        "YourOrderNumber": "",
        "YourReference": "",
        "ZipCode": "385 31"
    }
}

Using our .NET SDK

Request

InvoiceConnector connector = new InvoiceConnector();
Invoice result = connector.Update(new Invoice() { DocumentNumber = "204", Freight = "99" });

Actions

Name Description
bookkeep Bookkeeps an invoice
cancel Cancels an invoice
credit Creates a credit invoice from the provided invoice. The created credit invoice will be referenced in the property CreditInvoiceReference.
email Sends an e-mail to the customer with an attached PDF document of the invoice. You can use the properties in the EmailInformation to customize the e-mail message on each invoice.
print This action returns a PDF document with the current template that is used by the specific document. Note that this action also sets the property Sent as true.
printreminder This action returns a PDF document with the current reminder template that is used by the specific document. Note that this action also sets the property Sent as true.
externalprint This action is used to set the field Sent as true from an external system without generating a PDF.
preview This action returns a PDF document with the current template that is used by the specific document. Unliike the action print, this action doesn’t set the property Sent as true.

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

Filters

Name Description
cancelled Retrieves all invoices with the status “cancelled”
fullypaid Retrieves all invoices that has been fully paid
unpaid Retrieves all invoices that is unpaid
unpaidoverdue Retrieves all invoices that is unpaid and overdue
unbooked Retrieves all invoices that is unbooked

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

Properties

Invoice

Property Description
Url string, read-only
Direct url to the record.
UrlTaxReductionList string, read-only
Direct url to the tax reduction for the invoice. This is visible even if no tax reduction exists.
AccountingMethod string
Accounting Method. Can be ACCRUAL orCASH
AdministrationFee float, 12 digits (incl. decimals)
The invoice administration fee.
AdministrationFeeVAT float, read-only
VAT of the invoice administration fee.
Address1 string, 1024 characters
Invoice address 1.
Address2 string, 1024 characters
Invoice address 2.
Balance float, read-only
Balance of the invoice.
BasisTaxReduction float, read-only
Basis of tax reduction.
Booked boolean, read-only
If the invoice is bookkept. This value can be changed by using the action “bookkeep”.
Cancelled boolean, read-only
If the invoice is cancelled. This value can be changed by using the action “cancel”.
Credit boolean, read-only, searchable
If the invoice is a credit invoice.
CreditInvoiceReference integer
Reference to the credit invoice, if one exits. The reference must be a document number for an existing credit invoice.
City string, 1024 characters
City for the invoice address.
Comments string, 1024 characters
Comments of the invoice
ContractReference integer, read-only
Reference to the contract, if one exists.
ContributionPercent float, read-only
Invoice contribution in percent.
ContributionValue float, read-only
Invoice contribution in amount.
Country string
Country for the invoice address. Must be a name of an existing country.
CostCenter string, searchable
Code of the cost center. The code must be of an existing cost center.
Currency string, searchable
Code of the currency. The code must be of an existing currency.
CurrencyRate float, 16 digits (incl. decimals)
Currency rate used for the invoice.
CurrencyUnit float, 16 digits (incl. decimals)
Currency unit used for the invoice.
CustomerName string, 1024 characters, searchable, sortable
Name of the customer.
CustomerNumber string, required, searchable, sortable
Customer number of the customer. The customer number must be of an existing customer.
DeliveryAddress1 string, 1024 characters
Invoice delivery address 1.
DeliveryAddress2 string, 1024 characters
Invoice delivery address 2.
DeliveryCity string, 1024 characters
City for the invoice delivery address.
DeliveryCountry string
Country for the invoice delivery address. Must be a name of an existing country.
DeliveryDate date
Date of delivery. Must be a valid date according to our date format.
DeliveryName string, 1024 characters
Name of the recipient of the delivery
DeliveryZipCode string, 1024 characters
ZipCode for the invoice delivery address.
DocumentNumber integer, searchable, sortable
The invoice number. If no document number is provided, the next number in the series will be used.
DueDate date
Due date of the invoice. Must be a valid date according to our date format.
EDIInformation object
The properties for this object is listed in the table for “EDI Information”.
EmailInformation object
The properties for this object is listed in the table for “Email Information”.
EUQuarterlyReport Boolean true/false
EU Quarterly Report On / Off
ExternalInvoiceReference1 string, 80 characters, searchable
External invoice reference 1.
ExternalInvoiceReference2 string, 80 characters, searchable
External invoice reference 2.
Freight float, 12 digits (incl. decimals)
Freight cost of the invoice.
FreightVAT float, read-only
VAT of the freight cost.
Gross float, read-only
Gross value of the invoice
HouseWork boolean, read-only
If there is any row of the invoice marked “house work”.
InvoiceDate date, sortable
Invoice date. Must be a valid date according to our date format.
InvoicePeriodStart date, read-only
Start date of the invoice period, only applicable for contract invoices.
InvoicePeriodEnd date, read-only
End date of the invoice period, only applicable for contract invoices.
InvoiceRows array
The properties for the object in this array is listed in the table “Invoice Rows”.
InvoiceType string, searchable
The type of invoice. Can be INVOICE AGREEMENTINVOICE INTRESTINVOICE SUMMARYINVOICE or CASHINVOICE.
Labels array
The properties for the object in this array is listed in the table “Labels”
Language string
Language code. Can be SV or EN.
LastRemindDate date, read-only
Date of last reminder.
Net float, read-only
Net amount
NotCompleted boolean, searchable
If the invoice is set as not completed.
NoxFinans boolean, read-only
If the invoice is managed by NoxFinans
OCR string, searchable, sortable
OCR number of the invoice.
OfferReference integer, read-only
Reference to the offer, if one exists.
OrderReference integer, read-only
Reference to the order, if one exists.
OrganisationNumber string, read-only
Organisation number of the customer for the invoice.
OurReference string, 50 characters, searchable
Our reference.
PaymentWay string, 50 characters
CASH, CARD, AG
Phone1 string, 1024 characters
Phone number 1 of the customer for the invoice.
Phone2 string, 1024 characters
Phone number 2 of the customer for the invoice.
PriceList string
Code of the price list. The code must be of an existing price list.
PrintTemplate string
Print template of the invoice. Must be an existing print template.
Project string, searchable
Code of the project. The code must be of an existing project.
Remarks string, 1024 characters
Remarks of the invoice. This is the invoice text shown on the invoice.
Reminders integer, read-only
Number of reminders sent to the customer.
RoundOff float, read-only
Round off amount for the invoice.
Sent boolean, searchable, read-only
If the document is printed or sent in any way.
TaxReduction integer, read-only
The amount of tax reduction.
TermsOfDelivery string
Code of the terms of delivery. The code must be of an existing terms of delivery.
TermsOfPayment string
Code of the terms of payment. The code must be of an existing terms of payment.
Total float, sortable, read-only
The total amount of the invoice.
TotalVAT float, read-only
The total VAT amount of the invoice.
VATIncluded boolean
If the price of the invoice is including VAT.
VoucherNumber integer, read-only
Voucher number for the invoice. This is created when the invoice is bookkept.
VoucherSeries string, read-only
Voucher series for the invoice. This is created when the invoice is bookkept.
VoucherYear integer, read-only
Voucher year for the invoice. This is created when the invoice is bookkept.
WayOfDelivery string
Code of the way of delivery. The code must be of an existing way of delivery.
YourOrderNumber string, 75 characters, searchable
Your order number.
YourReference string, 50 characters, searchable
Your reference.
ZipCode string, 1024 characters
Zip code of the invoice.

EDI Information

Property Description
EDIGlobalLocationNumber string
Invoice address GLN for EDI
EDIGlobalLocationNumberDelivery string
Delivery address GLN for EDI
EDIInvoiceExtra1 string
Extra EDI Information
EDIInvoiceExtra2 string
Extra EDI Information
EDIOurElectronicReference string
Our electronic reference for EDI
EDIYourElectronicReference string
Your electronic reference for EDI

Email Information

Property Description
EmailAddressTo string, 1024 characters
Customer e-mail address. Must be a valid e-mail address.
EmailAddressCC string, 1024 characters
Customer e-mail address – Copy. Must be a valid e-mail address.
EmailAddressBCC string, 1024 characters
Customer e-mail address – Blind carbon copy. Must be a valid e-mail address.
EmailSubject string, 100 characters
Subject of the e-mail
The variable {no} = document number. The variable {name} =  customer name
EmailBody string, 20000 characters
Body of the e-mail.
The variable {no}  = document number. The variable {name} =  customer name

Invoice Row

Property Description
AccountNumber integer, 4 digits, searchable (accountnumberfrom=1111&accountnumberto=8999)
Account number. If not provided the predefined account will be used.
ArticleNumber string, 50 characters, searchable
Article number.
ContributionPercent float, read-only
Contribution Percent.
ContributionValue float, read-only
Contribution Value.
CostCenter string
Code of the cost center for the row. The code must be of an existing cost center.
DeliveredQuantity float, 14 digits
Delivered quantity.
Description string, 50 characters, searchable (articledescription)
Row description.
Discount float, 12 digits (for amount) / 5 digits (for percent)
Discount amount.
DiscountType string
The type of discount used for the row. Can be AMOUNT or PERCENT.
HouseWork boolean
If the row is housework
HouseWorkHoursToReport integer, 5 digits
Hours to be reported if the quantity of the row should not be used as hours.
HouseWorkType string
The type of house work. Can be
CONSTRUCTIONELECTRICITYGLASSMETALWORK
GROUNDDRAINAGEWORKMASONRY
PAINTINGWALLPAPERINGHVACMAJORAPPLIANCEREPAIR
MOVINGSERVICESITSERVICESCLEANINGTEXTILECLOTHINGSNOWPLOWING
GARDENINGBABYSITTINGOTHERCAREOTHERCOSTS or empty.
Price float, 12 digits
Price per unit
PriceExcludingVAT float, read-only
Price per unit excluding VAT (regardless of value of VATIncluded flag)
Project string
Code of the project for the row. The code must be of an existing project.
Total float, read-only
Total amount for the row.
TotalExcludingVAT float, read-only
Total amount for the row excluding VAT (regardless of value of VATIncluded flag)
Unit string
Code of the unit for the row. The code must be of an existing unit.
VAT integer
VAT percentage of the row. The percentage needs to be of an existing VAT percentage.

Labels

Property Description
Id integer
Id of the label.

PaymentWay Values for Cash Invoices

Property
Description
CASH string
Payment Way is set to Cash payment
CARD string
Payment Way is set to Card.
AG string
Payment Way is set to Direct debit