Quotes

The quotes API main endpoint is https://app.tradetrak.com.au/api/quote/ and the following functions are currently available.

Create quote

  • Endpoint: https://app.tradetrak.com.au/api/quote/<JOB #>/create > E.G. https://app.tradetrak.com.au/api/quote/0/create
  • Request Data: A JSON object containing the following information. Required fields are prefixed with an asterisk (*)

    {
       *"issued_on": "The date the quote is issued on (can be backdated), in format 'yyyy-mm-dd' e.g. 2018-08-30",
       "description": "A description for this quote - string",
       "notes": "Notes about the quote - string",
       *"tax_exclusive": boolean,            
       *"items": [
            {
                "sku": "SKU of a product within Trade Trak - use either this field OR description and cost fields",
                "use_retail": For use with the "sku" field, tells the API whether to use the retail price or cost price of a product. Defaults to true if not passed - boolean,
                "description": "Description for the quote item",
                "cost": Unit cost of the item, this will be rounded to 2 decimal places,
                "units": Quantity of item, this will not be rounded at all,
                "gst": Does this item have GST applied - boolean
            }
        ]
    }
    
  • Request Type: POST

  • Returned Data: Returns quote information for created quote, or an array containing error information if the quote wasn't created successfully. See List quotes for data returned.

List quotes

  • Endpoint: https://app.tradetrak.com.au/api/quote/<Optional JOB #>/list > E.G. https://app.tradetrak.com.au/api/quote/0/list
  • Request Data: None
  • Request Type: GET
  • Returned Data: Returns quote information for all quotes for a job, or all quotes for company if no job specified.

    [{
       "id": "1",
       "quote_number": "QT_0001",
       "issued_on": "2018-08-30",
       "total_amount": 536.24,
       "description": "A description for this quote",
       "notes": "Some notes",
       "tax_exclusive": true,            
       "items": [
            {
                "description": "A part",
                "cost": 149.99,
                "units": 1,
                "sub_total": 149.99,
                "gst": 15.00,
                "total": 164.99,
            },
            {
                "description": "Labour",
                "cost": 75.00,
                "units": 4.5,
                "sub_total": 337.50,
                "gst": 33.75,
                "total": 371.25,
            }
        ],
       "job": Job details (see above),      
    }]