* update dependencies * update onboarding mdx * fixes for mdx issues * fixes for mdx compatibility * resolve mdx errors * fixes in reference * fix check errors * revert change in vale action * fix node version in action * fix summary in markdown
1281 lines
38 KiB
Plaintext
1281 lines
38 KiB
Plaintext
---
|
||
displayed_sidebar: entitiesSidebar
|
||
---
|
||
|
||
import ParameterTypes from "@site/src/components/ParameterTypes"
|
||
|
||
# Fulfillment
|
||
|
||
A Fulfillment is created once an admin can prepare the purchased goods. Fulfillments will eventually be shipped and hold information about how to track shipments. Fulfillments are created through a fulfillment provider, which typically integrates a third-party shipping service. Fulfillments can be associated with orders, claims, swaps, and returns.
|
||
|
||
## Properties
|
||
|
||
<ParameterTypes parameters={[
|
||
{
|
||
"name": "canceled_at",
|
||
"type": "`Date`",
|
||
"description": "The date with timezone at which the Fulfillment was canceled.",
|
||
"optional": false,
|
||
"defaultValue": "",
|
||
"expandable": false,
|
||
"children": []
|
||
},
|
||
{
|
||
"name": "claim_order",
|
||
"type": "[ClaimOrder](ClaimOrder.mdx)",
|
||
"description": "The details of the claim that the fulfillment may belong to.",
|
||
"optional": false,
|
||
"defaultValue": "",
|
||
"expandable": true,
|
||
"children": [
|
||
{
|
||
"name": "additional_items",
|
||
"type": "[LineItem](LineItem.mdx)[]",
|
||
"description": "The details of the new items to be shipped when the claim's type is `replace`",
|
||
"optional": false,
|
||
"defaultValue": "",
|
||
"expandable": true,
|
||
"children": []
|
||
},
|
||
{
|
||
"name": "canceled_at",
|
||
"type": "`Date`",
|
||
"description": "The date with timezone at which the claim was canceled.",
|
||
"optional": false,
|
||
"defaultValue": "",
|
||
"expandable": false,
|
||
"children": []
|
||
},
|
||
{
|
||
"name": "claim_items",
|
||
"type": "[ClaimItem](ClaimItem.mdx)[]",
|
||
"description": "The details of the items that should be replaced or refunded.",
|
||
"optional": false,
|
||
"defaultValue": "",
|
||
"expandable": true,
|
||
"children": []
|
||
},
|
||
{
|
||
"name": "created_at",
|
||
"type": "`Date`",
|
||
"description": "The date with timezone at which the resource was created.",
|
||
"optional": false,
|
||
"defaultValue": "",
|
||
"expandable": false,
|
||
"children": []
|
||
},
|
||
{
|
||
"name": "deleted_at",
|
||
"type": "`Date`",
|
||
"description": "The date with timezone at which the resource was deleted.",
|
||
"optional": false,
|
||
"defaultValue": "",
|
||
"expandable": false,
|
||
"children": []
|
||
},
|
||
{
|
||
"name": "fulfillment_status",
|
||
"type": "[ClaimFulfillmentStatus](../enums/ClaimFulfillmentStatus.mdx)",
|
||
"description": "The claim's fulfillment status",
|
||
"optional": false,
|
||
"defaultValue": "not_fulfilled",
|
||
"expandable": false,
|
||
"children": []
|
||
},
|
||
{
|
||
"name": "fulfillments",
|
||
"type": "[Fulfillment](Fulfillment.mdx)[]",
|
||
"description": "The fulfillments of the new items to be shipped",
|
||
"optional": false,
|
||
"defaultValue": "",
|
||
"expandable": true,
|
||
"children": []
|
||
},
|
||
{
|
||
"name": "id",
|
||
"type": "`string`",
|
||
"description": "The claim's ID",
|
||
"optional": false,
|
||
"defaultValue": "",
|
||
"expandable": false,
|
||
"children": []
|
||
},
|
||
{
|
||
"name": "idempotency_key",
|
||
"type": "`string`",
|
||
"description": "Randomly generated key used to continue the completion of the cart associated with the claim in case of failure.",
|
||
"optional": false,
|
||
"defaultValue": "",
|
||
"expandable": false,
|
||
"children": []
|
||
},
|
||
{
|
||
"name": "metadata",
|
||
"type": "`Record<string, unknown>`",
|
||
"description": "An optional key-value map with additional details",
|
||
"optional": false,
|
||
"defaultValue": "",
|
||
"expandable": false,
|
||
"children": []
|
||
},
|
||
{
|
||
"name": "no_notification",
|
||
"type": "`boolean`",
|
||
"description": "Flag for describing whether or not notifications related to this should be send.",
|
||
"optional": false,
|
||
"defaultValue": "",
|
||
"expandable": false,
|
||
"children": []
|
||
},
|
||
{
|
||
"name": "order",
|
||
"type": "[Order](Order.mdx)",
|
||
"description": "The details of the order that this claim was created for.",
|
||
"optional": false,
|
||
"defaultValue": "",
|
||
"expandable": true,
|
||
"children": []
|
||
},
|
||
{
|
||
"name": "order_id",
|
||
"type": "`string`",
|
||
"description": "The ID of the order that the claim comes from.",
|
||
"optional": false,
|
||
"defaultValue": "",
|
||
"expandable": false,
|
||
"children": []
|
||
},
|
||
{
|
||
"name": "payment_status",
|
||
"type": "[ClaimPaymentStatus](../enums/ClaimPaymentStatus.mdx)",
|
||
"description": "The status of the claim's payment",
|
||
"optional": false,
|
||
"defaultValue": "na",
|
||
"expandable": false,
|
||
"children": []
|
||
},
|
||
{
|
||
"name": "refund_amount",
|
||
"type": "`number`",
|
||
"description": "The amount that will be refunded in conjunction with the claim",
|
||
"optional": false,
|
||
"defaultValue": "",
|
||
"expandable": false,
|
||
"children": []
|
||
},
|
||
{
|
||
"name": "return_order",
|
||
"type": "[Return](Return.mdx)",
|
||
"description": "The details of the return associated with the claim if the claim's type is `replace`.",
|
||
"optional": false,
|
||
"defaultValue": "",
|
||
"expandable": true,
|
||
"children": []
|
||
},
|
||
{
|
||
"name": "shipping_address",
|
||
"type": "[Address](Address.mdx)",
|
||
"description": "The details of the address that new items should be shipped to.",
|
||
"optional": false,
|
||
"defaultValue": "",
|
||
"expandable": true,
|
||
"children": []
|
||
},
|
||
{
|
||
"name": "shipping_address_id",
|
||
"type": "`string`",
|
||
"description": "The ID of the address that the new items should be shipped to",
|
||
"optional": false,
|
||
"defaultValue": "",
|
||
"expandable": false,
|
||
"children": []
|
||
},
|
||
{
|
||
"name": "shipping_methods",
|
||
"type": "[ShippingMethod](ShippingMethod.mdx)[]",
|
||
"description": "The details of the shipping methods that the claim order will be shipped with.",
|
||
"optional": false,
|
||
"defaultValue": "",
|
||
"expandable": true,
|
||
"children": []
|
||
},
|
||
{
|
||
"name": "type",
|
||
"type": "[ClaimType](../enums/ClaimType.mdx)",
|
||
"description": "The claim's type",
|
||
"optional": false,
|
||
"defaultValue": "",
|
||
"expandable": false,
|
||
"children": []
|
||
},
|
||
{
|
||
"name": "updated_at",
|
||
"type": "`Date`",
|
||
"description": "The date with timezone at which the resource was updated.",
|
||
"optional": false,
|
||
"defaultValue": "",
|
||
"expandable": false,
|
||
"children": []
|
||
}
|
||
]
|
||
},
|
||
{
|
||
"name": "claim_order_id",
|
||
"type": "`string`",
|
||
"description": "The ID of the Claim that the Fulfillment belongs to.",
|
||
"optional": false,
|
||
"defaultValue": "",
|
||
"expandable": false,
|
||
"children": []
|
||
},
|
||
{
|
||
"name": "created_at",
|
||
"type": "`Date`",
|
||
"description": "The date with timezone at which the resource was created.",
|
||
"optional": false,
|
||
"defaultValue": "",
|
||
"expandable": false,
|
||
"children": []
|
||
},
|
||
{
|
||
"name": "data",
|
||
"type": "`Record<string, unknown>`",
|
||
"description": "This contains all the data necessary for the Fulfillment provider to handle the fulfillment.",
|
||
"optional": false,
|
||
"defaultValue": "",
|
||
"expandable": false,
|
||
"children": []
|
||
},
|
||
{
|
||
"name": "id",
|
||
"type": "`string`",
|
||
"description": "The fulfillment's ID",
|
||
"optional": false,
|
||
"defaultValue": "",
|
||
"expandable": false,
|
||
"children": []
|
||
},
|
||
{
|
||
"name": "idempotency_key",
|
||
"type": "`string`",
|
||
"description": "Randomly generated key used to continue the completion of the fulfillment in case of failure.",
|
||
"optional": false,
|
||
"defaultValue": "",
|
||
"expandable": false,
|
||
"children": []
|
||
},
|
||
{
|
||
"name": "items",
|
||
"type": "[FulfillmentItem](FulfillmentItem.mdx)[]",
|
||
"description": "The Fulfillment Items in the Fulfillment. These hold information about how many of each Line Item has been fulfilled.",
|
||
"optional": false,
|
||
"defaultValue": "",
|
||
"expandable": true,
|
||
"children": [
|
||
{
|
||
"name": "fulfillment",
|
||
"type": "[Fulfillment](Fulfillment.mdx)",
|
||
"description": "The details of the fulfillment.",
|
||
"optional": false,
|
||
"defaultValue": "",
|
||
"expandable": true,
|
||
"children": []
|
||
},
|
||
{
|
||
"name": "fulfillment_id",
|
||
"type": "`string`",
|
||
"description": "The ID of the Fulfillment that the Fulfillment Item belongs to.",
|
||
"optional": false,
|
||
"defaultValue": "",
|
||
"expandable": false,
|
||
"children": []
|
||
},
|
||
{
|
||
"name": "item",
|
||
"type": "[LineItem](LineItem.mdx)",
|
||
"description": "The details of the line item.",
|
||
"optional": false,
|
||
"defaultValue": "",
|
||
"expandable": true,
|
||
"children": []
|
||
},
|
||
{
|
||
"name": "item_id",
|
||
"type": "`string`",
|
||
"description": "The ID of the Line Item that the Fulfillment Item references.",
|
||
"optional": false,
|
||
"defaultValue": "",
|
||
"expandable": false,
|
||
"children": []
|
||
},
|
||
{
|
||
"name": "quantity",
|
||
"type": "`number`",
|
||
"description": "The quantity of the Line Item that is included in the Fulfillment.",
|
||
"optional": false,
|
||
"defaultValue": "",
|
||
"expandable": false,
|
||
"children": []
|
||
}
|
||
]
|
||
},
|
||
{
|
||
"name": "location_id",
|
||
"type": "``null`` \\| `string`",
|
||
"description": "The ID of the stock location the fulfillment will be shipped from",
|
||
"optional": false,
|
||
"defaultValue": "",
|
||
"expandable": false,
|
||
"children": []
|
||
},
|
||
{
|
||
"name": "metadata",
|
||
"type": "`Record<string, unknown>`",
|
||
"description": "An optional key-value map with additional details",
|
||
"optional": false,
|
||
"defaultValue": "",
|
||
"expandable": false,
|
||
"children": []
|
||
},
|
||
{
|
||
"name": "no_notification",
|
||
"type": "`boolean`",
|
||
"description": "Flag for describing whether or not notifications related to this should be sent.",
|
||
"optional": false,
|
||
"defaultValue": "",
|
||
"expandable": false,
|
||
"children": []
|
||
},
|
||
{
|
||
"name": "order",
|
||
"type": "[Order](Order.mdx)",
|
||
"description": "The details of the order that the fulfillment may belong to.",
|
||
"optional": false,
|
||
"defaultValue": "",
|
||
"expandable": true,
|
||
"children": [
|
||
{
|
||
"name": "billing_address",
|
||
"type": "[Address](Address.mdx)",
|
||
"description": "The details of the billing address associated with the order.",
|
||
"optional": false,
|
||
"defaultValue": "",
|
||
"expandable": true,
|
||
"children": []
|
||
},
|
||
{
|
||
"name": "billing_address_id",
|
||
"type": "`string`",
|
||
"description": "The ID of the billing address associated with the order",
|
||
"optional": false,
|
||
"defaultValue": "",
|
||
"expandable": false,
|
||
"children": []
|
||
},
|
||
{
|
||
"name": "canceled_at",
|
||
"type": "`Date`",
|
||
"description": "The date the order was canceled on.",
|
||
"optional": false,
|
||
"defaultValue": "",
|
||
"expandable": false,
|
||
"children": []
|
||
},
|
||
{
|
||
"name": "cart",
|
||
"type": "[Cart](Cart.mdx)",
|
||
"description": "The details of the cart associated with the order.",
|
||
"optional": false,
|
||
"defaultValue": "",
|
||
"expandable": true,
|
||
"children": []
|
||
},
|
||
{
|
||
"name": "cart_id",
|
||
"type": "`string`",
|
||
"description": "The ID of the cart associated with the order",
|
||
"optional": false,
|
||
"defaultValue": "",
|
||
"expandable": false,
|
||
"children": []
|
||
},
|
||
{
|
||
"name": "claims",
|
||
"type": "[ClaimOrder](ClaimOrder.mdx)[]",
|
||
"description": "The details of the claims created for the order.",
|
||
"optional": false,
|
||
"defaultValue": "",
|
||
"expandable": true,
|
||
"children": []
|
||
},
|
||
{
|
||
"name": "created_at",
|
||
"type": "`Date`",
|
||
"description": "The date with timezone at which the resource was created.",
|
||
"optional": false,
|
||
"defaultValue": "",
|
||
"expandable": false,
|
||
"children": []
|
||
},
|
||
{
|
||
"name": "currency",
|
||
"type": "[Currency](Currency.mdx)",
|
||
"description": "The details of the currency used in the order.",
|
||
"optional": false,
|
||
"defaultValue": "",
|
||
"expandable": true,
|
||
"children": []
|
||
},
|
||
{
|
||
"name": "currency_code",
|
||
"type": "`string`",
|
||
"description": "The 3 character currency code that is used in the order",
|
||
"optional": false,
|
||
"defaultValue": "",
|
||
"expandable": false,
|
||
"children": []
|
||
},
|
||
{
|
||
"name": "customer",
|
||
"type": "[Customer](Customer.mdx)",
|
||
"description": "The details of the customer associated with the order.",
|
||
"optional": false,
|
||
"defaultValue": "",
|
||
"expandable": true,
|
||
"children": []
|
||
},
|
||
{
|
||
"name": "customer_id",
|
||
"type": "`string`",
|
||
"description": "The ID of the customer associated with the order",
|
||
"optional": false,
|
||
"defaultValue": "",
|
||
"expandable": false,
|
||
"children": []
|
||
},
|
||
{
|
||
"name": "discount_total",
|
||
"type": "`number`",
|
||
"description": "The total of discount rounded",
|
||
"optional": false,
|
||
"defaultValue": "",
|
||
"expandable": false,
|
||
"children": []
|
||
},
|
||
{
|
||
"name": "discounts",
|
||
"type": "[Discount](Discount.mdx)[]",
|
||
"description": "The details of the discounts applied on the order.",
|
||
"optional": false,
|
||
"defaultValue": "",
|
||
"expandable": true,
|
||
"children": []
|
||
},
|
||
{
|
||
"name": "display_id",
|
||
"type": "`number`",
|
||
"description": "The order's display ID",
|
||
"optional": false,
|
||
"defaultValue": "",
|
||
"expandable": false,
|
||
"children": []
|
||
},
|
||
{
|
||
"name": "draft_order",
|
||
"type": "[DraftOrder](DraftOrder.mdx)",
|
||
"description": "The details of the draft order this order was created from.",
|
||
"optional": false,
|
||
"defaultValue": "",
|
||
"expandable": true,
|
||
"children": []
|
||
},
|
||
{
|
||
"name": "draft_order_id",
|
||
"type": "`string`",
|
||
"description": "The ID of the draft order this order was created from.",
|
||
"optional": false,
|
||
"defaultValue": "",
|
||
"expandable": false,
|
||
"children": []
|
||
},
|
||
{
|
||
"name": "edits",
|
||
"type": "[OrderEdit](OrderEdit.mdx)[]",
|
||
"description": "The details of the order edits done on the order.",
|
||
"optional": false,
|
||
"defaultValue": "",
|
||
"expandable": true,
|
||
"children": []
|
||
},
|
||
{
|
||
"name": "email",
|
||
"type": "`string`",
|
||
"description": "The email associated with the order",
|
||
"optional": false,
|
||
"defaultValue": "",
|
||
"expandable": false,
|
||
"children": []
|
||
},
|
||
{
|
||
"name": "external_id",
|
||
"type": "``null`` \\| `string`",
|
||
"description": "The ID of an external order.",
|
||
"optional": false,
|
||
"defaultValue": "",
|
||
"expandable": false,
|
||
"children": []
|
||
},
|
||
{
|
||
"name": "fulfillment_status",
|
||
"type": "[FulfillmentStatus](../enums/FulfillmentStatus.mdx)",
|
||
"description": "The order's fulfillment status",
|
||
"optional": false,
|
||
"defaultValue": "not_fulfilled",
|
||
"expandable": false,
|
||
"children": []
|
||
},
|
||
{
|
||
"name": "fulfillments",
|
||
"type": "[Fulfillment](Fulfillment.mdx)[]",
|
||
"description": "The details of the fulfillments created for the order.",
|
||
"optional": false,
|
||
"defaultValue": "",
|
||
"expandable": true,
|
||
"children": []
|
||
},
|
||
{
|
||
"name": "gift_card_tax_total",
|
||
"type": "`number`",
|
||
"description": "The total of gift cards with taxes",
|
||
"optional": false,
|
||
"defaultValue": "",
|
||
"expandable": false,
|
||
"children": []
|
||
},
|
||
{
|
||
"name": "gift_card_total",
|
||
"type": "`number`",
|
||
"description": "The total of gift cards",
|
||
"optional": false,
|
||
"defaultValue": "",
|
||
"expandable": false,
|
||
"children": []
|
||
},
|
||
{
|
||
"name": "gift_card_transactions",
|
||
"type": "[GiftCardTransaction](GiftCardTransaction.mdx)[]",
|
||
"description": "The gift card transactions made in the order.",
|
||
"optional": false,
|
||
"defaultValue": "",
|
||
"expandable": true,
|
||
"children": []
|
||
},
|
||
{
|
||
"name": "gift_cards",
|
||
"type": "[GiftCard](GiftCard.mdx)[]",
|
||
"description": "The details of the gift card used in the order.",
|
||
"optional": false,
|
||
"defaultValue": "",
|
||
"expandable": true,
|
||
"children": []
|
||
},
|
||
{
|
||
"name": "id",
|
||
"type": "`string`",
|
||
"description": "The order's ID",
|
||
"optional": false,
|
||
"defaultValue": "",
|
||
"expandable": false,
|
||
"children": []
|
||
},
|
||
{
|
||
"name": "idempotency_key",
|
||
"type": "`string`",
|
||
"description": "Randomly generated key used to continue the processing of the order in case of failure.",
|
||
"optional": false,
|
||
"defaultValue": "",
|
||
"expandable": false,
|
||
"children": []
|
||
},
|
||
{
|
||
"name": "item_tax_total",
|
||
"type": "``null`` \\| `number`",
|
||
"description": "The tax total applied on items",
|
||
"optional": false,
|
||
"defaultValue": "",
|
||
"expandable": false,
|
||
"children": []
|
||
},
|
||
{
|
||
"name": "items",
|
||
"type": "[LineItem](LineItem.mdx)[]",
|
||
"description": "The details of the line items that belong to the order.",
|
||
"optional": false,
|
||
"defaultValue": "",
|
||
"expandable": true,
|
||
"children": []
|
||
},
|
||
{
|
||
"name": "metadata",
|
||
"type": "`Record<string, unknown>`",
|
||
"description": "An optional key-value map with additional details",
|
||
"optional": false,
|
||
"defaultValue": "",
|
||
"expandable": false,
|
||
"children": []
|
||
},
|
||
{
|
||
"name": "no_notification",
|
||
"type": "`boolean`",
|
||
"description": "Flag for describing whether or not notifications related to this should be send.",
|
||
"optional": false,
|
||
"defaultValue": "",
|
||
"expandable": false,
|
||
"children": []
|
||
},
|
||
{
|
||
"name": "object",
|
||
"type": "``\"order\"``",
|
||
"description": "",
|
||
"optional": false,
|
||
"defaultValue": "\"order\"",
|
||
"expandable": false,
|
||
"children": []
|
||
},
|
||
{
|
||
"name": "paid_total",
|
||
"type": "`number`",
|
||
"description": "The total amount paid",
|
||
"optional": false,
|
||
"defaultValue": "",
|
||
"expandable": false,
|
||
"children": []
|
||
},
|
||
{
|
||
"name": "payment_status",
|
||
"type": "[PaymentStatus](../enums/PaymentStatus.mdx)",
|
||
"description": "The order's payment status",
|
||
"optional": false,
|
||
"defaultValue": "not_paid",
|
||
"expandable": false,
|
||
"children": []
|
||
},
|
||
{
|
||
"name": "payments",
|
||
"type": "[Payment](Payment.mdx)[]",
|
||
"description": "The details of the payments used in the order.",
|
||
"optional": false,
|
||
"defaultValue": "",
|
||
"expandable": true,
|
||
"children": []
|
||
},
|
||
{
|
||
"name": "raw_discount_total",
|
||
"type": "`number`",
|
||
"description": "The total of discount",
|
||
"optional": false,
|
||
"defaultValue": "",
|
||
"expandable": false,
|
||
"children": []
|
||
},
|
||
{
|
||
"name": "refundable_amount",
|
||
"type": "`number`",
|
||
"description": "The amount that can be refunded",
|
||
"optional": false,
|
||
"defaultValue": "",
|
||
"expandable": false,
|
||
"children": []
|
||
},
|
||
{
|
||
"name": "refunded_total",
|
||
"type": "`number`",
|
||
"description": "The total amount refunded if the order is returned.",
|
||
"optional": false,
|
||
"defaultValue": "",
|
||
"expandable": false,
|
||
"children": []
|
||
},
|
||
{
|
||
"name": "refunds",
|
||
"type": "[Refund](Refund.mdx)[]",
|
||
"description": "The details of the refunds created for the order.",
|
||
"optional": false,
|
||
"defaultValue": "",
|
||
"expandable": true,
|
||
"children": []
|
||
},
|
||
{
|
||
"name": "region",
|
||
"type": "[Region](Region.mdx)",
|
||
"description": "The details of the region this order was created in.",
|
||
"optional": false,
|
||
"defaultValue": "",
|
||
"expandable": true,
|
||
"children": []
|
||
},
|
||
{
|
||
"name": "region_id",
|
||
"type": "`string`",
|
||
"description": "The ID of the region this order was created in.",
|
||
"optional": false,
|
||
"defaultValue": "",
|
||
"expandable": false,
|
||
"children": []
|
||
},
|
||
{
|
||
"name": "returnable_items",
|
||
"type": "[LineItem](LineItem.mdx)[]",
|
||
"description": "The details of the line items that are returnable as part of the order, swaps, or claims",
|
||
"optional": true,
|
||
"defaultValue": "",
|
||
"expandable": true,
|
||
"children": []
|
||
},
|
||
{
|
||
"name": "returns",
|
||
"type": "[Return](Return.mdx)[]",
|
||
"description": "The details of the returns created for the order.",
|
||
"optional": false,
|
||
"defaultValue": "",
|
||
"expandable": true,
|
||
"children": []
|
||
},
|
||
{
|
||
"name": "sales_channel",
|
||
"type": "[SalesChannel](SalesChannel.mdx)",
|
||
"description": "The details of the sales channel this order belongs to.",
|
||
"optional": false,
|
||
"defaultValue": "",
|
||
"expandable": true,
|
||
"children": []
|
||
},
|
||
{
|
||
"name": "sales_channel_id",
|
||
"type": "``null`` \\| `string`",
|
||
"description": "The ID of the sales channel this order belongs to.",
|
||
"optional": false,
|
||
"defaultValue": "",
|
||
"expandable": false,
|
||
"children": []
|
||
},
|
||
{
|
||
"name": "shipping_address",
|
||
"type": "[Address](Address.mdx)",
|
||
"description": "The details of the shipping address associated with the order.",
|
||
"optional": false,
|
||
"defaultValue": "",
|
||
"expandable": true,
|
||
"children": []
|
||
},
|
||
{
|
||
"name": "shipping_address_id",
|
||
"type": "`string`",
|
||
"description": "The ID of the shipping address associated with the order",
|
||
"optional": false,
|
||
"defaultValue": "",
|
||
"expandable": false,
|
||
"children": []
|
||
},
|
||
{
|
||
"name": "shipping_methods",
|
||
"type": "[ShippingMethod](ShippingMethod.mdx)[]",
|
||
"description": "The details of the shipping methods used in the order.",
|
||
"optional": false,
|
||
"defaultValue": "",
|
||
"expandable": true,
|
||
"children": []
|
||
},
|
||
{
|
||
"name": "shipping_tax_total",
|
||
"type": "``null`` \\| `number`",
|
||
"description": "The tax total applied on shipping",
|
||
"optional": false,
|
||
"defaultValue": "",
|
||
"expandable": false,
|
||
"children": []
|
||
},
|
||
{
|
||
"name": "shipping_total",
|
||
"type": "`number`",
|
||
"description": "The total of shipping",
|
||
"optional": false,
|
||
"defaultValue": "",
|
||
"expandable": false,
|
||
"children": []
|
||
},
|
||
{
|
||
"name": "status",
|
||
"type": "[OrderStatus](../enums/OrderStatus.mdx)",
|
||
"description": "The order's status",
|
||
"optional": false,
|
||
"defaultValue": "pending",
|
||
"expandable": false,
|
||
"children": []
|
||
},
|
||
{
|
||
"name": "subtotal",
|
||
"type": "`number`",
|
||
"description": "The subtotal of the order",
|
||
"optional": false,
|
||
"defaultValue": "",
|
||
"expandable": false,
|
||
"children": []
|
||
},
|
||
{
|
||
"name": "swaps",
|
||
"type": "[Swap](Swap.mdx)[]",
|
||
"description": "The details of the swaps created for the order.",
|
||
"optional": false,
|
||
"defaultValue": "",
|
||
"expandable": true,
|
||
"children": []
|
||
},
|
||
{
|
||
"name": "tax_rate",
|
||
"type": "``null`` \\| `number`",
|
||
"description": "The order's tax rate",
|
||
"optional": false,
|
||
"defaultValue": "",
|
||
"expandable": false,
|
||
"children": []
|
||
},
|
||
{
|
||
"name": "tax_total",
|
||
"type": "``null`` \\| `number`",
|
||
"description": "The total of tax",
|
||
"optional": false,
|
||
"defaultValue": "",
|
||
"expandable": false,
|
||
"children": []
|
||
},
|
||
{
|
||
"name": "total",
|
||
"type": "`number`",
|
||
"description": "The total amount of the order",
|
||
"optional": false,
|
||
"defaultValue": "",
|
||
"expandable": false,
|
||
"children": []
|
||
},
|
||
{
|
||
"name": "updated_at",
|
||
"type": "`Date`",
|
||
"description": "The date with timezone at which the resource was updated.",
|
||
"optional": false,
|
||
"defaultValue": "",
|
||
"expandable": false,
|
||
"children": []
|
||
}
|
||
]
|
||
},
|
||
{
|
||
"name": "order_id",
|
||
"type": "`string`",
|
||
"description": "The ID of the Order that the Fulfillment belongs to.",
|
||
"optional": false,
|
||
"defaultValue": "",
|
||
"expandable": false,
|
||
"children": []
|
||
},
|
||
{
|
||
"name": "provider",
|
||
"type": "[FulfillmentProvider](FulfillmentProvider.mdx)",
|
||
"description": "The details of the fulfillment provider responsible for handling the fulfillment.",
|
||
"optional": false,
|
||
"defaultValue": "",
|
||
"expandable": true,
|
||
"children": [
|
||
{
|
||
"name": "id",
|
||
"type": "`string`",
|
||
"description": "The ID of the fulfillment provider as given by the fulfillment service.",
|
||
"optional": false,
|
||
"defaultValue": "",
|
||
"expandable": false,
|
||
"children": []
|
||
},
|
||
{
|
||
"name": "is_installed",
|
||
"type": "`boolean`",
|
||
"description": "Whether the fulfillment service is installed in the current version. If a fulfillment service is no longer installed, the `is\\_installed` attribute is set to `false`.",
|
||
"optional": false,
|
||
"defaultValue": "true",
|
||
"expandable": false,
|
||
"children": []
|
||
}
|
||
]
|
||
},
|
||
{
|
||
"name": "provider_id",
|
||
"type": "`string`",
|
||
"description": "The ID of the Fulfillment Provider responsible for handling the fulfillment.",
|
||
"optional": false,
|
||
"defaultValue": "",
|
||
"expandable": false,
|
||
"children": []
|
||
},
|
||
{
|
||
"name": "shipped_at",
|
||
"type": "`Date`",
|
||
"description": "The date with timezone at which the Fulfillment was shipped.",
|
||
"optional": false,
|
||
"defaultValue": "",
|
||
"expandable": false,
|
||
"children": []
|
||
},
|
||
{
|
||
"name": "swap",
|
||
"type": "[Swap](Swap.mdx)",
|
||
"description": "The details of the swap that the fulfillment may belong to.",
|
||
"optional": false,
|
||
"defaultValue": "",
|
||
"expandable": true,
|
||
"children": [
|
||
{
|
||
"name": "additional_items",
|
||
"type": "[LineItem](LineItem.mdx)[]",
|
||
"description": "The details of the new products to send to the customer, represented as line items.",
|
||
"optional": false,
|
||
"defaultValue": "",
|
||
"expandable": true,
|
||
"children": []
|
||
},
|
||
{
|
||
"name": "allow_backorder",
|
||
"type": "`boolean`",
|
||
"description": "If true, swaps can be completed with items out of stock",
|
||
"optional": false,
|
||
"defaultValue": "false",
|
||
"expandable": false,
|
||
"children": []
|
||
},
|
||
{
|
||
"name": "canceled_at",
|
||
"type": "`Date`",
|
||
"description": "The date with timezone at which the Swap was canceled.",
|
||
"optional": false,
|
||
"defaultValue": "",
|
||
"expandable": false,
|
||
"children": []
|
||
},
|
||
{
|
||
"name": "cart",
|
||
"type": "[Cart](Cart.mdx)",
|
||
"description": "The details of the cart that the customer uses to complete the swap.",
|
||
"optional": false,
|
||
"defaultValue": "",
|
||
"expandable": true,
|
||
"children": []
|
||
},
|
||
{
|
||
"name": "cart_id",
|
||
"type": "`string`",
|
||
"description": "The ID of the cart that the customer uses to complete the swap.",
|
||
"optional": false,
|
||
"defaultValue": "",
|
||
"expandable": false,
|
||
"children": []
|
||
},
|
||
{
|
||
"name": "confirmed_at",
|
||
"type": "`Date`",
|
||
"description": "The date with timezone at which the Swap was confirmed by the Customer.",
|
||
"optional": false,
|
||
"defaultValue": "",
|
||
"expandable": false,
|
||
"children": []
|
||
},
|
||
{
|
||
"name": "created_at",
|
||
"type": "`Date`",
|
||
"description": "The date with timezone at which the resource was created.",
|
||
"optional": false,
|
||
"defaultValue": "",
|
||
"expandable": false,
|
||
"children": []
|
||
},
|
||
{
|
||
"name": "deleted_at",
|
||
"type": "``null`` \\| `Date`",
|
||
"description": "The date with timezone at which the resource was deleted.",
|
||
"optional": false,
|
||
"defaultValue": "",
|
||
"expandable": false,
|
||
"children": []
|
||
},
|
||
{
|
||
"name": "difference_due",
|
||
"type": "`number`",
|
||
"description": "The difference amount between the order’s original total and the new total imposed by the swap. If its value is negative, a refund must be issues to the customer. If it's positive, additional payment must be authorized by the customer. Otherwise, no payment processing is required.",
|
||
"optional": false,
|
||
"defaultValue": "",
|
||
"expandable": false,
|
||
"children": []
|
||
},
|
||
{
|
||
"name": "fulfillment_status",
|
||
"type": "[SwapFulfillmentStatus](../enums/SwapFulfillmentStatus.mdx)",
|
||
"description": "The status of the Fulfillment of the Swap.",
|
||
"optional": false,
|
||
"defaultValue": "",
|
||
"expandable": false,
|
||
"children": []
|
||
},
|
||
{
|
||
"name": "fulfillments",
|
||
"type": "[Fulfillment](Fulfillment.mdx)[]",
|
||
"description": "The details of the fulfillments that are used to send the new items to the customer.",
|
||
"optional": false,
|
||
"defaultValue": "",
|
||
"expandable": true,
|
||
"children": []
|
||
},
|
||
{
|
||
"name": "id",
|
||
"type": "`string`",
|
||
"description": "The swap's ID",
|
||
"optional": false,
|
||
"defaultValue": "",
|
||
"expandable": false,
|
||
"children": []
|
||
},
|
||
{
|
||
"name": "idempotency_key",
|
||
"type": "`string`",
|
||
"description": "Randomly generated key used to continue the completion of the swap in case of failure.",
|
||
"optional": false,
|
||
"defaultValue": "",
|
||
"expandable": false,
|
||
"children": []
|
||
},
|
||
{
|
||
"name": "metadata",
|
||
"type": "`Record<string, unknown>`",
|
||
"description": "An optional key-value map with additional details",
|
||
"optional": false,
|
||
"defaultValue": "",
|
||
"expandable": false,
|
||
"children": []
|
||
},
|
||
{
|
||
"name": "no_notification",
|
||
"type": "`boolean`",
|
||
"description": "If set to true, no notification will be sent related to this swap",
|
||
"optional": false,
|
||
"defaultValue": "",
|
||
"expandable": false,
|
||
"children": []
|
||
},
|
||
{
|
||
"name": "order",
|
||
"type": "[Order](Order.mdx)",
|
||
"description": "The details of the order that the swap belongs to.",
|
||
"optional": false,
|
||
"defaultValue": "",
|
||
"expandable": true,
|
||
"children": []
|
||
},
|
||
{
|
||
"name": "order_id",
|
||
"type": "`string`",
|
||
"description": "The ID of the order that the swap belongs to.",
|
||
"optional": false,
|
||
"defaultValue": "",
|
||
"expandable": false,
|
||
"children": []
|
||
},
|
||
{
|
||
"name": "payment",
|
||
"type": "[Payment](Payment.mdx)",
|
||
"description": "The details of the additional payment authorized by the customer when `difference\\_due` is positive.",
|
||
"optional": false,
|
||
"defaultValue": "",
|
||
"expandable": true,
|
||
"children": []
|
||
},
|
||
{
|
||
"name": "payment_status",
|
||
"type": "[SwapPaymentStatus](../enums/SwapPaymentStatus.mdx)",
|
||
"description": "The status of the Payment of the Swap. The payment may either refer to the refund of an amount or the authorization of a new amount.",
|
||
"optional": false,
|
||
"defaultValue": "",
|
||
"expandable": false,
|
||
"children": []
|
||
},
|
||
{
|
||
"name": "return_order",
|
||
"type": "[Return](Return.mdx)",
|
||
"description": "The details of the return that belongs to the swap, which holds the details on the items being returned.",
|
||
"optional": false,
|
||
"defaultValue": "",
|
||
"expandable": true,
|
||
"children": []
|
||
},
|
||
{
|
||
"name": "shipping_address",
|
||
"type": "[Address](Address.mdx)",
|
||
"description": "The details of the shipping address that the new items should be sent to.",
|
||
"optional": false,
|
||
"defaultValue": "",
|
||
"expandable": true,
|
||
"children": []
|
||
},
|
||
{
|
||
"name": "shipping_address_id",
|
||
"type": "`string`",
|
||
"description": "The Address to send the new Line Items to - in most cases this will be the same as the shipping address on the Order.",
|
||
"optional": false,
|
||
"defaultValue": "",
|
||
"expandable": false,
|
||
"children": []
|
||
},
|
||
{
|
||
"name": "shipping_methods",
|
||
"type": "[ShippingMethod](ShippingMethod.mdx)[]",
|
||
"description": "The details of the shipping methods used to fulfill the additional items purchased.",
|
||
"optional": false,
|
||
"defaultValue": "",
|
||
"expandable": true,
|
||
"children": []
|
||
},
|
||
{
|
||
"name": "updated_at",
|
||
"type": "`Date`",
|
||
"description": "The date with timezone at which the resource was updated.",
|
||
"optional": false,
|
||
"defaultValue": "",
|
||
"expandable": false,
|
||
"children": []
|
||
}
|
||
]
|
||
},
|
||
{
|
||
"name": "swap_id",
|
||
"type": "`string`",
|
||
"description": "The ID of the Swap that the Fulfillment belongs to.",
|
||
"optional": false,
|
||
"defaultValue": "",
|
||
"expandable": false,
|
||
"children": []
|
||
},
|
||
{
|
||
"name": "tracking_links",
|
||
"type": "[TrackingLink](TrackingLink.mdx)[]",
|
||
"description": "The Tracking Links that can be used to track the status of the Fulfillment. These will usually be provided by the Fulfillment Provider.",
|
||
"optional": false,
|
||
"defaultValue": "",
|
||
"expandable": true,
|
||
"children": [
|
||
{
|
||
"name": "created_at",
|
||
"type": "`Date`",
|
||
"description": "The date with timezone at which the resource was created.",
|
||
"optional": false,
|
||
"defaultValue": "",
|
||
"expandable": false,
|
||
"children": []
|
||
},
|
||
{
|
||
"name": "deleted_at",
|
||
"type": "``null`` \\| `Date`",
|
||
"description": "The date with timezone at which the resource was deleted.",
|
||
"optional": false,
|
||
"defaultValue": "",
|
||
"expandable": false,
|
||
"children": []
|
||
},
|
||
{
|
||
"name": "fulfillment",
|
||
"type": "[Fulfillment](Fulfillment.mdx)",
|
||
"description": "The details of the fulfillment that the tracking link belongs to.",
|
||
"optional": false,
|
||
"defaultValue": "",
|
||
"expandable": true,
|
||
"children": []
|
||
},
|
||
{
|
||
"name": "fulfillment_id",
|
||
"type": "`string`",
|
||
"description": "The ID of the fulfillment that the tracking link belongs to.",
|
||
"optional": false,
|
||
"defaultValue": "",
|
||
"expandable": false,
|
||
"children": []
|
||
},
|
||
{
|
||
"name": "id",
|
||
"type": "`string`",
|
||
"description": "The tracking link's ID",
|
||
"optional": false,
|
||
"defaultValue": "",
|
||
"expandable": false,
|
||
"children": []
|
||
},
|
||
{
|
||
"name": "idempotency_key",
|
||
"type": "`string`",
|
||
"description": "Randomly generated key used to continue the completion of a process in case of failure.",
|
||
"optional": false,
|
||
"defaultValue": "",
|
||
"expandable": false,
|
||
"children": []
|
||
},
|
||
{
|
||
"name": "metadata",
|
||
"type": "`Record<string, unknown>`",
|
||
"description": "An optional key-value map with additional details",
|
||
"optional": false,
|
||
"defaultValue": "",
|
||
"expandable": false,
|
||
"children": []
|
||
},
|
||
{
|
||
"name": "tracking_number",
|
||
"type": "`string`",
|
||
"description": "The tracking number given by the shipping carrier.",
|
||
"optional": false,
|
||
"defaultValue": "",
|
||
"expandable": false,
|
||
"children": []
|
||
},
|
||
{
|
||
"name": "updated_at",
|
||
"type": "`Date`",
|
||
"description": "The date with timezone at which the resource was updated.",
|
||
"optional": false,
|
||
"defaultValue": "",
|
||
"expandable": false,
|
||
"children": []
|
||
},
|
||
{
|
||
"name": "url",
|
||
"type": "`string`",
|
||
"description": "The URL at which the status of the shipment can be tracked.",
|
||
"optional": false,
|
||
"defaultValue": "",
|
||
"expandable": false,
|
||
"children": []
|
||
}
|
||
]
|
||
},
|
||
{
|
||
"name": "tracking_numbers",
|
||
"type": "`string`[]",
|
||
"description": "The tracking numbers that can be used to track the status of the fulfillment.",
|
||
"optional": false,
|
||
"defaultValue": "",
|
||
"expandable": false,
|
||
"children": []
|
||
},
|
||
{
|
||
"name": "updated_at",
|
||
"type": "`Date`",
|
||
"description": "The date with timezone at which the resource was updated.",
|
||
"optional": false,
|
||
"defaultValue": "",
|
||
"expandable": false,
|
||
"children": []
|
||
}
|
||
]} />
|