{ "ab_internal": { "isEnterprise": false, "ql": 400, "requireVersionIncrementsInPullRequests": true, "sl": 300 }, "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" ] }, "connectorBuildOptions": { "baseImage": "docker.io/airbyte/source-declarative-manifest:7.19.0@sha256:e7859182efa8cb6b31e3f3ebfcbd4ca7dd4597f2c20bda802f6d09283980fc24" }, "connectorTestSuitesOptions": [ { "suite": "liveTests", "testConnections": [ { "id": "17415432-092c-4020-ab55-fbb77cf5196e", "name": "amazon-seller-partner_config_dev_null" } ] }, { "suite": "unitTests" }, { "suite": "acceptanceTests", "testSecrets": [ { "fileName": "config.json", "name": "SECRET_SOURCE-AMAZON-SELLER-PARTNER__CREDS", "secretStore": { "alias": "airbyte-connector-testing-secret-store", "type": "GSM" } } ] } ], "custom": false, "dockerImageTag": "5.7.6-preview.38de536", "dockerRepository": "airbyte/source-amazon-seller-partner", "documentationUrl": "https://docs.airbyte.com/integrations/sources/amazon-seller-partner", "erdUrl": "https://dbdocs.io/airbyteio/source-amazon-seller-partner?view=relationships", "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" } ], "generated": { "git": { "commit_author": "Devin AI", "commit_author_email": "158243242+devin-ai-integration[bot]@users.noreply.github.com", "commit_sha": "79eb7859df8b635173ea9f02b34140a253749ced", "commit_timestamp": "2026-05-11T16:20:53+00:00" }, "sbomUrl": "https://connectors.airbyte.com/files/sbom/airbyte/source-amazon-seller-partner/5.7.6-preview.38de536.spdx.json", "source_file_info": { "metadata_bucket_name": "prod-airbyte-cloud-connector-metadata-service", "metadata_file_path": "metadata/airbyte/source-amazon-seller-partner/5.7.6-preview.38de536/metadata.yaml", "metadata_last_modified": "2026-05-11T16:46:10.612994+00:00", "registry_entry_generated_at": "2026-05-11T16:46:10.612994+00:00" } }, "githubIssueLabel": "source-amazon-seller-partner", "icon": "amazonsellerpartner.svg", "iconUrl": "https://connectors.airbyte.com/files/metadata/airbyte/source-amazon-seller-partner/latest/icon.svg", "language": "manifest-only", "license": "ELv2", "maxSecondsBetweenMessages": 14400, "name": "Amazon Seller Partner", "packageInfo": {}, "public": true, "releaseStage": "generally_available", "releases": { "breakingChanges": { "2.0.0": { "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", "upgradeDeadline": "2023-12-11" }, "3.0.0": { "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", "upgradeDeadline": "2024-01-12" }, "4.0.0": { "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", "upgradeDeadline": "2024-03-11" }, "5.0.0": { "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": [ { "impactedScopes": [ "GET_FBA_SNS_FORECAST_DATA", "GET_FBA_SNS_PERFORMANCE_DATA" ], "scopeType": "stream" } ], "upgradeDeadline": "2025-12-18" } }, "migrationDocumentationUrl": "https://docs.airbyte.com/integrations/sources/amazon-seller-partner-migrations", "rolloutConfiguration": { "advanceDelayMinutes": 10, "enableProgressiveRollout": false, "initialPercentage": 0, "maxPercentage": 50 } }, "remoteRegistries": { "pypi": { "enabled": false, "packageName": "airbyte-source-amazon-seller-partner" } }, "sourceDefinitionId": "e55879a8-0ef8-4557-abcf-ab34c53ec460", "sourceType": "api", "spec": { "advanced_auth": { "auth_flow_type": "oauth2.0", "oauth_config_specification": { "complete_oauth_output_specification": { "additionalProperties": false, "properties": { "refresh_token": { "path_in_connector_config": [ "refresh_token" ], "type": "string" } }, "type": "object" }, "complete_oauth_server_input_specification": { "additionalProperties": false, "properties": { "app_id": { "type": "string" }, "lwa_app_id": { "type": "string" }, "lwa_client_secret": { "type": "string" } }, "type": "object" }, "complete_oauth_server_output_specification": { "additionalProperties": false, "properties": { "app_id": { "path_in_connector_config": [ "app_id" ], "type": "string" }, "lwa_app_id": { "path_in_connector_config": [ "lwa_app_id" ], "type": "string" }, "lwa_client_secret": { "path_in_connector_config": [ "lwa_client_secret" ], "type": "string" } }, "type": "object" }, "oauth_user_input_from_connector_config_specification": { "properties": { "account_type": { "path_in_connector_config": [ "account_type" ], "type": "string" }, "region": { "path_in_connector_config": [ "region" ], "type": "string" } }, "type": "object" } }, "predicate_key": [ "auth_type" ], "predicate_value": "oauth2.0" }, "connectionSpecification": { "additionalProperties": true, "properties": { "account_type": { "default": "Seller", "description": "Type of the Account you're going to authorize the Airbyte application by", "enum": [ "Seller", "Vendor" ], "order": 3, "title": "AWS Seller Partner Account Type", "type": "string" }, "app_id": { "airbyte_secret": true, "description": "Your Amazon Application ID.", "order": 4, "title": "Application ID", "type": "string" }, "auth_type": { "const": "oauth2.0", "order": 0, "title": "Auth Type", "type": "string" }, "aws_environment": { "default": "PRODUCTION", "description": "Select the AWS Environment.", "enum": [ "PRODUCTION", "SANDBOX" ], "order": 1, "title": "AWS Environment", "type": "string" }, "creation_requester_429_max_retries": { "airbyte_hidden": true, "default": 5, "description": "Maximum number of retry attempts when the report creation API returns HTTP 429 (Too Many Requests). Each retry uses exponential backoff based on the x-amzn-RateLimit-Limit header. Reduce this value to avoid exhausting rate limits on retrying requests.", "minimum": 0, "order": 19, "title": "Report Creation 429 Max Retries", "type": "integer" }, "failed_retry_wait_time_in_seconds": { "airbyte_hidden": true, "default": 1800, "description": "Time in seconds to wait before retrying a report that returned FATAL status. Amazon enforces per-report-type cooldowns after generating a report. Near-real-time FBA reports have an approximately 30-minute cooldown, daily FBA reports approximately 4 hours. The default of 1800 seconds covers the most common cooldown. Increase this value if you see repeated FATAL errors on daily FBA reports.", "maximum": 14400, "minimum": 1, "order": 18, "title": "Failed Report Retry Wait Time (Seconds)", "type": "integer" }, "financial_events_max_results_per_page": { "default": 100, "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.", "maximum": 100, "minimum": 1, "order": 17, "title": "Financial Events Max Results Per Page", "type": "integer" }, "financial_events_step": { "default": "180D", "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.", "enum": [ "1H", "2H", "4H", "6H", "8H", "12H", "1D", "7D", "14D", "30D", "60D", "90D", "180D" ], "order": 13, "title": "Financial Events Step Size", "type": "string" }, "include_pii": { "default": false, "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.", "order": 16, "title": "Include PII (Personally Identifiable Information)", "type": "boolean" }, "lwa_app_id": { "airbyte_secret": true, "description": "Your Login with Amazon Client ID.", "order": 5, "title": "LWA Client Id", "type": "string" }, "lwa_client_secret": { "airbyte_secret": true, "description": "Your Login with Amazon Client Secret.", "order": 6, "title": "LWA Client Secret", "type": "string" }, "max_async_job_count": { "default": 2, "description": "The maximum number of concurrent asynchronous job requests that can be active at a time.", "minimum": 1, "order": 15, "title": "Maximum Concurrent Async Job Count", "type": "integer" }, "max_done_report_age_hours": { "default": 0, "description": "When the connector finds an existing completed (DONE) report matching the same date range and marketplace, it can reuse that report instead of creating a new one. This setting controls how old (in hours) a completed report can be and still be reused. Set to 0 to always create new reports. Maximum is 24 hours.", "maximum": 24, "minimum": 0, "order": 14, "title": "Max Age of Completed Reports to Reuse (Hours)", "type": "integer" }, "num_workers": { "default": 2, "description": "The number of workers to use for the connector when syncing concurrently.", "maximum": 10, "minimum": 2, "order": 14, "title": "Number of Workers", "type": "integer" }, "period_in_days": { "default": 90, "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.", "minimum": 1, "order": 10, "title": "Period In Days", "type": "integer" }, "refresh_token": { "airbyte_secret": true, "description": "The Refresh Token obtained via OAuth flow authorization.", "order": 7, "title": "Refresh Token", "type": "string" }, "region": { "default": "US", "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" ], "order": 2, "title": "AWS Region", "type": "string" }, "replication_end_date": { "description": "UTC date and time in the format 2017-01-25T00:00:00Z. Any data after this date will not be replicated.", "examples": [ "2017-01-25T00:00:00Z" ], "format": "date-time", "order": 9, "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}Z$|^$", "title": "End Date", "type": "string" }, "replication_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.", "examples": [ "2017-01-25T00:00:00Z" ], "format": "date-time", "order": 8, "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}Z$", "title": "Start Date", "type": "string" }, "report_options_list": { "description": "Additional information passed to reports. This varies by report type.", "items": { "properties": { "options_list": { "description": "List of options", "items": { "properties": { "option_name": { "order": 0, "title": "Name", "type": "string" }, "option_value": { "order": 1, "title": "Value", "type": "string" } }, "required": [ "option_name", "option_value" ], "type": "object" }, "order": 2, "title": "List of options", "type": "array" }, "report_name": { "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" ], "order": 0, "title": "Report Name", "type": "string" }, "stream_name": { "order": 1, "title": "Stream Name", "type": "string" } }, "required": [ "report_name", "stream_name", "options_list" ], "title": "Report Options", "type": "object" }, "order": 12, "title": "Report Options", "type": "array" }, "sales_and_traffic_report_asin_granularity": { "default": "PARENT", "description": "The level of ASIN granularity for the Sales and Traffic report streams. PARENT returns data aggregated at the parent ASIN level. CHILD returns data at the child ASIN level with populated childAsin values. SKU returns data at the individual SKU level with populated childAsin and sku values.", "enum": [ "PARENT", "CHILD", "SKU" ], "order": 11, "title": "Sales and Traffic Report ASIN Granularity", "type": "string" }, "wait_to_avoid_fatal_errors": { "airbyte_hidden": true, "default": false, "description": "Deprecated - this option is no longer functional and will be removed in a future version. Rate limiting is now handled automatically by the connector.", "order": 13, "title": "[Deprecated] Wait between requests to avoid fatal statuses in reports", "type": "boolean" } }, "required": [ "aws_environment", "region", "account_type", "lwa_app_id", "lwa_client_secret", "refresh_token" ], "title": "Amazon Seller Partner Spec", "type": "object" }, "documentationUrl": "https://docs.airbyte.com/integrations/sources/amazon-seller-partner", "supportsDBT": false, "supportsNormalization": false }, "suggestedStreams": { "streams": [ "Orders", "OrderItems", "ListFinancialEvents", "ListFinancialEventGroups" ] }, "supportLevel": "certified", "supportsDataActivation": false, "supportsFileTransfer": false, "tags": [ "language:manifest-only", "cdk:low-code" ], "tombstone": false }