orderBillingUpdate Mutation

Description

Updates the billing information for an order, including billing address and invoice ID.

mutation orderBillingUpdate($orderRef: ID!, $billingAddress: AddressInput) {
  orderBillingUpdate(orderRef: $orderRef, billingAddress: $billingAddress) {
    _id
    id
    incId
    origin
    created
    modified
    shipping {
      status
      fulfilled
      date
      method
      freeShippingThreshold
      tracking
      shopCollection
      weight
      packingSlip
    }
    billing {
      status
      fulfilled
      paymentDate
      refundDate
    }
    orderId
    notes {
      date
      content
    }
    instructions
    totals {
      subtotal
      subtotalBeforeTaxes
      tax
      grand
      leftToPay
      itemQuantity
      discount
      shipping
      creditNote
      balance
    }
    items {
      _id
      quantity
      unavailable
      added
    }
    messages {
      _id
      created
      subject
      message
      fromBuyer
      flagged
      content
      read
      orderId
      orderIncId
      uri
      via
    }
    buyer {
      _id
      firstName
      lastName
      email
      name
      path
      telephone
      organisation
      taxNumber
    }
    logs {
      action
      description
      date
      ip
    }
    seller {
      type
      name
      email
      ref
    }
    updated
    status
    discogsStatus
    buyerWasContacted
    unreadMessagesCount
    mergeableOrders {
      _id
      id
      created
      total
      description
    }
    path
  }
}

Variables

{
    "orderRef": "4f03c5bb1302943724bf3760",
    "billingAddress": {
        "description": "A description",
        "addressLine1": "addressLine1",
        "addressLine2": "addressLine2",
        "streetNumber": 42,
        "city": "Montreal",
        "state": "Quebec",
        "postCode": "postCode",
        "alpha2": "alpha2",
        "country": "Canada",
        "stateCode": "stateCode",
        "type": "type",
        "geoLoc": {
            "type": "type",
            "coordinates": [
                30.7
            ]
        }
    }
}

Response

{
    "orderBillingUpdate": {
        "_id": "851c906ba986e8816527203c",
        "id": "example",
        "incId": 42,
        "origin": "example",
        "created": 1744529717026,
        "modified": 1724479312470,
        "shipping": {
            "status": "Pending",
            "fulfilled": true,
            "date": 1756133195634,
            "method": "example",
            "freeShippingThreshold": 1.23,
            "tracking": "example",
            "shopCollection": true,
            "weight": 1.23,
            "packingSlip": "example"
        },
        "billing": {
            "status": "example",
            "fulfilled": true,
            "paymentDate": 1762465917945,
            "refundDate": 1765402322792
        },
        "orderId": "example",
        "notes": [
            {
                "date": 1736707430884,
                "content": "example"
            }
        ],
        "instructions": "example",
        "totals": {
            "subtotal": 1.23,
            "subtotalBeforeTaxes": 1.23,
            "tax": 1.23,
            "grand": 1.23,
            "leftToPay": 1.23,
            "itemQuantity": 1.23,
            "discount": 0.1,
            "shipping": 1.23,
            "creditNote": 1.23,
            "balance": 1.23
        },
        "items": [
            {
                "_id": "cd52e48c16c7b7ef58b505f5",
                "quantity": 1,
                "unavailable": true,
                "added": 1722602312197
            }
        ],
        "messages": [
            {
                "_id": "e6a3b8200d2344aaebae428f",
                "created": 1753798549142,
                "subject": "example",
                "message": "example",
                "fromBuyer": true,
                "flagged": true,
                "content": "example",
                "read": true,
                "orderId": "example",
                "orderIncId": 42,
                "uri": "https://www.my-common-ground-store.com/release/1763553751/release-artist-release-name",
                "via": "example"
            }
        ],
        "buyer": {
            "_id": "2e72fadec07fcf38699fc08a",
            "firstName": "example",
            "lastName": "example",
            "email": "email@example.com",
            "name": "example",
            "path": "/release/1763553751/release-artist-release-name",
            "telephone": "example",
            "organisation": "example",
            "taxNumber": "example"
        },
        "logs": [
            {
                "action": "example",
                "description": "example",
                "date": 1727854359206,
                "ip": "example"
            }
        ],
        "seller": {
            "type": "example",
            "name": "example",
            "email": "email@example.com",
            "ref": "c356b415e9174f83107ae351"
        },
        "updated": 1727103697248,
        "status": "example",
        "discogsStatus": "example",
        "buyerWasContacted": true,
        "unreadMessagesCount": 42,
        "mergeableOrders": [
            {
                "_id": "1f5836e6bded0860d1edde43",
                "id": "example",
                "created": 1768459596327,
                "total": 29.99,
                "description": "example"
            }
        ],
        "path": "/release/1763553751/release-artist-release-name"
    }
}

Arguments

Name	Type	Description
orderRef	ID!	Reference ID of the order to update.
billingAddress	AddressInput	Billing address for the order. If not provided, the billing address remains unchanged.

Returns

Order!