---
title: "Upload order receipt data"
method: POST
path: "/v3/orders/upload-receipt"
tags: ["Orders"]
---

# Upload order receipt data

`POST /v3/orders/upload-receipt`

Requires the `order:update` scope. Upload file to update shipment receipts (tracking IDs) for multiple orders. Template file can be downloaded from the link here: https://app.scalev.id/example/receipt_template.csv.

## Response `200`

Receipt uploaded successfully

- UploadOrderReceiptResponseBody — Non-paginated list payload for v3.
  - `data` UploadReceipt[], required
    - `id` string, uuid — Canonical UUIDv7 order primary key returned by the partitioned orders table.
    - `order_id` string — Order ID in string format
    - `public_order_url` string, uri, nullable — Public order URL built from metadata.custom_domain_full_url and secret_slug.
    - `payment_url` string, uri, nullable — Payment URL built from public_order_url with /success appended.
    - `shipment_receipt` string, nullable — Shipment receipt URL
  - `is_paginated` false, required

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden

---

[API](https://skmtc.net/scalev/apis/nexus-commerce-api.md) · [All operations](https://skmtc.net/scalev/apis/nexus-commerce-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/scalev/nexus-commerce-api/revisions/4354959d76dc/schema)