En esta guía te explicaremos cómo acceder a la descarga de los reportes de oferta general y por canal de venta de todos tus productos, de esta manera, comparas e identificas qué productos requieren actualización y así optimizar el número de peticiones diarias a la API.
Índice
1. Especificaciones de la descarga.
2. Endpoint.
3. Respuesta.
4. Consideraciones.
1. Especificaciones de la descarga
- Puedes hacer 1 petición cada 12 horas.
- La descarga del catálogo es completa, no hay filtros sobre la información.
2. Endpoint
POST /shops/{shop_pk}/reports/offers/
3. Respuesta
{
"url": "http://md0ihdewcx.cloudfront.net/tmp/1m/stock-76-1656542874.json"
}
El archivo es un formato json con la siguiente estructura:
[
{
"pk": 17992,
"parent_pk": null,
"sku_simple": "99121424625",
"sku": "99121424625",
"stock": 1,
"price": 173.7,
"created_at": "2020-06-02T03:14:08",
"channels": {
"7": {
"discount": null,
"discount_from": "2021-11-09 00:00:00",
"discount_to": "2021-11-17 00:00:00",
"discount_type": "percentage"
},
"12": {
"discount": null,
"discount_from": "2021-11-09 00:00:00",
"discount_to": "2021-11-29 00:00:00",
"discount_type": "percentage"
},
"13": {},
"17": {},
"1204": {},
"1205": {},
"1901": {
"discount": null,
"discount_type": "percentage"
},
"1902": {},
"2102": {},
"2201": {
"discount": null,
"discount_type": "percentage"
},
"2401": {
"discount": null,
"discount_from": "2021-11-09 00:00:00",
"discount_to": "2021-11-17 00:00:00",
"discount_type": "percentage"
},
"2501": {},
"3101": {
"discount": null,
"discount_to": "2021-11-17 00:00:00",
"discount_type": "percentage"
},
"3401": {
"stock": 0,
"price": null,
"discount": null,
"discount_from": "2021-11-09 00:00:00",
"discount_to": "2021-11-21 00:00:00",
"discount_type": "percentage"
}
}
},
{
"pk": 17993,
"parent_pk": null,
"sku_simple": "991214331",
"sku": "991214331",
"stock": 63,
"price": 257.85,
"created_at": "2020-06-02T03:14:09",
"channels": {
"7": {
"discount": null,
"discount_from": "2021-11-09 00:00:00",
"discount_to": "2021-11-17 00:00:00",
"discount_type": "percentage"
},
"12": {
"discount": null,
"discount_from": "2021-11-09 00:00:00",
"discount_to": "2021-11-29 00:00:00",
"discount_type": "percentage"
},
"13": {},
"17": {},
"1204": {},
"1205": {},
"1901": {
"discount": null,
"discount_type": "percentage"
},
"1902": {},
"2102": {},
"2201": {
"discount": null,
"discount_type": "percentage"
},
"2401": {
"discount": null,
"discount_from": "2021-11-09 00:00:00",
"discount_to": "2021-11-17 00:00:00",
"discount_type": "percentage"
},
"2501": {},
"3101": {
"discount": null,
"discount_to": "2021-11-17 00:00:00",
"discount_type": "percentage"
},
"3401": {
"stock": 0,
"price": null,
"discount": null,
"discount_from": "2021-11-09 00:00:00",
"discount_to": "2021-11-21 00:00:00",
"discount_type": "percentage"
}
}
}
]
4. Consideraciones:
- La respuesta será inmediata, sin embargo, el archivo puede tardar un par de minutos en estar disponible.
- En caso de que se solicite un reporte antes de las 12 horas permitidas, el código de respuesta de la petición será un 429 con un mensaje de error como el siguiente:
{
"message": "El reporte se puede procesar cada 12h. El desbloqueo termina 2022-08-11 04:02:10.350432"
}
Para cualquier duda y/o aclaración, ponte en contacto con tu KAM asignado o escribiendo a soporte@yuju.io.