orders pickcandidates (http://api.3plcentral.com/rels/orders/pickcandidates)
Resource:
order pick information for determining whether to start picking
C# Rel Const:
Rels.OrderSvc.PickCandidates
URI template:
pickcandidates{?pgsiz,pgnum,rql,sort,loadout,picked}
Obtain URI from:
pick candidates; filters out shipped, underallocated; optionally, picked or loadable orders
rql examples:
1) the legacy way, support mobile operator entering an order id for picking:
rql=OrderId==x
where x is the desired order
2) new way, to show next available order to pick:
rql=facilityidentifier.id==f;(pickjobid=hv=false,(pickjob.pickerid=hv=false,pickjob.pickerid==u))
pgsiz=s & pgnum=p & sort=PickJob.Priority,PickJob.ReadOnly.CreationDate,OrderId
where f is a facilityid,
where u is a pickin' user id,
s is how many orders to pull down, use 1 to merely grab the next one or >1 to show a list of possible orders
p is 1 for showing the next available one, 2 if user rejected the 1st and wants to see the one after, etc.
Success status: 200
Name Data Type Description
pgsiz int must be positive; limit 100, specifying more is an error; default 10; max records to return per response; use "next" or "prev" link to paginate
pgnum int considering pgsiz, returns the pgnum-th page, 1-indexed
rql string see RQL documentation
sort string see RQL documentation
loadout bool
picked bool
Type Description
TotalResults int
ResourceList IList<Order.Models.PickCandidate>
OrderId int each candidate is one order; see pickjobs for multi-order
CustomerId int
IsClosed bool
PickDoneDate DateTime? ... Stored and displayed in warehouse time
LoadOutDoneDate DateTime? ...
FullyAllocated bool
PickJobId int? ...
FacilityIdentifier Generic.Models.FacilityIdentifier
Name string
Id int
PickJob Order.Models.PickJob null if order not yet assigned to a pick job; see pickjobs link for creating pick job more...
ReadOnly Order.Models.PickJobReadOnly
PickJobId int
CustomerIdentifier Generic.Models.CustomerIdentifier
ExternalId string
Name string
Id int
FacilityIdentifier Generic.Models.FacilityIdentifier
Name string
Id int
NOrders int # of orders in this pick job; convenience for counting OrderIdentifiers
CreatedBy Generic.Models.UserIdentifier
Name string
Id int
CreationDateUtc DateTime
LastUpdatedBy Generic.Models.UserIdentifier
Name string
Id int
LastUpdateDateUtc DateTime
AssignedDateUtc DateTime? ...
DoneDateUtc DateTime? ...
DoneIncomplete bool true if operator closed job with remaining items to pick
ReasonForIncomplete string specify reason if operator completes a job with remaining items to pick
MispickExplanations string updated automatically when mispicked
Priority int any number, uninterpreted by system, used solely for sorting by user
PickInstructions string
PickerId int? ... for use in candidate searches only; ignored for all other purposes
Picker Generic.Models.UserIdentifier
Name string
Id int
OrderIdentifiers IEnumerable<Generic.Models.OrderIdentifier> which orders are in this job
Id int
LoadOutLocation Generic.Models.LocationIdentifier Location used to stage inventory for load out
NameKey Generic.Models.LocationNameKey
FacilityIdentifier Generic.Models.FacilityIdentifier
Name string
Id int
Name string
Id int
PickList IEnumerable<Order.Models.CandidatePickItem> information for only the given order; is not consolidated across orders if order part of multi-order job more...
Qty decimal Ī£OrderItem.Qty
LocationIdentifier Generic.Models.LocationIdentifier
NameKey Generic.Models.LocationNameKey
FacilityIdentifier Generic.Models.FacilityIdentifier
Name string
Id int
Name string
Id int
LocationSort Order.Models.LocationSort
Field1 string
Field2 string
Field3 string
Field4 string
ItemTraits Generic.Models.ItemTraits unique identifying characteristics of an item in a location
ItemIdentifier Generic.Models.ItemIdentifier
Sku string
Id int
Qualifier string
LotNumber string
SerialNumber string
Cost decimal? ...
ExpirationDate DateTime? ...
PalletIdentifier Generic.Models.PalletIdentifier
NameKey Generic.Models.PalletNameKey
FacilityIdentifier Generic.Models.FacilityIdentifier
Name string
Id int
Name string
Id int
UnitIdentifier Generic.Models.UnitOfMeasureIdentifier for convenience, referenced item's primary inventory unit
Name string
Id int
SecondaryUnitIdentifier Generic.Models.UnitOfMeasureIdentifier for convenience, referenced item's secondary inventory unit if defined
Name string
Id int
SecondaryQty decimal? ...
IsOrderQtySecondary bool
PickPath int? ...
CustomerName string
CustomerDeactivated bool
Sample accept: application/hal+json
{
  "totalResults": 1,
  "_embedded": {
    "item": [
      {
        "orderId": 1,
        "customerId": 2,
        "isClosed": true,
        "pickDoneDate": "2016-12-25T23:00:00",
        "loadOutDoneDate": "2016-12-25T23:00:00",
        "fullyAllocated": true,
        "pickJobId": 1,
        "facilityIdentifier": {
          "name": "str",
          "id": 2
        },
        "pickList": [
          {
            "qty": 1.0,
            "locationIdentifier": {
              "nameKey": {
                "facilityIdentifier": {
                  "name": "str",
                  "id": 2
                },
                "name": "str"
              },
              "id": 1
            },
            "locationSort": {
              "field1": "str",
              "field2": "str",
              "field3": "str",
              "field4": "str"
            },
            "itemTraits": {
              "itemIdentifier": {
                "sku": "str",
                "id": 2
              },
              "qualifier": "str",
              "lotNumber": "str",
              "serialNumber": "str",
              "cost": 1.0,
              "expirationDate": "2016-12-25T23:00:00",
              "palletIdentifier": {
                "nameKey": {
                  "facilityIdentifier": {
                    "name": "str",
                    "id": 2
                  },
                  "name": "str"
                },
                "id": 1
              }
            },
            "unitIdentifier": {
              "name": "str",
              "id": 2
            },
            "secondaryUnitIdentifier": {
              "name": "str",
              "id": 2
            },
            "secondaryQty": 1.0,
            "isOrderQtySecondary": true,
            "pickPath": 1
          }
        ],
        "customerName": "str",
        "customerDeactivated": true,
        "_embedded": {
          "http://api.3plCentral.com/rels/orders/pickjob": {
            "readOnly": {
              "pickJobId": 1,
              "customerIdentifier": {
                "externalId": "str",
                "name": "str",
                "id": 3
              },
              "facilityIdentifier": {
                "name": "str",
                "id": 2
              },
              "nOrders": 2,
              "createdBy": {
                "name": "str",
                "id": 2
              },
              "creationDateUtc": "2016-12-25T23:00:00",
              "lastUpdatedBy": {
                "name": "str",
                "id": 2
              },
              "lastUpdateDateUtc": "2016-12-25T23:00:00",
              "assignedDateUtc": "2016-12-25T23:00:00",
              "doneDateUtc": "2016-12-25T23:00:00",
              "doneIncomplete": true,
              "reasonForIncomplete": "str",
              "mispickExplanations": "str"
            },
            "priority": 1,
            "pickInstructions": "str",
            "pickerId": 1,
            "picker": {
              "name": "str",
              "id": 2
            },
            "orderIdentifiers": [
              {
                "id": 1
              }
            ],
            "loadOutLocation": {
              "nameKey": {
                "facilityIdentifier": {
                  "name": "str",
                  "id": 2
                },
                "name": "str"
              },
              "id": 1
            }
          }
        }
      }
    ]
  }
}

This documentation is subject to change, and is updated often and without warning. The models documented may or may not be available to users now or in the future. Use this documentation at your own risk.
Contact api@3plcentral.com with any questions about this documentation.