Vouchers | Fortnox Developer

Note that the parameter financialyear or financialyeardate must be used to select which year that should be used for the request.

List all vouchers

Retrieves a list of vouchers. The vouchers are returned sorted by voucher series and voucher number with the lowest number appearing first.

Note that vouchers have two keys, one for voucher series and one for voucher number. The financial year is also specified for each voucher, this is due to the same voucher series and number is used each year.

So to get a unique voucher you need the voucher series, the voucher number and the financial year. These properties will always be returned where ever vouchers is used.

Examples

Request

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

Response

{
    "MetaInformation": {
        "@CurrentPage": 1,
        "@TotalPages": 1,
        "@TotalResources": 49
    },
    "Vouchers": [
        {
            "@url": "https://api.fortnox.se/3/vouchers/B/25?financialyear=1",
            "Description": "Kundfaktura Anders Svensson (36)",
            "ReferenceNumber": "36",
            "ReferenceType": "INVOICE",
            "TransactionDate": "2014-06-10",
            "VoucherNumber": 25,
            "VoucherSeries": "B",
            "Year": 1
        },

        [...]

        {
            "@url": "https://api.fortnox.se/3/vouchers/D/6?financialyear=1",
            "Description": "Kundfaktura Sven Andersson (58)",
            "ReferenceNumber": "58",
            "ReferenceType": "SUPPLIERINVOICE",
            "TransactionDate": "2014-06-10",
            "VoucherNumber": 6,
            "VoucherSeries": "D",
            "Year": 1
        }
    ]
}

Request

Using Guzzle

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

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

function send_request() {
    // Vouchers (GET https://api.fortnox.se/3/vouchers)

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

    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

{
    "MetaInformation": {
        "@CurrentPage": 1,
        "@TotalPages": 1,
        "@TotalResources": 49
    },
    "Vouchers": [
        {
            "@url": "https://api.fortnox.se/3/vouchers/B/25?financialyear=1",
            "Description": "Kundfaktura Anders Svensson (36)",
            "ReferenceNumber": "36",
            "ReferenceType": "INVOICE",
            "TransactionDate": "2014-06-10",
            "VoucherNumber": 25,
            "VoucherSeries": "B",
            "Year": 1
        },

        [...]

        {
            "@url": "https://api.fortnox.se/3/vouchers/D/6?financialyear=1",
            "Description": "Kundfaktura Sven Andersson (58)",
            "ReferenceNumber": "58",
            "ReferenceType": "SUPPLIERINVOICE",
            "TransactionDate": "2014-06-10",
            "VoucherNumber": 6,
            "VoucherSeries": "D",
            "Year": 1
        }
    ]
}

Request

require 'net/http'

def send_request
  # Vouchers (GET )

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

    # 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

{
    "MetaInformation": {
        "@CurrentPage": 1,
        "@TotalPages": 1,
        "@TotalResources": 49
    },
    "Vouchers": [
        {
            "@url": "https://api.fortnox.se/3/vouchers/B/25?financialyear=1",
            "Description": "Kundfaktura Anders Svensson (36)",
            "ReferenceNumber": "36",
            "ReferenceType": "INVOICE",
            "TransactionDate": "2014-06-10",
            "VoucherNumber": 25,
            "VoucherSeries": "B",
            "Year": 1
        },

        [...]

        {
            "@url": "https://api.fortnox.se/3/vouchers/D/6?financialyear=1",
            "Description": "Kundfaktura Sven Andersson (58)",
            "ReferenceNumber": "58",
            "ReferenceType": "SUPPLIERINVOICE",
            "TransactionDate": "2014-06-10",
            "VoucherNumber": 6,
            "VoucherSeries": "D",
            "Year": 1
        }
    ]
}

Request

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

import requests

def send_request():
    # Vouchers (GET https://api.fortnox.se/3/vouchers)

    try:
        r = requests.get(
            url="https://api.fortnox.se/3/vouchers",
            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

{
    "MetaInformation": {
        "@CurrentPage": 1,
        "@TotalPages": 1,
        "@TotalResources": 49
    },
    "Vouchers": [
        {
            "@url": "https://api.fortnox.se/3/vouchers/B/25?financialyear=1",
            "Description": "Kundfaktura Anders Svensson (36)",
            "ReferenceNumber": "36",
            "ReferenceType": "INVOICE",
            "TransactionDate": "2014-06-10",
            "VoucherNumber": 25,
            "VoucherSeries": "B",
            "Year": 1
        },

        [...]

        {
            "@url": "https://api.fortnox.se/3/vouchers/D/6?financialyear=1",
            "Description": "Kundfaktura Sven Andersson (58)",
            "ReferenceNumber": "58",
            "ReferenceType": "SUPPLIERINVOICE",
            "TransactionDate": "2014-06-10",
            "VoucherNumber": 6,
            "VoucherSeries": "D",
            "Year": 1
        }
    ]
}

Using our .NET SDK

VoucherConnector connector = new VoucherConnector();
Vouchers result = connector.Find();

List all vouchers in a series

Retrieves a list of vouchers in a specific voucher series. The vouchers are returned sorted by voucher number with the lowest number appearing first.

To retrieve a list of vouchers based on a voucher series we use something called sublist, this is added to the URL together with the voucher series.

Examples

Request

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

Response

{
    "MetaInformation": {
        "@CurrentPage": 1,
        "@TotalPages": 1,
        "@TotalResources": 30
    },
    "Vouchers": [
        {
            "@url": "https://api.fortnox.se/3/vouchers/B/25?financialyear=1",
            "ReferenceNumber": "36",
            "ReferenceType": "INVOICE",
            "VoucherNumber": 25,
            "VoucherSeries": "B",
            "Year": 1
        },

        [...]

        {
            "@url": "https://api.fortnox.se/3/vouchers/B/30?financialyear=1",
            "ReferenceNumber": "48",
            "ReferenceType": "INVOICE",
            "VoucherNumber": 30,
            "VoucherSeries": "B",
            "Year": 1
        }
    ]
}

Request

Using Guzzle

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

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

function send_request() {
    // Vouchers Sublist (GET https://api.fortnox.se/3/vouchers/sublist/B)

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

    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

{
    "MetaInformation": {
        "@CurrentPage": 1,
        "@TotalPages": 1,
        "@TotalResources": 30
    },
    "Vouchers": [
        {
            "@url": "https://api.fortnox.se/3/vouchers/B/25?financialyear=1",
            "ReferenceNumber": "36",
            "ReferenceType": "INVOICE",
            "VoucherNumber": 25,
            "VoucherSeries": "B",
            "Year": 1
        },

        [...]

        {
            "@url": "https://api.fortnox.se/3/vouchers/B/30?financialyear=1",
            "ReferenceNumber": "48",
            "ReferenceType": "INVOICE",
            "VoucherNumber": 30,
            "VoucherSeries": "B",
            "Year": 1
        }
    ]
}

Request

require 'net/http'

def send_request
  # Vouchers Sublist (GET )

  begin
    uri = URI('https://api.fortnox.se/3/vouchers/sublist/B')

    # 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

{
    "MetaInformation": {
        "@CurrentPage": 1,
        "@TotalPages": 1,
        "@TotalResources": 30
    },
    "Vouchers": [
        {
            "@url": "https://api.fortnox.se/3/vouchers/B/25?financialyear=1",
            "ReferenceNumber": "36",
            "ReferenceType": "INVOICE",
            "VoucherNumber": 25,
            "VoucherSeries": "B",
            "Year": 1
        },

        [...]

        {
            "@url": "https://api.fortnox.se/3/vouchers/B/30?financialyear=1",
            "ReferenceNumber": "48",
            "ReferenceType": "INVOICE",
            "VoucherNumber": 30,
            "VoucherSeries": "B",
            "Year": 1
        }
    ]
}

Request

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

import requests

def send_request():
    # Vouchers Sublist (GET https://api.fortnox.se/3/vouchers/sublist/B)

    try:
        r = requests.get(
            url="https://api.fortnox.se/3/vouchers/sublist/B",
            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

{
    "MetaInformation": {
        "@CurrentPage": 1,
        "@TotalPages": 1,
        "@TotalResources": 30
    },
    "Vouchers": [
        {
            "@url": "https://api.fortnox.se/3/vouchers/B/25?financialyear=1",
            "ReferenceNumber": "36",
            "ReferenceType": "INVOICE",
            "VoucherNumber": 25,
            "VoucherSeries": "B",
            "Year": 1
        },

        [...]

        {
            "@url": "https://api.fortnox.se/3/vouchers/B/30?financialyear=1",
            "ReferenceNumber": "48",
            "ReferenceType": "INVOICE",
            "VoucherNumber": 30,
            "VoucherSeries": "B",
            "Year": 1
        }
    ]
}

Using our .NET SDK

VoucherConnector connector = new VoucherConnector();
connector.VoucherSeries = "B";
Vouchers result = connector.Find();

Retrieve a voucher

Retrieves the details of a voucher. To get a unique voucher you need to supply the voucher series and the voucher number, in addition to this you also need to supply the financial year in which the voucher exists.

Examples

Request

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

Response

{
    "Voucher": {
        "@url": "https://api.fortnox.se/3/vouchers/B/25?financialyear=1",
        "Comments": null,
        "CostCenter": "",
        "Description": "Kundfaktura Anders Svensson (36)",
        "Project": 0,
        "ReferenceNumber": "36",
        "ReferenceType": "INVOICE",
        "TransactionDate": "2014-06-10",
        "VoucherNumber": 25,
        "VoucherRows": [
            {
                "Account": 3011,
                "CostCenter": "",
                "Credit": 499,
                "Debit": 0,
                "Description": "F\u00f6rs\u00e4ljning tillverkade produkter 25% moms",
                "Project": "",
                "Removed": false,
                "TransactionInformation": ""
            },
            {
                "Account": 1510,
                "CostCenter": "",
                "Credit": 0,
                "Debit": 499,
                "Description": "Kundfordringar",
                "Project": "",
                "Removed": false,
                "TransactionInformation": ""
            }
        ],
        "VoucherSeries": "B",
        "Year": 1
    }
}

Request

Using Guzzle

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

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

function send_request() {
    // Voucher (GET https://api.fortnox.se/3/vouchers/B/25)

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

    try {
        $query = $request->getQuery();
        $query->replace([
            'financialyear' => '1',
        ]);
        $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

{
    "Voucher": {
        "@url": "https://api.fortnox.se/3/vouchers/B/25?financialyear=1",
        "Comments": null,
        "CostCenter": "",
        "Description": "Kundfaktura Anders Svensson (36)",
        "Project": 0,
        "ReferenceNumber": "36",
        "ReferenceType": "INVOICE",
        "TransactionDate": "2014-06-10",
        "VoucherNumber": 25,
        "VoucherRows": [
            {
                "Account": 3011,
                "CostCenter": "",
                "Credit": 499,
                "Debit": 0,
                "Description": "F\u00f6rs\u00e4ljning tillverkade produkter 25% moms",
                "Project": 0,
                "Removed": false,
                "TransactionInformation": ""
            },
            {
                "Account": 1510,
                "CostCenter": "",
                "Credit": 0,
                "Debit": 499,
                "Description": "Kundfordringar",
                "Project": 0,
                "Removed": false,
                "TransactionInformation": ""
            }
        ],
        "VoucherSeries": "B",
        "Year": 1
    }
}

Request

require 'net/http'

def send_request
  # Voucher (GET )

  begin
    uri = URI('https://api.fortnox.se/3/vouchers/B/25?financialyear=1')

    # 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

{
    "Voucher": {
        "@url": "https://api.fortnox.se/3/vouchers/B/25?financialyear=1",
        "Comments": null,
        "CostCenter": "",
        "Description": "Kundfaktura Anders Svensson (36)",
        "Project": 0,
        "ReferenceNumber": "36",
        "ReferenceType": "INVOICE",
        "TransactionDate": "2014-06-10",
        "VoucherNumber": 25,
        "VoucherRows": [
            {
                "Account": 3011,
                "CostCenter": "",
                "Credit": 499,
                "Debit": 0,
                "Description": "F\u00f6rs\u00e4ljning tillverkade produkter 25% moms",
                "Project": 0,
                "Removed": false,
                "TransactionInformation": ""
            },
            {
                "Account": 1510,
                "CostCenter": "",
                "Credit": 0,
                "Debit": 499,
                "Description": "Kundfordringar",
                "Project": 0,
                "Removed": false,
                "TransactionInformation": ""
            }
        ],
        "VoucherSeries": "B",
        "Year": 1
    }
}

Request

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

import requests

def send_request():
    # Voucher (GET https://api.fortnox.se/3/vouchers/B/25)

    try:
        r = requests.get(
            url="https://api.fortnox.se/3/vouchers/B/25",
            params = {
                "financialyear":"1",
            },
            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

{
    "Voucher": {
        "@url": "https://api.fortnox.se/3/vouchers/B/25?financialyear=1",
        "Comments": null,
        "CostCenter": "",
        "Description": "Kundfaktura Anders Svensson (36)",
        "Project": 0,
        "ReferenceNumber": "36",
        "ReferenceType": "INVOICE",
        "TransactionDate": "2014-06-10",
        "VoucherNumber": 25,
        "VoucherRows": [
            {
                "Account": 3011,
                "CostCenter": "",
                "Credit": 499,
                "Debit": 0,
                "Description": "F\u00f6rs\u00e4ljning tillverkade produkter 25% moms",
                "Project": 0,
                "Removed": false,
                "TransactionInformation": ""
            },
            {
                "Account": 1510,
                "CostCenter": "",
                "Credit": 0,
                "Debit": 499,
                "Description": "Kundfordringar",
                "Project": 0,
                "Removed": false,
                "TransactionInformation": ""
            }
        ],
        "VoucherSeries": "B",
        "Year": 1
    }
}

Using our .NET SDK

VoucherConnector connector = new VoucherConnector();
connector.FinancialYearID = "1";
Voucher result = connector.Get("B", "25");

Create a voucher

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

Examples

Request

curl -X "POST" "https://api.fortnox.se/3/vouchers" \
     -H "Access-Token: 61cf63ae-4ab9-4a95-9db5-753781c4f41f" \
     -H "Client-Secret: 3Er4kHXZTJ" \
     -H "Content-Type: application/json" \
     -H "Accept: application/json" \
     -d $'{
  "Voucher": {
    "TransactionDate": "2015-02-01",
    "Description": "Example transaction",
    "VoucherRows": [
        {
          "Account": "1930",
          "Debit": "1500",
          "Credit": "0"
        },
        {
          "Account": "1910",
          "Debit": "0",
          "Credit": "1500"
        }
    ],
    "VoucherSeries": "A"
  }
}'

Response

{
    "Voucher": {
        "@url": "https://api.fortnox.se/3/vouchers/A/1?financialyear=2",
        "Comments": null,
        "CostCenter": "",
        "Description": "Example transaction",
        "Project": 0,
        "ReferenceNumber": "",
        "ReferenceType": "MANUAL",
        "TransactionDate": "2015-02-01",
        "VoucherNumber": 1,
        "VoucherRows": [
            {
                "Account": 1930,
                "CostCenter": "",
                "Credit": 0,
                "Debit": 1500,
                "Description": "F\u00f6retagskonto / checkkonto / aff\u00e4rskonto",
                "Project": "",
                "Removed": false,
                "TransactionInformation": ""
            },
            {
                "Account": 1910,
                "CostCenter": "",
                "Credit": 1500,
                "Debit": 0,
                "Description": "Kassa",
                "Project": "",
                "Removed": false,
                "TransactionInformation": ""
            }
        ],
        "VoucherSeries": "A",
        "Year": 2
    }
}

Request

Using Guzzle

// 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() {
    // Voucher (POST https://api.fortnox.se/3/vouchers)

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

    try {
        $request->addHeaders([
            'Access-Token'=>'61cf63ae-4ab9-4a95-9db5-753781c4f41f',
            'Client-Secret'=>'3Er4kHXZTJ',
            'Content-Type'=>'application/json',
            'Accept'=>'application/json',
        ]);
        $body = [
            "Voucher" => [
                "Description" => "Example transaction",
                "VoucherSeries" => "A",
                "TransactionDate" => "2015-02-01",
                "VoucherRows" => [
                    [
                        "Description" => "Företagskonto / checkkonto / affärskonto",
                        "Debit" => "1500",
                        "Account" => "1930",
                        "Credit" => "0"
                    ],
                    [
                        "Description" => "Kassa",
                        "Debit" => "0",
                        "Account" => "1910",
                        "Credit" => "1500"
                    ]
                ]
            ]
        ];
        $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

{
    "Voucher": {
        "@url": "https://api.fortnox.se/3/vouchers/A/1?financialyear=2",
        "Comments": null,
        "CostCenter": "",
        "Description": "Example transaction",
        "Project": 0,
        "ReferenceNumber": "",
        "ReferenceType": "MANUAL",
        "TransactionDate": "2015-02-01",
        "VoucherNumber": 1,
        "VoucherRows": [
            {
                "Account": 1930,
                "CostCenter": "",
                "Credit": 0,
                "Debit": 1500,
                "Description": "F\u00f6retagskonto / checkkonto / aff\u00e4rskonto",
                "Project": 0,
                "Removed": false,
                "TransactionInformation": ""
            },
            {
                "Account": 1910,
                "CostCenter": "",
                "Credit": 1500,
                "Debit": 0,
                "Description": "Kassa",
                "Project": 0,
                "Removed": false,
                "TransactionInformation": ""
            }
        ],
        "VoucherSeries": "A",
        "Year": 2
    }
}

Request

require 'net/http'
require 'json'

def send_request
  # Voucher (POST )

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

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

    dict = {
            "Voucher" => {
                "Description" => "Example transaction",
                "VoucherSeries" => "A",
                "TransactionDate" => "2015-02-01",
                "VoucherRows" => [
                    {
                        "Description" => "Företagskonto / checkkonto / affärskonto",
                        "Debit" => "1500",
                        "Account" => "1930",
                        "Credit" => "0"
                    },
                    {
                        "Description" => "Kassa",
                        "Debit" => "0",
                        "Account" => "1910",
                        "Credit" => "1500"
                    }
                ]
            }
        }
    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

{
    "Voucher": {
        "@url": "https://api.fortnox.se/3/vouchers/A/1?financialyear=2",
        "Comments": null,
        "CostCenter": "",
        "Description": "Example transaction",
        "Project": 0,
        "ReferenceNumber": "",
        "ReferenceType": "MANUAL",
        "TransactionDate": "2015-02-01",
        "VoucherNumber": 1,
        "VoucherRows": [
            {
                "Account": 1930,
                "CostCenter": "",
                "Credit": 0,
                "Debit": 1500,
                "Description": "F\u00f6retagskonto / checkkonto / aff\u00e4rskonto",
                "Project": 0,
                "Removed": false,
                "TransactionInformation": ""
            },
            {
                "Account": 1910,
                "CostCenter": "",
                "Credit": 1500,
                "Debit": 0,
                "Description": "Kassa",
                "Project": 0,
                "Removed": false,
                "TransactionInformation": ""
            }
        ],
        "VoucherSeries": "A",
        "Year": 2
    }
}

Request

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

import requests
import json

def send_request():
    # Voucher (POST https://api.fortnox.se/3/vouchers)

    try:
        r = requests.post(
            url="https://api.fortnox.se/3/vouchers",
            headers = {
                "Access-Token":"61cf63ae-4ab9-4a95-9db5-753781c4f41f",
                "Client-Secret":"3Er4kHXZTJ",
                "Content-Type":"application/json",
                "Accept":"application/json",
            },
            data = json.dumps({
                "Voucher": {
                    "Description": "Example transaction",
                    "VoucherSeries": "A",
                    "TransactionDate": "2015-02-01",
                    "VoucherRows": [
                        {
                            "Description": "Företagskonto / checkkonto / affärskonto",
                            "Debit": "1500",
                            "Account": "1930",
                            "Credit": "0"
                        },
                        {
                            "Description": "Kassa",
                            "Debit": "0",
                            "Account": "1910",
                            "Credit": "1500"
                        }
                    ]
                }
            })
        )
        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

{
    "Voucher": {
        "@url": "https://api.fortnox.se/3/vouchers/A/1?financialyear=2",
        "Comments": null,
        "CostCenter": "",
        "Description": "Example transaction",
        "Project": 0,
        "ReferenceNumber": "",
        "ReferenceType": "MANUAL",
        "TransactionDate": "2015-02-01",
        "VoucherNumber": 1,
        "VoucherRows": [
            {
                "Account": 1930,
                "CostCenter": "",
                "Credit": 0,
                "Debit": 1500,
                "Description": "F\u00f6retagskonto / checkkonto / aff\u00e4rskonto",
                "Project": 0,
                "Removed": false,
                "TransactionInformation": ""
            },
            {
                "Account": 1910,
                "CostCenter": "",
                "Credit": 1500,
                "Debit": 0,
                "Description": "Kassa",
                "Project": 0,
                "Removed": false,
                "TransactionInformation": ""
            }
        ],
        "VoucherSeries": "A",
        "Year": 2
    }
}

Using our .NET SDK

VoucherConnector connector = new VoucherConnector();
List<VoucherRow> rows = new List<VoucherRow>();
rows.Add(new VoucherRow() { 
    Account = "1930", 
    Description = "Företagskonto / checkkonto / affärskonto", 
    Debit = "1500", 
    Credit = "0" 
});
rows.Add(new VoucherRow() { 
    Account = "1910", 
    Description = "Kassa", 
    Debit = "0", 
    Credit = "1500" 
});
Voucher result = connector.Create(new Voucher() { 
    TransactionDate = "2015-02-01", 
    Description = "Example transaction", 
    VoucherRows = rows, 
    VoucherSeries = "A" 
});

Properties

Voucher

Property	Description
Url	string, read-only Direct URL to the record.
Comments	string, 1000 characters Comments of the voucher.
CostCenter	string, searchable Code of the cost center. The code must be of an existing cost center.
Description	string, 200 characters, required Description of the voucher.
Project	string Code of the project. The code must be of an existing project.
ReferenceNumber	string, sortable, read-only Reference number, for example an invoice number.
ReferenceType	string, read-only Reference type. Can be INVOICE SUPPLIERINVOICE INVOICEPAYMENT SUPPLIERPAYMENT MANUAL CASHINVOICE or ACCRUAL
TransactionDate	date, required Date of the transaction. Must be a valid date according to our date format.
VoucherNumber	integer, sortable, read-only Number of the voucher
VoucherRows	array The properties for the object in this array is listed in the table for “Voucher Rows”.
VoucherSeries	string, sortable Code of the voucher series. The code must be of an existing voucher series.
Year	integer, read-only Id of the year of the voucher.
ApprovalState	integer, read-only The approval state f the voucher. Not for approval: 0 Not ready for approval: 1 Not approved: 2 Approved: 3

Voucher Rows

Property	Description
Account	integer, 4 digits Account number. The number must be of an existing active account.
CostCenter	string Code of the cost center. The code must be of an existing cost center.
Credit	float, 14 digits (incl. decimals) Amount of credit.
Description	string, read-only The description of the account.
Debit	float, 14 digits (incl. decimals) Amount of debit.
Project	string Code of the project. The code must be of an existing project.
Removed	boolean, read-only If the row is marked as removed.
TransactionInformation	string, 100 characters Transaction information regarding the row.

Table of content

List all vouchers

Examples

Request

Response

Request

Response

Request

Response

Request

Response

List all vouchers in a series

Examples

Request

Response

Request

Response

Request

Response

Request

Response

Retrieve a voucher

Examples

Request

Response

Request

Response

Request

Response

Request

Response

Create a voucher

Examples

Request

Response

Request

Response

Request

Response

Request

Response

Properties

Voucher

Voucher Rows