DataFlex

Xero Create New Accounts

Demonstrates how to create a new account in Xero.

Note: Requires Chilkat v9.5.0.64 or greater.

DataFlex

Use ChilkatAx-win32.pkg

Procedure Test
    Boolean iSuccess
    Handle hoRest
    Variant vSbAccounts
    Handle hoSbAccounts
    Handle hoHtAccounts
    Integer iCode
    Handle hoXml
    String sResponseXml
    String sTemp1
    Integer iTemp1
    Boolean bTemp1

    Move False To iSuccess

    // Note: Requires Chilkat v9.5.0.64 or greater.

    // This requires the Chilkat API to have been previously unlocked.
    // See Global Unlock Sample for sample code.

    Get Create (RefClass(cComChilkatRest)) To hoRest
    If (Not(IsComObjectCreated(hoRest))) Begin
        Send CreateComObject of hoRest
    End

    // Before sending REST API calls, the REST object needs to be
    // initialized for OAuth1.
    // See Xero 2-Legged OAuth1 Setup for sample code.

    // Assuming the REST object's OAuth1 authenticator is setup, and the initial
    // connection was made, we may now send REST HTTP requests..

    // --------------------------------------------------------------
    // To add certain accounts, we need a unique Code that hasn't yet been used.
    // Chilkat provided an example to download and save the Accounts data.
    // We can load this data into a hashtable to help us find an unused Code.
    // See Hash Xero Account Codes to see how this file was created.
    Get Create (RefClass(cComChilkatStringBuilder)) To hoSbAccounts
    If (Not(IsComObjectCreated(hoSbAccounts))) Begin
        Send CreateComObject of hoSbAccounts
    End
    Get ComLoadFile Of hoSbAccounts "qa_cache/xero_accounts_by_code.xml" "utf-8" To iSuccess
    If (Not iSuccess) Begin
        Showln "failed to load xero_accounts_by_code.xml"
        Procedure_Return
    End

    Get Create (RefClass(cComChilkatHashtable)) To hoHtAccounts
    If (Not(IsComObjectCreated(hoHtAccounts))) Begin
        Send CreateComObject of hoHtAccounts
    End
    Get pvComObject of hoSbAccounts to vSbAccounts
    Get ComAddFromXmlSb Of hoHtAccounts vSbAccounts To iSuccess

    // --------------------------------------------------------------
    // Build the request XML to create a Xero sales account.
    // Find an unused Code...
    Move 600 To iCode
    While ((ComContainsIntKey(hoHtAccounts, iCode)) = True)
        Move (iCode + 1) To iCode
    Loop

    Get Create (RefClass(cComChilkatXml)) To hoXml
    If (Not(IsComObjectCreated(hoXml))) Begin
        Send CreateComObject of hoXml
    End
    Set ComTag Of hoXml To "Account"
    Send ComNewChildInt2 To hoXml "Code" iCode
    Send ComNewChild2 To hoXml "Name" "Sales - clearance lines"
    Send ComNewChild2 To hoXml "Type" "SALES"
    Set ComEmitCompact Of hoXml To True

    // Do not emit the XML declarator. Xero does not accept the XML if it
    // has the initial line: <?xml version="1.0" encoding="utf-8"?>
    Set ComEmitXmlDecl Of hoXml To False

    Get ComGetXml Of hoXml To sTemp1
    Get ComAddQueryParam Of hoRest "xml" sTemp1 To iSuccess

    Set ComVerboseLogging Of hoRest To True
    Get ComFullRequestFormUrlEncoded Of hoRest "PUT" "/api.xro/2.0/Accounts" To sResponseXml
    Get ComLastMethodSuccess Of hoRest To bTemp1
    If (bTemp1 <> True) Begin
        Get ComLastErrorText Of hoRest To sTemp1
        Showln sTemp1
        Procedure_Return
    End

    // A 200 response is expected for actual success.
    Get ComResponseStatusCode Of hoRest To iTemp1
    If (iTemp1 <> 200) Begin
        Showln sResponseXml
        Procedure_Return
    End

    // Examine the XML response
    Showln sResponseXml

    // A successful XML response is as follows:

    // <Response xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    //   <Id>dac71f1b-7afb-49a7-8a57-719b91f2088e</Id>
    //   <Status>OK</Status>
    //   <ProviderName>ChilkatPrivate</ProviderName>
    //   <DateTimeUTC>2016-11-10T23:53:43.487791Z</DateTimeUTC>
    //   <Accounts>
    //     <Account>
    //       <AccountID>cb8c94cf-57d4-41ee-b866-4c27632fe838</AccountID>
    //       <Code>601</Code>
    //       <Name>Sales - clearance lines</Name>
    //       <Status>ACTIVE</Status>
    //       <Type>SALES</Type>
    //       <TaxType>OUTPUT</TaxType>
    //       <Class>REVENUE</Class>
    //       <EnablePaymentsToAccount>false</EnablePaymentsToAccount>
    //       <ShowInExpenseClaims>false</ShowInExpenseClaims>
    //       <ReportingCode>REV</ReportingCode>
    //       <ReportingCodeName>Revenue</ReportingCodeName>
    //       <UpdatedDateUTC>2016-11-10T23:53:43.94</UpdatedDateUTC>
    //     </Account>
    //   </Accounts>
    // </Response>

    // To access the information:
    Get ComLoadXml Of hoXml sResponseXml To iSuccess

    Get ComGetChildContent Of hoXml "Accounts|Account|AccountID" To sTemp1
    Showln "AccountID: " sTemp1
    Get ComGetChildContent Of hoXml "Accounts|Account|TaxType" To sTemp1
    Showln "TaxType: " sTemp1
    // ..


End_Procedure