Customers

List all customers

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

Examples

Request

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

Response

{
    "Customers": [
        {
            "@url": "https://api.fortnox.se/3/customers/102",
            "Address1": "Halltorpsgatan",
            "Address2": "",
            "City": "KLIPPAN",
            "CustomerNumber": "102",
            "Email": "a.s@example.com",
            "Name": "Anders Svensson",
            "OrganisationNumber": "",
            "Phone": "0435-9249236",
            "ZipCode": "264 32"
        },

        [...]

        {
            "@url": "https://api.fortnox.se/3/customers/110",
            "Address1": "Bjurtjärn åsviken",
            "Address2": "",
            "City": "ÄLMHULT",
            "CustomerNumber": "102",
            "Email": "s.v@example.com",
            "Name": "Stina Velander",
            "OrganisationNumber": "",
            "Phone": "0476-1352274",
            "ZipCode": "343 90"
        }
    ],
    "MetaInformation": {
        "@CurrentPage": 1,
        "@TotalPages": 1,
        "@TotalResources": 10
    }
}

Request

Using Guzzle

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

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

function send_request() {
    // Customers (GET https://api.fortnox.se/3/customers)

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

    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

{
    "Customers": [
        {
            "@url": "https://api.fortnox.se/3/customers/102",
            "Address1": "Halltorpsgatan",
            "Address2": "",
            "City": "KLIPPAN",
            "CustomerNumber": "102",
            "Email": "a.s@example.com",
            "Name": "Anders Svensson",
            "OrganisationNumber": "",
            "Phone": "0435-9249236",
            "ZipCode": "264 32"
        },

        [...]

        {
            "@url": "https://api.fortnox.se/3/customers/110",
            "Address1": "Bjurtjärn åsviken",
            "Address2": "",
            "City": "ÄLMHULT",
            "CustomerNumber": "102",
            "Email": "s.v@example.com",
            "Name": "Stina Velander",
            "OrganisationNumber": "",
            "Phone": "0476-1352274",
            "ZipCode": "343 90"
        }
    ],
    "MetaInformation": {
        "@CurrentPage": 1,
        "@TotalPages": 1,
        "@TotalResources": 10
    }
}

Request

require 'net/http'

def send_request
  # Customers (GET )

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

    # 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

{
    "Customers": [
        {
            "@url": "https://api.fortnox.se/3/customers/102",
            "Address1": "Halltorpsgatan",
            "Address2": "",
            "City": "KLIPPAN",
            "CustomerNumber": "102",
            "Email": "a.s@example.com",
            "Name": "Anders Svensson",
            "OrganisationNumber": "",
            "Phone": "0435-9249236",
            "ZipCode": "264 32"
        },

        [...]

        {
            "@url": "https://api.fortnox.se/3/customers/110",
            "Address1": "Bjurtjärn åsviken",
            "Address2": "",
            "City": "ÄLMHULT",
            "CustomerNumber": "102",
            "Email": "s.v@example.com",
            "Name": "Stina Velander",
            "OrganisationNumber": "",
            "Phone": "0476-1352274",
            "ZipCode": "343 90"
        }
    ],
    "MetaInformation": {
        "@CurrentPage": 1,
        "@TotalPages": 1,
        "@TotalResources": 10
    }
}

Request

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

import requests

def send_request():
    # Customers (GET https://api.fortnox.se/3/customers)

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

{
    "Customers": [
        {
            "@url": "https://api.fortnox.se/3/customers/102",
            "Address1": "Halltorpsgatan",
            "Address2": "",
            "City": "KLIPPAN",
            "CustomerNumber": "102",
            "Email": "a.s@example.com",
            "Name": "Anders Svensson",
            "OrganisationNumber": "",
            "Phone": "0435-9249236",
            "ZipCode": "264 32"
        },

        [...]

        {
            "@url": "https://api.fortnox.se/3/customers/110",
            "Address1": "Bjurtjärn åsviken",
            "Address2": "",
            "City": "ÄLMHULT",
            "CustomerNumber": "102",
            "Email": "s.v@example.com",
            "Name": "Stina Velander",
            "OrganisationNumber": "",
            "Phone": "0476-1352274",
            "ZipCode": "343 90"
        }
    ],
    "MetaInformation": {
        "@CurrentPage": 1,
        "@TotalPages": 1,
        "@TotalResources": 10
    }
}

Using our .NET SDK

CustomerConnector connector = new CustomerConnector();
Customers result = connector.Find();

Retrieve a customer

Retrieves the details of a customer. You need to supply the unique customer number that was returned when the customer was created or retrieved from the list of customers.

Examples

Request

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

Response

{
    "Customer": {
        "@url": "https://api.fortnox.se/3/customers/102",
        "Active": true,
        "Address1": "Halltorpsgatan",
        "Address2": null,
        "City": "KLIPPAN",
        "Comments": null,
        "CostCenter": null,
        "Country": "Sverige",
        "CountryCode": "SE",
        "Currency": "SEK",
        "CustomerNumber": "102",
        "DefaultDeliveryTypes": {
            "Invoice": "PRINT",
            "Offer": "PRINT",
            "Order": "PRINT"
        },
        "DefaultTemplates": {
            "CashInvoice": "DEFAULTTEMPLATE",
            "Invoice": "DEFAULTTEMPLATE",
            "Offer": "DEFAULTTEMPLATE",
            "Order": "DEFAULTTEMPLATE"
        },
        "DeliveryAddress1": null,
        "DeliveryAddress2": null,
        "DeliveryCity": null,
        "DeliveryCountry": null,
        "DeliveryCountryCode": null,
        "DeliveryFax": null,
        "DeliveryName": null,
        "DeliveryPhone1": null,
        "DeliveryPhone2": null,
        "DeliveryZipCode": null,
        "Email": "a.s@example.com",
        "EmailInvoice": "a.s@example.com",
        "EmailInvoiceBCC": "",
        "EmailInvoiceCC": "",
        "EmailOffer": "a.s@example.com",
        "EmailOfferBCC": "",
        "EmailOfferCC": "",
        "EmailOrder": "a.s@example.com",
        "EmailOrderBCC": "",
        "EmailOrderCC": "",
        "Fax": null,
        "GLN": null,
        "GLNDelivery": null,
        "InvoiceAdministrationFee": null,
        "InvoiceDiscount": null,
        "InvoiceFreight": null,
        "InvoiceRemark": "",
        "Name": "Anders Svensson",
        "OrganisationNumber": "",
        "OurReference": "",
        "Phone1": "0435-9249236",
        "Phone2": null,
        "PriceList": "A",
        "Project": "",
        "SalesAccount": null,
        "ShowPriceVATIncluded": false,
        "TermsOfDelivery": "",
        "TermsOfPayment": "",
        "Type": "PRIVATE",
        "VATNumber": "",
        "VATType": "SEVAT",
        "VisitingAddress": null,
        "VisitingCity": null,
        "VisitingCountry": null,
        "VisitingCountryCode": null,
        "VisitingZipCode": null,
        "WWW": "",
        "WayOfDelivery": "",
        "YourReference": "",
        "ZipCode": "264 32"
    }
}

Request

Using Guzzle

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

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

function send_request() {
    // Customer (GET https://api.fortnox.se/3/customers/102)

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

    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

{
    "Customer": {
        "@url": "https://api.fortnox.se/3/customers/102",
        "Address1": "Halltorpsgatan",
        "Address2": null,
        "City": "KLIPPAN",
        "Comments": null,
        "CostCenter": null,
        "Country": "Sverige",
        "CountryCode": "SE",
        "Currency": "SEK",
        "CustomerNumber": "102",
        "DefaultDeliveryTypes": {
            "Invoice": "PRINT",
            "Offer": "PRINT",
            "Order": "PRINT"
        },
        "DefaultTemplates": {
            "CashInvoice": "DEFAULTTEMPLATE",
            "Invoice": "DEFAULTTEMPLATE",
            "Offer": "DEFAULTTEMPLATE",
            "Order": "DEFAULTTEMPLATE"
        },
        "DeliveryAddress1": null,
        "DeliveryAddress2": null,
        "DeliveryCity": null,
        "DeliveryCountry": null,
        "DeliveryCountryCode": null,
        "DeliveryFax": null,
        "DeliveryName": null,
        "DeliveryPhone1": null,
        "DeliveryPhone2": null,
        "DeliveryZipCode": null,
        "Email": "a.s@example.com",
        "EmailInvoice": "a.s@example.com",
        "EmailInvoiceBCC": "",
        "EmailInvoiceCC": "",
        "EmailOffer": "a.s@example.com",
        "EmailOfferBCC": "",
        "EmailOfferCC": "",
        "EmailOrder": "a.s@example.com",
        "EmailOrderBCC": "",
        "EmailOrderCC": "",
        "Fax": null,
        "InvoiceAdministrationFee": null,
        "InvoiceDiscount": null,
        "InvoiceFreight": null,
        "InvoiceRemark": "",
        "Name": "Anders Svensson",
        "OrganisationNumber": "",
        "OurReference": "",
        "Phone1": "0435-9249236",
        "Phone2": null,
        "PriceList": "A",
        "Project": null,
        "SalesAccount": null,
        "ShowPriceVATIncluded": false,
        "TermsOfDelivery": "",
        "TermsOfPayment": "",
        "Type": "PRIVATE",
        "VATNumber": "",
        "VATType": "SEVAT",
        "VisitingAddress": null,
        "VisitingCity": null,
        "VisitingCountry": null,
        "VisitingCountryCode": null,
        "VisitingZipCode": null,
        "WWW": "",
        "WayOfDelivery": "",
        "YourReference": "",
        "ZipCode": "264 32"
    }
}

Request

require 'net/http'

def send_request
  # Customer (GET )

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

    # 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

{
    "Customer": {
        "@url": "https://api.fortnox.se/3/customers/102",
        "Address1": "Halltorpsgatan",
        "Address2": null,
        "City": "KLIPPAN",
        "Comments": null,
        "CostCenter": null,
        "Country": "Sverige",
        "CountryCode": "SE",
        "Currency": "SEK",
        "CustomerNumber": "102",
        "DefaultDeliveryTypes": {
            "Invoice": "PRINT",
            "Offer": "PRINT",
            "Order": "PRINT"
        },
        "DefaultTemplates": {
            "CashInvoice": "DEFAULTTEMPLATE",
            "Invoice": "DEFAULTTEMPLATE",
            "Offer": "DEFAULTTEMPLATE",
            "Order": "DEFAULTTEMPLATE"
        },
        "DeliveryAddress1": null,
        "DeliveryAddress2": null,
        "DeliveryCity": null,
        "DeliveryCountry": null,
        "DeliveryCountryCode": null,
        "DeliveryFax": null,
        "DeliveryName": null,
        "DeliveryPhone1": null,
        "DeliveryPhone2": null,
        "DeliveryZipCode": null,
        "Email": "a.s@example.com",
        "EmailInvoice": "a.s@example.com",
        "EmailInvoiceBCC": "",
        "EmailInvoiceCC": "",
        "EmailOffer": "a.s@example.com",
        "EmailOfferBCC": "",
        "EmailOfferCC": "",
        "EmailOrder": "a.s@example.com",
        "EmailOrderBCC": "",
        "EmailOrderCC": "",
        "Fax": null,
        "InvoiceAdministrationFee": null,
        "InvoiceDiscount": null,
        "InvoiceFreight": null,
        "InvoiceRemark": "",
        "Name": "Anders Svensson",
        "OrganisationNumber": "",
        "OurReference": "",
        "Phone1": "0435-9249236",
        "Phone2": null,
        "PriceList": "A",
        "Project": null,
        "SalesAccount": null,
        "ShowPriceVATIncluded": false,
        "TermsOfDelivery": "",
        "TermsOfPayment": "",
        "Type": "PRIVATE",
        "VATNumber": "",
        "VATType": "SEVAT",
        "VisitingAddress": null,
        "VisitingCity": null,
        "VisitingCountry": null,
        "VisitingCountryCode": null,
        "VisitingZipCode": null,
        "WWW": "",
        "WayOfDelivery": "",
        "YourReference": "",
        "ZipCode": "264 32"
    }
}

Request

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

import requests

def send_request():
    # Customer (GET https://api.fortnox.se/3/customers/102)

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

{
    "Customer": {
        "@url": "https://api.fortnox.se/3/customers/102",
        "Address1": "Halltorpsgatan",
        "Address2": null,
        "City": "KLIPPAN",
        "Comments": null,
        "CostCenter": null,
        "Country": "Sverige",
        "CountryCode": "SE",
        "Currency": "SEK",
        "CustomerNumber": "102",
        "DefaultDeliveryTypes": {
            "Invoice": "PRINT",
            "Offer": "PRINT",
            "Order": "PRINT"
        },
        "DefaultTemplates": {
            "CashInvoice": "DEFAULTTEMPLATE",
            "Invoice": "DEFAULTTEMPLATE",
            "Offer": "DEFAULTTEMPLATE",
            "Order": "DEFAULTTEMPLATE"
        },
        "DeliveryAddress1": null,
        "DeliveryAddress2": null,
        "DeliveryCity": null,
        "DeliveryCountry": null,
        "DeliveryCountryCode": null,
        "DeliveryFax": null,
        "DeliveryName": null,
        "DeliveryPhone1": null,
        "DeliveryPhone2": null,
        "DeliveryZipCode": null,
        "Email": "a.s@example.com",
        "EmailInvoice": "a.s@example.com",
        "EmailInvoiceBCC": "",
        "EmailInvoiceCC": "",
        "EmailOffer": "a.s@example.com",
        "EmailOfferBCC": "",
        "EmailOfferCC": "",
        "EmailOrder": "a.s@example.com",
        "EmailOrderBCC": "",
        "EmailOrderCC": "",
        "Fax": null,
        "InvoiceAdministrationFee": null,
        "InvoiceDiscount": null,
        "InvoiceFreight": null,
        "InvoiceRemark": "",
        "Name": "Anders Svensson",
        "OrganisationNumber": "",
        "OurReference": "",
        "Phone1": "0435-9249236",
        "Phone2": null,
        "PriceList": "A",
        "Project": null,
        "SalesAccount": null,
        "ShowPriceVATIncluded": false,
        "TermsOfDelivery": "",
        "TermsOfPayment": "",
        "Type": "PRIVATE",
        "VATNumber": "",
        "VATType": "SEVAT",
        "VisitingAddress": null,
        "VisitingCity": null,
        "VisitingCountry": null,
        "VisitingCountryCode": null,
        "VisitingZipCode": null,
        "WWW": "",
        "WayOfDelivery": "",
        "YourReference": "",
        "ZipCode": "264 32"
    }
}

Using our .NET SDK

CustomerConnector connector = new CustomerConnector();
Customer result = connector.Get("102");

Create a customer

The created customer 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/customers" \
     -H "Access-Token: 61cf63ae-4ab9-4a95-9db5-753781c4f41f" \
     -H "Client-Secret: 3Er4kHXZTJ" \
     -H "Content-Type: application/json" \
     -H "Accept: application/json" \
     -d $'{
	"Customer":{
		"Name": "Klara Norström"
	}
}'

Response

{
    "Customer": {
        "@url": "https://api.fortnox.se/3/customers/115",
        "Active": true,
        "Address1": null,
        "Address2": null,
        "City": null,
        "Comments": null,
        "CostCenter": null,
        "Country": null,
        "CountryCode": null,
        "Currency": "SEK",
        "CustomerNumber": 115,
        "DefaultDeliveryTypes": {
            "Invoice": "PRINT",
            "Offer": "PRINT",
            "Order": "PRINT"
        },
        "DefaultTemplates": {
            "CashInvoice": "DEFAULTTEMPLATE",
            "Invoice": "DEFAULTTEMPLATE",
            "Offer": "DEFAULTTEMPLATE",
            "Order": "DEFAULTTEMPLATE"
        },
        "DeliveryAddress1": null,
        "DeliveryAddress2": null,
        "DeliveryCity": null,
        "DeliveryCountry": null,
        "DeliveryCountryCode": null,
        "DeliveryFax": null,
        "DeliveryName": null,
        "DeliveryPhone1": null,
        "DeliveryPhone2": null,
        "DeliveryZipCode": null,
        "Email": "",
        "EmailInvoice": "",
        "EmailInvoiceBCC": "",
        "EmailInvoiceCC": "",
        "EmailOffer": "",
        "EmailOfferBCC": "",
        "EmailOfferCC": "",
        "EmailOrder": "",
        "EmailOrderBCC": "",
        "EmailOrderCC": "",
        "Fax": null,
        "GLN": null,
        "GLNDelivery": null,
        "InvoiceAdministrationFee": null,
        "InvoiceDiscount": null,
        "InvoiceFreight": null,
        "InvoiceRemark": "",
        "Name": "Klara Norstr\u00f6m",
        "OrganisationNumber": "",
        "OurReference": "",
        "Phone1": null,
        "Phone2": null,
        "PriceList": "A",
        "Project": "",
        "SalesAccount": null,
        "ShowPriceVATIncluded": false,
        "TermsOfDelivery": "",
        "TermsOfPayment": "",
        "Type": "COMPANY",
        "VATNumber": "",
        "VATType": "SEVAT",
        "VisitingAddress": null,
        "VisitingCity": null,
        "VisitingCountry": null,
        "VisitingCountryCode": null,
        "VisitingZipCode": null,
        "WWW": "",
        "WayOfDelivery": "",
        "YourReference": "",
        "ZipCode": null
    }
}

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

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

    try {
        $request->addHeaders([
            'Access-Token'=>'61cf63ae-4ab9-4a95-9db5-753781c4f41f',
            'Client-Secret'=>'3Er4kHXZTJ',
            'Content-Type'=>'application/json',
            'Accept'=>'application/json',
        ]);
        $body = [
            "Customer" => [
                "Name" => "Klara Norström"
            ]
        ];
        $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

{
    "Customer": {
        "@url": "https://api.fortnox.se/3/customers/115",
        "Address1": null,
        "Address2": null,
        "City": null,
        "Comments": null,
        "CostCenter": null,
        "Country": null,
        "CountryCode": null,
        "Currency": "SEK",
        "CustomerNumber": 115,
        "DefaultDeliveryTypes": {
            "Invoice": "PRINT",
            "Offer": "PRINT",
            "Order": "PRINT"
        },
        "DefaultTemplates": {
            "CashInvoice": "DEFAULTTEMPLATE",
            "Invoice": "DEFAULTTEMPLATE",
            "Offer": "DEFAULTTEMPLATE",
            "Order": "DEFAULTTEMPLATE"
        },
        "DeliveryAddress1": null,
        "DeliveryAddress2": null,
        "DeliveryCity": null,
        "DeliveryCountry": null,
        "DeliveryCountryCode": null,
        "DeliveryFax": null,
        "DeliveryName": null,
        "DeliveryPhone1": null,
        "DeliveryPhone2": null,
        "DeliveryZipCode": null,
        "Email": "",
        "EmailInvoice": "",
        "EmailInvoiceBCC": "",
        "EmailInvoiceCC": "",
        "EmailOffer": "",
        "EmailOfferBCC": "",
        "EmailOfferCC": "",
        "EmailOrder": "",
        "EmailOrderBCC": "",
        "EmailOrderCC": "",
        "Fax": null,
        "InvoiceAdministrationFee": null,
        "InvoiceDiscount": null,
        "InvoiceFreight": null,
        "InvoiceRemark": "",
        "Name": "Klara Norstr\u00f6m",
        "OrganisationNumber": "",
        "OurReference": "",
        "Phone1": null,
        "Phone2": null,
        "PriceList": "A",
        "Project": null,
        "SalesAccount": null,
        "ShowPriceVATIncluded": false,
        "TermsOfDelivery": "",
        "TermsOfPayment": "",
        "Type": "COMPANY",
        "VATNumber": "",
        "VATType": "SEVAT",
        "VisitingAddress": null,
        "VisitingCity": null,
        "VisitingCountry": null,
        "VisitingCountryCode": null,
        "VisitingZipCode": null,
        "WWW": "",
        "WayOfDelivery": "",
        "YourReference": "",
        "ZipCode": null
    }
}

Request

require 'net/http'
require 'json'

def send_request
  # Customer (POST )

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

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

    dict = {
            "Customer" => {
                "Name" => "Klara Norström"
            }
        }
    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

{
    "Customer": {
        "@url": "https://api.fortnox.se/3/customers/115",
        "Address1": null,
        "Address2": null,
        "City": null,
        "Comments": null,
        "CostCenter": null,
        "Country": null,
        "CountryCode": null,
        "Currency": "SEK",
        "CustomerNumber": 115,
        "DefaultDeliveryTypes": {
            "Invoice": "PRINT",
            "Offer": "PRINT",
            "Order": "PRINT"
        },
        "DefaultTemplates": {
            "CashInvoice": "DEFAULTTEMPLATE",
            "Invoice": "DEFAULTTEMPLATE",
            "Offer": "DEFAULTTEMPLATE",
            "Order": "DEFAULTTEMPLATE"
        },
        "DeliveryAddress1": null,
        "DeliveryAddress2": null,
        "DeliveryCity": null,
        "DeliveryCountry": null,
        "DeliveryCountryCode": null,
        "DeliveryFax": null,
        "DeliveryName": null,
        "DeliveryPhone1": null,
        "DeliveryPhone2": null,
        "DeliveryZipCode": null,
        "Email": "",
        "EmailInvoice": "",
        "EmailInvoiceBCC": "",
        "EmailInvoiceCC": "",
        "EmailOffer": "",
        "EmailOfferBCC": "",
        "EmailOfferCC": "",
        "EmailOrder": "",
        "EmailOrderBCC": "",
        "EmailOrderCC": "",
        "Fax": null,
        "InvoiceAdministrationFee": null,
        "InvoiceDiscount": null,
        "InvoiceFreight": null,
        "InvoiceRemark": "",
        "Name": "Klara Norstr\u00f6m",
        "OrganisationNumber": "",
        "OurReference": "",
        "Phone1": null,
        "Phone2": null,
        "PriceList": "A",
        "Project": null,
        "SalesAccount": null,
        "ShowPriceVATIncluded": false,
        "TermsOfDelivery": "",
        "TermsOfPayment": "",
        "Type": "COMPANY",
        "VATNumber": "",
        "VATType": "SEVAT",
        "VisitingAddress": null,
        "VisitingCity": null,
        "VisitingCountry": null,
        "VisitingCountryCode": null,
        "VisitingZipCode": null,
        "WWW": "",
        "WayOfDelivery": "",
        "YourReference": "",
        "ZipCode": null
    }
}

Request

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

import requests
import json

def send_request():
    # Customer (POST https://api.fortnox.se/3/customers)

    try:
        r = requests.post(
            url="https://api.fortnox.se/3/customers",
            headers = {
                "Access-Token":"61cf63ae-4ab9-4a95-9db5-753781c4f41f",
                "Client-Secret":"3Er4kHXZTJ",
                "Content-Type":"application/json",
                "Accept":"application/json",
            },
            data = json.dumps({
                "Customer": {
                    "Name": "Klara Norström"
                }
            })
        )
        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

{
    "Customer": {
        "@url": "https://api.fortnox.se/3/customers/115",
        "Address1": null,
        "Address2": null,
        "City": null,
        "Comments": null,
        "CostCenter": null,
        "Country": null,
        "CountryCode": null,
        "Currency": "SEK",
        "CustomerNumber": 115,
        "DefaultDeliveryTypes": {
            "Invoice": "PRINT",
            "Offer": "PRINT",
            "Order": "PRINT"
        },
        "DefaultTemplates": {
            "CashInvoice": "DEFAULTTEMPLATE",
            "Invoice": "DEFAULTTEMPLATE",
            "Offer": "DEFAULTTEMPLATE",
            "Order": "DEFAULTTEMPLATE"
        },
        "DeliveryAddress1": null,
        "DeliveryAddress2": null,
        "DeliveryCity": null,
        "DeliveryCountry": null,
        "DeliveryCountryCode": null,
        "DeliveryFax": null,
        "DeliveryName": null,
        "DeliveryPhone1": null,
        "DeliveryPhone2": null,
        "DeliveryZipCode": null,
        "Email": "",
        "EmailInvoice": "",
        "EmailInvoiceBCC": "",
        "EmailInvoiceCC": "",
        "EmailOffer": "",
        "EmailOfferBCC": "",
        "EmailOfferCC": "",
        "EmailOrder": "",
        "EmailOrderBCC": "",
        "EmailOrderCC": "",
        "Fax": null,
        "InvoiceAdministrationFee": null,
        "InvoiceDiscount": null,
        "InvoiceFreight": null,
        "InvoiceRemark": "",
        "Name": "Klara Norstr\u00f6m",
        "OrganisationNumber": "",
        "OurReference": "",
        "Phone1": null,
        "Phone2": null,
        "PriceList": "A",
        "Project": null,
        "SalesAccount": null,
        "ShowPriceVATIncluded": false,
        "TermsOfDelivery": "",
        "TermsOfPayment": "",
        "Type": "COMPANY",
        "VATNumber": "",
        "VATType": "SEVAT",
        "VisitingAddress": null,
        "VisitingCity": null,
        "VisitingCountry": null,
        "VisitingCountryCode": null,
        "VisitingZipCode": null,
        "WWW": "",
        "WayOfDelivery": "",
        "YourReference": "",
        "ZipCode": null
    }
}

Using our .NET SDK

CustomerConnector connector = new CustomerConnector();
Customer result = connector.Create(new Customer() { 
    Name = "Klara Norström" 
});

Update a customer

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

You need to supply the unique customer number of the customer that you want to update.

Only the properties provided in the request body will be updated, properties not provided will left unchanged.

Examples

Request

curl -X "PUT" "https://api.fortnox.se/3/customers/115" \
     -H "Access-Token: 61cf63ae-4ab9-4a95-9db5-753781c4f41f" \
     -H "Client-Secret: 3Er4kHXZTJ" \
     -H "Content-Type: application/json" \
     -H "Accept: application/json" \
     -d $'{
     "Customer":{
          "Address1": "Hällesjö",
          "City": "Hultsfred",
          "ZipCode": "57737",
          "CountryCode": "SE"
     }
}'

Response

{
    "Customer": {
        "@url": "https://api.fortnox.se/3/customers/115",
        "Active": true,
        "Address1": "H\u00e4llesj\u00f6",
        "Address2": null,
        "City": "Hultsfred",
        "Comments": null,
        "CostCenter": null,
        "Country": "Sverige",
        "CountryCode": "SE",
        "Currency": "SEK",
        "CustomerNumber": "115",
        "DefaultDeliveryTypes": {
            "Invoice": "PRINT",
            "Offer": "PRINT",
            "Order": "PRINT"
        },
        "DefaultTemplates": {
            "CashInvoice": "DEFAULTTEMPLATE",
            "Invoice": "DEFAULTTEMPLATE",
            "Offer": "DEFAULTTEMPLATE",
            "Order": "DEFAULTTEMPLATE"
        },
        "DeliveryAddress1": null,
        "DeliveryAddress2": null,
        "DeliveryCity": null,
        "DeliveryCountry": null,
        "DeliveryCountryCode": null,
        "DeliveryFax": null,
        "DeliveryName": null,
        "DeliveryPhone1": null,
        "DeliveryPhone2": null,
        "DeliveryZipCode": null,
        "Email": "",
        "EmailInvoice": "",
        "EmailInvoiceBCC": "",
        "EmailInvoiceCC": "",
        "EmailOffer": "",
        "EmailOfferBCC": "",
        "EmailOfferCC": "",
        "EmailOrder": "",
        "EmailOrderBCC": "",
        "EmailOrderCC": "",
        "Fax": null,
        "GLN": null,
        "GLNDelivery": null,
        "InvoiceAdministrationFee": null,
        "InvoiceDiscount": null,
        "InvoiceFreight": null,
        "InvoiceRemark": "",
        "Name": "Klara Norstr\u00f6m",
        "OrganisationNumber": "",
        "OurReference": "",
        "Phone1": null,
        "Phone2": null,
        "PriceList": "A",
        "Project": "",
        "SalesAccount": null,
        "ShowPriceVATIncluded": false,
        "TermsOfDelivery": "",
        "TermsOfPayment": "",
        "Type": "COMPANY",
        "VATNumber": "",
        "VATType": "SEVAT",
        "VisitingAddress": null,
        "VisitingCity": null,
        "VisitingCountry": null,
        "VisitingCountryCode": null,
        "VisitingZipCode": null,
        "WWW": "",
        "WayOfDelivery": "",
        "YourReference": "",
        "ZipCode": "57737"
    }
}

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() {
    // Customer (PUT https://api.fortnox.se/3/customers/115)

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

    try {
        $request->addHeaders([
            'Access-Token'=>'61cf63ae-4ab9-4a95-9db5-753781c4f41f',
            'Client-Secret'=>'3Er4kHXZTJ',
            'Content-Type'=>'application/json',
            'Accept'=>'application/json',
        ]);
        $body = [
            "Customer" => [
                "Address1" => "Hällesjö",
                "City" => "Hultsfred",
                "CountryCode" => "SE",
                "ZipCode" => "57737"
            ]
        ];
        $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

{
    "Customer": {
        "@url": "https://api.fortnox.se/3/customers/115",
        "Address1": "H\u00e4llesj\u00f6",
        "Address2": null,
        "City": "Hultsfred",
        "Comments": null,
        "CostCenter": null,
        "Country": "Sverige",
        "CountryCode": "SE",
        "Currency": "SEK",
        "CustomerNumber": "115",
        "DefaultDeliveryTypes": {
            "Invoice": "PRINT",
            "Offer": "PRINT",
            "Order": "PRINT"
        },
        "DefaultTemplates": {
            "CashInvoice": "DEFAULTTEMPLATE",
            "Invoice": "DEFAULTTEMPLATE",
            "Offer": "DEFAULTTEMPLATE",
            "Order": "DEFAULTTEMPLATE"
        },
        "DeliveryAddress1": null,
        "DeliveryAddress2": null,
        "DeliveryCity": null,
        "DeliveryCountry": null,
        "DeliveryCountryCode": null,
        "DeliveryFax": null,
        "DeliveryName": null,
        "DeliveryPhone1": null,
        "DeliveryPhone2": null,
        "DeliveryZipCode": null,
        "Email": "",
        "EmailInvoice": "",
        "EmailInvoiceBCC": "",
        "EmailInvoiceCC": "",
        "EmailOffer": "",
        "EmailOfferBCC": "",
        "EmailOfferCC": "",
        "EmailOrder": "",
        "EmailOrderBCC": "",
        "EmailOrderCC": "",
        "Fax": null,
        "InvoiceAdministrationFee": null,
        "InvoiceDiscount": null,
        "InvoiceFreight": null,
        "InvoiceRemark": "",
        "Name": "Klara Norstr\u00f6m",
        "OrganisationNumber": "",
        "OurReference": "",
        "Phone1": null,
        "Phone2": null,
        "PriceList": "A",
        "Project": null,
        "SalesAccount": null,
        "ShowPriceVATIncluded": false,
        "TermsOfDelivery": "",
        "TermsOfPayment": "",
        "Type": "COMPANY",
        "VATNumber": "",
        "VATType": "SEVAT",
        "VisitingAddress": null,
        "VisitingCity": null,
        "VisitingCountry": null,
        "VisitingCountryCode": null,
        "VisitingZipCode": null,
        "WWW": "",
        "WayOfDelivery": "",
        "YourReference": "",
        "ZipCode": "57737"
    }
}

Request

require 'net/http'
require 'json'

def send_request
  # Customer (PUT )

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

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

    dict = {
            "Customer" => {
                "Address1" => "Hällesjö",
                "City" => "Hultsfred",
                "CountryCode" => "SE",
                "ZipCode" => "57737"
            }
        }
    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

{
    "Customer": {
        "@url": "https://api.fortnox.se/3/customers/115",
        "Address1": "H\u00e4llesj\u00f6",
        "Address2": null,
        "City": "Hultsfred",
        "Comments": null,
        "CostCenter": null,
        "Country": "Sverige",
        "CountryCode": "SE",
        "Currency": "SEK",
        "CustomerNumber": "115",
        "DefaultDeliveryTypes": {
            "Invoice": "PRINT",
            "Offer": "PRINT",
            "Order": "PRINT"
        },
        "DefaultTemplates": {
            "CashInvoice": "DEFAULTTEMPLATE",
            "Invoice": "DEFAULTTEMPLATE",
            "Offer": "DEFAULTTEMPLATE",
            "Order": "DEFAULTTEMPLATE"
        },
        "DeliveryAddress1": null,
        "DeliveryAddress2": null,
        "DeliveryCity": null,
        "DeliveryCountry": null,
        "DeliveryCountryCode": null,
        "DeliveryFax": null,
        "DeliveryName": null,
        "DeliveryPhone1": null,
        "DeliveryPhone2": null,
        "DeliveryZipCode": null,
        "Email": "",
        "EmailInvoice": "",
        "EmailInvoiceBCC": "",
        "EmailInvoiceCC": "",
        "EmailOffer": "",
        "EmailOfferBCC": "",
        "EmailOfferCC": "",
        "EmailOrder": "",
        "EmailOrderBCC": "",
        "EmailOrderCC": "",
        "Fax": null,
        "InvoiceAdministrationFee": null,
        "InvoiceDiscount": null,
        "InvoiceFreight": null,
        "InvoiceRemark": "",
        "Name": "Klara Norstr\u00f6m",
        "OrganisationNumber": "",
        "OurReference": "",
        "Phone1": null,
        "Phone2": null,
        "PriceList": "A",
        "Project": null,
        "SalesAccount": null,
        "ShowPriceVATIncluded": false,
        "TermsOfDelivery": "",
        "TermsOfPayment": "",
        "Type": "COMPANY",
        "VATNumber": "",
        "VATType": "SEVAT",
        "VisitingAddress": null,
        "VisitingCity": null,
        "VisitingCountry": null,
        "VisitingCountryCode": null,
        "VisitingZipCode": null,
        "WWW": "",
        "WayOfDelivery": "",
        "YourReference": "",
        "ZipCode": "57737"
    }
}

Request

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

import requests
import json

def send_request():
    # Customer (PUT https://api.fortnox.se/3/customers/115)

    try:
        r = requests.put(
            url="https://api.fortnox.se/3/customers/115",
            headers = {
                "Access-Token":"61cf63ae-4ab9-4a95-9db5-753781c4f41f",
                "Client-Secret":"3Er4kHXZTJ",
                "Content-Type":"application/json",
                "Accept":"application/json",
            },
            data = json.dumps({
                "Customer": {
                    "Address1": "Hällesjö",
                    "City": "Hultsfred",
                    "CountryCode": "SE",
                    "ZipCode": "57737"
                }
            })
        )
        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

{
    "Customer": {
        "@url": "https://api.fortnox.se/3/customers/115",
        "Address1": "H\u00e4llesj\u00f6",
        "Address2": null,
        "City": "Hultsfred",
        "Comments": null,
        "CostCenter": null,
        "Country": "Sverige",
        "CountryCode": "SE",
        "Currency": "SEK",
        "CustomerNumber": "115",
        "DefaultDeliveryTypes": {
            "Invoice": "PRINT",
            "Offer": "PRINT",
            "Order": "PRINT"
        },
        "DefaultTemplates": {
            "CashInvoice": "DEFAULTTEMPLATE",
            "Invoice": "DEFAULTTEMPLATE",
            "Offer": "DEFAULTTEMPLATE",
            "Order": "DEFAULTTEMPLATE"
        },
        "DeliveryAddress1": null,
        "DeliveryAddress2": null,
        "DeliveryCity": null,
        "DeliveryCountry": null,
        "DeliveryCountryCode": null,
        "DeliveryFax": null,
        "DeliveryName": null,
        "DeliveryPhone1": null,
        "DeliveryPhone2": null,
        "DeliveryZipCode": null,
        "Email": "",
        "EmailInvoice": "",
        "EmailInvoiceBCC": "",
        "EmailInvoiceCC": "",
        "EmailOffer": "",
        "EmailOfferBCC": "",
        "EmailOfferCC": "",
        "EmailOrder": "",
        "EmailOrderBCC": "",
        "EmailOrderCC": "",
        "Fax": null,
        "InvoiceAdministrationFee": null,
        "InvoiceDiscount": null,
        "InvoiceFreight": null,
        "InvoiceRemark": "",
        "Name": "Klara Norstr\u00f6m",
        "OrganisationNumber": "",
        "OurReference": "",
        "Phone1": null,
        "Phone2": null,
        "PriceList": "A",
        "Project": null,
        "SalesAccount": null,
        "ShowPriceVATIncluded": false,
        "TermsOfDelivery": "",
        "TermsOfPayment": "",
        "Type": "COMPANY",
        "VATNumber": "",
        "VATType": "SEVAT",
        "VisitingAddress": null,
        "VisitingCity": null,
        "VisitingCountry": null,
        "VisitingCountryCode": null,
        "VisitingZipCode": null,
        "WWW": "",
        "WayOfDelivery": "",
        "YourReference": "",
        "ZipCode": "57737"
    }
}

Using our .NET SDK

CustomerConnector connector = new CustomerConnector();
Customer result = connector.Update(new Customer() { 
    CustomerNumber = "115", 
    Address1 = "Hällesjö", 
    City = "Hultsfred", 
    ZipCode = "57737",
    CountryCode = "SE"
});

Delete a customer

Deletes the customer permanently. If everything succeeded the response will be of the type “204 – No content” and the response body will be empty. If there was any problems an error will be returned.

You need to supply the unique customer number of the customer that you want to delete.

Examples

Request

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

Request

Using Guzzle

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

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

function send_request() {
    // Customer (DELETE https://api.fortnox.se/3/customers/115)

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

    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();
        }
    }
}

Request

require 'net/http'

def send_request
  # Customer (DELETE )

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

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

    # Create Request
    req =  Net::HTTP::Delete.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

Request

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

import requests

def send_request():
    # Customer (DELETE https://api.fortnox.se/3/customers/115)

    try:
        r = requests.delete(
            url="https://api.fortnox.se/3/customers/115",
            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')

Using our .NET SDK

CustomerConnector connector = new CustomerConnector();
connector.Delete("115");

Filter

Filter the search on active or inactive customers.

?filter=active displays only active customers
?filter=inactive displays only inactive customers

Example: https://api.fortnox.se/3/customers?filter=active

Properties

Customer

Property	Description
Url	string, read-only Direct URL to the record.
Active	boolean, true/false If the customer is active or not
Address1	string, 1024 characters Address 1 of the customer.
Address2	string, 1024 characters Address 2 of the customer.
City	string, 1024 characters, searchable City of the customer.
Country	string, read-only Country name for the customer.
Comments	string, 1024 characters Comments of the customer.
Currency	string, 3 characters Code of the currency for the customer. This will be used as the predefined currency for documents for the customer. The code must be of an existing currency.
CostCenter	string Code of the cost center for the customer. The code must be of a an existing currency.
CountryCode	string, 2 characters Code of the country for the customer. The code must be of an existing country according to ISO 3166-1 Alpha-2.
CustomerNumber	string, 1024 characters, searchable, sortable Customer number of the customer. If no customer number is provided, the next number in the series will be used. Only alpha numeric characters, with the addition of – + / and _, are allowed.
DefaultDeliveryTypes	object The properties for this object is listed in the table for “Default Delivery Types”.
DefaultTemplates	object The properties for this object is listed in the table for “Default Templates”.
DeliveryAddress1	string, 1024 characters Delivery address 1 for the customer.
DeliveryAddress2	string, 1024 characters DeliveryAddress 2 for the customer.
DeliveryCity	string, 1024 characters Delivery city for the customer.
DeliveryCountry	string, 1024 characters, read-only Delivery country for the customer.
DeliveryCountryCode	string, 2 characters Code of the delivery country for the customer. The code must be of an existing country according to ISO 3166-1 Alpha-2.
DeliveryFax	string, 1024 characters Delivery fax number of the customer.
DeliveryName	string, 1024 characters Delivery name for the customer.
DeliveryPhone1	string, 1024 characters Delivery phone number 1 for the customer.
DeliveryPhone2	string, 1024 characters Delivery phone number 2 for the customer.
DeliveryZipCode	string, 10 characters Delivery zip code for the customer.
Email	string, 1024 characters, searchable Email address for the customer. This must be a valid email address.
EmailInvoice	string, 1024 characters Specific email address used for invoices sent to the customer. This must be a valid email address.
EmailInvoiceBCC	string, 1024 characters Specific blind carbon copy email address used for invoices sent to the customer. This must be a valid email address.
EmailInvoiceCC	string, 1024 characters Specific carbon copy email address used for invoices sent to the customer. This must be a valid email address.
EmailOffer	string, 1024 characters Specific email address used for offers sent to the customer. This must be a valid email address.
EmailOfferBCC	string, 1024 characters Specific blind carbon copy email address used for offers sent to the customer. This must be a valid email address.
EmailOfferCC	string, 1024 characters Specific carbon copy email address used for offers sent to the customer. This must be a valid email address.
EmailOrder	string, 1024 characters Specific email address used for orders sent to the customer. This must be a valid email address.
EmailOrderBCC	string, 1024 characters Specific blind carbon copy email address used for orders sent to the customer. This must be a valid email address.
EmailOrderCC	string, 1024 characters Specific carbon copy email address used for orders sent to the customer. This must be a valid email address.
Fax	string, 1024 characters Fax number for the customer.
GLN	string, 1024 characters, searchable Global Location Number of the customer
GLNDelivery	string, 1024 characters, searchable Global Location Delivery Number
InvoiceAdministrationFee	float, 11 digits Predefined invoice administration fee for the customer.
InvoiceDiscount	float, 11 digits Predefined invoice discount for the customer.
InvoiceFreight	float, 11 digits Predefined invoice freight fee for the customer.
InvoiceRemark	string, 1024 characters Predefined invoice remark for the customer.
Name	string, 1024 characters, searchable, sortable, required Name of the customer.
OrganisationNumber	string, 30 characters, searchable Organisation number of the customer. It needs to be a valid organisation numer.
OurReference	string, 50 characters Our reference of the customer.
Phone1	string, 1024 characters, searchable Phone number 1 of the customer.
Phone2	string, 1024 characters Phone number 2 of the customer.
PriceList	string Code of the price list for the customer. The code must be of a an existing price list.
Project	string Number of the project for the customer. The number must be of a an existing project.
SalesAccount	string, 4 digits Predefined sales account of the customer.
ShowPriceVATIncluded	boolean If prices should be displayed with VAT included.
TermsOfDelivery	string Code of the terms of delivery for the customer. The code must be of a an existing terms of delivery.
TermsOfPayment	string Code of the terms of payment for the customer. The code must be of a an existing terms of payment.
Type	string Type of the customer. Can be PRIVATE or COMPANY.
VATNumber	string VAT number for the customer.
VATType	string VAT type of the customer. Can be SEVAT SEREVERSEDVAT EUREVERSEDVAT EUVAT or EXPORT.
VisitingAddress	string, 128 characters Visiting address of the customer.
VisitingCity	string, 128 characters Visiting city of the customer.
VisitingCountry	string, read-only Visiting country of the customer.
VisitingCountryCode	string, 2 characters Code of the visiting country for the customer. The code must be of an existing country according to ISO 3166-1 Alpha-2.
VisitingZipCode	string, 10 characters Visiting zip code of the customer.
WWW	string, 128 characters Website of the customer.
WayOfDelivery	string Code of the way of delivery for the customer. The code must be of a an existing way of delivery.
YourReference	string, 50 characters Your reference of the customer.
ZipCode	string, 10 characters, searchable Zip code of the customers.

Default Delivery Types

Property	Description
Invoice	string Default delivery type for invoices. Can be PRINT EMAIL or PRINTSERVICE.
Order	string Default delivery type for orders. Can be PRINT EMAIL or PRINTSERVICE.
Offer	string Default delivery type for offers. Can be PRINT EMAIL or PRINTSERVICE.

Default Templates

Property	Description
Order	string Default template for orders. Must be a name of an existing print template.
Offer	string Default template for offers. Must be a name of an existing print template.
Invoice	string Default template for invoices. Must be a name of an existing print template.
CashInvoice	string Default template for cash invoices. Must be a name of an existing print template.

Table of content

List all customers

Examples

Request

Response

Request

Response

Request

Response

Request

Response

Retrieve a customer

Examples

Request

Response

Request

Response

Request

Response

Request

Response

Create a customer

Examples

Request

Response

Request

Response

Request

Response

Request

Response

Update a customer

Examples

Request

Response

Request

Response

Request

Response

Request

Response

Delete a customer

Examples

Request

Request

Request

Request

Filter

Properties

Customer

Default Delivery Types

Default Templates