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:
-
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 seCANCELLED
,DONE
oFATAL
. El evento de notificación incluye un valorreportDocumentId
si no hay reporte de los datos disponibles. -
Para cada uno
reportDocumentId
que representa un reporte que desea recuperar:-
Llame a la operación
getReportDocument
, pasando el valorreportDocumentId
.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.
-
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
Paso 1. Recuperar información acerca de los reportes que pueden ser descargados
- 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.
- Para cada uno
reportDocumentId
que representa un reporte que desea recuperar, guardar elreportDocumentId
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.
Updated over 1 year ago