For digital products, is there a way to fulfil order items separately?

[jramoyo-serenade]

Let's say a customer purchased 2 digital products as order items, and only 1 has been provisioned so far.

Is there a way for us to separately mark order items as fulfilled? Ideally the order is only marked as fulfilled when all order items have been fulfilled?

I tried this via the API, but if I set the quantity_delivered of only 1 item, the entire order gets marked as fulfilled.

My guess is that the delivered flag is set to true if item_quantity_delivered > item_quantity_deliverable, but I can't seem to find a way to set quantity_deliverable when creating an order.

POST /orders

{
  "account_id": "6530655d48ae5d00128ed0ad",
  "items": [
    {
      "product_id": "65306535844d6200118dd00b",
      "quantity": 1,
      "quantity_deliverable": 1
    },
    {
      "product_id": "65306522f031880012e6cf96",
      "quantity": 1,
      "quantity_deliverable": 1
    }
  ]
}

Response (quantity_deliverable gets ignored)

{
  "account_id": "6530655d48ae5d00128ed0ad",
  "items": [
    {
      "product_id": "65306535844d6200118dd00b",
      "quantity": 1,
      "quantity_deliverable": 0,
      "id": "65307131d25c0900129b091f",
      "quantity_delivered": 0
    },
    {
      "product_id": "65306522f031880012e6cf96",
      "quantity": 1,
      "quantity_deliverable": 0,
      "id": "65307131d25c0900129b0920",
      "quantity_delivered": 0
    }
  ],
  "item_quantity_delivered": 0,
  "item_quantity_deliverable": 0,
  "delivered": false,
  "item_quantity": 2,
  "status": "payment_pending",
  "payment_total": 0,
  "refund_total": 0,
  "number": "100003",
  "id": "65307131d25c0900129b0921"
}

---

POST /payments

{
  "account_id": "6530655d48ae5d00128ed0ad",
  "amount": 25,
  "method": "cash",
  "order_id": "65307131d25c0900129b0921"
}

---

PUT /orders/65307131d25c0900129b0921

{
  "items": [
    {
      "id": "65307131d25c0900129b091f",
      "quantity_delivered": 1
    }
  ]
}

Response (order.delivered is set to true)

{
  "account_id": "6530655d48ae5d00128ed0ad",
  "items": [
    {
      "product_id": "65306535844d6200118dd00b",
      "quantity": 1,
      "quantity_deliverable": 0,
      "id": "65307131d25c0900129b091f",
      "price": 15,
      "stock_tracking": true,
      "shipment_weight": 0,
      "product_name": "Digital Product 2",
      "quantity_total": 1,
      "price_total": 15,
      "discount_total": 0,
      "quantity_invoiceable": 1,
      "quantity_creditable": 1,
      "quantity_cancelable": 0,
      "discount_each": 0,
      "tax_total": 0,
      "tax_each": 0,
      "quantity_canceled": 0,
      "quantity_delivered": 1,
      "quantity_consumed": 1
    },
    {
      "product_id": "65306522f031880012e6cf96",
      "quantity": 1,
      "quantity_deliverable": 0,
      "id": "65307131d25c0900129b0920",
      "price": 10,
      "stock_tracking": true,
      "shipment_weight": 0,
      "product_name": "Digital Product 1",
      "quantity_total": 1,
      "price_total": 10,
      "discount_total": 0,
      "quantity_invoiceable": 1,
      "quantity_creditable": 1,
      "quantity_cancelable": 1,
      "discount_each": 0,
      "tax_total": 0,
      "tax_each": 0,
      "quantity_canceled": 0,
      "quantity_delivered": 0,
      "quantity_consumed": 1
    }
  ],
  "date_trial_end": null,
  "billing": {},
  "shipping": {},
  "currency": "USD",
  "sub_total": 25,
  "shipment_price": 0,
  "shipment_total": 0,
  "item_tax": 0,
  "tax_included_total": 0,
  "item_discount": 0,
  "discount_total": 0,
  "grand_total": 25,
  "return_item_total": 0,
  "return_item_tax": 0,
  "return_item_tax_included": 0,
  "return_total": 0,
  "payment_balance": 0,
  "paid": true,
  "refunded": false,
  "item_quantity_delivered": 1,
  "item_quantity_deliverable": 0,
  "delivered": true,
  "item_quantity": 2,
  "item_quantity_canceled": 0,
  "item_quantity_cancelable": 1,
  "item_quantity_returned": 0,
  "item_quantity_returnable": 0,
  "item_quantity_invoiced": 0,
  "item_quantity_invoiceable": 2,
  "item_quantity_credited": 0,
  "item_quantity_creditable": 2,
  "item_shipment_weight": 0,
  "shipment_tax_included_total": 0,
  "tax_total": 0,
  "giftcard_total": 0,
  "guest": true,
  "taxes": null,
  "date_created": "2023-10-18T23:58:41.372Z",
  "hold": false,
  "closed": false,
  "status": "complete",
  "payment_total": 25,
  "refund_total": 0,
  "number": "100003",
  "date_updated": "2023-10-19T00:07:17.739Z",
  "payment_marked": true,
  "test": true,
  "id": "65307131d25c0900129b0921"
}

[ericingram]

I believe that's because there isn't a built-in "delivery" method for digital items, and the quantity_delivered and related field formulas only work with the standard delivery methods out of the box (shipment, subscription, giftcard)

It should be possible to customize the model for this use case but since we haven't tested this approach I can't say for sure what the side effects might be

You can give it a try by changing the enum property on the orders model delivery fields via API console