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": {}
}
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

id
string
required
The unique identifier of the ASN to update

Request Body

expected_arrival_date
string
Updated expected delivery date (ISO 8601)
actual_arrival_date
string
Actual delivery date when shipment arrives (ISO 8601)
status
string
Updated status: “pending”, “in_transit”, “delivered”, “received”, “partially_received”, “cancelled”
tracking_info
object
Updated tracking information
packaging_details
object
Updated packaging information
shipping_documents
array
Updated or additional shipping documents
notes
string
Updated notes or instructions
metadata
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"
        }
    ]
}'
{
  "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": {}
}