PostServiceConfirmation (POST)

Overview

This POST API allows pushing Service Confirmation posted in ERP into GEP Quantum for further processing.

Request
{
   "documentNumber": "TDSC-06022025-001-QE2",
   "supplierConfirmationNumber": "TDSC-06022025-001-QE2",
   "creationSourceType": "CXML",
   "documentId": "TDSC-06022025-001",
   "actionType": "create",
   "orderDetails": {
      "lineNumber": "1",
      "orderNumber": "TD-06022025-001"
   },
   "scItems": [
      {
         "serviceEndDate": "2025-01-24",
         "serviceStartDate": "2025-01-24",
         "quantity": 1,
         "unitPrice": 500000,
         "itemLevel": 1,
         "lineNumber": "0",
         "lineType": {
            "code": "2"
         },
         "priceBasis": {
            "code": "1"
         },
         "uom": {
            "code": "AU"
         },
         "fulfillmentDocumentLineDetails": [
            {
               "lineItemNumber": "1",
               "documentNumber": "TD-06022025-001"
            }
         ],
         "category": {
            "clientCode": "9209-PE2"
         }
      },
      {
         "itemName": "JASA PROMOSI IKLAN A",
         "splitItems": [
            {
               "accountingDetails": {
                  "entity5": {
                     "entityType": "Profit Center",
                     "entityCode": "7M1APD1001"
                  },
                  "entity7": {
                     "entityCode": "5790000000",
                     "entityType": "GL Account"
                  },
                  "entity6": {
                     "entityCode": "7M1APD1021",
                     "entityType": "Cost Center"
                  }
               },
               "splitType": {
                  "description": "QuantityBased"
               },
               "percentage": 100
            }
         ],
         "serviceEndDate": "2025-01-24",
         "serviceStartDate": "2025-01-24",
         "quantity": 1,
         "unitPrice": 500000,
         "itemLevel": 2,
         "lineNumber": "1",
         "lineDescription": "JASA PROMOSI IKLAN A",
         "lineType": {
            "code": "2"
         },
         "priceBasis": {
            "code": "1"
         },
         "uom": {
            "code": "PC"
         },
         "fulfillmentDocumentLineDetails": [
            {
               "lineItemNumber": "1",
               "documentNumber": "TD-06022025-001"
            }
         ],
         "category": {
            "clientCode": "9209-PE2"
         }
      }
   ]
}
Response
{
    "data": true ,
    "hasData": false,
    "hasException": false,
    "exception": null
}
Data Elements

 

Request Schema

Property

Required?

Data Type

Description

Validations / Exceptions

supplierConfirmationNumber

Yes

string

Supplier confirmation number

 

documentId

Yes

 guid

Unique document identifier

 

creationSourceType

Yes

string

Specifies Whether document is created by inbound or portal

 

actionType

Yes

string

Whether create document or cancel document

“create” or “cancel”

 

documentNumber

Yes

string

Document Number of SC

 

totalSCAmount

 

decimal

Total amount of sc that will be created

 

eRS

No

BOOLEAN

Indicates if eRS is enabled

 

scItems

Yes

Array

Items of sc document

 

orderDetails

Yes

Object

Contains order from which sc is getting created

 

 

Order Details

Property

Required?

Data Type

Description

Validations / Exceptions

orderNumber

Yes

string

Document Number of  order

 

 

SC Items

Property

Required?

Data Type

Description

Validations / Exceptions

itemLevel

Yes

integer

Parent line is 1

Subline is 2

 

erpLineNumber

No

string

ERP Line Number

 

quantity

Yes

decimal

Quantity of item consumed

 

unitPrice

Yes

decimal

Unit price of item

 

closedForReceiving

Yes

BOOLEAN

Indicates if receiving is closed

 

lineTypeCode

Yes

LineType

Schema

Line type code whether service type or material type

 

category

Yes

Category

Schema

  

priceBasisCode

Yes

PriceBasis

Schema

Price basis code whether rate based, amount based etc.

 

uomCode

Yes

UomSchema

Unit of Measure code

 

serviceStartDate

Yes

DateTime

Service start date (if applicable) for service type line

 

serviceEndDate

Yes

DateTime

Service end date (if applicable) for service type line

 

fulfillmentDocumentLineDetails

Yes

Array of

(Fulfillment Document Line Details Schema)

 

Contains Line Level Details of source document like order

 

Consumed Date

Yes

DateTime

Consumed Date Applicable for Material Line Type

 

lineDescription

No

String

Description of the item that is being consumed

 

itemName

No

String

Name of the line item that is consumed

 

lineNumber

Yes

String

Unique line number of line in SC

 

splitItems

No

Array of (SplitItem Schema)

Contains accounting splits of a particular line item

 

 

Fulfillment Document Line Details Schema

Property

Required?

Data Type

Description

Validations / Exceptions

lineItemNumber

Yes

string

Line number of po line from which sc is getting created

 

documentNumber

Yes

string

Document Number of the fulfillment document

 

 

PriceBasisSchema

Property

Required?

Data Type

Description

Validations / Exceptions

code

Yes

string

Price basis code whether rate based, amount based etc.

“0” - quantity

“1” - rate based

“2” - amount based

 

 

LineTypeSchema

Property

Required?

Data Type

Description

Validations / Exceptions

code

Yes

string

Line type code whether service type or material type

Value -

“1” for material

“2” for service

 

 

UomSchema

Property

Required?

Data Type

Description

Validations / Exceptions

code

Yes

string

Unique UOM Code stored in GEP Platform

 

 

CategorySchema

Property

Required?

Data Type

Description

Validations / Exceptions

clientCode

Yes

string

 

Unique Category Code

 

 

 

SplitItemSchema

Property

Required?

Data Type

Description

Validations / Exceptions

percentage

Yes

decimal

Percentage of amount this split contributes to

 

splitType

Yes

SplitTypeSchema

 

 

accountingDetails

Yes

AccountingDetailsSchema

Contains details of all accounting entities

 

 

AccountingDetailsSchema (contains all accounting entities, no of entities varies from client to client)

Property

Required?

Data Type

Description

Validations / Exceptions

entity1

No

EntitySchema

 

 

entity2

No

EntitySchema

 

 

 

entityn

No

EntitySchema

 

 

 

 

EntitySchema

Property

Required?

Data Type

Description

Validations / Exceptions

entityType

Yes

string

Type of the accounting entity, like if it is a “GL Account” or “Cost Center”

 

entityCode

Yes

string

Unique code of an entity