Get one definition

get

/fscmRestApi/resources/11.13.18.05/cycleCountDefinitions/{CycleCountHeaderId}

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 : cycleCountDefinitions-item-response
Type: object
Show Source
  • Maximum Length: 40
    Name of the ABC group that the warehouse uses to initialize the item classification in the cycle count.
  • Title: ABC Assignment Group
    Value that uniquely identifies the ABC group that the warehouse uses to initialize the item classification.
  • Maximum Length: 80
    Value that determines whether or not the warehouse requires approval. A list of accepted values is defined in the lookup type INV_YES_NO_NUMERIC.
  • Title: Approval required
    Value that indicates whether or not the warehouse requires approval.
  • Maximum Length: 80
    Type of approval that the warehouse requires for an adjustment transaction. A list of accepted values is defined in the lookup type INV_APPROVAL_REQ.
  • Title: Approval Type
    Maximum Length: 30
    Value that determines the type of approval that the warehouse requires for adjustment transactions. A list of accepted values is defined in the lookup type INV_APPROVAL_REQ.
  • Maximum Length: 80
    Value that determines whether or not the warehouse schedules the counts. A list of accepted values is defined in the lookup type INV_YES_NO_NUMERIC.
  • Title: Automatically schedule
    Value that indicates whether or not the warehouse schedules the counts. A list of accepted values is defined in the lookup type INV_YES_NO_NUMERIC.
  • Mode of item category synchronization. A list of accepted values is defined in the lookup type INV_CC_SYNC_MODE.
  • Abbreviation that identifies the item category synchronization mode. A list of accepted values is defined in the lookup type INV_CC_SYNC_MODE.
  • Contains one of the following values: true or false. If true, then enable the cycle count by item category. If false, then do not enable the cycle count by item category. The default value is false.
  • Categories
    Title: Categories
    The Categories resource manages the item categories that the warehouse can use in the cycle count.
  • Category Items
    Title: Category Items
    The Category Items resource manages the category items that the warehouse can use in the cycle count.
  • Classes
    Title: Classes
    The Classes resource manages the count classes that the warehouse can use in the cycle count.
  • Items
    Title: Items
    The Items resource manages the items that the warehouse can use in the cycle count.
  • Subinventories
    Title: Subinventories
    The Subinventories resource manages the subinventories that the warehouse can use with the cycle count.
  • Maximum Length: 80
    Value that determines whether the warehouse schedules a cycle count for an item when the on-hand quantity is zero. A list of accepted values is defined in the lookup type INV_YES_NO_NUMERIC.
  • Title: Count Zero Quantity
    Value that indicates whether the warehouse schedules a cycle count for an item when the on-hand quantity is zero. A list of accepted values is defined in the lookup type INV_YES_NO_NUMERIC.
  • Value that uniquely identifies the cycle count definition.
  • Title: Count Name
    Maximum Length: 30
    Name of the cycle count.
  • Contains one of the following values: true or false. If true, then delete the additional items during item category synchronization. If false, then do not delete the additional items during item category synchronization. This attribute does not have a default value.
  • Contains one of the following values: true or false. If true, then delete the additional items during ABC synchronization. If false, then do not delete the additional items during ABC synchronization. This attribute does not have a default value.
  • Title: Description
    Maximum Length: 240
    Description of the cycle count.
  • Flexfields for Cycle Count Definitions
    Title: Flexfields for Cycle Count Definitions
    The Flexfields for Cycle Count Definitions resource manages the details about cycle counts.
  • Maximum Length: 80
    Value that determines whether or not to display the on-hand quantity for the cycle count sequence. A list of accepted values is defined in the lookup type INV_YES_NO_NUMERIC.
  • Title: Display suggested quantity
    Value that indicates whether or not to display the on-hand quantity for the cycle count sequence. A list of accepted values is defined in the lookup type INV_YES_NO_NUMERIC.
  • Title: End Date
    Date when this cycle count becomes inactive.
  • Maximum Length: 80
    Value that determines the time interval to use between two consecutive scheduling runs for a cycle count. A list of accepted values is defined in the lookup type INV_CC_SCHED_TIME.
  • Title: Frequency
    Maximum Length: 30
    Value that indicates the time interval to use between two consecutive scheduling runs for a cycle count. A list of accepted values is defined in the lookup type INV_CC_SCHED_TIME.
  • Read Only: true
    Number of subinventories included in the cycle count.
  • Title: Last Scheduled Date
    Date when the last cycle count was scheduled to run by the warehouse.
  • Links
  • Maximum Length: 80
    Value that determines whether or not the warehouse can use this cycle count to enter an unscheduled count. A list of accepted values is defined in the lookup type INV_YES_NO_NUMERIC.
  • Value that indicates whether or not the warehouse can use this cycle count to enter an unscheduled count. A list of accepted values is defined in the lookup type INV_YES_NO_NUMERIC.
  • Title: Manual Count Sequence Prefix
    Maximum Length: 3
    Prefix for a manual count sequence.
  • Title: Maximum Days Before Late
    Number of days after creation before the warehouse considers a scheduled count as late.
  • Title: Maximum Recounts
    Maximum number of recounts that the warehouse uses on a cycle count.
  • Title: Negative Adjustment Value Tolerance
    Negative currency tolerance. If the currency falls below this tolerance, then the warehouse requires approval for the adjustment transaction.
  • Title: Negative Hit and Miss Percentage
    Negative percent tolerance that the warehouse uses for hit or miss analysis.
  • Title: Negative Quantity Tolerance Percentage
    Negative percent tolerance. If the adjustment falls below this tolerance, then the warehouse requires approval for the adjustment transaction.
  • Title: Next Scheduled Date
    Date when the next cycle count is scheduled to run by the warehouse.
  • Maximum Length: 18
    Value that identifies the inventory organization.
  • Value that uniquely identifies the inventory organization.
  • Maximum Length: 240
    Name of the inventory organization.
  • Title: Positive Adjustment Value Tolerance
    Positive currency tolerance. If the currency exceeds this tolerance, then the warehouse requires approval for the adjustment transaction.
  • Positive percent tolerance that the warehouse uses for hit or miss analysis.
  • Title: Positive Quantity Tolerance Percentage
    Positive percent tolerance. If the adjustment exceeds this tolerance, then the warehouse requires approval for the adjustment transaction.
  • Maximum Length: 80
    Value that determines the detail level to use when counting serial items. A list of accepted values is defined in the lookup type INV_YES_NO_NUMERIC.
  • Title: Record count serials
    Value that indicates the detail level to use when counting serial items. A list of accepted values is defined in the lookup type INV_YES_NO_NUMERIC.
  • Maximum Length: 80
    Value that determines whether or not to include serial items when creating the count. A list of accepted values is defined in the lookup type INV_CC_SERIAL_COUNT_OPTIONS.
  • Title: Serial Numbers per Count
    Maximum Length: 30
    Default Value: 2
    Value that indicates whether or not to include serial items when creating the count. A list of accepted values is defined in the lookup type INV_CC_SERIAL_COUNT_OPTIONS.
  • Maximum Length: 80
    Value that determines whether or not to allow discrepancy when counting serial items. A list of accepted values is defined in the lookup type INV_YES_NO_NUMERIC.
  • Title: Serial discrepancy allowed
    Value that indicates whether or not to allow discrepancy when counting serial items. A list of accepted values is defined in the lookup type INV_YES_NO_NUMERIC.
  • Maximum Length: 80
    Value that determines whether or not to use the cycle count to count serial items. A list of accepted values is defined in the lookup type INV_YES_NO_NUMERIC.
  • Value that indicates whether or not to use the cycle count to count serial items. A list of accepted values is defined in the lookup type INV_YES_NO_NUMERIC.
  • Maximum Length: 80
    Value that determines whether or not to adjust for serial items. A list of accepted values is defined in the lookup type INV_CC_SERIAL_ADJ_OPTIONS.
  • Title: Serial Number Adjustment
    Maximum Length: 30
    Value that indicates whether or not to adjust for serial items. A list of accepted values is defined in the lookup type INV_CC_SERIAL_ADJ_OPTIONS.
  • Title: Start Date
    Date when this cycle count becomes active.
  • Title: Starting Count Sequence
    Starting number that the warehouse uses for the count sequence for the next scheduling run of the cycle count.
  • Value that determines the ABC synchronization mode. A list of accepted values is defined in the lookup type INV_CC_SYNC_MODE.
  • Name of the ABC group that the warehouse uses to initialize the item classification in the cycle count.
  • Contains one of the following values: true or false. If true, then synchronize the ABC classes and items during ABC synchronization. If false, then do not synchronize the ABC classes and items during ABC synchronization. This attribute does not have a default value.
  • Contains one of the following values: true or false. If true, then synchronize the count category items during item category synchronization. If false, then do not synchronize the count category items during item category synchronization. This attribute does not have a default value.
  • Maximum Length: 240
    Workday schedule that the count references.
  • Title: Workday Schedule
    Value that identifies the workday schedule that the cycle count references.
Nested Schema : Categories
Type: array
Title: Categories
The Categories resource manages the item categories that the warehouse can use in the cycle count.
Show Source
Nested Schema : Category Items
Type: array
Title: Category Items
The Category Items resource manages the category items that the warehouse can use in the cycle count.
Show Source
Nested Schema : Classes
Type: array
Title: Classes
The Classes resource manages the count classes that the warehouse can use in the cycle count.
Show Source
Nested Schema : Items
Type: array
Title: Items
The Items resource manages the items that the warehouse can use in the cycle count.
Show Source
Nested Schema : Subinventories
Type: array
Title: Subinventories
The Subinventories resource manages the subinventories that the warehouse can use with the cycle count.
Show Source
Nested Schema : Flexfields for Cycle Count Definitions
Type: array
Title: Flexfields for Cycle Count Definitions
The Flexfields for Cycle Count Definitions resource manages the details about cycle counts.
Show Source
Nested Schema : cycleCountDefinitions-countCategories-item-response
Type: object
Show Source
Nested Schema : cycleCountDefinitions-countCategoryItems-item-response
Type: object
Show Source
Nested Schema : cycleCountDefinitions-countClasses-item-response
Type: object
Show Source
Nested Schema : cycleCountDefinitions-countItems-item-response
Type: object
Show Source
Nested Schema : cycleCountDefinitions-countSubinventories-item-response
Type: object
Show Source
  • Read Only: true
    Maximum Length: 255
    Value that provides the description of the subinventory.
  • Maximum Length: 255
    Value that determines whether or not to include the subinventory when counting. A list of accepted values is defined in the lookup type INV_YES_NO_NUMERIC.
  • Value that indicates whether or not to include the subinventory when counting. A list of accepted values is defined in the lookup type INV_YES_NO_NUMERIC.
  • Links
  • Maximum Length: 10
    Name of the subinventory that the warehouse includes in this count definition.
Nested Schema : cycleCountDefinitions-DFF-item-response
Type: object
Show Source
Back to Top

Examples

This example describes how to get one cycle count definition.

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/cycleCountDefinitions?q=CycleCountHeaderId=value"

For example, the following command gets cycle count definition 300100002756508 in organization M1:

curl -u username:password "https://servername/fscmRestApi/resources/version/cycleCountDefinitions?q=OrganizationCode=M1;CycleCountHeaderId=300100002756508"

Example Response Body

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

{
  "items" : [ {
    "CycleCountHeaderId" : 300100002756508,
    "CycleCountName" : "CC-RRF",
    "Description" : null,
    "OrganizationId" : 207,
    "OrganizationCode" : "M1",
    "OrganizationName" : "Tall Manufacturing\t\t",
    "AbcAssignmentGroupId" : null,
    "AbcAssigmentGroup" : null,
    "AutomaticallyScheduleCode" : 1,
    "AutomaticallySchedule" : "Yes",
    "FrequencyCode" : "1",
    "Frequency" : "Daily",
    "WorkdayScheduleCode" : 100000016383004,
    "WorkdaySchedule" : "BJ-CC1",
    "LastScheduledDate" : "2011-11-29",
    "NextScheduledDate" : "2011-11-30",
    "ApprovalRequiredCode" : 1,
    "ApprovalRequired" : "Yes",
    "ApprovalTypeCode" : "2",
    "ApprovalType" : "If out of tolerance",
    "PositiveTolerancePercentage" : null,
    "NegativeTolerancePercentage" : null,
    "PositiveAdjustmentTolerance" : null,
    "NegativeAdjustmentTolerance" : null,
    "StartingCountSequence" : 4,
    "MaximumDaysBeforeLate" : 1,
    "MaximumRecounts" : null,
    "StartDate" : "2011-11-29",
    "EndDate" : null,
    "ManualCountsAllowedCode" : 1,
    "ManualCountsAllowed" : "Yes",
    "ManualCountSequencePrefix" : null,
    "CountZeroQuantityCode" : 1,
    "CountZeroQuantity" : "Yes",
    "DisplaySuggestedQuantityCode" : 1,
    "DisplaySuggestedQuantity" : "Yes",
    "SerializedItemsAllowedCode" : 1,
    "SerializedItemsAllowed" : "Yes",
    "SerialCountOptionCode" : "1",
    "SerialCountOption" : "Multiple",
    "SerialNumberAdjustmentCode" : "1",
    "SerialNumberAdjustment" : "Adjust if possible",
    "RecordCountSerialsCode" : 1,
    "RecordCountSerials" : "Yes",
    "SerialDiscrepancyCode" : 1,
    "SerialDiscrepancyAllowed" : "Yes",
    "PositiveHitMissPercentage" : null,
    "NegativeHitMissPercentage" : null,
    "links" : [ {
      "rel" : "self",
      "href" : "https://servername/logisticsApi/resources/version/cycleCountDefinitions/300100002756508",
      "name" : "cycleCountDefinitions",
      "kind" : "item"
    }, {
      "rel" : "canonical",
      "href" : "https://servername/logisticsApi/resources/version/cycleCountDefinitions/300100002756508",
      "name" : "cycleCountDefinitions",
      "kind" : "item"
    }, {
      "rel" : "child",
      "href" : "https://servername/logisticsApi/resources/version/cycleCountDefinitions/300100002756508/child/countSubinventories",
      "name" : "countSubinventories",
      "kind" : "collection"
    }, {
      "rel" : "child",
      "href" : "https://servername/logisticsApi/resources/version/cycleCountDefinitions/300100002756508/child/countItems",
      "name" : "countItems",
      "kind" : "collection"
    }, {
      "rel" : "child",
      "href" : "https://servername/logisticsApi/resources/version/cycleCountDefinitions/300100002756508/child/countClasses",
      "name" : "countClasses",
      "kind" : "collection"
    } ]
  } ],
  "count" : 1,
  "hasMore" : false,
  "limit" : 25,
  "offset" : 0,
  "links" : [ {
    "rel" : "self",
    "href" : "https://servername/logisticsApi/resources/version/cycleCountDefinitions",
    "name" : "cycleCountDefinitions",
    "kind" : "collection"
  } ]
}
Back to Top