Chances are you have encountered the term "Entity" at the beginning of your SyncSpider journey.
The purpose of this article is for you to be able to understand what they are, how to use them, and how to tell if an Integration is able to send or receive a certain Entity.
Entities can be defined as a type of Data certain Integration can either Import or Export.
They will vary from Integration to Integration.
E.G. Our eBay Integration is able to send Orders and Products, and receive Refunds, Products, and Order Status.
This means that the Entities eBay has are:
• Order and Product as a Source Integration.
• Refund, Product, and Order Status as a Target Integration.
Let's look at another example - our Ecwid Integration can send Customers, Orders, and Products and receive Customers, Orders, and Products.
This means that the Entities Amazon EU has are:
• Customer, Order, and Product as a Source Integration.
• Customer, Order, and Product as a Target Integration.
When creating a Task, it is highly recommended to choose Integrations with compatible Entities.
NOTE: Every business is different, so we allow you to match any entity with any other entity even though it might not make any sense at first :)
This means that if we wanted to connect eBay with Ecwid, we could easily do the following:
• Send Order and Product Entities from eBay to Ecwid.
• Send Product Entity from Ecwid to eBay.
You will be asked to choose the Entity you wish to send when setting up your Source Integration, and the Entity you wish to receive when setting up your Target Integration, within a Task.
It is important to note that you can send one type of Entity per Task. For example, you can migrate how many Contacts you wish within one Task, but you'd have to set up a new Task if you wish to migrate another Entity, e.g. Invoice.
All Entities have Attributes. Attributes are certain properties that further define an Entity, and can vary.
E.G. eBay's Product Entity has Attributes such as:
Title, Type, Size, Color, Quantity, Price, etc. If you chose to migrate Products in bulk these Attributes will vary from Product to Product.
Another thing worth mentioning is that the Entity you selected for your Source and Target Integration will determine how the Mapping section will look like.
To learn more about Mapping, click here.
In addition to new Integration Requests, you can also submit a Feature Request by clicking here.
Feature Requests usually pertain (but are not limited) to the addition of new Entities to an already existing Integration.
E.G. Users can request Entities such as Email Campaign and SMS Campaign to be added to our Sendinblue Integration.
We hope you found this Article helpful :)
If you still have any questions or inquiries left unanswered, please email us at [email protected].
Additionally, you can shoot us a message via our website's chat widget or get in touch with us on our Facebook page, and our Customer Support Representatives will be more than happy to assist you.