Guía de migración de Vendor Retail Analytics Reports

Cómo migrar los vendor retail analytics reports.

Descripción general

Este documento explica los cambios en los vendor retail analytics reports y describe cómo migrar los siguientes reports:

GET_VENDOR_DEMAND_FORECAST_REPORT (reemplazado por GET_VENDOR_FORECASTING_REPORT)
GET_VENDOR_INVENTORY_HEALTH_AND_PLANNING_REPORT (reemplazado por GET_VENDOR_INVENTORY_REPORT)
GET_VENDOR_SALES_DIAGNOSTIC_REPORT (reemplazado por GET_VENDOR_SALES_REPORT y GET_VENDOR_TRAFFIC_REPORT)

Importante: Los Report Types GET_VENDOR_DEMAND_FORECAST_REPORT, GET_VENDOR_INVENTORY_HEALTH_AND_PLANNING_REPORT y GET_VENDOR_SALES_DIAGNOSTIC_REPORT quedarán obsoletos el 27 de junio de 2022. Para obtener más información, consulte la tabla de Report Types de asignación a continuación.

¿Cuáles son los tipos de vendor retail analytics reports?

Los tipos de vendor retail analytics reports son una colección de reportes que comparten datos de series temporales para el vendor’s business, incluidas las ventas históricas, el tráfico, el inventario y las métricas de pronóstico.

Nuevos reportes y características

Nuevos Report Types lanzados en marzo de 2022:

GET_VENDOR_SALES_REPORT
GET_VENDOR_TRAFFIC_REPORT
GET_VENDOR_FORECASTING_REPORT
GET_VENDOR_INVENTORY_REPORT

Los nuevos Report Types incluyen los siguientes cambios para mejorar la experiencia del desarollador:

Obtención de datos para reportes de la misma fuente utilizada por los equipos de categorías de Amazon retail
Permitir que los integradores especifiquen diferentes agregaciones de intervalos de tiempo en su solicitud createReport
Aplanamiento de la estructura general del reporte JSON para simplificar el análisis

Migración de flujo de trabajo

Utilice los siguientes pasos para migrar los Report Types GET_VENDOR_DEMAND_FORECAST_REPORT, GET_VENDOR_INVENTORY_HEALTH_AND_PLANNING_REPORT y GET_VENDOR_SALES_DIAGNOSTIC_REPORT.

Paso 1. Genere y descargue los nuevos reportes

Envíe una solicitud createReport para cada uno de los cuatro reportes nuevos (GET_VENDOR_SALES_REPORT, GET_VENDOR_TRAFFIC_REPORT, GET_VENDOR_FORECASTING_REPORT y GET_VENDOR_INVENTORY_REPORT).
Utilice las operaciones de la API getReport y getReportDocument para descargar los reportes.
Revisar la estructura y el contenido de los reportes.

Paso 2. Modifique su analizador JSON para reconocer la nueva versión del reporte y la estructura JSON

Para cada Report Type, revise la estructura JSON del reporte.

Nota: Los nuevos reportes son "flatter", lo que simplifica el análisis.

Para cada Report Type, tome nota de los diferentes elementos de datos en el reporte.

Paso 3. Cambie sus canalizaciones de producción a datos de origen del nuevo Report Type.

Modifique su solicitud createReport para alinearla con los parámetros de la nueva versión del reporte.

Nota: La mayoría de los reportes nuevos requieren el parámetro reportPeriod; sin embargo, este parámetro no existía en GET_VENDOR_DEMAND_FORECAST_REPORT, GET_VENDOR_INVENTORY_HEALTH_AND_PLANNING_REPORT y GET_VENDOR_SALES_DIAGNOSTIC_REPORT.

Actualice su solicitud createReport para usar el nuevo valor de Report Type (por ejemplo, GET_VENDOR_SALES_REPORT).
Pruebe su canalización.

Paso 4. (Opcional) Datos históricos de Backfill

Los nuevos reportes obtienen datos de una fuente de datos diferente a GET_VENDOR_DEMAND_FORECAST_REPORT, GET_VENDOR_INVENTORY_HEALTH_AND_PLANNING_REPORT y GET_VENDOR_SALES_DIAGNOSTIC_REPORT. Los equipos de la categoría minorista de Amazon también utilizan esta nueva fuente. Debido a este cambio de fuente, es posible que desee Backfill los datos históricos para asegurarse de que no está combinando datos de varias fuentes.

Asignación de Report Types

	Viejo			Nuevo
Nombre	Valor de Report Type	Fecha de depreciación	Nombre	Valor de Report Type	notas
Sales Diagnostic Report	GET_VENDOR_SALES_DIAGNOSTIC_REPORT	27 de junio de 2022	Sales Report y Traffic Report	GET_VENDOR_SALES_REPORT y GET_VENDOR_SALES_TRAFFIC_REPORT	Los nuevos reportes imitan los paneles que se lanzarán en Vendor Central más adelante en 2022. Las métricas de ventas y tráfico se dividen en diferentes paneles y, por lo tanto, se dividen en diferentes reportes.
Inventory Health & Planning Report	GET_VENDOR_INVENTORY_HEALTH_AND_PLANNING_REPORT	27 de junio de 2022	Reporte de inventario	GET_VENDOR_INVENTORY_REPORT
Demand Forecast Report	GET_VENDOR_DEMAND_FORECAST_REPORT	27 de junio de 2022	Reporte de previsión	GET_VENDOR_FORECASTING_REPORT
Net Pure Product Margin Report	GET_VENDOR_NET_PURE_PRODUCT_MARGIN_REPORT	No será obsoleto			Este reporte se lanzó con la nueva fuente de datos. Los desarolladores no necesitan migrar fuera de este reporte.

Mapeo de elementos de datos

antiguo		nuevo
Valor de Report Type	Data Element	Report	Data Element(s)	Notes
GET_VENDOR_SALES_DIAGNOSTIC_REPORT	preOrderedReveue	n/a	n/a	Obsoleto
GET_VENDOR_SALES_DIAGNOSTIC_REPORT	preOrderedUnits	n/a	n/a	Obsoleto
GET_VENDOR_SALES_DIAGNOSTIC_REPORT	orderedRevenue	GET_VENDOR_SALES_REPORT	orderedRevenue
GET_VENDOR_SALES_DIAGNOSTIC_REPORT	orderedUnits	GET_VENDOR_SALES_REPORT	orderedUnits
GET_VENDOR_SALES_DIAGNOSTIC_REPORT	shippedRevenue	GET_VENDOR_SALES_REPORT	shippedRevenue
GET_VENDOR_SALES_DIAGNOSTIC_REPORT	shippedUnits	GET_VENDOR_SALES_REPORT	shippedUnits
GET_VENDOR_SALES_DIAGNOSTIC_REPORT	shippedCogs	GET_VENDOR_SALES_REPORT	shippedCogs
GET_VENDOR_SALES_DIAGNOSTIC_REPORT	glanceViews	GET_VENDOR_TRAFFIC_REPORT	glanceViews
GET_VENDOR_SALES_DIAGNOSTIC_REPORT	conversionRate	n/a	n/a	En desuso, pero se puede calcular: orderedUnits / glanceViews
GET_VENDOR_SALES_DIAGNOSTIC_REPORT	lostBuyBox	n/a	n/a	Obsoleto
GET_VENDOR_SALES_DIAGNOSTIC_REPORT	customerReturns	n/a	n/a	Obsoleto
GET_VENDOR_SALES_DIAGNOSTIC_REPORT	freeReplacements	n/a	n/a	Obsoleto
GET_VENDOR_SALES_DIAGNOSTIC_REPORT	orderedSubcategorySalesRank	n/a	n/a	Obsoleto
GET_VENDOR_SALES_DIAGNOSTIC_REPORT	shippedSubcategorySalesRank	n/a	n/a	Obsoleto
GET_VENDOR_INVENTORY_HEALTH_AND_PLANNING_REPORT	netReceivedAmount	GET_VENDOR_INVENTORY_REPORT	netReceivedAmount
GET_VENDOR_INVENTORY_HEALTH_AND_PLANNING_REPORT	netReceivedUnits	GET_VENDOR_INVENTORY_REPORT	netReceivedUnits
GET_VENDOR_INVENTORY_HEALTH_AND_PLANNING_REPORT	openPurchaseOrderQuantity	GET_VENDOR_INVENTORY_REPORT	openPurchaseOrderQuantity
GET_VENDOR_INVENTORY_HEALTH_AND_PLANNING_REPORT	sellThroughRate	GET_VENDOR_INVENTORY_REPORT	sellThroughRate
GET_VENDOR_INVENTORY_HEALTH_AND_PLANNING_REPORT	sellableOnHandInventory	GET_VENDOR_INVENTORY_REPORT	sellableOnHandInventory
GET_VENDOR_INVENTORY_HEALTH_AND_PLANNING_REPORT	sellableOnHandAmountTrailing30DayAverage	n/a	n/a	Obsoleto
GET_VENDOR_INVENTORY_HEALTH_AND_PLANNING_REPORT	sellableOnHandUnits	GET_VENDOR_INVENTORY_REPORT	sellableOnHandUnits
GET_VENDOR_INVENTORY_HEALTH_AND_PLANNING_REPORT	unsellableOnHandInventory	GET_VENDOR_INVENTORY_REPORT	unsellableOnHandInventory
GET_VENDOR_INVENTORY_HEALTH_AND_PLANNING_REPORT	unsellableOnHandAmountTrailing30DayAverage	n/a	n/a	Obsoleto
GET_VENDOR_INVENTORY_HEALTH_AND_PLANNING_REPORT	unsellableOnHandUnits	GET_VENDOR_INVENTORY_REPORT	unsellableOnHandUnits
GET_VENDOR_INVENTORY_HEALTH_AND_PLANNING_REPORT	aged90PlusDaysSellableInventory	GET_VENDOR_INVENTORY_REPORT	aged90PlusDaysSellableInventory
GET_VENDOR_INVENTORY_HEALTH_AND_PLANNING_REPORT	aged90PlusDaysSellableAmountTrailing30DayAverage	n/a	n/a	Obsoleto
GET_VENDOR_INVENTORY_HEALTH_AND_PLANNING_REPORT	aged90PlusDaysSellableUnits	GET_VENDOR_INVENTORY_REPORT	aged90PlusDaysSellableUnits
GET_VENDOR_INVENTORY_HEALTH_AND_PLANNING_REPORT	unhealthyInventory	GET_VENDOR_INVENTORY_REPORT	unhealthyInventory
GET_VENDOR_INVENTORY_HEALTH_AND_PLANNING_REPORT	unhealthyUnitsTrailing30DayAverage	n/a	n/a	Obsoleto
GET_VENDOR_INVENTORY_HEALTH_AND_PLANNING_REPORT	availableUnits	n/a	n/a	Obsoleto
GET_VENDOR_INVENTORY_HEALTH_AND_PLANNING_REPORT	unhealthyUnits		unhealthyUnits
GET_VENDOR_INVENTORY_HEALTH_AND_PLANNING_REPORT	unfilledCustomerOrderedUnits		unfilledCustomerOrderedUnits
GET_VENDOR_INVENTORY_HEALTH_AND_PLANNING_REPORT	weeksOnHand	n/a	n/a	Obsoleto
GET_VENDOR_INVENTORY_HEALTH_AND_PLANNING_REPORT	receiveFillRate	n/a	n/a	Obsoleto. Ver vendorConfirmationRate
GET_VENDOR_INVENTORY_HEALTH_AND_PLANNING_REPORT	overallVendorLeadTime		overallVendorLeadTime
GET_VENDOR_DEMAND_FORECAST_REPORT	relativeWeek	GET_VENDOR_FORECASTING_REPORT	startDate y endDate	Use startDate y endDate para calcular la semana en relación con el forecastGenerationDate
GET_VENDOR_DEMAND_FORECAST_REPORT	demandForecastType y demandUnits	GET_VENDOR_FORECASTING_REPORT	meanForecastUnits p70ForecastUnits p80ForecastUnits p90ForecastUnits

Ejemplo de Inventory Report (antiguo)

GET_VENDOR_INVENTORY_HEALTH_AND_PLANNING_REPORT

{
    "reportSummary": {
        "reportingDateRange": {
            "reportingDateFrom": "2021-08-01",
            "reportingDateTo": "2021-08-01"
        },
        "distributorView": "MANUFACTURER",
        "currencyCode": "USD"
    },
    "reportDetails": [
        {
            "sellingProgramName": "AMAZON_RETAIL",
            "inventoryHealthMetricsByProgram": [{
                    "asin": "B123456789",
                    "inventoryHealthMetricsByAsin": [{
                            "reportingDate": "2021-08-01",
                            "inventoryHealthMetricsByDate": {
                                "netReceivedAmount": {
                                    "amount": 0.00,
                                    "currencyCode": "USD"
                                },
                                "netReceivedUnits": 0,
                                "openPurchaseOrderQuantity": 0,
                                "sellThroughRate": 0.0000,
                                "sellableOnHandInventory": {
                                    "amount": 0.00,
                                    "currencyCode": "USD"
                                },
                                "sellableOnHandAmountTrailing30DayAverage": {
                                    "amount": 0.00,
                                    "currencyCode": "USD"
                                },
                                "sellableOnHandUnits": 0,
                                "unsellableOnHandInventory": {
                                    "amount": 0.00,
                                    "currencyCode": "USD"
                                },
                                "unsellableOnHandAmountTrailing30DayAverage": {
                                    "amount": 0.00,
                                    "currencyCode": "USD"
                                },
                                "unsellableOnHandUnits": 0,
                                "aged90PlusDaysSellableInventory": {
                                    "amount": 0.00,
                                    "currencyCode": "USD"
                                },
                                "aged90PlusDaysSellableAmountTrailing30DayAverage": {
                                    "amount": 0.00,
                                    "currencyCode": "USD"
                                },
                                "aged90PlusDaysSellableUnits": 0,
                                "unhealthyInventory": {
                                    "amount": 0.00,
                                    "currencyCode": "USD"
                                },
                                "unhealthyUnitsTrailing30DayAverage": 0.00,
                                "unhealthyUnits": 0,
                                "unfilledCustomerOrderedUnits": 0,
                                "availableUnits": 0,
                                "weeksOnHand": 0,
                                "receiveFillRate": 1.0000,
                                "overallVendorLeadTime": 7.26
                            }
                        }
                    ]
                }, { ... }
            ]
        }
    ]
}

Ejemplo de Inventory Report (nuevo)

GET_VENDOR_INVENTORY_REPORT

{
  "reportSpecification": {
    "reportType": "GET_VENDOR_INVENTORY_REPORT",
    "reportOptions": {
      "reportPeriod": "WEEK",
      "sellingProgram": "RETAIL",
      "distributorView": "MANUFACTURING"
    },
    "dataStartTime": "2022-05-22",
    "dataEndTime": "2022-05-28",
    "marketplaceIds": [
      "ATVPDKIKX0DER"
    ]
  },
  "inventoryAggregate": [
    {
      "startDate": "2022-05-22",
      "endDate": "2022-05-28",
      "vendorConfirmationRate": 0.88,
      "netReceivedAmount": {
        "amount": 2345.50,
        "currencyCode": "USD"
      },
      "netReceivedUnits": 278,
      "openPurchaseOrderQuantity": 123,
      "overallVendorLeadTime": 10.2,
      "sellThroughRate": 0.88,
      "sellableOnHandInventory": {
        "amount": 43123.99,
        "currencyCode": "USD"
      },
      "sellableOnHandUnits": 5490,
      "unfilledCustomerOrderedUnits": 12,
      "unsellableOnHandInventory": {
        "amount": 2345.50,
        "currencyCode": "USD"
      },
      "unsellableOnHandUnits": 881,
      "aged90PlusDaysSellableInventory": {
        "amount": 123.50,
        "currencyCode": "USD"
      },
      "aged90PlusDaysSellableUnits": 2234,
      "unhealthyInventory": {
        "amount": 123.45,
        "currencyCode": "USD"
      },
      "unhealthyUnits": 114
    },
    { ...
    }
  ],
  "inventoryByAsin": [
    {
      "startDate": "2022-05-22",
      "endDate": "2022-05-28",
      "asin": "B123456789",
      "vendorConfirmationRate": 0.88,
      "netReceivedAmount": {
        "amount": 2345.50,
        "currencyCode": "USD"
      },
      "netReceivedUnits": 278,
      "openPurchaseOrderQuantity": 123,
      "overallVendorLeadTime": 10.2,
      "sellThroughRate": 0.88,
      "sellableOnHandInventory": {
        "amount": 43123.99,
        "currencyCode": "USD"
      },
      "sellableOnHandUnits": 5490,
      "unfilledCustomerOrderedUnits": 12,
      "unsellableOnHandInventory": {
        "amount": 2345.50,
        "currencyCode": "USD"
      },
      "unsellableOnHandUnits": 881,
      "aged90PlusDaysSellableInventory": {
        "amount": 123.50,
        "currencyCode": "USD"
      },
      "aged90PlusDaysSellableUnits": 2234,
      "unhealthyInventory": {
        "amount": 123.45,
        "currencyCode": "USD"
      },
      "unhealthyUnits": 114
    },
    { ...
    }
  ]
}

Updated over 1 year ago