Skip to main content
Skip table of contents

AP Supplier

URL

Verbs

Function

/Supplier

GET

Query a list of all Suppliers

/Supplier/<code>

GET

Query a single Supplier

/Supplier

POST

Create a new supplier

/Supplier/<code>

POST

Update an existing Supplier

  • Note updated for Post 2018.3 to handle the full Supplier detail

Supported modifiers

Query String

Definition

Sample
Available
modifiedSinceReturn Suppliers modified since a particular date and timemodifiedSince=2013-02-28T16:45:00 
treeName and treeBranchReturn a list of Suppliers assigned to a nominated branch of a nominated treetreeName=Colour-AUS&treeBranch=Blue 
taxReferenceReturn a list of Suppliers that match the the tax reference passed in (ie lookup by ABN)taxReference=24454342 
statusReturn a list of Suppliers for a particulat statusstatus=Active 

isActive

Return a list of Suppliers deemed Active in Greentree

isActive=true

 
respectAdvancedSecurityForUserReturn only Suppliers that are accessible to the nominated User based on Advanced SecurityrespectAdvancedSecurityForUser=Susan Smith2020.3

Security Linked Menu

Menu Item
Located
Supplier MaintenanceData Entry / Accounts Payable

Sample XML Response

<?xml version="1.0" encoding="UTF-8"?>
<Supplier>
    <Code>2000</Code>
    <Alpha>CPMNX</Alpha>
    <Name>Computer and Parts Maintenance</Name>
    <OidString>2578.53</OidString>
    <Edition>202</Edition>
    <ModifiedTimeStamp>2018-10-10T12:27:46</ModifiedTimeStamp>
    <ModifiedUser>SUPER</ModifiedUser>
    <EntryTimeStamp>2007-07-21T11:47:49</EntryTimeStamp>
    <EntryUser/>
    <IsActive>false</IsActive>
    <AlternatePayeeName>Ralph</AlternatePayeeName>
    <BankAccount>
        <AccountNo>643117125268</AccountNo>
        <Branch/>
        <Name/>
        <Suffix/>
        <FullBankAccount>643117125268</FullBankAccount>
    </BankAccount>
    <CreditorsControlAccount>33.*.*</CreditorsControlAccount>
    <DiscountRate>12.00</DiscountRate>
    <GLExpenseAccountNo>14.*.*</GLExpenseAccountNo>
    <InvoiceForm>AP Invoice</InvoiceForm>
    <IsChild>false</IsChild>
    <IsPayingInvoicesSeparately>false</IsPayingInvoicesSeparately>
    <IsPrintSupplierPartNum>true</IsPrintSupplierPartNum>
    <IsReportTaxablePayments>false</IsReportTaxablePayments>
    <IsTPRIndividual>false</IsTPRIndividual>
    <IsUseAdvInvoicing>true</IsUseAdvInvoicing>
    <IsUsingAlternatePayeeAddress>true</IsUsingAlternatePayeeAddress>
    <IsUsingAlternatePayeeName>false</IsUsingAlternatePayeeName>
    <IsUsingBuyerCreatedInvoice>true</IsUsingBuyerCreatedInvoice>
    <IsUsingWithholdingTax>false</IsUsingWithholdingTax>
    <IsSingleAttachmentPereReportingEmail>false</IsSingleAttachmentPereReportingEmail>
    <BPayBillerCode>123</BPayBillerCode>
    <BPayReference>5678</BPayReference>
    <IsBPayDefaultReferenceFromInvoice>true</IsBPayDefaultReferenceFromInvoice>
    <IsBPayFixedReference>true</IsBPayFixedReference>
    <Country>AUS</Country>
    <PayeeAddress>
        <Contact/>
        <Address1>Factory 123</Address1>
        <Address2>663 Luck Street2</Address2>
        <Address3>Smithfield</Address3>
        <Suburb>Mulgrave South</Suburb>
        <Postcode>3173</Postcode>
        <State>NSW</State>
        <Country>AUS</Country>
        <TZone>+11:00</TZone>
        <PhoneBH>(03) 9586 5233</PhoneBH>
        <PhoneAH>(03) 9586 5237</PhoneAH>
        <Fax>(03) 9584 5230</Fax>
        <Email>sales@cpm.com</Email>
        <Web>www.myaddres.com</Web>
        <Mobile>0410 007 334</Mobile>
    </PayeeAddress>
    <SecurityTeam>HR Weekly</SecurityTeam>
    <BalanceType>Balance Forward</BalanceType>
    <Branch>02</Branch>
    <AnalysisCode>ADVE</AnalysisCode>
    <Calendar>JUN</Calendar>
    <Currency>AUD</Currency>
    <DeliveryMethod>Courier-Road</DeliveryMethod>
    <CreditNoteType>AP Credit</CreditNoteType>
    <InvoiceType>Receipt</InvoiceType>
    <PaymentTerm>60 Days from Invoice Date</PaymentTerm>
    <DiscountType>Percentage of Total</DiscountType>
    <PurchaseOrders>
        <ClearingAccount>21.*.*</ClearingAccount>
        <HoldStatus>Entered</HoldStatus>
        <Form>PO Purchase Order - L</Form>
        <VarianceAccount>15.*.*</VarianceAccount>
        <DeliveryMethod>Email</DeliveryMethod>
        <RecipientAddress>peter@email.com</RecipientAddress>
    </PurchaseOrders>
    <PaymentMethod>BPay</PaymentMethod>
    <RemittanceDeliveryMethod>Print</RemittanceDeliveryMethod>
    <Status>Inactive</Status>
    <TaxCode>Input Taxed</TaxCode>
    <TaxType>Inclusive</TaxType>
    <Notes>Stickier Notes</Notes>
    <PayeeRef1>Payment from2</PayeeRef1>
    <PayeeRef2>e-Computers3</PayeeRef2>
    <PayeeRef3>Miss 4</PayeeRef3>
    <RemittanceRecipientAddress>steve@emailc.om</RemittanceRecipientAddress>
    <RetentionBalance>0.00</RetentionBalance>
    <TaxControlAccount>17.*.*</TaxControlAccount>
    <TotalHoldAmount>7524.11</TotalHoldAmount>
    <TotalOutstandingBalance>38665.12</TotalOutstandingBalance>
    <TransitABANumber/>
    <TaxActivity/>
    <TaxExemption/>
    <ExemptionEnd/>
    <ExemptionStart/>
    <TaxRate>0</TaxRate>
    <TaxReference>72 456 379 609</TaxReference>
    <TaxReturnEnd/>
    <TaxReturnStart/>
    <TaxReturnName/>
    <Address>
        <Contact>Georgie</Contact>
        <Address1>Factory 123</Address1>
        <Address2>663 Luck Street2</Address2>
        <Address3>Smithfield</Address3>
        <Suburb>Mulgrave South</Suburb>
        <Postcode>3173</Postcode>
        <State>NSW</State>
        <Country>AUS</Country>
        <TZone>+11:00</TZone>
        <PhoneBH>(03) 9586 5233</PhoneBH>
        <PhoneAH>(03) 9586 5237</PhoneAH>
        <Fax>(03) 9584 5230</Fax>
        <Email>sales@cpm.com</Email>
        <Web>www.myaddres.com</Web>
        <Mobile>0410 007 334</Mobile>
    </Address>
    <UserDefinedFields collection='true' count='2'>
        <UserDefinedField>
            <Name>Review Date</Name>
            <Type>Date</Type>
            <Value>2009-02-02</Value>
        </UserDefinedField>
        <UserDefinedField>
            <Name>UBD Ref</Name>
            <Type>String</Type>
            <Value>12 E43</Value>
        </UserDefinedField>
    </UserDefinedFields>
    <Trees collection='true' count='2'>
        <Tree>
            <Name>Region-AUS</Name>
            <IsMandatory>false</IsMandatory>
            <Value>Tasmania</Value>
            <Path>Australia\Tasmania</Path>
            <ShortCode>TAS</ShortCode>
        </Tree>
        <Tree>
            <Name>Supplier Type-AUS</Name>
            <IsMandatory>false</IsMandatory>
            <Value>Hardware Wholesalers</Value>
            <Path>Hardware Wholesalers</Path>
            <ShortCode>HARDWARE</ShortCode>
        </Tree>
    </Trees>
</Supplier>
JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.