Tag orders when your delivery service updates

from clickruntime import on_event, credentials, http, log

STORE = "your-store.myshopify.com"

def gql(query, variables=None):
    resp = http.post(f"https://{STORE}/admin/api/2025-07/graphql.json",
                     headers={"X-Shopify-Access-Token": credentials.connection("shopify", "store")},
                     json={"query": query, "variables": variables or {}})
    resp.raise_for_status()
    return resp.json()["data"]

TAGS = {"delivered": "delivered", "delayed": "delayed", "exception": "delivery-issue", "out_for_delivery": "out-for-delivery"}

@on_event
def handle(event):
    update = event.json or {}
    tag = TAGS.get(update.get("status"))
    if not tag:
        return {"tagged": False}
    orders = gql("query($q: String!) { orders(first: 1, query: $q) { nodes { id } } }",
                 {"q": f"name:{update['order_number']}"})["orders"]["nodes"]
    if not orders:
        log.warning("order not found", {"order": update.get("order_number")})
        return {"tagged": False}
    gql("mutation($id: ID!, $tags: [String!]!) { tagsAdd(id: $id, tags: $tags) { userErrors { message } } }",
        {"id": orders[0]["id"], "tags": [tag]})
    return {"tagged": True, "tag": tag}