Skip to content

Commit c5b6f5e

Browse files
Merge pull request #687 from akeneo/updates-following-optionalsku-launch
Updates following optional sku launch
2 parents 9d26182 + c6446a1 commit c5b6f5e

File tree

1 file changed

+6
-6
lines changed
  • content/getting-started/from-identifiers-to-uuid-7x

1 file changed

+6
-6
lines changed

content/getting-started/from-identifiers-to-uuid-7x/welcome.md

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -20,31 +20,31 @@ We deployed **8** new API endpoints, endpoints that have the same role as alread
2020
- `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)
2121
- `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_)
2222

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.
2424

2525
## Why do we do that?
2626

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).
2828
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,...)?
2929
Adding classic fields won't do the job: you need a kind of identifier field for each product.
3030
And how will you identify your product if its SKU has changed?
3131

3232
That's the purpose of the brand-new product UUID feature.
3333

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).
3535

3636
## What are the impacts?
3737

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:
4040
- [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);
4141
- `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);
4242
- [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).
4343
...and you could encounter some issues with your code.
4444

4545
## What do we advise you?
4646

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:
4848
- Change [product-identifier-based products endpoints](https://api.akeneo.com/api-reference.html#Product) with UUID ones.
4949
- 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.
5050

0 commit comments

Comments
 (0)