BERSHKA

INFORMACIÓN DE CONSULTA DE API POR FIRMA (info a guardar)

Raíz de datos

 Categoría (Hombre/Mujer/)
 Subcategoría (Ej: Abrigos, camisas, etc; para traducirlo y volcarlo a nuestra categorización
estandarizada)
Datos de producto

 Firma (marca): BERSHKA

 Número de referencia del producto: displayReference "6529/118" + >color "707"
(color del producto que determina la referencia completa de 10 dígitos):
o URL producto concreto (con el ID contenido en bundleProductSummaries)>
detail> displayReference
o URL producto concreto> detail> colors> nº nodo > id: (número color)
 Nombre del producto: URL producto concreto> name:
 Descripción del producto:
o Descripción genérica del producto: URL producto concreto> detail>
longDescription
o Composición del producto: URL producto concreto> composition> name +
percentage
o Cuidado de la prenda: URL producto concreto> > care> guardar description
de los diferentes nodos.
o Color del producto. URL producto concreto> detail> colors> nº nodo > name
 Precio (Full; artículo sin rebaja): URL producto concreto> detail> colors> nº nodo >
sizes> nº nodo (talla)> price / oldPrice (comprobar que todas las tallas
coinciden)
 Precio (Rebaja, dado el caso): URL producto concreto> detail> colors> nº nodo >
sizes> nº nodo (talla)> price / oldPrice (comprobar que todas las tallas
coinciden)
 Imágenes de producto (todas): URL producto concreto> detail> xmedia> nº nodo
(sacar todas las imágenes) ó xmedia>nº nodo> xmediaItems>nº nodo> medias>
(todas) (usa la vía que te permina descargar todas las fotos de cada prenda y
variante (color) independiente)
 Imagen de muestra de la prenda: Localizar en las imágenes de la URL la que está la prenda
solo, verificar si su posición numérica en el nodo; verificar si es un patrón organizativo
extrapolable a los demás productos, y si es así guardar siempre esa imagen en el campo imagen
de muestra de la prenda.
 Imagen muestra color producto: – URL producto concreto> detail> colors> nº nodo>
image
 Tallas
o Nomenclatura para las tallas: URL producto concreto> detail> colors> nº nodo
> sizes> nº nodo> name:(talla) (SERÁN SIEMPRE GUARDADAS DE MENOR A MAYOR
talla)
o Disponibilidad numérica / stock genérico: *** se explica en un esquema
posterior
  URL de compra del producto: link directo al producto en web propia (Web y App si se
proporciona): Url producto concreto> productUrl (No estoy realmente seguro, haz
algún test a ver si sacas la URL directa de cada variante de producto concreta
(producto en color concreto) y nos cuentas cuando la tengas.
 Sección: sectionName: “HOMBRE” / ”MUJER”
 Tipo de producto: Url producto concreto> detail> familyInfo> familyName
 Subtipo de producto: Url producto concreto> detail> subfamilyInfo> subfamilyName
 Producto nuevo o no: contenido en el nodo especificado en el documento general
(name: “NUEVO”)

NOTA** Disponibilidad numérica / stock genérico: *** se explica en un esquema posterior.

Puedes usar cualquier ejemplo para verificar la explicación:

- https://www.bershka.com/itxrest/2/catalog/store/44009500/40259530/category/1010193212/prod
uct/102294890/detail?languageId=-5

Para consultar el stock tendremos en cuenta el ID de cada talla en concreto y su nombre (name) para
ordenarlas en la BD (URL producto concreto> detail> colors> nº nodo > sizes> nº nodo
(talla)> id talla) y el ID de producto (el contenido en bundleProductSummaries, como se ha
especificado). Este ID de producto lo usaremos para formar la siguiente URL de stock:

- https://www.bershka.com/itxrest/2/catalog/store/44009500/40259530/product/stock?
productIds=102294890

Al colocar el ID del producto, la URL nos aporta toda la información relativa al stock de las diferentes
variantes (colores) que componen el producto, es decir, la información de stock del producto al
completo. La estructura quedaría tal que así:

También podemos hacer consultas de varias IDs, es decir, que podemos hacer consultas por lotes de
productos (subcategorías, por ejemplo). Para ello usaremos la misma estructura de URL separando los
identificadores por comas:

Protocolo para organizar los productos guardados.

Para encontrar los productos barreremos directamente las subcategorías de los nodos de la URL
PRINCIPAL. Dentro de ellas encontraremos los productos dentro del nodo bundleProductSummaries
cumpliendo las premisas: id: (X); type: "ProductBean".

Como hemos mencionado anteriormente, guardaremos el ID de producto y el displayReference

completo de cada variante.

NOTA**: Todos los productos que comparten la primera parte del displayReference 9 caracteres, son
los mismos. Se diferencian unos de otros por los 3 caracteres siguientes, que marcan el color. Por lo
tanto, agruparemos los productos que compartan la primera estructura en diferentes variantes del
mismo producto. Ej de producto ficticio:

- Id: “8815038” / type: "ProductBean" / name: "ABRIGO HANDMADE LANA"

displayReference: " 6451/523"
o color: id: " 432" / name: "PIEDRA"
o color: id: " 805" / name: "HIELO"
o Referencias exactas de cada variante del producto:
 displayReference: "6451/523/432"
 displayReference: "6451/523/805"

NOTA**: al acceder a la URL de un producto o de una subcategoría concreta no tendremos en cuenta lo

contenido en el nodo relatedCategories; y que en él se aporta toda la información sobre los
productos que son recomendados para el producto principal que estamos comentando. Para evitar líos
y confusiones, bajo ningún concepto se lee ni se accede a dicho nodo relatedCategories de
momento.

Tomemos por ejemplo todos los productos contenidos en la subcategoría abrigos.

En el caso de BERSHKA, en la subcategoría abrigos, a diferencia de otras firmas, todo lo toma bajo una
clasificación (familyName y subfamilyName) muy genérica que no nos sirve para categorizar al detalle
cada tipo de prenda. Por tanto, no podemos diferenciar por ejemplo mediante esos tags si dentro de
abrigos las prendas son anoraks, gabardinas, abrigos, chalecos, etc. Dada la situación, utilizaremos la
información de nombre del producto (name: "Anorak largo mostaza") para poder categorizarlos.
Todos los nombres de los diferentes productos de la firma comienzan con la palabra que determina el
tipo de producto que es: camisa blanca de cuadros. De este modo, podemos deducir la siguiente
estructura para guardar los datos:

- Anorak largo mostaza > Abrigo (X).

De este modo, identificaremos la palabra Anorak al inicio del nombre de la prenda y la integraremos en
la subcategoría propia y estandarizada que queramos. La tabla de traducción inicio de nombre de
producto-categoría estándar se muestra posteriormente.

NODOS de las categorías principales de la firma (categories). Pueden cambiar, filtrar por NAME:

 0 name "MUJER"; id 1010193132 (MUJER)

 4 name "HOMBRE"; id 1010193133 (HOMBRE)

MUJER
  "MUJER"; subcategorías principales (subcategories) + subcategorías de la
subcategoría (>subcategories). Es necesario que, al entrar a barrer las subcategorías,
entremos no solo al ID genérico, sino también a los diferentes IDs de las subcategorías de
las propias subcategorías principales.

Ej: Al barrer ABRIGOS, no nos valdrá con entrar al ID genérico de abrigos, si no que deberemos entrar
a los IDS de sus diferentes subcategorías dentro de ABRIGOS para no dejarnos productos fuera (puede
ocurrir que en el ID principal no aparezcan).

o 0>1>10: id 1010193212; name: “Chaquetas y abrigos”

 Subcategorías de la subcategorie “ABRIGOS”
 0; name: "Ver Todo"; id: 1010193259
 1; name: "Cazadoras"; id: 1010193261
 2; name: "Abrigos"; id: 1010193260
 3; name: "Puffy"; id: 1010313020
 4; name: "Bikers"; id: 1010196003
 5; name: "Blazers"; id: 1010193258
 6; name: "Efecto piel"; id: 1010398008
 7; name: "Pelo"; id: 1010200503
 5; name: "Borrego"; id: 1010258510
 6; name: "Denim"; id: 1010212502
 7; name: "Chalecos"; id: 1010193262
 6; name: "Parkas"; id: 1010393005
 7; name: "Chaquetas de invierno"; id: 1010394625

**NOTA: Todos los productos que no cumplan los criterios establecidos en las tablas de clasificación
que se muestran en las páginas posteriores; y por ende no puedan categorizarse automáticamente,
serán enviados a la categoría “SIN CATEGORIZAR” dentro de la firma que solo podrá ser vista por
nosotros en la base de datos y no se mostrará posteriormente al público. Los productos que acaben en
esta categoría serán revisados previo aviso-alerta por parte de la base de datos, reubicados e incluidos
sus patrones de clasificación para futuros productos que la firma añada con las mismas características.
CATEGORIZACIÓN BERSHKA (GUARDADO)
BERSHKA >MUJER
TRADUCIÓN PARA CATEGORIZACIÓN
Subcategoría estándar de Subcategoría de la Orden de productos de la firma basado en
nuestra BD subcategoría estándar name: "nombre” del producto
Todo lo contenido en el nodo especificado.
1. NOVEDADES
ABRIGO; PARKA; CHAQUETÓN; SOBRECAMISA
2.1. ABRIGOS PARKA;

CAZADORA; CHAQUETA; BOMBER;

SOBRECAMISA; BIKER:
2.2. CAZADORAS
ANORAK; GABARDINA; TRENCH; CHAQUETA
TRENCH; CHUBASQUERO; CORTAVIENTOS;
PLUMÍFERO; CHAQUETA ACOLCHADA;
PLUMAS; CAZADORA ACOLCHADA; ABRIGO
2.3. ANORAKS Y
ACOLCHADO;
GABARDINAS
CHALECO;
2. ABRIGOS Y 2.4. CHALECOS
PONCHO;
CAZADORAS 2.5. OTROS
BLASIER; BLAZER; AMERICANA;
7. BLAZER
4.1. VESTIDOS VESTIDO; CAFTÁN; KAFTÁN; KIMONO; PICHI;

4.2. FALDAS FALDA; MINIFALDA;

8. VESTIDOS Y FALDAS
MONO; PETO; KIMONO;
10.MONOS
6.1. CAMISAS Y BLUSAS CAMISA; BLUSA: BLUSÓN;

6.2. TOPS TOP; CUERPO;

11.CAMISAS Y BLUSAS
CAMISETA;
13.CAMISETAS Y TOPS
8.1. JERSÉIS JERSEY; JERSEI;

CÁRDIGAN; CAPA; CAPA PUNTO; CHAQUETA

PUNTO; (CONTENGA) CHAQUETA – PUNTO;
CHAQUETA CROCHET; (CONTENGA)
8.2. CARDIGANS CHAQUETA-PUNTO
14.JERSÉIS Y
8.3. POLOS POLO;
CÁRDIGANS
SUDADERA; VESTIDO SUDADERA;
17.SUDADERAS
10.1. PANTALONES PANTALÓN; CULOTTE;

10.2. LEGGINS LEGGINS; LEGGING;

18.PANTALONES Y
10.3. SHORTS BERMUDA; SHORTS; PANTALÓN CORTO
SHORTS
JEANS; VAQUERO; VAQUEROS; PANTALÓN
VAQUERO; SHIMMER; PANTALÓN TEJANERO;
21.JEANS PANTALÓN SARGA; JEGGIN;
 22.BODIES Y BODY; BRALETTE;
BRALETTES

13.1. BOTAS Y BOTINES BOTÍN; BOTIN; BOTA; ANKLE;

13.2. ZAPATOS ZAPATO; MULE; ZUECO; ZUECOS; SALÓN;

13.3. MOCASINES MOCASÍN; MOCASIN; MOCASINES;

DEPORTIVO; DEPORTIVAS; BAMBA; ZAPATILLA

13.4. DEPORTIVAS URBANA; JOG; BOTINES DEPORTIVOS;

13.5. SANDALIAS Y SANDALIA; ALPARGATA; BABUCHA; BAILARINA;

23.CALZADO ALPARGATAS CUÑA; HAVAIANAS; PALA;

BOLSOS; MAXI BOLSO; MINI BOLSO; MOCHILA;

RIÑONERA; BANDOLERA; MINI BANDOLERA;
CAPAZO; MINI CAPAZO; ORGANIZADR DE
14.1. BOLSOS Y BOLSO; POCHETTE; SHOPPER; BOMBONERA;
MOCHILAS BOLSA; SHOPPING BAG; POUCH;

MONEDERO; BILLETERA; BILLETERO;

14.2. MONEDEROS Y NECESER; CLUTCH; TARJETERO; SOBRE;
14. BOLSOS Y MOCHILAS NECESERES ESTUCHE; CARTERA;

15.ACCESORIOS Y BUFANDA; PAÑUELO; FULAR; FOULARD; MAXI

COMPLEMENTOS 15.1. BUFANDAS Y BUFANDA; CHAL; BANDANA; SNOOD; ESTOLA;
PAÑUELOS PAÑOLETA;

14.2. GORROS Y GORRO; GORRA; SOMBRERO; BOINA; BEANIE;

SOMBREROS TURBANTE;

15.3. GUANTES GUANTES; PUÑOS; MITONES;

15.4. CINTURONES CINTURÓN; PACK CINTURONES;

GAFAS DE SOL; (CONTENGA) CADENA -

GAFAS; GAFAS; (CONTENGA) CORDÓN -
15.5. GAFAS DE SOL GAFAS;

15.6. BISUTERÍA COLLAR; (CONTENGA) SET – COLLARES;

PENDIENTES; ANILLO; EAR CUFF; SET
PENDIENTES; (CONTENGA) SET- PENDIENTES;
PULSERA; PULSERAS; SET ANILLOS;
(CONTENGA) SET – ANILLOS; PACK ANILLOS;
PACK 5 ANILLOS; PACK 8 ANILLOS; PACK
 PULSERAS; PACK 4 PULSERAS; SET
PULSERAS; PACK PENDIENTES; PACK 2
PENDIENTES; PACK 3 PENDIENTES; PACK 4
PENDIENTES; PACK 5 PENDIENTES; PACK 8
PENDIENTES; PACK 20 PENDIENTES;
COLETERO; (CONTENGA)PACK - COLETEROS;
PACK 2 COLETEROS; (CONTENGA) PACK-
COLETEROS; PACK 3 COLETEROS;
HORQUILLAS; PACK HORQUILLAS; PACK 3
HORQUILLAS; PACK 4 HORQUILLAS; AROS;
PACK AROS; PACK 2 AROS; PACK 3 AROS;
PACK 6 AROS; (CONTENGA) SET – AROS;
CADENA; CHÓKER; PACK CHÓQUER; CHOKER;
PACK CHOQUER; PACK 2 CHÓKER; PACK 2
CHOKER; DIADEMA; PACK DIADEMAS;
CADENA; (CONTENGA) SET CLIPS;
PASADORES;

15.7. RELOJES

SET 2 PASADORES; SET 3 PASADORES;

PASADOR; PASADORES; DIADEMA; SET 3
GOMAS PELO SET 3 GOMAS PELO; SET
GOMAS PELO PARAGUAS; SET PASADORES
PELO; AURICULARES; FUNDA; FUNDAS;
(CONTENGA) SET – FUNDAS; BOTELLA;
BATERÍA; CABLE; CARGADOR; ALTAVOZ;
CARCASA; AGENDA; BOLÍGRAFO; (CONTENGA)
15.8. OTROS SET – LÁPICES;

23.1.BRAGUITAS Y TANGA; BRAGA; BRAGUITA;

TANGAS
16.2. MEDIAS Y PANTYS MEDIAS-PANTYS; MEDIAS; PANTYS; PANTIES;

CALCETIN; CALCETINES; (CONTENGA) PACK -

16.3. CALCETINES CALCETINES;

16.4. SUJETADORES SUJETADOR;

16.5. BODIES Y
BRALETTES

COPAS; TAPAPEZONES; ALMOHADILLA PUSH;

16.5 ACCESORIOS ROPA REGULADORES; REGULADOR; LIGA;
INTERIOR Y LENCERÍA TIRANTES; CLIP ESPALDA; ADHESIVO;
23.ROPA INTERIOR
PACK PIJAMA; PIJAMA:
29.MODA PARA DORMIR
 BAÑADOR; (CONTENGA) TOP-BIKINI;
(CONTENGA) BRAGUITA-BIKINI
30.MODA DE BAÑO
31. DEPORTE

32. PREMAMÁ

33.TALLAS GRANDES

34.BEAUTY QUE CONTENGA “PARFUM”; QUE CONTENGA

EAU”; PERFUME; ESMALTE; BODY MIST;

ADEMÁS DE LOS TÉRMINOS, TODO LO

CONTENIDO EN LA SUBCATEGORÍA NAME:
COSMÉTICA. RUTA:
MUJER>COLECCIÓN>COSMÉTICA.

35.PROMOCIONES Todo lo contenido en el nodo especificado.

CATEGORIZACIÓN BERSHKA (GUARDADO)
BERSHKA >HOMBRE
TRADUCIÓN PARA CATEGORIZACIÓN
Subcategoría estándar de nuestra Subcategoría de la Orden de productos de la firma basado
BD subcategoría estándar en shortDescription: "nombre”
Todo lo contenido en el nodo
especificado.
1. NOVEDADES
2.1. ABRIGOS ABRIGO; PARKA;

2.2. CHAQUETONES Y CAZADORA; CHAQUETA; BOMBER;

CAZADORAS CHAQUETÓN; SOBRECAMISA;

ANORAK; GABARDINA; TRENCH;

CHAQUETA TRENCH; CHUBASQUERO;
CORTAVIENTOS; CHAQUETA PLUMAS;
CAZADORA PLUMAS: PLUMÓN;
CAZADORA ACOLCHADA; ABRIGO
ACOLCHADO; (CONTENGA)
CAZADORA – ACOLCHADA;
2.3. ANORAKS Y
(CONTENGA) PUFFY;
GABARDINAS
CHALECO;
2.4. CHALECOS
PONCHO;
2. ABRIGOS Y CAZADORAS 2.5. OTROS
BLASIER; BLAZER; AMERICANA;
CHALECO TRAJE;
7. BLAZER
4.1 JERSÉIS JERSEY; JERSEI;

4.2 CÁRDIGANS CÁRDIGAN; CAPA;

4.3 POLOS POLO;
8. JERSÉIS Y CÁRDIGANS
SUDADERA;
11.SUDADERAS
CAMISA; BLUSA;
12.CAMISAS Y BLUSAS
CAMISETA;
13.CAMISETAS
8.1. PANTALONES PANTALÓN; JOGGER;

8.2. SHORTS Y BERMUDA; SHORTS; PANTALÓN

BERDMUDAS CORTO;
14.PANTALONES Y SHORTS
JEANS; VAQUERO; VAQUEROS;
PANTALÓN TEJANERO; PANTALÓN
16.JEANS VAQUERO; PANTALÓN TEJANO;

17.CALZADO 10.1. BOTAS Y BOTINES BOTÍN; BOTIN; BOTA; BOTA; BOTINES;

10.2. MOCASINES
MOCASÍN; MOCASINES; KIOWA;
 ZAPATO KIOWA; NÁUTICO; NAUTICO;

10.3. ZAPATOS ZAPATO; MULE; ZAPATOS; BLUCHER;

DEPORTIVO; DEPORTIVAS; SNEAKER;

SNEAKERS; BAMBA; ZAPATILLA;
10.4. DEPORTIVAS BOTINES DEPORTIVOS;

SANDALIA; ALPARGATA; BABUCHA;

10.5. SANDALIAS Y SANDALIAS; ALPARGATAS;
ALPARGATAS BABUCHAS; SLIPPER;

BOLSOS; BOLSO; MAXI BOLSO; MINI

BOLSO; MOCHILA; RIÑONERA;
BANDOLERA; CAPAZO; MINI CAPAZO;
11.1. BOLSOS Y ORGANIZADR DE BOLSO; MALETÍN;
MOCHILAS MALETA; WEEKENDER; CHEST BAG;

MONEDERO; BILLETERA; BILLETERO;

NECESER; CLUTCH; TARJETERO;
11. BOLSOS Y MOCHILAS 11.2. BILLETERAS SOBRE; ESTUCHE; CARTERA;

12. ACCESORIOS Y 12.1. BUFANDAS Y BUFANDA; PAÑUELO; FULAR;

COMPLEMENTOS PAÑUELOS FOULARD; MAXI BUFANDA; SNOOD;

12.2. GORROS Y GORRO; GORRA; SOMBRERO; BOINA;

SOMBREROS BEANIE;
12.3. GUANTES GUANTES; PUÑOS;

12.4. CINTURONES Y CINTURÓN; TIRANTES; TIRANTE;

TIRANTES

12.5 CORBATAS Y CORBATA; PAJARITA: FAJÍN;

PAJARITAS CONJUNTO FAJÍN PAJARITA;

12.6. GAFAS DE SOL GAFAS DE SOL; CADENA; GAFAS;

12.7. BISUTERÍA COLLAR; PENDIENTES; ANILLO;

(CONTENGA) PACK - ANILLO;
(CONTENGA) PACK - ANILLOS; EAR
CUFF; SET PENDIENTES; PULSERA;
PULSERAS; SET ANILLOS; PACK
PULSERAS; SET PULSERAS; CADENA;
(CONTENGA) SET – PULSERAS;
(CONTENGA) SET – ANILLO;
 (CONTENGA) SET – COLLARES;

12.8. RELOJES RELOJ;

SET 2 PASADORES; SET 3

PASADORES; PASADOR; PASADORES;
DIADEMA; SET 3 GOMAS PELO;
PARAGUAS; SET PASADORES PELO;
AURICULARES; FUNDA; (CONTENGA)
SET – CARCASAS; (CONTENGA) SET –
FUNDAS; BOTELLA; BATERÍA; CABLE;
CARGADOR; ALTAVOZ; LLAVERO;
GEMELOS; BROCHE; PARCHE; PINZA;
MOSQUETÓN; (CONTENGA) SET –
12.8. OTROS MOSQUETONES;

CALZONCILLO; BÓXER; BOXER; PACK

2 BOÓXERS; SLIP; (CONTENGA) PACK
21.1.BÓXERS Y
– BOXERS;
CALZONCILLOS
CALCETIN; CALCETÍN; CALCETINES;
PACK 2 CALCETINES; PACK 3
CALCETINES; (CONTENGA) PACK
-CALCETINES; (CONTENGA) SET –
ROPA INTERIOR; (CONTENGA) SET –
16.2. CALCETINES CALCETINES;
21.ROPA INTERIOR
PACK PIJAMA; PIJAMA:
23.MODA PARA DORMIR
BAÑADOR;
24.MODA DE BAÑO
25. DEPORTE

26.BEAUTY FRAGANCE; QUE CONTENGA

“PARFUM”; (CONTENGA) EAU”;
PERFUME; EAU DE TOILETTE;

27.PROMOCIONES Todo lo contenido en el nodo

especificado.