SupplierPayment

Return, create and delete supplier payments

Date Released: Sep 2013 Date Updated: Jan 2022
URLSupports
/{cf_uri}/Purchase/SupplierPayment GET |  PUT |  POST |  DELETE
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 SupplierPayment. 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 guid identifier created for a supplier payment.
  • PayFromString
  • If allocating a banking account for the payment specify Account
    If using electronic payments specify ElectronicPayments
    What are electronic payments?
  • Account
  • The following set of information pulls through details for the Account
    • UIDGuid (36)
    • Please note: Passing the Account UID is optional if you are assigning ElectronicPayments, if allocating a bank account the UID is required.

      Foreign Key: Unique identifier for the account in the form of a guid.
    • NameString (30)
    • Account name belonging to the account record.
    • DisplayIDString (6)
    • Account code format includes separator ie 1-1100{ 'DisplayID': '1-1100' }
    • URIString
    • Uniform resource identifier associated with the account object.
  • Supplier
  • The following set of information pulls through details for the Supplier contact
    • UIDGuid (36)
    • Foreign Key: Unique guid identifier belonging to the supplier assigned to the supplier payment.
    • NameString (30)
    • Name of the supplier.
    • DisplayIDString (15)
    • Supplier contact Card ID, can also be used as a unique supplier contact identifier.
    • URIString
    • Uniform resource identifier associated with the supplier object.
  • PayeeAddressString (255)
  • Payee name and address of the supplier contact.
  • StatementParticularsString
  • ONLY applicable for Electronic Payments.
    Particulars attached to electronic payment.
    What are electronic payments?
  • StatementCodeString
  • ONLY APPLICABLE FOR NZ REGION.
    Code attached to electronic payment.
  • StatementReferenceString
  • ONLY APPLICABLE FOR NZ REGION.
    Reference attached to electronic payment.
  • PaymentNumber String (8)
  • ID No of payment transaction
  • DateDateTime
  • Transaction date entry, format YYYY-MM-DD HH:MM:SS { 'Date': '2013-08-11 13:33:02' }
  • AmountPaidDecimal (13.2)
  • Total of all amounts paid to the purchase bill/bills.
  • AmountPaidForeignDecimal (13.2)
  • Total of all amounts paid to the purchase bill/bills in foreign currency.
  • Memo String (255)
  • Memo text of the supplier payment entry.
  • Lines []
  • An array of purchase bill/order line information
    • RowId Integer
    • Sequence of the entry within the supplier payment set.
    • TypeString
    • Purchase type, can consist of the following:
      Bill
      Order
    • Purchase
    • The following set of information pulls through details for the Purchase Bill or Order
      • UIDGuid (36)
      • Foreign Key: Unique guid identifier belonging to the supplier purchase bill or order.
      • Number String (8)
      • Purchase bill/order number
      • URIString
      • Uniform resource identifier associated with the purchase bill/order object.
    • AmountAppliedDecimal (13.2)
    • Mandatory for a Local currency record : Amount applied to the purchase bill or order
    • AmountAppliedForeignDecimal (13.2)
    • Mandatory for a Foreign currency record : Amount applied to the purchase bill or order in foreign currency.
    • RowVersion String
    • Incrementing number that can be used for change control but does does not preserve a date or a time.
  • DeliveryStatusString (20)
  • Delivery status assigned to payment:
    Print = ToBePrinted
    Email = ToBeEmailed
    PrintAndEmail = ToBePrintedAndEmailed
    Nothing = AlreadyPrintedOrSent
  • ForeignCurrency
  • Foreign currency information in the transaction.
    • UIDGuid (36)
    • Foreign Key: Unique identifier for the currency in the form of a guid.
    • CodeString (3)
    • The currency code.
    • CurrencyNameString
    • The full name of the currency
    • URIString
    • Uniform resource identifier associated with the currency object.
  • CurrencyExchangeRateDecimal
  • Currency exchange rate for the associated currency object.
  • 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.


Paging: default page size is set to 400 with a maximum of 1000 results.

Example json GET response

  • {
  • "UID" : "7976deea-7c9c-4fe5-bd63-2131ff541337",
  • "PayFrom" : "Account",
  • "Account" : {
    • "UID" : "7772dc25-5ee6-4a61-994e-28c04b8a35fc",
    • "Name" : "General Cheque Account 1",
    • "DisplayID" : "1-1110",
    • "URI" : "{cf_uri}/GeneralLedger/Account/7772dc25-5ee6-4a61-994e-28c04b8a35fc"
    • },
  • "Supplier" : {
    • "UID" : "a96f1ee9-af79-4f9e-93bf-6b12e2676b90",
    • "Name" : "Curbys Super Stands",
    • "DisplayID" : "SUPP000003",
    • "URI" : "{cf_uri}/Contact/Supplier/a96f1ee9-af79-4f9e-93bf-6b12e2676b90"
    • },
  • "PayeeAddress" : "Curbys Super Stands 67 Mountain Road Leura NSW 2477 Australia",
  • "StatementParticulars" : "",
  • "PaymentNumber" : "106",
  • "Date" : "2013-10-03T00:00:00",
  • "AmountPaid" : 69.95,
  • "AmountPaidForeign" : null,
  • "Memo" : "Curbys Super Stands for PJ000009",
  • "Lines" : [
    • {
  • "RowID" : 403,
  • "Type" : "Bill",
  • "Purchase" : {
    • "UID" : "8d757d45-a1c9-41b2-9b02-5c149f7d3979",
    • "Number" : "PJ000009",
    • "URI" : "{cf_uri}/Purchase/Bill/Miscellaneous/8d757d45-a1c9-41b2-9b02-5c149f7d3979"
    • },
  • "AmountApplied" : 69.95,
  • "AmountAppliedForeign" : null,
  • "RowVersion" : "5295670211834282000"
  • }
  • ],
  • "DeliveryStatus" : "Print",
  • "ForeignCurrency" : null,
  • "CurrencyExchangeRate" : null,
  • "URI" : "{cf_uri}/Purchase/SupplierPayment/7976deea-7c9c-4fe5-bd63-2131ff541337",
  • "RowVersion" : "5223612617796354048"
  • }
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.