Supplier

Return, update, create and delete a supplier contact.

Date Released: Dec 2013 Date Updated: Apr 2022
URLSupports

/{cf_uri}/Contact/Supplier

/{cf_uri}/Contact/Supplier{contact_uid}/Photo

GET |  PUT |  POST |  DELETE

GET |  PUT |  POST |  DELETE

Please note: The /{cf_uri}/Contact/Supplier/{contact_uid}/Photo endpoint is only available when using AccountRight.
Please note: While accessibility via the API is available to both AccountRight and new Essentials files. Not all features will be displayed in Product for new Essentials

The elements list below details information for Supplier. To view the descriptions for the elements you can either hover any attribute to reveal details or click here to show all details inline.

Items shown with are required when posting or puting data
Items shown with are read-only elements

Attribute Details

  • UIDGuid (36)
  • Unique supplier contact identifier in the form of a guid.
    ONLY required for updating an existing contact
    NOT required when creating a new contact.
  • CompanyNameString (50)
  • Company name of the supplier contact.
    ONLY required when creating a company contact with IsIndividual set to false.
  • LastNameString (30)
  • Last name for an individual contact
  • FirstNameString (20)
  • First name for an individual contact
  • IsIndividualBoolean
  • True indicates the supplier contact represents an individual.
    False indicates the supplier contact represents a company.
  • DisplayIDString (15)
  • Supplier contact card id. { 'DisplayID': 'SUP00001' }
  • IsActiveBoolean
  • True indicates the supplier contact is active.
    False indicates the supplier contact is inactive.
  • Addresses []
  • The following set of information pulls through details for a contact address
    • Location Integer
    • One contact can have up to five address records.
    • Street String (255)
    • Full content of Address field.
    • City String (255)
    • City of address record.
    • State String (255)
    • State of address record.
    • PostCode String (11)
    • Postcode of address record.
    • Country String (255)
    • Country of location for address record.
    • Phone1 String (21)
    • Phone number 1 of address record.
    • Phone2 String (21)
    • Phone number 2 of address record.
    • Phone3 String (21)
    • Phone number 3 of address record.
    • Fax String (21)
    • Fax number of address record.
    • Email String (255)
    • Email contact of address record.
    • Website String (255)
    • World wide web address for contact.
    • ContactName String (25)
    • Contact Name on address record.
    • Salutation String (15)
    • Salutation text for address record.
  • NotesString (255)
  • Notes for the supplier contact.
  • Identifiers []
  • This is an AccountRight only field. The following set of information pulls through details for a contact identifier
    • Label String (30)
    • This is an AccountRight only field. Name attached to the identification alphabet letter.
    • Value String
    • This is an AccountRight only field. Identifiers convert bits to actual letters, one of the 26 letters in the alphabet can be used.
  • CustomList1
  • This is an AccountRight only field. The following set of information pulls through details for a contact custom list
    • LabelString (30)
    • This is an AccountRight only field. Name of CustomList1 applicable to the custom list text, labels can be edited within the AccountRight interface ONLY.
      For example CustomList # 1 could be changed to Melbourne, click here for more information on how to edit labels
    • ValueString (30)
    • This is an AccountRight only field. Custom list text entry populated for CustomList1.
  • CustomList2
  • This is an AccountRight only field. The following set of information pulls through details for a contact custom list
    • LabelString (30)
    • This is an AccountRight only field. Name of CustomList2 applicable to the custom list text, labels can be edited within the AccountRight interface ONLY.
      For example CustomList # 2 could be changed to Sydney, click here for more information on how to edit labels
    • ValueString (30)
    • This is an AccountRight only field. Custom list text entry populated for CustomList2.
  • CustomList3
  • This is an AccountRight only field. The following set of information pulls through details for a contact custom list
    • LabelString (30)
    • This is an AccountRight only field. Name of CustomList3 applicable to the custom list text, labels can be edited within the AccountRight interface ONLY.
      For example CustomList # 3 could be changed to Tasmania, click here for more information on how to edit labels
    • ValueString (30)
    • This is an AccountRight only field. Custom list text entry populated for CustomList3.
  • CustomField1
  • This is an AccountRight only field. The following set of information pulls through details for a contact custom field
    • LabelString (30)
    • This is an AccountRight only field. Name of CustomField1 applicable to the custom field text, labels can be edited within the AccountRight interface ONLY.
      For example CustomField # 1 could be changed to South Australia, click here for more information on how to edit labels
    • ValueString (30)
    • This is an AccountRight only field. Custom field text entry populated for CustomField1.
  • CustomField2
  • This is an AccountRight only field. The following set of information pulls through details for a contact custom field
    • LabelString (30)
    • This is an AccountRight only field. Name of CustomField2 applicable to the custom field text, labels can be edited, for example CustomField # 2 could be changed to Queensland
    • ValueString (30)
    • This is an AccountRight only field. Custom field text entry populated for CustomField2.
  • CustomField3
  • This is an AccountRight only field. The following set of information pulls through details for a contact custom field
    • LabelString (30)
    • This is an AccountRight only field. Name of CustomField3 applicable to the custom field text, labels can be edited within the AccountRight interface ONLY.
      For example CustomField # 3 could be changed to ACT, click here for more information on how to edit labels
    • ValueString (30)
    • This is an AccountRight only field. Custom field text entry populated for CustomField3.
  • CurrentBalanceDecimal (13.6)
  • Supplier contact balance.
  • BuyingDetails
  • The following set of information pulls through default supplier buying details.
    • PurchaseLayoutPurchaseLayoutType
    • Purchase type of the record containing the full default purchase layout definition:
      NoDefault
      Service
      Item
      Professional
      Miscellaneous
    • PrintedFormString (255)
    • Named form selected as default printed form.
    • PurchaseOrderDeliveryString (20)
    • Default supplier delivery status.
    • ExpenseAccount
    • The following set of information pulls through details for an expense account
      • UIDGuid (36)
      • Foreign Key: Unique identifier for the expense account in the form of a guid.
      • NameString (60)
      • Name of the expense account
      • DisplayIDString (6)
      • Expense account code format includes separator ie 4-1100
      • URIString
      • Uniform resource identifier associated with the expense account object.
    • PaymentMemoString (255)
    • Default payment memo.
    • PurchaseCommentString (255)
    • Default selected purchase comment.
    • SupplierBillingRateDecimal (10.6)
    • The suppliers hourly billing rate exclusive of tax.
    • ShippingMethodString (255)
    • Shipping method text.
    • IsReportableBoolean
    • ONLY APPLICABLE FOR AU REGION.
      True indicates the supplier contact is setup for reportable taxable payments.
      False indicates the supplier contact is not setup for reportable taxable payments.
      What are taxable payments?
    • CostPerHour Decimal (13.6)
    • Cost per hour of providing the suppliers services when generating an activity slip.
    • Credit
    • The following set of information pulls through default supplier credit details.
      • Limit Decimal (13.6)
      • Suppliers credit limit.
      • Available Decimal (13.6)
      • Suppliers credit available.
      • PastDue Decimal (13.6)
      • Suppliers past due balance.
    • ABNString (14)
    • ONLY APPLICABLE FOR AU REGION.
      ABN Number (Must be 11 digits and formatted as XX XXX XXX XXX). { 'ABN': '45 676 343 224' }
    • ABNBranchString (11)
    • ONLY APPLICABLE FOR AU REGION.
      ABN branch number.
    • TaxIdNumber String (19)
    • Tax id number.
    • TaxCode
    • The following set of information pulls through the details for the TaxCodes
      • UID GUID (36)
      • Foreign Key: Unique tax code identifier in the form of a guid
      • Code String (3)
      • 3 digit code assigned to the tax code.
      • URI String
      • Uniform resource identifier associated with the Tax code object
    • FreightTaxCode
    • The following set of information pulls through the details for freight Tax Codes
      • UID GUID (36)
      • Foreign Key: Unique freight tax code identifier in the form of a guid
      • Code String (3)
      • 3 digit code assigned to the freight tax code.
      • URI String
      • Uniform resource identifier associated with the freight tax code object.
    • UseSupplierTaxCodeBoolean
    • True indicates to use the supplier tax code.
      False indicates do not use the supplier tax code.
    • Terms
    • The following set of information pulls through supplier terms.
      • PaymentIsDueString
      • Default Terms of Payment definitions:
        CashOnDelivery
        PrePaid
        InAGivenNumberOfDays
        OnADayOfTheMonth
        NumberOfDaysAfterEOM
        DayOfMonthAfterEOM
      • DiscountDate Integer
      • If PaymentIsDue = CashOnDelivery, PrePaid, InAGivenNumberOfDaysNumber or NumberOfDaysAfterEOM then set the number of days within which payments must be made to receive discounts.

        If PaymentIsDue = OnADayOfTheMonth or DayOfMonthAfterEOM then set the day of the month within which the payment must be made to receive discounts.
      • BalanceDueDate Integer
      • If PaymentIsDue = CashOnDelivery, PrePaid, InAGivenNumberOfDaysNumber or NumberOfDaysAfterEOM then set the number of days within which payments must be made.

        If PaymentIsDue = OnADayOfTheMonth or DayOfMonthAfterEOM then set the day of the month within which payments must be made.
      • DiscountForEarlyPayment Double (99.99%)
      • % discount for early payment.
      • VolumeDiscount Double (99.99%)
      • Volume supplier discount.
  • PaymentDetails
  • The following set of information pulls through supplier payment details.
    • BSBNumber String (6)
    • ONLY APPLICABLE FOR AU REGION.
      Default bank account bsb number.
    • BankAccountNumberString (9)
    • Default bank account number.
      Please note: when working with the NZ region, ensure the number is valid and formatted (XX-XXXX-XXXXXXX-XX){ 'BankAccountNumber': '03-1587-0050000-00' }
    • BankAccountName String (32)
    • Default bank account name.
    • StatementTextString (18)
    • ONLY APPLICABLE FOR AU REGION.
      Default statement text.
    • StatementCodeString
    • ONLY APPLICABLE FOR NZ REGION.
      Default code attached to an electronic payment.
    • StatementReferenceString
    • ONLY APPLICABLE FOR NZ REGION.
      Default reference attached to an electronic payment.
    • Refund
    • The following set of information pulls through refund details.
      • PaymentMethod PaymentMethod
      • Payment method on refund, must exist in company file, default methods consist of the following: (Users can add new methods through AccountRight UI)

        American Express
        Bank Card
        Barter Card
        Cash
        Cheque
        Diners Club
        EFTPOS
        MasterCard
        Money Order
        Other
        Visa
      • CardNumber String (4)
      • Last 4 digits only.
      • NameOnCard String (50)
      • Default name on card.
      • Notes String (255)
      • Default refund payment notes.
  • ForeignCurrency
  • This is an AccountRight only field.Null if no foreign currency is set.
    • UIDGuid (36)
    • This is an AccountRight only field. Foreign Key: Unique identifier for the currency in the form of a guid.
    • CodeString (3)
    • This is an AccountRight only field.The currency code.
    • CurrencyNameString
    • This is an AccountRight only field. The full name of the currency
    • URIString
    • This is an AccountRight only field. Uniform resource identifier associated with the currency object.
  • LastModifiedDateTime
  • Extracts the last modification date for the contact resource.
  • PhotoURIString
  • This is an AccountRight only field. Uniform resource identifier associated with a photo image.
  • URIString
  • Uniform resource identifier encompasses all types of names and addresses that refer to objects on the web.
  • RowVersionString
  • Number value that changes upon a record update, can be used for change control but does does not preserve a date or a time.
    ONLY required for updating an existing contact
    NOT required when creating a new contact.


Paging: default page size is set to 400 with a maximum of 5000 results (contacts only).

Example json GET response

  • {
    • "UID" : "8654a102-4859-451f-834b-0ddb9bbf2edc",
    • "CompanyName" : "Cash Purchases",
    • "IsIndividual" : false,
    • "DisplayID" : "SUP00001",
    • "IsActive" : true,
    • "Addresses" : [
      • {
        • "Location" : 1,
        • "Street" : "105 Bourke Street",
        • "City" : "Melbourne",
        • "State" : "VIC",
        • "PostCode" : "3000",
        • "Country" : "Australia",
        • "Phone1" : "03 8897 9444",
        • "Phone2" : "03 8897 2989",
        • "Phone3" : "03 8897 7300",
        • "Fax" : "03 8897 4212",
        • "Website" : "www.myob.com.au",
        • "ContactName" : "Tim",
        • "Salutation" : "Mr."
        • }
      • ],
    • "Notes" : "Description for Cash Purchase",
    • "Identifiers" : [
      • {
        • "Label" : "AZZ",
        • "Value" : "E"
        • }
      • ],
    • "CustomList1" : null,
    • "CustomList2" : null,
    • "CustomList3" : null,
    • "CustomField1" : {
      • "Label" : "Custom Field No. 1",
      • "Value" : "Queensland"
      • },
    • "CustomField2" : {
      • "Label" : "Custom Field No. 2",
      • "Value" : "Adeliade"
      • },
    • "CustomField3" : {
      • "Label" : "Custom Field No. 3",
      • "Value" : "Tasmania"
      • },
    • "CurrentBalance" : 1000,
    • "BuyingDetails" : {
      • "PurchaseLayout" : "NoDefault",
      • "PrintedForm" : "",
      • "PurchaseOrderDelivery" : "Print",
      • "ExpenseAccount" : {
        • "UID" : "6703ee30-b063-4afe-8ed3-14834b25a30e",
        • "Name" : "Other Operating Expenses",
        • "DisplayID" : "6-2150",
        • "URI" : "{cf_uri}/GeneralLedger/Account/6703ee30-b063-4afe-8ed3-14834b25a30e"
        • },
      • "PaymentMemo" : "Thank you",
      • "PurchaseComment" : "Pick up ASAP.",
      • "SupplierBillingRate" : 0,
      • "ShippingMethod" : "Freight",
      • "IsReportable" : false,
      • "CostPerHour" : 0,
      • "Credit" : {
        • "Limit" : 0,
        • "Available" : 0,
        • "PastDue" : 0
        • },
      • "ABN" : "45 676 343 223",
      • "ABNBranch" : "014",
      • "TaxIdNumber" : null,
      • "TaxCode" : {
        • "UID" : "97e9b42d-56db-4e57-9033-4714221041f1",
        • "Code" : "GST",
        • "URI" : "{cf_uri}/GeneralLedger/TaxCode/97e9b42d-56db-4e57-9033-4714221041f1"
        • },
      • "FreightTaxCode" : {
        • "UID" : "97e9b42d-56db-4e57-9033-4714221041f1",
        • "Code" : "GST",
        • "URI" : "{cf_uri}/GeneralLedger/TaxCode/97e9b42d-56db-4e57-9033-4714221041f1"
        • },
      • "UseSupplierTaxCode" : true,
      • "Terms" : {
        • "PaymentIsDue" : "DayOfMonthAfterEOM",
        • "DiscountDate" : 1,
        • "BalanceDueDate" : 30,
        • "DiscountForEarlyPayment" : 0,
        • "VolumeDiscount" : 0
        • }
      • },
    • "PaymentDetails" : {
      • "BSBNumber" : "232-323",
      • "BankAccountNumber" : "234213421",
      • "BankAccountName" : "CLEAR AND BRIGHT FILTERS",
      • "StatementText" : "PAY FROM CLEARWTR",
      • "Refund" : {
        • "PaymentMethod" : "Visa",
        • "CardNumber" : "4921",
        • "NameOnCard" : "Mr MYOBapi Team",
        • "Notes" : "Refund notes for supplier"
        • },
      • "ForeignCurrency" : null,
      • "LastModified" : "2014-03-19T05:04:32.993",
      • "PhotoURI" : "{cf_uri}/Contact/Supplier/8654a102-4859-451f-834b-0ddb9bbf2edc/Photo",
      • "URI" : "{cf_uri}/Contact/Supplier/8654a102-4859-451f-834b-0ddb9bbf2edc",
      • "RowVersion" : "-3008686026060201984"
      • }
    • }
Hypermedia in the MYOB Business API

The {cf_uri} is provided by the Company File endpoint.

Read more about Hypermedia in the MYOB Business API in our best practice guide.