curl --location --request POST 'https://api.stateset.com/v1/asns/asn_0901f083-aa1c-43c5-af5c-0a9d2fc64e30/receive' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--data-raw '{
"received_date": "2024-01-18T11:00:00Z",
"received_by": "john.doe@warehouse.com",
"items": [
{
"item_id": "asn_item_123",
"quantity_received": 498,
"condition": "new",
"lot_number": "LOT-2024-001",
"location": "A-12-3",
"discrepancy_notes": "2 units damaged in transit"
},
{
"item_id": "asn_item_124",
"quantity_received": 1000,
"condition": "new",
"lot_number": "LOT-2024-002",
"location": "B-5-1"
}
],
"quality_check": {
"performed": true,
"passed": true,
"notes": "All items meet quality standards"
},
"discrepancies": [
{
"type": "damage",
"description": "2 units of WBH-001 damaged in transit",
"resolution": "Filed claim with carrier"
}
],
"notes": "Shipment received in good condition except for noted damages",
"complete_receipt": true
}'
{
"id": "asn_0901f083-aa1c-43c5-af5c-0a9d2fc64e30",
"asn_number": "ASN-2024-00001",
"status": "received",
"receiving_summary": {
"total_items_expected": 1500,
"total_items_received": 1498,
"discrepancy_count": 1,
"receipt_completed": true,
"received_date": "2024-01-18T11:00:00Z",
"received_by": "john.doe@warehouse.com"
},
"inventory_updates": [
{
"sku": "WBH-001",
"product_name": "Wireless Bluetooth Headphones",
"quantity_added": 498,
"previous_quantity": 145,
"new_total": 643,
"location": "A-12-3",
"lot_number": "LOT-2024-001"
},
{
"sku": "USB-C-001",
"product_name": "USB-C Charging Cable",
"quantity_added": 1000,
"previous_quantity": 487,
"new_total": 1487,
"location": "B-5-1",
"lot_number": "LOT-2024-002"
}
],
"discrepancy_report": {
"has_discrepancies": true,
"total_discrepancies": 1,
"discrepancies": [
{
"type": "damage",
"description": "2 units of WBH-001 damaged in transit",
"expected_quantity": 500,
"received_quantity": 498,
"impact": "inventory_shortage",
"resolution": "Filed claim with carrier"
}
]
},
"purchase_order_update": {
"po_id": "po_123456789",
"items_received": 1498,
"items_outstanding": 2,
"po_status": "partially_received"
},
"workflows_triggered": [
{
"type": "putaway",
"status": "initiated",
"assigned_to": "warehouse_team"
},
{
"type": "carrier_claim",
"status": "initiated",
"reference": "CLAIM-2024-00123"
}
]
}
Receive ASN
Process the receiving of items from an ASN and update inventory
POST
/
v1
/
asns
/
:id
/
receive
curl --location --request POST 'https://api.stateset.com/v1/asns/asn_0901f083-aa1c-43c5-af5c-0a9d2fc64e30/receive' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--data-raw '{
"received_date": "2024-01-18T11:00:00Z",
"received_by": "john.doe@warehouse.com",
"items": [
{
"item_id": "asn_item_123",
"quantity_received": 498,
"condition": "new",
"lot_number": "LOT-2024-001",
"location": "A-12-3",
"discrepancy_notes": "2 units damaged in transit"
},
{
"item_id": "asn_item_124",
"quantity_received": 1000,
"condition": "new",
"lot_number": "LOT-2024-002",
"location": "B-5-1"
}
],
"quality_check": {
"performed": true,
"passed": true,
"notes": "All items meet quality standards"
},
"discrepancies": [
{
"type": "damage",
"description": "2 units of WBH-001 damaged in transit",
"resolution": "Filed claim with carrier"
}
],
"notes": "Shipment received in good condition except for noted damages",
"complete_receipt": true
}'
{
"id": "asn_0901f083-aa1c-43c5-af5c-0a9d2fc64e30",
"asn_number": "ASN-2024-00001",
"status": "received",
"receiving_summary": {
"total_items_expected": 1500,
"total_items_received": 1498,
"discrepancy_count": 1,
"receipt_completed": true,
"received_date": "2024-01-18T11:00:00Z",
"received_by": "john.doe@warehouse.com"
},
"inventory_updates": [
{
"sku": "WBH-001",
"product_name": "Wireless Bluetooth Headphones",
"quantity_added": 498,
"previous_quantity": 145,
"new_total": 643,
"location": "A-12-3",
"lot_number": "LOT-2024-001"
},
{
"sku": "USB-C-001",
"product_name": "USB-C Charging Cable",
"quantity_added": 1000,
"previous_quantity": 487,
"new_total": 1487,
"location": "B-5-1",
"lot_number": "LOT-2024-002"
}
],
"discrepancy_report": {
"has_discrepancies": true,
"total_discrepancies": 1,
"discrepancies": [
{
"type": "damage",
"description": "2 units of WBH-001 damaged in transit",
"expected_quantity": 500,
"received_quantity": 498,
"impact": "inventory_shortage",
"resolution": "Filed claim with carrier"
}
]
},
"purchase_order_update": {
"po_id": "po_123456789",
"items_received": 1498,
"items_outstanding": 2,
"po_status": "partially_received"
},
"workflows_triggered": [
{
"type": "putaway",
"status": "initiated",
"assigned_to": "warehouse_team"
},
{
"type": "carrier_claim",
"status": "initiated",
"reference": "CLAIM-2024-00123"
}
]
}
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 processes the receiving of items from an ASN. It updates inventory levels, records any discrepancies, and can trigger automated workflows for putaway and quality control.
Path Parameters
The unique identifier of the ASN to receive
Request Body
Date and time when items were received (ISO 8601)
User ID or name of the person processing the receipt
Array of received items with quantities and conditions
Show Item object properties
Show Item object properties
ASN item ID being received
Actual quantity received
Condition of received items: “new”, “damaged”, “defective”
Lot number for tracking (can override ASN lot number)
Expiration date for perishable items
Array of serial numbers for serialized items
Warehouse location where items are placed
Notes about any discrepancies found
General receiving notes
Whether this completes the ASN receipt (default: true)
Response
ASN ID
Updated ASN status
Summary of the receiving process
Details of inventory updates made
Summary of any discrepancies found
curl --location --request POST 'https://api.stateset.com/v1/asns/asn_0901f083-aa1c-43c5-af5c-0a9d2fc64e30/receive' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--data-raw '{
"received_date": "2024-01-18T11:00:00Z",
"received_by": "john.doe@warehouse.com",
"items": [
{
"item_id": "asn_item_123",
"quantity_received": 498,
"condition": "new",
"lot_number": "LOT-2024-001",
"location": "A-12-3",
"discrepancy_notes": "2 units damaged in transit"
},
{
"item_id": "asn_item_124",
"quantity_received": 1000,
"condition": "new",
"lot_number": "LOT-2024-002",
"location": "B-5-1"
}
],
"quality_check": {
"performed": true,
"passed": true,
"notes": "All items meet quality standards"
},
"discrepancies": [
{
"type": "damage",
"description": "2 units of WBH-001 damaged in transit",
"resolution": "Filed claim with carrier"
}
],
"notes": "Shipment received in good condition except for noted damages",
"complete_receipt": true
}'
{
"id": "asn_0901f083-aa1c-43c5-af5c-0a9d2fc64e30",
"asn_number": "ASN-2024-00001",
"status": "received",
"receiving_summary": {
"total_items_expected": 1500,
"total_items_received": 1498,
"discrepancy_count": 1,
"receipt_completed": true,
"received_date": "2024-01-18T11:00:00Z",
"received_by": "john.doe@warehouse.com"
},
"inventory_updates": [
{
"sku": "WBH-001",
"product_name": "Wireless Bluetooth Headphones",
"quantity_added": 498,
"previous_quantity": 145,
"new_total": 643,
"location": "A-12-3",
"lot_number": "LOT-2024-001"
},
{
"sku": "USB-C-001",
"product_name": "USB-C Charging Cable",
"quantity_added": 1000,
"previous_quantity": 487,
"new_total": 1487,
"location": "B-5-1",
"lot_number": "LOT-2024-002"
}
],
"discrepancy_report": {
"has_discrepancies": true,
"total_discrepancies": 1,
"discrepancies": [
{
"type": "damage",
"description": "2 units of WBH-001 damaged in transit",
"expected_quantity": 500,
"received_quantity": 498,
"impact": "inventory_shortage",
"resolution": "Filed claim with carrier"
}
]
},
"purchase_order_update": {
"po_id": "po_123456789",
"items_received": 1498,
"items_outstanding": 2,
"po_status": "partially_received"
},
"workflows_triggered": [
{
"type": "putaway",
"status": "initiated",
"assigned_to": "warehouse_team"
},
{
"type": "carrier_claim",
"status": "initiated",
"reference": "CLAIM-2024-00123"
}
]
}
⌘I