Logiwa streamlines your warehouse management with a user-friendly self-onboarding process for sales channels. This article walks you through the available functions, setup, and operational rules for your Amazon FBA integration.
Because Amazon fulfills FBA orders itself, this integration works differently from a typical marketplace connection: Logiwa doesn't ship orders on your behalf. Instead, it keeps your warehouse records in sync with what's happening at Amazon — tracking inbound shipments, mirroring your Fulfillable inventory, and pulling in shipping documents and your product catalog.
Before You Begin
Connecting Amazon FBA to Logiwa is self-service — you'll authorize the connection directly through Amazon Seller Central and choose your own settings on the connection screen.
💡 Your FBA Dummy Warehouse & Location Are Set Up for You: Amazon FBA inventory needs to reside within a dedicated Warehouse and Warehouse Location in Logiwa, kept separate from your physical or other virtual stock. You don't need to create this yourself — Logiwa creates and configures a dedicated FBA Dummy Warehouse and Location for you as part of setting up your integration. You'll simply select it on the connection screen below.
⚠️ US Marketplace Only: This integration currently supports the US marketplace only. Support for additional Amazon marketplaces is not yet available.
Locating Your Amazon Seller ID (Merchant Token)
You'll need your Amazon Seller ID to complete the connection. In Amazon's system, this is referred to as your Merchant Token. To find it:
Log in to your Amazon Seller Central account.
In the top-right corner of the dashboard, hover over the Settings gear icon and select Account Info.
On the Seller Account Information page, locate the Business Information box.
Click Merchant Token within that section.
Copy the alphanumeric string that appears — you'll paste this into the Seller ID field during connection setup.
Connect Amazon FBA in Logiwa
Start the Connection
Log in to Logiwa and navigate to Integrations > Store and Marketplace.
Find "Fulfillment By Amazon" from the list of available integrations and click Connect.
Integration Management: locate Fulfillment by Amazon among the available Store and Marketplace integrations.
Connection Screen Fields
Fill in the fields on the screen that appears, then click Continue.
Connect Amazon FBA Integration: Amazon FBA Store Name, Client, Warehouse, Shipment Order Type, Product UOM, and Contact Email.
Field | Description |
Amazon FBA Store Name | Enter your Amazon Store Name. |
Client | Select the client entity this connection belongs to. |
Warehouse | You can choose any Warehouse information, as Logiwa creates the FBA Dummy Warehouse through the integration itself. |
Shipment Order Type | Select the order type to apply to shipments imported from Amazon FBA. |
Product UOM | Select the pack type to apply to products synced from Amazon FBA. |
Contact Email | The address that receives integration notifications, status updates, and errors. |
Select Workflows
On the Overview tab, turn on the workflows you want to activate, then click Install.
Select the features to install: Sync Inventory, Download Products, Download Orders, Download Label, Download Bill of Lading.
Authorize Amazon FBA
After clicking Continue, you'll be redirected to the Amazon Seller Central login page.
Fill in the Region, Marketplace, and Environment fields, and enter the Seller ID you located above. Then click Connect to Amazon Seller.
Authenticate: Region (North America), Marketplace (US), Environment (Production), and Seller ID fields.
Log in with your Amazon Seller Central credentials.
You'll be redirected back to Logiwa, where a confirmation message shows the connection is complete.
ℹ️ Note: Once you grant access, Amazon returns a secure token to Logiwa, which is stored safely and used to generate the temporary access tokens Logiwa needs for ongoing API calls. You don't need to do anything further for this part — it happens automatically.
Operational Rules & Edge Cases
To prevent fulfillment delays and inventory discrepancies, review these operational business rules.
The FBA Dummy Warehouse & Location Are the Exclusive FBA Destination
All FBA shipment and inventory data is routed exclusively to the dedicated Warehouse and Warehouse Location Logiwa sets up for you and that you select during connection setup. This keeps FBA stock clearly separated from your physical or other virtual inventory.
Inventory Synchronization Uses "Overwrite" Logic
Unlike a typical incremental adjustment, Inventory Synchronization sets the Available quantity in your FBA Dummy Warehouse & Location to exactly match the Total Supply Quantity Amazon reports for each SKU — it doesn't add or subtract from the existing balance.
💡 Why this matters: If a SKU already exists in the FBA Dummy Warehouse & Location, its quantity is overwritten to match Amazon exactly. If the SKU doesn't exist there yet, Logiwa initializes a new inventory record with the balance from Amazon's report. Every sync cycle logs the SKU, the previous quantity, the new quantity, and the timestamp, so you always have a clear audit trail.
Bill of Lading Applies Only to LTL/FTL Shipments
Bill of Lading documents are retrieved only for Less Than Truckload (LTL) and Full Truckload (FTL) shipments. Small Parcel Delivery (SPD) shipments are not supported for this document type.
Document Sync Covers Shipments From the Last 24 Hours
The Bill of Lading and Shipping Label syncs run every 15 minutes, but each run only checks shipment orders created within the last 24 hours. If a shipment's documents weren't available on Amazon's side within that window, reach out to Support so the documents can be retrieved manually.
Integration Flows & Field Mappings
ℹ️ Reading these tables: Fields shown in parentheses are technical Amazon or Logiwa field names used by the system. The text before the parentheses is the everyday, user-facing label.
Shipment Order Synchronization (Amazon FBA → Logiwa)
Cadence & Trigger: Scheduled automation running every 10 minutes, 24/7. Logiwa pulls active (Working) inbound shipments, plus any cancelled since the last check.
Business Rules: Product line items are consolidated by SKU. New shipments are created in Logiwa; existing ones are updated; shipments cancelled on Amazon are cancelled in Logiwa.
Source (Amazon FBA) | Target (Logiwa) | Logic / Notes |
Shipment Id | Shipment Order Code (FBA-{Shipment Id}) |
|
Shipment Name | Company Name |
|
Ship From Address (Name) | Customer Name |
|
Ship From Address (Street, City, State, Zip, Country) | Shipping Address |
|
Consolidated Product SKUs & Quantities | Line Items | Items are grouped by SKU before being written to Logiwa. |
ℹ️ Note — Split Inbound Shipments: When Amazon splits a main FBA inbound shipment into multiple separate shipments, each split receives its own unique Shipment ID from Amazon. Since the integration maps orders on a 1:1 basis using this ID (Shipment Order Code = FBA-{Shipment Id}), each split shipment is automatically created as a separate, independent Shipment Order in Logiwa. There's no manual consolidation step required — the sync (running every 10 minutes) picks up each new Shipment ID as it becomes available and creates the corresponding order individually.
Inventory Synchronization (Amazon FBA → Logiwa)
Cadence & Trigger: Scheduled sync running every 10 minutes.
Business Rules: Syncs the Fulfillable Quantity — units physically available at Amazon fulfillment centers — into your FBA Dummy Warehouse & Location using the overwrite logic described above.
Source (Amazon FBA) | Target (Logiwa) | Logic / Notes |
Seller SKU | Product match key | Matches the product in Logiwa by SKU. |
Total Supply Quantity (Fulfillable) | Available Quantity (in the FBA Dummy Warehouse & Location) | Overwritten to exactly match Amazon's reported quantity (see Operational Rules above). |
Document Synchronization (Amazon FBA → Logiwa)
A) Bill of Lading (BOL)
Cadence & Trigger: Scheduled automation running every 15 minutes, covering shipment orders created in the last 24 hours. Applies only to LTL/FTL shipments.
Logiwa Output: Attached to the matching shipment order as a document (Document Type: Bill of Lading).
B) Shipping Labels
Cadence & Trigger: Scheduled automation running every 15 minutes, covering shipment orders created in the last 24 hours.
Logiwa Output: All three label types — 2D Barcode, Unique, and Pallet — are downloaded and attached to the matching shipment order as documents.
Product Synchronization (Amazon FBA → Logiwa)
Cadence & Trigger: Scheduled sync running every 15 minutes.
Business Rules: Downloads your active Amazon listings. Products are matched by SKU to prevent duplicates — existing products are updated, and new ones are created automatically.
Core Data Synced: Seller SKU, Product Name, Description, Price, and Active Status (all synced products are set to active).
Additional Data Synced: ASIN, Listing ID, Product Condition, Quantity, Fulfillment Channel, Image URL, Category & Browse Path, Date First Available, and International Shipping Eligibility.
Log Access & Support
Error Classifications & Diagnostics
Error Type | Common Causes | System Behavior |
Connection & Feed Failures | Logiwa cannot retrieve data, or Amazon rejects a feed. | The workflow stops immediately to prevent incorrect data from being written, and an email alert is sent. |
Individual Record Failures | A single shipment, inventory record, or product fails to process. | The error is logged, an email notification is sent with the specific SKU or Channel Order Number, and the workflow continues processing the remaining items (skip & continue). |
Every system event captures the following diagnostic markers (where applicable):
Timestamp
API Endpoint
Status (Success / Failed)
HTTP Status Code
Error Description / API Response Body
Every successful operation is also logged with a timestamp, the action performed, and the resulting quantities or Feed IDs — giving you a complete audit trail in both directions.
💡 Note on Log Access: Processing logs are not accessible via the Logiwa user interface dashboard, though log details for specific transactions can be shared upon request. All troubleshooting inquiries must be directed to the Support team by opening a ticket through HubSpot. This integration is also monitored by the Logiwa Integration Team.
ℹ️ When opening a support ticket, include: your Amazon Seller ID; the Amazon Shipment Id or SKU involved (if applicable); the time of the error; and any error message shown in the notification email.
