Get one receipt transaction request

get

/fscmRestApi/resources/11.13.18.05/receivingReceiptTransactionRequests/{InterfaceTransactionId}

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 : receivingReceiptTransactionRequests-item-response
Type: object
Show Source
  • Receipt amount in the purchase order currency. This attribute is mandatory when creating receipt for a fixed price service purchase order line.
  • ASNLineDFF
  • Number that identifies the line on the advance shipment notice. Either this attribute or ShipmentLineId must be provided when receiving an advanced shipment notice (ASN).
  • Assessable value of the transaction for taxation purposes. This attribute is applicable only for return transactions. Even for returns, if blank, the default value from the parent transaction is used.
  • Attachments
    Title: Attachments
    The Attachments resource manages attachments when creating a post receipt transaction. The attachments uploaded as part of this correspond to the entity name Receiving Transactions.
  • Maximum Length: 25
    This attribute is not applicable and should be left blank.
  • Maximum Length: 35
    Label of the barcode on the product. This attribute is not currently used.
  • Maximum Length: 240
    Name of the business unit. This attribute can be blank for this resource and is derived from the parent transaction.
  • Value that uniquely identifies the business unit. This attribute can be blank for this resource and is derived from the parent transaction.
  • Maximum Length: 240
    Text that the used entered when receiving the item.
  • Maximum Length: 1
    Value that indicates whether or not the receiving transaction is for consigned material. If this attribute is blank, the value is derived from the parent transaction. Enter N if returning an owned (once consigned) material. Else, leave this attribute blank.
  • Maximum Length: 35
    Container number. This attribute is not currently used.
  • Maximum Length: 2
    Abbreviation that identifies the country of manufacture for this item. This attribute can be blank for this resource.
  • Read Only: true
    Maximum Length: 64
    User who created the interface record for the receipt line request.
  • Contains one of the following values: true or false. If true, then the supplier site of the purchase order is setup to create a debit memo and the receipt (for which return is performed) has a corresponding evaluated receipt settlement (ERS) invoice. If false, then the supplier site of the purchase order is not setup for creating debit memo. The default value is false. This attribute determines whether to create the debit memo. This attribute is applicable only when transaction type is RETURN TO VENDOR.
  • Read Only: true
    Date and time when the user created the interface record for receipt line request.
  • Maximum Length: 15
    Receipt amount in the purchase order currency. This attribute is mandatory when creating receipt for a fixed price service purchase order line.
  • Date when the currency conversion occurred for the receipt. Use this attribute only for a purchase order receipt where the option on the purchase order schedule is Receipt and the order currency is different from the ledger currency of the receiving organization.
  • Currency conversion rate for the receipt. Use this attribute only for a purchase order receipt where the option on the purchase order schedule is Receipt, the order currency is different from the ledger currency of the receiving organization, and the rate type on the purchase order is User.
  • Value that uniquely identifies the customer. This attribute can be blank and the value is derived from the parent transaction.
  • Value that the customer uses to uniquely identify the item. This attribute can be blank and the value is derived from the parent transaction.
  • Maximum Length: 50
    Number that the customer uses to identify the item. This attribute can be blank and the value is derived from the parent transaction.
  • Maximum Length: 360
    Name of the customer. This attribute can be blank and the value is derived from the parent transaction.
  • Maximum Length: 30
    Number that uniquely identifies the customer. This attribute can be blank and the value is derived from the parent transaction.
  • Maximum Length: 1
    Contains one of the following values: true or false. If true, then the lots and serial numbers from an advance shipment notice (ASN) or an advance shipment billing notice (ASBN) will be are defaulted when executing a receipt or a put away transaction. If false, then the lots and serial numbers from an advance shipment notice (ASN) or an advance shipment billing notice (ASBN) will not be defaulted when executing a receipt or a put away transaction. The default value is false.
  • Maximum Length: 1
    Contains one of the following values: true or false. If true, then the lots and serial numbers from a transfer order are defaulted when executing a receipt or a put away transaction. If false, then the lots and serial numbers from a transfer order aren't defaulted when executing a receipt or a put away transaction. The default value is false.
  • Maximum Length: 2
    Value that indicates the default taxation country. This attribute is applicable only for return transactions. Even for returns, if blank, the default value from the parent transaction is used.
  • Maximum Length: 60
    Abbreviation that identifies the deliver-to location. This attribute is used to derive DeliverTolocationId. If this attribute is blank, the default value from the purchase order distribution or transfer order distribution is used.
  • Value that uniquely identifies the deliver-to location. If this attribute is blank, the default value from the purchase order distribution or transfer order distribution is used. DeliverToLocationId is mandatory when transaction type is DELIVER and source document code is PO or TRANSFER ORDER and the destination type code of the distribution is EXPENSE.
  • Value that uniquely identifies the deliver-to person or requester. If this attribute is blank, the default value of the requester specified on the purchase order distribution or transfer order distribution is used.
  • Maximum Length: 240
    Name of the deliver-to person or requester. This attribute is used to derive DeliverToPersonId.
  • Maximum Length: 25
    Abbreviation that identifies the destination type for the receiving transaction. This attribute should be left blank. It will be derived from the source document.
  • Flexfields for Receipt Transactions
    Title: Flexfields for Receipt Transactions
    The Flexfields for Receipt Transactions resource manages the information associated with receipt transactions.
  • Number that identifies the document distribution for the receiving transaction. When receiving a purchase order that has multiple distributions, this attribute is the respective purchase order distribution number. When receiving a purchase order with multiple distributions, this attribute is mandatory.
  • Maximum Length: 240
    Fiscal classification for the document. This attribute is applicable only for return transactions. Even for returns, if blank, the default value from the parent transaction is used.
  • Number that identifies the document line number for the receipt line request or advanced shipment notice (ASN) line request. When the source document code is PO (create an ASN, receive a purchase order, or receive an ASN), this attribute is the purchase order line number. When the source document code is INVENTORY, this attribute is the in-transit shipment line number. When the source document code is TRANSFER ORDER, this attribute is the transfer order shipment line number. When the source document code is RMA, this attribute is the return material authorization (RMA) line number. This attribute is mandatory.
  • Maximum Length: 30
    Number that identifies the document for the receipt line request or advanced shipment notice (ASN) line request. When the source document code is PO (create an ASN, receive a purchase order or an ASN), this attribute is the purchase order number. When the source document code is INVENTORY, this attribute is the in-transit shipment number. When the source document code is TRANSFER ORDER, this attribute is the transfer order shipment number. When the source document code is RMA, this attribute is the return material authorization (RMA) number. This attribute is mandatory.
  • Number that identifies the document schedule for the receiving transaction. When the source document code is PO (create an advanced shipment notice (ASN), receive a purchase order, or receive an ASN), this attribute is the purchase order schedule number. When receiving a purchase order or creating an ASN line, this attribute is mandatory.
  • Value that uniquely identifies the employee who performed the receiving transaction. If this attribute is blank, the value from the parent transaction is used.
  • Maximum Length: 240
    Name of the employee who performed the receiving transaction. This attribute is used to derive EmployeeId. If this attribute is blank, the value from the parent transaction is used.
  • Date when the electronic waybill was generated. This attribute is not applicable and should be left blank.
  • Number that identifies the electronic waybill provided by supplier for shipment of goods. This attribute is not applicable and should be left blank.
  • Maximum Length: 1
    Value that indicates whether or not the receive transaction being created has an exception. If you want to flag the receiving transaction as an exception, populate this attribute with Y. Else, leave it blank.
  • Maximum Length: 150
    License plate number of the external warehouse management application.
  • Maximum Length: 300
    Value that contains reference information for the corresponding transaction in external applications.
  • Maximum Length: 60
    Value that indicates the final discharge location. This attribute is used to derive FinalDischargeLocationId. Applicable only for return transactions. Even for returns, if left blank, defaulted from the parent transaction.
  • Value that uniquely identifies the final discharge location. This attribute is applicable only for return transactions. Even for returns, if blank, the default value from the parent transaction is used.
  • Value that uniquely identifies the first party registration. This attribute is applicable only for return transactions. Even for returns, if blank, the default value from the parent transaction is used.
  • Maximum Length: 30
    Number that is used for the first party registration. This attribute is used to derive FirstPartyRegistrationId. This attribute is applicable only for return transactions. Even for returns, if blank, the default value from the parent transaction is used.
  • Maximum Length: 30
    Abbreviation that identifies the ownership of the items that are in transit. This attribute is not currently used.
  • Maximum Length: 81
    Name of the source locator for the receiving transaction. This attribute is used to derive FromLocatorId. This attribute is applicable for negative corrections or returns and the value is derived from the parent DELIVER transaction. Enter this value if you want to return from a different location than where the material was put away.
  • Value that uniquely identifies the source locator for the receiving transaction. This attribute is applicable for negative corrections or returns and the value is derived from the parent DELIVER transaction. Enter this value if you want to return from a different location than where the material was put away.
  • Maximum Length: 18
    Abbreviation that identifies the source organization for an interorganization transfer. This is applicable for receipts against in-transit shipment or transfer order shipment.
  • Value that uniquely identifies the source organization for an in-transit shipment.
  • Maximum Length: 10
    Name of the source subinventory for the receiving transaction. This attribute is applicable for negative corrections or returns and the value is derived from the parent DELIVER transaction. Enter this value if you want to return from a different location than where the material was put away.
  • Value that uniquely identifies the group of interface records submitted together for processing.
  • Value that uniquely identifies the header interfaced receipt transaction line request.
  • Default Value: true
    Contains one of the following values: true or false. If true, then the Manage Receiving Transactions API processes the posted interface data automatically and immediately returns the response. If false, then the records are created in interface tables but no processing is done. These interface records can subsequently processed by the Manage Receiving Transactions scheduled process. The default value is true.
  • Maximum Length: 25
    Abbreviation that identifies the inspection quality. This attribute is applicable only when the transaction type is ACCEPT or REJECT. A list of accepted values is defined in the lookup type RCV_QUALITY_CODE.
  • Maximum Length: 240
    Value that indicates the intended use. This attribute is applicable only for return transactions. Even for returns, if blank, the default value from the parent transaction is used.
  • Value that uniquely identifies the intended use classification. This attribute is applicable only for return transactions. Even for returns, if blank, the default value from the parent transaction is used.
  • Maximum Length: 30
    Default Value: REST
    Abbreviation that identifies the source that interfaced the receiving transaction. It can be populated with the source application name.
  • Value that uniquely identifies the interfaced source line. This can be populated with the identifier of the line in the source application that initiated the receipt.
  • Value that uniquely identifies the interfaced receipt transaction line request.
  • Flexfields for Inventory Striping Attributes
    Title: Flexfields for Inventory Striping Attributes
    The Flexfields for Inventory Striping Attributes resource manages the inventory striping attributes that the descriptive flexfield references associated with a transaction. Inventory striping (inventory tracking) attributes are a set of named attributes (project, task, and country of origin) as well as user-configurable attributes, which when specified as part of the receipt or receiving transaction, are used to track the inventory on hand.
  • Maximum Length: 240
    Description of the item corresponding to the receipt transaction request. When you create a receipt transaction for a purchase order, it should match the item description of the corresponding purchase order line. For receipt transactions against In-transit shipment, transfer order, and return material authorization (RMA), this attribute should match the description of the inventory item. When creating a receipt transaction, one of the following must be provided: ItemId, ItemNumber, or ItemDescription. If left blank, the value from the source document is used.
  • Value that uniquely identifies the inventory item. If left blank, the value from the source document is used. When creating a receipt transaction, one of the following must be provided: ItemId, ItemNumber, or ItemDescription.
  • Maximum Length: 300
    Number that identifies the item. This attribute is used to derive ItemId. If blank, the value from the source document is used. When creating a receipt transaction, one of the following must be provided: ItemId, ItemNumber, or ItemDescription.
  • Maximum Length: 18
    Revision number of the item. This attribute is mandatory when delivering receipt lines whose item is revision controlled.
  • Read Only: true
    Date and time when the user most recently updated the interface record for receipt line request.
  • Read Only: true
    Maximum Length: 64
    Login of the user who updated the interface record for receipt line request.
  • Maximum Length: 30
    Source license plate number. This attribute can be blank for this resource.
  • Links
  • Maximum Length: 81
    Name of the destination locator for the receiving transaction. This is used to derive LocatorId. This attribute or LocatorId is mandatory when: the transaction type is DELIVER, destination type of the document schedule or document line is Inventory, locator control is predefined or dynamic and item transaction defaults or not entered (if item transaction default exists, it will be derived).
  • Value that uniquely identifies the destination locator for the receiving transaction. This attribute or Locator is mandatory when: the transaction type is DELIVER, destination type of the document schedule or document line is Inventory, locator control is predefined or dynamic and item transaction defaults or not entered (if item transaction default exists, it will be derived).
  • Lots for Lot Items
    Title: Lots for Lot Items
    The Lots for Lot Items resource manages the lot information for a transaction line whose item is lot controlled and not serial controlled.
  • Lots for Lot and Serial Items
    Title: Lots for Lot and Serial Items
    The Lots for Lot and Serial Items resource manages the lot information for a transaction line whose item is both lot and serial controlled.
  • Value that uniquely identifies the source license plate number. This attribute can be blank for this resource.
  • Maximum Length: 18
    Abbreviation that identifies the receiving organization. This attribute is used to derive OrganizationId. For every receipt transaction request, you must provide one of the following attributes: OrganizationCode or OrganizationId, otherwise the request will fail.
  • Value that uniquely identifies the receiving organization. For every receipt transaction request, you must provide one of the following attributes: OrganizationCode or OrganizationId, otherwise the request will fail.
  • Maximum Length: 25
    Packing slip number for the container that contains this item. This attribute can be blank for this resource.
  • Maximum Length: 25
    Number that identifies the source transaction number of the parent receiving transaction.
  • Value that uniquely identifies the parent receiving transaction. This attribute is mandatory. Without this attribute, inspections, put away, corrections, and returns will not be processed.
  • Contains one of the following values: true or false. If true, then a new return transfer order is created that needs to be shipped to the source organization. If false, then the material is issued to scrap. The default value is false. This attribute determines whether the return against a transfer order requires a physical return of the item. This attribute is applicable only when the transaction type is RETURN TO ORGANIZATION.
  • Value that uniquely identifies the purchase order distribution. This attribute is applicable when creating an advanced shipment notice (ASN), receiving a purchase order or an ASN.
  • Value that uniquely identifies the purchase order header. This attribute is applicable when creating an advanced shipment notice (ASN), receiving a purchase order or an ASN.
  • Value that uniquely identifies the purchase order line. This attribute is applicable when creating an advanced shipment notice (ASN), receiving a purchase order or an ASN.
  • Value that uniquely identifies the purchase order schedule. This attribute is applicable when creating an advanced shipment notice (ASN), receiving a purchase order or an ASN.
  • Transaction quantity in the primary unit of measure that the item uses.
  • Maximum Length: 25
    Primary unit of measure that the item in the receiving organization uses. This attribute is used to derive PrimaryUOMCode.
  • Maximum Length: 3
    Abbreviation that identifies the primary unit of measure that the item in the receiving organization uses.
  • Processing Errors
    Title: Processing Errors
    The Processing Errors resource gets the details for each error that was encountered while processing a request for post receipt transactions.
  • Maximum Length: 25
    Default Value: PENDING
    Value that indicates the processing status for the line request. Valid values include PENDING, RUNNING, COMPLETED. The default value is PENDING. Only the interface records with value PENDING will be picked for processing. If there is an error in the derive, default, and validate cycle, the status moves to ERROR. This attribute should be left blank during POST operation so that the default value of PENDING is picked.
  • Maximum Length: 240
    Value that indicates the product category. This attribute is applicable only for return transactions. Even for returns, if blank, the default value from the parent transaction is used.
  • Value that uniquely identifies the product fiscal classification. This attribute is applicable only for return transactions. Even for returns, if blank, the default value from the parent transaction is used.
  • Maximum Length: 250
    Name used to indicate the product fiscal classification. This attribute is used to derive ProductFiscalClassificationId. This attribute is applicable only for return transactions. Even for returns, if blank, the default value from the parent transaction is used.
  • Maximum Length: 240
    Value that indicates the product type for taxation purposes. This attribute is applicable only for return transactions. Even for returns, if blank, the default value from the parent transaction is used.
  • Transaction quantity in the unit of measure that the receipt transaction request uses.
  • Value that uniquely identifies the inventory transaction reason for the receiving transaction.
  • Maximum Length: 30
    Name of the inventory transaction reason for the receiving transaction. This attribute is used to derive ReasonId.
  • Value that uniquely identifies the recall notice. This attribute should only be used for the RETURN TO VENDOR transaction type.
  • Value that uniquely identifies the line corresponding to the recall notice. This attribute should only be used for the RETURN TO VENDOR transaction type.
  • Number that identifies the recall notice line. This attribute should only be used for the RETURN TO VENDOR transaction type.
  • Maximum Length: 60
    Number that identifies the recall notice. This attribute should only be used for the RETURN TO VENDOR transaction type.
  • Value that uniquely identifies the receipt advice header.
  • Value that uniquely identifies the receipt advice line.
  • Maximum Length: 25
    Value that identifies the source of the advanced shipment notice (ASN) or the receipt. Valid values include VENDOR when creating an ASN, receiving a purchase order, or receiving an ASN, INVENTORY when receiving an in-transit shipment, TRANSFER ORDER when receiving a transfer order, CUSTOMER when receiving a return material authorization (RMA). This attribute is mandatory.
  • Maximum Length: 20000
    Contains the message that's returned to the caller when the input payload is processed asynchronously through immediate or background processing.
  • Value that indicates the status of the application call that's sent to the client. When the input payload is processed synchronously, values include SUCCESS or ERROR. When the input payload is processed asynchronously, values include SUBMITTED or QUEUED.
  • Maximum Length: 80
    Line number of the return material authorization (RMA) against which receipt is being created. This attribute is used to derive ReceiptAdviceLineId. This attribute is mandatory when creating receipt for RMA.
  • Maximum Length: 80
    Number of the return material authorization (RMA) against which receipt is being done. This attribute along with RMASourceSystemName of the header is used to derive ReceiptAdviceHeaderId. This attribute is applicable when creating receipt transactions for RMA.
  • Maximum Length: 30
    Number that identifies the return material authorization that the supplier provides when returning goods to the supplier. This attribute is applicable only when the transaction type is RETURN TO VENDOR.
  • Maximum Length: 80
    Schedule number of the return material authorization against which receipt is being done.
  • Maximum Length: 30
    Value that indicates the receiving routing. This attribute need not be populated for this resource. It is derived from the parent transaction.
  • Value that uniquely identifies the receiving routing. This attribute need not be populated for this resource. It is derived from the parent transaction.
  • Default Value: false
    Contains one of the following values: true or false. If true, then the Manage Receiving Transactions API resubmits the patched interface data automatically and immediately returns the response. If false, then the records are updated in interface tables but not resubmitted. The default value is false.
  • Transaction quantity in the secondary unit of measure that the item uses.
  • Maximum Length: 25
    Secondary unit of measure that the item in the receiving organization uses.
  • Maximum Length: 3
    Abbreviation that identifies the secondary unit of measure that the item in the receiving organization uses.
  • Serials for Serial Items
    Title: Serials for Serial Items
    The Serials for Serial Items resource manages the serial number information for a transaction line whose item is serial controlled and not lot controlled.
  • Value that uniquely identifies the receiving shipment or receipt header. This attribute is applicable when receiving an advanced shipment notice (ASN), a in-transit shipment, or a transfer order.
  • Value that uniquely identifies the shipment line. This attribute is applicable when receiving an advanced shipment notice (ASN), a in-transit shipment, or a transfer order.
  • Maximum Length: 30
    Number that identifies the shipment that the shipment source assigns. This number corresponds to the number that identifies one of the following objects: advance shipment notice, in-transit shipment, or transfer-order shipment.
  • Maximum Length: 60
    Abbreviation that identifies the receiving location. This is used to derive ShipTolocationId. This attribute is applicable only when transaction type is ACCEPT, REJECT, and TRANSFER. If this attribute is blank, the value from the parent transaction is used.
  • Value that uniquely identifies the receiving location. If this attribute is blank during a POST operation, the value is derived from ShipToLocationId of the source document. This attribute is applicable only when transaction type is ACCEPT, REJECT, and TRANSFER. If this attribute is blank, the value from the parent transaction is used.
  • Maximum Length: 240
    Name of the sold-to legal entity. Populate this attribute with the sold-to legal entity associated to the purchase order. This is used to derive SoldtoLegalEntityId.
  • Value that uniquely identifies the sold-to legal entity. The combination of DocumentNumber and SoldtoLegalEntityId is needed to derive POHeaderId, which identifies the purchase order header for a purchase order-based transaction.
  • Maximum Length: 25
    Abbreviation that identifies the type of source document. Valid values include PO to create an advanced shipment notice (ASN), receive a purchase order, or an ASN, INVENTORY to receive an in-transit shipment, TRANSFER ORDER to receive a transfer order, RMA to receive a transfer order. A list of accepted values is defined in the lookup type RCV_SOURCE_DOCUMENT_TYPE. This attribute is mandatory.
  • Maximum Length: 25
    Number that identifies the unique transaction identifier in the source application. There can be only one record in receiving transactions for a source transaction number.
  • Maximum Length: 10
    Name of the destination subinventory for the receiving transaction. This attribute is mandatory when: the transaction type is DELIVER, destination type of the document schedule or document line is Inventory, subinventory is not specified on the document distribution or line (if provided in the document line, the default value is used), or no item transaction default exists (if item transaction default exists, it will be derived).
  • Value that uniquely identifies the substitute item. This attribute is not currently used.
  • Maximum Length: 300
    Substitute item number for the item on the receipt line. This attribute is not currently used.
  • Maximum Length: 25
    Value that indicates whether the transaction is for a substitute item. This attribute is not currently used.
  • Maximum Length: 50
    Value that indicates the tax classification. This attribute is applicable only for return transactions. Even for returns, if blank, the default value from the parent transaction is used.
  • Date when the tax invoice is created. This attribute is applicable only for return transactions. Even for returns, if blank, the default value from the parent transaction is used.
  • Maximum Length: 150
    Number of the tax invoice. This attribute is applicable only for return transactions. Even for returns, if blank, the default value from the parent transaction is used.
  • Value that uniquely identifies the third party registration. This attribute is applicable only for return transactions. Even for returns, if blank, the default value from the parent transaction is used.
  • Maximum Length: 30
    Number that is used for the third party registration. This attribute is used to derive ThirdPartyRegistrationId. This attribute is applicable only for return transactions. Even for returns, if blank, the default value from the parent transaction is used.
  • Maximum Length: 240
    Business category of the transaction. This attribute is applicable only for return transactions. Even for returns, if blank, the default value from the parent transaction is used.
  • Date when the transaction for the current line is created. This attribute is used for receipt accounting, invoicing, and other related processes. The default value is the current date and time. If the time zone is not provided, the value stored is the time zone of the database. This value cannot be a future date.
  • Maximum Length: 25
    Default Value: PENDING
    Value that indicates the status of the advanced shipment notice (ASN) line request or receipt transaction request. Valid values include PENDING, RUNNING or ERROR. The default value is PENDING. Only the interface records with value PENDING are picked for processing. If there is an error in running the transaction, the status changes to ERROR. This attribute should be blank during POST operations so that the default value of PENDING is used.
  • Maximum Length: 25
    Default Value: RECEIVE
    Type of transaction for the receipt transaction line request. Valid values include ACCEPT, REJECT, TRANSFER, DELIVER, CORRECT, RETURN TO VENDOR, RETURN TO RECEIVING, RETURN TO CUSTOMER, and RETURN TO ORGANIZATION.
  • Value that uniquely identifies the transfer order distribution. This attribute is applicable when receiving a transfer order with multiple distributions and direct routing.
  • Value that uniquely identifies the transfer order header. This attribute is applicable when receiving a transfer order.
  • Value that uniquely identifies the transfer order line. This attribute is applicable receiving a transfer order.
  • Maximum Length: 35
    Number of the truck. This attribute is not currently used.
  • Maximum Length: 25
    Unit of measure for the receipt transaction request. This attribute is used to derive UOMCode.
  • Maximum Length: 3
    Abbreviation that identifies the unit of measure that the receipt transaction uses.
  • Maximum Length: 30
    Value that indicates the fiscal classification defined by the user. This attribute is applicable only for return transactions. Even for returns, if blank, the default value from the parent transaction is used.
  • Value that uniquely identifies the supplier. This attribute can be blank for this resource and is derived from the parent transaction.
  • Maximum Length: 300
    Number that the supplier uses to identify the item. This attribute can be blank for this resource and is derived from the parent transaction.
  • Maximum Length: 240
    Name of the supplier. This attribute can be blank for this resource and is derived from the parent transaction.
  • Maximum Length: 30
    Number that identifies the supplier. This attribute can be blank for this resource and is derived from the parent transaction.
  • Maximum Length: 240
    Abbreviation that identifies the supplier site for a business unit. This attribute can be blank for this resource and is derived from the parent transaction.
  • Value that uniquely identifies the supplier site. This attribute can be blank for this resource and is derived from the parent transaction.
Nested Schema : ASNLineDFF
Type: array
Show Source
Nested Schema : Attachments
Type: array
Title: Attachments
The Attachments resource manages attachments when creating a post receipt transaction. The attachments uploaded as part of this correspond to the entity name Receiving Transactions.
Show Source
Nested Schema : Flexfields for Receipt Transactions
Type: array
Title: Flexfields for Receipt Transactions
The Flexfields for Receipt Transactions resource manages the information associated with receipt transactions.
Show Source
Nested Schema : Flexfields for Inventory Striping Attributes
Type: array
Title: Flexfields for Inventory Striping Attributes
The Flexfields for Inventory Striping Attributes resource manages the inventory striping attributes that the descriptive flexfield references associated with a transaction. Inventory striping (inventory tracking) attributes are a set of named attributes (project, task, and country of origin) as well as user-configurable attributes, which when specified as part of the receipt or receiving transaction, are used to track the inventory on hand.
Show Source
Nested Schema : Lots for Lot Items
Type: array
Title: Lots for Lot Items
The Lots for Lot Items resource manages the lot information for a transaction line whose item is lot controlled and not serial controlled.
Show Source
Nested Schema : Lots for Lot and Serial Items
Type: array
Title: Lots for Lot and Serial Items
The Lots for Lot and Serial Items resource manages the lot information for a transaction line whose item is both lot and serial controlled.
Show Source
Nested Schema : Processing Errors
Type: array
Title: Processing Errors
The Processing Errors resource gets the details for each error that was encountered while processing a request for post receipt transactions.
Show Source
Nested Schema : Serials for Serial Items
Type: array
Title: Serials for Serial Items
The Serials for Serial Items resource manages the serial number information for a transaction line whose item is serial controlled and not lot controlled.
Show Source
Nested Schema : receivingReceiptTransactionRequests-ASNLineDFF-item-response
Type: object
Show Source
Nested Schema : receivingReceiptTransactionRequests-attachments-item-response
Type: object
Show Source
Nested Schema : receivingReceiptTransactionRequests-DFF-item-response
Type: object
Show Source
Nested Schema : receivingReceiptTransactionRequests-inventoryStripingDFF-item-response
Type: object
Show Source
  • Title: Context Segment
    Maximum Length: 40
    Descriptive flexfield context name for inventory striping attributes. This attribute is associated with a feature that requires opt in.
  • Title: Context Segment
    Descriptive flexfield context display value for inventory striping attributes. This attribute is associated with a feature that requires opt in.
  • Title: Country of Origin
    Maximum Length: 2
    Abbreviation that identifies the country of manufacture for this item. This attribute is associated with a feature that requires opt in.
  • Title: Country of Origin
    Name of the country of origin. This attribute is associated with a feature that requires opt in.
  • Value that uniquely identifies the transaction. This attribute is associated with a feature that requires opt in.
  • Links
  • Title: Project
    Value that uniquely identifies the project. This attribute is associated with a feature that requires opt in.
  • Title: Project
    Number that identifies the project. This attribute is associated with a feature that requires opt in.
  • Title: Task
    Value that uniquely identifies the task. This attribute is associated with a feature that requires opt in.
  • Title: Task
    Number that identifies the task. This attribute is associated with a feature that requires opt in.
Nested Schema : receivingReceiptTransactionRequests-lotItemLots-item-response
Type: object
Show Source
  • Maximum Length: 150
    Abbreviation that identifies the grade.
  • Date when the warehouse applied a hold on the lot corresponding to the receipt transaction request. This attribute is applicable when the warehouse places the item under lot control.
  • Links
  • Flexfields for Lot Attributes
    Title: Flexfields for Lot Attributes
    The Flexfields for Lot Attributes resource manages the details of the lot attributes and is associated to a transaction line whose item is both lot and serial controlled.
  • Date when the item of the lot corresponding to receipt transaction request. This attribute is applicable when the warehouse places the item under lot control.
  • Maximum Length: 80
    Number that identifies the lot corresponding to the receipt transaction request. This attribute is applicable when the warehouse places the item under lot control.
  • Flexfields for Lot Numbers
    Title: Flexfields for Lot Numbers
    The Flexfields for Lot Numbers resource manages lot numbers and is associated to a transaction line whose item is both lot and serial controlled.
  • Date when the lot matures. This attribute is applicable when the warehouse places the item under lot control.
  • Date when the lot originated corresponding to the ASN line request or receipt line request. This attribute is applicable when the warehouse places the item under lot control.
  • Maximum Length: 30
    Type of origination for the lot corresponding to the advanced shipment notice (ASN) line request or receipt line request. This attribute is applicable when the warehouse places the item under lot control.
  • Maximum Length: 80
    Number that identifies the parent lot of the lot corresponding to the receipt transaction request. This attribute is applicable when the warehouse places the item under lot control.
  • Transaction quantity for the lot in the primary unit of measure that the item uses. This attribute is applicable when the warehouse places the item under lot control.
  • Value that uniquely identifies the reason for the receiving transaction. This attribute is applicable when the warehouse places the item under lot control.
  • Maximum Length: 30
    Name of the reason for the receiving transaction for the lot. This attribute is applicable when the warehouse places the item under lot control.
  • Transaction quantity for the lot in the secondary unit of measure that the item uses. This attribute is applicable when the warehouse places the item under lot control.
  • Transaction quantity of the item for the lot corresponding to the receipt transaction request expires. This attribute is applicable when the warehouse places the item under lot control.
  • Maximum Length: 150
    Number that identifies the supplier lot for the lot corresponding to the receipt transaction request. This attribute is applicable when the warehouse places the item under lot control.
Nested Schema : Flexfields for Lot Attributes
Type: array
Title: Flexfields for Lot Attributes
The Flexfields for Lot Attributes resource manages the details of the lot attributes and is associated to a transaction line whose item is both lot and serial controlled.
Show Source
Nested Schema : Flexfields for Lot Numbers
Type: array
Title: Flexfields for Lot Numbers
The Flexfields for Lot Numbers resource manages lot numbers and is associated to a transaction line whose item is both lot and serial controlled.
Show Source
Nested Schema : receivingReceiptTransactionRequests-lotItemLots-lotAttributesDFF-item-response
Type: object
Show Source
Nested Schema : receivingReceiptTransactionRequests-lotItemLots-lotNumbersDFF-item-response
Type: object
Show Source
Nested Schema : receivingReceiptTransactionRequests-lotSerialItemLots-item-response
Type: object
Show Source
  • Maximum Length: 150
    Abbreviation that identifies the grade.
  • Date when the warehouse applied a hold on the lot corresponding to the receipt transaction request. This attribute is applicable when the warehouse places the item under lot and serial control.
  • Links
  • Flexfields for Lot Attributes
    Title: Flexfields for Lot Attributes
    The Flexfields for Lot Attributes resource manages the details of the lot attributes and is associated to a transaction line whose item is both lot and serial controlled.
  • Date when the item of this lot corresponding to the receipt transaction request expires. This attribute is applicable when the warehouse places the item under lot and serial control.
  • Maximum Length: 80
    Number that identifies the lot for the item corresponding to the receipt transaction request. This attribute is applicable when the warehouse places the item under lot and serial control.
  • Flexfields for Lot Numbers
    Title: Flexfields for Lot Numbers
    The Flexfields for Lot Numbers resource manages lot numbers and is associated to a transaction line whose item is both lot and serial controlled.
  • Serials for Lot and Serial Items
    Title: Serials for Lot and Serial Items
    The Serials for Lot and Serial Items resource manages the serial number information associated with a specific lot for a transaction line whose item is both lot and serial controlled.
  • Date when the lot matures for the receipt transaction request. This attribute is applicable when the warehouse places the item under lot and serial control.
  • Date when this lot originated for the receipt transaction request. This attribute is applicable when the warehouse places the item under lot and serial control.
  • Maximum Length: 30
    Type of origination for the lot corresponding to the receipt transaction request. This attribute is applicable when the warehouse places the item under lot and serial control.
  • Maximum Length: 80
    Number that identifies the parent lot of the lot corresponding to the receipt transaction request. This attribute is applicable when the warehouse places the item under lot and serial control.
  • Transaction quantity for this lot in the primary unit of measure that the item uses. This attribute is applicable when the warehouse places the item under lot and serial control.
  • Value that uniquely identifies the reason for the receiving transaction for the lot. This attribute is applicable when the warehouse places the item under lot and serial control.
  • Maximum Length: 30
    Name of the reason for the receiving transaction for the lot. This attribute is applicable when the warehouse places the item under lot and serial control.
  • Transaction quantity for this lot in the secondary unit of measure that the item uses. This attribute is applicable when the warehouse places the item under lot and serial control.
  • Transaction quantity of the lot corresponding to the receipt transaction request. This attribute is applicable when the warehouse places the item under lot and serial control.
  • Maximum Length: 150
    Number that identifies the supplier lot for the lot corresponding to the receipt transaction request. This attribute is applicable when the warehouse places the item under lot and serial control.
Nested Schema : Flexfields for Lot Attributes
Type: array
Title: Flexfields for Lot Attributes
The Flexfields for Lot Attributes resource manages the details of the lot attributes and is associated to a transaction line whose item is both lot and serial controlled.
Show Source
Nested Schema : Flexfields for Lot Numbers
Type: array
Title: Flexfields for Lot Numbers
The Flexfields for Lot Numbers resource manages lot numbers and is associated to a transaction line whose item is both lot and serial controlled.
Show Source
Nested Schema : Serials for Lot and Serial Items
Type: array
Title: Serials for Lot and Serial Items
The Serials for Lot and Serial Items resource manages the serial number information associated with a specific lot for a transaction line whose item is both lot and serial controlled.
Show Source
Nested Schema : receivingReceiptTransactionRequests-lotSerialItemLots-lotAttributesDFF-item-response
Type: object
Show Source
Nested Schema : receivingReceiptTransactionRequests-lotSerialItemLots-lotNumbersDFF-item-response
Type: object
Show Source
Nested Schema : receivingReceiptTransactionRequests-lotSerialItemLots-lotSerialItemSerials-item-response
Type: object
Show Source
  • Maximum Length: 80
    Starting serial number in a range of serial numbers of the receipt transaction request. This attribute is applicable when the warehouse places the item under lot and serial control.
  • Links
  • Flexfields for Serial Attributes
    Title: Flexfields for Serial Attributes
    The Flexfields for Serial Attributes resource manages the details of serial attributes and is associated to a transaction line whose item is both lot and serial controlled.
  • Flexfields for Serial Numbers
    Title: Flexfields for Serial Numbers
    The Flexfields for Serial Numbers resource manages the details of serial numbers and is associated to a transaction line whose item is serial controlled and not lot controlled.
  • Maximum Length: 80
    Ending serial number in a range of serial numbers of the receipt transaction request. This attribute is applicable when the warehouse places the item under lot and serial control.
  • Maximum Length: 80
    Supplier serial number for the serial range of the receipt transaction request. This attribute is applicable when the warehouse places the item under lot and serial control.
Nested Schema : Flexfields for Serial Attributes
Type: array
Title: Flexfields for Serial Attributes
The Flexfields for Serial Attributes resource manages the details of serial attributes and is associated to a transaction line whose item is both lot and serial controlled.
Show Source
Nested Schema : Flexfields for Serial Numbers
Type: array
Title: Flexfields for Serial Numbers
The Flexfields for Serial Numbers resource manages the details of serial numbers and is associated to a transaction line whose item is serial controlled and not lot controlled.
Show Source
Nested Schema : receivingReceiptTransactionRequests-lotSerialItemLots-lotSerialItemSerials-serialAttributesDFF-item-response
Type: object
Show Source
Nested Schema : receivingReceiptTransactionRequests-lotSerialItemLots-lotSerialItemSerials-serialNumbersDFF-item-response
Type: object
Show Source
Nested Schema : receivingReceiptTransactionRequests-processingErrors-item-response
Type: object
Show Source
  • Read Only: true
    Value that uniquely identifies the batch into which the interface records are grouped for processing.
  • Read Only: true
    Maximum Length: 30
    Name of the column for the attribute value that resulted in error during processing.
  • Read Only: true
    Maximum Length: 240
    Text of the error message, if any, after the processing the records.
  • Read Only: true
    Maximum Length: 240
    Name of the error message, is any, after processing the records.
  • Read Only: true
    Maximum Length: 25
    Type of the error, if any, after processing the records. Valid values include ERROR or WARNING.
  • Read Only: true
    Value that uniquely identifies the receiving interface error record.
  • Read Only: true
    Value that uniquely identifies the header request that corresponds to the current receiving interface error record.
  • Read Only: true
    Value that uniquely identifies the line request that corresponds to the current receiving interface error record.
  • Links
  • Read Only: true
    Maximum Length: 30
    Name of the table for the attribute value that resulted in error during processing.
Nested Schema : receivingReceiptTransactionRequests-serialItemSerials-item-response
Type: object
Show Source
  • Maximum Length: 80
    Starting serial number in a range of serial numbers of the receipt transaction request. This attribute is applicable when the warehouse places the item under serial control.
  • Links
  • Flexfields for Serial Attributes
    Title: Flexfields for Serial Attributes
    The Flexfields for Serial Attributes resource manages the details of serial attributes and is associated to a transaction line whose item is both lot and serial controlled.
  • Flexfields for Serial Numbers
    Title: Flexfields for Serial Numbers
    The Flexfields for Serial Numbers resource manages the details of serial numbers and is associated to a transaction line whose item is serial controlled and not lot controlled.
  • Maximum Length: 80
    Ending serial number in a range of serial numbers of the receipt transaction request. This attribute is applicable when the warehouse places the item under serial control.
  • Maximum Length: 80
    Supplier serial number for the serial range of the receipt transaction request. This attribute is applicable when the warehouse places the item under serial control.
Nested Schema : Flexfields for Serial Attributes
Type: array
Title: Flexfields for Serial Attributes
The Flexfields for Serial Attributes resource manages the details of serial attributes and is associated to a transaction line whose item is both lot and serial controlled.
Show Source
Nested Schema : Flexfields for Serial Numbers
Type: array
Title: Flexfields for Serial Numbers
The Flexfields for Serial Numbers resource manages the details of serial numbers and is associated to a transaction line whose item is serial controlled and not lot controlled.
Show Source
Nested Schema : receivingReceiptTransactionRequests-serialItemSerials-serialAttributesDFF-item-response
Type: object
Show Source
Nested Schema : receivingReceiptTransactionRequests-serialItemSerials-serialNumbersDFF-item-response
Type: object
Show Source
Back to Top

Examples

This example describes how to get one receipt transaction request.

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/receivingReceiptTransactionRequests/InterfaceTransactionId"

For example, the following command gets one receipt transaction request using a finder:

curl -u username:password "https://servername/fscmRestApi/resources/version/receivingReceiptTransactionRequests?finder=findByTransactionAttributes;ProcessingStatusCode=ERROR,GroupId=40380&expand=DFF,attachments,processingErrors,lotItemLots,lotItemLots.lotAttributesDFF,lotItemLots.lotNumbersDFF,serialItemSerials,serialItemSerials.serialAttributesDFF,serialItemSerials.serialNumbersDFF,lotSerialItemLots,lotSerialItemLots.lotAttributesDFF,lotSerialItemLots.lotNumbersDFF,lotSerialItemLots.lotSerialItemSerials,lotSerialItemLots.lotSerialItemSerials.serialAttributesDFF,lotSerialItemLots.lotSerialItemSerials.serialNumbersDFF,transactionAttachments,transactionDFF&onlyData=true"

Example Response Body

The following shows an example of the response body in JSON format.

{
    "items": [
        {
            "InterfaceTransactionId": 100000012481130,
            "HeaderInterfaceId": 100000012481132,
            "CreatedBy": "ALL_FUNCTION_ALL_DATA",
            "CreationDate": "2009-10-08T22:00:33.001+00:00",
            "LastUpdateDate": "2009-10-08T22:11:37.410+00:00",
            "LastUpdatedBy": "ALL_FUNCTION_ALL_DATA",
            "TransactionType": "RECEIVE",
            "AutoTransactCode": "RECEIVE",
            "TransactionDate": "2009-10-08T22:00:33+00:00",
            "OrganizationCode": null,
            "OrganizationId": 204,
            "ItemDescription": "zBIA_Purchase Item_07",
            "ItemId": 100000012071152,
            "ItemNumber": "zBIA_proc_item_07",
            "ItemRevision": "A",
            "ReceiptSourceCode": "VENDOR",
            "SourceDocumentCode": "PO",
            "DocumentNumber": "1000256",
            "DocumentLineNumber": 1,
            "DocumentShipmentLineNumber": 1,
            "DocumentDistributionNumber": null,
            "PODistributionId": null,
            "POHeaderId": 100000012303578,
            "POLineId": 100000012303596,
            "POLineLocationId": 100000012303597,
            "ShipmentHeaderId": null,
            "ShipmentLineId": null,
            "ShipmentNumber": null,
            "ASNLineNumber": null,
            "TransferOrderHeaderId": null,
            "TransferOrderLineId": null,
            "TransferOrderDistributionId": null,
            "SoldtoLegalEntity": null,
            "SoldtoLegalEntityId": null,
            "DestinationTypeCode": "RECEIVING",
            "Subinventory": "Stores",
            "Locator": null,
            "LocatorId": null,
            "Quantity": 275,
            "UnitOfMeasure": null,
            "UOMCode": "DZ",
            "PrimaryQuantity": 275,
            "PrimaryUOMCode": "DZ",
            "PrimaryUnitOfMeasure": null,
            "ProcessingStatusCode": "ERROR",
            "SecondaryUOMCode": null,
            "SecondaryUnitOfMeasure": null,
            "SecondaryQuantity": null,
            "EmployeeId": 31,
            "EmployeeName": null,
            "ParentTransactionId": null,
            "SourceTransactionNumber": null,
            "ParentSourceTransactionNumber": null,
            "InterfaceSourceCode": "RCV",
            "InterfaceSourceLineId": null,
            "ShipToLocationCode": null,
            "ShipToLocationId": 204,
            "DeliverToLocationCode": null,
            "DeliverToLocationId": null,
            "DeliverToPersonId": null,
            "DeliverToPersonName": null,
            "RoutingCode": null,
            "RoutingHeaderId": 1,
            "InspectionQualityCode": null,
            "Exception": null,
            "RMAReference": null,
            "RMANumber": null,
            "RMALineNumber": null,
            "RMAScheduleNumber": null,
            "ReceiptAdviceHeaderId": null,
            "ReceiptAdviceLineId": null,
            "CustomerId": null,
            "CustomerPartyName": null,
            "CustomerPartyNumber": null,
            "CustomerItemNumber": null,
            "CustomerItemId": null,
            "Amount": null,
            "CountryOfOriginCode": null,
            "CurrencyCode": "USD",
            "CurrencyConversionDate": null,
            "CurrencyConversionRate": null,
            "FromOrganizationCode": null,
            "FromOrganizationId": null,
            "ContainerNumber": null,
            "SubstituteItemNumber": null,
            "SubstituteItemId": null,
            "SubstituteUnorderedCode": null,
            "VendorName": null,
            "VendorId": 100000011548737,
            "VendorNumber": null,
            "VendorSiteCode": null,
            "VendorSiteId": 100000011548781,
            "VendorItemNumber": null,
            "BusinessUnit": null,
            "BusinessUnitId": 204,
            "ConsignedLine": null,
            "ReasonId": null,
            "ReasonName": null,
            "PackingSlip": null,
            "Comments": null,
            "FromSubinventory": null,
            "FromLocator": null,
            "FromLocatorId": null,
            "TransactionStatusCode": "PENDING",
            "GroupId": 40380,
            "ExternalSystemPackingUnit": null,
            "DefaultTaxationCountry": null,
            "DocumentFiscalClassification": null,
            "FirstPartyRegistrationId": null,
            "ThirdPartyRegistrationId": null,
            "TransactionBusinessCategory": null,
            "TaxInvoiceNumber": null,
            "TaxInvoiceDate": null,
            "EwayBillNumber": null,
            "EwayBillDate": null,
            "UserDefinedFiscalClassification": null,
            "ProductFiscalClassificationId": null,
            "TaxClassificationCode": null,
            "IntendedUseClassificationId": null,
            "IntendedUse": null,
            "ProductCategory": null,
            "AssessableValue": null,
            "FinalDischargeLocationId": null,
            "ProductType": null,
            "FirstPartyRegistrationNumber": null,
            "ThirdPartyRegistrationNumber": null,
            "ProductFiscalClassName": null,
            "FinalDischargeLocationCode": null,
            "BarcodeLabel": null,
            "TruckNumber": null,
            "InsertAndProcessFlag": "false",
            "ReturnStatus": null,
            "LPNId": null,
            "LicensePlateNumber": null,
            "SaveAndSubmitFlag": "false",
            "CreateDebitMemoFlag": null,
            "PhysicalMaterialReturnRequiredFlag": null,
            "serialItemSerials": [],
            "processingErrors": [],
            "DFF": [
                {
                    "InterfaceTransactionId": 100000012481130,
                    "_Global__Segment": null,
                    "_zBIADFF1": null,
                    "_BI_2DGlob_2DRT": null,
                    "newseg": null,
                    "__FLEX_Context": null,
                    "__FLEX_Context_DisplayValue": null
                }
            ],
            "lotItemLots": [],
            "lotSerialItemLots": [],
            "attachments": []
        }
    ],
    "count": 1,
    "hasMore": false,
    "limit": 25,
    "offset": 0,
    "links": [
        {
            "rel": "self",
            "href": "https://servername/fscmRestApi/resources/version/receivingReceiptTransactionRequests",
            "name": "receivingReceiptTransactionRequests",
            "kind": "collection"
        }
    ]
}
Back to Top