Hosted API - 22 March 2022 - Reckon Help and Support Centre

Overview

We've released exciting new features and enhancements to v6.1 of the SDK that will help you get the best out of Reckon Accounts.

Support for Gross Amount

You can now pass the Gross amount instead of the Net amount for the Bill Credit transactions, in addition to the other transaction types that were added in SDK 6.1 2021 R2.

To be able to send Gross amounts, you will need to send <IsTaxIncluded> true </IsTaxIncluded> with your payload.

<IsTaxIncluded> is optional when you post your request to the supported transaction types. In the responses from the supported transaction types, you will notice the <IsTaxIncluded> qbXML tag within the transaction 'Ret' aggregate, for example, for Bill Credit queries, within the <VendorCreditRet>, even if you do not send this tag in your post. Please ensure that your app is able to handle the extra object in the response.

Supported request

Add
Query

To be able to post Gross amount, you will need to enable Allow tax inclusive (gross) prices and costs to be entered from Edit > Preferences > Tax > Company Preferences.

Sample

Bill Credit Add Request

<IsTaxIncluded>true</IsTaxIncluded> is included in the payload to tag the amount as Gross.

{
    "FileName":"{{file_name}}",
    "Operation":
    "<?xml version=\"1.0\"?>
     <?qbxml version="6.1"?>
     <QBXML>
         <QBXMLMsgsRq onError="continueOnError">
            <VendorCreditAddRq>
                <VendorCreditAdd>
                    <VendorRef>			
                        <FullName>Plastic Supplies</FullName>
                    </VendorRef>
                    <APAccountRef>
                        <FullName>Accounts Payable</FullName>
                    </APAccountRef>
                    <TxnDate>2022-01-28</TxnDate>
                    <RefNumber>1016</RefNumber>
                    <Memo>Bill from A.James glass and aluminium</Memo>
                    <IsTaxIncluded>true</IsTaxIncluded>
                    <ItemLineAdd>
                        <ItemRef>
                            <FullName>Service Tax Absent</FullName>
                        </ItemRef>
                        <Desc>Service Item IsTaxIncluded not sent</Desc>
                        <Quantity>30</Quantity>                   
                        <Cost>10.00</Cost>
                        <Amount>300.00</Amount>
                        <TaxAmount>0.00</TaxAmount>                
                        <SalesTaxCodeRef>
                            <FullName>E</FullName>
                        </SalesTaxCodeRef>
                    </ItemLineAdd>
                </VendorCreditAdd>
            </VendorCreditAddRq>
        </QBXMLMsgsRq>
     </QBXML>",
     "UserName":"{{user_name}}",
     "Password":"{{password}}",
     "CountryVersion":"20xx.Rx.xx"
}

Bill Credit Query Request

<IsTaxIncluded>true</IsTaxIncluded> is included in the payload to tag the amount as Gross.

{
    "FileName":"{{file_name}}",
    "Operation":
    "<?xml version=\"1.0\"?>
     <?qbxml version="6.1"?>
     <QBXML>
        <QBXMLMsgsRq onError="continueOnError">
            <VendorCreditQueryRq >
            </VendorCreditQueryRq>
        </QBXMLMsgsRq>
     </QBXML>
     "UserName":"{{user_name}}",
     "Password":"{{password}}",
     "CountryVersion":"20xx.Rx.xx"
}

Bill Credit Query Response

<?xml version="1.0" ?>
<QBXML>
    <QBXMLMsgsRs>
        <VendorCreditQueryRs statusCode="0" statusSeverity="Info" statusMessage="Status OK">
            <VendorCreditRet>
                <TxnID>CD-1644272992</TxnID>
                <TimeCreated>2022-02-07T22:29:52+00:00</TimeCreated>
                <TimeModified>2022-02-07T22:29:52+00:00</TimeModified>
                <EditSequence>1644272992</EditSequence>
                <TxnNumber>36</TxnNumber>
                <VendorRef>
                    <ListID>80000009-1643949500</ListID>
                    <FullName>sup2</FullName>
                </VendorRef>
                <APAccountRef>
                <ListID>80000056-1610066781</ListID>
                    <FullName>Accounts Payable</FullName>
                </APAccountRef>
                <TxnDate>2022-01-28</TxnDate>
                <CreditAmount>330.63</CreditAmount>
                <RefNumber>1</RefNumber>
                <Memo>Sdktax included memo</Memo>
                <IsTaxIncluded>false</IsTaxIncluded>
            </VendorCreditRet>
        </VendorCreditQueryRs>
    </QBXMLMsgsRs>
</QBXML>

Resolved SDK Bug

The Add request issues when the default value is not passed in the <IsTaxIncluded> qbXML tag were fixed for the following transactions:

Sales receipts
Adjustment notes
Estimates
Sales orders
Purchase Order
Bill

Hosted API - 22 March 2022