TicketRmaCredits
This entity describes the refund/credit charge that is created when the RMA is set as Authorized on a ticket with the RMA ticket category.
NOTE You can refer to the Online Help to find root and child access URLs of the entity you wish to query. Refer to Finding resource and child access URLs of REST API entities for more information.
Entity details
Entity Name: | TicketRmaCredits |
Entity Path: |
/atservicesrest/v1.0/TicketRmaCredits |
Parent Entity: |
|
Can Create: | |
Can Update: | |
Can Query: | |
Can Delete: | |
Can Have UDFs: |
Conditions and requirements
General
- This entity will be read-only if the module with which it is associated is not active. For more information, refer to Activations.
- Only one TicketRmaCredit can exist per ticket.
The fields that are not set through the API are configured as follows:
- Product: (No value)
- Material Code: RMA (see this view for details on this new system material code)
- Charge Name: "RMA Credit ({The product name of the asset of the RMA ticket}) ({That asset's ID})"
- Description: The value entered in the Credit Details field on the Request RMA page/dialog when the RMA ticket was created.
- Date Purchased: The current date
- Charge Type: Operational
- Purchase Order Number: the Purchase Order Number of the RMA ticket, if it has one.
- Status: Ready to Deliver/Ship
- Quantity: 1.00
- Unit Cost: 0.00
- Extended Cost: 0.00
- Unit Price: The value entered in the Credit Amount field on the Request RMA page/dialog when the RMA ticket was created, multiplied by -1
- Billable Amount: (The same as the Unit Price value above)
- Notes: the "Notes" field will be used to reference the original charge or quote item from which the asset was created. If such a charge or quote item does not exist, the field will be left blank. If it does exist, the field will be filled as follows:
- "Source of Refund
- Item Type: {type of item: Ticket Charge, Project Charge, Contract Charge, or Quote Item}
- {Associated item information (see below)}
- {Associated invoice information (see below)}
- Amount: {The Unit Price of the original charge/quote item}
- Date: {The create date of the original charge}"
Special field attributes
Field | Conditions and Requirements |
---|---|
creditAmount |
|
internalCurrencyCreditAmount | If multi-currency functionality is enabled for your database, the creditAmount is converted to your internal currency. If it is not enabled, it will match the value of the creditAmount field. |
creditDetails | This value will be used to set the description of the charge created when the associated ticket's RMA status is set to Authorized. |
ticketID |
A TicketRmaCredit may only be created with a given ticketID if the referenced ticket currently has the RMA ticket category. However, it may exist with the ticketID of a ticket that is no longer of ticket category "RMA", since the ticket category of an RMA ticket may be changed. Only one TicketRmaCredit can be associated with a ticket. |
Field definitions
The following table describes the standard Autotask fields for this entity. Refer to the following articles for more information about working with these fields:
- The entityInformation REST API call
- Making basic query calls to the REST API
- Advanced query features of the REST API
To learn how to query picklist endpoints, refer to Understanding picklists.
Notes
- For string datatypes, the number in parentheses ( ) indicates the maximum number of characters allowed.
- LT indicates Local Term.
- If this entity has child collections, they will appear in a Child collection access URLs or an Entity URLs and relationships drop-down in the Entity details section of this article.
- You can call the /query/count/ endpoint of a resource to determine how many records a collection holds.
Field Name | Datatype | Read-Only | Is Required | Reference Name | Picklist |
---|---|---|---|---|---|
creditAmount | decimal | ||||
creditDetails | text (2000) | ||||
id | integer | ||||
internalCurrencyCreditAmount | decimal | ||||
ticketID | integer | Tickets |