Receipts

You can list your available receipts with the following URL:

                GET https://api.smallinvoice.com/receipt/list/
            

URL Parameters

NameTypeRequiredDefaultOptionsNotes
limitintno0Limit the amount of results
pageintno1When limiting the results, specifies page
sortstringnodatedate
due
number
Sorts the list by the available values
sorttypestringnodescasc
desc
Defines the way of sorting


Example: Making a request with 100 Results, getting second page, and sorting by date ascending

        GET https://api.smallinvoice.com/receipt/list/limit/100/page/2/sort/date/sorttype/asc/
    

Response

NameTypeNotes
errorbooleanIs true if an error occured
errorcodeintCode of the error. Only returned if error is true.
errormessagestringInformational message about the error. Only returned if error is true.
pageintCurrent page that was passed in on the request
pagesintTotal number of pages available
countintTotal number of objects available
itemscollectionCollection of receipt Objects

Example content of data variable:

    {
        "error":false,
        "page":1,
        "pages":1,
        "count":1,
        "items":[
            {
                "id":3,
                "number":10000,
                "client_id":16,
                "client_name":"John Doe",
                "client_address_id":11,
                "client_contact_id":0,
                "currency":"CHF",
                "title":"Lieferschein Nr. {10} \/ Kunden Nr. {2}",
                "date":"2013-02-25",
                "conditions":"",
                "introduction":"",
                "language":"de",
                "vat_included":0,
                "totalamount":0,
                "status":7,
                "pages":1,
                "positions":[
                    {
                        "type":1,
                        "number":null,
                        "name":"Position X",
                        "description":"Repairing car",
                        "cost":0,
                        "unit":1,
                        "amount":1,
                        "vat":8,
                        "discount":null
                    },
                    {
                        "type":2,
                        "number":null,
                        "name":"Position Y",
                        "description":"Cleaning house",
                        "cost":0,
                        "unit":7,
                        "amount":1,
                        "vat":8,
                        "discount":null
                    }
                ]
            }
        ]
    }
    

You can get your receipt with the following URL:

                GET https://api.smallinvoice.com/receipt/get/
            

URL Parameters

NameTypeRequiredDefaultOptionsNotes
idintyesThe Id of the receipt


Example: Making a request for receipt with id 5

                GET https://api.smallinvoice.com/receipt/get/id/5
            

Response

NameTypeNotes
errorbooleanIs true if an error occured
errorcodeintCode of the error. Only returned if error is true.
errormessagestringInformational message about the error. Only returned if error is true.
itemobjectObject of receipt

Example content of data variable:

    {
        "error":false,
        "item":{
            "id":3,
            "number":10000,
            "client_id":16,
            "client_name":"John Doe",
            "client_address_id":11,
            "client_contact_id":0,
            "currency":"CHF",
            "title":"Lieferschein Nr. {LIEFERSCHEINNR} \/ Kunden Nr. {KUNDENNR}",
            "date":"2013-02-25",
            "conditions":"",
            "introduction":"",
            "language":"de",
            "vat_included":0,
            "totalamount":0,
            "status":7,
            "pages":1,
            "positions":[
                {
                    "type":1,
                    "number":null,
                    "name":"Position X",
                    "description":"Repairing car",
                    "cost":0,
                    "unit":1,
                    "amount":1,
                    "vat":8,
                    "discount":null
                },
                {
                    "type":2,
                    "number":null,
                    "name":"Position Y",
                    "description":"Cleaning house",
                    "cost":0,
                    "unit":7,
                    "amount":1,
                    "vat":8,
                    "discount":null
                }
            ]
        }
    }
    

You can get your receipt as pdf with the following URL:

                GET https://api.smallinvoice.com/receipt/pdf/
            

URL Parameters

NameTypeRequiredDefaultOptionsNotes
idintyesThe Id of the receipt


Example: Making a request for receipt with id 5

                GET https://api.smallinvoice.com/receipt/pdf/id/5
            

Response

NameTypeNotes
HTTP Bodyapplication/pdfThe PDF in raw format

You can get a receipt preview in PNG form for each page of a document with the following URL:

                GET https://api.smallinvoice.com/receipt/preview/
            

URL Parameters

NameTypeRequiredDefaultOptionsNotes
idintyesThe Id of the receipt
pageintno1The page you want to retreive
sizeintno595240
595
600
972
1240
The size in pixels


Example: Getting second page in size 1240 for receipt with id 5

                GET https://api.smallinvoice.com/receipt/preview/id/5/page/2/size/1240
            

Response

NameTypeNotes
HTTP Bodyimage/pngThe image in raw format

You can add a new receipt with the following URL:

                POST https://api.smallinvoice.com/receipt/add
            

Body parameters

NameTypeRequiredDefaultNotes
numberstringnonext higher numberYour receipt number
client_idintyesClient's id
client_address_idintyesClient's address id
client_contact_idintno0Client's contact id
currencystringyesThree-letter currency code
titlestringnoTitle of the receipt
datedateyesDate of receipt
introductionstringnoIntroduction text printed above positions
conditionsstringnoText printed below positions
languagestringyesTwo-letter language code
vat_includedintno0If VAT is included in positions' prices
positionscollectionyesCollection of Position Objects


Example: Creating a new receipt

                POST https://api.smallinvoice.com/receipt/add/
            

Example content of data variable:
{
    "number":10000,
    "client_id":16,
    "client_name":"John Doe",
    "client_address_id":11,
    "client_contact_id":0,
    "currency":"CHF",
    "title":"Lieferschein Nr. {LIEFERSCHEINNR} \/ Kunden Nr. {KUNDENNR}",
    "date":"2013-02-25",
    "conditions":"",
    "introduction":"",
    "language":"de",
    "vat_included":0,
	"positions":[
	{
		"type":2,
		"number":null,
		"name":"Product X",
		"description":"Repairing car",
		"cost":0,
		"unit":1,
		"amount":1,
		"vat":8,
		"discount":null
	},
	{
		"type":1,
		"number":null,
		"name":"Service Y",
		"description":"Cleaning house",
		"cost":0,
		"unit":7,
		"amount":1,
		"vat":8,
		"discount":null
	}
	]
}

Response

NameTypeNotes
errorbooleanIs true if an error occured
errorcodeintCode of the error. Only returned if error is true.
errormessagestringInformational message about the error. Only returned if error is true.
idintThe Id of the receipt Object that was created

Example response:

    {
        "error":false,
        "id": 43
    }
    

You can edit an receipt with the following URL:

                POST https://api.smallinvoice.com/receipt/edit
            

URL Parameters

NameTypeRequiredDefaultOptionsNotes
idintyesThe Id of the receipt

Body parameters

NameTypeNotes
numberstringYour receipt number
client_idintClient's id
client_address_idintClient's address id
client_contact_idintClient's contact id
currencystringThree-letter currency code
titlestringTitle of the receipt
datedateDate of receipt
introductionstringIntroduction text printed above positions
conditionsstringText printed below positions
languagestringTwo-letter language code
vat_includedintIf VAT is included in positions' prices
positionscollectionCollection of Position Objects


Example: Editing an receipt with id 5

                POST https://api.smallinvoice.com/receipt/edit/id/5
            

Example content of data variable:
{
    "number":10000,
    "client_id":16,
    "client_name":"John Doe",
    "client_address_id":11,
    "client_contact_id":0,
    "currency":"CHF",
    "title":"Lieferschein Nr. {LIEFERSCHEINNR} \/ Kunden Nr. {KUNDENNR}",
    "date":"2013-02-25",
    "conditions":"",
    "introduction":"",
    "language":"de",
    "vat_included":0,
}

Response

NameTypeNotes
errorbooleanIs true if an error occured
errorcodeintCode of the error. Only returned if error is true.
errormessagestringInformational message about the error. Only returned if error is true.

Example response:

    {
        "error":false
    }
    

You can delete an receipt with the following URL:

                POST https://api.smallinvoice.com/receipt/delete/
            

URL Parameters

NameTypeRequiredDefaultOptionsNotes
idintyesThe Id of the receipt


Example: Making a request for deleting receipt with id 5

                POST https://api.smallinvoice.com/receipt/delete/id/5
            

Response

NameTypeNotes
errorbooleanIs true if an error occured
errorcodeintCode of the error. Only returned if error is true.
errormessagestringInformational message about the error. Only returned if error is true.

Example response:

    {
        "error":false
    }
    

You can email your receipt with the following URL:

                POST https://api.smallinvoice.com/receipt/email
            

URL Parameters

NameTypeRequiredDefaultOptionsNotes
idintyesThe Id of the receipt

Body parameters

NameTypeRequiredDefaultNotes
subjectstringYesSubject of email
bodystringYesContent of the email
afterstatusintNoThe status the document should take after sending
recipientscollectionYesList of recipients. See example


Example: Sending an receipt with id 5 via email

                POST https://api.smallinvoice.com/receipt/email/id/5
            

Example content of data variable
{
  "subject" : "Email subject",
  "body" : "Email body",
  "afterstatus" : 1,
  "recipients" : [
      {
        "cc" : false,
        "email" : "email@domain.com",
        "name" : "Client Name"
      }
    ]
}
     

Response

NameTypeNotes
errorbooleanIs true if an error occured
errorcodeintCode of the error. Only returned if error is true.
errormessagestringInformational message about the error. Only returned if error is true.

Example response:

    {
        "error":false
    }
    

You can send your receipt via postmail with the following URL:

                POST https://api.smallinvoice.com/receipt/post
            

URL Parameters

NameTypeRequiredDefaultOptionsNotes
idintyesThe Id of the receipt

Body parameters

NameTypeRequiredDefaultNotes
speedintYes1 = Priority / 2 = Economy
colorintNo00 = B/W / 1 = Color
sendstatusintNoThe status the document should be sent in
afterstatusintNoThe status the document should take after sending


Example: Sending an receipt with id 5 via postmail

                POST https://api.smallinvoice.com/receipt/post/id/5
            

Example content of data variable
{
  "afterstatus" : 1,
  "sendstatus" : 1,
  "speed" : 1
}
     

Response

NameTypeNotes
errorbooleanIs true if an error occured
errorcodeintCode of the error. Only returned if error is true.
errormessagestringInformational message about the error. Only returned if error is true.

Example response:

    {
        "error":false
    }
    

You can change status of your receipt with the following URL:

                POST https://api.smallinvoice.com/receipt/status/
            

URL Parameters

NameTypeRequiredDefaultOptionsNotes
idintyesThe Id of the receipt

Body parameters

NameTypeRequiredDefaultNotes
statusintYesSee Status Types


Example: Making a request for receipt with id 5

                POST https://api.smallinvoice.com/receipt/status/id/5
            

Example content of data variable
{
  "status" : 1
}
     

Response

NameTypeNotes
errorbooleanIs true if an error occured
errorcodeintCode of the error. Only returned if error is true.
errormessagestringInformational message about the error. Only returned if error is true.

Example response:

    {
        "error":false
    }