Updated API from documentation release

Author: ct-sdks[bot]

api-specs/api/resources/customers.raml

@@ -29,9 +29,6 @@ post:
   displayName: Create (sign up) Customer
   securedBy: [oauth_2_0: { scopes: ['manage_customers:{projectKey}'] }]
   description: |
-    If the `anonymousCart` field is set on the [CustomerDraft](ctp:api:type:CustomerDraft), then the newly created Customer will be assigned to that [Cart](ctp:api:type:Cart).
-    Similarly, if the `anonymousId` field is set, the Customer will be set on all [Carts](ctp:api:type:Cart), [Orders](ctp:api:type:Order), [ShoppingLists](ctp:api:type:ShoppingList) and [Payments](ctp:api:type:Payment) with the same `anonymousId`.
-
     Creating a Customer produces the [CustomerCreated](ctp:api:type:CustomerCreatedMessage) Message. Simultaneously creating two Customers with the same email address can return a [LockedField](ctp:api:type:LockedFieldError) error.
   body:
     application/json:

api-specs/api/resources/in-store/customers-in-store.raml

@@ -44,10 +44,10 @@ post:
   description: |
     When using this endpoint, if omitted, the Customer `stores` field is set to the [Store](ctp:api:type:Store) specified in the path parameter.
 
-    If the `anonymousCart` field is set on the [CustomerDraft](ctp:api:type:CustomerDraft), then the newly created Customer will be assigned to that [Cart](ctp:api:type:Cart).
-    Similarly, if the `anonymousId` field is set, the Customer will be set on all [Carts](ctp:api:type:Cart), [Orders](ctp:api:type:Order), [ShoppingLists](ctp:api:type:ShoppingList) and [Payments](ctp:api:type:Payment) with the same `anonymousId`.
     If a Cart with a `store` field specified, the `store` field must reference the same [Store](ctp:api:type:Store) specified in the `{storeKey}` path parameter.
 
+    If the Customer has multiple active Carts, the anonymous Cart is [merged](/../api/customers-overview#cart-merge-during-sign-in-and-sign-up) into the most recently modified active Cart.
+
     Creating a Customer produces the [CustomerCreated](ctp:api:type:CustomerCreatedMessage) Message. Simultaneously creating two Customers with the same email address can return a [LockedField](ctp:api:type:LockedFieldError) error.
   body:
     application/json:

api-specs/api/resources/in-store/in-store.raml

@@ -24,14 +24,11 @@ uriParameters:
   post:
     displayName: Authenticate (sign in) Customer in Store
     description: |
-      Authenticates a Customer associated with a [Store](ctp:api:type:Store). For more information, see [Global versus Store-specific Customers](/../api/customers-overview#global-versus-store-specific-customers).
+      Authenticates a Customer associated with a [Store](ctp:api:type:Store).
 
-      A Cart returned in the [CustomerSignInResult](ctp:api:type:CustomerSignInResult) has any invalid Line Items removed and is [updated](/api/carts-orders-overview#update-a-cart) with the latest prices, taxes, and discounts. During these updates, the following errors can be returned: [MatchingPriceNotFound](ctp:api:type:MatchingPriceNotFoundError) and [MissingTaxRateForCountry](ctp:api:type:MissingTaxRateForCountryError).
-
-      Triggers [Cart merge during sign-in](/../api/customers-overview#cart-merge-during-sign-in).
+      If the Customer has multiple active Carts, the anonymous Cart is [merged](/../api/customers-overview#cart-merge-during-sign-in-and-sign-up) into the most recently modified active Cart.
 
       If the Customer exists in the Project but the `stores` field references a different [Store](ctp:api:type:Store), this method returns an [InvalidCredentials](ctp:api:type:InvalidCredentialsError) error.
-
     securedBy:
       - oauth_2_0:
           scopes:

api-specs/api/resources/in-store/my-carts-orders-shoppinglists-in-store.raml

@@ -1044,12 +1044,11 @@ delete:
   post:
     displayName: Create (sign up) My Customer in Store
     description: |
-
       If used with an optional [access token for an anonymous session](ctp:api:type:AnonymousSession), all Orders and Carts that belong to the `anonymousId` are assigned to the newly created Customer.
 
       If omitted in the request body, the [Customer](ctp:api:type:Customer) `stores` field is set to the [Store](ctp:api:type:Store) specified in the path parameter.
 
-      A Cart returned in the [CustomerSignInResult](ctp:api:type:CustomerSignInResult) has any invalid Line Items removed and is [updated](/api/carts-orders-overview#update-a-cart) with the latest prices, taxes, and discounts. During these updates, the following errors can be returned: [MatchingPriceNotFound](ctp:api:type:MatchingPriceNotFoundError) and [MissingTaxRateForCountry](ctp:api:type:MissingTaxRateForCountryError).
+      If the Customer has multiple active Carts, the anonymous Cart is [merged](/../api/customers-overview#cart-merge-during-sign-in-and-sign-up) into the most recently modified active Cart.
 
       Creating a Customer produces the [CustomerCreated](ctp:api:type:CustomerCreatedMessage) Message.
     securedBy:
@@ -1087,10 +1086,7 @@ delete:
       - If the Customer does not have a Cart, the most recently modified anonymous cart becomes the Customer's Cart.
       - If the Customer already has a Cart, the most recently modified anonymous cart is handled according to [AnonymousCartSignInMode](ctp:api:type:AnonymousCartSignInMode).
 
-      A Cart returned in the [CustomerSignInResult](ctp:api:type:CustomerSignInResult) has any invalid Line Items removed and is [updated](/api/carts-orders-overview#update-a-cart) with the latest prices, taxes, and discounts. During these updates, the following errors can be returned: [MatchingPriceNotFound](ctp:api:type:MatchingPriceNotFoundError) and [MissingTaxRateForCountry](ctp:api:type:MissingTaxRateForCountryError).
-
       If an account with the given credentials is not found, an [InvalidCredentials](ctp:api:type:InvalidCredentialsError) error is returned.
-
     securedBy:
       [
         oauth_2_0:

api-specs/api/resources/login.raml

@@ -3,16 +3,11 @@ description: Retrieves the authenticated customer.
 post:
   displayName: Authenticate (sign in) Customer
   description: |
-    Authenticates a global Customer not associated with a Store.
-    For more information, see [Global versus Store-specific Customers](/../api/customers-overview#global-versus-store-specific-customers).
-    If the Customer is registered in a Store, use the [Authenticate (sign in) Customer in Store](ctp:api:endpoint:/{projectKey}/in-store/key={storeKey}/login:POST) method.
+    Authenticates a global Customer.
 
-    Triggers [Cart merge during sign-in](/../api/customers-overview#cart-merge-during-sign-in).
-
-    A Cart returned in the [CustomerSignInResult](ctp:api:type:CustomerSignInResult) has any invalid Line Items removed and is [updated](/api/carts-orders-overview#update-a-cart) with the latest prices, taxes, and discounts. During these updates, the following errors can be returned: [MatchingPriceNotFound](ctp:api:type:MatchingPriceNotFoundError) and [MissingTaxRateForCountry](ctp:api:type:MissingTaxRateForCountryError).
+    If the Customer has multiple active Carts, the anonymous Cart is [merged](/../api/customers-overview#cart-merge-during-sign-in-and-sign-up) into the most recently modified active Cart.
 
     If an account with the given credentials is not found, an [InvalidCredentials](ctp:api:type:InvalidCredentialsError) error is returned.
-
   securedBy: [oauth_2_0: { scopes: ['manage_customers:{projectKey}'] }]
   body:
     application/json:

api-specs/api/resources/me.raml

@@ -179,8 +179,6 @@ delete:
       - If the Customer does not have a Cart yet, the most recently modified anonymous cart becomes the Customer's Cart.
       - If the Customer already has a Cart, the most recently modified anonymous cart is handled in accordance with [AnonymousCartSignInMode](ctp:api:type:AnonymousCartSignInMode).
 
-      A Cart returned in the [CustomerSignInResult](ctp:api:type:CustomerSignInResult) has any invalid Line Items removed and is [updated](/api/carts-orders-overview#update-a-cart) with the latest prices, taxes, and discounts. During these updates, the following errors can be returned: [MatchingPriceNotFound](ctp:api:type:MatchingPriceNotFoundError) and [MissingTaxRateForCountry](ctp:api:type:MissingTaxRateForCountryError).
-
       If an account with the given credentials is not found, an [InvalidCredentials](ctp:api:type:InvalidCredentialsError) error is returned.
     securedBy:
       [

api-specs/api/types/customer/AnonymousCartSignInMode.raml

@@ -6,5 +6,5 @@ enum:
   - MergeWithExistingCustomerCart
   - UseAsNewActiveCustomerCart
 (enumDescriptions):
-  MergeWithExistingCustomerCart: If set, the content of an anonymous [Cart is merged during sign-in](/../api/customers-overview#cart-merge-during-sign-in) with the Customer's most recently modified active Cart.
+  MergeWithExistingCustomerCart: If set, the content of an anonymous [Cart is merged during sign-in](/../api/customers-overview#cart-merge-during-sign-in-and-sign-up) with the Customer's most recently modified active Cart.
   UseAsNewActiveCustomerCart: If set, an anonymous Cart is used as the new active Customer Cart, and no [LineItems](ctp:api:type:LineItem) or [CustomLineItems](ctp:api:type:CustomLineItem) are merged.

api-specs/api/types/customer/CustomerDraft.raml

@@ -58,11 +58,13 @@ properties:
   anonymousCart?:
     type: CartResourceIdentifier
     description: |
-      Identifies a [Cart](ctp:api:type:Cart) that will be assigned to the new Customer.
+      Assigns the Customer to the specified Cart.
   anonymousId?:
     type: string
     description: |
-      Identifies Carts and Orders belonging to an anonymous session that will be assigned to the new Customer.
+      Assigns the Customer to all [Carts](ctp:api:type:Cart), [Orders](ctp:api:type:Order), [ShoppingLists](ctp:api:type:ShoppingList), and [Payments](ctp:api:type:Payment) with the same `anonymousId`.
+
+      If `anonymousCart` is provided, this value must match the `anonymousId` of the anonymous [Cart](ctp:api:type:Cart); otherwise, an [InvalidOperation](ctp:api:type:InvalidOperationError) error is returned.
   dateOfBirth?:
     type: date-only
     description: |

api-specs/api/types/customer/CustomerSignInResult.raml

@@ -11,4 +11,8 @@ properties:
     type: Cart
     description: |
       Cart associated with the Customer.
-      If empty, the Customer does not have a Cart assigned.
+
+      The Cart is recalculated to remove invalid Line Items and apply the latest prices, taxes, and discounts.
+      During these updates, the following errors can be returned: [MatchingPriceNotFound](ctp:api:type:MatchingPriceNotFoundError) and [MissingTaxRateForCountry](ctp:api:type:MissingTaxRateForCountryError).
+
+      For more information, see [Cart updates](/../api/carts-orders-overview#update-a-cart).

api-specs/api/types/customer/CustomerSignin.raml

@@ -20,7 +20,7 @@ properties:
   anonymousCart?:
     type: CartResourceIdentifier
     description: |
-      Identifies a [Cart](ctp:api:type:Cart) that will be assigned to the Customer.
+      Assigns the Customer to the specified Cart.
   anonymousCartSignInMode?:
     type: AnonymousCartSignInMode
     description: |
@@ -30,9 +30,9 @@ properties:
   anonymousId?:
     type: string
     description: |
-      If both `anonymousCart` and `anonymousId` are provided, the `anonymousId` on the CustomerSignin must match that of the anonymous [Cart](ctp:api:type:Cart).
-      Otherwise a [400 Bad Request](ctp:api:type:InvalidOperationError) `Invalid Operation` error is returned with the message:
-      "Cart with the ID cart-id does not have the expected anonymousId.".
+      Assigns the Customer to all [Carts](ctp:api:type:Cart), [Orders](ctp:api:type:Order), [ShoppingLists](ctp:api:type:ShoppingList), and [Payments](ctp:api:type:Payment) with the same `anonymousId`.
+
+      If `anonymousCart` is provided, this value must match the `anonymousId` of the anonymous [Cart](ctp:api:type:Cart); otherwise, an [InvalidOperation](ctp:api:type:InvalidOperationError) error is returned.
   updateProductData?:
     type: boolean
     description: |