amzn / selling-partner-api-models

This repository contains OpenAPI models for developers to use when developing software to call Selling Partner APIs.
Apache License 2.0
619 stars 741 forks source link

Finances API v2024-06-19 - How to distinguish between Refund and Chargeback Refund? #4274

Open gamestarxie opened 1 month ago

gamestarxie commented 1 month ago

@jawheral Hello, I am currently experiencing a problem where the “transaction_type” and "description" of a transaction data returned to me by this interface are both "Refund", but the data in the Transaction CSV downloaded from the seller central is "Chargeback Refund". How should I distinguish the data returned by the interface from "Refund"?

This is the data returned by the interface:

{
    "breakdowns": [
      {
        "breakdown_type": "Sales",
        "breakdown_amount": {
          "currency_code": "USD",
          "currency_amount": {"$numberDecimal": 6.84}
        },
        "breakdowns": [
          {
            "breakdown_type": "AmazonFees",
            "breakdown_amount": {
              "currency_code": "USD",
              "currency_amount": {"$numberDecimal": 6.84}
            }
          }
        ]
      },
      {
        "breakdown_type": "Expenses",
        "breakdown_amount": {
          "currency_code": "USD",
          "currency_amount": {"$numberDecimal": -57.01}
        },
        "breakdowns": [
          {
            "breakdown_type": "ProductCharges",
            "breakdown_amount": {
              "currency_code": "USD",
              "currency_amount": {"$numberDecimal": -57.01}
            }
          }
        ]
      }
    ],
    "description": "Refund",
    "items": [
      {
        "description": "XXXXXX",
        "related_identifiers": [
          {
            "item_related_identifier_name": "ORDER_ADJUSTMENT_ITEM_ID",
            "item_related_identifier_value": "101267092859XXX"
          }
        ],
        "total_amount": {
          "currency_code": "USD",
          "currency_amount": {"$numberDecimal": -50.17}
        },
        "breakdowns": [
          {
            "breakdown_type": "Tax",
            "breakdown_amount": {
              "currency_code": "USD",
              "currency_amount": {"$numberDecimal": 0.0}
            },
            "breakdowns": [
              {
                "breakdown_type": "OurPriceTax",
                "breakdown_amount": {
                  "currency_code": "USD",
                  "currency_amount": {"$numberDecimal": -3.99}
                },
                "breakdowns": []
              },
              {
                "breakdown_type": "MarketplaceFacilitatorTax-Principal",
                "breakdown_amount": {
                  "currency_code": "USD",
                  "currency_amount": {"$numberDecimal": 3.99}
                },
                "breakdowns": []
              }
            ]
          },
          {
            "breakdown_type": "ProductCharges",
            "breakdown_amount": {
              "currency_code": "USD",
              "currency_amount": {"$numberDecimal": -57.01}
            },
            "breakdowns": [
              {
                "breakdown_type": "OurPricePrincipal",
                "breakdown_amount": {
                  "currency_code": "USD",
                  "currency_amount": {"$numberDecimal": -57.01}
                },
                "breakdowns": []
              }
            ]
          },
          {
            "breakdown_type": "AmazonFees",
            "breakdown_amount": {
              "currency_code": "USD",
              "currency_amount": {"$numberDecimal": 6.84}
            },
            "breakdowns": [
              {
                "breakdown_type": "Commission",
                "breakdown_amount": {
                  "currency_code": "USD",
                  "currency_amount": {"$numberDecimal": 8.55}
                },
                "breakdowns": [
                  {
                    "breakdown_type": "Base",
                    "breakdown_amount": {
                      "currency_code": "USD",
                      "currency_amount": {"$numberDecimal": 8.55}
                    }
                  }
                ]
              },
              {
                "breakdown_type": "RefundCommission",
                "breakdown_amount": {
                  "currency_code": "USD",
                  "currency_amount": {"$numberDecimal": -1.71}
                },
                "breakdowns": [
                  {
                    "breakdown_type": "Base",
                    "breakdown_amount": {
                      "currency_code": "USD",
                      "currency_amount": {"$numberDecimal": -1.71}
                    }
                  }
                ]
              }
            ]
          }
        ],
        "contexts": [
          {
            "context_type": "ProductContext",
            "asin": "B07KY5XXXX",
            "sku": "XXXXXX",
            "quantity_shipped": 1,
            "fulfillment_network": "AFN"
          }
        ]
      }
    ],
    "marketplace_details": {
      "marketplace_id": "ATVPDKIKX0DER",
      "marketplace_name": "Amazon.com"
    },
    "posted_date": {"$date": "2024-06-19T02:20:49.000Z"},
    "related_identifiers": [
      {
        "related_identifier_name": "ORDER_ID",
        "related_identifier_value": "111-8197069-833XXXX"
      },
      {
        "related_identifier_name": "SHIPMENT_ID",
        "related_identifier_value": "amzn1:crow:+2jy8LT4SzC9iyMPihI+Eg"
      },
      {
        "related_identifier_name": "FINANCIAL_EVENT_GROUP_ID",
        "related_identifier_value": "vaCJTNj5OC1vBcfYBVfc1tMW07-PtWEtJehtWVwlOu8"
      }
    ],
    "selling_partner_metadata": {
      "selling_partner_id": "A1R2N6LO0XXXXXX",
      "account_type": "Standard Orders",
      "marketplace_id": "ATVPDKIKX0DER"
    },
    "total_amount": {
      "currency_code": "USD",
      "currency_amount": {"$numberDecimal": -50.17}
    },
    "transaction_id": "z17Ced9X7d1TnD6meKsS_dL4RTQp9gNxmzckTPxffbs",
    "transaction_status": "Released",
    "transaction_type": "Refund"
  }

This is the data returned by the seller central:

{
  "account_type": "Standard Orders",
  "date_time": {"$date": "2024-06-19T02:20:49.000Z"},
  "description": "TXXXX",
  "fba_fees": {"$numberDecimal": 0},
  "fulfillment": "Amazon",
  "gift_wrap_credits": {"$numberDecimal": 0},
  "giftwrap_credits_tax": {"$numberDecimal": 0},
  "marketplace": "amazon.com",
  "marketplace_withheld_tax": {"$numberDecimal": 3.99},
  "order_city": "MIAMI",
  "order_id": "111-8197069-833XXXX",
  "order_postal": "33186-6628",
  "order_state": "FL",
  "other": {"$numberDecimal": 0},
  "other_transaction_fees": {"$numberDecimal": 0},
  "product_sales": {"$numberDecimal": -57.01},
  "product_sales_tax": {"$numberDecimal": -3.99},
  "promotional_rebates": {"$numberDecimal": 0},
  "promotional_rebates_tax": {"$numberDecimal": 0},
  "quantity": 1,
  "regulatory_fee": {"$numberDecimal": 0},
  "selling_fees": {"$numberDecimal": 6.84},
  "settlement_id": "2076869XXXX",
  "shipping_credits": {"$numberDecimal": 0},
  "shipping_credits_tax": {"$numberDecimal": 0},
  "sku": "XXXXXX",
  "tax_collection_model": "MarketplaceFacilitator",
  "tax_on_regulatory_fee": {"$numberDecimal": 0},
  "total": {"$numberDecimal": -50.17},
  "type": "Chargeback Refund"
}
jawheral commented 1 month ago

Hi @gamestarxie,

Thank you for reaching out and providing the feedback. Our teams are currently aware and I will provide you with updates once I receive them.

Best, Jawher Selling Partner Developer Services

thesky2017 commented 1 day ago

Hi @gamestarxie,

Thank you for reaching out and providing the feedback. Our teams are currently aware and I will provide you with updates once I receive them.

Best, Jawher Selling Partner Developer Services

这个问题预计什么时候能修复呢?