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"
}
]
}'
mutation UpdateASN($id: ID!, $input: UpdateASNInput!) {
updateASN(id: $id, input: $input) {
id
asn_number
status
actual_arrival_date
tracking_info {
current_status
last_update
}
shipping_documents {
type
document_number
url
}
}
}
const asn = await stateset.asns.update(
'asn_0901f083-aa1c-43c5-af5c-0a9d2fc64e30',
{
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'
}
]
}
);
asn = stateset.asns.update(
'asn_0901f083-aa1c-43c5-af5c-0a9d2fc64e30',
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"
}
]
}'
mutation UpdateASN($id: ID!, $input: UpdateASNInput!) {
updateASN(id: $id, input: $input) {
id
asn_number
status
actual_arrival_date
tracking_info {
current_status
last_update
}
shipping_documents {
type
document_number
url
}
}
}
const asn = await stateset.asns.update(
'asn_0901f083-aa1c-43c5-af5c-0a9d2fc64e30',
{
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'
}
]
}
);
asn = stateset.asns.update(
'asn_0901f083-aa1c-43c5-af5c-0a9d2fc64e30',
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": {}
}
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
string
required
The unique identifier of the ASN to update
Request Body
string
Updated expected delivery date (ISO 8601)
string
Actual delivery date when shipment arrives (ISO 8601)
string
Updated status: “pending”, “in_transit”, “delivered”, “received”, “partially_received”, “cancelled”
object
object
array
string
Updated notes or instructions
object
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"
}
]
}'
mutation UpdateASN($id: ID!, $input: UpdateASNInput!) {
updateASN(id: $id, input: $input) {
id
asn_number
status
actual_arrival_date
tracking_info {
current_status
last_update
}
shipping_documents {
type
document_number
url
}
}
}
const asn = await stateset.asns.update(
'asn_0901f083-aa1c-43c5-af5c-0a9d2fc64e30',
{
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'
}
]
}
);
asn = stateset.asns.update(
'asn_0901f083-aa1c-43c5-af5c-0a9d2fc64e30',
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