Receive

The Receive ApI is mainly used in our WMS Cloud Mobile app, but it allows you to receive LPNs. Currently, it does not support Attributes, batch, expiry, but it is planned for a future release.

API Signature

POST .../entity/iblpn/receive

The following is an example body for receive API.

{        "facility_id_code": "FAC",
        "company_id__code": "COMP",
        "shipment_nbr": "SHIPMTNBR",
        "container_nbr": "CNTRNBR",
        "recv_dock_nbr_or_location_barcode": "DOCK_NBR_OR_BARCODE",
        "trailer_nbr": "TRLRNBR",
        "lpn_type": "LPT",
        "pallet_nbr": "PLTNBR",
        "item_list": [{                
              "item_barcode": "ITEM1234",  
              "qty": 10,
              "case_qty": 5,    
              "pack_qty": 5 
          }]
  }

Request Parameters

Name Required Type Default Description
facility_id Integer Facility context by id.
facility_id__code String Facility context by code.
company_id Integer Company context by id.
company_id__code String Company context by code.
container_nbr X String IB container number
shipment_nbr C String IB shipment number
po_nbr C String Purchase order number
recv_dock_nbr_or_location_barcode String The dock number or dock location barcode at which the LPN is being received.
pallet_nbr String Pallet number
trailer_nbr String Trailer number
lpn_type String LPN type Code
item_list List Sku list

Item List

Name Required Type Default Description
item_barcode X String Item Barcode
qty X Integer Quantity
case_qty Integer Case Quantity
pack_qty Integer Pack Quantity

Cross Dock Receiving

The Receive REST API also allows Cross Docking of an LPN.

URL:

POST .../entity/iblpn/receive

Request Parameter / Options

Name Required Type Default Options
xdock_mode N String None
  • 'lpn',
  • 'lpn-and-one-sku',
  • 'lpn-one-and-multi-facility',
  • 'lpn-one-and-multi'
  • lpn-and-one-sku : It will first check the receiving LPN with orders that have arequired lpn number. If doesnt match, it will try to do single sku xdock (as long as it is single sku lpn).
  • lpn : It will first check the receiving LPN with orders that required lpn number.
  • lpn-one-and-multi-facility: It will first try to match LPN with an order. If it doesnt match, then will try to cross dock single sku. If it is a multi sku, it will try to xdock facility ( but it has to be a facility order).
  • lpn-one-and-multi: It will first try to match LPN with an order. If it doesnt match, then will try to cross dock single sku. If it is a multi sku, it will try to xdock.

Additional Notes

As of now we support only receiving of normal items. Support for attribute, batch, expiry and serial tracking items will be added later.

Note: If the shipment is cartonized, the REST API will only pass the LPN information, and it will not pass the item list information.
  • We do not support LPN as a Physical Pallet.
  • We do not support detail receiving for cartonized LPNs.
  • We do not support handling over-receipt warning message.
  • QC flow is not supported.
    Note: If you are sending a case or pack quantity, it must be a multiple of standard case or standard pack quantity.

Receive UOM

With the receive API, you can also receive inbound shipments with receiving UOM.

Receiving UOM Sample Body

{ "facility_id_code": "QATST01",
 "company_id_code": "QATSTPC",
 "shipment_nbr": "APIBS25012302",
 "container_nbr": "APCNTR27012301",
 "recv_dock_nbr_or_location_barcode": "BH-DK-01-01",
 "trailer_nbr": "APTRL2701",
 "lpn_type": "PEP-BEV",
 "pallet_nbr": "APPLT-27012301",
 "item_list": [{ 
 "item_barcode": "AP004", 
 "qty": 10,
 "receiving_uom": "LB"
 }]
 }