{"sourceDefinitionId": "e55879a8-0ef8-4557-abcf-ab34c53ec460", "name": "Amazon Seller Partner", "dockerRepository": "airbyte/source-amazon-seller-partner", "dockerImageTag": "5.6.0-preview.065f13f", "documentationUrl": "https://docs.airbyte.com/integrations/sources/amazon-seller-partner", "icon": "amazonsellerpartner.svg", "iconUrl": "https://connectors.airbyte.com/files/metadata/airbyte/source-amazon-seller-partner/latest/icon.svg", "sourceType": "api", "spec": {"connectionSpecification": {"title": "Amazon Seller Partner Spec", "type": "object", "required": ["aws_environment", "region", "account_type", "lwa_app_id", "lwa_client_secret", "refresh_token"], "additionalProperties": true, "properties": {"auth_type": {"title": "Auth Type", "const": "oauth2.0", "order": 0, "type": "string"}, "aws_environment": {"title": "AWS Environment", "description": "Select the AWS Environment.", "enum": ["PRODUCTION", "SANDBOX"], "default": "PRODUCTION", "type": "string", "order": 1}, "region": {"title": "AWS Region", "description": "Select the AWS Region.", "enum": ["AE", "AU", "BE", "BR", "CA", "DE", "EG", "ES", "FR", "GB", "IN", "IT", "JP", "MX", "NL", "PL", "SA", "SE", "SG", "TR", "UK", "US"], "default": "US", "type": "string", "order": 2}, "account_type": {"title": "AWS Seller Partner Account Type", "description": "Type of the Account you're going to authorize the Airbyte application by", "enum": ["Seller", "Vendor"], "default": "Seller", "type": "string", "order": 3}, "app_id": {"title": "Application ID", "description": "Your Amazon Application ID.", "order": 4, "airbyte_secret": true, "type": "string"}, "lwa_app_id": {"title": "LWA Client Id", "description": "Your Login with Amazon Client ID.", "order": 5, "airbyte_secret": true, "type": "string"}, "lwa_client_secret": {"title": "LWA Client Secret", "description": "Your Login with Amazon Client Secret.", "airbyte_secret": true, "order": 6, "type": "string"}, "refresh_token": {"title": "Refresh Token", "description": "The Refresh Token obtained via OAuth flow authorization.", "airbyte_secret": true, "order": 7, "type": "string"}, "replication_start_date": {"title": "Start Date", "description": "UTC date and time in the format 2017-01-25T00:00:00Z. Any data before this date will not be replicated. If start date is not provided or older than 2 years ago from today, the date 2 years ago from today will be used.", "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}Z$", "examples": ["2017-01-25T00:00:00Z"], "order": 8, "type": "string", "format": "date-time"}, "replication_end_date": {"title": "End Date", "description": "UTC date and time in the format 2017-01-25T00:00:00Z. Any data after this date will not be replicated.", "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}Z$|^$", "examples": ["2017-01-25T00:00:00Z"], "order": 9, "type": "string", "format": "date-time"}, "period_in_days": {"title": "Period In Days", "type": "integer", "description": "For syncs spanning a large date range, this option is used to request data in a smaller fixed window to improve sync reliability. This time window can be configured granularly by day.", "default": 90, "minimum": 1, "order": 10}, "report_options_list": {"title": "Report Options", "description": "Additional information passed to reports. This varies by report type.", "order": 11, "type": "array", "items": {"type": "object", "title": "Report Options", "required": ["report_name", "stream_name", "options_list"], "properties": {"report_name": {"title": "Report Name", "type": "string", "order": 0, "enum": ["GET_AFN_INVENTORY_DATA", "GET_AFN_INVENTORY_DATA_BY_COUNTRY", "GET_AMAZON_FULFILLED_SHIPMENTS_DATA_GENERAL", "GET_BRAND_ANALYTICS_ALTERNATE_PURCHASE_REPORT", "GET_BRAND_ANALYTICS_ITEM_COMPARISON_REPORT", "GET_BRAND_ANALYTICS_MARKET_BASKET_REPORT", "GET_BRAND_ANALYTICS_REPEAT_PURCHASE_REPORT", "GET_BRAND_ANALYTICS_SEARCH_TERMS_REPORT", "GET_FBA_ESTIMATED_FBA_FEES_TXT_DATA", "GET_FBA_FULFILLMENT_CUSTOMER_RETURNS_DATA", "GET_FBA_FULFILLMENT_CUSTOMER_SHIPMENT_PROMOTION_DATA", "GET_FBA_FULFILLMENT_CUSTOMER_SHIPMENT_REPLACEMENT_DATA", "GET_FBA_FULFILLMENT_REMOVAL_ORDER_DETAIL_DATA", "GET_FBA_FULFILLMENT_REMOVAL_SHIPMENT_DETAIL_DATA", "GET_FBA_INVENTORY_PLANNING_DATA", "GET_FBA_MYI_UNSUPPRESSED_INVENTORY_DATA", "GET_FBA_REIMBURSEMENTS_DATA", "GET_FBA_STORAGE_FEE_CHARGES_DATA", "GET_FLAT_FILE_ACTIONABLE_ORDER_DATA_SHIPPING", "GET_FLAT_FILE_ALL_ORDERS_DATA_BY_LAST_UPDATE_GENERAL", "GET_FLAT_FILE_ALL_ORDERS_DATA_BY_ORDER_DATE_GENERAL", "GET_FLAT_FILE_ARCHIVED_ORDERS_DATA_BY_ORDER_DATE", "GET_FLAT_FILE_OPEN_LISTINGS_DATA", "GET_FLAT_FILE_RETURNS_DATA_BY_RETURN_DATE", "GET_LEDGER_DETAIL_VIEW_DATA", "GET_LEDGER_SUMMARY_VIEW_DATA", "GET_MERCHANT_CANCELLED_LISTINGS_DATA", "GET_MERCHANT_LISTINGS_ALL_DATA", "GET_MERCHANT_LISTINGS_DATA", "GET_MERCHANT_LISTINGS_DATA_BACK_COMPAT", "GET_MERCHANT_LISTINGS_INACTIVE_DATA", "GET_MERCHANTS_LISTINGS_FYP_REPORT", "GET_ORDER_REPORT_DATA_SHIPPING", "GET_RESTOCK_INVENTORY_RECOMMENDATIONS_REPORT", "GET_SALES_AND_TRAFFIC_REPORT", "GET_SELLER_FEEDBACK_DATA", "GET_STRANDED_INVENTORY_UI_DATA", "GET_V2_SETTLEMENT_REPORT_DATA_FLAT_FILE", "GET_VENDOR_FORECASTING_REPORT", "GET_VENDOR_INVENTORY_REPORT", "GET_VENDOR_REAL_TIME_INVENTORY_REPORT", "GET_VENDOR_SALES_REPORT", "GET_XML_ALL_ORDERS_DATA_BY_ORDER_DATE_GENERAL", "GET_XML_BROWSE_TREE_DATA"]}, "stream_name": {"title": "Stream Name", "type": "string", "order": 1}, "options_list": {"title": "List of options", "description": "List of options", "type": "array", "order": 2, "items": {"type": "object", "required": ["option_name", "option_value"], "properties": {"option_name": {"title": "Name", "type": "string", "order": 0}, "option_value": {"title": "Value", "type": "string", "order": 1}}}}}}}, "wait_to_avoid_fatal_errors": {"title": "Wait between requests to avoid fatal statuses in reports", "type": "boolean", "description": "For report based streams with known amount of requests per time period, this option will use waiting time between requests to avoid fatal statuses in reports. See <a href=\"https://docs.airbyte.com/integrations/sources/amazon-seller-partner#limitations--troubleshooting\" target=\"_blank\">Troubleshooting</a> section for more details", "default": false, "order": 12}, "financial_events_step": {"title": "Financial Events Step Size", "description": "The time window size for fetching financial events data in chunks for the ListFinancialEvents and ListFinancialEventGroups streams. Options include hourly (1H, 6H, 12H) and daily (1D, 7D, 14D, 30D, 60D, 90D, 180D) granularity.\n\n- **Hourly step sizes (e.g., 1H, 6H)** are recommended for very high data volumes where daily windows cause pagination token expiration (TTL errors). They fetch smaller chunks per request, reducing the risk of timeouts.\n- **Daily step sizes (e.g., 1D, 7D)** are better for moderate data volumes. They balance sync speed with API efficiency.\n- **Larger step sizes (e.g., 30D, 180D)** are better for smaller data volumes. They fetch more data per request, speeding up syncing and reducing the number of API calls.\n\nSelect a step size that matches your data volume to optimize syncing speed and API performance.", "type": "string", "enum": ["1H", "2H", "4H", "6H", "8H", "12H", "1D", "7D", "14D", "30D", "60D", "90D", "180D"], "default": "180D", "order": 13}, "num_workers": {"title": "Number of Workers", "description": "The number of workers to use for the connector when syncing concurrently.", "type": "integer", "default": 2, "minimum": 2, "maximum": 10, "order": 14}, "max_async_job_count": {"title": "Maximum Concurrent Async Job Count", "description": "The maximum number of concurrent asynchronous job requests that can be active at a time.", "type": "integer", "default": 2, "minimum": 1, "order": 15}, "include_pii": {"title": "Include PII (Personally Identifiable Information)", "description": "When enabled, the connector requests a Restricted Data Token (RDT) to access PII fields such as BuyerInfo and ShippingAddress in the Orders and OrderItems streams. Your Amazon SP-API developer profile must have an approved Restricted Role (Direct-to-Consumer Shipping or Tax Invoicing). If the RDT request is denied (HTTP 403), the connector falls back to the standard token automatically and PII fields remain empty.", "type": "boolean", "default": false, "order": 16}, "financial_events_max_results_per_page": {"title": "Financial Events Max Results Per Page", "description": "The maximum number of results to return per page for the ListFinancialEvents stream. If the response exceeds the maximum number of transactions or 10 MB, the API returns an InvalidInput error. Lower this value if you encounter InvalidInput errors during sync. Valid range is 1-100.", "type": "integer", "default": 100, "minimum": 1, "maximum": 100, "order": 17}}}, "documentationUrl": "https://docs.airbyte.com/integrations/sources/amazon-seller-partner", "supportsNormalization": false, "supportsDBT": false, "advanced_auth": {"auth_flow_type": "oauth2.0", "predicate_key": ["auth_type"], "predicate_value": "oauth2.0", "oauth_config_specification": {"oauth_user_input_from_connector_config_specification": {"type": "object", "properties": {"region": {"type": "string", "path_in_connector_config": ["region"]}, "account_type": {"type": "string", "path_in_connector_config": ["account_type"]}}}, "complete_oauth_output_specification": {"type": "object", "additionalProperties": false, "properties": {"refresh_token": {"type": "string", "path_in_connector_config": ["refresh_token"]}}}, "complete_oauth_server_input_specification": {"type": "object", "additionalProperties": false, "properties": {"app_id": {"type": "string"}, "lwa_app_id": {"type": "string"}, "lwa_client_secret": {"type": "string"}}}, "complete_oauth_server_output_specification": {"type": "object", "additionalProperties": false, "properties": {"app_id": {"type": "string", "path_in_connector_config": ["app_id"]}, "lwa_app_id": {"type": "string", "path_in_connector_config": ["lwa_app_id"]}, "lwa_client_secret": {"type": "string", "path_in_connector_config": ["lwa_client_secret"]}}}}}}, "tombstone": false, "public": true, "custom": false, "releaseStage": "generally_available", "supportLevel": "certified", "allowedHosts": {"hosts": ["https://sellingpartnerapi-eu.amazon.com", "https://sellingpartnerapi-fe.amazon.com", "https://sellingpartnerapi-na.amazon.com", "https://sandbox.sellingpartnerapi-eu.amazon.com", "https://sandbox.sellingpartnerapi-fe.amazon.com", "https://sandbox.sellingpartnerapi-na.amazon.com"]}, "suggestedStreams": {"streams": ["Orders", "OrderItems", "ListFinancialEvents", "ListFinancialEventGroups"]}, "maxSecondsBetweenMessages": 14400, "erdUrl": "https://dbdocs.io/airbyteio/source-amazon-seller-partner?view=relationships", "releases": {"rolloutConfiguration": {"enableProgressiveRollout": false, "initialPercentage": 0, "maxPercentage": 50, "advanceDelayMinutes": 10}, "breakingChanges": {"2.0.0": {"upgradeDeadline": "2023-12-11", "message": "Deprecated FBA reports will be removed permanently from Cloud and Brand Analytics Reports will be removed temporarily. Updates on Brand Analytics Reports can be tracked here: [#32353](https://github.com/airbytehq/airbyte/issues/32353)", "migrationDocumentationUrl": "https://docs.airbyte.com/integrations/sources/amazon-seller-partner-migrations#2.0.0"}, "3.0.0": {"upgradeDeadline": "2024-01-12", "message": "Streams `GET_FLAT_FILE_ALL_ORDERS_DATA_BY_ORDER_DATE_GENERAL` and `GET_FLAT_FILE_ALL_ORDERS_DATA_BY_LAST_UPDATE_GENERAL` now have updated schemas. Streams `GET_AMAZON_FULFILLED_SHIPMENTS_DATA_GENERAL`, `GET_LEDGER_DETAIL_VIEW_DATA`, `GET_MERCHANTS_LISTINGS_FYP_REPORT`, `GET_STRANDED_INVENTORY_UI_DATA`, and `GET_V2_SETTLEMENT_REPORT_DATA_FLAT_FILE` now have date-time formatted fields. Users will need to refresh the source schemas and reset these streams after upgrading.", "migrationDocumentationUrl": "https://docs.airbyte.com/integrations/sources/amazon-seller-partner-migrations#3.0.0"}, "4.0.0": {"upgradeDeadline": "2024-03-11", "message": "Stream `GET_FBA_STORAGE_FEE_CHARGES_DATA` schema has been updated to match Amazon Seller Partner. Users will need to refresh the source schema and reset this stream after upgrading.", "migrationDocumentationUrl": "https://docs.airbyte.com/integrations/sources/amazon-seller-partner-migrations#4.0.0"}, "5.0.0": {"upgradeDeadline": "2025-12-18", "message": "Deprecated FBA Subscribe and Save report types (GET_FBA_SNS_FORECAST_DATA and GET_FBA_SNS_PERFORMANCE_DATA) have been removed per Amazon SP-API deprecation. See: https://developer-docs.amazon.com/sp-api/changelog/deprecation-of-two-fba-subscribe-and-save-report-types", "migrationDocumentationUrl": "https://docs.airbyte.com/integrations/sources/amazon-seller-partner-migrations#5.0.0", "scopedImpact": [{"scopeType": "stream", "impactedScopes": ["GET_FBA_SNS_FORECAST_DATA", "GET_FBA_SNS_PERFORMANCE_DATA"]}]}}, "migrationDocumentationUrl": "https://docs.airbyte.com/integrations/sources/amazon-seller-partner-migrations"}, "ab_internal": {"sl": 300, "ql": 400, "isEnterprise": false, "requireVersionIncrementsInPullRequests": true}, "generated": {"git": {"commit_sha": "2f18a48b640c2de3b70ca598162a96198adce49c", "commit_timestamp": "2026-03-06T00:49:02+00:00", "commit_author": "Octavia Squidington III", "commit_author_email": "octavia-squidington-iii@users.noreply.github.com"}, "source_file_info": {"metadata_file_path": "metadata/airbyte/source-amazon-seller-partner/5.6.0-preview.065f13f/metadata.yaml", "metadata_bucket_name": "prod-airbyte-cloud-connector-metadata-service", "metadata_last_modified": "2026-03-09T18:12:32.536000+00:00", "registry_entry_generated_at": "2026-03-09T18:13:50.684108"}, "sbomUrl": "https://connectors.airbyte.com/files/sbom/airbyte/source-amazon-seller-partner/5.6.0-preview.065f13f.spdx.json"}, "packageInfo": {}, "language": "manifest-only", "supportsFileTransfer": false, "supportsDataActivation": false, "license": "ELv2", "remoteRegistries": {"pypi": {"enabled": false, "packageName": "airbyte-source-amazon-seller-partner"}}, "githubIssueLabel": "source-amazon-seller-partner", "externalDocumentationUrls": [{"title": "SP-API Deprecation Schedule", "type": "api_deprecations", "url": "https://developer-docs.amazon.com/sp-api/docs/sp-api-deprecations"}, {"title": "SP-API documentation", "type": "api_reference", "url": "https://developer-docs.amazon.com/sp-api/"}, {"title": "SP-API Release Notes", "type": "api_release_history", "url": "https://developer-docs.amazon.com/sp-api/docs/sp-api-release-notes"}, {"title": "Authorization", "type": "other", "url": "https://developer-docs.amazon.com/sp-api/docs/authorizing-selling-partner-api-applications"}, {"title": "Usage plans and rate limits", "type": "other", "url": "https://developer-docs.amazon.com/sp-api/docs/usage-plans-and-rate-limits-in-the-sp-api"}], "tags": ["language:manifest-only", "cdk:low-code"], "connectorBuildOptions": {"baseImage": "docker.io/airbyte/source-declarative-manifest:7.10.1@sha256:bd69f6b52bdd92ce06c30786d67546427b828ffb553363c8950b2816c552d6e0"}, "connectorTestSuitesOptions": [{"suite": "liveTests", "testConnections": [{"id": "17415432-092c-4020-ab55-fbb77cf5196e", "name": "amazon-seller-partner_config_dev_null"}]}, {"suite": "unitTests"}, {"suite": "acceptanceTests", "testSecrets": [{"fileName": "config_old_data.json", "name": "SECRET_SOURCE-AMAZON-SELLER-PARTNER_OLD_DATA_CREDS", "secretStore": {"alias": "airbyte-connector-testing-secret-store", "type": "GSM"}}, {"fileName": "config.json", "name": "SECRET_SOURCE-AMAZON-SELLER-PARTNER__CREDS", "secretStore": {"alias": "airbyte-connector-testing-secret-store", "type": "GSM"}}]}]}