Authorized Acquisitions -

Technical Design Document

Client: Authorized Acquisitions

Author: Ume-Hani Usman

[Mention name who initiated this document]

Release Date: 21/Nov/2022

[Date when this document is handed over to devs]

Estimate / WBS Sheet: https://docs.google.com/spreadsheets/d/1JMlvsGKotvqvR

[link to a google sheet ] wwrtS6XrL4wJJmrKk-dbc-iIXe_Kkg/edit#gid=600808496

Bitbucket: https://bitbucket.org/folio3/f3-ns-unified-connector-custo
[To be added after setup] mizations/src/authorized-aquistions/

Basecamp / JIRA: https://folio3.atlassian.net/jira/software/c/projects/NAAEC

[To be added after setup] /boards/828?selectedIssue=NAAEC-38

Intended Audience: DEV

[Dev Only / Dev & QA]
 Revision History

Date Version Contributor Changes

21/Nov/22 1.0 Ume-Hani Usman Initial Document Setup

28/Nov/22 1.1 Ume-Hani Usman Additional Item Export Features

TABLE OF CONTENTS

Task-01: Use customer eBay ID as primary identifier instead of Email

Business Requirement
Proposed Solution
Overview
Expected Inputs / Outputs
Components

Task-02: Exclude Tax Amount in NS Sales Order

When importing/creating eBay orders in NetSuite, the connector will automatically exclude the tax amount
(given in the eBay order), from the sales order that is created in NetSuite.
Proposed Solution
Overview

Task-03: Create Customer Deposit with Sales Order Import

Proposed Solution
Overview

Task - 04: Export Kit Items as Simple Products from NetSuite to eBay
Business Requirement
Proposed Solution
Overview

Task - 05: End Listing & Relisting Item

Business Requirement
Proposed Solution
Overview

Task - 06: Update Inventory & Price incase of any error

Business Requirement
Proposed Solution
Overview
Task-01: Use customer eBay ID as primary identifier instead of Email

Business Requirement
Sync customers associated with eBay orders to NetSuite by using the customer's eBay ID as
the primary identifier to check whether that customer already exists in NetSuite (instead of
the customer's email address).

Proposed Solution

Overview
To cater for this requirement, the connector will use the eBay ‘BuyerId’ field to look up customers in NetSuite, at
the time of order import from eBay. The connector will set the eBay ‘BuyerId’ field on the NetSuite Customer
record. In case of Guest Checkout orders on eBay (where the customer does not have an eBay account and places
the order on eBay as a Guest), the connector will look for the customer in NetSuite (at the time of order import
from eBay) based on the email id provided on the eBay order.

Expected Inputs / Outputs

Components

Scripts: F3 Client Factory

Script Name:
F3 Client Factory

Task-02: Exclude Tax Amount in NS Sales Order

When importing/creating eBay orders in NetSuite, the connector will automatically exclude the tax amount (given in the
eBay order), from the sales order that is created in NetSuite.

Proposed Solution

Overview
To cater for this requirement, the connector will be excluding the amount from the sales order created in NetSuite
Scripts: F3 Client Factory

Script Name:
F3 Client Factory

Task-03: Create Customer Deposit with Sales Order Import

Automatic creation of a customer deposit (instead of a cash sale record) along with the sales order, upon order
import in NetSuite. Furthermore, while creating the customer deposit in NetSuite, the connector will exclude the
tax amount (given on the eBay order) from the customer deposit.
When Authorized Acquisitions manually creates the invoice in NetSuite for the sales order, the connector will
automatically apply the customer deposit to this invoice.

Proposed Solution

Overview
Connector will create Instant Customer Deposit along with sales order. Once the sales order is created, transform it
into Customer Deposit.

Scripts: F3 Client Factory

Script Name:
F3 Client Factory

Task - 04: Export Kit Items as Simple Products from NetSuite to eBay

Business Requirement
The client needed Kit Items to be synced to eBay as simple inventory items

Proposed Solution

Overview
Kit Items will be exported like Simple Inventory items. Kit Quantity will be picked from Custom Field on Kit item record in
NS.

Scripts: Item Export Sch Script

Script Name:
F3 Item Export to External System Sch

Script URL:
https://7003394-sb1.app.netsuite.com/app/common/scripting/script.nl?id=1336

Script Type:
Schedule

Task - 05: End Listing & Relisting Item

Business Requirement
The client needed an option on the F3 ebay item listing record from where they can end listing for an item from netsuite.
And if they want to relist that item again, it can also be done from Netsuite instead of ebay.

Proposed Solution

Overview
We have provided a custom checkbox for both end listing & relisting an item. If end listing checkbox is marked True, the
item listing will be ended on Ebay. For ending listing, Ending reason is also required in Ebay API, therefore, an Ending
reason dropdown is also created and a default value is selected.
To relist an item, there is a checkbox on F3 Ebay item listing record. If Relist is marked True, a new listing will be created
on Ebay for that item and Ebay Id in the listing record will be replaced by the new listing created ( as new listing will have
a new ebay item id), after the item is relisted, in Netsuite the checkbox value for end listing and relisting will be
automatically marked as False.
Scripts: F3 Client Factory

Script Name:
F3 Client Factory
F3 Ebay Wrapper

Task - 06: Update Inventory & Price incase of any error

Business Requirement
If the Best Offer is enabled or product details cannot be modified for an item or any required field is missing for the
Revise Item call, the inventory & price of that item should still be updated from NS to Ebay.
Proposed Solution

Overview
If any error occurs during ReviseFixedPriceItem API call due to any missing required field or promotions enabled. The
inventory and price of the item will still be updated via ReviseInventoryStatus call.
Scripts: F3 Client Factory

Script Name:
F3 Client Factory
F3 Ebay Wrapper

Custom Lists:

Name ID

F3 Item Listing Ending Reason customlist_f3_item_listing_end_reason

Values

Incorrect

LostOrBroken

NotAvailable

OtherListingError

SellToHighBidder

Sold

Custom Fields:

Record Type Field Name Field Type List/Record Id

F3 Ebay Item Listing End Item Listing Check Box custrecord_enditemlis

Records ting

F3 Ebay Item Listing Item Listing Ending List/Record F3 Item Listing custrecord_f3_item_e
Records Reason Ending Reason nding_reason

F3 Ebay Item Listing Relist Item Check Box custrecord_f3_relistit

Records em
Scripts:
Script Name:
F3 Set Default Ebay Listing Values

Script URL:
https://4953269.app.netsuite.com/app/common/scripting/script.nl?id=988

Script Type:*
UserEvent

Responsibility*:
As F3 Ebay item listing record is locked and cannot be edited. Client needed to set default values when a new listing
record is created. This script will set Default values in F3 Ebay Item Listing Record for following fields

1. EBAY CATEGORY ID
2. EBAY ITEM LISTING TYPE
3. EBAY DISPATCH TIME MAX\
4. COUNTRY
5. CURRENCY
6. EBAY LISTING DURATION
7. EBAY STORE
8. POSTAL CODE
9. SHIPPING PROFILE
10. PAYMENT PROFILE
11. RETURN PROFILE