curl --location --request PUT 'https://api.stateset.com/v1/asns/asn_0901f083-aa1c-43c5-af5c-0a9d2fc64e30' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--data-raw '{
"status": "delivered",
"actual_arrival_date": "2024-01-18T09:30:00Z",
"tracking_info": {
"current_status": "Delivered"
},
"shipping_documents": [
{
"type": "proof_of_delivery",
"document_number": "POD-2024-00001",
"url": "https://documents.stateset.com/pod/POD-2024-00001.pdf"
}
]
}'
{
"id": "asn_0901f083-aa1c-43c5-af5c-0a9d2fc64e30",
"object": "asn",
"asn_number": "ASN-2024-00001",
"status": "delivered",
"created_at": "2024-01-15T14:30:00Z",
"updated_at": "2024-01-18T09:35:00Z",
"purchase_order_id": "po_123456789",
"supplier_id": "sup_abc123",
"warehouse_id": "wh_001",
"shipment_date": "2024-01-15T14:00:00Z",
"expected_arrival_date": "2024-01-18T10:00:00Z",
"actual_arrival_date": "2024-01-18T09:30:00Z",
"tracking_info": {
"carrier": "UPS",
"tracking_number": "1Z999AA10123456784",
"service_type": "Ground",
"tracking_url": "https://www.ups.com/track?tracknum=1Z999AA10123456784",
"current_status": "Delivered",
"last_update": "2024-01-18T09:30:00Z"
},
"items": [
{
"id": "asn_item_123",
"sku": "WBH-001",
"product_name": "Wireless Bluetooth Headphones",
"quantity_shipped": 500,
"quantity_ordered": 500,
"quantity_received": 0,
"unit_cost": {
"amount": 7500,
"currency": "USD"
},
"lot_number": "LOT-2024-001",
"status": "pending_receipt"
},
{
"id": "asn_item_124",
"sku": "USB-C-001",
"product_name": "USB-C Charging Cable",
"quantity_shipped": 1000,
"quantity_ordered": 1000,
"quantity_received": 0,
"unit_cost": {
"amount": 450,
"currency": "USD"
},
"lot_number": "LOT-2024-002",
"status": "pending_receipt"
}
],
"packaging_details": {
"total_packages": 10,
"total_pallets": 2,
"total_weight": {
"value": 250,
"unit": "lb"
}
},
"shipping_documents": [
{
"type": "packing_list",
"document_number": "PL-2024-00001",
"url": "https://documents.stateset.com/packing-lists/PL-2024-00001.pdf"
},
{
"type": "proof_of_delivery",
"document_number": "POD-2024-00001",
"url": "https://documents.stateset.com/pod/POD-2024-00001.pdf"
}
],
"notes": "Please schedule receiving appointment. Fragile electronics.",
"metadata": {}
}
Update ASN
Update an existing ASN with new tracking information or status
PUT
/
v1
/
asns
/
:id
curl --location --request PUT 'https://api.stateset.com/v1/asns/asn_0901f083-aa1c-43c5-af5c-0a9d2fc64e30' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--data-raw '{
"status": "delivered",
"actual_arrival_date": "2024-01-18T09:30:00Z",
"tracking_info": {
"current_status": "Delivered"
},
"shipping_documents": [
{
"type": "proof_of_delivery",
"document_number": "POD-2024-00001",
"url": "https://documents.stateset.com/pod/POD-2024-00001.pdf"
}
]
}'
{
"id": "asn_0901f083-aa1c-43c5-af5c-0a9d2fc64e30",
"object": "asn",
"asn_number": "ASN-2024-00001",
"status": "delivered",
"created_at": "2024-01-15T14:30:00Z",
"updated_at": "2024-01-18T09:35:00Z",
"purchase_order_id": "po_123456789",
"supplier_id": "sup_abc123",
"warehouse_id": "wh_001",
"shipment_date": "2024-01-15T14:00:00Z",
"expected_arrival_date": "2024-01-18T10:00:00Z",
"actual_arrival_date": "2024-01-18T09:30:00Z",
"tracking_info": {
"carrier": "UPS",
"tracking_number": "1Z999AA10123456784",
"service_type": "Ground",
"tracking_url": "https://www.ups.com/track?tracknum=1Z999AA10123456784",
"current_status": "Delivered",
"last_update": "2024-01-18T09:30:00Z"
},
"items": [
{
"id": "asn_item_123",
"sku": "WBH-001",
"product_name": "Wireless Bluetooth Headphones",
"quantity_shipped": 500,
"quantity_ordered": 500,
"quantity_received": 0,
"unit_cost": {
"amount": 7500,
"currency": "USD"
},
"lot_number": "LOT-2024-001",
"status": "pending_receipt"
},
{
"id": "asn_item_124",
"sku": "USB-C-001",
"product_name": "USB-C Charging Cable",
"quantity_shipped": 1000,
"quantity_ordered": 1000,
"quantity_received": 0,
"unit_cost": {
"amount": 450,
"currency": "USD"
},
"lot_number": "LOT-2024-002",
"status": "pending_receipt"
}
],
"packaging_details": {
"total_packages": 10,
"total_pallets": 2,
"total_weight": {
"value": 250,
"unit": "lb"
}
},
"shipping_documents": [
{
"type": "packing_list",
"document_number": "PL-2024-00001",
"url": "https://documents.stateset.com/packing-lists/PL-2024-00001.pdf"
},
{
"type": "proof_of_delivery",
"document_number": "POD-2024-00001",
"url": "https://documents.stateset.com/pod/POD-2024-00001.pdf"
}
],
"notes": "Please schedule receiving appointment. Fragile electronics.",
"metadata": {}
}
Documentation Index
Fetch the complete documentation index at: https://docs.stateset.com/llms.txt
Use this file to discover all available pages before exploring further.
This endpoint supports partial updates. Only include the fields you want to change. Once an ASN is received, only certain fields can be updated.
Path Parameters
The unique identifier of the ASN to update
Request Body
Updated expected delivery date (ISO 8601)
Actual delivery date when shipment arrives (ISO 8601)
Updated status: “pending”, “in_transit”, “delivered”, “received”, “partially_received”, “cancelled”
Updated notes or instructions
Updated custom metadata
Response
Returns the updated ASN object with all fields.curl --location --request PUT 'https://api.stateset.com/v1/asns/asn_0901f083-aa1c-43c5-af5c-0a9d2fc64e30' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--data-raw '{
"status": "delivered",
"actual_arrival_date": "2024-01-18T09:30:00Z",
"tracking_info": {
"current_status": "Delivered"
},
"shipping_documents": [
{
"type": "proof_of_delivery",
"document_number": "POD-2024-00001",
"url": "https://documents.stateset.com/pod/POD-2024-00001.pdf"
}
]
}'
{
"id": "asn_0901f083-aa1c-43c5-af5c-0a9d2fc64e30",
"object": "asn",
"asn_number": "ASN-2024-00001",
"status": "delivered",
"created_at": "2024-01-15T14:30:00Z",
"updated_at": "2024-01-18T09:35:00Z",
"purchase_order_id": "po_123456789",
"supplier_id": "sup_abc123",
"warehouse_id": "wh_001",
"shipment_date": "2024-01-15T14:00:00Z",
"expected_arrival_date": "2024-01-18T10:00:00Z",
"actual_arrival_date": "2024-01-18T09:30:00Z",
"tracking_info": {
"carrier": "UPS",
"tracking_number": "1Z999AA10123456784",
"service_type": "Ground",
"tracking_url": "https://www.ups.com/track?tracknum=1Z999AA10123456784",
"current_status": "Delivered",
"last_update": "2024-01-18T09:30:00Z"
},
"items": [
{
"id": "asn_item_123",
"sku": "WBH-001",
"product_name": "Wireless Bluetooth Headphones",
"quantity_shipped": 500,
"quantity_ordered": 500,
"quantity_received": 0,
"unit_cost": {
"amount": 7500,
"currency": "USD"
},
"lot_number": "LOT-2024-001",
"status": "pending_receipt"
},
{
"id": "asn_item_124",
"sku": "USB-C-001",
"product_name": "USB-C Charging Cable",
"quantity_shipped": 1000,
"quantity_ordered": 1000,
"quantity_received": 0,
"unit_cost": {
"amount": 450,
"currency": "USD"
},
"lot_number": "LOT-2024-002",
"status": "pending_receipt"
}
],
"packaging_details": {
"total_packages": 10,
"total_pallets": 2,
"total_weight": {
"value": 250,
"unit": "lb"
}
},
"shipping_documents": [
{
"type": "packing_list",
"document_number": "PL-2024-00001",
"url": "https://documents.stateset.com/packing-lists/PL-2024-00001.pdf"
},
{
"type": "proof_of_delivery",
"document_number": "POD-2024-00001",
"url": "https://documents.stateset.com/pod/POD-2024-00001.pdf"
}
],
"notes": "Please schedule receiving appointment. Fragile electronics.",
"metadata": {}
}
⌘I