salesreceipt.go

package quickbooks

import (
	"bytes"
	"encoding/json"
	"net/http"
	"net/url"
)

type SalesReceipt struct {
	ID            string    `json:"Id,omitempty"`
	SyncToken     string    `json:",omitempty"`
	MetaData      *MetaData `json:",omitempty"`
	DocNumber     string    `json:",omitempty"`
	TxnDate       *Date     `json:",omitempty"`
	PrivateNote   string    `json:",omitempty"`
	Line          []Line
	BillAddr      *PhysicalAddress `json:",omitempty"`
	ShipAddr      *PhysicalAddress `json:",omitempty"`
	ShipFromAddr  *PhysicalAddress `json:",omitempty"`
	PaymentRefNum string           `json:",omitempty"`
	Domain        string           `json:"domain,omitempty"`

	ShipMethodRef *ReferenceType `json:",omitempty"`
	ShipDate      *Date          `json:",omitempty"`
	TrackingNum   string         `json:",omitempty"`
	TotalAmt      json.Number    `json:",omitempty"`

	CurrencyRef           *ReferenceType `json:",omitempty"`
	ExchangeRate          json.Number    `json:",omitempty"`
	PrintStatus           string         `json:",omitempty"` // Valid values: NotSet, NeedToPrint, PrintComplete
	EmailStatus           string         `json:",omitempty"`
	HomeTotalAmt          json.Number    `json:",omitempty"`
	FreeFormAddress       bool           `json:",omitempty"`
	ApplyTaxAfterDiscount bool           `json:",omitempty"`
	Spare                 bool           `json:"spare,omitempty"`
	DepositToAccountRef   *ReferenceType `json:",omitempty"`
	CustomerMemo          *MemoRef       `json:",omitempty"`
	ProjectRef            *ReferenceType `json:",omitempty"`

	Balance          json.Number    `json:",omitempty"`
	CustomerRef      *ReferenceType `json:",omitempty"`
	TxnTaxDetail     *TxnTaxDetail  `json:",omitempty"`
	PaymentMethodRef *ReferenceType `json:",omitempty"`

	GlobalTaxCalculation string         `json:",omitempty"` // Values: TaxExcluded, TaxInclusive, NotApplicable
	DepositToAccount     *ReferenceType `json:",omitempty"`
}

func (c *Client) CreateSalesReceipt(receipt *SalesReceipt) (*SalesReceipt, error) {
	var u, err = url.Parse(string(c.Endpoint))
	if err != nil {
		return nil, err
	}
	u.Path = "/v3/company/" + c.RealmID + "/salesreceipt"
	var v = url.Values{}
	v.Add("minorversion", minorVersion)
	u.RawQuery = v.Encode()
	var j []byte
	j, err = json.Marshal(receipt)
	if err != nil {
		return nil, err
	}
	var req *http.Request
	req, err = http.NewRequest("POST", u.String(), bytes.NewBuffer(j))
	if err != nil {
		return nil, err
	}
	req.Header.Add("Content-Type", "application/json")
	req.Header.Add("Accept", "application/json")
	var res *http.Response
	res, err = c.Client.Do(req)
	if err != nil {
		return nil, err
	}
	defer res.Body.Close()

	if res.StatusCode != http.StatusOK {
		return nil, parseFailure(res)
	}

	var r struct {
		SalesReceipt SalesReceipt
		Time         Date
	}

	err = json.NewDecoder(res.Body).Decode(&r)
	return &r.SalesReceipt, err
}

// DeleteInvoice deletes the given Invoice by ID and sync token from the
// QuickBooks server.
func (c *Client) DeleteSalesReceipt(id, syncToken string) error {
	var u, err = url.Parse(string(c.Endpoint))
	if err != nil {
		return err
	}
	u.Path = "/v3/company/" + c.RealmID + "/salesreceipt"
	var v = url.Values{}
	v.Add("minorversion", minorVersion)
	v.Add("operation", "delete")
	u.RawQuery = v.Encode()
	var j []byte
	j, err = json.Marshal(struct {
		ID        string `json:"Id"`
		SyncToken string
	}{
		ID:        id,
		SyncToken: syncToken,
	})
	if err != nil {
		return err
	}
	var req *http.Request
	req, err = http.NewRequest("POST", u.String(), bytes.NewBuffer(j))
	if err != nil {
		return err
	}
	req.Header.Add("Content-Type", "application/json")
	req.Header.Add("Accept", "application/json")
	var res *http.Response
	res, err = c.Client.Do(req)
	if err != nil {
		return err
	}
	defer res.Body.Close()
	//var b, _ = ioutil.ReadAll(res.Body)
	//log.Println(string(b))

	// If the invoice was already deleted, QuickBooks returns 400 :(
	// The response looks like this:
	// {"Fault":{"Error":[{"Message":"Object Not Found","Detail":"Object Not Found : Something you're trying to use has been made inactive. Check the fields with accounts, invoices, items, vendors or employees.","code":"610","element":""}],"type":"ValidationFault"},"time":"2018-03-20T20:15:59.571-07:00"}

	// This is slightly horrifying and not documented in their API. When this
	// happens we just return success; the goal of deleting it has been
	// accomplished, just not by us.
	if res.StatusCode == http.StatusBadRequest {
		var r Failure
		err = json.NewDecoder(res.Body).Decode(&r)
		if err != nil {
			return err
		}
		if r.Fault.Error[0].Message == "Object Not Found" {
			return nil
		}
	}
	if res.StatusCode != http.StatusOK {
		return parseFailure(res)
	}

	// TODO they send something back, but is it useful?
	return nil
}