Entity Types
An entity type identifies the kind of data record being moved. Each connector supports a specific set of entity types, and the mapping configuration you create must declare which entity type it handles. The entity type name in a mapping config must match the values in the table below exactly (the match is case-insensitive).
When the pipeline processes a record, it uses the entity type to select the correct canonical format, the correct normalizer, and the correct transformer for that source–target connector pair.
Supported entity types
Section titled “Supported entity types”| Entity type | Friendly name | Description | Supported source connectors | Supported target connectors |
|---|---|---|---|---|
item | Item / Product | A sellable product or SKU, including variants, pricing, images, and inventory. | SAP Business One, Shopify, WooCommerce, Wix | EZY Portal, Shopify, Flat File, Generic API |
itemstock | Item Stock (inventory only) | A stock-only update for an existing item. Used to push inventory levels to a destination without touching product master data. | — | Shopify |
bp | Business Partner | A company or individual that can be a customer, supplier, or both. | SAP Business One | EZY Portal, Flat File, Generic API |
customer | Customer | A customer record extracted from an e-commerce platform. | Shopify, WooCommerce, Wix | EZY Portal, Flat File, Generic API |
bpgroup | Business Partner Group | A category used to group business partners. | SAP Business One, EZY Portal | EZY Portal, Flat File, Generic API |
paymentterms | Payment Terms | Payment terms reference data (for example, Net 30). | SAP Business One, EZY Portal | EZY Portal, Flat File, Generic API |
itemgroup | Item Group | A category used to group items / products. | SAP Business One, EZY Portal | EZY Portal, Flat File, Generic API |
pricelist | Price List | A named list of prices, typically associated with a customer group. | SAP Business One, EZY Portal | EZY Portal, Flat File, Generic API |
warehouse | Warehouse | A physical or logical inventory location. | SAP Business One | EZY Portal, Flat File, Generic API |
taxgroup | Tax Group | A grouping of tax rates applied to items or business partners. | SAP Business One | EZY Portal, Flat File, Generic API |
uomgroup | Unit of Measure Group | A group of related units of measure (for example, Weight: kg, g, lb). | SAP Business One | EZY Portal, Flat File, Generic API |
fiscalperiod | Fiscal Period | An accounting period definition. | SAP Business One | EZY Portal, Flat File, Generic API |
salesquotation | Sales Quotation | A sales quotation document. | SAP Business One, EZY Portal | EZY Portal, SAP Business One, Flat File, Generic API |
salesorder | Sales Order | A confirmed sales order document. | SAP Business One, EZY Portal | EZY Portal, SAP Business One, Flat File, Generic API |
order | Order | An e-commerce order from an online store. | Shopify, WooCommerce, Wix | Flat File, Generic API |
booking | Booking | An appointment or service booking (Wix Bookings). | Wix | Flat File, Generic API |
subscription | Subscription | A recurring subscription to a pricing plan (Wix Pricing Plans). Always performs a full scan — incremental sync is not supported for this type. | Wix | Flat File, Generic API |
service | Service | A bookable service offering (Wix Bookings). | Wix | EZY Portal, Flat File, Generic API |
plan | Plan | A pricing plan (Wix Pricing Plans). | Wix | EZY Portal, Flat File, Generic API |
menuitem | Menu Item | A restaurant menu item (Wix Restaurants). | Wix | EZY Portal, Flat File, Generic API |
- Exact name required. The entity type value in your mapping configuration must match one of the names in the
Entity typecolumn above. The comparison is case-insensitive, soItem,item, andITEMare all accepted. - Flat File and Generic API accept any entity type. Because these connectors write output without interpreting the record structure, they can receive any entity type the source provides.
bpvscustomer. SAP Business One usesbp(business partner) which can represent both customers and suppliers. E-commerce platforms usecustomerwhich represents only buyers. Both map to EZY Portal’s business partner entity.salesquotationandsalesordershare a canonical format. Both document types use the same underlying canonical structure; the entity type string in the mapping config determines which document type is created in the target system.
Related
Section titled “Related”- Architecture Overview — How entity types fit into the pipeline flow.
- Mapping Configuration — How to specify the entity type in a mapping config and configure field mappings.
- Pipeline Stages — How entity types are used during normalization and transformation.