Amazon Selling Partner icon

Amazon Selling Partner

Interact with Amazon Selling Partner API

Report → Refunds by ASIN

AI-generated

Overview

This node operation fetches refund reports by ASIN (Amazon Standard Identification Number) from the Amazon Selling Partner API. It is useful for sellers who want to analyze refund data for their products over a specified time period, aggregated by daily, weekly, or monthly granularity. Practical applications include monitoring refund trends, identifying problematic products, and managing financial reconciliations.

Use Case Examples

  1. A seller wants to retrieve daily refund data for their products sold in the US marketplace from January 1 to January 31 to analyze refund patterns.
  2. A business needs to generate a monthly refund report for multiple Amazon marketplaces to consolidate financial data and adjust inventory or marketing strategies accordingly.

Properties

Name Meaning
Start Date Start of the reporting window (inclusive) in ISO-8601 format with timezone.
End Date End of the reporting window (inclusive) in ISO-8601 format with timezone.
Granularity Aggregation level for returned metrics, which must align with Amazon report configuration.
Marketplace IDs Select marketplaces included in the report request.
Normalize Currency If true, convert refund amounts into the first selected marketplace currency.
Advanced Options Additional settings for report generation such as max poll time, poll interval, returning raw document, and binary property name.

Output

JSON

  • asin - The ASIN (Amazon Standard Identification Number) for the refunded product.
  • refundDate - The date of the refund event.
  • refundAmount - The amount refunded for the product.
  • currency - Currency of the refund amount.
  • marketplaceId - Marketplace identifier where the refund occurred.
  • additionalDetails - Any additional details related to the refund event.

Dependencies

  • Amazon Selling Partner API credentials

Troubleshooting

  • Ensure the date range is valid and in ISO-8601 format with timezone to avoid errors.
  • Verify that the selected marketplace IDs are correct and supported by the Amazon Selling Partner API.
  • If the report generation takes too long, consider increasing the max poll time or adjusting the poll interval in advanced options.
  • If the node returns raw document data, ensure the binary property name is correctly set to access the data.
  • Common errors include authentication failures due to invalid or expired credentials; ensure API credentials are correctly configured.

Discussion