@nautical-commerce/graphql-schema 4.16.0 → 4.18.0

package/nautical/schema.graphql

@@ -5333,7 +5333,9 @@ input CustomerInput {
   """URL for password reset."""
   passwordUrl: String = null
 
-  """ID of the seller to associate with the customer."""
+  """
+  ID of the seller to add the customer to when upgrading them to staff. It must resolve to a seller the requestor can access. When omitted, the customer is upgraded without a seller; none is created.
+  """
   seller: ID = null
 
   """Tax exemption code."""
@@ -11047,14 +11049,18 @@ type Mutation {
   agreementCommissionDelete(id: ID!): AgreementCommissionDelete!
 
   """
-  Assign an agreement to a seller. Requires MANAGE_AGREEMENTS permission.
+  Assign an agreement to a seller. Requires MANAGE_AGREEMENTS permission. If the agreement in force for the seller is already this one, signed, with its terms unchanged since the signature, and no other assignment is scheduled to take effect by the requested date, nothing is written: the assignment in force is returned, with its own effectiveAt.
   """
   sellerAgreementAssign(input: SellerAgreementInput!): SellerAgreementAssign!
 
-  """Seller acknowledges the agreement."""
+  """
+  Seller acknowledges the agreement awaiting their decision: Seller.agreementAwaitingDecision, which can differ from Seller.agreement. Pass input.sellerAgreement to sign only the agreement the seller was shown.
+  """
   sellerAgreementAcknowledge(id: ID!, input: SellerAgreementAcknowledgeInput = null): SellerAgreementAcknowledge!
 
-  """Seller declines the agreement."""
+  """
+  Seller declines the agreement awaiting their decision: Seller.agreementAwaitingDecision, which can differ from Seller.agreement. Pass input.sellerAgreement to decline only the agreement the seller was shown.
+  """
   sellerAgreementDecline(id: ID!, input: SellerAgreementDeclineInput = null): SellerAgreementDecline!
 
   """
@@ -20782,6 +20788,11 @@ type Seller implements Node & ObjectWithMetadata {
   """Date seller acknowledged their agreement"""
   agreementAcknowledged: DateTime
 
+  """
+  The seller agreement that sellerAgreementAcknowledge signs and sellerAgreementDecline declines: the one in force while it is unsigned, else the next unsigned one due. It differs from `agreement`, which is always the agreement in force, once that one is signed and another is scheduled. With nothing left unsigned it is the one in force, else the next one due, and its acknowledgedOn is already set. Requires the seller's owner or MANAGE_MARKETPLACE.
+  """
+  agreementAwaitingDecision: AgreementSellers
+
   """External payout source plugin identifier"""
   externalPayoutSource: SellerExternalPayoutSource
 
@@ -21027,6 +21038,11 @@ type SellerAgreementAcknowledge {
 input SellerAgreementAcknowledgeInput {
   """Reason why seller decided to accept the agreement."""
   agreementDecisionReason: String = null
+
+  """
+  ID of the seller agreement shown to the seller, from Seller.agreementAwaitingDecision. When given, nothing is signed unless it is still the agreement awaiting the seller's decision.
+  """
+  sellerAgreement: ID = null
 }
 
 """Result of seller agreement assign mutation."""
@@ -21054,6 +21070,11 @@ type SellerAgreementDecline {
 input SellerAgreementDeclineInput {
   """Reason why seller decided to decline the agreement."""
   agreementDecisionReason: String = null
+
+  """
+  ID of the seller agreement shown to the seller, from Seller.agreementAwaitingDecision. When given, nothing is declined unless it is still the agreement awaiting the seller's decision.
+  """
+  sellerAgreement: ID = null
 }
 
 """Result of seller agreement delete mutation."""

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nautical-commerce/graphql-schema",
-  "version": "4.16.0",
+  "version": "4.18.0",
   "description": "Traide API GraphQL Schema",
   "main": "./nautical/schema.graphql",
   "scripts": {