Tutorial: Recuperar automáticamente los reportes generados

Cómo obtener reportes de Amazon para ayudar a los selling partners a gestionar su negocio.

Versión de la API: 2021-06-30

Tutorial: Recuperar los reportes que se generan de forma automática

Utilice el siguiente proceso para la solicitud de un reporte generados automáticamente:

  1. Periódicamente la encuesta de la cola de Amazon SQS para REPORT_PROCESSING_FINISHED la notificación de eventos que proporciona información cuando el reporte de procesamiento de se CANCELLED, DONE o FATAL. El evento de notificación incluye un valor reportDocumentId si no hay reporte de los datos disponibles.

  2. Para cada uno reportDocumentId que representa un reporte que desea recuperar:

    1. Llame a la operación getReportDocument, pasando el valor reportDocumentId.

      Amazon devuelve un pre-firmado dirección URL de la ubicación del documento de reporte, y el algoritmo de compresión utilizado si el documento de reporte, los contenidos han sido comprimido.

    2. Descargar el reporte.

Requisitos previos

Los siguientes elementos son necesarios para completar con éxito este tutorial:

  • Uno o más tipos de reporte para descargar después de que el reporte de datos está disponible. Consulte valores de reportType para obtener una lista de tipos de reporte.
  • Autorización del selling partner para el cual estás realizando las llamadas. Consulta la Guía de la Selling Partner API para desarollador para más información.
  • Una instalación funcional de Java Development Kit (JDK) para ejecutar código de ejemplo.

Pasos

  1. Recuperar información acerca de los reportes que pueden ser descargados
  2. Recuperar el reporte

Paso 1. Recuperar información acerca de los reportes que pueden ser descargados

  1. Puedes realizar un seguimiento periódico de la cola de Amazon SQS para verificar si has recibido una notificación sobre los reportes generados por Amazon. Para confirmar que el procesamiento del reporte está completo consulte Cómo comprobar que el reporte que el proceso esté completo.

El REPORT_PROCESSING_FINISHED evento de notificación contiene el reportDocumentId, que puede ser utilizado para descargar el reporte.

  1. Para cada uno reportDocumentId que representa un reporte que desea recuperar, guardar el reportDocumentId y vaya al Paso 2 para recuperar el reporte.

Respuesta ejemplo:

{
  "reportes": [
    {
      "reportType": "GET_V2_SETTLEMENT_REPORT_DATA_FLAT_FILE",
      "processingEndTime": "2021-08-03T01:02:25+00:00",
      "processingStatus": "DONE",
      "marketplaceIds": [
        "ATVPDKIKX0DER"
      ],
      "reportDocumentId": "DOC-b8b0-4226-b4b9-0ee058ea5760",
      "reportId": "ID222",
      "dataEndTime": "2021-08-03T01:02:25+00:00",
      "createdTime": "2021-08-03T01:02:25+00:00",
      "processingStartTime": "2021-08-03T01:02:25+00:00",
      "dataStartTime": "2021-08-03T01:02:25+00:00"
    }
  ]
}

Paso 2. Recuperar el reporte

Para recuperar un reporte, consulte Recuperar un reporte.