Supplier Invoices

GET

Description

Retrieves a list of invoices or a single invoice.

URL structure

https://api.fortnox.se/3/supplierinvoices/{GivenNumber}

Method

GET

Version

Response

The invoice register can return a list of supplier invoices or a single supplier invoice. By specifying a GivenNumber in the URL, a single supplier invoice will be returned. Not specifying a GivenNumber will return a list of records.

<?xml version="1.0" encoding="UTF-8" ?>
	<MetaInformation>
		<@TotalResources>7</@TotalResources>
		<@TotalPages>1</@TotalPages>
		<@CurrentPage>1</@CurrentPage>
	</MetaInformation>
	<SupplierInvoices>
		<@url>https://api.fortnox.se/3/supplierinvoices/1</@url>
		<Balance>2500</Balance>
		<Booked>false</Booked>
		<Cancel>true</Cancel>
		<CostCenter></CostCenter>
		<Credit>false</Credit>
		<Currency>SEK</Currency>
		<CurrencyRate>1</CurrencyRate>
		<CurrencyUnit>1</CurrencyUnit>
		<DueDate>2014-01-15</DueDate>
		<GivenNumber>1</GivenNumber>
		<InvoiceDate>2014-01-15</InvoiceDate>
		<InvoiceNumber></InvoiceNumber>
		<Project></Project>
		<SupplierNumber>101</SupplierNumber>
		<SupplierName>Test</SupplierName>
		<Total>2500</Total>
		<AuthorizerName>Anders Andersson</AuthorizerName>
                <Vouchers/>
               <FinalPayDate/>
	</SupplierInvoices>

       [...]

	<SupplierInvoices>
		<@url>https://api.fortnox.se/3/supplierinvoices/2</@url>
		<Balance>0</Balance>
		<Booked>false</Booked>
		<Cancel>true</Cancel>
		<CostCenter></CostCenter>
		<Credit>false</Credit>
		<Currency>SEK</Currency>
		<CurrencyRate>1</CurrencyRate>
		<CurrencyUnit>1</CurrencyUnit>
		<DueDate>2014-01-15</DueDate>
		<GivenNumber>2</GivenNumber>
		<InvoiceDate>2014-01-15</InvoiceDate>
		<InvoiceNumber></InvoiceNumber>
		<Project></Project>
		<SupplierNumber>101</SupplierNumber>
		<SupplierName>Test</SupplierName>
		<Total>0</Total>
		<AuthorizerName />
                <Vouchers>
                  <Voucher>
                    <Number>3</Number>
                    <Year>1</Year>
                    <Series>D</Series>
                    <ReferenceType>SUPPLIERINVOICE</ReferenceType>
                  </Voucher>
                  <Voucher>
                   <Number>3</Number>
                   <Year>1</Year>
                   <Series>E</Series>
                   <ReferenceType>SUPPLIERPAYMENT</ReferenceType>
                </Voucher>
                </Vouchers>
                <FinalPayDate>2014-01-10</FinalPayDate>
	</SupplierInvoices>

<?xml version="1.0" encoding="UTF-8"?>
<SupplierInvoice url="https://api.fortnox.se/3/supplierinvoices/1">
    <AdministrationFee>89</AdministrationFee>
    <Balance>2500</Balance>
    <Booked>false</Booked>
    <Cancelled>true</Cancelled>
    <Comments></Comments>
    <CostCenter></CostCenter>
    <Credit>false</Credit>
    <CreditReference></CreditReference>
    <Currency>SEK</Currency>
    <CurrencyRate>1</CurrencyRate>
    <CurrencyUnit>1</CurrencyUnit>
    <DisablePaymentFile>false</DisablePaymentFile>
    <DueDate>2014-01-15</DueDate>
    <ExternalInvoiceNumber></ExternalInvoiceNumber>
    <ExternalInvoiceSeries></ExternalInvoiceSeries>
    <Freight>0</Freight>
    <GivenNumber>1</GivenNumber>
    <InvoiceDate>2014-01-15</InvoiceDate>
    <InvoiceNumber></InvoiceNumber>
    <OCR></OCR>
    <OurReference></OurReference>
    <PaymentPending>true</PaymentPending>
    <Project>0</Project>
    <RoundOffValue>0</RoundOffValue>
    <SalesType>STOCK</SalesType>
    <SupplierInvoiceRows>
        <SupplierInvoiceRow>
            <Account>7817</Account>
            <ArticleNumber></ArticleNumber>
            <Code>TOT</Code>
            <CostCenter></CostCenter>
            <AccountDescription>Avskrivningar på goodwill</AccountDescription>
            <ItemDescription></ItemDescription>
            <Debit>0</Debit>
            <DebitCurrency>0</DebitCurrency>
            <Credit>2500</Credit>
            <CreditCurrency>2500</CreditCurrency>
            <Project>0</Project>
            <Price>-2500</Price>
            <Quantity>1</Quantity>
            <Total>-2500</Total>
            <Unit></Unit>
        </SupplierInvoiceRow>
        <SupplierInvoiceRow>
            <Account>2641</Account>
            <ArticleNumber></ArticleNumber>
            <Code>VAT</Code>
            <CostCenter></CostCenter>
            <AccountDescription>Debiterad ingående moms</AccountDescription>
            <ItemDescription></ItemDescription>
            <Debit>500</Debit>
            <DebitCurrency>500</DebitCurrency>
            <Credit>0</Credit>
            <CreditCurrency>0</CreditCurrency>
            <Project>0</Project>
            <Price>0</Price>
            <Quantity>0</Quantity>
            <Total>500</Total>
            <Unit></Unit>
        </SupplierInvoiceRow>
        <SupplierInvoiceRow>
            <Account>3540</Account>
            <ArticleNumber></ArticleNumber>
            <Code>AFE</Code>
            <CostCenter></CostCenter>
            <AccountDescription>Faktureringsavgifter</AccountDescription>
            <ItemDescription></ItemDescription>
            <Debit>89</Debit>
            <DebitCurrency>89</DebitCurrency>
            <Credit>0</Credit>
            <CreditCurrency>0</CreditCurrency>
            <Project>0</Project>
            <Price>0</Price>
            <Quantity>0</Quantity>
            <Total>89</Total>
            <Unit></Unit>
        </SupplierInvoiceRow>
    </SupplierInvoiceRows>
    <SupplierNumber>101</SupplierNumber>
    <SupplierName>Test</SupplierName>
    <Total>2500</Total>
    <VAT>500</VAT>
    <YourReference></YourReference>
</SupplierInvoice>

{
    "MetaInformation": {
        "@TotalResources": 7,
        "@TotalPages": 1,
        "@CurrentPage": 1
    },
    "SupplierInvoices": [
        {
            "@url": "https://api.fortnox.se/3/supplierinvoices/1",
            "Balance": 2500,
            "Booked": false,
            "Cancel": true,
            "CostCenter": "",
            "Credit": "false",
            "Currency": "SEK",
            "CurrencyRate": "1",
            "CurrencyUnit": 1,
            "DueDate": "2014-01-15",
            "GivenNumber": "1",
            "InvoiceDate": "2014-01-15",
            "InvoiceNumber": "",
            "Project": "",
            "SupplierNumber": "101",
            "SupplierName": "Test",
            "Total": 2500,
            "AuthorizerName": "Anders Andersson"
            "Vouchers": [],
            "FinalPayDate": null
        },

         [...]

        {
            "@url": "https://api.fortnox.se/3/supplierinvoices/2",
            "Balance": 0,
            "Booked": false,
            "Cancel": true,
            "CostCenter": "",
            "Credit": "false",
            "Currency": "SEK",
            "CurrencyRate": "1",
            "CurrencyUnit": 1,
            "DueDate": "2014-01-15",
            "GivenNumber": "2",
            "InvoiceDate": "2014-01-15",
            "InvoiceNumber": "",
            "Project": "",
            "SupplierNumber": "101",
            "SupplierName": "Test",
            "Total": 0,
            "AuthorizerName": null
            "Vouchers": [
                {
                    "Number": 3,
                    "Year": 1,
                    "Series": "D",
                    "ReferenceType": "SUPPLIERINVOICE"
                },
                {
                    "Number": 3,
                    "Year": 1,
                    "Series": "E",
                    "ReferenceType": "SUPPLIERPAYMENT"
                }
            ],
            "FinalPayDate": "2014-01-10"
        },
    ]
}

{
    "SupplierInvoice": {
        "@url": "https://api.fortnox.se/3/supplierinvoices/1",
        "AdministrationFee": "89",
        "Balance": 2500,
        "Booked": false,
        "Cancelled": true,
        "Comments": "",
        "CostCenter": "",
        "Credit": "false",
        "CreditReference": null,
        "Currency": "SEK",
        "CurrencyRate": "1",
        "CurrencyUnit": 1,
        "DisablePaymentFile": false,
        "DueDate": "2014-01-15",
        "ExternalInvoiceNumber": "",
        "ExternalInvoiceSeries": "",
        "Freight": "0",
        "GivenNumber": "1",
        "InvoiceDate": "2014-01-15",
        "InvoiceNumber": "",
        "OCR": "",
        "OurReference": "",
        "PaymentPending": true,
        "Project": "",
        "RoundOffValue": "0",
        "SalesType": "STOCK",
        "SupplierInvoiceRows": [
            {
                "Account": 7817,
                "ArticleNumber": "",
                "Code": "TOT",
                "CostCenter": "",
                "AccountDescription": "Avskrivningar på goodwill",
                "ItemDescription": null,
                "Debit": 0,
                "DebitCurrency": 0,
                "Credit": 2500,
                "CreditCurrency": 2500,
                "Project": "",
                "Price": -2500,
                "Quantity": 1,
                "Total": -2500,
                "Unit": ""
            },
            {
                "Account": 2641,
                "ArticleNumber": "",
                "Code": "VAT",
                "CostCenter": "",
                "AccountDescription": "Debiterad ingående moms",
                "ItemDescription": null,
                "Debit": 500,
                "DebitCurrency": 500,
                "Credit": 0,
                "CreditCurrency": 0,
                "Project": "",
                "Price": 0,
                "Quantity": 0,
                "Total": 500,
                "Unit": ""
            },
            {
                "Account": 3540,
                "ArticleNumber": "",
                "Code": "AFE",
                "CostCenter": "",
                "AccountDescription": "Faktureringsavgifter",
                "ItemDescription": null,
                "Debit": 89,
                "DebitCurrency": 89,
                "Credit": 0,
                "CreditCurrency": 0,
                "Project": "",
                "Price": 0,
                "Quantity": 0,
                "Total": 89,
                "Unit": ""
            }
        ],
        "SupplierNumber": "101",
        "SupplierName": "Test",
        "Total": "2500",
        "VAT": "500",
        "YourReference": ""
    }
}

POST

Description

Creates a supplier invoice.

URL structure

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

Method

POST

Version

Request

The request body should contain a structure of a supplier invoice, either in JSON or XML.

XML
JSON

<SupplierInvoice>
<Currency>SEK</Currency>
<CurrencyRate>1</CurrencyRate>
<CurrencyUnit>1</CurrencyUnit>
<DueDate>2014-08-25</DueDate>
<InvoiceDate>2014-07-25</InvoiceDate>
	<SupplierInvoiceRows>
		<SupplierInvoiceRow>
			<Account>2440</Account>
			<Code>TOT</Code>
			<AccountDescription>Leverantörsskulder</AccountDescription>
			<Debit>0</Debit>
			<Credit>10000</Credit>
			</SupplierInvoiceRow>
		<SupplierInvoiceRow>
			<Account>2641</Account>
			<Code>VAT</Code>
			<AccountDescription>Debiterad ingående moms</AccountDescription>
			<Debit>2000</Debit>
			<Credit>0</Credit>
		</SupplierInvoiceRow>
		<SupplierInvoiceRow>
			<Account>6210</Account>
			<Code></Code>
			<AccountDescription>Telekommunikation</AccountDescription>
			<Debit>8000</Debit>
			<Credit>0</Credit>
		</SupplierInvoiceRow>
	</SupplierInvoiceRows>
<SupplierNumber>1</SupplierNumber>
<Total>10000</Total>
<VAT>2000</VAT>
<VATType>NORMAL</VATType>
<SalesType>STOCK</SalesType>
</SupplierInvoice>

{
  "SupplierInvoice": {
    "Currency": "SEK",
    "CurrencyRate": "1",
    "CurrencyUnit": 1,
    "DueDate": "2014-08-25",
    "InvoiceDate": "2014-07-25",
    "SupplierInvoiceRows": [
      {
        "Account": 2440,
        "Code": "TOT",
        "AccountDescription": "Leverantörsskulder",
        "Debit": 0,
        "Credit": 10000,
        "Total": -10000
      },
      {
        "Account": 2641,
        "Code": "VAT",
        "AccountDescription": "Debiterad ingående moms",
        "Debit": 2000,
        "Credit": 0,
        "Total": 2000
      },
      {
        "Account": 6210,
        "Code": "PRE",
        "AccountDescription": "Telekommunikation",
        "Debit": 8000,
        "Credit": 0,
        "Total": 8000
      }
    ],
    "SupplierNumber": "1",
    "Total": "10000",
    "VAT": "2000",
    "VATType": "NORMAL",
    "SalesType": "STOCK"
  }
}

Response

The response should contain the created supplier invoice in either JSON or XML.

XML
JSON

<?xml version="1.0" encoding="UTF-8"?>
<SupplierInvoice url="https://api.fortnox.se/3/supplierinvoices/14">
    <AdministrationFee>0</AdministrationFee>
    <Balance>10000</Balance>
    <Booked>false</Booked>
    <Cancelled>false</Cancelled>
    <Comments></Comments>
    <CostCenter></CostCenter>
    <Credit>false</Credit>
    <CreditReference></CreditReference>
    <Currency>SEK</Currency>
    <CurrencyRate>1</CurrencyRate>
    <CurrencyUnit>1</CurrencyUnit>
    <DisablePaymentFile>false</DisablePaymentFile>
    <DueDate>2014-08-25</DueDate>
    <ExternalInvoiceNumber></ExternalInvoiceNumber>
    <ExternalInvoiceSeries></ExternalInvoiceSeries>
    <Freight>0</Freight>
    <GivenNumber>15</GivenNumber>
    <InvoiceDate>2014-07-25</InvoiceDate>
    <InvoiceNumber></InvoiceNumber>
    <OCR></OCR>
    <OurReference></OurReference>
    <Project></Project>
    <RoundOffValue>0</RoundOffValue>
    <SupplierInvoiceRows>
        <SupplierInvoiceRow>
            <Account>2440</Account>
            <ArticleNumber></ArticleNumber>
            <Code>TOT</Code>
            <CostCenter></CostCenter>
            <AccountDescription>Leverantörsskulder</AccountDescription>
            <ItemDescription></ItemDescription>
            <Debit>0</Debit>
            <DebitCurrency>0</DebitCurrency>
            <Credit>10000</Credit>
            <CreditCurrency>10000</CreditCurrency>
            <Project></Project>
            <TransactionInformation></TransactionInformation>
            <Price>0</Price>
            <Quantity>0</Quantity>
            <Total>-10000</Total>
            <Unit></Unit>
        </SupplierInvoiceRow>
        <SupplierInvoiceRow>
            <Account>2641</Account>
            <ArticleNumber></ArticleNumber>
            <Code>VAT</Code>
            <CostCenter></CostCenter>
            <AccountDescription>Debiterad ingående moms</AccountDescription>
            <ItemDescription></ItemDescription>
            <Debit>2000</Debit>
            <DebitCurrency>2000</DebitCurrency>
            <Credit>0</Credit>
            <CreditCurrency>0</CreditCurrency>
            <Project></Project>
            <TransactionInformation></TransactionInformation>
            <Price>0</Price>
            <Quantity>0</Quantity>
            <Total>2000</Total>
            <Unit></Unit>
        </SupplierInvoiceRow>
        <SupplierInvoiceRow>
            <Account>6210</Account>
            <ArticleNumber></ArticleNumber>
            <Code></Code>
            <CostCenter></CostCenter>
            <AccountDescription>Telekommunikation</AccountDescription>
            <ItemDescription></ItemDescription>
            <Debit>8000</Debit>
            <DebitCurrency>8000</DebitCurrency>
            <Credit>0</Credit>
            <CreditCurrency>0</CreditCurrency>
            <Project></Project>
            <TransactionInformation></TransactionInformation>
            <Price>0</Price>
            <Quantity>0</Quantity>
            <Total>8000</Total>
            <Unit></Unit>
        </SupplierInvoiceRow>
    </SupplierInvoiceRows>
    <SupplierNumber>1</SupplierNumber>
    <SupplierName>Testleverantör</SupplierName>
    <Total>10000</Total>
    <VAT>2000</VAT>
    <YourReference></YourReference>
    <VoucherNumber></VoucherNumber>
    <VoucherSeries></VoucherSeries>
    <VoucherYear></VoucherYear>
    <VATType>NORMAL</VATType>
    <SalesType>STOCK</SalesType>
</SupplierInvoice>

{
  "SupplierInvoice": {
    "@url": "https://api.fortnox.se/3/supplierinvoices/14",
    "AdministrationFee": 0,
    "Balance": 10000,
    "Booked": false,
    "Cancelled": false,
    "Comments": "",
    "CostCenter": "",
    "Credit": "false",
    "CreditReference": null,
    "Currency": "SEK",
    "CurrencyRate": 1,
    "CurrencyUnit": 1,
    "DisablePaymentFile": false,
    "DueDate": "2014-08-25",
    "ExternalInvoiceNumber": "",
    "ExternalInvoiceSeries": "",
    "Freight": 0,
    "GivenNumber": "14",
    "InvoiceDate": "2014-07-25",
    "InvoiceNumber": "",
    "OCR": "",
    "OurReference": "",
    "Project": null,
    "RoundOffValue": 0,
    "SupplierInvoiceRows": [
      {
        "Account": 2440,
        "ArticleNumber": "",
        "Code": "TOT",
        "CostCenter": "",
        "AccountDescription": "Leverantörsskulder",
        "ItemDescription": "",
        "Debit": 0,
        "DebitCurrency": 0,
        "Credit": 10000,
        "CreditCurrency": 10000,
        "Project": "",
        "TransactionInformation": "",
        "Price": 0,
        "Quantity": 0,
        "Total": -10000,
        "Unit": ""
      },
      {
        "Account": 2641,
        "ArticleNumber": "",
        "Code": "VAT",
        "CostCenter": "",
        "AccountDescription": "Debiterad ingående moms",
        "ItemDescription": "",
        "Debit": 2000,
        "DebitCurrency": 2000,
        "Credit": 0,
        "CreditCurrency": 0,
        "Project": "",
        "TransactionInformation": "",
        "Price": 0,
        "Quantity": 0,
        "Total": 2000,
        "Unit": ""
      },
      {
        "Account": 6210,
        "ArticleNumber": "",
        "Code": "PRE",
        "CostCenter": "",
        "AccountDescription": "Telekommunikation",
        "ItemDescription": "",
        "Debit": 8000,
        "DebitCurrency": 8000,
        "Credit": 0,
        "CreditCurrency": 0,
        "Project": "",
        "TransactionInformation": "",
        "Price": 0,
        "Quantity": 0,
        "Total": 8000,
        "Unit": ""
      }
    ],
    "SupplierNumber": "1",
    "SupplierName": "Testleverantör",
    "Total": 10000,
    "VAT": 2000,
    "YourReference": "",
    "VoucherNumber": null,
    "VoucherSeries": null,
    "VoucherYear": null,
    "VATType": "NORMAL",
    "SalesType": "STOCK"
  }
}

PUT

Description

Updates a supplier invoice.

URL structure

https://api.fortnox.se/3/supplierinvoices/{GivenNumber}

Method

PUT

Version

Request

The request body should contain a structure of a supplier invoice, either in JSON or XML.

XML
JSON

<?xml version="1.0" encoding="UTF-8"?>
   <SupplierInvoice>
      <SupplierInvoiceRows>
         <SupplierInvoiceRow>
            <Quantity>10.00</Quantity>
         </SupplierInvoiceRow>
      </SupplierInvoiceRows>
      <SupplierNumber>101</SupplierNumber>
   </SupplierInvoice>

{
  "SupplierInvoice": {
    "SupplierNumber": "101",
    "SupplierInvoiceRows": [
      {
        "Quantity": "10.00"
      }
    ]
  }
}

Response

The response should contain the updated supplier invoice in either JSON or XML.

XML
JSON

<?xml version="1.0" encoding="UTF-8"?>
<SupplierInvoice url="https://api.fortnox.se/3/supplierinvoices/2">
    <AdministrationFee>0</AdministrationFee>
    <Balance>0</Balance>
    <Booked>false</Booked>
    <Cancelled>true</Cancelled>
    <Comments></Comments>
    <CostCenter></CostCenter>
    <Credit>false</Credit>
    <CreditReference></CreditReference>
    <Currency>SEK</Currency>
    <CurrencyRate>1</CurrencyRate>
    <CurrencyUnit>1</CurrencyUnit>
    <DisablePaymentFile>false</DisablePaymentFile>
    <DueDate>2014-01-15</DueDate>
    <ExternalInvoiceNumber></ExternalInvoiceNumber>
    <ExternalInvoiceSeries></ExternalInvoiceSeries>
    <Freight>0</Freight>
    <GivenNumber>2</GivenNumber>
    <InvoiceDate>2014-01-15</InvoiceDate>
    <InvoiceNumber></InvoiceNumber>
    <OCR></OCR>
    <OurReference></OurReference>
    <Project>0</Project>
    <RoundOffValue>0</RoundOffValue>
    <SalesType>STOCK</SalesType>
    <SupplierInvoiceRows>
        <SupplierInvoiceRow>
            <Account>2440</Account>
            <ArticleNumber></ArticleNumber>
            <Code>TOT</Code>
            <CostCenter></CostCenter>
            <AccountDescription>Leverantörsskulder</AccountDescription>
            <ItemDescription></ItemDescription>
            <Debit>0</Debit>
            <DebitCurrency>0</DebitCurrency>
            <Credit>0</Credit>
            <CreditCurrency>0</CreditCurrency>
            <Project></Project>
            <Price>0</Price>
            <Quantity>0</Quantity>
            <Total>0</Total>
            <Unit></Unit>
        </SupplierInvoiceRow>
    </SupplierInvoiceRows>
    <SupplierNumber>101</SupplierNumber>
    <SupplierName>Test</SupplierName>
    <Total>0</Total>
    <VAT>0</VAT>
    <YourReference></YourReference>
</SupplierInvoice>

{
    "SupplierInvoice": {
        "@url": "https://api.fortnox.se/3/supplierinvoices/2",
        "AdministrationFee": "0",
        "Balance": 0,
        "Booked": false,
        "Cancelled": true,
        "Comments": "",
        "CostCenter": "",
        "Credit": "false",
        "CreditReference": null,
        "Currency": "SEK",
        "CurrencyRate": "1",
        "CurrencyUnit": 1,
        "DisablePaymentFile": false,
        "DueDate": "2014-01-15",
        "ExternalInvoiceNumber": "",
        "ExternalInvoiceSeries": "",
        "Freight": "0",
        "GivenNumber": "2",
        "InvoiceDate": "2014-01-15",
        "InvoiceNumber": "",
        "OCR": "",
        "OurReference": "",
        "Project": "",
        "RoundOffValue": "0",
        "SalesType": "STOCK",
        "SupplierInvoiceRows": [
            {
                "Account": 2440,
                "ArticleNumber": "",
                "Code": "TOT",
                "CostCenter": "",
                "AccountDescription": "Leverantörsskulder",
                "ItemDescription": "",
                "Debit": 0,
                "DebitCurrency": 0,
                "Credit": 0,
                "CreditCurrency": 0,
                "Project": "",
                "Price": 0,
                "Quantity": 0,
                "Total": 0,
                "Unit": ""
            }
        ],
        "SupplierNumber": "101",
        "SupplierName": "Test",
        "Total": "0",
        "VAT": "0",
        "YourReference": ""
    }
}

Actions

Action name	Description
bookkeep	Bookkeeps the supplier invoice
cancel	Cancels the supplier invoice
credit	Creates a credit of the supplier invoice
approvalpayment	Approval of payment of the supplier invoice
approvalbookkeep	Approval of bookkeep of the supplier invoice

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
pendingpayment	Retrieves all invoices that has PaymentPending=true and is booked.
authorizepending	Retrieves all invoices that has a waiting authorization pending.

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

Fields