Topic

connectors/source/amazon-seller-partner, type/enhancement

Relevant information

Summary

Add Fulfillment Inbound (FBA Inbound v0) support to the Amazon Seller Partner source connector by introducing streams for inbound shipments and shipment items.

Motivation / Background

The Amazon SP-API Fulfillment Inbound v0 endpoints expose operational inbound shipment data that is valuable for inventory and inbound tracking workflows, but the current Airbyte Amazon Seller Partner source connector does not provide these endpoints as streams.

Relevant SP-API references:

• getShipments: https://developer-docs.amazon.com/sp-api/reference/getshipments
• getShipmentItemsByShipmentId: https://developer-docs.amazon.com/sp-api/reference/getshipmentitemsbyshipmentid

Proposed streams

• FbaInboundShipments (backed by getShipments)
• FbaInboundShipmentItems (backed by getShipmentItemsByShipmentId, sliced by parent ShipmentId)

Expected user value

• Users can replicate inbound shipment operations data (shipments + shipment items) through Airbyte without building custom sync logic.
• A rolling time window option is helpful for day-to-day operations because getShipments requires both start and end timestamps for QueryType=DATE_RANGE, and maintaining the end timestamp manually can be burdensome.

Notes / limitations (API contract)

• getShipmentItemsByShipmentId responses may include NextToken, but the reference documentation does not define NextToken as a request parameter for this operation. If item lists are truncated, this may present a data loss risk for very large shipments.

Internal Tracking: https://github.com/airbytehq/oncall/issues/12000