Customer Invoice

URL: https://api.finance.visma.net/v1/CustomerInvoice

For information about the ERP logic behind Customer Invoice, please refer to the ERP Manual Help: Sales invoices of type Invoice

Methods

All Customer Invoice

URL: https://api.finance.visma.net/v1/CustomerInvoice

Query Parameters

• lastModifiedDateTime=YYYY-MM-DD

As of today Filtering Parameters does not accept certain characters such as W-Z

These are the formats for Filtering

• 2001-01-01
• 2001-01-01 13:13:13
• 2001-01-01 13:13:13.133

Compare Operators for lastModifiedDateTimeCondition

• > - Greater than
• < - Less than
• <= - Less than or equal to
• >= - Greater than or equal to

Usage Example

This query will return suppliers updated on 2025-01-14 or later:

GET https://api.finance.visma.net/v1/CustomerInvoice?lastModifiedDateTime=2025-01-14&lastModifiedDateTimeCondition=>=

POST Customer Invoice

URL: https://api.finance.visma.net/v1/CustomerInvoice

This example shows the minimum fields you should send to be able to post a new Customer Invoice, if you are using automatic numbering you can omit the “referenceNumber” field.

JSON Request body

{
    "invoiceLines": [
        {
            "operation": "Insert",
            "inventoryNumber": {
                "value": "222"
            },
            "quantity": {
                "value": 500
            },
            "uom": {
                "value": "STK"
            }
        }
    ],
    "referenceNumber": {
        "value": "156589"
    },
    "customerNumber": {
        "value": "10000"
    },
    "documentDate": {
        "value": "2025-01-27"
    },
    "invoiceText": {
        "value": "Payment for potatoes"
    }
}

If sent successfully, the API will return:

PUT CustomerInvoice

URL: https://api.finance.visma.net/v1/CustomerInvoice/{InvoiceNumber}

When using PUT, you only send the fields you want to update. In the below example, we update the first line of the Invoice:

URL: PUT https://api.finance.visma.net/v1/CustomerInvoice/003547

JSON Request body

{
    "invoiceLines": [
        {
            "operation": "Insert",
            "lineNumber": {
                "value": 1
            },
            "inventoryNumber": {
                "value": "6"
            },
            "quantity": {
                "value": 1
            },
            "unitPriceInCurrency": {
                "value": 1
            }
        }
    ]
}

If sent successfully, the API will return: