1. Overview

Microservice containing the business logic for managing erp-import-service.

Descriptions of these functions can be found in the section headers for each collection of relevant resources.

1.1. URI scheme

Host : localhost
BasePath : /

1.2. Tags

  • import-service-controller : Import Service Controller

2. Resources

2.1. Import-service-controller

Import Service Controller

2.1.1. Get JOB Status

GET /v1/importJobs/{jobIdsList}
Parameters
Type Name Description Schema

Path

jobIdsList
required

JobIds List

string

Responses
HTTP Code Description Schema

200

Ok

< ResponseInfo > array

401

Unauthorized

No Content

404

Not found

No Content

500

Internal server error

No Content

Produces
  • application/json;charset=UTF-8

Security
Type Name Scopes

oauth2

access_token

default

oauth2

client_creds

default

oauth2

resource_owner

default

oauth2

implicit_grant

default

2.1.2. Import Material

POST /v1/importMaterialJobs
Parameters
Type Name Description Schema

Body

input
required

Import Material XML/JSON

RequestInfo

Responses
HTTP Code Description Schema

200

OK

object

202

Accepted

object

401

Unauthorized

No Content

404

Not found

No Content

500

Internal server error

No Content

Consumes
  • application/json

Produces
  • application/json

Security
Type Name Scopes

oauth2

access_token

default

oauth2

client_creds

default

oauth2

resource_owner

default

oauth2

implicit_grant

default

2.1.3. Import Multiple MaterialLot

POST /v1/importMaterialLotJobs
Parameters
Type Name Description Schema

Body

input
required

Import Multiple MaterialLot XML/JSON

RequestInfo

Responses
HTTP Code Description Schema

200

OK

object

202

Accepted

object

401

Unauthorized

No Content

404

Not found

No Content

500

Internal server error

No Content

Consumes
  • application/json

Produces
  • application/json

Security
Type Name Scopes

oauth2

access_token

default

oauth2

client_creds

default

oauth2

resource_owner

default

oauth2

implicit_grant

default

2.1.4. Import Osp

POST /v1/importOspJobs
Parameters
Type Name Description Schema

Body

input
required

Import Osp XML/JSON

RequestInfo

Responses
HTTP Code Description Schema

200

OK

object

202

Accepted

object

401

Unauthorized

No Content

404

Not found

No Content

500

Internal server error

No Content

Consumes
  • application/json

Produces
  • application/json

Security
Type Name Scopes

oauth2

access_token

default

oauth2

client_creds

default

oauth2

resource_owner

default

oauth2

implicit_grant

default

2.1.5. Import ProcessOrder

POST /v1/importProcessOrderJobs
Parameters
Type Name Description Schema

Body

input
required

Import ProcessOrder XML/JSON

RequestInfo

Responses
HTTP Code Description Schema

200

OK

object

202

Accepted

object

401

Unauthorized

No Content

404

Not found

No Content

500

Internal server error

No Content

Consumes
  • application/json

Produces
  • application/json

Security
Type Name Scopes

oauth2

access_token

default

oauth2

client_creds

default

oauth2

resource_owner

default

oauth2

implicit_grant

default

2.1.6. Import WorkOrder

POST /v1/importWorkOrderJobs
Parameters
Type Name Description Schema

Body

input
required

Import WorkOrder XML/JSON

RequestInfo

Responses
HTTP Code Description Schema

200

OK

object

202

Accepted

object

401

Unauthorized

No Content

404

Not found

No Content

500

Internal server error

No Content

Consumes
  • application/json

Produces
  • application/json

Security
Type Name Scopes

oauth2

access_token

default

oauth2

client_creds

default

oauth2

resource_owner

default

oauth2

implicit_grant

default

3. Definitions

3.1. BillOfMaterialInfo

Bill of Materials of a work order.

Name Description Schema

behaviors
required

behaviors of the material

< string > array

bomItemId
required

Bom Item Id of the material

integer (int32)

displayOrder
required

display order of the Bom Item

integer (int32)

materialId
required

Id of the material

integer (int64)

materialName
required

Name of the material

string

propertyValues
optional

< MaterialProperties > array

quantity
required

Quantity of the material

number (double)

requiresConsumptionTracking
required

Determines if Consumption is required
Example : false

boolean

unitOfMeasureId
required

Id of the unitOfMeasure

integer (int64)

unitOfMeasureName
required

unit Of Measure

string

3.2. DocumentInfo

Documents of a route.

Name Description Schema

displayName
required

Name of the document

string

link
required

Link of the document

string

3.3. MaterialInfo

Material Information from ERP to import a material.

Name Description Schema

isSerialized
optional

The product Id is serialized or not
Example : false

boolean

productCode
required

ProductCode of the material

string

productDescription
required

ProductDescription of the material

string

productFamily
optional

ProductFamily of the material

string

propertyValues
optional

Properties of the material

< MaterialProperties > array

3.4. MaterialLotImportDocumentInfo

MaterialLot Information from ERP to import a MaterialLot.

Name Description Schema

materialLot
required

List of material lots

< MaterialLotInfo > array

schemaVersion
required

Version of the MaterialLot document

integer (int32)

3.5. MaterialLotInfo

Information from ERP to import a MaterialLot.

Name Description Schema

description
optional

Description of the materialLot

string

isSerialized
optional

The product Id is serialized or not
Example : false

boolean

lotIdentifier
required

Name of the materialLot

string

materialLotId
optional

Id of materialLot

integer (int64)

materialSubLots
optional

List of MaterialSubLots

< MaterialSubLots > array

processOrderId
optional

processOrderId

integer (int64)

productId
optional

productId

integer (int64)

productName
required

Name of the Product

string

productionLine
optional

Name of the ProductionLine

string

productionUnit
optional

Name of the productionUnit

string

propertyValues
optional

properties associated to a materialLot.

< MaterialProperties > array

quantity
required

Quantity of the Product

number (double)

status
optional

Status of the materialLot

string

statusId
optional

Id of the Status

integer (int64)

unitId
optional

Id of the Unit

integer (int64)

unitOfMeasure
optional

UnitOfMeasure associated to Unit

string

unitOfMeasureId
optional

unitOfMeasureId

integer (int64)

3.6. MaterialMasterInfo

Material to import.

Name Description Schema

material
optional

Material details.

MaterialInfo

productionLines
optional

Units to which material will be associated.

< string > array

schemaVersion
required

Schema version of the material master import document

integer (int32)

storageUnit
optional

Storage Unit

string

storageZone
optional

Storage Zone

string

unitOfMeasureId
optional

integer (int64)

3.7. MaterialProperties

Properties of a material.

Name Description Schema

propertyDataType
optional

Datatype of property

string

propertyDefinitionId
optional

Id of property

string

propertyName
required

Name of the property

string

propertyValue
required

Value of the property

string

required
optional

boolean

3.8. MaterialSubLots

Name Schema

lotIdentifier
optional

string

quantity
optional

number (double)

3.9. OperationsGroupInfo

OperationsGroupInfo data tranfer object

Name Description Schema

operations
optional

List Of Operations.

< OperationsInfo > array

route
optional

Route Operation details.

RouteOperationInfo

3.10. OperationsInfo

Operation data tranfer object

Name Description Schema

behaviors
optional

Behaviors associated to operation

< string > array

billOfMaterials
optional

Bill of materials associated to operation

< BillOfMaterialInfo > array

description
optional

Description of the operation

string

documents
optional

Documents associated to operation

< DocumentInfo > array

name
optional

Name of the operation

string

plannedUnitIds
optional

units associated to a operation

< integer (int64) > array

plannedUnitNames
optional

Name of the units associated to a operation

< string > array

propertyValues
optional

properties associated to operation

< MaterialProperties > array

sequenceNumber
optional

Sequence number of the operation

integer (int32)

3.11. ProcessOrderImportDocumentInfo

Process Order Information from ERP to import a Process order.

Name Description Schema

bomFormulation
required

bomFormulation of the processorder

string

bomFormulationId
optional

bomFormulationId of the processorder

integer (int64)

orderTypeId
optional

orderTypeId of the processorder

integer (int64)

pathId
optional

pathId of the processorder

integer (int64)

plannedEndDate
required

plannedEndDate of the workorder

string (date-time)

plannedLineId
optional

plannedLineId of the workorder

integer (int32)

plannedLineName
required

plannedLineName of the workorder

string

plannedQuantity
optional

plannedQuantity of the processorder

number (double)

plannedStartDate
required

plannedStartDate of the workorder

string (date-time)

priority
required

priority of the workorder

integer (int32)

processOrderName
required

Name of the processorder

string

producedMaterialId
optional

producedMaterialId of the workorder

integer (int64)

producedMaterialName
required

producedMaterialName of the workorder

string

schemaVersion
required

Version of the Workorder document

integer (int32)

statusId
optional

statusId of the processorder

integer (int64)

3.12. RequestInfo

Name Description Schema

jobId
required

Job Id

integer (int64)

mediaType
required

Media Type either application/XML or application/Json

string

message
required

Message of Workorder/Material/Material Lot/OSP/Process Order

string

3.13. ResponseInfo

Name Schema

jobId
optional

integer (int64)

keyData
optional

string

responseCode
optional

integer (int32)

responseMessage
optional

< string > array

3.14. RouteOperationInfo

RouteOperationInfo data tranfer object

Name Description Schema

behaviors
optional

Behaviors associated to Route operation

< string > array

billOfMaterials
optional

List of Bill of materials associated to Route operation

< BillOfMaterialInfo > array

documents
optional

List of documents associated to Route operation

< DocumentInfo > array

propertyValues
optional

properties associated to Route operation

< MaterialProperties > array

3.15. WorkOrderImportDocumentInfo

WorkOrderImportDocumentInfo data tranfer object

Name Description Schema

operationsGroup
optional

OperationsGroup Info

OperationsGroupInfo

plannedEndDate
required

plannedEndDate of the workorder

string (date-time)

plannedLineId
optional

plannedLineId of the workorder

integer (int32)

plannedLineName
required

plannedLineName of the workorder

string

plannedStartDate
required

plannedStartDate of the workorder

string (date-time)

priority
required

priority of the workorder

integer (int32)

producedMaterialId
optional

producedMaterialId of the workorder

integer (int64)

producedMaterialName
required

producedMaterialName of the workorder

string

routeDefinitionId
optional

Route Definition Id

integer (int64)

routeDefinitionName
optional

Route Definition Name

string

routeDefinitionRevision
optional

Route Definition Revision

integer (int32)

schemaVersion
required

Version of the Workorder document

integer (int32)

workOrderName
optional

Name of the Workorder

string

4. Security

4.1. access_token

Type : oauth2
Flow : accessCode
Token URL : https://10.181.213.180/uaa/oauth/authorize
Token URL : https://10.181.213.180/uaa/oauth/token

Name Description

default

Default oauth2 scope.

4.2. resource_owner

Type : oauth2
Flow : password
Token URL : https://10.181.213.180/uaa/oauth/token

Name Description

default

Default oauth2 scope.

4.3. implicit_grant

Type : oauth2
Flow : implicit
Token URL : https://10.181.213.180/uaa/oauth/authorize

Name Description

default

Default oauth2 scope.

4.4. client_creds

Type : oauth2
Flow : application
Token URL : https://10.181.213.180/uaa/oauth/token

Name Description

default

Default oauth2 scope.