/api/wip-completions-entry-create

POST

WIP Completions Entry (JCTWC)
Kit/Shortage Issue (ICTKI) (for Kit Issue Backflush only)

JOB_ID
AUTH_TOKEN

This API call requires an Authentication Token ("Auth Token") for the required field AUTH_TOKEN. Auth Tokens are obtained from Auth Token, Get.

{
  "JOB_ID": "000958",
  "ACTION_TYPE": "TC",
  "FROM_TASK": "10",
  "STORES_CODE": "MS",
  "QUANTITY": "5",
  "SERIAL_NUMBER": "JX00005140:JX00005143,JX00005145",
  "AUTH_TOKEN": ""
}

{
  "GL_MONTH": "",
  "GL_YEAR": "",
  "ACTION_DATE": "",
  "JOB_ID": "",
  "ACTION_TYPE": "",
  "FROM_TASK": "",
  "TO_JOB_ID": "",
  "TO_TASK": "",
  "PART_ID": "",
  "LOT_ID": "",
  "STORES_CODE": "",
  "STOCK_LOCATION": "",
  "MULTI_LOC": "",
  "EXPIRE_DATE": "",
  "QUANTITY": "",
  "REFERENCE": "",
  "REASON_CODE": "",
  "SERIAL_NUMBER": "",
  "BATCH_NUMBER": "",
  "TXNS_ACCEPTED": "",
  "PROCESS_BACKFLUSH": "",
  "BACKFLUSH_COMPONENTS": [
    {
      "COMPONENT_ID": "",
      "LOT_ID": "",
      "STOCK_LOCATION": "",
      "SERIAL_NUMBER": ""
    }
  ],
  "AUTH_TOKEN": ""
}

This transaction uses Serial Numbers. Serial Numbers are specified in the SERIAL_NUMBER field.

A single Serial Number can be specified:

"SERIAL_NUMBER": "GC00004057"

A list of Serial Numbers can be specified:

"SERIAL_NUMBER": "GC00004057,GC00004058,GC00004059"

A range of Serial Numbers can be specified:

"SERIAL_NUMBER": "GC00004057:GC00004059"

A list of single Serial Numbers and Serial Number ranges can be specified:

"SERIAL_NUMBER": "GC00004052,GC00004057:GC00004059"

This transaction uses Batch Numbers. Batch Numbers are specified in the BATCH_NUMBER field. Normally a new Batch Number is assigned automatically by the transaction every time it is called and this Batch Number is returned by the transaction.

It is also possible use the same Batch Number across multiple transactions. This is done by passing the Batch Number that is returned from the first call into subsequent calls. This has the advantage of relating multiple transactions to each other, and consuming less Batch Numbers in the system. The scope of what constitutes a "Batch" is up to the API client application developer. In Expandable, the scope of a "Batch" is considered to include all transactions entered by a single operator before closing the transaction window.

This API call can automatically perform a Kit Issue Backflush transaction in conjunction with a WIP Completions transaction. To do this the PROCESS_BACKFLUSH field in the request JSON must be set to 'Y', and the WIP Completions transaction must refer to a Task where a Kit Issue Backflush is possible.

It is not strictly necessary to include the BACKFLUSH_COMPONENTS array in the request JSON. However, this array should be used if it is necessary to specify a LOT_ID, STOCK_LOCATION or SERIAL_NUMBER for any of the Backflush Components. It is only necessary to list the Backflush Components for which you need to specify any of these items. All eligible Components will be included in the Kit Issue Backflush transaction automatically.

This API call uses the Kit/Shortage Issue program (ICTKI) to perform the Kit Issue Backflush. Therefore, the API user must have Run Permission for ICTKI in order to perform a Kit Issue Backflush in conjunction with this API call.

If there is any error in the WIP Completions transaction or the Kit Issue Backflush transaction, then neither transaction will be committed to the database. There is no error if PROCESS_BACKFLUSH is set to 'Y' and the Task referred to in the WIP Completions transaction is not capable of a Kit Issue Backflush.

All transacted Kit Issue Backflush Components are listed in the BACKFLUSH_COMPONENTS array in the response JSON.

{
  "GL_MONTH": "",
  "GL_YEAR": "",
  "ACTION_DATE": "",
  "JOB_ID": "",
  "JOB_DESC": "",
  "DELIVER_TO": "",
  "ACTION_TYPE": "",
  "FROM_TASK": "",
  "FROM_TASK_DESC": "",
  "TO_JOB_ID": "",
  "TO_JOB_DESC": "",
  "TO_TASK": "",
  "TO_TASK_DESC": "",
  "PART_ID": "",
  "PART_DESC": "",
  "LOT_ID": "",
  "STORES_CODE": "",
  "STOCK_LOCATION": "",
  "MULTI_LOC": "",
  "EXPIRE_DATE": "",
  "QUANTITY": "",
  "TOTAL_STD_COST": "",
  "REFERENCE": "",
  "REASON_CODE": "",
  "SERIAL_NUMBER": "",
  "BATCH_NUMBER": "",
  "TXNS_ACCEPTED": "",
  "BACKFLUSH_COMPONENTS": [
    {
      "COMPONENT_ID": "",
      "COMPANY_ID": "",
      "DEPARTMENT": "",
      "ACCOUNT": "",
      "KIT_STORES": "",
      "REFERENCE": "",
      "SCH_KIT_DATE": "",
      "KIT_QTY": "",
      "ISSUED_QTY": "",
      "BALANCE_DUE": "",
      "DATE_LAST_ACT": "",
      "KIT_PRINT_DATE": "",
      "LOT_ID": "",
      "STOCK_LOCATION": "",
      "SERIAL_NUMBER": ""
    }
  ]
}

{
  "MESSAGE": "",
  "MESSAGE_CODE": ""
}