Amazon serves as a robust channel integration within Flxpoint, empowering businesses to efficiently manage their product listings, inventory, and orders on the global Amazon Marketplace. This integration delivers real-time synchronization of product data, advanced pricing controls, and streamlined order fulfillment, ensuring that your operations remain accurate, competitive, and fully aligned with Amazon’s dynamic marketplace standards.
How to Connect
- Connection Name - E.g., "My Amazon US Link".
- Marketplace ID - Use "ATVPDKIKX0DER" (US) or "A2EUQ1WTGCTBG2" (CA).
- Refresh Token - Get from Amazon Seller Central > Developers > Apps & Services.
- Selling Partner ID - Find in Seller Central > Settings > User Permissions > Account Info.
- Match SKUs carefully.
- Add a prefix like "AMZ-" if needed.
- Inventory & Pricing: Sync stock and prices.
- Order Sync: Pull orders (e.g., every 15 minutes).
- Shipment Tracking: Update tracking info.
Listing Operations
Import Listings
- Import product listings from Amazon using the GET_MERCHANT_LISTINGS_ALL_DATA feed type.
- Save key data like SKU and Title for easy inventory management in Flxpoint.
- Automate the import process with a new token generated if the previous one expires, keeping your connection secure.
- Data Retrieval: Pulls listing data from Amazon using the GET_MERCHANT_LISTINGS_ALL_DATA feed type, including SKU and Title.
- Data Import: Saves the retrieved data (SKU and Title) into Flxpoint for inventory management.
- Token Management: Generates a new token if the previous one expires to maintain a secure connection.
"Listings": [
{
"SKU": "AMZ12345",
"Title": "Blue Widget"
},
{
"SKU": "AMZ67890",
"Title": "Red Gadget"
}
]
}
-
Connection Settings:
- Connection Name: Name it something like "AmazonImport2025".
- Amazon OAuth2: Use the Amazon Seller Portal (OAuth2) credentials to connect.
- Feed Type: Set to GET_MERCHANT_LISTINGS_ALL_DATA to import all listing data.
- Data to Save: Configure to save only SKU and Title fields from the imported data.
New Token: If your token expires, a new one is automatically generated to keep the integration running smoothly.
- 1 Connect to Amazon: Enter your Amazon Seller Portal (OAuth2) credentials and click "Save and Proceed" to establish the connection.
- 2 Configure Settings: Set the feed type to GET_MERCHANT_LISTINGS_ALL_DATA and save only SKU and Title data. Click "Save and Complete" when done.
- 3 Run the Integration: Click "Run Integration" to import your listings manually, or schedule it for automatic updates.
- Integration Title: Labeled as "Amazon Channel - Import Listings" at the top.
- Connection Section: Includes fields for Amazon Seller Portal (OAuth2) credentials.
- Settings Section: Allows you to set the feed type and data to save (SKU and Title).
- Action Buttons: Features "Save and Proceed" and "Save and Complete" to move through the setup.
- Current Date and Time: As of 02:23 PM -04 on Monday, June 23, 2025, this integration is ready to use.
- Feed Type: Uses GET_MERCHANT_LISTINGS_ALL_DATA to import all listings.
- Data Saved: Only SKU and Title are saved in Flxpoint.
Publish Listings
- Publish product listings from Flxpoint to Amazon marketplaces (e.g., AMAZON_NA, AMAZON_EU, AMAZON_JP).
- Map Flxpoint fields (like SKU, Title, Description) to Amazon product fields using a customizable template.
- Data Mapping: Maps Flxpoint fields (e.g., SKU, Title) to Amazon product fields using the mapping template.
- Rule Application: Applies custom rules (e.g., "If no ASIN use UPC") to handle special cases.
- Publishing: Sends the mapped data to Amazon.
"SKU": "FLX12345",
"Title": "Blue Widget",
"Description": "High-quality blue widget",
"ProductIDType": "ASIN",
"ProductID": "B07X4K9Y9Z",
}
-
Connection Settings:
- Amazon Marketplace: Choose from DEFAULT, AMAZON_NA, AMAZON_EU, or AMAZON_JP.
- OAuth2 Credentials: Use your Amazon Seller Portal credentials.
- Fulfillment Center ID: Set a value or map a field (optional).
- 1 Connect to Amazon: Enter your OAuth2 credentials, select your marketplace, and save.
- 2 Configure Mapping: Use the Mapping Template to map fields (see below).
- 3 Apply Rules: Set up rules (e.g., "If no ASIN use UPC") and save.
- 4 Publish Listings: Click "Save" to publish or use "Duplicate" to test.
| Field | Maps To | Options | Purpose |
|---|---|---|---|
| SKU | Amazon Product Field: SKU | Don't Map, Set To Empty, Field, Value, Mapping Set, Rules | Identifies the product |
| Title | Amazon Product Field: Title | Field, Value, Mapping Set, Rules | Sets the product name |
| Product ID | Amazon Product Field: Product ID | Don't Map, Set To Empty, Field, Option (ASIN, ISBN, UPC, EAN), Rules | Sets the product identifier; ASIN is the most accurate identifier and recommended whenever possible. If ASINs are unavailable, UPCs may be used instead, but publish in batches and validate mappings to avoid errors. |
| Quantity | Amazon Product Field: Quantity | Don't Map, Set To Empty, Field, Option (3-5 Business Days, 4-14 Business Days), Rules | Sets stock or handling time |
| Item Condition | Amazon Product Field: Item Condition | Don't Map, Set To Empty, Field, Value, Mapping Set, Rules (e.g., New, Used - Like New) | Defines product condition |
-
If no ASIN use UPC:
- Type: Conditional
- Description: Uses UPC if ASIN is missing.
- Logic: 1 condition, 1 action.
- Example: Sets Product ID to "123456789012" if ASIN is empty.
- Current Date and Time: As of 10:31 PM -04 on Monday, June 23, 2025, this integration is ready.
Sync & Link Listings
- Sync price and quantity data from Flxpoint to Amazon marketplaces (e.g., AMAZON_NA, AMAZON_EU, AMAZON_JP).
- Link Flxpoint fields (like Quantity, Price) to Amazon’s Product (Price & Quantity) fields.
- Hide products marked OOS on your storefront for a cleaner user experience.
- Data Mapping: Maps Flxpoint fields (e.g., Quantity, Price) to Amazon’s Product (Price & Quantity) fields.
- Data Sync: Updates Amazon with the latest price and quantity values from Flxpoint.
- OOS Handling: Marks products as OOS and hides them on your storefront if stock is zero.
"SKU": "FLX12345",
"Price": 29.99,
"Quantity": 5,
"Status": "Active"
}
-
Connection Settings:
- Amazon Marketplace: Choose from DEFAULT, AMAZON_NA, AMAZON_EU, or AMAZON_JP.
- OAuth2 Credentials: Use your Amazon Seller Portal credentials.
- Price and Quantity: Map fields like Price and Quantity to sync with Amazon.
- OOS Handling: Enable hiding products marked OOS on your storefront.
Hiding OOS: When a product is OOS, it’s hidden from your storefront to avoid confusion.
- 1 Connect to Amazon: Enter your OAuth2 credentials, select your marketplace, and save.
- 2 Configure Mapping: Use the Mapping Template to map Price and Quantity (see below).
- 3 Enable OOS Hiding: Turn on the option to hide OOS products on your storefront.
- 4 Sync Listings: Click "Save" to sync or use "Duplicate" to test.
| Field | Maps To | Options | Purpose |
|---|---|---|---|
| Price | Amazon Product (Price & Quantity) Field: Price | Don't Map, Set To Empty, Field, Value, Rules | Sets the selling price on Amazon |
| Quantity | Amazon Product (Price & Quantity) Field: Quantity | Field, Value, Rules | Updates available stock |
| Handling Time | Amazon Product (Price & Quantity) Field: Handling Time | Don't Map, Set To Empty, Field, Value, Rules | Sets the processing time |
lead_time_to_ship_max_days only when one of two conditions is true:
-
Your fulfillment channel ≠
DEFAULT.
Amazon’s schema requires a value in this case, so Flxpoint passes1day if the field is blank. -
You explicitly map Handling Time in the template (even if your channel is
DEFAULT).
DEFAULT channel)
"header": { … },
"messages": [ {
"sku": "ABC123",
"operationType": "PATCH",
"productType": "PRODUCT",
"patches": [ {
"path": "/attributes/fulfillment_availability",
"value": [ {
"fulfillment_channel_code": "DEFAULT",
"quantity": 25
} ]
} ]
} ]
}
- Current Date and Time: As of 02:42 PM ‑04 on Monday, June 23, 2025, this integration is ready.
- OOS Behavior: Products marked OOS are hidden on your storefront.
What Flxpoint does when you link products:
- Reads and stores the product type from Amazon.
- If unavailable, falls back to
PRODUCT.
- Confirm the product‑type value in Seller Central.
- Verify it with Amazon’s Product Type Definitions API (search by keyword).
- Update the listing with a supported value and re‑sync.
Order Operations
Get Orders
- Retrieve order data from Amazon marketplaces (e.g., AMAZON_NA, AMAZON_EU, AMAZON_JP).
- Map Amazon order fields (like Amazon Order ID, Address Line 1) to Flxpoint fields.
- Import billing, shipping, and invoice details for seamless order management.
- Data Retrieval: Pulls order data from Amazon, including Amazon Order ID, shipping addresses, and item details.
- Data Mapping: Maps Amazon fields to Flxpoint fields using the mapping template.
- Data Import: Imports the mapped data into Flxpoint for processing.
"AmazonOrderID": "AMZ202306231234",
"OrderTotal": {
"Amount": 49.99,
"CurrencyCode": "USD"
},
"ShippingAddress": {
"AddressLine1": "123 Main St",
"City": "Austin",
"PostalCode": "78701"
},
"OrderItem": {
"SellerSKU": "FLX12345",
"QuantityOrdered": 1
}
}
-
Connection Settings:
- Amazon Marketplace: Choose from DEFAULT, AMAZON_NA, AMAZON_EU, or AMAZON_JP.
- OAuth2 Credentials: Use your Amazon Seller Portal credentials.
- Billing and Shipping Mapping: Map fields like Address Line 1 and City to Flxpoint billing or shipping addresses.
- Invoice Mapping: Optionally map invoice fields like Total to Flxpoint order fields.
Address Mapping: Ensure shipping addresses are correctly mapped for accurate delivery.
- 1 Connect to Amazon: Enter your OAuth2 credentials, select your marketplace, and save.
- 2 Configure Mapping: Use the Mapping Template to map fields like Amazon Order ID and Address Line 1 (see below).
- 3 Run the Integration: Click "Save" to fetch orders or use "Duplicate" to test.
| Amazon Field | Maps To | Options | Purpose |
|---|---|---|---|
| Amazon Order ID | Order Field: Reference Number | Field, Value, Rules | Links the order in Flxpoint |
| Address Line 1 | Shipping Address Field: Address Line 1 | Don't Map, Set To Empty, Field, Value, Mapping Set, Rules | Sets the primary shipping address |
| City | Shipping Address Field: City | Don't Map, Set To Empty, Field, Value, Mapping Set, Rules | Specifies the shipping city |
| Order Total - Amount | Channel Invoice Field: Total | Don't Map, Set To Empty, Field, Value, Rules | Records the order total |
| Purchase Date | Order Field: Ordered On | Field, Value, Mapping Set, Rules | Sets the order date |
- Current Date and Time: As of 02:48 PM -04 on Monday, June 23, 2025, this integration is ready to use.
- Supported Fields: Includes order details, billing, shipping, and invoice data from Amazon.
Sync Orders
- Send shipment details (like Tracking Number and Carrier) to Amazon.
- Update Amazon fulfillment fields with a custom mapping template.
- Keep tracking and shipping info accurate for your orders.
- Configuration: Starts with your Amazon channel settings (SP-API or MWS).
- Receive Shipped Orders: Gets a list of orders with shipments from Flxpoint.
- Process Shipments: Handles each shipment, inferring Carrier and Method.
- Map to Amazon Format: Converts data into the format Amazon expects with rules and IDs.
- Filter Empty Fulfillments: Removes data with no items.
- Categorize Orders: Separates managed and non-managed orders.
- Submit to Amazon: Sends data as an order fulfillment feed.
- Process Response: Marks shipments as successful or failed based on Amazon’s feedback.
- Return Results: Provides a sync summary.
"FulfillmentRequestNumber": "FR202306231234",
"Carrier": "UPS",
"TrackingNumber": "1Z9999W999999999"
}
- Connection Settings: Choose marketplace (DEFAULT, AMAZON_NA, AMAZON_EU, AMAZON_JP) and use your Amazon credentials.
- Shipment Mapping: Map fields like Carrier and Tracking Number.
Accurate mappings are key.
You control how Flxpoint chooses the Carrier and Shipping Service that get posted to Amazon:
-
Auto-Detect Shipping Carrier from Tracking Number (Advanced) — default: ON
When ON, Flxpoint identifies the carrier (and sometimes service) from the tracking number pattern and uses that value when posting to Amazon. - Use Your Mapping Rules — Turn Auto-Detect OFF to prioritize your own mapping rules (for example, normalize vendor inputs into your preferred carrier names).
1) Auto-Detect = ON → auto-detected carrier/service override mappings.
2) Auto-Detect = OFF → your mappings determine the carrier/service sent to Amazon.
- 1 Connect to Amazon: Enter your Amazon credentials, select marketplace, and save.
- 2 Configure Mapping: Use the Mapping Template below.
- 3 Sync Orders: Run a test sync before enabling on a schedule.
| Flxpoint Field | Maps To | Example |
|---|---|---|
| Shipment Carrier | Fulfillment Data - Carrier Name | Use "Field" to pull "UPS" from your system, or set "Value" to "USPS" for all shipments. |
| Shipment Tracking Number | Fulfillment Data - Shipper Tracking Number | Map "Field" to "1Z9999W999999999" for a specific order, ensuring it matches your carrier’s format. |
| Shipment Method | Fulfillment Data - Shipping Method | Set "Value" to "Ground" or use "Field" to pull "Priority Mail" from your data. |
| Condition | Action | Example |
|---|---|---|
| Length is 22 characters, starts with "94A0" | Carrier: "USPS", Method: "First Class" | Tracking Number: "94A0123456789012345678" → USPS First Class. |
| Length is 22 characters, starts with "94A05" or "92A05" | Carrier: "USPS", Method: "Priority Mail" | Tracking Number: "94A0512345678901234567" → USPS Priority Mail. |
| Starts with "93G1" | Carrier: "USPS", Method: "Parcel Select" | Tracking Number: "93G123456789" → USPS Parcel Select. |
| Starts with "9374" | Carrier: "USPS", Method: "Parcel Select Lightweight" | Tracking Number: "9374123456789" → USPS Parcel Select Lightweight. |
| None of the above USPS prefixes (length 22) | Carrier: "USPS", Method: "(empty string)" | Tracking Number: "ZZ12345678901234567890" → USPS with no method. |
| Length is 18 characters, starts with "1Z" and 9th & 10th chars are "YW" | Carrier: "UPS", Method: "SurePost" | Tracking Number: "1Z999YW9999999999" → UPS SurePost. |
| Length is 18 characters, starts with "1Z" and 9th & 10th chars are "03" | Carrier: "UPS", Method: "Ground" | Tracking Number: "1Z9990399999999999" → UPS Ground. |
| Starts with "9274" and length is 26 characters | Carrier: "UPS", Method: "Mail Innovations" | Tracking Number: "92741234567890123456789012" → UPS Mail Innovations. |
| Matches regex ^[0-9]{20}$ OR ^[0-9]{15}$ OR ^[0-9]{12}$ | Carrier: "FedEx", Method: "(empty string) if not FedEx, otherwise preserved" | Tracking Number: "12345678901234567890" → FedEx with no method. |
| Input | Type | Mapped To | Notes |
|---|---|---|---|
| "GOSO" | Carrier value | GLS US | Normalizes vendor-provided value to your preferred carrier name. |
| "GOLDEN STATE OVERNIGHT" | Service value | Other | Maps long-form service label to a standardized value. |
- Authentication: Uses the Amazon connection configured on your channel.
- Shipment scope: Syncs tracking for shipments created in Flxpoint that are ready to send to Amazon.
For Amazon bundle items, Sync Orders uses the Amazon Order Item ID for the line item, not the individual component SKUs. Because Amazon expects a single shipment update per order item, bundle tracking is sent only when the bundle is fully shipped in Flxpoint.
- If all component SKUs for the bundle are shipped, Sync Orders sends a single shipment update for the bundled item to Amazon.
- If at least one component SKU is still unshipped, the bundle line is treated as partially shipped and that shipment is skipped during that sync run.
- Once all components are shipped in Flxpoint, the next Sync Orders run will include the tracking for the bundle line and update Amazon.
- Check the toggle: In Sync Orders → Advanced, confirm the Auto-Detect Shipping Carrier from Tracking Number setting is as intended.
- Review a recent order in Flxpoint: Open the shipment and confirm the final carrier/service before sync.
- Verify your mapping rules: Ensure exact key matches (case/spacing) and that each rule targets the correct field (Carrier vs Service).
- Re-sync after changes: If you adjusted the toggle or mappings, re-run the sync (or next cycle) for updated results.