Service

Attribute Details

• UIDGuid (36)
• Unique guid identifier created for a service sale invoice.
  ONLY required for updating an existing service sale invoice.
  NOT required when creating a new service sale invoice.
• Number String (13)
• Sale invoice number
• DateDateTime
• Transaction date entry, format YYYY-MM-DD HH:MM:SS { 'Date': '2013-09-10 13:33:02' }
• CustomerPurchaseOrderNumberString (255)
• Customer PO number.
• Customer
• The following set of information pulls through details for the Customer contact
• • UIDGuid (36)
  • Foreign Key: Unique guid identifier belonging to the customer assigned to the service sale.
  • NameString (50)
  • Name of the customer.
  • DisplayIDString (15)
  • Customer contact Card ID, can also be used as a unique customer contact identifier.
  • URIString
  • Uniform resource identifier associated with the customer object.
• PromisedDateDateTime
• Transaction promised date, format YYYY-MM-DD HH:MM:SS { 'PromisedDate': '2013-11-12 13:33:02' }
• BalanceDueAmountDecimal (13.2)
• Amount still payable on the sale invoice.
• BalanceDueAmountForeignDecimal (13.2)
• Foreign Currency amount still payable on the sale invoice.
• StatusString
• Invoice status:
  Open
  Closed
  Credit
  
• Lines []
• An array of line invoice information
• • RowID Integer
  • Sequence of the entry within the service sale set.
    REQUIRED only when passing the RowVersion for updating an existing service sale line.
  • TypeString
  • Invoice line type, can consist of the following:
    Transaction - All fields detailed in Lines array are consumable.
    Header - Only allows you to POST to Description element.
    Subtotal - Calculated value that is read-only.
  • DescriptionString (1000)
  • Description text for the sale line.
  • UnitsOfMeasureString (5)
  • Unit of measure assigned to the service.
  • UnitCountDecimal (13.6)
  • ONLY required when using UnitPrice on the sale line : Unit count assigned to the service.
  • UnitPriceDecimal (13.6)
  • ONLY required when using UnitCount on the sale line : Unit price assigned to the service.
  • UnitPriceForeignDecimal (13.2)
  • ONLY required when using UnitCount on the foreign currency sale line: Unit price assigned to the service in foreign currency
  • DiscountPercentDouble (99.99%)
  • Discount rate applicable to the line of the sale invoice.
  • TotalDecimal (13.2)
  • Mandatory for a Local currency record : Dollar amount for each individual line.
  • TotalForeignDecimal (13.2)
  • Mandatory for a Foreign currency record : Total amount for the line item only.
  • Account
  • The following set of information pulls through details for an Account
  • • UIDGuid (36)
    • Foreign Key: Unique identifier for the account in the form of a guid.
    • NameString (60)
    • Account name belonging to the account record.
    • DisplayIDString (6)
    • Account code format includes separator ie 1-1100{ 'DisplayID': '1-1200' }
    • URIString
    • Uniform resource identifier associated with the account object.
  • Job
  • The following set of information pulls through the details for a job
  • • UID GUID (36)
    • Foreign Key: Unique guid identifier belonging to the job for the line of the service sale.
    • Number String (30)
    • Number assigned to the job
    • Name String (30)
    • Name assigned to the job
    • URI String
    • Uniform resource identifier associated with the job object
  • TaxCode
  • The following set of information pulls through the details for the Tax Code
  • • 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.
  • RowVersion String
  • ONLY required on PUT for updating an existing service invoice line.
    NOT required when creating a new service sale invoice.
• ShipToAddressString (255)
• ShipTo address of the sale invoice.
• Terms
• The following set of information pulls through customer payment terms.
  
  Please note: When posting a new sale invoice, if you do not set the terms, default payment terms from the customer contact card will be substituted instead.
• • 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 the customer must pay 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 the customer has to pay invoices.
    
    If PaymentIsDue = OnADayOfTheMonth or DayOfMonthAfterEOM then set the day of the month within which the payment must be made to pay invoices.
  • DiscountForEarlyPayment Double (99.99%)
  • % discount for early payment.
  • MonthlyChargeForLatePayment Double (99.99%)
  • % monthly charge for late payment.
  • DiscountExpiryDateDateTime
  • Date in which payment must be paid in full in order to receive discount, format YYYY-MM-DD HH:MM:SS { 'Date': '2013-09-10 00:00:00' }
  • DiscountDecimal (13.2)
  • Discount amount that will apply if payment is made in full by the discount date.
  • DiscountForeignDecimal (13.2)
  • Discount amount that will apply if payment is made in full by the discount date in Foreign Currency
  • DueDateDateTime
  • Date in which payment is due, format YYYY-MM-DD HH:MM:SS { 'Date': '2014-09-10 00:00:00' }
  • FinanceChargeDecimal (13.2)
  • Late payment fee to be charged if payment is not made in full by the due date.
  • FinanceChargeForeignDecimal (13.2)
  • Late payment fee to be charged if payment is not made in full by the due date in Foreign Currency
• IsTaxInclusiveBoolean
• True indicates the transaction is tax inclusive with Total values to be keyed in tax-inclusive.
  
  False indicates the transaction is not tax inclusive with Total values to be keyed in tax-exclusive.
• SubtotalDecimal (13.2)
• If IsTaxInclusive = false then sum of all tax exclusive line amounts.
  If IsTaxInclusive = true then sum of all tax inclusive line amounts.
• SubtotalForeignDecimal (13.2)
• Subtotal of the Invoice lines in Foreign Currency.
• FreightDecimal (13.2)
• Freight applicable to the sale invoice.
• FreightForeignDecimal (13.2)
• Amount for freight applicable to the sale invoice in Foreign Currency
• 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.
• TotalTaxDecimal (13.2)
• Total of all tax amounts applicable to the sale invoice.
• TotalTaxForeignDecimal (13.2)
• Total of all tax amounts applicable to the sale invoice in Foreign Currency.
• TotalAmountDecimal (13.2)
• Total amount of the sale invoice.
• TotalAmountForeignDecimal (13.2)
• Total amount of the sale invoice in Foreign Currency
• Category
• The following outlines category information for the sale service invoice.
• • UID GUID (36)
  • Foreign Key: Unique guid identifier belonging to the category assigned to the sale invoice
  • Name String (30)
  • Name of the category
  • DisplayID String (15)
  • Display id for the category
  • URI String
  • Uniform resource identifier associated with the category object
• Salesperson
• The following set of information pulls through details for the an employee contact.
• • UIDGuid (36)
  • Foreign Key: Unique employee contact identifier in the form of a guid.
  • NameString (30)
  • Selected employee contact name.
  • DisplayIDString (15)
  • Employee contact Card ID, can also be used as a unique employee contact identifier.
  • URIString
  • Uniform resource identifier associated with the employee contact object.
• CommentString (2000)
• Sale invoice comment.
• ShippingMethodString (20)
• Shipping method text.
• JournalMemoString (255)
• Journal memo text describing the sale.
• ReferralSourceString (20)
• Referral Source selected on the sale invoice.
• InvoiceDeliveryStatusString (20)
• Invoice delivery status assigned:
  Print = ToBePrinted
  Email = ToBeEmailed
  PrintAndEmail = ToBePrintedAndEmailed
  Nothing = AlreadyPrintedOrSent
  
• LastPaymentDateDateTime
• The most recent invoice payment, format YYYY-MM-DD HH:MM:SS
• CanApplySurchargeBoolean
• This flag enables/disables surcharging at the invoice level when payment is made via MYOB Online Invoice Payments for users registered for Surcharging.
• Order
• REQUIRED ONLY if converting an existing order to an invoice. Fore details visit here.
  Please note: This field will default to null for any new invoice created without an order conversion.
• • UIDGuid (36)
  • Foreign Key: Unique sale order identifier in the form of a guid. Required when converting Order to Invoice
  • NumberString (8)
  • Sales order number.
  • URIString
  • Uniform resource identifier associated with the sale order object.
• OnlinePaymentMethodString
• Which Online Payment Methods should be turned on for this resource. Values can be 'All' or 'None'
• ForeignCurrency
• Null if no foreign currency is set.
• • 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 (13.2)
• The exchange rate between the Local and Foreign currency
• LastModifiedDateTime
• DateTime of the last time this resource was modified through a direct action to the object. eg a field was updated.
• 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 service sale invoice.
  NOT required when creating a new service sale invoice.

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