ExpressExpense API
Introduction
The ExpressExpense API enables web developers to use ExpressExpense applications on their own site.
An Enterprise Account is required to utilize the ExpressExpense API. Contact info@expressexpense.com to request an Enterprise Account and receive an API token.
How it works
The API takes special parameters either as querystring or form parameters. You don’t have to do anything special to get the application to recognize the parameters, we check for them on every request.
Request and Response
Please utilize the following REQUEST and RESPONSE details to utilize our API
REQUEST: GET or form parameters
| Name | Description |
| username | Username for authentication |
| token | Hex token for authentication |
| style | Name of the receipt style (we have 36 styles currently) |
| language | Language code (en, es, zn, pt, fr) |
| business | Name of text business input |
| date | Date of receipt (any format) |
| time | Time of receipt (any format) |
| address | Address |
| location | City, State Zip |
| separator | Currency separator. . = period OR , = comma |
| amount | Payment amount or cost |
| payment-last4 | Payment details – Last 4 digits of credit card used |
| tax-percent | Tax Rate: Percent of Amount as Tax (ie: 7.5 ) |
| tax-type | Type of Tax (1,2,3,4) |
| show-to-go | Display “To-Go” text on receipt |
| show-total-line | Display Total write-in line on receipt |
| show-tip-line | Display Tip write-in line on receipt |
| logo-url | URL of logo for receipt custom logo |
| fuelQty | Number of gallons or liters |
| costPerFuel | Cost per unit (gallon or liter) of fuel |
| font | Name of font (blank will use default font) |
| image-width | Image width in pixels (blank for default) |
| image-height | Image height in pixels (blank for default) |
| quality | JPG quality (1-100) of output image |
| item#Qty | Itemized list Item quantity (valid # is 1 – 8) – ie: item1Qty |
| item#Name | Itemized list Item name (valid # is 1 – 8) – ie: item5Name |
| item#Amount | Itemized list Item amount / cost (valid # is 1 – 8) – ie: item8Amount |
Sample request:
https://expressexpense.com/api/v1/retailerreceipt.php?token=dsai9fsadn29na&date=09-30-2018&time=10:28%20am&business=Extons%20roofing%20ltd&address=72%20Cargill%20Rd,%20London,%20SW18%203DZ&location=london,england&amount=9600&tax-percent=20&text_currency=%C2%A3&tax-type=Tax&payment=visa&separator=1&text-last4=9505&telephone=0208%208879%209966&p_qty%5B%5D=1&p_scnt%5B%5D=9000%20slates&p_price%5B%5D=7650&p_qty%5B%5D=1&blur=0&font=1&paper=1&scratch=0&brightness=100&userid=9544&logo-url=uploads/upfile1538051432.jpg
RESPONSE:
The API returns a URL of image with a unique filename. All images are returned in JPG format.
The complete image URL is formed using the following format:
https://expressexpense.com/api/v1/[username]/uploads/5bacd9844a80c.jpg
SAMPLE Representative Generated Receipt
