Create ASN - StateSet API Docs

curl --location --request POST 'https://api.stateset.com/v1/asns' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--data-raw '{
    "purchase_order_id": "po_123456789",
    "supplier_id": "sup_abc123",
    "shipment_date": "2024-01-15T14:00:00Z",
    "expected_arrival_date": "2024-01-18T10:00:00Z",
    "warehouse_id": "wh_001",
    "tracking_info": {
        "carrier": "UPS",
        "tracking_number": "1Z999AA10123456784",
        "service_type": "Ground"
    },
    "items": [
        {
            "sku": "WBH-001",
            "quantity_shipped": 500,
            "quantity_ordered": 500,
            "unit_cost": {
                "amount": 7500,
                "currency": "USD"
            },
            "lot_number": "LOT-2024-001"
        },
        {
            "sku": "USB-C-001",
            "quantity_shipped": 1000,
            "quantity_ordered": 1000,
            "unit_cost": {
                "amount": 450,
                "currency": "USD"
            },
            "lot_number": "LOT-2024-002"
        }
    ],
    "packaging_details": {
        "total_packages": 10,
        "total_pallets": 2,
        "total_weight": {
            "value": 250,
            "unit": "lb"
        }
    },
    "notes": "Please schedule receiving appointment. Fragile electronics."
}'

{
  "id": "asn_0901f083-aa1c-43c5-af5c-0a9d2fc64e30",
  "object": "asn",
  "asn_number": "ASN-2024-00001",
  "status": "pending",
  "created_at": "2024-01-15T14:30:00Z",
  "updated_at": "2024-01-15T14:30: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": null,
  "tracking_info": {
    "carrier": "UPS",
    "tracking_number": "1Z999AA10123456784",
    "service_type": "Ground",
    "tracking_url": "https://www.ups.com/track?tracknum=1Z999AA10123456784"
  },
  "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"
    },
    {
      "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"
    }
  ],
  "packaging_details": {
    "total_packages": 10,
    "total_pallets": 2,
    "total_weight": {
      "value": 250,
      "unit": "lb"
    }
  },
  "notes": "Please schedule receiving appointment. Fragile electronics.",
  "metadata": {}
}

POST

asns

curl --location --request POST 'https://api.stateset.com/v1/asns' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--data-raw '{
    "purchase_order_id": "po_123456789",
    "supplier_id": "sup_abc123",
    "shipment_date": "2024-01-15T14:00:00Z",
    "expected_arrival_date": "2024-01-18T10:00:00Z",
    "warehouse_id": "wh_001",
    "tracking_info": {
        "carrier": "UPS",
        "tracking_number": "1Z999AA10123456784",
        "service_type": "Ground"
    },
    "items": [
        {
            "sku": "WBH-001",
            "quantity_shipped": 500,
            "quantity_ordered": 500,
            "unit_cost": {
                "amount": 7500,
                "currency": "USD"
            },
            "lot_number": "LOT-2024-001"
        },
        {
            "sku": "USB-C-001",
            "quantity_shipped": 1000,
            "quantity_ordered": 1000,
            "unit_cost": {
                "amount": 450,
                "currency": "USD"
            },
            "lot_number": "LOT-2024-002"
        }
    ],
    "packaging_details": {
        "total_packages": 10,
        "total_pallets": 2,
        "total_weight": {
            "value": 250,
            "unit": "lb"
        }
    },
    "notes": "Please schedule receiving appointment. Fragile electronics."
}'

{
  "id": "asn_0901f083-aa1c-43c5-af5c-0a9d2fc64e30",
  "object": "asn",
  "asn_number": "ASN-2024-00001",
  "status": "pending",
  "created_at": "2024-01-15T14:30:00Z",
  "updated_at": "2024-01-15T14:30: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": null,
  "tracking_info": {
    "carrier": "UPS",
    "tracking_number": "1Z999AA10123456784",
    "service_type": "Ground",
    "tracking_url": "https://www.ups.com/track?tracknum=1Z999AA10123456784"
  },
  "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"
    },
    {
      "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"
    }
  ],
  "packaging_details": {
    "total_packages": 10,
    "total_pallets": 2,
    "total_weight": {
      "value": 250,
      "unit": "lb"
    }
  },
  "notes": "Please schedule receiving appointment. Fragile electronics.",
  "metadata": {}
}

This endpoint creates a new ASN (Advanced Shipping Notice) to notify about incoming shipments from suppliers. ASNs help warehouses prepare for receiving inventory and automate the receiving process.

Authentication

This endpoint requires a valid API key with asns:write permissions.

Authorization: Bearer YOUR_API_KEY

Request Body

purchase_order_id

string

required

The purchase order ID this ASN is associated with

supplier_id

string

required

The supplier ID sending the shipment

shipment_date

string

required

Date when the shipment was sent (ISO 8601)

expected_arrival_date

string

required

Expected delivery date at warehouse (ISO 8601)

warehouse_id

string

required

Destination warehouse ID

tracking_info

object

required

Shipping and tracking information

Show Tracking info properties

carrier

string

required

Carrier name (e.g., “UPS”, “FedEx”, “DHL”)

tracking_number

string

required

Primary tracking number

service_type

string

Service level (e.g., “Ground”, “Express”, “2-Day”)

additional_tracking_numbers

array

Additional tracking numbers for multi-package shipments

items

array

required

Array of items being shipped

Show Item object properties

sku

string

required

Product SKU

quantity_shipped

integer

required

Quantity being shipped

quantity_ordered

integer

Original quantity ordered (for reference)

unit_cost

object

Cost per unit

Show Cost properties

amount

integer

Cost in cents

currency

string

ISO 4217 currency code

lot_number

string

Lot or batch number for tracking

expiration_date

string

Expiration date for perishable items (ISO 8601)

serial_numbers

array

Array of serial numbers for serialized items

packaging_details

object

Packaging and palletization information

Show Packaging properties

total_packages

integer

Total number of packages/boxes

total_pallets

integer

Total number of pallets

total_weight

object

Total shipment weight

Show Weight properties

value

number

Weight value

unit

string

Weight unit (e.g., “lb”, “kg”)

packages

array

Detailed package information

Show Package properties

package_id

string

Unique package identifier

type

string

Package type (e.g., “box”, “pallet”, “crate”)

dimensions

object

Package dimensions

weight

object

Package weight

items

array

Items contained in this package

shipping_documents

array

Response

string

Unique ASN identifier

object

string

Always “asn”

asn_number

string

System-generated ASN number

status

string

ASN status: “pending”, “in_transit”, “delivered”, “received”, “cancelled”

created_at

string

ISO 8601 timestamp of creation

updated_at

string

ISO 8601 timestamp of last update

curl --location --request POST 'https://api.stateset.com/v1/asns' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--data-raw '{
    "purchase_order_id": "po_123456789",
    "supplier_id": "sup_abc123",
    "shipment_date": "2024-01-15T14:00:00Z",
    "expected_arrival_date": "2024-01-18T10:00:00Z",
    "warehouse_id": "wh_001",
    "tracking_info": {
        "carrier": "UPS",
        "tracking_number": "1Z999AA10123456784",
        "service_type": "Ground"
    },
    "items": [
        {
            "sku": "WBH-001",
            "quantity_shipped": 500,
            "quantity_ordered": 500,
            "unit_cost": {
                "amount": 7500,
                "currency": "USD"
            },
            "lot_number": "LOT-2024-001"
        },
        {
            "sku": "USB-C-001",
            "quantity_shipped": 1000,
            "quantity_ordered": 1000,
            "unit_cost": {
                "amount": 450,
                "currency": "USD"
            },
            "lot_number": "LOT-2024-002"
        }
    ],
    "packaging_details": {
        "total_packages": 10,
        "total_pallets": 2,
        "total_weight": {
            "value": 250,
            "unit": "lb"
        }
    },
    "notes": "Please schedule receiving appointment. Fragile electronics."
}'

{
  "id": "asn_0901f083-aa1c-43c5-af5c-0a9d2fc64e30",
  "object": "asn",
  "asn_number": "ASN-2024-00001",
  "status": "pending",
  "created_at": "2024-01-15T14:30:00Z",
  "updated_at": "2024-01-15T14:30: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": null,
  "tracking_info": {
    "carrier": "UPS",
    "tracking_number": "1Z999AA10123456784",
    "service_type": "Ground",
    "tracking_url": "https://www.ups.com/track?tracknum=1Z999AA10123456784"
  },
  "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"
    },
    {
      "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"
    }
  ],
  "packaging_details": {
    "total_packages": 10,
    "total_pallets": 2,
    "total_weight": {
      "value": 250,
      "unit": "lb"
    }
  },
  "notes": "Please schedule receiving appointment. Fragile electronics.",
  "metadata": {}
}

Get ASN

Update ASN

StateSet One

​Authentication

​Request Body

​Response

Authentication

Request Body

Response