> ## Documentation Index
> Fetch the complete documentation index at: https://developers.redo.com/llms.txt
> Use this file to discover all available pages before exploring further.

# FulfillmentGroupUpdateInput

> Changes to a fulfillment group. Omit a field to leave it as is. Once the group is past open, only the internal note, the assignee and tags can change; anything else, including the note to the buyer, returns FULFILLMENT_GROUP_LOCKED.

**assigneeId** `ID`

The id of the team member to assign the group to.

**billing** `[ShipmentBillingInput](/docs/api-reference/v3/reference/shipping/shipment-billing-input)`

Who pays the carrier. Null bills the shipper.

**fields**

**account** `String`

The payer's carrier account number. Never returned.

**carrier** `String`

The carrier billed, for third-party or receiver billing.

**country** `String`

The payer's country, for third-party or receiver billing.

**postalCode** `String`

The payer's postal code, for third-party or receiver billing.

**type** `[ShipmentBillingType!](/docs/api-reference/v3/reference/shipping/shipment-billing-type)` *required*

Who pays.

**customs** `[FulfillmentGroupCustomsInput](/docs/api-reference/v3/reference/shipping/fulfillment-group-customs-input)`

Customs details to change.

**fields**

**comments** `String`

Extra comments for customs.

**contentsExplanation** `String`

A description of the contents, when the type needs one.

**contentsType** `[CustomsContentsType](/docs/api-reference/v3/reference/shipping/customs-contents-type)`

What kind of contents the shipment holds.

**declarations** `[\[CustomsDeclarationInput!\]](/docs/api-reference/v3/reference/shipping/customs-declaration-input)`

The declared items, replacing the current ones.

**fields**

**countryOfOrigin** `[CountryCode!](/docs/api-reference/v3/reference/common/country-code)` *required*

Where the item was made.

**description** `String!` *required*

What the item is.

**hsCode** `String`

The Harmonized System tariff code.

**quantity** `Int!` *required*

Units declared.

**value** `[MoneyInput!](/docs/api-reference/v3/reference/common/money-input)` *required*

The declared value of one unit.

**weight** `[WeightInput!](/docs/api-reference/v3/reference/catalog/weight-input)` *required*

The weight of one unit.

**exportFiling** `[ExportFilingInput](/docs/api-reference/v3/reference/shipping/export-filing-input)`

The US export filing.

**fields**

**exemptionCode** `[AesExemptionCode](/docs/api-reference/v3/reference/shipping/aes-exemption-code)`

Why no export filing is needed.

**itn** `String`

The AES internal transaction number.

**incoterm** `[Incoterm](/docs/api-reference/v3/reference/shipping/incoterm)`

Who pays duties and import taxes. Null uses the store's setting.

**nonDeliveryOption** `[CustomsNonDeliveryOption](/docs/api-reference/v3/reference/shipping/customs-non-delivery-option)`

What happens to the shipment if it can't be delivered.

**deliveryMethod** `[DeliveryMethodKind](/docs/api-reference/v3/reference/shipping/delivery-method-kind)`

How the order reaches the customer, overriding the sales channel's. It can be replaced but not cleared.

**fulfillBy** `[Date](/docs/api-reference/v3/reference/common/date)`

The day the group must ship by, overriding the sales channel's deadline. Null removes the override.

**fulfiller** `[FulfillmentGroupFulfillerInput](/docs/api-reference/v3/reference/shipping/fulfillment-group-fulfiller-input)`

Move the group to another fulfiller.

**fields**

**accountId** `ID!` *required*

The account that should ship the group.

**note** `String`

More detail on why, up to 500 characters.

**reason** `[FulfillmentGroupReassignmentReason](/docs/api-reference/v3/reference/shipping/fulfillment-group-reassignment-reason)`

Why the group is moving.

**notes** `[FulfillmentGroupNotesInput](/docs/api-reference/v3/reference/shipping/fulfillment-group-notes-input)`

Notes to change.

**fields**

**internal** `String`

A note for the warehouse that the customer never sees.

**toBuyer** `String`

A note printed for the customer, such as on the slip. Only while the group is open: it is printed by then, so a later change returns FULFILLMENT\_GROUP\_LOCKED.

**notifyMarketplace** `Boolean`

Whether to send tracking to the sales channel when the label is bought. Null uses the store's setting.

**parcels** `[\[FulfillmentGroupParcelInput!\]](/docs/api-reference/v3/reference/shipping/fulfillment-group-parcel-input)`

The parcels the group ships in, replacing the current ones.

**fields**

**dimensions** `[FulfillmentGroupParcelDimensionsInput!](/docs/api-reference/v3/reference/shipping/fulfillment-group-parcel-dimensions-input)` *required*

The parcel's outside dimensions.

**fields**

**height** `Float!` *required*

The height.

**length** `Float!` *required*

The length.

**unit** `[DimensionUnit!](/docs/api-reference/v3/reference/catalog/dimension-unit)` *required*

The unit of all three.

**width** `Float!` *required*

The width.

**dryIceWeight** `[WeightInput](/docs/api-reference/v3/reference/catalog/weight-input)`

The weight of dry ice in the parcel.

**fields**

**unit** `[WeightUnit!](/docs/api-reference/v3/reference/catalog/weight-unit)` *required*

The unit the value is expressed in.

**value** `Float!` *required*

The numeric magnitude of the weight.

**hazmat** `[HazmatType](/docs/api-reference/v3/reference/shipping/hazmat-type)`

The dangerous goods class the parcel ships as.

**insurance** `[MoneyInput](/docs/api-reference/v3/reference/common/money-input)`

The amount to insure the parcel for, in the group's currency. Omit for none.

**fields**

**amount** `[Decimal!](/docs/api-reference/v3/reference/common/decimal)` *required*

The amount as an exact decimal string (e.g. "19.99").

**currency** `String!` *required*

ISO 4217 currency code (e.g. USD).

**name** `String`

The packaging's name.

**packagingWeight** `[WeightInput!](/docs/api-reference/v3/reference/catalog/weight-input)` *required*

The weight of the empty packaging.

**fields**

**unit** `[WeightUnit!](/docs/api-reference/v3/reference/catalog/weight-unit)` *required*

The unit the value is expressed in.

**value** `Float!` *required*

The numeric magnitude of the weight.

**totalWeight** `[WeightInput](/docs/api-reference/v3/reference/catalog/weight-input)`

The weight of the packed parcel. Omit to derive it from the items.

**fields**

**unit** `[WeightUnit!](/docs/api-reference/v3/reference/catalog/weight-unit)` *required*

The unit the value is expressed in.

**value** `Float!` *required*

The numeric magnitude of the weight.

**type** `[ParcelType!](/docs/api-reference/v3/reference/shipping/parcel-type)` *required*

The kind of packaging. CARRIER\_PACKAGE can't be set through the API.

**residentialOverride** `Boolean`

Rate the destination as residential (true) or commercial (false). Null uses the address's classification.

**returnLabel** `Boolean`

Whether to buy a return label with the label.

**saturdayDelivery** `Boolean`

Whether to request Saturday delivery.

**selectedRate** `[FulfillmentGroupSelectedRateInput](/docs/api-reference/v3/reference/shipping/fulfillment-group-selected-rate-input)`

The rate to buy the label with. Null clears it.

**fields**

**carrier** `String!` *required*

The carrier.

**carrierAccountId** `String`

The carrier account the rate is on, `carrierAccountId` on the group's rate quotes. Optional when exactly one account quotes this carrier and service; AMBIGUOUS\_RATE when several do, RATE\_NOT\_QUOTED when none does.

**service** `String!` *required*

The carrier service level.

**signature** `[SignatureRequirement](/docs/api-reference/v3/reference/shipping/signature-requirement)`

Whether a signature is required on delivery.

**specialRates** `[\[SpecialRate!\]](/docs/api-reference/v3/reference/shipping/special-rate)`

Discounted rate classes the contents qualify for. An empty list or null clears them.

**tags** `[String!]`

The names of the group's tags, replacing the current ones. Each must be a fulfillment group tag the store has.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.