Create invoice

Create invoice

POST https://api.notify.cm/v2/invoices

Authentication: API keys

Headers

Name	Type	Description
Authorization	string	Your test or live API key

Request Body

Name	Type	Description
Customer	string	Unique Notify customer id
InvoiceNumber	string	Unique invoice number from your administration Max. 100 characters
InvoiceDate	string	European date > 28-01-2021
InvoiceDuedate	string	European date > 28-02-2021
InvoiceTotal	number	Number format: 1100.00
InvoiceBalance	number	Same format. When empty InvoiceTotal will be used.
InvoiceStatus	string	Statuscode: concept open paid or canceled

201

HTTP/1.1 201 Created
Content-Type: application/hal+json

{
        "resource": "invoice",
        "id": "a0f0660d-6c8d-422b-8114-e363b260521e",
        "status":"open",
        "invoiceNumber":"10001",
        "invoiceDate":"28-01-2021",
        "invoiceDuedate":"28-02-2021",
        "invoiceTotal":"500.00",
        "invoiceBalance":"330.00",
        "document":"36cf1c0d-53fe-4c73-8a46-f9f40cd99b65.pdf",
        "customer": {
                "id":"36cf1c0d-53fe-4c73-8a46-f9f40cd99b65",
                "number":"10001",
                "name":"Creditpartners B.V."
        }     
}

400

HTTP/1.1 400 Bad Request
Content-Type: application/json

{
    "status": 400,
    "title": "Bad Request",
    "detail": "Field invoiceDate in wrong format"
}

Example

curl -X POST https://api.notify.cm/v2/invoices \
   -H "Authorization: Bearer test_R7HQ9QpXgx8J32rW9X9UyXjgfNk6C7TQ2UD8M5rwf8vVnYxnSETvSuEC6SKFW8Ug" \
   -d "customer=36cf1c0d-53fe-4c73-8a46-f9f40cd99b65" \
   -d "invoiceNumber=10001" \
   -d "InvoiceDate=28-01-2021" \
   -d "InvoiceDuedate=28-02-2021" \
   -d "InvoiceTotal=500.00" \
   -d "invoiceBalance=330.00" \
   -d "invoiceStatus=open"

Response

HTTP/1.1 200 OK
Content-Type: application/hal+json

{
        "resource": "invoice",
        "id": "a0f0660d-6c8d-422b-8114-e363b260521e",
        "status":"open",
        "invoiceNumber":"10001",
        "invoiceDate":"28-01-2021",
        "invoiceDuedate":"28-02-2021",
        "invoiceTotal":"500.00",
        "invoiceBalance":"330.00",
        "document":"36cf1c0d-53fe-4c73-8a46-f9f40cd99b65.pdf",
        "customer": {
                "id":"36cf1c0d-53fe-4c73-8a46-f9f40cd99b65",
                "number":"10001",
                "name":"Creditpartners B.V."
        }     
}