curl --request POST \
--url 'https://api.stateset.com/api/v1/receipts' \
--header "Authorization: Bearer $STATESET_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"carrier": "UPS",
"created_by": "string",
"expected_date": "2026-08-31T14:22:05Z",
"items": [
{
"description": "Two-person tent, green — replacement for damaged pole set.",
"expected_quantity": "string",
"lot_number": "string",
"notes": "Two-person tent, green — replacement for damaged pole set.",
"po_line_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"sku": "SKU-TENT-2P-GRN",
"unit_cost": "49.00"
}
],
"notes": "Two-person tent, green — replacement for damaged pole set.",
"receipt_type": "string",
"reference_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"reference_type": "string",
"supplier_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"tracking_number": "1Z999AA10123456784",
"warehouse_id": 1001
}'
{
"carrier": "UPS",
"created_at": "2026-08-31T14:22:05Z",
"expected_quantity": "string",
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"put_away_quantity": "string",
"receipt_number": "string",
"receipt_type": "string",
"received_quantity": "string",
"status": "pending",
"supplier_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"tracking_number": "1Z999AA10123456784",
"warehouse_id": 1001
}
Create a receipt
Create a receipt
POST
/
api
/
v1
/
receipts
curl --request POST \
--url 'https://api.stateset.com/api/v1/receipts' \
--header "Authorization: Bearer $STATESET_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"carrier": "UPS",
"created_by": "string",
"expected_date": "2026-08-31T14:22:05Z",
"items": [
{
"description": "Two-person tent, green — replacement for damaged pole set.",
"expected_quantity": "string",
"lot_number": "string",
"notes": "Two-person tent, green — replacement for damaged pole set.",
"po_line_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"sku": "SKU-TENT-2P-GRN",
"unit_cost": "49.00"
}
],
"notes": "Two-person tent, green — replacement for damaged pole set.",
"receipt_type": "string",
"reference_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"reference_type": "string",
"supplier_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"tracking_number": "1Z999AA10123456784",
"warehouse_id": 1001
}'
{
"carrier": "UPS",
"created_at": "2026-08-31T14:22:05Z",
"expected_quantity": "string",
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"put_away_quantity": "string",
"receipt_number": "string",
"receipt_type": "string",
"received_quantity": "string",
"status": "pending",
"supplier_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"tracking_number": "1Z999AA10123456784",
"warehouse_id": 1001
}
Request body
CreateReceiptRequest
string,null
string,null
string,null
RFC 3339 timestamp.
CreateReceiptItemRequest[]
required
string,null
string,null
One of
purchase_order, transfer, return, adjustment, production, other.string,null
string,null
string,null
string,null
integer (int32)
required
Response
ReceiptResponse
string,null
string
required
string
required
string
required
string
required
string
required
string
required
string
required
string
required
string,null
string,null
integer (int32)
required
Status codes
| Code | Meaning |
|---|---|
201 | — |
400 | — |
curl --request POST \
--url 'https://api.stateset.com/api/v1/receipts' \
--header "Authorization: Bearer $STATESET_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"carrier": "UPS",
"created_by": "string",
"expected_date": "2026-08-31T14:22:05Z",
"items": [
{
"description": "Two-person tent, green — replacement for damaged pole set.",
"expected_quantity": "string",
"lot_number": "string",
"notes": "Two-person tent, green — replacement for damaged pole set.",
"po_line_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"sku": "SKU-TENT-2P-GRN",
"unit_cost": "49.00"
}
],
"notes": "Two-person tent, green — replacement for damaged pole set.",
"receipt_type": "string",
"reference_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"reference_type": "string",
"supplier_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"tracking_number": "1Z999AA10123456784",
"warehouse_id": 1001
}'
{
"carrier": "UPS",
"created_at": "2026-08-31T14:22:05Z",
"expected_quantity": "string",
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"put_away_quantity": "string",
"receipt_number": "string",
"receipt_type": "string",
"received_quantity": "string",
"status": "pending",
"supplier_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"tracking_number": "1Z999AA10123456784",
"warehouse_id": 1001
}
Last modified on August 31, 2026