Workflows

Orders

Find wholesale orders, quote shipping orders, and apply reviewed previews.

Find buyers and orders

Search by buyer name, then pass the exact account ID to read that buyer’s checkout options. List orders with a bounded page size and pass the returned cursor for the next page. Use the saved order ID for details.

finoctl wholesale orders options --query "Example store" --limit 10
finoctl wholesale orders options --buyer "$BUYER_ID"
finoctl wholesale orders list --limit 25
finoctl wholesale orders list --limit 25 --cursor "$NEXT_CURSOR"
finoctl wholesale orders get "$ORDER_ID"

Quote a shipping order

The CLI accepts registered buyer orders or guest orders. A registered order needs buyer_user_id. A guest order needs as_guest: true, customer_name, email, and whatsapp. Both need a shipping address and at least one line with a saved SKU, positive quantity, and hats_only or full_set. Use one line for each SKU and set type pair.

Set fulfillment_method to ship, or let the CLI default it. For Mexico, provide the importer details required by the Portal in mexico_customs. Use the Portal checkout when it requires additional destination information that your installed CLI cannot represent.

This illustrative guest order shows the file format. Replace the example identity, address, SKU, and quantity before getting a quote. The server decides current pricing, minimum quantities, availability, and country requirements.

{
  "as_guest": true,
  "customer_name": "Example Buyer",
  "email": "buyer@example.com",
  "whatsapp": "+12025550100",
  "fulfillment_method": "ship",
  "goods_payment_method": "bank_transfer",
  "ship_destination": "US",
  "ship_address": {
    "name": "Example Buyer",
    "address1": "123 Example Avenue",
    "city": "Los Angeles",
    "state": "CA",
    "zip": "90001",
    "country": "US"
  },
  "items": [
    { "sku": "EXAMPLE-HAT", "qty": 30, "set_type": "hats_only" }
  ]
}

Save your input privately as order.json. See Input files for the complete fields. The command asks the server for a quote and writes a new preview file.

finoctl wholesale orders create --file order.json --out order-preview.json

Apply a reviewed order

Review the buyer, address, lines, quantities, and server totals in the preview. Use the checksum printed by the CLI. Applying creates an unpaid goods obligation, reserves capacity, and queues an invoice or PDF attempt. Shipping is billed separately. Confirm those effects before running the command.

finoctl wholesale apply order-preview.json --confirm "$CHECKSUM" --accept-order-effects

Read the returned order ID back with orders get. If the network drops during apply, preserve the original file and operation ID and reconcile the result before repeating it. See Troubleshooting.