here - NetSuite
here - NetSuite
here - NetSuite
You also want an ePaper? Increase the reach of your titles
YUMPU automatically turns print PDFs into web optimized ePapers that Google loves.
Version 2009 Release 2 SuiteTalk (Web<br />
Services) Release Notes<br />
Revision Date: March 31, 2010<br />
This document summarizes the changes to SuiteTalk (Web Services) between Version 2009<br />
Release 2 and the previous release.<br />
Click links in the following table for details about product changes:<br />
Section<br />
SuiteTalk (Web Services) Integration<br />
Summary<br />
Records Exposed, getServerTime Operation Added, Changes to<br />
getSelectValue Operation, externalId Search Filter Added, Full<br />
Search Now Supported for Certain getAll Record Types, Web<br />
Services Usage Log Issue Resolved, Update to the Address<br />
Sublist, General Schema Updates, Araxis Merge Diff File for the<br />
2009.2 Endpoint, 2009.2 Schema Browser<br />
SuiteTalk (Web Services) Integration<br />
Refer to the following sections for details on all SuiteTalk Web services updates for Version<br />
2009 Release 2:<br />
• Records Exposed<br />
• getServerTime Operation Added<br />
• Changes to getSelectValue Operation<br />
• externalId Search Filter Added<br />
• Full Search Now Supported for Certain getAll Record Types<br />
• Web Services Usage Log Issue Resolved<br />
• Update to the Address Sublist<br />
• General Schema Updates<br />
• Araxis Merge Diff File for the 2009.2 Endpoint<br />
• 2009.2 Schema Browser<br />
Records Exposed<br />
The following records have been exposed in Web services:<br />
• Download Items<br />
Subject to Change
Version 2009 Release 2 SuiteTalk (Web Services) Release<br />
Notes<br />
186<br />
• Project Task<br />
getServerTime Operation Added<br />
The getServerTime operation has been added to the 2009.2 SuiteTalk platform. Developers can<br />
use this operation to identify new, changed, and deleted <strong>NetSuite</strong> records for synchronization<br />
with other applications. This operation takes no arguments and returns the <strong>NetSuite</strong> server<br />
time in GMT, regardless of a user’s time zone. Developers no longer have to rely on client time,<br />
which may not be in sync with <strong>NetSuite</strong> server time, when writing synchronization procedures.<br />
Changes to getSelectValue Operation<br />
The details regarding this operation are divided into the following categories:<br />
• Enhancements<br />
• Schema Changes<br />
• Coding Considerations<br />
Enhancements<br />
The following table provides a summary of all 2009.2 getSelectValue enhancements:<br />
Prior to 2009.2 Starting with 2009.2<br />
Only the first 1000 select options were returned for a<br />
select (RecordRef) field.<br />
Pagination was not available through getSelectValue.<br />
Select options could be filtered using only the contains<br />
search operator.<br />
You could not call getSelectValue on fields whose select<br />
options w<strong>here</strong> determined by the value of another<br />
field. For example, in a OneWorld account you could not<br />
get the select values of an Item field if those values had<br />
a dependency on the value of the Customer or<br />
Subsidiary fields.<br />
You could not use getSelectValue on enumerated static<br />
fields<br />
You could not use getSelectValue on custom fields.<br />
The first call to getSelectValue now returns the total number of<br />
select options for the specified field.<br />
Users can now specify a pageIndex value to return a subset of<br />
possible select options. See pageIndex Element Added in the<br />
Release Notes.<br />
getSelectValue now supports the filtering of select options using<br />
the contains, startsWith, or is operators. See<br />
GetSelectValueFilterOperator Added in the Release Notes.<br />
getSelectValue now allows you to specify a filterBy (“master”)<br />
field. You can specify the filterBy field if you want to get select<br />
values for a field that is dependent on the value of the filterBy<br />
field. See GetSelectFilterByFieldValue Added in the Release Notes.<br />
getSelectValue now returns select options for enumerated static<br />
fields. For example, the options available for the<br />
CalendarEvent.accessLevel field are now returned (_private,<br />
_public, _showAsBusy).<br />
getSelectValue now returns select options for custom fields.<br />
When the custom field appears on a custom record, you can get<br />
select values for the field by specifying the custom record ID and<br />
the custom field ID in the request.<br />
Subject to Change
Version 2009 Release 2 SuiteTalk (Web Services) Release<br />
Notes<br />
187<br />
Prior to 2009.2 Starting with 2009.2<br />
You could not use getSelectValue on custom records.<br />
When an item group had been added to the Items<br />
sublist, you could not use getSelectValue to return the<br />
“End of Group” value.<br />
Schema Changes<br />
Click each link for a summary of all schema changes related to the getSelectValue operation:<br />
• GetSelectValueType Removed<br />
• pageIndex Element Added<br />
• GetSelectValueFieldDescription Added<br />
• GetSelectValueFilter Added<br />
• GetSelectValueFilterOperator Added<br />
• GetSelectFilterByFieldValueList Added<br />
• GetSelectFilterByFieldValue Added<br />
GetSelectValueType Removed<br />
The simpleType GetSelectValueType has been removed from the 2009.2 endpoint. T<strong>here</strong>fore,<br />
calls to getSelectValue can no longer reference the enumeration values defined in this type. See<br />
Coding Considerations for what this means when upgrading to the 2009.2 point.<br />
pageIndex Element Added<br />
getSelectValue can now be used to get select options for<br />
CustomRecordRef fields that appear on custom and standard<br />
records.<br />
The value for End of Group is now returned when using<br />
getSelectValue.<br />
To support the pagination of select values in your response, the getSelectValueRequest object<br />
now includes a pageIndex element. Set the pageIndex value to control which set of values will<br />
be returned. See Coding Considerations for what this means when upgrading to the 2009.2<br />
point.<br />
<br />
<br />
<br />
<br />
<br />
<br />
GetSelectValueFieldDescription Added<br />
In endpoints prior to 2009.2, the getSelectValueRequest object contained a fieldName element<br />
of type GetSelectValueField. In 2009.2, the GetSelectValueField type has been removed, the<br />
Subject to Change
Version 2009 Release 2 SuiteTalk (Web Services) Release<br />
Notes<br />
188<br />
fieldName element has been renamed to fieldDescription, and fieldDescription now references<br />
the new GetSelectValueFieldDescription type.<br />
Before 2009.2:<br />
<br />
<br />
<br />
<br />
<br />
Starting with 2009.2:<br />
<br />
<br />
<br />
<br />
<br />
<br />
Use GetSelectValueFieldDescription to define all values for the RecordRef or<br />
CustomRecordRef select field. You will set the record type the field appears on, the name of the<br />
sublist (if the field appears on the sublist); the name of the field, as defined in the schema;<br />
(optionally) any customForm values (if the field appears on a custom form); a search operator<br />
for filtering the results (if desired); and any filterBy criteria that may be required if your field<br />
has a dependency on one or more other fields.<br />
<br />
<br />
<br />
<br />
<br />
<br />
<br />
<br />
<br />
<br />
<br />
GetSelectValueFilter Added<br />
The GetSelectValueFilter type has been added to allow you to specify which search operator to<br />
use for filtering your results. Notice the operator attribute references the new<br />
GetSelectValueFilterOperator type.<br />
<br />
<br />
<br />
<br />
Subject to Change
Version 2009 Release 2 SuiteTalk (Web Services) Release<br />
Notes<br />
189<br />
<br />
<br />
GetSelectValueFilterOperator Added<br />
The new GetSelectFilterOperator type defines all search operators available in a getSelectValue<br />
call.<br />
<br />
<br />
<br />
<br />
<br />
<br />
<br />
GetSelectFilterByFieldValueList Added<br />
The GetSelectFilterByFieldValueList type includes a filterBy element, which references the new<br />
GetSelectFilterByFieldValue type. Through the filterBy element you will pass all the values of<br />
the filterBy fields.<br />
<br />
<br />
<br />
<br />
<br />
GetSelectFilterByFieldValue Added<br />
The GetSelectFilterByFieldValue type allows you to specify all aspects of the filterBy field. The<br />
filterBy field is the field that controls which values are available for the dependent field. The<br />
dependent field is the field you want to get the values for.<br />
<br />
<br />
<br />
<br />
<br />
<br />
<br />
Subject to Change
Version 2009 Release 2 SuiteTalk (Web Services) Release<br />
Notes<br />
190<br />
Coding Considerations<br />
Users wishing to upgrade to the 2009.2 endpoint will be required to recode all existing calls to<br />
getSelectValue. With the removal of GetSelectValueType and all its enumerations, this sample<br />
code will no longer run against the 2009.2 endpoint:<br />
GetSelectValueField myGSVField = new GetSelectValueField();<br />
myGSVField.setFieldType(GetSelectValueType.calendarEvent_attendeeList_attendee);<br />
myGSVField.setSearchCriteria("Smith");<br />
c.getSelectValue(myGSVField);<br />
Instead, users will need to re-code such samples to look like the following:<br />
GetSelectValueFieldDescription myGSVField = new GetSelectValueFieldDescription();<br />
myGSVField.setRecordType(RecordType.calendarEvent);<br />
myGSVField.setSublist("attendeeList");<br />
myGSVField.setField("attendee");<br />
myGSVField.setFilter(new GetSelectValueFilter("Smith", GetSelectValueFilterOperator.contains));<br />
c.getSelectValue(myGSVField, 1); //value must be provided for pageIndex<br />
In the sample above, notice you must set the record type, sublist, and field names using three<br />
separate methods, rather than the single setFieldType() method that existed in pre-2009.2<br />
endpoints.<br />
Also notice that the setSearchCriteria() method has been replaced by setFilter(). Within<br />
setFilter() you must set the search string value and specify the search operator. Now that the<br />
contains, startsWith, and is operators are supported in the 2009.2 endpoint, you are required<br />
to specify which operator you want your data filtered by.<br />
Finally, all re-coding will require you to set a value for the getSelectValue pageIndex argument.<br />
To return all select options for a field, set pageIndex to 1 in your first call to getSelectValue.<br />
Note that pageIndex cannot be set to null.<br />
externalId Search Filter Added<br />
The externalId search filter has been added to SuiteTalk in the release. With the addition of<br />
this search filter, you can now search for records based on their externalId values. You can also<br />
search for records that have empty externalId fields, which as not supported prior to this<br />
release.<br />
Full Search Now Supported for Certain getAll Record Types<br />
All search operations are now supported for the following record types:<br />
• Accounting Period<br />
• Contact Category<br />
• Contact Role<br />
Subject to Change
Version 2009 Release 2 SuiteTalk (Web Services) Release<br />
Notes<br />
191<br />
• Customer Category<br />
• Customer Status<br />
• Expense Category<br />
• Job Status<br />
• Job Type<br />
• Note Type<br />
• Partner Category<br />
• Payment Method<br />
• Price Level<br />
• Sales Role<br />
• Term<br />
• Vendor Category<br />
• WinLoss Reason<br />
This means you no longer have to use the getAll operation to return all records of the types<br />
specified above. You can now tailor your searches using specific search filters and search return<br />
columns available to these record types.<br />
Note that these records have been removed from the GetAllRecordType type in the 2009.2<br />
endpoint. If you upgrade to 2009.2 from an older endpoint that used getAll for these records,<br />
you must recode your client to use the appropriate search interface.<br />
Web Services Usage Log Issue Resolved<br />
T<strong>here</strong> was an issue with the Web Services Usage Log that made page refresh inconsistent. At<br />
times, users needed to reset usage log filtering values to see the most recent log details. This<br />
issue has been resolved. Clicking the Refresh button on the Web Services Usage Log now<br />
consistently refreshes the page.<br />
Update to the Address Sublist<br />
The internalId field on the Address (addressbookList) sublist is now the sublist key. This<br />
change allows you to update the address list and maintain existing internal IDs.<br />
Note that in the 2009.1 endpoint t<strong>here</strong> was a bug that prevented developers from updating<br />
address entries using the address label field when replaceAll was set to FALSE. This issue has<br />
been resolved in the 2009.2 endpoint with the changes to the internalId field. Be aware that to<br />
make changes to the address list using the internalId field, you must upgrade to the 2009.2<br />
endpoint.<br />
Subject to Change
Version 2009 Release 2 SuiteTalk (Web Services) Release<br />
Notes<br />
192<br />
General Schema Updates<br />
The following table lists most of the updates that have been made to the 2009.2 endpoint. More<br />
changes may be added to this table. Any additional changes will be added to the table and<br />
recorded in the Documentation Revision History log, which is located in the <strong>NetSuite</strong> Help<br />
Center under Additional Resources > Documentation Revision History.<br />
Records, Types,<br />
Sublists<br />
Changed Fields /<br />
Removed Fields<br />
New Fields /<br />
Joined Searches<br />
Notes<br />
Account<br />
translationList<br />
AccountSearchBasic<br />
externalIdString<br />
AccountingPeriod<br />
closedOnDate<br />
closed<br />
arLocked<br />
apLocked<br />
payrollLocked<br />
AccountingPeriodSearch<br />
New complex type<br />
AccountingPeriodSearchA<br />
dvanced<br />
New complex type<br />
AccountingPeriodSearchB<br />
asic<br />
New complex type<br />
AccountingPeriodSearchR<br />
ow<br />
New complex type<br />
AccountingPeriodSearchR<br />
owBasic<br />
New complex type<br />
AccountTranslationList<br />
New complex type<br />
AssemblyItem<br />
excludeFromSitemap<br />
sitemapPriority<br />
transferPrice<br />
BaseRefList<br />
New complex type<br />
Subject to Change
Version 2009 Release 2 SuiteTalk (Web Services) Release<br />
Notes<br />
193<br />
Records, Types,<br />
Sublists<br />
Changed Fields /<br />
Removed Fields<br />
New Fields /<br />
Joined Searches<br />
Notes<br />
Budget<br />
Changed:<br />
periodamount1 to<br />
periodAmount1<br />
periodamount2 to<br />
periodAmount2<br />
periodamount3 to<br />
periodAmount3<br />
periodamount4 to<br />
periodAmount4<br />
periodamount5 to<br />
periodAmount5<br />
periodamount6 to<br />
periodAmount6<br />
periodamount7 to<br />
periodAmount7<br />
periodamount8 to<br />
periodAmount8<br />
periodamount9 to<br />
periodAmount9<br />
periodamount10 to<br />
periodAmount10<br />
periodamount11 to<br />
periodAmount11<br />
periodamount12 to<br />
periodAmount12<br />
budgetType<br />
currency<br />
BudgetBudgetType<br />
New simple type<br />
C alendarEvent<br />
recurrence<br />
CalendarEventSearch<br />
originatingLeadJoin<br />
Calenda rEventSear<br />
chBasic<br />
externalIdString<br />
message<br />
CalendarEventSearchRow<br />
originatingLeadJoin<br />
Calenda rEventSear<br />
chRowBasic<br />
message<br />
recurrence<br />
CampaignSearch<br />
originatingLeadJoin<br />
CampaignSearchRow<br />
originatingLeadJoin<br />
Subject to Change
Version 2009 Release 2 SuiteTalk (Web Services) Release<br />
Notes<br />
194<br />
Records, Types,<br />
Sublists<br />
Changed Fields /<br />
Removed Fields<br />
New Fields /<br />
Joined Searches<br />
Notes<br />
CashSale<br />
itemCostDiscount<br />
itemCostDiscrate<br />
itemCostDiscAmount<br />
itemCostTaxRate<br />
itemCostTaxRate2<br />
itemCostDiscTaxable<br />
itemCostTaxCode<br />
itemCostDiscTax1Amt<br />
itemCostDiscPrint<br />
expCostDiscount<br />
expCostDiscRate<br />
expCostDiscAmount<br />
expCostDiscTaxable<br />
expCostDiscprint<br />
expCostTaxRate1<br />
timeD iscount<br />
expCostTaxCode<br />
timeDiscRate<br />
expCostTaxRate2<br />
expCostDiscTax1Amt<br />
timeDiscAmount<br />
timeDiscTaxable<br />
timeDiscPrint<br />
timeTaxRate1<br />
timeTaxCode<br />
timeDiscTax1Amt<br />
timeTaxRate2<br />
CashSaleItemCost<br />
desc changed to memo<br />
item changed to<br />
itemCostCount<br />
quantity<br />
CashSaleTime<br />
desc changed to memo<br />
CheckLandedCostList<br />
New complex type<br />
ClassificationSearchBasic<br />
externalIdString<br />
ContactCategorySearch<br />
New complex type<br />
ContactCategorySearchAd<br />
vanced<br />
New complex type<br />
ContactCategorySearchBas<br />
ic<br />
New complex type<br />
ContactCategorySearchRo<br />
w<br />
New complex type<br />
ContactCategorySearchRo<br />
wBasic<br />
New complex type<br />
ContactRoleSearch<br />
New complex type<br />
ContactRoleSearchAdvanc<br />
ed<br />
New complex type<br />
ContactRoleSearchBasic<br />
New complex type<br />
Subject to Change
Version 2009 Release 2 SuiteTalk (Web Services) Release<br />
Notes<br />
195<br />
Records, Types,<br />
Sublists<br />
Changed Fields /<br />
Removed Fields<br />
New Fields /<br />
Joined Searches<br />
Notes<br />
ContactRoleSearchRow<br />
New complex type<br />
ContactRoleSearchRowBas<br />
ic<br />
New complex type<br />
ContactSearchBasic<br />
externalIdString<br />
CreditMemoApply<br />
date changed to applyDate<br />
CreditMemoItem<br />
binNumbers<br />
CrmCustomField<br />
globalSearch<br />
availableToSso<br />
showIssueChanges<br />
CurrencyLocale<br />
_bengali<br />
_haitian<br />
Customer<br />
buyingReason<br />
buyingTimeFrame<br />
estimatedBudget<br />
isBudgetApproved<br />
salesReadiness<br />
CustomerCategorySearch<br />
New complex type<br />
CustomerCategorySearchA<br />
dvanced<br />
New complex type<br />
CustomerCategorySearchB<br />
asic<br />
New complex type<br />
CustomerCategorySearchR<br />
ow<br />
New complex type<br />
CustomerCategorySearchR<br />
owBasic<br />
New complex type<br />
CustomerDeposit<br />
applyList<br />
CustomerDepositApply<br />
New complex type<br />
CustomerItemPricing<br />
price<br />
CustomerPaymentApply<br />
date changed to applyDate<br />
CustomerPaymentCredit<br />
date changed to creditDate<br />
CustomerPaymentDeposit<br />
date changed to depositDate<br />
CustomerRecordTypePerm<br />
issions<br />
searchResults<br />
CustomerRefundApply<br />
date changed to applyDate<br />
CustomerRefundDeposit<br />
date changed to depositDate<br />
CustomerSearch<br />
originatingLeadJoin<br />
Subject to Change
Version 2009 Release 2 SuiteTalk (Web Services) Release<br />
Notes<br />
196<br />
Records, Types,<br />
Sublists<br />
Changed Fields /<br />
Removed Fields<br />
New Fields /<br />
Joined Searches<br />
Notes<br />
CustomerSearchBasic<br />
buyingReason<br />
buyingTimeFrame<br />
conversionDate<br />
estimatedBudget<br />
externalIdString<br />
explicitConversion<br />
isBudgetApproved<br />
itemPricingUnitPrice<br />
salesReadiness<br />
CustomerSearchRow<br />
originatingLeadJoin<br />
CustomerSearchRowBasic<br />
buyingReason<br />
buyingTimeFrame<br />
conversionDate<br />
estimatedBudget<br />
explicitConversion<br />
isBudgetApproved<br />
itemPricingUnitPrice<br />
salesReadiness<br />
CustomerStatusSearch<br />
New complex type<br />
CustomerStatusSearchAdv<br />
anced<br />
New complex type<br />
CustomerStatusSearchRow<br />
Basic<br />
New complex type<br />
CustomerStatusSearchRow<br />
New complex type<br />
CustomerStatusSearchRow<br />
Basic<br />
New complex type<br />
CustomRecordCustomFiel<br />
d<br />
globalSearch<br />
roleRestrict<br />
CustomRecordSearchBasic<br />
externalIdString<br />
DeletedRecordType<br />
projectTask<br />
DepartmentSearchBasic<br />
externalIdString<br />
DepositApplicationApply<br />
date changed to applyDate<br />
DownloadItem<br />
New complex type<br />
Employee<br />
emergencyContactList<br />
ethnicity<br />
gender<br />
hrEducationList<br />
maritalStatus<br />
EmployeeEmergencyCont<br />
act<br />
New complex type<br />
EmployeeEmergencyCont<br />
act<br />
New complex type<br />
EmployeeHrEducation<br />
New complex type<br />
Subject to Change
Version 2009 Release 2 SuiteTalk (Web Services) Release<br />
Notes<br />
197<br />
Records, Types,<br />
Sublists<br />
Changed Fields /<br />
Removed Fields<br />
New Fields /<br />
Joined Searches<br />
Notes<br />
EmployeeHrEducationList<br />
New complex type<br />
EmployeeSearchBasic<br />
externalIdString<br />
EntityCustomField<br />
globalSearch<br />
availableToSso<br />
appliesToStatement<br />
appliesToPriceList<br />
EntityGroupSearchBasic<br />
externalIdString<br />
EntitySearchBasic<br />
externalIdString<br />
ExpenseCategory<br />
customFieldList<br />
customForm<br />
ExpenseCategorySearch<br />
New complex type<br />
ExpenseCategorySearchAd<br />
vanced<br />
New complex type<br />
ExpenseCategorySearchBa<br />
sic<br />
New complex type<br />
ExpenseCategorySearchRo<br />
w<br />
New complex type<br />
ExpenseCategorySearchRo<br />
wBasic<br />
New complex type<br />
File<br />
bundleable<br />
textFileEncoding<br />
FileSearchBasic<br />
externalIdString<br />
Folder<br />
subsidiary<br />
FolderSearchBasic<br />
externalIdString<br />
Subject to Change
Version 2009 Release 2 SuiteTalk (Web Services) Release<br />
Notes<br />
198<br />
Records, Types,<br />
Sublists<br />
GetAllRecordType<br />
GetSelectFilterByFieldValu<br />
e<br />
GetSelectFilterByFieldValu<br />
eList<br />
The following enumerations<br />
have been removed from this<br />
type:<br />
accountingPeriod<br />
contactCategory<br />
contactRole<br />
customerCategory<br />
customerStatus<br />
expenseCategory<br />
jobStatus<br />
jobType<br />
noteType<br />
partnerCategory<br />
paymentMethod<br />
priceLevel<br />
salesRole<br />
term<br />
vendorCategory<br />
winLossReason<br />
For additional details, see Full<br />
Search Now Supported for<br />
Certain getAll Record Types<br />
in the Release Notes.<br />
New complex type<br />
New complex type<br />
GetSelectValueField Removed Complex type removed<br />
GetSelectValueFieldDescri<br />
ption<br />
GetSelectValueFilter<br />
GetSelectValueFilterOperat<br />
or<br />
GetSelectValueFieldDescri<br />
pt ion<br />
GetSelectValueRequest<br />
GetSelectValueType<br />
GetServerTimeRequest<br />
GetServerTimeResponse<br />
GetServerTimeResult<br />
GiftCertificateItem<br />
Changed Fields /<br />
Removed Fields<br />
fieldName changed to<br />
fieldDescription<br />
Removed<br />
New Fields /<br />
Joined Searches<br />
pageIndex<br />
excludeFromSitemap<br />
sitemapPriority<br />
Notes<br />
New complex type<br />
New complex type<br />
New simple type<br />
New complex type<br />
New complex type<br />
New complex type<br />
New complex type<br />
New complex type<br />
Subject to Change
Version 2009 Release 2 SuiteTalk (Web Services) Release<br />
Notes<br />
199<br />
Records, Types,<br />
Sublists<br />
Changed Fields /<br />
Removed Fields<br />
New Fields /<br />
Joined Searches<br />
Notes<br />
InventoryItem<br />
excludeFromSitemap<br />
sitemapPriority<br />
transferPrice<br />
Invoice<br />
expCostTaxRate1<br />
expCostTaxRate2<br />
expCostTaxCode<br />
expCostDiscTax1Amt<br />
itemCostTaxRate1<br />
itemCostTaxRate2<br />
itemCostTaxCode<br />
itemCostDiscTax1Amt<br />
itemCostDiscPrint<br />
timeTaxRate1<br />
timeTaxRate2<br />
timeTaxCode<br />
timeDiscTax1Amt<br />
timeCostDiscPrint<br />
InvoiceItemCost<br />
desc changed to memo<br />
count changed to<br />
itemCostCount<br />
quantity<br />
InvoiceTime<br />
desc changed to memo<br />
ItemCustomField<br />
globalSearch<br />
availableToSso<br />
appliesToPriceList<br />
ItemFulfillment<br />
transferLocation<br />
ItemFulfillmentPackageFe<br />
dExPackagingFedEx<br />
_fedEx10kgBox<br />
_fedEx25kgBox<br />
ItemFulfillmentPackageUs<br />
psPackagingUsps<br />
_smallFlatRateBox<br />
_mediumFlatRateBox<br />
_largeFlatRateBox<br />
ItemOptionCustomField<br />
colTransferOrder<br />
ItemReceipt<br />
exchangeRate<br />
currencyName<br />
ItemSearch<br />
fileJoin<br />
ItemSearchBasic<br />
excludeFromSitemap<br />
externalIdString<br />
locat ionQuantit yInTransit<br />
sitemapPriority<br />
transferPrice<br />
webSi te<br />
ItemSearchRow<br />
fileJoin<br />
Subject to Change
Version 2009 Release 2 SuiteTalk (Web Services) Release<br />
Notes<br />
200<br />
Records, Types,<br />
Sublists<br />
Changed Fields /<br />
Removed Fields<br />
New Fields /<br />
Joined Searches<br />
Notes<br />
ItemSearchRowBasic<br />
locationReorderPoint changed<br />
to locationReOrderPoint<br />
reorderPoint changed to<br />
reOrderPoint<br />
excludeFromSitemap<br />
loc ationBinQu antityAvai<br />
lable<br />
locat ionQuantit yInTransit<br />
sitemapPriority<br />
transferPrice<br />
webSi te<br />
ItemType<br />
_downloadItem<br />
Job<br />
allowAllResourcesForTasks<br />
JobSearch<br />
projectTaskJoin<br />
JobSearchBasic<br />
externalIdString<br />
JobSearchRow<br />
projectTaskJoin<br />
JobStatusSearch<br />
New complex type<br />
JobStatusSearchAdvanced<br />
New complex type<br />
JobStatusSearchBasic<br />
New complex type<br />
JobStatusSearchRow<br />
New complex type<br />
JobStatusSearchRowBasic<br />
New complex type<br />
JobTypeSearch<br />
New complex type<br />
JobTypeSearchAdvanced<br />
New complex type<br />
JobTypeSearchBasic<br />
New complex type<br />
JobTypeSearchRow<br />
New complex type<br />
JobTypeSearchRowBasic<br />
New complex type<br />
KitItem<br />
excludeFromSitemap<br />
sitemapPriority<br />
LocationSearchBasic<br />
externalIdString<br />
LotNumberedAssemblyIte<br />
m<br />
excludeFromSitemap<br />
sitemapPriority<br />
transferPrice<br />
LotNumberedInventoryIte<br />
m<br />
excludeFromSitemap<br />
sitemapPriority<br />
transferPrice<br />
MessageSearch<br />
originatingLeadJoin<br />
MessageSearchBasic<br />
externalIdString<br />
MessageSearchRow<br />
originatingLeadJoin<br />
NonInventoryResaleItem<br />
excludeFromSitemap<br />
sitemapPriority<br />
NonInventorySaleItem<br />
excludeFromSitemap<br />
sitemapPriority<br />
NoteSearch<br />
originatingLeadJoin<br />
Subject to Change
Version 2009 Release 2 SuiteTalk (Web Services) Release<br />
Notes<br />
201<br />
Records, Types,<br />
Sublists<br />
Changed Fields /<br />
Removed Fields<br />
New Fields /<br />
Joined Searches<br />
Notes<br />
NoteSearchBasic<br />
externalIdString<br />
NoteSearchRow<br />
originatingLeadJoin<br />
NoteTypeSearch<br />
New complex type<br />
NoteTypeSearchAdvanced<br />
New complex type<br />
NoteTypeSearchBasic<br />
New complex type<br />
NoteTypeSearchRow<br />
New complex type<br />
NoteTypeSearchRowBasic<br />
New complex type<br />
Opportunity<br />
buyingReason<br />
buyingTimeFrame<br />
estimatedBudget<br />
isBudgetApproved<br />
salesReadiness<br />
OpportunitySearch<br />
originatingLeadJoin<br />
OpportunitySearchBasic<br />
buyingReason<br />
buyingTimeFrame<br />
estimatedBudget<br />
externalIdString<br />
isBudgetApproved<br />
salesReadiness<br />
OpportunitySearchRow<br />
originatingLeadJoin<br />
OpportunitySearchRowBas<br />
ic<br />
buyingReason<br />
buyingTimeFrame<br />
estimatedBudget<br />
isBudgetApproved<br />
salesReadiness<br />
OriginatingLeadSearch<br />
New complex type<br />
OriginatingLeadSearchBasi<br />
c<br />
New complex type<br />
OriginatingLeadSearchRo<br />
w<br />
New complex type<br />
OriginatingLeadSearchRo<br />
wBasic<br />
New complex type<br />
PartnerCategorySearch<br />
New complex type<br />
PartnerCategorySearchAdv<br />
anced<br />
New complex type<br />
PartnerCategorySearchBas<br />
ic<br />
New complex type<br />
PartnerCategorySearchRo<br />
w<br />
New complex type<br />
PartnerCategorySearchRo<br />
wBasic<br />
New complex type<br />
PartnerSearchBasic<br />
externalIdString<br />
Subject to Change
Version 2009 Release 2 SuiteTalk (Web Services) Release<br />
Notes<br />
202<br />
Records, Types,<br />
Sublists<br />
Changed Fields /<br />
Removed Fields<br />
New Fields /<br />
Joined Searches<br />
Notes<br />
PaymentMethodSearch<br />
New complex type<br />
PaymentMethodSearchAd<br />
vanced<br />
New complex type<br />
PaymentMethodSearchBas<br />
ic<br />
New complex type<br />
PaymentMethodSearchRo<br />
w<br />
New complex type<br />
PaymentMethodSearchRo<br />
wBasic<br />
New complex type<br />
PermissionCode<br />
_fulfillSalesOrders changed to<br />
_fulfillOrders<br />
_receiveItems changed to<br />
_receiveOrder<br />
Removed:<br />
_shipItems<br />
_itemFulfillment<br />
_itemReceipt<br />
_recognizeGiftCertificateInco<br />
me<br />
_suiteSignon<br />
_transferOrder<br />
_transferOrderApproval<br />
PhoneCallSearch<br />
originatingLeadJoin<br />
PhoneCallSearchBasic<br />
externalIdString<br />
PhoneCallSearchRow<br />
originatingLeadJoin<br />
PriceLevelSearch<br />
New complex type<br />
PriceLevelSearchAdvanced<br />
New complex type<br />
PriceLevelSearchBasic<br />
New complex type<br />
PriceLevelSearchRow<br />
New complex type<br />
PriceLevelSearchRowBasic<br />
New complex type<br />
ProjectTask<br />
New complex type<br />
ProjectTaskAssignee<br />
New complex type<br />
ProjectTaskAssigneeList<br />
New complex type<br />
ProjectTaskAssignmentSea<br />
rchBasic<br />
New complext type<br />
ProjectTaskAssignmentSea<br />
rchRowBasic<br />
New complext type<br />
ProjectTaskPredecessor<br />
New complex type<br />
ProjectTaskPredecessorList<br />
New complex type<br />
ProjectTaskPredecessorPre<br />
decessorType<br />
New simple type<br />
ProjectT askPriorit y<br />
New simple type<br />
ProjectTaskSearchAdvance<br />
d<br />
New complex type<br />
Project TaskSearchBasic<br />
New complext type<br />
Subject to Change
Version 2009 Release 2 SuiteTalk (Web Services) Release<br />
Notes<br />
203<br />
Records, Types,<br />
Sublists<br />
Changed Fields /<br />
Removed Fields<br />
New Fields /<br />
Joined Searches<br />
Notes<br />
Project<br />
TaskSearchRowBasic<br />
New complext type<br />
ProjectTaskStatus<br />
New simple type<br />
ProjectTaskConstraintType<br />
New simple type<br />
ProjectTaskSearchRow<br />
New complex type<br />
PromotionCode<br />
currencyList<br />
freeShipMethod<br />
minimumOrderAmount<br />
PromotionCodeCurrency<br />
New complex type<br />
PromotionCodeCurrencyLi<br />
st<br />
New complex type<br />
PurchLandedCostList<br />
New complex type<br />
RecordType<br />
downloadItem<br />
projectTask<br />
SalesRoleSearch<br />
New complex type<br />
SalesRoleSearchAdvanced<br />
New complex type<br />
SalesRoleSearchBasic<br />
New complex type<br />
SalesRoleSearchRow<br />
New complex type<br />
SalesRoleSearchRowBasic<br />
New complex type<br />
SearchRecordType<br />
accountingPeriod<br />
projectTask<br />
SerializedAssemblyItem<br />
excludeFromSitemap<br />
sitemapPriority<br />
transferPrice<br />
SerializedInventoryItem<br />
excludeFromSitemap<br />
sitemapPriority<br />
transferPrice<br />
ServiceResaleItem<br />
excludeFromSitemap<br />
sitemapPriority<br />
ServiceSaleItem<br />
excludeFromSitemap<br />
sitemapPriority<br />
SiteCategory<br />
excludeFromSitemap<br />
sitemapPriority<br />
SiteCat egorySearc hBasic<br />
excludeFromSitemap<br />
extermalIdString<br />
sitemapPriority<br />
SiteCat egorySearc<br />
hRowBasic<br />
excludeFromSitemap<br />
sitemapPriority<br />
SitemapPriority<br />
New simple type<br />
SolutionSearchBasic<br />
externalIdString<br />
Subject to Change
Version 2009 Release 2 SuiteTalk (Web Services) Release<br />
Notes<br />
204<br />
Records, Types,<br />
Sublists<br />
Changed Fields /<br />
Removed Fields<br />
New Fields /<br />
Joined Searches<br />
Notes<br />
Subsidiary<br />
interCoAccount<br />
SubsidiarySearchBasic<br />
email<br />
externalIdString<br />
fax<br />
isElimination<br />
legalName<br />
phone<br />
taxIdNum<br />
tranPrefix<br />
url<br />
SubsidiarySearchRowBasic<br />
email<br />
fax<br />
isElimination<br />
legalName<br />
phone<br />
taxIdNum<br />
tranPrefix<br />
url<br />
SupportCaseSearchBasic<br />
externalIdString<br />
TaskSearch<br />
originatingLeadJoin<br />
TaskSearchBasic<br />
externalIdString<br />
TaskSearchRow<br />
originatingLeadJoin<br />
TaskSearchRowBasic<br />
markDone changed to<br />
markdone<br />
TaxGroup<br />
includeChildren<br />
TermSearch<br />
New complex type<br />
TermSearchAdvanced<br />
New complex type<br />
TermSearchBasic<br />
New complex type<br />
TermSearchRow<br />
New complex type<br />
TermSearchRowBasic<br />
New complex type<br />
TextFileEncoding<br />
New simple type<br />
TimeBill<br />
type changed to timeType<br />
TimeBillSearch<br />
projectTaskJoin<br />
TimeBillSearchBasic<br />
externalIdString<br />
TimeBillSearchRow<br />
projectTaskJoin<br />
TimeBillTimeType<br />
simple type name<br />
TimeBillType changed to<br />
TimeBillTimeType<br />
TopicSearchBasic<br />
externalIdString<br />
TransactionBodyCustomFi<br />
eld<br />
globalSearch<br />
availableToSso<br />
bodyTransferOrder<br />
Subject to Change
Version 2009 Release 2 SuiteTalk (Web Services) Release<br />
Notes<br />
205<br />
Records, Types,<br />
Sublists<br />
Changed Fields /<br />
Removed Fields<br />
New Fields /<br />
Joined Searches<br />
Notes<br />
TransactionColumnCusto<br />
mField<br />
availableToSso<br />
colTransferOrder<br />
TransactionLinkType<br />
_intercompanyAdjustment<br />
TransactionSearch<br />
accountingPeriodJoin<br />
expenseCategoryJoin<br />
TransactionSearchBasic<br />
built<br />
expenseCategory<br />
externalIdString<br />
isIntercompanyAdjustment<br />
trans ferLocatio n<br />
trans ferOrderLi neType<br />
trans ferOrderQu<br />
antityComm itted<br />
trans ferOrderQu antityPack<br />
ed<br />
trans ferOrderQu antityPick<br />
ed<br />
trans ferOrderQu antityRece<br />
ived<br />
trans ferOrderQu antityShip<br />
ped<br />
TransactionSearchRow<br />
accountingPeriodJoin<br />
expenseCategoryJoin<br />
TransactionSearchRowBasi<br />
c<br />
built<br />
estGrossProfitPercent<br />
expenseCategory<br />
isIntercompanyAdjustment<br />
totalCostEstimate<br />
trans ferLocatio n<br />
trans ferOrderLi neType<br />
tra nsferOrder ItemLine<br />
trans ferOrderQu<br />
antityComm itted<br />
trans ferOrderQu antityPack<br />
ed<br />
trans ferOrderQu antityPick<br />
ed<br />
trans ferOrderQu antityRece<br />
ived<br />
trans ferOrderQu antityShip<br />
ped<br />
Subject to Change
Version 2009 Release 2 SuiteTalk (Web Services) Release<br />
Notes<br />
206<br />
Records, Types,<br />
Sublists<br />
Changed Fields /<br />
Removed Fields<br />
New Fields /<br />
Joined Searches<br />
Notes<br />
TransactionStatus<br />
_transferOrderClosed<br />
_transferOrderPartiallyFulfille<br />
d<br />
_transferOrderPendingAppr<br />
oval<br />
_transferOrderPend ingFulfill<br />
ment<br />
_transferOrderPendingRecei<br />
pt<br />
_transferOrderPendingRecei<br />
ptPartiallyFulfilled<br />
_transferOrderReceived<br />
_transferOrderRejected<br />
TransactionTransferOrderLi<br />
neType<br />
New simple type<br />
VendorCategorySearch<br />
New complex type<br />
VendorCategorySearchAdv<br />
anced<br />
New complex type<br />
VendorCategorySearchBasi<br />
c<br />
New complex type<br />
VendorCategorySearchRo<br />
w<br />
New complex type<br />
VendorCategorySearchRo<br />
wBasic<br />
New complex type<br />
VendorPaymentApply<br />
date changed to applyDate<br />
VendorPaymentCredit<br />
date changed to creditDate<br />
VendorSearchBasic<br />
externalIdString<br />
WinLossReasonSearch<br />
New complex type<br />
WinLossReasonSearchAdv<br />
anced<br />
New complex type<br />
WinLossReasonSearchBasi<br />
c<br />
New complex type<br />
WinLossReasonSearchRow<br />
New complex type<br />
WinLossReasonSearchRow<br />
Basic<br />
New complex type<br />
Important: You can also view all changes between the 2009.1 WSDL and the 2009.2<br />
WSDL by looking at a diff file that is automatically generated from Araxis. In<br />
the Release Notes, see Araxis Merge Diff File for the 2009.2 Endpoint for<br />
details.<br />
Subject to Change
Version 2009 Release 2 SuiteTalk (Web Services) Release<br />
Notes<br />
207<br />
Araxis Merge Diff File for the 2009.2 Endpoint<br />
The Araxis Merge 2009.2 Diff file highlights all 2009.1 - 2009.2 schema changes. Depending on<br />
the scope of the release, these changes may include:<br />
• New record types<br />
• Elements (fields) that have been added, removed or changed since 2009.1<br />
• New sublists (lists)<br />
• New joins<br />
• New search filters and search return columns<br />
• New platform operations<br />
Using the Araxis Diff File<br />
Important: The figures in this section are for illustrative purposes only. They do NOT<br />
reflect schema changes related to any specific endpoint.<br />
The SuiteTalk diff file is generated using Araxis Merge. The following figure shows an Araxis<br />
Merge Comparison Report, which is a summary page that highlights all schemas that have<br />
been modified for a release. Diff files that are attached to <strong>NetSuite</strong> Release Notes will always<br />
open to the summary page.<br />
Schemas that are highlighted in blue have been modified. Click individual schema links or a<br />
Report link to see all changes to a particular schema.<br />
This column represents the<br />
previous endpoint.<br />
This column represents the<br />
newest endpoint.<br />
Click the Report links to<br />
see the differences.<br />
Subject to Change
Version 2009 Release 2 SuiteTalk (Web Services) Release<br />
Notes<br />
208<br />
The following figure shows a snapshot of documents.fileCabinet.xsd. The elements<br />
highlighted in green are the changed elements. This figure shows:<br />
• The mediaFile element has been added to the new endpoint.<br />
• The isFeatured element that existed in the previous endpoint been deprecated in the<br />
new endpoint.<br />
This column represents the<br />
previous endpoint.<br />
This column represents the<br />
newest endpoint.<br />
The Araxis Merge 2009.2 Diff file also includes data type changes. The following is a snapshot<br />
of activities.scheduling.xsd. This figure shows:<br />
• The data types for the estimatedTime, estimatedTimeOverride, actualTime, and<br />
timeRemaining elements have changed from dateTime to Duration.<br />
2009.2 Schema Browser<br />
The 2009.2 version of the SuiteTalk Schema Browser has been generated and is available <strong>here</strong>.<br />
You can also access the 2009.2 Schema Browser by:<br />
• Clicking links to the Schema Browser that are provided with each record in the<br />
SuiteTalk (Web Services) Records Guide<br />
• Opening the <strong>NetSuite</strong> Help Center and navigating to SuiteFlex (Customization,<br />
Scripting, and WebServices) > SuiteTalk (Web Services) > SuiteTalk Schema Browser<br />
Version 2009.2. The link to the Schema Browser appears in the main Help window.<br />
Subject to Change