This article, and the subsequent articles in this section are intended solely for clients who have signed up for a Managed Activation/Integration. If you are signed up for a Basic Integration/Activation, please utilize the Basic Activation guide at https://farapp.zendesk.com/hc/en-us/articles/360043725493.
FarApp wants to ensure that you have a successful integration. This article lays out what you need to know about how the managed integration process works and what to expect during your integration. Please make sure you have read and thoroughly understand this overview. At the end of the article, you will find a link to the next step of the process. Please follow the entire process all the way so you will be prepared to integrate when your Integration Specialist contacts you.
Both you and FarApp are responsible for providing specialists with the skills and availability required to complete integration tasks successfully and on time.
It is imperative that you have an experienced technical resource assigned to the integration who is familiar with data flows between software applications. This person can be a company employee or a third-party contractor who you’ve given permission to access and implement changes for your account. Please specify on your FarApp Integration Questionnaire the name of your designated technical resource and their full contact information.
You can view our list of verified FarApp Partners at https://www.farapp.com/partners/.
A specialist is considered a technical resource if they can independently execute the Prerequisites section below. For a successful implementation, the technical resource specialist should complete the following Prerequisites before the FarApp integration starts. An unqualified technical resource specialist can result in delays to your integration.
If FarApp starts your integration before the Prerequisites have been completed, it may result in a delayed or prolonged integration.
Before integrating with FarApp, you should:
- Sign up with FarApp.
- Have accounts/credentials for NetSuite, your marketplace(s)/cart(s), and (if applicable) your 3PL(s).
- Be familiar with using NetSuite, your marketplace(s)/cart(s), and (if applicable) your 3PL(s).
- Have a clear idea of what data will be synced between NetSuite and the marketplace/cart (e.g., order information, SKUs, quantity, price, product description, etc.)
- Make sure all items on your marketplace(s)/cart(s) have unique SKUs that exactly match the value in the field you are using for your SKU field on the corresponding item in NetSuite.
- Be able to place orders on your marketplace(s)/cart(s) because you will be creating test orders for FarApp during the course of the integration.
- Be able to enter orders manually into NetSuite with shipment and payment methods along with any other information you'd expect FarApp to sync (e.g., discounts).
- Have NetSuite configured to calculate your tax codes and rates correctly (i.e. your tax nexuses should be configured) so that orders entered into NetSuite properly reflect tax. If you are using tax codes then tax codes should be automatically assigned to orders when the order is created. This means that you do not need to manually select the tax code on the order.
- Be able to fulfill orders/print labels/generate tracking numbers, etc. in your 3PL(s) or in NetSuite if you ship orders directly in NetSuite.
- Be able to bill orders in NetSuite and verify they are billed as the record type (Cash Sale or Invoice) you expect.
- Only applicable if setting up product sync- Be able to create an item in NetSuite and in the marketplace(s)/cart(s) with the correct data that the marketplace(s)/cart(s) is/are expecting.
- Only applicable if setting up refund sync- Be able to refund orders in NetSuite and in the marketplace(s)/cart(s).
- Be able to supply FarApp with the sample/test data needed. For example, if FarApp requests sample orders to manually sync to NetSuite for you as tests, you should be able to provide the order IDs for these orders. Common sample/test data needed are orders, fulfilled orders, products ready to sync, and refunded orders.
FarApp Integration Specialists work on multiple projects at once; they are not dedicated to your project on a full-time basis. Standard operating hours for FarApp resources are Monday through Friday 8am-6pm PT excluding holidays. If you request tasks to be done off-hours (i.e. weekends and/or weekdays before 8am PT or after 6pm PT), additional costs may apply.
FarApp works integrations through tickets. One ticket will be opened for the first feature sync to be integrated and a new ticket for the subsequent feature sync(s) will be opened after the first integration sync has been completed.
You should communicate through the appropriate ticket since it makes it easier to streamline updates and troubleshoot issues should they arise. Thus, please refrain from opening new tickets or responding to a different ticket. If necessary, scheduled calls can be made with the assigned Integration Specialist to clarify any configurations or to discuss the progress of the project.
You should expect the following integration times for leading practice integrations.
|Project Kick-off / Initiation||1 week|
|Order + Fulfillment Sync||1 week|
|Full Product Sync||2 weeks|
|Price and Quantity Sync (including Real-time Price and Quantity Sync)||1 week|
|Refund Sync||1 week|
|Add-On Syncs||Configure after go-live.|
|Settlement/Fees Sync (Amazon only)||Configure after go-live.|
Purchasing upgraded support does not reduce these integration times. Upgraded support allows FarApp to execute the integration steps on your behalf with input from you as needed.
The timelines listed above reflect the amount of time that is actually spent working on the integration. For example, if your Integration Specialist is waiting for necessary information for one week, that will extend the timeline by one week. You should answer questions from the FarApp Integration team and provide sample data in a timely fashion, which allows the integration to proceed on schedule. Diverging from leading practices can lead to a delayed integration and additional costs since these are not standard configurations and may require more time and resources to set up and support.
**Disclaimer: The timeline above is an average project schedule for standard functionality where there are no unexpected project delays such as change orders, third party delays, etc. Add-ons and customizations are not included in the timeline above and will increase the target project period.
It is expected that you should know your workflow and know how you want FarApp/NetSuite to work. This conception may or may not match leading practices or available functionality, but your Integration Specialist will work with you as much as possible to find the best path forward.
Connectors will be set up in your production environment(s). It is possible to connect the NetSuite sandbox environment to FarApp and then switch to the production environment before Go-Live, but this will require additional testing to ensure the syncs are working properly and may extend the timeline of the integration.
FarApp doesn't provide a separate sandbox account for integrations because it's unnecessary. If you want a sandbox and production connector running in parallel after Go-Live, there will be an extra charge and the FarApp Integration Specialist will only work on one connector. Sandbox accounts are only provided for a fee on an as-needed basis. If you require setting up a sandbox environment, you must inform the Integration Specialist prior to the start of the integration.
Changes to the integration timeline and pricing increases could occur tasks are required that fall outside of the original integration scope.
In order for the integration to be successful, you should be responsive, make prompt decisions, and complete requested tasks in a timely manner. Many integration configurations rely on input from you. If you do not provide punctual responses the integration could be delayed.
FarApp is not responsible for the overall project management in the implementation of software systems other than FarApp. FarApp is only responsible for the integration between NetSuite and the marketplace(s)/cart(s) and (if applicable) 3PL(s) connectors that are being integrated.
- It is your responsibility to manage third parties.
- If there's an issue with NetSuite, the marketplace/cart, or 3PL, it is your responsibility to contact NetSuite, the marketplace/cart, or 3PL to resolve the issue.
- If FarApp’s integration is completed, it will be considered closed regardless of whether your other projects are completed.
- Additional charges may apply for FarApp to participate in meetings such as requirements sessions, weekly progress session, etc. that involve aren't focused primarily on the FarApp integration portion.
The services in scope will be delivered in one project phase. If you want to implement a partial deployment of the integration, additional charges may apply to implement the remaining scope in a future project phase.
Any customizations (non-standard or not leading practice configurations) done in FarApp may increase your monthly support fee since it requires more time and resources to maintain.
Mappings are typically set up one-to-one. Standard FarApp functionality can handle one layer of logic (e.g., a single level if-then statement) within those mappings. If you require additional layers of logic, that should be done within NetSuite using workflows, formula fields, or scripts. If you need FarApp to handle that additional layer of logic for you, your Integration Specialist will assess whether the request should be handled using mappings within FarApp.
Your Integration Specialist will set up the standard mappings for you plus 5 additional mappings. If you require additional mappings, your Integration Specialist will provide you with instructions on how to set those up and you will be responsible for testing to ensure they work properly.
Testing / Confirming Data Has Synced Properly
Test items/transactions are used to test and you should understand the possibility that something could potentially go wrong with those items/transactions during testing.
You are responsible for the following testing tasks:
- Creating the data necessary to test the configuration and mappings.
- Deleting any test data that was created during the course of this project.
- Confirming that an item, order, fulfillment, etc. posted as expected. Once the Integration Specialist receives your confirmation, that successfully tested portion of the project will be completed and the Integration Specialist will move on to the next phase.
- If you return to make changes to the portion of the project that's already been completed, this will delay completion of the overall integration and additional charges may apply.
If you have verified with the Integration Specialist that the features they've configured for you are working properly and then you later make changes before Go-Live, then you are responsible if the syncs are no longer working. If the Integration Specialist needs to fix the configuration in order to get the sync(s) to work properly again, additional charges will apply.
Integration fees are non-refundable. If the integration has started, but you no longer want to proceed with completing the integration, integration fees will not be refunded.
If a project is put on-hold, FarApp’s resources will be reassigned to other projects. FarApp will always try to contact you before the project is put on-hold. A project may be put on-hold due to the following scenarios:
- If you are not ready to start the project or you do not respond within 3 days after the integration kick-off.
- If you do not respond within 3 days after the FarApp Integration Specialist requests information from you or you fail to complete a task needed to advance the integration within the same time period.
- Once the project has started if you or a third party is unresponsive or stalls the project for more than 3 days.
- If invoice(s) for Integration Support is not paid within 1 week of receiving the invoice.
- If the integration is completed but the syncs aren't enabled within 3 days.
To reinstate an integration that has been put on-hold, additional charges may apply in order to reallocate resources to the integration, bring the Integration Specialist up to speed, or discuss topics previously addressed.
- All outstanding FarApp invoices must be paid and current before the integration will be reinstated.
- If there has been no communication from you for more than 30 days, then reintegration fees apply.
- FarApp's availability to reinstate the integration will be subject to resource availability.
- FarApp will attempt to assign the same Integration Specialist to the project, however, FarApp does not guarantee the same resource will be assigned.
- FarApp reserves the right to put the project back on-hold at any time if any outstanding invoice has not been paid.
The project will be considered canceled if the project has been on-hold for 6 months or more. If you wish to restart the project, you and FarApp must execute a new project plan and a new integration fee will be charged.
Integration Milestones and Completion
Depending on the type and level of your connector, the project plan that your Integration Specialist creates for you will have several milestones that serve as guidelines on when we expect that portion of your integration to be completed. During an integration, when these milestones are completed, the completed portion of the integration is considered closed and all subsequent questions with regards to that portion of the integration will need to be directed to the support team. For example, if you have completed the Order/Fulfillment Sync portion of the integration and have moved on to the next milestone, then all questions pertaining to Order/Fulfillment Sync will be forwarded to Support. This is a means to keep the integration on track and making sure that the Integration Specialist is able to help you reach your Go-Live deadline.
The integration will be considered complete once all pre-Go-Live milestones outlined in your project plan have been implemented, tested, and confirmed to be working. Once the integration has been completed, you should Go-Live within one week. You have a 3-day window after Go-Live to report any issues with the integration to your Integration Specialist. After 3 days, we assume your integration is working as expected and your account will be marked as live. Once your account is live, invoicing for the monthly subscription(s) will commence. Any issues or changes that occur after the Integration Completion will be handled as a support ticket unless you've purchased Enterprise ongoing support, in which case you should reach out to your account manager directly. New support tickets can be created at https://support.farapp.com/hc/en-us/requests/new. You can also refer to the following article for more details on support after you go live https://support.farapp.com/hc/en-us/articles/360007700733
Starting the Process
In order to begin the process you will need to make sure you have created a FarApp account and logged into FarApp. If you are not logged into FarApp the support articles containing additional steps will not be accessible. If you are logged into FarApp you can click the link below to continue.