sage_one 0.0.1

data/lib/sage_one/configuration.rb

@@ -0,0 +1,81 @@
+require 'faraday'
+require 'sage_one/version'
+
+module SageOne
+  # Provide numerous configuration options that control core behaviour.
+  module Configuration
+    VALID_OPTIONS_KEYS = [
+      :adapter,
+      :faraday_config_block,
+      :api_endpoint,
+      :proxy,
+      :access_token,
+      :client_id,
+      :client_secret,
+      :user_agent,
+      :request_host,
+      :auto_traversal,
+      :raw_response].freeze
+
+    DEFAULT_ADAPTER        = Faraday.default_adapter
+    DEFAULT_API_ENDPOINT   = 'https://app.sageone.com/api/v1/'.freeze
+    DEFAULT_USER_AGENT     = "SageOne Ruby Gem #{SageOne::VERSION}".freeze
+
+    # Only get the first page when making paginated data requests
+    DEFAULT_AUTO_TRAVERSAL = false
+
+    # Parse Json, Mashify & convert SData when making requests
+    DEFAULT_RAW_RESPONSE   = false
+
+    attr_accessor(*VALID_OPTIONS_KEYS)
+
+    # Override the default API endpoint, this ensures a trailing forward slash is added.
+    # @param [String] value for a different API endpoint
+    # @example
+    #   SageOne.api_end_point = 'https://app.sageone.com/api/v2/'
+    def api_endpoint=(value)
+      @api_endpoint = File.join(value, "")
+    end
+
+    # Stores the given block which is called when the new Faraday::Connection
+    # is set up for all requests. This allow you to configure the connection,
+    # for example with your own middleware.
+    def faraday_config(&block)
+      @faraday_config_block = block
+    end
+
+    # Yields the given block passing in selfing allow you to set config options
+    # on the 'extend'-ing module.
+    # @example
+    #   SageOne.configure do |config|
+    #     config.access_token = 'my-access-token'
+    #   end
+    def configure
+      yield self
+    end
+
+    # @return [Hash] All options with their current values
+    def options
+      VALID_OPTIONS_KEYS.inject({}){|o,k| o.merge!(k => send(k)) }
+    end
+
+    # When extended call reset
+    def self.extended(base)
+      base.reset
+    end
+
+    # Sets the options to the default values
+    def reset
+      self.adapter        = DEFAULT_ADAPTER
+      self.api_endpoint   = DEFAULT_API_ENDPOINT
+      self.proxy          = nil
+      self.access_token   = nil
+      self.client_id      = nil
+      self.client_secret  = nil
+      self.request_host   = nil
+      self.user_agent     = DEFAULT_USER_AGENT
+      self.auto_traversal = DEFAULT_AUTO_TRAVERSAL
+      self.raw_response   = DEFAULT_RAW_RESPONSE
+    end
+  end
+end

data/lib/sage_one/connection.rb

@@ -0,0 +1,44 @@
+require 'faraday_middleware'
+require 'faraday/request/oauth2'
+require 'faraday/response/raise_sage_one_exception'
+require 'faraday/response/convert_sdata_to_headers'
+
+module SageOne
+  # @api private
+  # @note Used by request.rb to make Faraday requests to the SageOne API.
+  module Connection
+    private
+
+    # @return [Faraday::Connection] configured with the headers SageOne expects
+    #   and our required middleware stack. raw_response can be set to true to
+    #   help with debugging.
+    def connection
+      options = {
+        headers:  { 'Accept'        => "application/json; charset=utf-8",
+                    'User-Agent'    => user_agent,
+                    'Content-Type'  => 'application/json' },
+        proxy:    proxy,
+        ssl:      { verify: false },
+        url:      api_endpoint
+      }
+
+      Faraday.new(options) do |conn|
+        conn.request :json
+
+        conn.use FaradayMiddleware::OAuth2, access_token
+        conn.use FaradayMiddleware::RaiseSageOneException
+
+        unless raw_response
+          conn.use FaradayMiddleware::Mashify
+          conn.use FaradayMiddleware::ConvertSdataToHeaders
+          conn.use FaradayMiddleware::ParseJson
+        end
+
+        faraday_config_block.call(conn) if faraday_config_block
+
+        conn.adapter(adapter)
+      end
+    end
+  end
+
+end

data/lib/sage_one/error.rb

@@ -0,0 +1,39 @@
+module SageOne
+
+  # Custom error class for rescuing from all SageOne errors
+  class Error < StandardError; end
+
+  # Raised when SageOne returns a 400 HTTP status code
+  class BadRequest < Error; end
+
+  # Raised when SageOne returns a 401 HTTP status code
+  class Unauthorized < Error; end
+
+  # Raised when SageOne returns a 403 HTTP status code
+  class Forbidden < Error; end
+
+  # Raised when SageOne returns a 404 HTTP status code
+  class NotFound < Error; end
+
+  # Raised when SageOne returns a 406 HTTP status code
+  class NotAcceptable < Error; end
+
+  # Raised when SageOne returns a 409 HTTP status code
+  class Conflict < Error; end
+
+  # Raised when SageOne returns a 422 HTTP status code
+  class UnprocessableEntity < Error; end
+
+  # Raised when SageOne returns a 500 HTTP status code
+  class InternalServerError < Error; end
+
+  # Raised when SageOne returns a 501 HTTP status code
+  class NotImplemented < Error; end
+
+  # Raised when SageOne returns a 502 HTTP status code
+  class BadGateway < Error; end
+
+  # Raised when SageOne returns a 503 HTTP status code
+  class ServiceUnavailable < Error; end
+
+end

data/lib/sage_one/oauth.rb

@@ -0,0 +1,49 @@
+require 'sage_one/connection'
+require 'sage_one/request'
+
+module SageOne
+
+  # This module helps with setting up the OAuth connection to SageOne. After the two
+  # step process you will have an access_token that you can store and use
+  # for making future API calls.
+  #
+  # @see OAuth#authorize_url Step 1 - Authorisation request
+  # @see #get_access_token Step 2 - Access Token Request
+  module OAuth
+
+    # Generates the OAuth URL for redirecting users to SageOne. You should ensure
+    # the your SageOne.client_id is configured before calling this method.
+    #
+    # @param [String] callback_url SageOne OAuth will pass an authorization code back to this URL.
+    # @return [String] The URL for you to redirect the user to SageOne.
+    # @example
+    #   SageOne.authorize_url('https://example.com/auth/sageone/callback')
+    def authorize_url(callback_url)
+      params = {
+        client_id:      client_id,
+        redirect_uri:   callback_url,
+        response_type: 'code'
+      }
+      connection.build_url("/oauth/authorize/", params).to_s
+    end
+
+    # Returns an access token for future authentication.
+    #
+    # @param [String] code The authorisation code SageOne sent to your callback_url.
+    # @param [String] callback_url The callback URL you used to get the authorization code.
+    # @return [Hashie::Mash] Containing the access_token for you to store for making future API calls.
+    # @example
+    #   # Assuming (Rails) your code is stored in params hash.
+    #   SageOne.get_access_token(params[:code], 'https://example.com/auth/sageone/callback')
+    def get_access_token(code, callback_url)
+      params = {
+        client_id:      client_id,
+        client_secret:  client_secret,
+        grant_type:     'authorization_code',
+        code:           code,
+        redirect_uri:   callback_url
+      }
+      post("/oauth/token/", params)
+    end
+  end
+end

data/lib/sage_one/request.rb

@@ -0,0 +1,72 @@
+require 'multi_json'
+
+module SageOne
+  # This helper methods in this module are used by the public api methods.
+  # They use the Faraday::Connection defined in connection.rb for making
+  # requests. Setting 'SageOne.raw_response' to true can help with debugging.
+  # @api private
+  module Request
+    def delete(path, options={})
+      request(:delete, path, options)
+    end
+
+    def get(path, options={})
+      request(:get, path, options)
+    end
+
+    def post(path, options={})
+      request(:post, path, options)
+    end
+
+    def put(path, options={})
+      request(:put, path, options)
+    end
+
+    private
+
+    def request(method, path, options)
+      options = format_datelike_objects!(options) unless options.empty?
+      response = connection.send(method) do |request|
+        case method
+        when :delete, :get
+          options.merge!('$startIndex' => options.delete(:start_index)) if options[:start_index]
+          request.url(path, options)
+        when :post, :put
+          request.path = path
+          request.body = MultiJson.dump(options) unless options.empty?
+        end
+        request.headers['Host'] = request_host if request_host
+      end
+
+      if raw_response
+        response
+      elsif auto_traversal && ( next_url = links(response)["next"] )
+        response.body + request(method, next_url, options)
+      else
+        response.body
+      end
+    end
+
+    def links(response)
+      links = ( response.headers["X-SData-Pagination-Links"] || "" ).split(', ').map do |link|
+        url, type = link.match(/<(.*?)>; rel="(\w+)"/).captures
+        [ type, url ]
+      end
+
+      Hash[ *links.flatten ]
+    end
+
+    def format_datelike_objects!(options)
+      new_opts = {}
+      options.map do |k,v|
+        if v.respond_to?(:map)
+          new_opts[k] = format_datelike_objects!(v)
+        else
+          new_opts[k] = v.respond_to?(:strftime) ? v.strftime("%d/%m/%Y") : v
+        end
+      end
+      new_opts
+    end
+
+  end
+end

data/lib/sage_one/version.rb

@@ -0,0 +1,3 @@
+module SageOne
+  VERSION = "0.0.1"
+end

data/lib/sage_one.rb

@@ -0,0 +1,31 @@
+$:.unshift File.dirname(__FILE__)
+
+require 'sage_one/configuration'
+require 'sage_one/client'
+require 'sage_one/error'
+
+
+module SageOne
+  extend Configuration
+  class << self
+    # Alias for SageOne::Client.new
+    #
+    # @return [SageOne::Client]
+    def new(options={})
+      SageOne::Client.new(options)
+    end
+
+    # True if the method can be delegated to the SageOne::Client
+    #
+    # @return [Boolean]
+    def respond_to?(method, include_private=false)
+      new.respond_to?(method, include_private) || super(method, include_private)
+    end
+
+    # Delegate to SageOne::Client.new
+    def method_missing(method, *args, &block)
+      return super unless new.respond_to?(method)
+      new.send(method, *args, &block)
+    end
+  end
+end

data/sage_one.gemspec

@@ -0,0 +1,32 @@
+# encoding: utf-8
+require File.expand_path('../lib/sage_one/version', __FILE__)
+
+Gem::Specification.new do |s|
+  s.add_dependency 'addressable', '~>2.3'
+  s.add_dependency 'faraday', '~>0.8'
+  s.add_dependency 'faraday_middleware', '~> 0.9'
+  s.add_dependency 'hashie', '~>1.2'
+  s.add_dependency 'multi_json', '~> 1.4'
+
+  s.add_development_dependency 'json'
+  s.add_development_dependency 'rake'
+  s.add_development_dependency 'rspec'
+  s.add_development_dependency 'simplecov'
+  s.add_development_dependency 'webmock'
+  s.add_development_dependency 'yard'
+
+  s.authors = ['Luke Brown', 'Chris Stainthorpe']
+  s.email = ['tsdbrown@gmail.com', 'chris@randomcat.co.uk']
+  s.name = 'sage_one'
+  s.platform = Gem::Platform::RUBY
+  s.homepage = 'https://github.com/customersure/sage_one'
+  s.summary = %q{Ruby wrapper for the Sage One V1 API.}
+  s.description = s.summary
+  s.rubyforge_project = s.name
+  s.files = `git ls-files`.split("\n")
+  s.test_files = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ['lib']
+  s.required_rubygems_version = Gem::Requirement.new('>= 1.3.6')
+  s.version = SageOne::VERSION
+end

data/spec/faraday/request/oauth2_spec.rb

@@ -0,0 +1,44 @@
+require 'spec_helper'
+
+describe FaradayMiddleware::OAuth2 do
+
+  let(:client) { SageOne.new }
+
+  before { stub_get('sales_invoices') }
+
+  context 'when the access_token is nil' do
+    it 'does not add an Authorization header' do
+      client.send(:connection).get do |request|
+        request.url 'sales_invoices'
+        expect(request.headers.keys).not_to include("Authorization")
+      end
+      a_get("sales_invoices").should have_been_made.once
+      a_get("sales_invoices").with(:headers => { "Authorization" => "Bearer #{nil}"}).should_not have_been_made
+    end
+  end
+
+  context 'when the access_token is set' do
+    let(:access_token) { 'wHeHaMwscCIEOLGQ9uIi' }
+    before { client.access_token = access_token }
+
+    it 'adds an Authorization header with the Bearer token' do
+      client.send(:connection).get('sales_invoices')
+      a_get("sales_invoices").with(:headers => { 'Authorization' => "Bearer #{access_token}" }).should have_been_made.once
+    end
+  end
+
+  context 'when the Authorization header has already been set' do
+    let(:access_token) { 'wHeHaMwscCIEOLGQ9uIi' }
+    let(:pre_set_access_token) { 'SuperBearer my_pre_set_token' }
+    before { client.access_token = access_token }
+
+    it 'leaves the set Authorization header alone' do
+      client.send(:connection).get do |request|
+        request.url 'sales_invoices'
+        request.headers['Authorization'] = pre_set_access_token
+      end
+      a_get("sales_invoices").with(:headers => { 'Authorization' => pre_set_access_token }).should have_been_made.once
+    end
+  end
+
+end

data/spec/faraday/response/convert_sdata_to_headers_spec.rb

@@ -0,0 +1,113 @@
+require 'spec_helper'
+
+describe FaradayMiddleware::ConvertSdataToHeaders do
+
+  def connection(include_mashify=true)
+    Faraday.new(url: sage_url(nil)) do |conn|
+      conn.request :json
+      conn.use FaradayMiddleware::Mashify if include_mashify
+      conn.use FaradayMiddleware::ConvertSdataToHeaders
+      conn.use FaradayMiddleware::ParseJson
+      conn.adapter  Faraday.default_adapter
+    end
+  end
+
+  context "when on the first page"do
+    it "does not add a prev link" do
+      stub_get('sales_invoices').to_return(body: sdata_fixture('sales_invoices.json', 20, 0, 20))
+      response = connection.get('sales_invoices')
+      expect(response.headers).to be_empty
+    end
+    context "and there are more results than items_per_page" do
+      it "adds a next link" do
+        stub_get('sales_invoices').to_return(body: sdata_fixture('sales_invoices.json', 40, 0, 20))
+        response = connection.get('sales_invoices')
+        expect(response.headers['X-Sdata-Pagination-Links']).to_not be_nil
+        expect(response.headers['X-Sdata-Pagination-Links']).to include(%Q{<#{sage_url('sales_invoices?%24startIndex=20')}>; rel="next"})
+      end
+    end
+  end
+
+  context "when on the last page" do
+    before { stub_get('sales_invoices').to_return(body: sdata_fixture('sales_invoices.json', 40, 20, 20)) }
+    it "does not add a next link" do
+      response = connection.get('sales_invoices')
+      expect(response.headers).to_not include('rel="next"')
+    end
+    it "adds a prev link" do
+      response = connection.get('sales_invoices')
+      expect(response.headers['X-Sdata-Pagination-Links']).to_not be_nil
+      expect(response.headers['X-Sdata-Pagination-Links']).to include(%Q{<#{sage_url('sales_invoices?%24startIndex=0')}>; rel="prev"})
+    end
+    context "when requesting a value in the middle of the last page" do
+      before { stub_get('sales_invoices').to_return(body: sdata_fixture('sales_invoices.json', 40, 30, 20)) }
+      it "does not add a next link" do
+        response = connection.get('sales_invoices')
+        expect(response.headers).to_not include('rel="next"')
+      end
+      it "adds a prev link" do
+        response = connection.get('sales_invoices')
+        expect(response.headers['X-Sdata-Pagination-Links']).to_not be_nil
+        expect(response.headers['X-Sdata-Pagination-Links']).to include(%Q{<#{sage_url('sales_invoices?%24startIndex=10')}>; rel="prev"})
+      end
+    end
+  end
+
+  context "when there are fewer results than items_per_page" do
+    before { stub_get('sales_invoices').to_return(body: sdata_fixture('sales_invoices.json', 5, 0, 20)) }
+    it "adds no links" do
+      response = connection.get('sales_invoices')
+      expect(response.headers['X-Sdata-Pagination-Links']).to be_nil
+    end
+  end
+
+  context "when on a middle page" do
+    before { stub_get('sales_invoices').to_return(body: sdata_fixture('sales_invoices.json', 20, 10, 5)) }
+    it "adds a prev link" do
+      response = connection.get('sales_invoices')
+      expect(response.headers['X-Sdata-Pagination-Links']).to include(%Q{<#{sage_url('sales_invoices?%24startIndex=5')}>; rel="prev"})
+    end
+    it "adds a next link" do
+      response = connection.get('sales_invoices')
+      expect(response.headers['X-Sdata-Pagination-Links']).to include(%Q{<#{sage_url('sales_invoices?%24startIndex=15')}>; rel="next"})
+    end
+  end
+
+  it "places the resources in the body of the response" do
+    stub_get('sales_invoices').to_return(body: sdata_fixture('sales_invoices.json', 20, 10, 5))
+    response = connection(false).get('sales_invoices')
+    response.body.to_s.should eq(JSON.parse(sdata_fixture('sales_invoices.json', 20,10,5))['$resources'].to_s)
+  end
+
+  context "when there are existing query parameters" do
+    before { stub_get('sales_invoices?search=salad&from_date=2012-11-11').to_return(body: sdata_fixture('sales_invoices.json', 20, 10, 5)) }
+    it "it passes them through without modification" do
+      response = connection.get('sales_invoices?from_date=2012-11-11&search=salad')
+      expect(response.headers['X-Sdata-Pagination-Links']).to eq('<https://app.sageone.com/api/v1/sales_invoices?%24startIndex=15&from_date=2012-11-11&search=salad>; rel="next", <https://app.sageone.com/api/v1/sales_invoices?%24startIndex=5&from_date=2012-11-11&search=salad>; rel="prev"')
+    end
+  end
+
+  context 'when there is no SData' do
+    before { stub_get('sales_invoices/954380').to_return(body: fixture('sales_invoice.json')) }
+    it "does not create link headers" do
+      response = connection.get('sales_invoices/954380')
+      expect(response.headers['X-Sdata-Pagination-Links']).to be_nil
+    end
+    it "leaves the resources in the body of the response" do
+      response = connection(false).get('sales_invoices/954380')
+      response.body.to_s.should eq(JSON.parse(fixture('sales_invoice.json').read).to_s)
+    end
+  end
+
+  context 'within first page of results, but not from start_index of 0' do
+    before { stub_get('sales_invoices').to_return(body: sdata_fixture('sales_invoices.json', 20, 3, 5)) }
+    it "Adds a previous link to start_index=0" do
+      response = connection.get('sales_invoices')
+      expect(response.headers['X-Sdata-Pagination-Links']).to include(%Q{<#{sage_url('sales_invoices?%24startIndex=0')}>; rel="prev"})
+    end
+    it "Adds a next link to start_index=8" do
+      response = connection.get('sales_invoices')
+      expect(response.headers['X-Sdata-Pagination-Links']).to include(%Q{<#{sage_url('sales_invoices?%24startIndex=8')}>; rel="next"})
+    end
+  end
+end

data/spec/faraday/response/raise_sage_one_exception_spec.rb

@@ -0,0 +1,45 @@
+require 'spec_helper'
+
+describe FaradayMiddleware::RaiseSageOneException do
+  let(:client) { SageOne::Client.new }
+
+  {
+    400 => SageOne::BadRequest,
+    401 => SageOne::Unauthorized,
+    403 => SageOne::Forbidden,
+    404 => SageOne::NotFound,
+    409 => SageOne::Conflict,
+    422 => SageOne::UnprocessableEntity,
+  }.each do |status, exception|
+    context "when HTTP status is #{status}" do
+
+      before { stub_get('sales_invoices').to_return(:status => status) }
+
+      it "raises #{exception.name} error" do
+        expect { client.sales_invoices }.to raise_error(exception)
+      end
+    end
+  end
+
+  context "when the response body contains an error: key (i.e. from OAuth)" do
+    before { stub_get('sales_invoices').to_return(:status => 400, body: { error: "Unauthorised Access" }) }
+    it "raises an error with the error message" do
+      expect { client.sales_invoices }.to raise_error(SageOne::BadRequest, '{"method":"get","url":"https://app.sageone.com/api/v1/sales_invoices","status":400,"body":{"error":"Unauthorised Access"}}')
+    end
+  end
+
+  context "when the response body contains validation errors" do
+    before { stub_post('sales_invoices').to_return(:status => 422, body: fixture('invalid_sales_invoice.json')) }
+    it "includes the validation errors" do
+      expect { client.post('sales_invoices', {}) }.to raise_error(SageOne::UnprocessableEntity, %q{{"method":"post","url":"https://app.sageone.com/api/v1/sales_invoices","status":422,"body":{"$diagnoses":[{"$severity":"error","$dataCode":"ValidationError","$message":"blank","$source":"due_date"},{"$severity":"error","$dataCode":"ValidationError","$message":"invalid date","$source":"due_date"},{"$severity":"error","$dataCode":"ValidationError","$message":"blank","$source":"carriage_tax_code_id"},{"$severity":"error","$dataCode":"ValidationError","$message":"The type of sale associated with a product/service no longer exists. Check product/service and try again.","$source":"line_items"}]}}})
+    end
+  end
+
+  context "when the response body is nil" do
+    before { stub_post('sales_invoices').to_return(:status => 422, body: nil) }
+    it "just converts this to a blank string" do
+      expect { client.post('sales_invoices', {}) }.to raise_error(SageOne::UnprocessableEntity, %q{{"method":"post","url":"https://app.sageone.com/api/v1/sales_invoices","status":422,"body":""}})
+    end
+  end
+
+end

data/spec/fixtures/contact.json

@@ -0,0 +1,28 @@
+{
+  "id":568085,
+  "name":"Luke Brown",
+  "company_name":"Luke corp",
+  "name_and_company_name":"Luke corp (Luke Brown)",
+  "contact_type":{"id":1,"$key":1},
+  "email":"luke.brown@example.com",
+  "telephone":"",
+  "mobile":"",
+  "notes":"",
+  "tax_reference":"",
+  "lock_version":0,
+  "main_address":{"street_one":"",
+  "street_two":"",
+  "town":"",
+  "county":"",
+  "postcode":"",
+  "country":{"$key":null},
+  "$key":1167938},
+  "delivery_address":{"street_one":"",
+  "street_two":"",
+  "town":"",
+  "county":"",
+  "postcode":"",
+  "country":{"$key":null},
+  "$key":1167939},
+  "$key":568085
+}

data/spec/fixtures/invalid_sales_invoice.json

@@ -0,0 +1,28 @@
+{
+  "$diagnoses": [
+    {
+      "$severity":"error",
+      "$dataCode":"ValidationError",
+      "$message":"blank",
+      "$source":"due_date"
+    },
+    {
+      "$severity":"error",
+      "$dataCode":"ValidationError",
+      "$message":"invalid date",
+      "$source":"due_date"
+    },
+    {
+      "$severity":"error",
+      "$dataCode":"ValidationError",
+      "$message":"blank",
+      "$source":"carriage_tax_code_id"
+    },
+    {
+      "$severity":"error",
+      "$dataCode":"ValidationError",
+      "$message":"The type of sale associated with a product/service no longer exists. Check product/service and try again.",
+      "$source":"line_items"
+    }
+  ]
+}

data/spec/fixtures/oauth/invalid_client.json

@@ -0,0 +1 @@
+{"error":"invalid_client"}

data/spec/fixtures/oauth/invalid_grant.json

@@ -0,0 +1 @@
+{"error":"invalid_grant"}

data/spec/fixtures/oauth/oauth_token.json

@@ -0,0 +1,4 @@
+{
+  "access_token":"IguLPAK5VPvDSw3z4SjrkhHTyRXgnnqAPzt1mLUk",
+  "token_type":"bearer"
+}

data/spec/fixtures/sales_invoice.json

@@ -0,0 +1,43 @@
+{
+  "id":954380,
+  "invoice_number":"SI-4",
+  "status":{"id":1, "$key":1},
+  "due_date":"19/04/2013",
+  "date":"20/03/2013",
+  "void_reason":null,
+  "outstanding_amount":"17.0",
+  "total_net_amount":"14.17",
+  "total_tax_amount":"2.83",
+  "tax_scheme_period_id":30394,
+  "carriage":"0.0",
+  "carriage_tax_code":{"id":1, "$key":1},
+  "carriage_tax_rate_percentage":"20.0",
+  "contact":{"id":568085, "$key":568085},
+  "contact_name":"Luke corp (Luke Brown)",
+  "main_address":"Killer Bees",
+  "delivery_address":"",
+  "delivery_address_same_as_main":false,
+  "reference":"",
+  "notes":"future date. did email it.",
+  "terms_and_conditions":"",
+  "lock_version":0,
+  "line_items":[
+    { "id":1570294,
+      "description":"Some fish - herring",
+      "quantity":"1.0",
+      "unit_price":"17.0",
+      "net_amount":"14.17",
+      "tax_amount":"2.83",
+      "tax_code":{"id":1, "$key":1},
+      "tax_rate_percentage":"20.0",
+      "unit_price_includes_tax":true,
+      "ledger_account":{"id":1898509, "$key":1898509},
+      "product_code":"HERRING",
+      "product":{"id":68656, "$key":68656},
+      "service":{"$key":null},
+      "lock_version":0,
+      "$key":1570294
+    }
+  ],
+  "$key":954380
+}