Skip to main content

Send Warehouse Transfer ASN

POST 

/api/warehouses/transfers/:warehouseTransfer/asn

Send an Advanced Shipment Notice (ASN) for this warehouse transfer to its destination third-party logistics (3PL) warehouse. The destination warehouse must be of type 3PL.

Required scope: warehouses:write

Grant this scope to your token under Settings → Developer → Personal Access Tokens.

How it is sent depends on the destination warehouse:

  • Warehouse system — when the destination warehouse is mapped to a Trackstar warehouse-system connection that can create inbound shipments, the ASN is created directly in that warehouse system as an inbound shipment (using the connection's configured receipt type). This happens once per warehouse transfer: a second request returns 422, because the warehouse system cannot change the lines of a shipment it has already created — make any further changes in the warehouse system. The destination warehouse needs no email address in this case.
  • Email — otherwise the ASN is emailed as a spreadsheet to the email address on the destination warehouse's address record, and can be resent.

Warehouse transfer responses include to_warehouse.asn_warehouse_system — the name of the warehouse-system connection the ASN will be created in, or null when it will be emailed.

Response: data.channel (email or warehouse_system), data.message (also returned as the top-level message) and data.external_reference (the inbound shipment ID in the warehouse system; null for email, or when the warehouse system did not return an ID).

Returns 422 when the destination warehouse is not a 3PL; when it has no email address and no connected warehouse system; when the order has no product lines; when the ASN was already sent to the warehouse system; or when the warehouse system refuses it (for example a product without a SKU, a fractional quantity, a receipt type the warehouse system does not accept, or a field it requires that SKU.io cannot fill) — the message says which.

Requires permission: warehouse_transfers.update

Authentication: Requires Bearer token.

When the ASN is emailed, its email template must be turned on; otherwise the request is refused with 422 and nothing is marked as sent. A transfer out of an Amazon FBA warehouse uses the ASN (FBA) template.

When the destination warehouse is on a ShipHero connection with asn.send_transfers turned on, the transfer is created as a ShipHero purchase order instead: the transfer number is the PO number, the vendor is the source warehouse (or asn.transfer_vendor_name), and prices are always 0.00. A transfer out of an Amazon FBA warehouse (a removal) uses asn.removal_po_number_template, starts the PO note with asn.removal_note_prefix, and carries each line's FNSKU and condition in the line note. The response then has data.channel = warehouse_system; a product ShipHero doesn't have holds the transfer with 422 (held_reason, missing_skus).

Request​

Responses​

OK

Response Headers
    Content-Type