Item

Attribute Details

• UIDGuid (36)
• Unique guid identifier created for a item purchase order.
  ONLY required for updating an existing item purchase order.
  NOT required when creating a new item purchase order.
• Number String (13)
• Purchase order number
• DateDateTime
• Transaction date entry, format YYYY-MM-DD HH:MM:SS { 'Date': '2014-09-10 13:33:02' }
• SupplierInvoiceNumberString (255)
• Supplier invoice number.
• Supplier
• The following set of information pulls through details for the supplier contact
• • UIDGuid (36)
  • Foreign Key: Unique guid identifier belonging to the supplier contact assigned to the purchase order.
  • NameString (30)
  • Name of the supplier contact.
  • 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.
• ShipToAddressString (255)
• ShipTo address of the purchase order.
• Terms
• The following set of information pulls through supplier payment terms.
  
  Please note: When posting a new purchase bill, if you do not set the terms, default payment terms from the supplier 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 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.
  • 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 in foreign currency that will apply if payment is made in full by the discount date.
  • DueDateDateTime
  • Date in which payment is due, format YYYY-MM-DD HH:MM:SS { 'Date': '2014-09-10 00:00:00' }
• IsTaxInclusiveBoolean
• True indicates the transaction is tax inclusive with both UnitPrice and Total values to be keyed in tax-inclusive.
  
  False indicates the transaction is not tax inclusive with both UnitPrice and Total values to be keyed in tax-exclusive.
• Lines []
• An array of line order information
• • RowID Integer
  • Sequence of the entry within the item purchase set.
    REQUIRED only when passing the RowVersion for updating an existing item order line.
  • TypeString
  • Purchase order 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 purchase line.
  • BillQuantityDecimal (13.6)
  • The quantity of goods shipped.
  • ReceivedQuantityDecimal (13.6)
  • The quantity of goods received.
  • UnitPriceDecimal (13.6)
  • Unit price assigned to the item.
  • UnitPriceForeignDecimal (13.6)
  • Mandatory for a Foreign currency record : Unit price assigned to the item in foreign currency.
  • DiscountPercentDouble (99.99%)
  • Discount rate applicable to the line of the purchase order.
  • TotalDecimal (13.2)
  • Mandatory for a Local currency record : Total amount for the line item only.
  • TotalForeignDecimal (13.2)
  • Total amount for the line item only in foreign currency.
  • Item
  • The following set of information pulls through details for an Item
  • • UIDGuid (36)
    • Foreign Key: Unique identifier for item in the form of a guid.
    • NumberString (30)
    • Number assigned to the item.
    • NameString (30)
    • Name assigned to the item.
    • URIString
    • Uniform resource identifier associated with the item 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.
    • 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.
  • Location
  • The following set of information pulls through details for the item associated location./li>
  • • UIDGuid (36)
    • Foreign Key: Unique identifier for location in the form of a guid.
    • IdentifierString (10)
    • Identifier assigned to the location.
    • NameString (30)
    • Name assigned to the location.
    • URIString
    • Uniform resource identifier associated with the location object.
  • RowVersion String
  • ONLY required on PUT for updating an existing item purchase order line.
    NOT required when creating a new item purchase order.
• IsReportableBoolean
• ONLY APPLICABLE FOR AU REGION.
  True indicates the transaction is reportable taxable payment.
  False indicates the transaction is not reportable taxable payment.
  What are taxable payments?
• 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)
• If IsTaxInclusive = false then sum of all tax exclusive line amounts.
  If IsTaxInclusive = true then sum of all tax inclusive line amounts.
• FreightDecimal (13.2)
• Tax inclusive freight amount applicable to the purchase order.
• FreightForeignDecimal (13.2)
• Tax inclusive freight amount applicable to the purchase order 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 purchase order.
• TotalTaxForeignDecimal (13.2)
• Total of all tax amounts applicable to the purchase order in foreign currency.
• TotalAmountDecimal (13.2)
• Total amount of the purchase order.
• TotalAmountForeignDecimal (13.2)
• Total amount of the purchase order in Foreign Currency
• Category
• The following outlines the category information for the puchase order.
• • UID GUID (36)
  • Foreign Key: Unique guid identifier belonging to the category assigned to the purchase order.
  • 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
• CommentString (2000)
• Purchase order comment.
• ShippingMethodString (20)
• Shipping method text.
• JournalMemoString (255)
• Journal memo text describing the order.
• PromisedDateDateTime
• Transaction promised date, format YYYY-MM-DD HH:MM:SS { 'PromisedDate': '2014-12-12 00:00:00' }
• AppliedToDateDecimal (13.2)
• All amounts currently applied to the purchase order.
• AppliedToDateForeignDecimal (13.2)
• All amounts currently applied to the purchase order in foreign currency.
• OrderDeliveryStatusString (20)
• Order delivery status assigned:
  Print = ToBePrinted
  Email = ToBeEmailed
  PrintAndEmail = ToBePrintedAndEmailed
  Nothing = AlreadyPrintedOrSent
• BalanceDueAmountDecimal (13.2)
• Amount still payable on the purchase order.
• BalanceDueAmountForeignDecimal (13.2)
• Amount still payable on the purchase order in foreign currency.
• StatusString
• Order status can consist of the following:
  
  Open - If an order is paid in full, partially paid or has a negative amount, the status will always be set to Open
  
  ConvertedToBill - This status will only show if an order has been converted to a bill. Please note: once an order has been converted to a bill, you can no longer edit or delete the order, only retrieve it.
• LastPaymentDateDateTime
• The most recent order payment, format YYYY-MM-DD HH:MM:SS
• 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 in 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.
  ONLY required for updating an existing item purchase order.
  NOT required when creating a new item purchase order.

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