Get one line

get

/fscmRestApi/resources/11.13.18.05/linesToInspect/{ParentTransactionId}

Request

Path Parameters
Query Parameters
  • This parameter specifies dependencies which are fields that are set before and rolled back after generating the response. Generally they are used to preview the effects of an attribute change. The fields specified in this parameter are always set in the resource instance in question. When a child resource collection is requested and the parameter is set, the fields will be set in the parent resource instance before generating the resource collection payload. The value of this query parameter is a set of dependency fields. Example: dependency=ProductId=2

    Format: <attr1>=<val1>,<attr2>=<value2>
  • When this parameter is provided, the specified children are included in the resource payload (instead of just a link). The value of this query parameter is "all" or "". More than one child can be specified using comma as a separator. Example: ?expand=Employees,Localizations. Nested children can also be provided following the format "Child.NestedChild" (Example: ?expand=Employees.Managers). If a nested child is provided (Example: Employees.Managers), the missing children will be processed implicitly. For example, "?expand=Employees.Managers" is the same as "?expand=Employees,Employees.Managers" (which will expand Employees and Managers).
  • This parameter filters the resource fields. Only the specified fields are returned, which means that if no fields are specified, no fields are returned (useful to get only the links). If an indirect child resource is provided (Example: Employees.Managers), the missing children will be processed implicitly. For example, "?fields=Employees.Managers:Empname" is the same as "?fields=;Employees:;Employees.Managers:Empname" (which will only return the "Empname" field for Managers). the value of this query parameter is a list of resource fields. The attribute can be a direct (Example: Employees) or indirect (Example: Employees.Managers) child. It cannot be combined with expand query parameter. If both are provided, only fields will be considered.

    Format: ?fields=Attribute1,Attribute2

    Format for fields in child resource: ?fields=Accessor1:Attribute1,Attribute2
  • This parameter can be used to show only certain links while accessing a singular resource or a resource collection. The parameter value format is a comma-separated list of : <link_relation>

    Example:
    self,canonical
  • The resource item payload will be filtered in order to contain only data (no links section, for example).
Header Parameters
  • If the REST API supports runtime customizations, the shape of the service may change during runtime. The REST client may isolate itself from these changes or choose to interact with the latest version of the API by specifying this header. For example: Metadata-Context:sandbox="TrackEmployeeFeature".
  • The protocol version between a REST client and service. If the client does not specify this header in the request the server will pick a default version for the API.

There's no request body for this operation.

Back to Top

Response

Supported Media Types

Default Response

The following table describes the default response for this task.
Headers
  • If the REST API supports runtime customizations, the shape of the service may change during runtime. The REST client may isolate itself from these changes or choose to interact with the latest version of the API by specifying this header. For example: Metadata-Context:sandbox="TrackEmployeeFeature".
  • The protocol version between a REST client and service. If the client does not specify this header in the request the server will pick a default version for the API.
Body ()
Root Schema : linesToInspect-item-response
Type: object
Show Source
  • Read Only: true
    Line number of the advanced shipment notice.
  • Read Only: true
    Maximum Length: 30
    Number that identifies the advanced shipment notice for the shipment from the supplier.
  • Read Only: true
    Maximum Length: 25
    Abbreviation that identifies the document type that specifies how to use this transaction. This attribute contains one of the following values. ASN: create an advance shipment notice; ASBN: create an advance shipment billing notice; STD: create a receipt.
  • Read Only: true
    Quantity that is available to inspect the parent transaction.
  • Read Only: true
    Maximum Length: 1
    Contains Y or N. Y: use back-to-back shipping. N: reference a transfer order. Note that the order line for the supply source for the reservation references this purchase order. The default value is N.
  • Read Only: true
    Value that uniquely identifies the category name.
  • Read Only: true
    Maximum Length: 250
    Name of the category that classifies the item. A category groups items that possess similar characteristics, such as plastics, paints, inks, foods, and so on.
  • Read Only: true
    Maximum Length: 4000
    Comments provided with the receiving transaction.
  • Read Only: true
    Maximum Length: 1
    Contains Y, N, or empty. Y: the item is consigned. N: the item is not consigned. The default value is N.
  • Read Only: true
    Maximum Length: 15
    Abbreviation that identifies the currency, such as USD.
  • Read Only: true
    Date to use when determining the rates that your deployment uses when calculating the currency conversion.
  • Read Only: true
    Rate to use when calculating the currency conversion.
  • Read Only: true
    Maximum Length: 30
    Currency conversion type.
  • Read Only: true
    Value that uniquely identifies the customer.
  • Read Only: true
    Maximum Length: 360
    Name of the party who purchases the item, typically for a fee.
  • Read Only: true
    Maximum Length: 80
    Destination type for the item on the transaction line. This attribute determines the accounting behavior of the transaction line. The RCV_DESTINATION_TYPE lookup defines the values that you can use with this attribute.
  • Read Only: true
    Maximum Length: 25
    Abbreviation that identifies the destination type for the item on the transaction line. This attribute determines the accounting behavior of the transaction line. The RCV_DESTINATION_TYPE lookup defines the values that you can use with this attribute.
  • Read Only: true
    Maximum Length: 30
    Line number for the document.
  • Read Only: true
    Maximum Length: 80
    Document number that identifies one of the following: the purchase order number for a purchase order, advance shipment notice, or advance shipment billing notice; the number for the return material authorization for the source document code of type RMA; the in-transit shipment number for the source document code of type INVENTORY; or the transfer order number for the source document code of type TRANSFER ORDER.
  • Read Only: true
    Maximum Length: 80
    Schedule number for the document.
  • Read Only: true
    Maximum Length: 80
    Document type according to the originating source, such as purchase order or return material authorization. The RCV_SOURCE_DOCUMENT_TYPE lookup defines the values that you can use with this attribute.
  • Read Only: true
    Value that uniquely identifies the employee.
  • Read Only: true
    Maximum Length: 2000
    Name of the person who performed the transaction.
  • Read Only: true
    Maximum Length: 18
    Abbreviation that identifies the name of the organization that is the point of origin of the shipment. This value is empty for purchase orders and advanced shipment notices.
  • Read Only: true
    Value that uniquely identifies the organization that is the point of origin of the shipment. This value is empty for purchase orders and advance shipment notices.
  • Read Only: true
    Maximum Length: 240
    Name of the source organization.
  • Read Only: true
    Maximum Length: 80
    Inspection status of the item. The RCV_INSPECTION_STATUS lookup defines the values that you can use with this attribute.
  • Read Only: true
    Maximum Length: 25
    Abbreviation that identifies the inspection status of the item. The RCV_INSPECTION_STATUS lookup defines the values that you can use with this attribute.
  • Read Only: true
    Maximum Length: 240
    Description of the item.
  • Read Only: true
    Value that uniquely identifies the item.
  • Read Only: true
    Maximum Length: 300
    Number that identifies the item to receive. This item is any part, material, product, or service that contains unique attributes when compared to other items.
  • Read Only: true
    Maximum Length: 18
    Revision of the item.
  • Read Only: true
    Maximum Length: 80
    Current status of the received line, such as received, delivered, or inspected. The RCV_LINE_STATUS lookup defines the values that you can use with this attribute.
  • Links
  • Read Only: true
    Maximum Length: 60
    Physical location of the warehouse that receives the item.
  • Read Only: true
    Value that uniquely identifies the receiving location.
  • Read Only: true
    Maximum Length: 4000
    Name of the locator where the item currently resides.
  • Read Only: true
    Value that uniquely identifies the locator.
  • Manufacturer Parts
    Title: Manufacturer Parts
    The Manufacturer Parts resource manages the manufacturer parts associated with a receipt line.
  • Read Only: true
    Value that uniquely identifies the parent transaction.
  • Read Only: true
    Maximum Length: 25
    Transaction type of the parent transaction.
  • Read Only: true
    Value that uniquely identifies the purchase order header.
  • Read Only: true
    Value that uniquely identifies the purchase order line.
  • Read Only: true
    Value that uniquely identifies the purchase order schedule.
  • Read Only: true
    Value that identifies the revision of the purchase order.
  • Read Only: true
    Maximum Length: 3
    Abbreviation that identifies the primary unit of measure that the item uses.
  • Read Only: true
    Maximum Length: 30
    Rationale for classifying the transaction.
  • Read Only: true
    Value that uniquely identifies the transaction reason.
  • Read Only: true
    Value that uniquely identifies the receipt advice header.
  • Read Only: true
    Value that uniquely identifies the receipt advice line.
  • Read Only: true
    Maximum Length: 1
    Contains Y, N, or empty. Y: the transaction contains an exception. N or empty: no exceptions.
  • Read Only: true
    Maximum Length: 30
    Number that identifies receipt of the shipment in the warehouse.
  • Read Only: true
    Maximum Length: 25
    Abbreviation that identifies the source type of the shipment.
  • Read Only: true
    Maximum Length: 80
    Routing name for the type of transaction entry that determines the steps that receive the item. The RCV_ROUTING_HEADERS lookup defines the values that you can use with this attribute.
  • Read Only: true
    Value that uniquely identifies the routing header.
  • Read Only: true
    Quantity that is available to inspect in the secondary unit of measure.
  • Read Only: true
    Maximum Length: 25
    Unit of measure for the quantity that the receipt transaction contains.
  • Read Only: true
    Maximum Length: 3
    Abbreviation that identifies the secondary unit of measure for the quantity that the receipt transaction contains.
  • Read Only: true
    Value that uniquely identifies the shipment header.
  • Read Only: true
    Value that uniquely identifies the shipment line.
  • Read Only: true
    Maximum Length: 25
    Document type of the shipment. You can use one of the following values for this attribute: PO, RMA, TRANSFER ORDER, or INVENTORY.
  • Read Only: true
    Maximum Length: 10
    Name of the subinventory where the item currently resides.
  • Read Only: true
    Maximum Length: 18
    Abbreviation that identifies the name of the ship-to organization of the received line.
  • Read Only: true
    Value that uniquely identifies the ship-to organization of the received line.
  • Read Only: true
    Maximum Length: 30
    Number that identifies the transfer order shipment.
  • Read Only: true
    Date when the transaction finished.
  • Read Only: true
    Value that uniquely identifies the transfer order distribution.
  • Read Only: true
    Value that uniquely identifies the transfer order header. Each transfer order can request to move an item from one location to another location.
  • Read Only: true
    Value that uniquely identifies the transfer order line.
  • Read Only: true
    Maximum Length: 25
    Unit of measure that the received transaction uses.
  • Read Only: true
    Maximum Length: 3
    Abbreviation that identifies the unit of measure that the received transaction uses.
  • Read Only: true
    Value that uniquely identifies the supplier.
  • Read Only: true
    Maximum Length: 300
    Number that the supplier uses to identify the item.
  • Read Only: true
    Maximum Length: 360
    Name of the company that provides a product in return for an item that might or might not require payment.
  • Read Only: true
    Maximum Length: 240
    Abbreviation that identifies the name of the buying organization that conducts business with the supplier.
  • Read Only: true
    Value that uniquely identifies the supplier site.
Nested Schema : Manufacturer Parts
Type: array
Title: Manufacturer Parts
The Manufacturer Parts resource manages the manufacturer parts associated with a receipt line.
Show Source
Nested Schema : linesToInspect-manufacturerParts-item-response
Type: object
Show Source
Back to Top

Examples

This example describes how to get one line to inspect.

Example cURL Command

Use the following cURL command to submit a request on the REST resource:

curl -u username:password "https://servername/fscmRestApi/resources/version/linesToInspect?q=ParentTransactionId=value"

For example, the following command gets one line to inspect for transaction 3215474:

curl -u username:password "https://servername/fscmRestApi/resources/version/linesToInspect?q=ParentTransactionId=3215474"

Example Response Body

The following example includes the contents of the response body in JSON format:

{
"items": [
  {
"ToOrganizationCode": "M1",
"ToOrganizationId": 207,
"FromOrganizationName": null,
"FromOrganizationCode": null,
"FromOrganizationId": null,
"ItemNumber": "RCV-100",
"ItemDescription": "Plain Item",
"ItemId": 663907,
"ItemRevision": null,
"ReceiptNumber": "33869",
"LineStatus": "Received",
"DocumentType": "Purchase order",
"SourceDocumentCode": "PO",
"DocumentNumber": "1004137",
"DocumentLineNumber": "1",
"DocumentScheduleNumber": "1",
"TransactionDate": "2017-03-13",
"VendorName": "First Network Devices",
"VendorId": 21,
"VendorSiteCode": "FRESNO",
"VendorSiteId": 1969,
"VendorItemNumber": null,
"TOShipmentNumber": null,
"ASNType": "STD",
"ASNNumber": null,
"ASNLineNumber": null,
"CustomerPartyName": null,
"CustomerId": null,
"AvailableQuantity": 1,
"UOMCode": "Ea",
"UnitOfMeasure": "Each",
"SecondaryAvailableQuantity": null,
"SecondaryUOMCode": null,
"SecondaryUnitOfMeasure": null,
"DestinationType": "Receiving",
"DestinationTypeCode": "RECEIVING",
"Location": "M1- Seattle Mfg",
"LocationId": 207,
"Routing": "Inspection required",
"RoutingHeaderId": 2,
"POHeaderId": 300100139063422,
"POLineLocationId": 300100139063425,
"POLineId": 300100139063424,
"PORevisionNumber": 0,
"ShipmentHeaderId": 2985477,
"ShipmentLineId": 3062386,
"TransferOrderHeaderId": null,
"TransferOrderLineId": null,
"TransferOrderDistId": null,
"ReceiptAdviceHeaderId": null,
"ReceiptAdviceLineId": null,
"ReceiptSourceCode": "VENDOR",
"ConsignedItems": "N",
"BackToBack": "N",
"CategoryName": "Miscellaneous_1",
"CategoryId": 1,
"CurrencyCode": "USD",
"CurrencyConversionRate": null,
"CurrencyConversionDate": null,
"CurrencyConversionType": null,
"ParentTransactionType": "RECEIVE",
"ParentTransactionId": 3215474,
"InspectionStatus": "Not inspected",
"InspectionStatusCode": "NOT INSPECTED",
"PrimaryUOMCode": "Ea",
"Reason": null,
"ReasonId": null,
"ReceiptException": null,
"EmployeeName": "Brent, Marsha",
"EmployeeId": 300100036640797,
"Comments": null,
"Subinventory": null,
"Locator": null,
"LocatorId": null,
}
],
"count": 1,
"hasMore": false,
"limit": 25,
"offset": 0,
"links": [
  {
"rel": "self",
"href": "https://servername/logisticsApi/resources/version/linesToInspect",
"name": "linesToInspect",
"kind": "collection"
}
],
}
Back to Top