You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: content/getting-started/from-identifiers-to-uuid-7x/welcome.md
+6-6Lines changed: 6 additions & 6 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -20,31 +20,31 @@ We deployed **8** new API endpoints, endpoints that have the same role as alread
20
20
-`POST a proposal /api/rest/v1/products-uuid/{uuid}/proposal` (EE only), same as [POST /api/rest/v1/products/{code}/proposal](https://api.akeneo.com/api-reference.html#post_proposal)
21
21
-`GET a draft /api/rest/v1/products-uuid/{uuid}/draft` (EE only), same as [GET /api/rest/v1/products/{code}/draft](https://api.akeneo.com/api-reference.html#get_draft__code_)
22
22
23
-
And later (during the last quarter of 2022), we plan to make optional the product identifier value (`pim_catalog_identifier` attribute).
23
+
From November 2022, the product identifier value (pim_catalog_identifier attribute) has now become optional.
24
24
25
25
## Why do we do that?
26
26
27
-
At the time these lines are written (July 2022), a PIM product contains one and only one way of unique identification: the so-called field `identifier` (the only `pim_catalog_identifier` attribute of the whole product).
27
+
A PIM used to contain one and only identification: the so-called field `identifier` (the only `pim_catalog_identifier` attribute of the whole product).
28
28
In Serenity, this field value is the SKU (Stock Keeping Unit) of the product, but what if you need to identify your product with several product identifiers (SKU, EAN, GTIN,...)?
29
29
Adding classic fields won't do the job: you need a kind of identifier field for each product.
30
30
And how will you identify your product if its SKU has changed?
31
31
32
32
That's the purpose of the brand-new product UUID feature.
33
33
34
-
But before making it happen, a product must have a **unique** and **immutable** way to identify it: that's why we introduce the product UUID (for Universally Unique Identifier).
34
+
But before making it happen, a product must have a **unique** and **immutable** way to identify it: that's why we introduced the product UUID (for Universally Unique Identifier).
35
35
36
36
## What are the impacts?
37
37
38
-
Of course, [Products endpoints](https://api.akeneo.com/api-reference.html#Product) will remain available (and they be enriched with a `UUID` property), even when new API endpoints will be ready for use.
39
-
Nevertheless, when the current product identifier will become optional:
38
+
Of course, [Products endpoints](https://api.akeneo.com/api-reference.html#Product) will remain available (and they be enriched with a `UUID` property), even whith the availability of the new API endpoints.
39
+
Nevertheless, now that the current product identifier is optional:
40
40
-[GET /api/rest/v1/products](https://api.akeneo.com/api-reference.html#get_products) won’t return products with empty product identifiers (in other words, you may miss products if you continue to use this endpoint);
41
41
-`associations` property for [GET /api/rest/v1/products](https://api.akeneo.com/api-reference.html#get_products) or [GET /api/rest/v1/products/{code}](https://api.akeneo.com/api-reference.html#get_products__code_) may contain **NULL** values (product associated with a product without identifier);
42
42
-[GET /api/rest/v1/products/{code}](https://api.akeneo.com/api-reference.html#get_products__code_) could result in a 404 error (if the identifier is removed from the product).
43
43
...and you could encounter some issues with your code.
44
44
45
45
## What do we advise you?
46
46
47
-
As soon as product UUID API endpoints are released, jump on the bandwagon right away:
47
+
As UUID API endpoints have now been released, we recommend you to jump on the bandwagon right away:
48
48
- Change [product-identifier-based products endpoints](https://api.akeneo.com/api-reference.html#Product) with UUID ones.
49
49
- Every time you identify a product with its identifier in your application, be sure to replace it by corresponding product UUID. You will easily find the match between product identifier and UUID in both [products endpoints](https://api.akeneo.com/api-reference.html#Product) and new ones.
0 commit comments