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
}'
mutation ReceiveASN($id: ID!, $input: ReceiveASNInput!) {
receiveASN(id: $id, input: $input) {
id
status
receiving_summary {
total_items_expected
total_items_received
discrepancy_count
receipt_completed
}
inventory_updates {
sku
quantity_added
new_total
location
}
discrepancy_report {
has_discrepancies
total_discrepancies
discrepancies {
type
description
impact
}
}
}
}
const receipt = await stateset.asns.receive(
'asn_0901f083-aa1c-43c5-af5c-0a9d2fc64e30',
{
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'
},
complete_receipt: true
}
);
receipt = stateset.asns.receive(
'asn_0901f083-aa1c-43c5-af5c-0a9d2fc64e30',
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'
},
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
}'
mutation ReceiveASN($id: ID!, $input: ReceiveASNInput!) {
receiveASN(id: $id, input: $input) {
id
status
receiving_summary {
total_items_expected
total_items_received
discrepancy_count
receipt_completed
}
inventory_updates {
sku
quantity_added
new_total
location
}
discrepancy_report {
has_discrepancies
total_discrepancies
discrepancies {
type
description
impact
}
}
}
}
const receipt = await stateset.asns.receive(
'asn_0901f083-aa1c-43c5-af5c-0a9d2fc64e30',
{
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'
},
complete_receipt: true
}
);
receipt = stateset.asns.receive(
'asn_0901f083-aa1c-43c5-af5c-0a9d2fc64e30',
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'
},
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"
}
]
}
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
string
required
The unique identifier of the ASN to receive
Request Body
string
required
Date and time when items were received (ISO 8601)
string
required
User ID or name of the person processing the receipt
array
required
Array of received items with quantities and conditions
Show Item object properties
Show Item object properties
string
required
ASN item ID being received
integer
required
Actual quantity received
string
Condition of received items: “new”, “damaged”, “defective”
string
Lot number for tracking (can override ASN lot number)
string
Expiration date for perishable items
array
Array of serial numbers for serialized items
string
Warehouse location where items are placed
string
Notes about any discrepancies found
object
array
string
General receiving notes
boolean
Whether this completes the ASN receipt (default: true)
Response
string
ASN ID
string
Updated ASN status
object
Summary of the receiving process
array
Details of inventory updates made
object
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
}'
mutation ReceiveASN($id: ID!, $input: ReceiveASNInput!) {
receiveASN(id: $id, input: $input) {
id
status
receiving_summary {
total_items_expected
total_items_received
discrepancy_count
receipt_completed
}
inventory_updates {
sku
quantity_added
new_total
location
}
discrepancy_report {
has_discrepancies
total_discrepancies
discrepancies {
type
description
impact
}
}
}
}
const receipt = await stateset.asns.receive(
'asn_0901f083-aa1c-43c5-af5c-0a9d2fc64e30',
{
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'
},
complete_receipt: true
}
);
receipt = stateset.asns.receive(
'asn_0901f083-aa1c-43c5-af5c-0a9d2fc64e30',
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'
},
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