Produse și atribute

Când se schimbă doar prețul sau disponibilitatea, nu retrimite meniul întreg: ai operații dedicate, fără limita de 5 pe zi.

Operație	Metodă și cale	Sincron?
Modificare produs	POST /api/v3/item/modify/stores/{storeId}/products/{productId}	da
Modificare atribut	POST /api/v3/item/modify/stores/{storeId}/attributes/{attributeId}	da
Actualizare în masă	POST /api/v3/item/modify/stores/{storeId}/bulk	nu
Verificare status bulk	GET /api/v3/item/modify/checkstatus/bulk/{trackingCode}	—

Modificarea unui produs

POST /api/v3/item/modify/stores/gi20__001/products/18411340
Authorization: cheia-ta-api
Content-Type: application/json

{
  "price": 47.5,
  "available": true
}

Câmp	Tip	Efect
price	Number	Prețul nou. Absent sau null → nu se modifică.
available	Boolean	Disponibilitatea. Absent sau null → nu se modifică.

Absent nu înseamnă zero

Ca să schimbi doar disponibilitatea, trimite doar available. Dacă trimiți price: 0, chiar setezi prețul la zero — nu este același lucru cu a-l lăsa neatins.

Modificarea unui atribut

POST /api/v3/item/modify/stores/gi20__001/attributes/17876412
Authorization: cheia-ta-api
Content-Type: application/json

{
  "price_impact": 1.5,
  "available": true
}

Atributele folosesc price_impact, nu price: valoarea reprezintă adaosul peste prețul produsului, nu un preț de sine stătător.

Actualizarea în masă

Pentru schimbări multe deodată — de exemplu disponibilitatea de dimineață pentru tot meniul:

POST /api/v3/item/modify/stores/gi20__001/bulk
Authorization: cheia-ta-api
Content-Type: application/json

{
  "products": [
    { "id": "18411340", "price": 47.5, "available": true },
    { "id": "18412870", "available": false }
  ],
  "attributes": [
    { "id": "17876412", "price_impact": 2.0, "available": true }
  ]
}

Operația este asincronă: primești un cod de urmărire și verifici rezultatul separat.

GET /api/v3/item/modify/checkstatus/bulk/{trackingCode}
Authorization: cheia-ta-api

Nu presupune că a mers

Ca la actualizarea de meniu, răspunsul imediat confirmă doar primirea. Un produs cu identificator inexistent nu oprește restul lotului — află din verificarea de status care linii au eșuat.

Cum alegi între ele

Situație	Ce folosești
S-a terminat un produs	modificare individuală
Deschiderea de dimineață, zeci de produse	bulk
Listă de prețuri nouă	bulk
Produs nou, categorie nouă, denumire schimbată	actualizare completă

Modificările individuale nu pot crea sau șterge produse. Ele operează pe identificatori care există deja în meniu; orice schimbare de structură trece printr-o actualizare completă.

Specificația completă a câmpurilor și a răspunsurilor: referința API.