# Εισαγωγές προϊόντων προς WooCommerce

### `backorders` (string, προαιρετικό)

Προσδιορίζει αν το προϊόν έχει backorders, και αν ο πελάτης μπορεί να ειδοποιηθεί. Οι αποδεκτές τιμές είναι `no`, `notify` ή `yes`.
Τιμές:

- `no`: Δεν επιτρέπονται backorders
- `notify`: Επιτρέπονται backorders αλλά ειδοποιείται ο πελάτης
- `yes`: Επιτρέπονται backorders

### `brands` (string, προαιρετικό)

Μία ή περισσότερες μάρκες διαχωρισμένες με `,` (κόμμα).
Κάθε μάρκα μπορεί να αντιστοιχηθεί με άλλο όνομα στα mappings, διαφορετικά πρέπει να ταιριάζει με το όνομα της μάρκας στο WooCommerce. Μάρκες που δεν βρίσκονται αγνοούνται.
Στα variable προϊόντα ισχύει μόνο για το variable προϊόν, όχι για τα variations.
Π.χ. `Nike, Adidas`.

### `catalog_visibility` (string, προαιρετικό)

Προσδιορίζει αν το προϊόν είναι ορατό στον κατάλογο και διαθέσιμο για αναζήτηση. Οι αποδεκτές τιμές είναι `visible`, `catalog`, `search` ή `hidden`.
Τιμές:

- `visible`: Κατάστημα και αποτελέσματα αναζήτησης
- `catalog`: Μόνο κατάστημα
- `search`: Μόνο αποτελέσματα αναζήτησης
- `hidden`: Απόκρυψη

### `categories` (string, προαιρετικό)

Μπορεί να έχει μία ή περισσότερες κατηγορίες, διαχωρισμένες με `,` (κόμμα), `;` (ερωτηματικό) ή `|` (κάθετος).
Το διαχωριστικό ορίζεται στις ρυθμίσεις κατηγοριών και είναι ένα για όλες τις εισαγωγές. Το προεπιλεγμένο είναι το `,` (κόμμα).
Κάθε κατηγορία μπορεί να αντιστοιχηθεί με άλλο όνομα στα mappings, διαφορετικά πρέπει να ταιριάζει με το όνομα της κατηγορίας στο WooCommerce.
Οι υποκατηγορίες διαχωρίζονται με το σύμβολο `>` (μεγαλύτερο από).
Π.χ. `Αντρικά > Μπλούζες > T-Shirts, Αντρικά > Προσφορές`. Αν ένα προϊόν δεν έχει κατηγορία, θα χρησιμοποιηθεί η προεπιλεγμένη κατηγορία από τις ρυθμίσεις.

### `code` (string, προαιρετικό)

Ο κωδικός του προϊόντος για να ομαδοποιηθούν variation προϊόντα σε variable προϊόντα.
Π.χ. αν δύο προϊόντα έχουν τον ίδιο `code`, θα εισαχθούν ως παιδιά του ίδιου variable προϊόντος.
Αν ένα προϊόν δεν έχει `code`, θα εισαχθεί ως simple προϊόν.
Αν ένα προϊόν έχει `code` ίδιο με το `sku` του, θα εισαχθεί ως simple προϊόν.

### `cross_sell_ids` (string, προαιρετικό)

Ένα ή περισσότερα SKU διαχωρισμένα με `,` (κόμμα).
Περιλαμβάνει το SKU κάθε προϊόντος που έχει προσδιοριστεί ως cross-sell.
Π.χ. `HERO-S,ORION-S,AERO-S`.

### `date_on_sale_from` (string, προαιρετικό)

Η ημερομηνία πρέπει να έχει μορφή `YYYY-MM-DD` ή `YYYY-MM-DD hh:mm:ss`.
Αν είναι κενό, θα αγνοηθεί.

### `date_on_sale_to` (string, προαιρετικό)

Η ημερομηνία πρέπει να έχει μορφή `YYYY-MM-DD` ή `YYYY-MM-DD hh:mm:ss`.
Αν είναι κενό, θα αγνοηθεί.

### `description` (string, προαιρετικό)

Η περιγραφή του προϊόντος.

### `featured` (boolean, προαιρετικό)

Επισήμανση προϊόντος ως προβεβλημένο.
Οι αποδεκτές τιμές είναι: `1`, `true`, `on`, `yes`, και `0`, `false`, `off`, `no`.
Μπορούν να οριστούν διαφορετικές αποδεκτές τιμές μέσω των mappings.

### `global_unique_id` (string, προαιρετικό)

Ο κωδικός GTIN, UPC, EAN ή ISBN του προϊόντος.
Πρέπει να είναι μοναδικός για κάθε προϊόν.
Στα variable προϊόντα ισχύει μόνο για τα variations.
Π.χ. `5201234567890`.

### `height` (float, προαιρετικό)

Το ύψος του προϊόντος, στη μονάδα μέτρησης διαστάσεων που έχει οριστεί στο WooCommerce.
Το σύμβολο διαχωρισμού δεκαδικών μπορεί να είναι `.` (τελεία) ή `,` (υποδιαστολή).
Στα variable προϊόντα ισχύει μόνο για τα variations.

### `images` (string, προαιρετικό)

Μία ή περισσότερες εικόνες διαχωρισμένες με `,` (κόμμα).
Κάθε εικόνα πρέπει να είναι μια έγκυρη διεύθυνση URL, π.χ. `https://www.example.com/product.jpg`.

### `length` (float, προαιρετικό)

Το μήκος του προϊόντος, στη μονάδα μέτρησης διαστάσεων που έχει οριστεί στο WooCommerce.
Το σύμβολο διαχωρισμού δεκαδικών μπορεί να είναι `.` (τελεία) ή `,` (υποδιαστολή).
Στα variable προϊόντα ισχύει μόνο για τα variations.

### `manage_stock` (boolean, προαιρετικό)

Διαχείριση αποθέματος σε επίπεδο προϊόντος.

### `name` (string, προαιρετικό)

Όνομα προϊόντος.

### `regular_price` (float, προαιρετικό)

Το σύμβολο διαχωρισμού δεκαδικών μπορεί να είναι `.` (τελεία) ή `,` (υποδιαστολή).

### `short_description` (string, προαιρετικό)

Σύντομη περιγραφή προϊόντος.

### `sale_price` (float, προαιρετικό)

Η τιμή έκπτωσης του προϊόντος.
Το σύμβολο διαχωρισμού δεκαδικών μπορεί να είναι `.` (τελεία) ή `,` (υποδιαστολή).
Αν είναι κενό, μηδέν, ή ίσο με το πεδίο `regular_price`, τότε θα αγνοηθεί.

### `sku` (string, απαραίτητο)

Προσδιορίζει το SKU του προϊόντος που θα εισαχθεί. Πρέπει να είναι μοναδικό για κάθε προϊόν.

### `status` (string, προαιρετικό)

Προσδιορίζει αν το προϊόν είναι ενεργό ή απενεργοποιημένο.
Οι αποδεκτές τιμές είναι: `publish`, `future`, `draft`, `pending`, `private` ή `trash`.
Μπορούν να οριστούν διαφορετικές αποδεκτές τιμές μέσω των mappings.

### `stock_quantity` (integer, προαιρετικό)

Προσδιορίζει την ποσότητα αποθέματος του προϊόντος.

### `stock_status` (string, προαιρετικό)

Οι αποδεκτές τιμές είναι: `instock`, `outofstock` ή `onbackorder`.

### `tax_status` (string, προαιρετικό)

Οι αποδεκτές τιμές είναι: `taxable`, `shipping` ή `none`.

### `upsell_ids` (string, προαιρετικό)

Ένα ή περισσότερα SKU διαχωρισμένα με `,` (κόμμα).
Περιλαμβάνει το SKU κάθε προϊόντος που έχει προσδιοριστεί ως upsell.
Π.χ. `GEO-S,ZEUS-S`.

### `weight` (float, προαιρετικό)

Το σύμβολο διαχωρισμού δεκαδικών μπορεί να είναι `.` (τελεία) ή `,` (υποδιαστολή).

### `width` (float, προαιρετικό)

Το πλάτος του προϊόντος, στη μονάδα μέτρησης διαστάσεων που έχει οριστεί στο WooCommerce.
Το σύμβολο διαχωρισμού δεκαδικών μπορεί να είναι `.` (τελεία) ή `,` (υποδιαστολή).
Στα variable προϊόντα ισχύει μόνο για τα variations.

Οποιοδήποτε άλλο πεδίο θα χρησιμοποιηθεί για να ενημερώσει τα attributes και τα metadata.

- Attributes: Το πεδίο αντιστοιχεί σε ένα attribute του WooCommerce μέσω mapping, διαφορετικά πρέπει να ταιριάζει με το slug ή το όνομα του attribute (χωρίς διάκριση πεζών/κεφαλαίων).
Για παράδειγμα, το πεδίο `color` θα αντιστοιχεί στο attribute `color`, ενώ το πεδίο `chroma` μπορεί να αντιστοιχιστεί με το attribute `color` μέσω mapping.
Η τιμή του πεδίου πρέπει να είναι ένας (1) όρος (term) του attribute, είτε μέσω mapping είτε με το όνομα του όρου (χωρίς διάκριση πεζών/κεφαλαίων). Αν δεν βρεθεί ο όρος, το attribute αγνοείται και καταγράφεται σφάλμα.
Τα attributes που έχουν οριστεί στις ρυθμίσεις των variable προϊόντων χρησιμοποιούνται για τα variations, ενώ τα υπόλοιπα αποθηκεύονται ως attributes του προϊόντος.
- Metadata: Το πεδίο αντιστοιχεί σε ένα custom field μέσω mapping, διαφορετικά πρέπει να ταιριάζει με το όνομα του custom field (χωρίς διάκριση πεζών/κεφαλαίων).
Η τιμή αποθηκεύεται ως κείμενο στα metadata του προϊόντος, με κλειδί το όνομα του custom field.

### Παράδειγμα simple προϊόντος

#### RESPONSE

```json
[
  {
    "backorders": "no",
    "brands": "Fusion",
    "catalog_visibility": "visible",
    "categories": "Αξεσουάρ > Τσάντες, Αξεσουάρ > Προσφορές",
    "color": "Μαύρο",
    "description": "The Fusion Backpack has room for everything you need on the go.",
    "global_unique_id": "5201234567913",
    "height": 45,
    "images": "https://example.com/fusion-1.jpg,https://example.com/fusion-2.jpg",
    "length": 30,
    "manage_stock": true,
    "name": "Fusion Backpack",
    "regular_price": 59.00,
    "sale_price": 49.00,
    "short_description": "A roomy backpack for everyday use.",
    "sku": "FUSION-BACKPACK",
    "status": "publish",
    "stock_quantity": 25,
    "stock_status": "instock",
    "tax_status": "taxable",
    "weight": 1.2,
    "width": 15
  }
]
```

### Παράδειγμα variable προϊόντος με variation προϊόντα

#### RESPONSE

```json
[
  {
    "backorders": "yes",
    "brands": "Champ",
    "catalog_visibility": "visible",
    "categories": "Αντρικά > Μπλούζες > T-Shirts, Αντρικά > Προσφορές",
    "code": "CHAMP",
    "cross_sell_ids": "HERO-S,ORION-S,AERO-S",
    "date_on_sale_from": "2025-08-01",
    "date_on_sale_to": "2025-09-01",
    "description": "The Champ Tee keeps you cool and dry while you do your thing.",
    "global_unique_id": "5201234567890",
    "height": 30,
    "images": "https://example.com/champ-1.jpg,https://example.com/champ-2.jpg",
    "length": 40,
    "manage_stock": true,
    "name": "Champ Tee",
    "regular_price": 25.00,
    "sale_price": 19.99,
    "short_description": "The Champ Tee keeps you cool and dry while you do your thing.",
    "size": "S",
    "sku": "CHAMP-S",
    "status": "publish",
    "stock_quantity": 100,
    "stock_status": "instock",
    "tax_status": "taxable",
    "upsell_ids": "GEO-S,ZEUS-S",
    "weight": 0.5,
    "width": 5
  },
  {
    "backorders": "yes",
    "brands": "Champ",
    "catalog_visibility": "visible",
    "categories": "Αντρικά > Μπλούζες > T-Shirts, Αντρικά > Προσφορές",
    "code": "CHAMP",
    "cross_sell_ids": "HERO-S,ORION-S,AERO-S",
    "date_on_sale_from": "2025-08-01",
    "date_on_sale_to": "2025-09-01",
    "description": "The Champ Tee keeps you cool and dry while you do your thing.",
    "global_unique_id": "5201234567906",
    "height": 30,
    "images": "https://example.com/champ-1.jpg,https://example.com/champ-2.jpg",
    "length": 40,
    "manage_stock": true,
    "name": "Champ Tee",
    "regular_price": 25.00,
    "sale_price": 19.99,
    "short_description": "The Champ Tee keeps you cool and dry while you do your thing.",
    "size": "M",
    "sku": "CHAMP-M",
    "status": "publish",
    "stock_quantity": 100,
    "stock_status": "instock",
    "tax_status": "taxable",
    "upsell_ids": "GEO-S,ZEUS-S",
    "weight": 0.5,
    "width": 5
  }
]
```
