API Documentation
v1Complete reference for the Aumtics APIs — 10 endpoints across 5 categories. Learn how to authenticate, send requests and handle responses.
Base URL
https://devconnect.aumtics.com/api/v1/
Authentication
Bearer Token
Content Type
application/json
Last Updated
September 17, 2026
Getting Started
-
1
Get your credentials. Aumtics issues a
client_idandclient_secretfor your integration. -
2
Generate an access token. Call POST /oauth/token with
grant_type: client_credentials. -
3
Verify it works. Call GET /testing with the header
Authorization: Bearer {access_token}. -
4
Start sending data. Pick your integration under API Categories in the sidebar, then read the endpoints you need. Response codes are listed under HTTP Codes.
Auth APIs
Generate and revoke the access token required by every secured endpoint.
2
Endpoints
Auth APIs
Generate and revoke the access token required by every secured endpoint.
Method
Endpoint
Description
POST
/oauth/token
Generate Access Token
1. Generate Access Token
/oauth/token
Purpose: This API is used to generate an Access Token that allows clients to securely access other protected APIs in the system.
Usage: Call this API endpoint /oauth/token first to get a token. This token is required to access all secure APIs. It ensures only authorized clients can access the system.
Usage: Call this API endpoint /oauth/token first to get a token. This token is required to access all secure APIs. It ensures only authorized clients can access the system.
Endpoint
https://devconnect.aumtics.com/api/v1/oauth/token
https://devconnect.aumtics.com/api/v1/oauth/token
Headers
{
"Accept": "application/json"
}
{ "Accept": "application/json" }{ "Accept": "application/json" }
Request Body
{
"grant_type": "client_credentials",
"client_id": "your-client-id",
"client_secret": "your-client-secret"
}
{ "grant_type": "client_credentials", "client_id": "your-client-id", "client_secret": "your-client-secret" }{ "grant_type": "client_credentials", "client_id": "your-client-id", "client_secret": "your-client-secret" }
Success Response
{
"token_type": "Bearer",
"expires_in": "86400",
"access_token": "example.token.string"
}
{ "token_type": "Bearer", "expires_in": "86400", "access_token": "example.token.string" }{ "token_type": "Bearer", "expires_in": "86400", "access_token": "example.token.string" }
Error Response
{
"error": "invalid_request",
"error_description": "The request is missing a required parameter.",
"hint": "Check the `...` parameter"
}
{ "error": "invalid_request", "error_description": "The request is missing a required parameter.", "hint": "Check the `...` parameter" }{ "error": "invalid_request", "error_description": "The request is missing a required parameter.", "hint": "Check the `...` parameter" }
cURL Example
curl -X POST \
https://devconnect.aumtics.com/api/v1/oauth/token \
-H 'Accept: application/json' \
-d '{
"grant_type": "client_credentials",
"client_id": "your-client-id",
"client_secret": "your-client-secret"
}'
curl -X POST \ https://devconnect.aumtics.com/api/v1/oauth/token \ -H 'Accept: application/json' \ -d '{ "grant_type": "client_credentials", "client_id": "your-client-id", "client_secret": "your-client-secret" }'
POST
/oauth/revoke
Revoke Access Token
2. Revoke Access Token
/oauth/revoke
Purpose: This API is used to revoke an existing Access Token that was previously issued to an application.
Usage: Call this API endpoint /oauth/revoke when a user logs out or when you want to invalidate a token to prevent further use. It helps maintain security by ensuring tokens are not misused.
Note: Once revoked, the token cannot be used to access any protected APIs.
Usage: Call this API endpoint /oauth/revoke when a user logs out or when you want to invalidate a token to prevent further use. It helps maintain security by ensuring tokens are not misused.
Note: Once revoked, the token cannot be used to access any protected APIs.
Endpoint
https://devconnect.aumtics.com/api/v1/oauth/revoke
https://devconnect.aumtics.com/api/v1/oauth/revoke
Headers
{
"Authorization": "Bearer {access_token}"
}
{ "Authorization": "Bearer {access_token}" }{ "Authorization": "Bearer {access_token}" }
Success Response
{
"message": "Token revoked."
}
{ "message": "Token revoked." }{ "message": "Token revoked." }
Error Response 4 fields
{
"success": false,
"error": "Bad request.",
"message": "Bearer token is required.",
"timestamp": "2025-07-23 12:28:01"
}
{ "success": false, "error": "Bad request.", "message": "Bearer token is required.", }{ "success": false, "error": "Bad request.", "message": "Bearer token is required.", "timestamp": "2025-07-23 12:28:01" }
cURL Example
curl -X POST \
https://devconnect.aumtics.com/api/v1/oauth/revoke \
-H 'Authorization: Bearer {access_token}'
curl -X POST \ https://devconnect.aumtics.com/api/v1/oauth/revoke \ -H 'Authorization: Bearer {access_token}'
Testing API
Verify that your access token is valid.
1
Endpoint
Testing API
Verify that your access token is valid.
Method
Endpoint
Description
GET
/testing
Testing
Testing
/testing
Purpose: This API is used after successful authentication to verify the validity of your access token.
Usage: Once you have generated a valid token via the authentication APIs (like
Note: This API is primarily for debugging and development. It ensures that your API token is valid. Recommended only for internal or staging environments.
Usage: Once you have generated a valid token via the authentication APIs (like
/oauth/token), call /testing to confirm the system correctly recognized.Note: This API is primarily for debugging and development. It ensures that your API token is valid. Recommended only for internal or staging environments.
Endpoint
https://devconnect.aumtics.com/api/v1/testing
https://devconnect.aumtics.com/api/v1/testing
Headers
{
"Authorization": "Bearer {access_token}"
}
{ "Authorization": "Bearer {access_token}" }{ "Authorization": "Bearer {access_token}" }
Success Response
{
"success": true,
"message": "API is working!",
"timestamp": "2025-07-16T09:31:57.808572Z"
}
{ "success": true, "message": "API is working!", "timestamp": "2025-07-16T09:31:57.808572Z" }{ "success": true, "message": "API is working!", "timestamp": "2025-07-16T09:31:57.808572Z" }
Error Response 4 fields
{
"success": false,
"error": "Unauthorized.",
"message": "Bearer token is required.",
"timestamp": "2025-07-23 12:23:48"
}
{ "success": false, "error": "Unauthorized.", "message": "Bearer token is required.", }{ "success": false, "error": "Unauthorized.", "message": "Bearer token is required.", "timestamp": "2025-07-23 12:23:48" }
cURL Example
curl -X GET \
https://devconnect.aumtics.com/api/v1/testing \
-H 'Authorization: Bearer {access_token}'
curl -X GET \ https://devconnect.aumtics.com/api/v1/testing \ -H 'Authorization: Bearer {access_token}'
Sales Order APIs
Create or update sales orders and AR invoices in Prime.
2
Endpoints
Sales Order APIs
Create or update sales orders and AR invoices in Prime.
Method
Endpoint
Description
POST
/sap/sales-orders
Create/Update Sales Order
1. Create/Update Sales Order
/sap/sales-orders
Purpose: This API is used to create or update Sales Order in the Prime.
Usage: You must call this API after successfully authenticating and receiving an
Usage: You must call this API after successfully authenticating and receiving an
access_token. It allows your application to push new sales orders into Prime from SAP.Endpoint
https://devconnect.aumtics.com/api/v1/sap/sales-orders
https://devconnect.aumtics.com/api/v1/sap/sales-orders
Headers
{
"Authorization": "Bearer {access_token}"
}
{ "Authorization": "Bearer {access_token}" }{ "Authorization": "Bearer {access_token}" }
Request Body 25 fields
{
"DocNum": "241005356",
"DocEntry": "121005351",
"DocStatus": "0",
"NumAtCard": "TMLPM/18194416 DT 31.03.2029",
"CardCode": "CO0006",
"CardName": "Hero MotoCorp Ltd Neemrana",
"DocDate": "2025-08-10",
"DocDueDate": "2025-08-20",
"TextDate": "2025-08-10",
"Currency": "INR",
"SlpCode": "5",
"OwnerCode": "88",
"Comments": "Urgent delivery required",
"ObjType": "17",
"DutyStatus": "Y",
"PlaceOfSupply": "1",
"Branch": "1",
"DiscPrcnt": 0,
"PaymentTerm": "15",
"ShipToCode": "GP ENTERPRISES",
"OtherShipToAddress": true,
"ShipToAddress": {
"AddressID": "SAI ROAD OPPOSITE HDFC BANK BADDI",
"AddressName2": "",
"AddressName3": "",
"Street_POBox": "",
"Block": "",
"City": "Baddi",
"ZipCode": "173205",
"State": "HP",
"Country": "IN",
"StreetNo": "",
"Building_Floor_Room": "",
"GSTNumber": ""
},
"Item_Details": [
{
"ItemCode": "FG000128",
"Dscription": "Sample Item 1",
"LineNum": 1,
"Quantity": 1000,
"Price": 120.15,
"TaxCode": "GST18",
"WhsCode": "W001",
"CogsOcrCod": "OC001",
"CogsOcrCo2": "OC002",
"CogsOcrCo3": "OC003",
"CogsOcrCo4": "",
"CogsOcrCo5": "",
"OpenQty": 0,
"DelivrdQty": 0,
"BackOrdr": 0,
"LineStatus": "Open",
"LineTotal": 1140,
"ShipDate": "2025-08-20"
},
{
"ItemCode": "FG000011",
"Dscription": "Sample Item 2",
"LineNum": 2,
"Quantity": 5000,
"Price": 250.654321,
"TaxCode": "GST12",
"WhsCode": "W002",
"CogsOcrCod": "OC010",
"CogsOcrCo2": "OC011",
"CogsOcrCo3": "OC012",
"CogsOcrCo4": "",
"CogsOcrCo5": "",
"OpenQty": 0,
"DelivrdQty": 0,
"BackOrdr": 0,
"LineStatus": "Closed",
"LineTotal": 1253.27,
"ShipDate": "2025-08-22"
}
],
"DocumentAdditionalExpenses": [
{
"ExpenseCode": 0,
"TaxCode": "",
"LineTotal": 0
}
],
"ImportExportDetails": {
"ImportOrExport": "Y",
"ImportOrExportType": "S"
}
}
{ "DocNum": "241005356", "DocEntry": "121005351", "DocStatus": "0", }{ "DocNum": "241005356", "DocEntry": "121005351", "DocStatus": "0", "NumAtCard": "TMLPM/18194416 DT 31.03.2029", "CardCode": "CO0006", "CardName": "Hero MotoCorp Ltd Neemrana", "DocDate": "2025-08-10", "DocDueDate": "2025-08-20", "TextDate": "2025-08-10", "Currency": "INR", "SlpCode": "5", "OwnerCode": "88", "Comments": "Urgent delivery required", "ObjType": "17", "DutyStatus": "Y", "PlaceOfSupply": "1", "Branch": "1", "DiscPrcnt": 0, "PaymentTerm": "15", "ShipToCode": "GP ENTERPRISES", "OtherShipToAddress": true, "ShipToAddress": { "AddressID": "SAI ROAD OPPOSITE HDFC BANK BADDI", "AddressName2": "", "AddressName3": "", "Street_POBox": "", "Block": "", "City": "Baddi", "ZipCode": "173205", "State": "HP", "Country": "IN", "StreetNo": "", "Building_Floor_Room": "", "GSTNumber": "" }, "Item_Details": [ { "ItemCode": "FG000128", "Dscription": "Sample Item 1", "LineNum": 1, "Quantity": 1000, "Price": 120.15, "TaxCode": "GST18", "WhsCode": "W001", "CogsOcrCod": "OC001", "CogsOcrCo2": "OC002", "CogsOcrCo3": "OC003", "CogsOcrCo4": "", "CogsOcrCo5": "", "OpenQty": 0, "DelivrdQty": 0, "BackOrdr": 0, "LineStatus": "Open", "LineTotal": 1140, "ShipDate": "2025-08-20" }, { "ItemCode": "FG000011", "Dscription": "Sample Item 2", "LineNum": 2, "Quantity": 5000, "Price": 250.654321, "TaxCode": "GST12", "WhsCode": "W002", "CogsOcrCod": "OC010", "CogsOcrCo2": "OC011", "CogsOcrCo3": "OC012", "CogsOcrCo4": "", "CogsOcrCo5": "", "OpenQty": 0, "DelivrdQty": 0, "BackOrdr": 0, "LineStatus": "Closed", "LineTotal": 1253.27, "ShipDate": "2025-08-22" } ], "DocumentAdditionalExpenses": [ { "ExpenseCode": 0, "TaxCode": "", "LineTotal": 0 } ], "ImportExportDetails": { "ImportOrExport": "Y", "ImportOrExportType": "S" } }
Success Response 4 fields
{
"success": true,
"message": "Sales order stored successfully!",
"timestamp": "2025-08-07 16:21:20",
"DocEntry": "121005351"
}
{ "success": true, "message": "Sales order stored successfully!", "timestamp": "2025-08-07 16:21:20", }{ "success": true, "message": "Sales order stored successfully!", "timestamp": "2025-08-07 16:21:20", "DocEntry": "121005351" }
Error Response 5 fields
{
"success": false,
"error": "Validation failed.",
"message": "The provided data is invalid.",
"timestamp": "2025-07-23 12:15:06",
"errors": {
"DocEntry": [
"The doc entry field is required."
],
"DocNum": [
"The document number (DocNum) is required."
],
"items": [
"At least one item is required."
]
}
}
{ "success": false, "error": "Validation failed.", "message": "The provided data is invalid.", }{ "success": false, "error": "Validation failed.", "message": "The provided data is invalid.", "timestamp": "2025-07-23 12:15:06", "errors": { "DocEntry": [ "The doc entry field is required." ], "DocNum": [ "The document number (DocNum) is required." ], "items": [ "At least one item is required." ] } }
cURL Example
curl -X POST \
https://devconnect.aumtics.com/api/v1/sap/sales-orders \
-H 'Authorization: Bearer {access_token}' \
-d '{
"DocNum": "241005356",
"DocEntry": "121005351",
"DocStatus": "0",
"NumAtCard": "TMLPM/18194416 DT 31.03.2029",
"CardCode": "CO0006",
"CardName": "Hero MotoCorp Ltd Neemrana",
"DocDate": "2025-08-10",
"DocDueDate": "2025-08-20",
"TextDate": "2025-08-10",
"Currency": "INR",
"SlpCode": "5",
"OwnerCode": "88",
"Comments": "Urgent delivery required",
"ObjType": "17",
"DutyStatus": "Y",
"PlaceOfSupply": "1",
"Branch": "1",
"DiscPrcnt": 0,
"PaymentTerm": "15",
"ShipToCode": "GP ENTERPRISES",
"OtherShipToAddress": true,
"ShipToAddress": {
"AddressID": "SAI ROAD OPPOSITE HDFC BANK BADDI",
"AddressName2": "",
"AddressName3": "",
"Street_POBox": "",
"Block": "",
"City": "Baddi",
"ZipCode": "173205",
"State": "HP",
"Country": "IN",
"StreetNo": "",
"Building_Floor_Room": "",
"GSTNumber": ""
},
"Item_Details": [
{
"ItemCode": "FG000128",
"Dscription": "Sample Item 1",
"LineNum": 1,
"Quantity": 1000,
"Price": 120.15,
"TaxCode": "GST18",
"WhsCode": "W001",
"CogsOcrCod": "OC001",
"CogsOcrCo2": "OC002",
"CogsOcrCo3": "OC003",
"CogsOcrCo4": "",
"CogsOcrCo5": "",
"OpenQty": 0,
"DelivrdQty": 0,
"BackOrdr": 0,
"LineStatus": "Open",
"LineTotal": 1140,
"ShipDate": "2025-08-20"
},
{
"ItemCode": "FG000011",
"Dscription": "Sample Item 2",
"LineNum": 2,
"Quantity": 5000,
"Price": 250.654321,
"TaxCode": "GST12",
"WhsCode": "W002",
"CogsOcrCod": "OC010",
"CogsOcrCo2": "OC011",
"CogsOcrCo3": "OC012",
"CogsOcrCo4": "",
"CogsOcrCo5": "",
"OpenQty": 0,
"DelivrdQty": 0,
"BackOrdr": 0,
"LineStatus": "Closed",
"LineTotal": 1253.27,
"ShipDate": "2025-08-22"
}
],
"DocumentAdditionalExpenses": [
{
"ExpenseCode": 0,
"TaxCode": "",
"LineTotal": 0
}
],
"ImportExportDetails": {
"ImportOrExport": "Y",
"ImportOrExportType": "S"
}
}'
curl -X POST \ https://devconnect.aumtics.com/api/v1/sap/sales-orders \ -H 'Authorization: Bearer {access_token}' \ -d '{ "DocNum": "241005356", "DocEntry": "121005351", "DocStatus": "0", "NumAtCard": "TMLPM/18194416 DT 31.03.2029", "CardCode": "CO0006", "CardName": "Hero MotoCorp Ltd Neemrana", "DocDate": "2025-08-10", "DocDueDate": "2025-08-20", "TextDate": "2025-08-10", "Currency": "INR", "SlpCode": "5", "OwnerCode": "88", "Comments": "Urgent delivery required", "ObjType": "17", "DutyStatus": "Y", "PlaceOfSupply": "1", "Branch": "1", "DiscPrcnt": 0, "PaymentTerm": "15", "ShipToCode": "GP ENTERPRISES", "OtherShipToAddress": true, "ShipToAddress": { "AddressID": "SAI ROAD OPPOSITE HDFC BANK BADDI", "AddressName2": "", "AddressName3": "", "Street_POBox": "", "Block": "", "City": "Baddi", "ZipCode": "173205", "State": "HP", "Country": "IN", "StreetNo": "", "Building_Floor_Room": "", "GSTNumber": "" }, "Item_Details": [ { "ItemCode": "FG000128", "Dscription": "Sample Item 1", "LineNum": 1, "Quantity": 1000, "Price": 120.15, "TaxCode": "GST18", "WhsCode": "W001", "CogsOcrCod": "OC001", "CogsOcrCo2": "OC002", "CogsOcrCo3": "OC003", "CogsOcrCo4": "", "CogsOcrCo5": "", "OpenQty": 0, "DelivrdQty": 0, "BackOrdr": 0, "LineStatus": "Open", "LineTotal": 1140, "ShipDate": "2025-08-20" }, { "ItemCode": "FG000011", "Dscription": "Sample Item 2", "LineNum": 2, "Quantity": 5000, "Price": 250.654321, "TaxCode": "GST12", "WhsCode": "W002", "CogsOcrCod": "OC010", "CogsOcrCo2": "OC011", "CogsOcrCo3": "OC012", "CogsOcrCo4": "", "CogsOcrCo5": "", "OpenQty": 0, "DelivrdQty": 0, "BackOrdr": 0, "LineStatus": "Closed", "LineTotal": 1253.27, "ShipDate": "2025-08-22" } ], "DocumentAdditionalExpenses": [ { "ExpenseCode": 0, "TaxCode": "", "LineTotal": 0 } ], "ImportExportDetails": { "ImportOrExport": "Y", "ImportOrExportType": "S" } }'
POST
/sap/ar-invoice
Create/Update Invoice
2. Create/Update Invoice
/sap/ar-invoice
Purpose: This API is used to create or update AR Invoice in the Prime.
Usage: You must call this API after successfully authenticating and receiving an
Usage: You must call this API after successfully authenticating and receiving an
access_token. It allows your application to push new sales orders's Invoice into Prime from SAP.Endpoint
https://devconnect.aumtics.com/api/v1/sap/ar-invoice
https://devconnect.aumtics.com/api/v1/sap/ar-invoice
Headers
{
"Authorization": "Bearer {access_token}"
}
{ "Authorization": "Bearer {access_token}" }{ "Authorization": "Bearer {access_token}" }
Request Body 31 fields
{
"DocEntry": "DOC1001",
"DocNum": 50001,
"DocType": "Standard",
"CANCELED": "N",
"DocStatus": "Open",
"InvntSttus": "Pending",
"Transfered": "N",
"ObjType": "INV",
"DocDate": "2025-07-17",
"DocDueDate": "2025-07-31",
"CardCode": "C001",
"CardName": "Client Name",
"Address": "123 Main Street",
"NumAtCard": "INV-2025-01",
"VatPercent": "18",
"VatSum": 180,
"DiscPrcnt": 5,
"DiscSum": 100,
"DocCur": "INR",
"DocRate": 3,
"DocTotal": 1180,
"PaidToDate": 200,
"Ref1": "REF-1",
"Ref2": "REF-2",
"Comments": "Urgent delivery requested.",
"JrnlMemo": "Sales Order Memo",
"SubStr": "Custom",
"ReqName": "John Doe",
"Branch": "Delhi",
"Department": "Sales",
"items": [
{
"DocEntry": "DOC001",
"ItemCode": "ITEM001",
"LineNum": "1",
"TargetType": "INV",
"TrgetEntry": "TRG001",
"BaseRef": "BR001",
"BaseType": "ORDR",
"BaseEntry": "DOC1001",
"BaseLine": "1",
"LineStatus": "13",
"Dscription": "Product 1",
"Quantity": 2,
"ShipDate": "2025-07-20",
"OpenQty": 2,
"Price": 500,
"Currency": "INR",
"Rate": 1,
"DiscPrcnt": 5,
"LineTotal": 950,
"OpenSum": 950,
"VendorNum": "V001",
"WhsCode": "W001",
"SlpCode": "SLP001",
"TreeType": "N",
"AcctCode": "AC001",
"PriceBefDi": 1000,
"DocDate": "2025-07-17",
"UseBaseUn": "Y",
"SubCatNum": "SC001",
"OcrCode": "OC001",
"Project": "P001",
"PriceAfVAT": 1180,
"VatSum": 180,
"VatSumFrgn": 3,
"VatSumSy": 4,
"FinncPriod": "202507",
"ObjType": "INV",
"Address": "123 Main Street",
"TaxCode": "GST18",
"TaxType": "O.45",
"BaseQty": 2,
"BaseOpnQty": 2,
"unitMsr": "Nos",
"NumPerMsr": 2,
"StockPrice": 500,
"ShipToCode": "SHIP001",
"ShipToDesc": "Client Warehouse",
"ActDelDate": "2025-07-21",
"OcrCode2": "OC002",
"OcrCode3": "OC003",
"LocCode": "LOC001",
"unitMsr2": "Nos",
"UomEntry": "UOM01",
"UomCode": "NOS",
"ExpType": "Direct",
"ItmTaxType": "GST",
"SacEntry": "SAC001",
"HsnEntry": "HSN001"
},
{
"DocEntry": "DOC002",
"ItemCode": "ITEM002",
"LineNum": "2",
"TargetType": "INV",
"TrgetEntry": "TRG002",
"BaseRef": "BR002",
"BaseType": "ORDR",
"BaseEntry": "DOC1001",
"BaseLine": "2",
"LineStatus": "12",
"Dscription": "Product 2",
"Quantity": 1,
"ShipDate": "2025-07-22",
"OpenQty": 1,
"Price": 200,
"Currency": "INR",
"Rate": 1,
"DiscPrcnt": 0,
"LineTotal": 200,
"OpenSum": 200,
"VendorNum": "V002",
"WhsCode": "W002",
"SlpCode": "SLP002",
"TreeType": "N",
"AcctCode": "AC002",
"PriceBefDi": 200,
"DocDate": "2025-07-17",
"UseBaseUn": "Y",
"SubCatNum": "SC002",
"OcrCode": "OC004",
"Project": "P002",
"PriceAfVAT": 236,
"VatSum": 36,
"VatSumFrgn": 6,
"VatSumSy": 7,
"FinncPriod": "202507",
"ObjType": "INV",
"Address": "456 Client Street",
"TaxCode": "GST18",
"TaxType": "0.23",
"BaseQty": 1,
"BaseOpnQty": 1,
"unitMsr": "Nos",
"NumPerMsr": 1,
"StockPrice": 200,
"ShipToCode": "SHIP002",
"ShipToDesc": "Client Office",
"ActDelDate": "2025-07-23",
"OcrCode2": "OC005",
"OcrCode3": "OC006",
"LocCode": "LOC002",
"unitMsr2": "Nos",
"UomEntry": "UOM02",
"UomCode": "NOS",
"ExpType": "Direct",
"ItmTaxType": "GST",
"SacEntry": "SAC002",
"HsnEntry": "HSN002"
}
]
}
{ "DocEntry": "DOC1001", "DocNum": 50001, "DocType": "Standard", }{ "DocEntry": "DOC1001", "DocNum": 50001, "DocType": "Standard", "CANCELED": "N", "DocStatus": "Open", "InvntSttus": "Pending", "Transfered": "N", "ObjType": "INV", "DocDate": "2025-07-17", "DocDueDate": "2025-07-31", "CardCode": "C001", "CardName": "Client Name", "Address": "123 Main Street", "NumAtCard": "INV-2025-01", "VatPercent": "18", "VatSum": 180, "DiscPrcnt": 5, "DiscSum": 100, "DocCur": "INR", "DocRate": 3, "DocTotal": 1180, "PaidToDate": 200, "Ref1": "REF-1", "Ref2": "REF-2", "Comments": "Urgent delivery requested.", "JrnlMemo": "Sales Order Memo", "SubStr": "Custom", "ReqName": "John Doe", "Branch": "Delhi", "Department": "Sales", "items": [ { "DocEntry": "DOC001", "ItemCode": "ITEM001", "LineNum": "1", "TargetType": "INV", "TrgetEntry": "TRG001", "BaseRef": "BR001", "BaseType": "ORDR", "BaseEntry": "DOC1001", "BaseLine": "1", "LineStatus": "13", "Dscription": "Product 1", "Quantity": 2, "ShipDate": "2025-07-20", "OpenQty": 2, "Price": 500, "Currency": "INR", "Rate": 1, "DiscPrcnt": 5, "LineTotal": 950, "OpenSum": 950, "VendorNum": "V001", "WhsCode": "W001", "SlpCode": "SLP001", "TreeType": "N", "AcctCode": "AC001", "PriceBefDi": 1000, "DocDate": "2025-07-17", "UseBaseUn": "Y", "SubCatNum": "SC001", "OcrCode": "OC001", "Project": "P001", "PriceAfVAT": 1180, "VatSum": 180, "VatSumFrgn": 3, "VatSumSy": 4, "FinncPriod": "202507", "ObjType": "INV", "Address": "123 Main Street", "TaxCode": "GST18", "TaxType": "O.45", "BaseQty": 2, "BaseOpnQty": 2, "unitMsr": "Nos", "NumPerMsr": 2, "StockPrice": 500, "ShipToCode": "SHIP001", "ShipToDesc": "Client Warehouse", "ActDelDate": "2025-07-21", "OcrCode2": "OC002", "OcrCode3": "OC003", "LocCode": "LOC001", "unitMsr2": "Nos", "UomEntry": "UOM01", "UomCode": "NOS", "ExpType": "Direct", "ItmTaxType": "GST", "SacEntry": "SAC001", "HsnEntry": "HSN001" }, { "DocEntry": "DOC002", "ItemCode": "ITEM002", "LineNum": "2", "TargetType": "INV", "TrgetEntry": "TRG002", "BaseRef": "BR002", "BaseType": "ORDR", "BaseEntry": "DOC1001", "BaseLine": "2", "LineStatus": "12", "Dscription": "Product 2", "Quantity": 1, "ShipDate": "2025-07-22", "OpenQty": 1, "Price": 200, "Currency": "INR", "Rate": 1, "DiscPrcnt": 0, "LineTotal": 200, "OpenSum": 200, "VendorNum": "V002", "WhsCode": "W002", "SlpCode": "SLP002", "TreeType": "N", "AcctCode": "AC002", "PriceBefDi": 200, "DocDate": "2025-07-17", "UseBaseUn": "Y", "SubCatNum": "SC002", "OcrCode": "OC004", "Project": "P002", "PriceAfVAT": 236, "VatSum": 36, "VatSumFrgn": 6, "VatSumSy": 7, "FinncPriod": "202507", "ObjType": "INV", "Address": "456 Client Street", "TaxCode": "GST18", "TaxType": "0.23", "BaseQty": 1, "BaseOpnQty": 1, "unitMsr": "Nos", "NumPerMsr": 1, "StockPrice": 200, "ShipToCode": "SHIP002", "ShipToDesc": "Client Office", "ActDelDate": "2025-07-23", "OcrCode2": "OC005", "OcrCode3": "OC006", "LocCode": "LOC002", "unitMsr2": "Nos", "UomEntry": "UOM02", "UomCode": "NOS", "ExpType": "Direct", "ItmTaxType": "GST", "SacEntry": "SAC002", "HsnEntry": "HSN002" } ] }
Success Response 4 fields
{
"success": true,
"message": "AR Invoice stored successfully!",
"timestamp": "2025-08-07 16:21:20",
"DocEntry": "DOC1001"
}
{ "success": true, "message": "AR Invoice stored successfully!", "timestamp": "2025-08-07 16:21:20", }{ "success": true, "message": "AR Invoice stored successfully!", "timestamp": "2025-08-07 16:21:20", "DocEntry": "DOC1001" }
Error Response 5 fields
{
"success": false,
"error": "Validation failed.",
"message": "The provided data is invalid.",
"timestamp": "2025-07-23 12:18:53",
"errors": {
"DocEntry": [
"DocEntry is required."
],
"DocNum": [
"DocNum is required."
],
"items": [
"At least one item is required."
]
}
}
{ "success": false, "error": "Validation failed.", "message": "The provided data is invalid.", }{ "success": false, "error": "Validation failed.", "message": "The provided data is invalid.", "timestamp": "2025-07-23 12:18:53", "errors": { "DocEntry": [ "DocEntry is required." ], "DocNum": [ "DocNum is required." ], "items": [ "At least one item is required." ] } }
cURL Example
curl -X POST \
https://devconnect.aumtics.com/api/v1/sap/ar-invoice \
-H 'Authorization: Bearer {access_token}' \
-d '{
"DocEntry": "DOC1001",
"DocNum": 50001,
"DocType": "Standard",
"CANCELED": "N",
"DocStatus": "Open",
"InvntSttus": "Pending",
"Transfered": "N",
"ObjType": "INV",
"DocDate": "2025-07-17",
"DocDueDate": "2025-07-31",
"CardCode": "C001",
"CardName": "Client Name",
"Address": "123 Main Street",
"NumAtCard": "INV-2025-01",
"VatPercent": "18",
"VatSum": 180,
"DiscPrcnt": 5,
"DiscSum": 100,
"DocCur": "INR",
"DocRate": 3,
"DocTotal": 1180,
"PaidToDate": 200,
"Ref1": "REF-1",
"Ref2": "REF-2",
"Comments": "Urgent delivery requested.",
"JrnlMemo": "Sales Order Memo",
"SubStr": "Custom",
"ReqName": "John Doe",
"Branch": "Delhi",
"Department": "Sales",
"items": [
{
"DocEntry": "DOC001",
"ItemCode": "ITEM001",
"LineNum": "1",
"TargetType": "INV",
"TrgetEntry": "TRG001",
"BaseRef": "BR001",
"BaseType": "ORDR",
"BaseEntry": "DOC1001",
"BaseLine": "1",
"LineStatus": "13",
"Dscription": "Product 1",
"Quantity": 2,
"ShipDate": "2025-07-20",
"OpenQty": 2,
"Price": 500,
"Currency": "INR",
"Rate": 1,
"DiscPrcnt": 5,
"LineTotal": 950,
"OpenSum": 950,
"VendorNum": "V001",
"WhsCode": "W001",
"SlpCode": "SLP001",
"TreeType": "N",
"AcctCode": "AC001",
"PriceBefDi": 1000,
"DocDate": "2025-07-17",
"UseBaseUn": "Y",
"SubCatNum": "SC001",
"OcrCode": "OC001",
"Project": "P001",
"PriceAfVAT": 1180,
"VatSum": 180,
"VatSumFrgn": 3,
"VatSumSy": 4,
"FinncPriod": "202507",
"ObjType": "INV",
"Address": "123 Main Street",
"TaxCode": "GST18",
"TaxType": "O.45",
"BaseQty": 2,
"BaseOpnQty": 2,
"unitMsr": "Nos",
"NumPerMsr": 2,
"StockPrice": 500,
"ShipToCode": "SHIP001",
"ShipToDesc": "Client Warehouse",
"ActDelDate": "2025-07-21",
"OcrCode2": "OC002",
"OcrCode3": "OC003",
"LocCode": "LOC001",
"unitMsr2": "Nos",
"UomEntry": "UOM01",
"UomCode": "NOS",
"ExpType": "Direct",
"ItmTaxType": "GST",
"SacEntry": "SAC001",
"HsnEntry": "HSN001"
},
{
"DocEntry": "DOC002",
"ItemCode": "ITEM002",
"LineNum": "2",
"TargetType": "INV",
"TrgetEntry": "TRG002",
"BaseRef": "BR002",
"BaseType": "ORDR",
"BaseEntry": "DOC1001",
"BaseLine": "2",
"LineStatus": "12",
"Dscription": "Product 2",
"Quantity": 1,
"ShipDate": "2025-07-22",
"OpenQty": 1,
"Price": 200,
"Currency": "INR",
"Rate": 1,
"DiscPrcnt": 0,
"LineTotal": 200,
"OpenSum": 200,
"VendorNum": "V002",
"WhsCode": "W002",
"SlpCode": "SLP002",
"TreeType": "N",
"AcctCode": "AC002",
"PriceBefDi": 200,
"DocDate": "2025-07-17",
"UseBaseUn": "Y",
"SubCatNum": "SC002",
"OcrCode": "OC004",
"Project": "P002",
"PriceAfVAT": 236,
"VatSum": 36,
"VatSumFrgn": 6,
"VatSumSy": 7,
"FinncPriod": "202507",
"ObjType": "INV",
"Address": "456 Client Street",
"TaxCode": "GST18",
"TaxType": "0.23",
"BaseQty": 1,
"BaseOpnQty": 1,
"unitMsr": "Nos",
"NumPerMsr": 1,
"StockPrice": 200,
"ShipToCode": "SHIP002",
"ShipToDesc": "Client Office",
"ActDelDate": "2025-07-23",
"OcrCode2": "OC005",
"OcrCode3": "OC006",
"LocCode": "LOC002",
"unitMsr2": "Nos",
"UomEntry": "UOM02",
"UomCode": "NOS",
"ExpType": "Direct",
"ItmTaxType": "GST",
"SacEntry": "SAC002",
"HsnEntry": "HSN002"
}
]
}'
curl -X POST \ https://devconnect.aumtics.com/api/v1/sap/ar-invoice \ -H 'Authorization: Bearer {access_token}' \ -d '{ "DocEntry": "DOC1001", "DocNum": 50001, "DocType": "Standard", "CANCELED": "N", "DocStatus": "Open", "InvntSttus": "Pending", "Transfered": "N", "ObjType": "INV", "DocDate": "2025-07-17", "DocDueDate": "2025-07-31", "CardCode": "C001", "CardName": "Client Name", "Address": "123 Main Street", "NumAtCard": "INV-2025-01", "VatPercent": "18", "VatSum": 180, "DiscPrcnt": 5, "DiscSum": 100, "DocCur": "INR", "DocRate": 3, "DocTotal": 1180, "PaidToDate": 200, "Ref1": "REF-1", "Ref2": "REF-2", "Comments": "Urgent delivery requested.", "JrnlMemo": "Sales Order Memo", "SubStr": "Custom", "ReqName": "John Doe", "Branch": "Delhi", "Department": "Sales", "items": [ { "DocEntry": "DOC001", "ItemCode": "ITEM001", "LineNum": "1", "TargetType": "INV", "TrgetEntry": "TRG001", "BaseRef": "BR001", "BaseType": "ORDR", "BaseEntry": "DOC1001", "BaseLine": "1", "LineStatus": "13", "Dscription": "Product 1", "Quantity": 2, "ShipDate": "2025-07-20", "OpenQty": 2, "Price": 500, "Currency": "INR", "Rate": 1, "DiscPrcnt": 5, "LineTotal": 950, "OpenSum": 950, "VendorNum": "V001", "WhsCode": "W001", "SlpCode": "SLP001", "TreeType": "N", "AcctCode": "AC001", "PriceBefDi": 1000, "DocDate": "2025-07-17", "UseBaseUn": "Y", "SubCatNum": "SC001", "OcrCode": "OC001", "Project": "P001", "PriceAfVAT": 1180, "VatSum": 180, "VatSumFrgn": 3, "VatSumSy": 4, "FinncPriod": "202507", "ObjType": "INV", "Address": "123 Main Street", "TaxCode": "GST18", "TaxType": "O.45", "BaseQty": 2, "BaseOpnQty": 2, "unitMsr": "Nos", "NumPerMsr": 2, "StockPrice": 500, "ShipToCode": "SHIP001", "ShipToDesc": "Client Warehouse", "ActDelDate": "2025-07-21", "OcrCode2": "OC002", "OcrCode3": "OC003", "LocCode": "LOC001", "unitMsr2": "Nos", "UomEntry": "UOM01", "UomCode": "NOS", "ExpType": "Direct", "ItmTaxType": "GST", "SacEntry": "SAC001", "HsnEntry": "HSN001" }, { "DocEntry": "DOC002", "ItemCode": "ITEM002", "LineNum": "2", "TargetType": "INV", "TrgetEntry": "TRG002", "BaseRef": "BR002", "BaseType": "ORDR", "BaseEntry": "DOC1001", "BaseLine": "2", "LineStatus": "12", "Dscription": "Product 2", "Quantity": 1, "ShipDate": "2025-07-22", "OpenQty": 1, "Price": 200, "Currency": "INR", "Rate": 1, "DiscPrcnt": 0, "LineTotal": 200, "OpenSum": 200, "VendorNum": "V002", "WhsCode": "W002", "SlpCode": "SLP002", "TreeType": "N", "AcctCode": "AC002", "PriceBefDi": 200, "DocDate": "2025-07-17", "UseBaseUn": "Y", "SubCatNum": "SC002", "OcrCode": "OC004", "Project": "P002", "PriceAfVAT": 236, "VatSum": 36, "VatSumFrgn": 6, "VatSumSy": 7, "FinncPriod": "202507", "ObjType": "INV", "Address": "456 Client Street", "TaxCode": "GST18", "TaxType": "0.23", "BaseQty": 1, "BaseOpnQty": 1, "unitMsr": "Nos", "NumPerMsr": 1, "StockPrice": 200, "ShipToCode": "SHIP002", "ShipToDesc": "Client Office", "ActDelDate": "2025-07-23", "OcrCode2": "OC005", "OcrCode3": "OC006", "LocCode": "LOC002", "unitMsr2": "Nos", "UomEntry": "UOM02", "UomCode": "NOS", "ExpType": "Direct", "ItmTaxType": "GST", "SacEntry": "SAC002", "HsnEntry": "HSN002" } ] }'
Production Order APIs
Create or update production orders in Prime.
1
Endpoint
Production Order APIs
Create or update production orders in Prime.
Method
Endpoint
Description
POST
/sap/production-order
Create/Update Production Order
1. Create/Update Production Order
/sap/production-order
Purpose: This API is used to create or update Production Order in the Prime.
Usage: You must call this API after successfully authenticating and receiving an
Usage: You must call this API after successfully authenticating and receiving an
access_token. It allows your application to push new Production order into Prime from SAP.Endpoint
https://devconnect.aumtics.com/api/v1/sap/production-order
https://devconnect.aumtics.com/api/v1/sap/production-order
Headers
{
"Authorization": "Bearer {access_token}"
}
{ "Authorization": "Bearer {access_token}" }{ "Authorization": "Bearer {access_token}" }
Request Body 45 fields
{
"DocEntry": "DOC021",
"DocNum": "5001",
"Series": "A1",
"ItemCode": "ITEM123",
"Status": "Open",
"Type": "Standard",
"PlannedQty": 10,
"CmpltQty": 5,
"RjctQty": 5,
"PostDate": "2025-07-15",
"DueDate": "2025-07-20",
"OriginAbs": "ORG001",
"OriginNum": "123456",
"OriginType": "TypeA",
"UserSign": "USR001",
"Comments": "This is a test comment.",
"CloseDate": "2025-07-21",
"RlsDate": "2025-07-10",
"CardCode": "16A039",
"Warehouse": "WH001",
"Uom": "KG",
"LineDirty": "N",
"JrnlMemo": "Memo Text",
"TransId": "T001",
"CreateDate": "2025-07-01",
"Printed": "Y",
"PIndicator": "P1",
"SeriesStr": "S1",
"SubStr": "SUB",
"Project": "PRJ100",
"UomEntry": "UE1",
"PickRmrk": "Pick this",
"SysCloseDt": "2025-07-30",
"SysCloseTm": "18:30",
"CloseVerNm": "v1.2",
"StartDate": "2025-07-01",
"ObjType": "OT123",
"ProdName": "Demo Product",
"Priority": "High",
"RouDatCalc": "RDC",
"UpdAlloc": "Yes",
"CreateTS": "2025-07-01",
"UpdateTS": "2025-07-15",
"VersionNum": "v1.0",
"items": [
{
"DocEntry": "DOC01",
"ItemCode": "ITEM01",
"BaseEntry": "DOC021",
"LineNum": "1",
"BaseQty": 10,
"PlannedQty": 5,
"IssuedQty": 3,
"IssueType": "Manual",
"wareHouse": "WH001",
"VisOrder": "1",
"WipActCode": "WIP001",
"CompTotal": 100.5,
"LocCode": "LOC123",
"Project": "PRJ100",
"UomEntry": "UE1",
"UomCode": "KG",
"ItemType": "Raw",
"AdditQty": "2",
"LineText": "Line description",
"ReleaseQty": "1",
"ResAlloc": "N",
"StartDate": "2025-07-15",
"EndDate": "2025-07-20",
"StageId": "STG1",
"BaseQtyNum": "10",
"BaseQtyDen": "1",
"ReqDays": "5",
"RtCalcProp": "Auto",
"Status": "Planned"
},
{
"DocEntry": "DOC02",
"ItemCode": "ITEM02",
"BaseEntry": "DOC021",
"LineNum": "1",
"BaseQty": 10,
"PlannedQty": 5,
"IssuedQty": 3,
"IssueType": "Manual",
"wareHouse": "WH001",
"VisOrder": "1",
"WipActCode": "WIP001",
"CompTotal": 100.5,
"LocCode": "LOC123",
"Project": "PRJ100",
"UomEntry": "UE1",
"UomCode": "KG",
"ItemType": "Raw",
"AdditQty": "2",
"LineText": "Line description",
"ReleaseQty": "1",
"ResAlloc": "N",
"StartDate": "2025-07-15",
"EndDate": "2025-07-20",
"StageId": "STG1",
"BaseQtyNum": "10",
"BaseQtyDen": "1",
"ReqDays": "5",
"RtCalcProp": "Auto",
"Status": "Planned"
},
{
"DocEntry": "DOC03",
"ItemCode": "ITEM02",
"BaseEntry": "DOC021",
"LineNum": "1",
"BaseQty": 10,
"PlannedQty": 5,
"IssuedQty": 3,
"IssueType": "Manual",
"wareHouse": "WH001",
"VisOrder": "1",
"WipActCode": "WIP001",
"CompTotal": 100.5,
"LocCode": "LOC123",
"Project": "PRJ100",
"UomEntry": "UE1",
"UomCode": "KG",
"ItemType": "Raw",
"AdditQty": "2",
"LineText": "Line description",
"ReleaseQty": "1",
"ResAlloc": "N",
"StartDate": "2025-07-15",
"EndDate": "2025-07-20",
"StageId": "STG1",
"BaseQtyNum": "10",
"BaseQtyDen": "1",
"ReqDays": "5",
"RtCalcProp": "Auto",
"Status": "Planned"
}
]
}
{ "DocEntry": "DOC021", "DocNum": "5001", "Series": "A1", }{ "DocEntry": "DOC021", "DocNum": "5001", "Series": "A1", "ItemCode": "ITEM123", "Status": "Open", "Type": "Standard", "PlannedQty": 10, "CmpltQty": 5, "RjctQty": 5, "PostDate": "2025-07-15", "DueDate": "2025-07-20", "OriginAbs": "ORG001", "OriginNum": "123456", "OriginType": "TypeA", "UserSign": "USR001", "Comments": "This is a test comment.", "CloseDate": "2025-07-21", "RlsDate": "2025-07-10", "CardCode": "16A039", "Warehouse": "WH001", "Uom": "KG", "LineDirty": "N", "JrnlMemo": "Memo Text", "TransId": "T001", "CreateDate": "2025-07-01", "Printed": "Y", "PIndicator": "P1", "SeriesStr": "S1", "SubStr": "SUB", "Project": "PRJ100", "UomEntry": "UE1", "PickRmrk": "Pick this", "SysCloseDt": "2025-07-30", "SysCloseTm": "18:30", "CloseVerNm": "v1.2", "StartDate": "2025-07-01", "ObjType": "OT123", "ProdName": "Demo Product", "Priority": "High", "RouDatCalc": "RDC", "UpdAlloc": "Yes", "CreateTS": "2025-07-01", "UpdateTS": "2025-07-15", "VersionNum": "v1.0", "items": [ { "DocEntry": "DOC01", "ItemCode": "ITEM01", "BaseEntry": "DOC021", "LineNum": "1", "BaseQty": 10, "PlannedQty": 5, "IssuedQty": 3, "IssueType": "Manual", "wareHouse": "WH001", "VisOrder": "1", "WipActCode": "WIP001", "CompTotal": 100.5, "LocCode": "LOC123", "Project": "PRJ100", "UomEntry": "UE1", "UomCode": "KG", "ItemType": "Raw", "AdditQty": "2", "LineText": "Line description", "ReleaseQty": "1", "ResAlloc": "N", "StartDate": "2025-07-15", "EndDate": "2025-07-20", "StageId": "STG1", "BaseQtyNum": "10", "BaseQtyDen": "1", "ReqDays": "5", "RtCalcProp": "Auto", "Status": "Planned" }, { "DocEntry": "DOC02", "ItemCode": "ITEM02", "BaseEntry": "DOC021", "LineNum": "1", "BaseQty": 10, "PlannedQty": 5, "IssuedQty": 3, "IssueType": "Manual", "wareHouse": "WH001", "VisOrder": "1", "WipActCode": "WIP001", "CompTotal": 100.5, "LocCode": "LOC123", "Project": "PRJ100", "UomEntry": "UE1", "UomCode": "KG", "ItemType": "Raw", "AdditQty": "2", "LineText": "Line description", "ReleaseQty": "1", "ResAlloc": "N", "StartDate": "2025-07-15", "EndDate": "2025-07-20", "StageId": "STG1", "BaseQtyNum": "10", "BaseQtyDen": "1", "ReqDays": "5", "RtCalcProp": "Auto", "Status": "Planned" }, { "DocEntry": "DOC03", "ItemCode": "ITEM02", "BaseEntry": "DOC021", "LineNum": "1", "BaseQty": 10, "PlannedQty": 5, "IssuedQty": 3, "IssueType": "Manual", "wareHouse": "WH001", "VisOrder": "1", "WipActCode": "WIP001", "CompTotal": 100.5, "LocCode": "LOC123", "Project": "PRJ100", "UomEntry": "UE1", "UomCode": "KG", "ItemType": "Raw", "AdditQty": "2", "LineText": "Line description", "ReleaseQty": "1", "ResAlloc": "N", "StartDate": "2025-07-15", "EndDate": "2025-07-20", "StageId": "STG1", "BaseQtyNum": "10", "BaseQtyDen": "1", "ReqDays": "5", "RtCalcProp": "Auto", "Status": "Planned" } ] }
Success Response 4 fields
{
"success": true,
"message": "Production Order created successfully!",
"timestamp": "2025-08-07 16:21:20",
"DocEntry": "DOC021"
}
{ "success": true, "message": "Production Order created successfully!", "timestamp": "2025-08-07 16:21:20", }{ "success": true, "message": "Production Order created successfully!", "timestamp": "2025-08-07 16:21:20", "DocEntry": "DOC021" }
Error Response 5 fields
{
"success": false,
"error": "Validation failed.",
"message": "The provided data is invalid.",
"timestamp": "2025-07-23 12:18:53",
"errors": {
"DocEntry": [
"DocEntry is required."
],
"DocNum": [
"DocNum is required."
],
"items": [
"At least one item is required."
]
}
}
{ "success": false, "error": "Validation failed.", "message": "The provided data is invalid.", }{ "success": false, "error": "Validation failed.", "message": "The provided data is invalid.", "timestamp": "2025-07-23 12:18:53", "errors": { "DocEntry": [ "DocEntry is required." ], "DocNum": [ "DocNum is required." ], "items": [ "At least one item is required." ] } }
cURL Example
curl -X POST \
https://devconnect.aumtics.com/api/v1/sap/production-order \
-H 'Authorization: Bearer {access_token}' \
-d '{
"DocEntry": "DOC021",
"DocNum": "5001",
"Series": "A1",
"ItemCode": "ITEM123",
"Status": "Open",
"Type": "Standard",
"PlannedQty": 10,
"CmpltQty": 5,
"RjctQty": 5,
"PostDate": "2025-07-15",
"DueDate": "2025-07-20",
"OriginAbs": "ORG001",
"OriginNum": "123456",
"OriginType": "TypeA",
"UserSign": "USR001",
"Comments": "This is a test comment.",
"CloseDate": "2025-07-21",
"RlsDate": "2025-07-10",
"CardCode": "16A039",
"Warehouse": "WH001",
"Uom": "KG",
"LineDirty": "N",
"JrnlMemo": "Memo Text",
"TransId": "T001",
"CreateDate": "2025-07-01",
"Printed": "Y",
"PIndicator": "P1",
"SeriesStr": "S1",
"SubStr": "SUB",
"Project": "PRJ100",
"UomEntry": "UE1",
"PickRmrk": "Pick this",
"SysCloseDt": "2025-07-30",
"SysCloseTm": "18:30",
"CloseVerNm": "v1.2",
"StartDate": "2025-07-01",
"ObjType": "OT123",
"ProdName": "Demo Product",
"Priority": "High",
"RouDatCalc": "RDC",
"UpdAlloc": "Yes",
"CreateTS": "2025-07-01",
"UpdateTS": "2025-07-15",
"VersionNum": "v1.0",
"items": [
{
"DocEntry": "DOC01",
"ItemCode": "ITEM01",
"BaseEntry": "DOC021",
"LineNum": "1",
"BaseQty": 10,
"PlannedQty": 5,
"IssuedQty": 3,
"IssueType": "Manual",
"wareHouse": "WH001",
"VisOrder": "1",
"WipActCode": "WIP001",
"CompTotal": 100.5,
"LocCode": "LOC123",
"Project": "PRJ100",
"UomEntry": "UE1",
"UomCode": "KG",
"ItemType": "Raw",
"AdditQty": "2",
"LineText": "Line description",
"ReleaseQty": "1",
"ResAlloc": "N",
"StartDate": "2025-07-15",
"EndDate": "2025-07-20",
"StageId": "STG1",
"BaseQtyNum": "10",
"BaseQtyDen": "1",
"ReqDays": "5",
"RtCalcProp": "Auto",
"Status": "Planned"
},
{
"DocEntry": "DOC02",
"ItemCode": "ITEM02",
"BaseEntry": "DOC021",
"LineNum": "1",
"BaseQty": 10,
"PlannedQty": 5,
"IssuedQty": 3,
"IssueType": "Manual",
"wareHouse": "WH001",
"VisOrder": "1",
"WipActCode": "WIP001",
"CompTotal": 100.5,
"LocCode": "LOC123",
"Project": "PRJ100",
"UomEntry": "UE1",
"UomCode": "KG",
"ItemType": "Raw",
"AdditQty": "2",
"LineText": "Line description",
"ReleaseQty": "1",
"ResAlloc": "N",
"StartDate": "2025-07-15",
"EndDate": "2025-07-20",
"StageId": "STG1",
"BaseQtyNum": "10",
"BaseQtyDen": "1",
"ReqDays": "5",
"RtCalcProp": "Auto",
"Status": "Planned"
},
{
"DocEntry": "DOC03",
"ItemCode": "ITEM02",
"BaseEntry": "DOC021",
"LineNum": "1",
"BaseQty": 10,
"PlannedQty": 5,
"IssuedQty": 3,
"IssueType": "Manual",
"wareHouse": "WH001",
"VisOrder": "1",
"WipActCode": "WIP001",
"CompTotal": 100.5,
"LocCode": "LOC123",
"Project": "PRJ100",
"UomEntry": "UE1",
"UomCode": "KG",
"ItemType": "Raw",
"AdditQty": "2",
"LineText": "Line description",
"ReleaseQty": "1",
"ResAlloc": "N",
"StartDate": "2025-07-15",
"EndDate": "2025-07-20",
"StageId": "STG1",
"BaseQtyNum": "10",
"BaseQtyDen": "1",
"ReqDays": "5",
"RtCalcProp": "Auto",
"Status": "Planned"
}
]
}'
curl -X POST \ https://devconnect.aumtics.com/api/v1/sap/production-order \ -H 'Authorization: Bearer {access_token}' \ -d '{ "DocEntry": "DOC021", "DocNum": "5001", "Series": "A1", "ItemCode": "ITEM123", "Status": "Open", "Type": "Standard", "PlannedQty": 10, "CmpltQty": 5, "RjctQty": 5, "PostDate": "2025-07-15", "DueDate": "2025-07-20", "OriginAbs": "ORG001", "OriginNum": "123456", "OriginType": "TypeA", "UserSign": "USR001", "Comments": "This is a test comment.", "CloseDate": "2025-07-21", "RlsDate": "2025-07-10", "CardCode": "16A039", "Warehouse": "WH001", "Uom": "KG", "LineDirty": "N", "JrnlMemo": "Memo Text", "TransId": "T001", "CreateDate": "2025-07-01", "Printed": "Y", "PIndicator": "P1", "SeriesStr": "S1", "SubStr": "SUB", "Project": "PRJ100", "UomEntry": "UE1", "PickRmrk": "Pick this", "SysCloseDt": "2025-07-30", "SysCloseTm": "18:30", "CloseVerNm": "v1.2", "StartDate": "2025-07-01", "ObjType": "OT123", "ProdName": "Demo Product", "Priority": "High", "RouDatCalc": "RDC", "UpdAlloc": "Yes", "CreateTS": "2025-07-01", "UpdateTS": "2025-07-15", "VersionNum": "v1.0", "items": [ { "DocEntry": "DOC01", "ItemCode": "ITEM01", "BaseEntry": "DOC021", "LineNum": "1", "BaseQty": 10, "PlannedQty": 5, "IssuedQty": 3, "IssueType": "Manual", "wareHouse": "WH001", "VisOrder": "1", "WipActCode": "WIP001", "CompTotal": 100.5, "LocCode": "LOC123", "Project": "PRJ100", "UomEntry": "UE1", "UomCode": "KG", "ItemType": "Raw", "AdditQty": "2", "LineText": "Line description", "ReleaseQty": "1", "ResAlloc": "N", "StartDate": "2025-07-15", "EndDate": "2025-07-20", "StageId": "STG1", "BaseQtyNum": "10", "BaseQtyDen": "1", "ReqDays": "5", "RtCalcProp": "Auto", "Status": "Planned" }, { "DocEntry": "DOC02", "ItemCode": "ITEM02", "BaseEntry": "DOC021", "LineNum": "1", "BaseQty": 10, "PlannedQty": 5, "IssuedQty": 3, "IssueType": "Manual", "wareHouse": "WH001", "VisOrder": "1", "WipActCode": "WIP001", "CompTotal": 100.5, "LocCode": "LOC123", "Project": "PRJ100", "UomEntry": "UE1", "UomCode": "KG", "ItemType": "Raw", "AdditQty": "2", "LineText": "Line description", "ReleaseQty": "1", "ResAlloc": "N", "StartDate": "2025-07-15", "EndDate": "2025-07-20", "StageId": "STG1", "BaseQtyNum": "10", "BaseQtyDen": "1", "ReqDays": "5", "RtCalcProp": "Auto", "Status": "Planned" }, { "DocEntry": "DOC03", "ItemCode": "ITEM02", "BaseEntry": "DOC021", "LineNum": "1", "BaseQty": 10, "PlannedQty": 5, "IssuedQty": 3, "IssueType": "Manual", "wareHouse": "WH001", "VisOrder": "1", "WipActCode": "WIP001", "CompTotal": 100.5, "LocCode": "LOC123", "Project": "PRJ100", "UomEntry": "UE1", "UomCode": "KG", "ItemType": "Raw", "AdditQty": "2", "LineText": "Line description", "ReleaseQty": "1", "ResAlloc": "N", "StartDate": "2025-07-15", "EndDate": "2025-07-20", "StageId": "STG1", "BaseQtyNum": "10", "BaseQtyDen": "1", "ReqDays": "5", "RtCalcProp": "Auto", "Status": "Planned" } ] }'
Masters APIs
Create or update client, vendor, item master and BOM records in Prime.
4
Endpoints
Masters APIs
Create or update client, vendor, item master and BOM records in Prime.
Method
Endpoint
Description
POST
/sap/client
Create/Update Client
1. Create/Update Client
/sap/client
Purpose: This API is used to create or update a Client (customer) master in the Prime.
Usage: You must call this API after successfully authenticating and receiving an
Required fields:
Note:
Usage: You must call this API after successfully authenticating and receiving an
access_token. It allows your application to push client master records into Prime from your ERP.Required fields:
erp_id, name.Note:
erp_id is the unique key – sending an erp_id that already exists will update that client instead of creating a new one. status accepts Active or Inactive. A duplicate erp_id is rejected with a 422 – if the same erp_id somehow exists on more than one record, clean up the duplicates before sending it again.Endpoint
https://devconnect.aumtics.com/api/v1/sap/client
https://devconnect.aumtics.com/api/v1/sap/client
Headers
{
"Authorization": "Bearer {access_token}",
"Accept": "application/json",
"Content-Type": "application/json"
}
{ "Authorization": "Bearer {access_token}", "Accept": "application/json", "Content-Type": "application/json" }{ "Authorization": "Bearer {access_token}", "Accept": "application/json", "Content-Type": "application/json" }
Request Body 12 fields
{
"erp_id": "CUST-001",
"name": "Tata Motors Ltd",
"email": "procurement@tatamotors.com",
"mobile": "9876543210",
"website": "https://www.tatamotors.com",
"address": "Bombay House, 24 Homi Mody Street",
"city": "Mumbai",
"state": "Maharashtra",
"industry_type": "Automobile",
"business_type": "Manufacturing",
"sales_owner": "Ajeet Singh",
"status": "Active"
}
{ "erp_id": "CUST-001", "name": "Tata Motors Ltd", "email": "procurement@tatamotors.com", }{ "erp_id": "CUST-001", "name": "Tata Motors Ltd", "email": "procurement@tatamotors.com", "mobile": "9876543210", "website": "https://www.tatamotors.com", "address": "Bombay House, 24 Homi Mody Street", "city": "Mumbai", "state": "Maharashtra", "industry_type": "Automobile", "business_type": "Manufacturing", "sales_owner": "Ajeet Singh", "status": "Active" }
Success Response 5 fields
{
"success": true,
"status": "success",
"message": "Client created successfully!",
"timestamp": "2026-08-12 11:30:45",
"erp_id": "CUST-001"
}
{ "success": true, "status": "success", "message": "Client created successfully!", }{ "success": true, "status": "success", "message": "Client created successfully!", "timestamp": "2026-08-12 11:30:45", "erp_id": "CUST-001" }
Error Response 6 fields
{
"success": false,
"status": "failed",
"error": "Validation failed.",
"message": "The provided data is invalid.",
"timestamp": "2026-08-12 11:30:45",
"errors": {
"erp_id": [
"erp_id is required."
],
"name": [
"name is required."
]
}
}
{ "success": false, "status": "failed", "error": "Validation failed.", }{ "success": false, "status": "failed", "error": "Validation failed.", "message": "The provided data is invalid.", "timestamp": "2026-08-12 11:30:45", "errors": { "erp_id": [ "erp_id is required." ], "name": [ "name is required." ] } }
cURL Example
curl -X POST \
https://devconnect.aumtics.com/api/v1/sap/client \
-H 'Authorization: Bearer {access_token}' \
-H 'Accept: application/json' \
-H 'Content-Type: application/json' \
-d '{
"erp_id": "CUST-001",
"name": "Tata Motors Ltd",
"email": "procurement@tatamotors.com",
"mobile": "9876543210",
"website": "https://www.tatamotors.com",
"address": "Bombay House, 24 Homi Mody Street",
"city": "Mumbai",
"state": "Maharashtra",
"industry_type": "Automobile",
"business_type": "Manufacturing",
"sales_owner": "Ajeet Singh",
"status": "Active"
}'
curl -X POST \ https://devconnect.aumtics.com/api/v1/sap/client \ -H 'Authorization: Bearer {access_token}' \ -H 'Accept: application/json' \ -H 'Content-Type: application/json' \ -d '{ "erp_id": "CUST-001", "name": "Tata Motors Ltd", "email": "procurement@tatamotors.com", "mobile": "9876543210", "website": "https://www.tatamotors.com", "address": "Bombay House, 24 Homi Mody Street", "city": "Mumbai", "state": "Maharashtra", "industry_type": "Automobile", "business_type": "Manufacturing", "sales_owner": "Ajeet Singh", "status": "Active" }'
POST
/sap/vendor
Create/Update Vendor
2. Create/Update Vendor
/sap/vendor
Purpose: This API is used to create or update a Vendor (supplier) master in the Prime.
Usage: You must call this API after successfully authenticating and receiving an
Required fields:
Note:
Usage: You must call this API after successfully authenticating and receiving an
access_token. It allows your application to push vendor master records into Prime from your ERP.Required fields:
erp_id, name.Note:
erp_id is the unique key – sending an existing erp_id will update that vendor. status accepts Active or Inactive. A duplicate erp_id is rejected with a 422 – if the same erp_id somehow exists on more than one record, clean up the duplicates before sending it again.Endpoint
https://devconnect.aumtics.com/api/v1/sap/vendor
https://devconnect.aumtics.com/api/v1/sap/vendor
Headers
{
"Authorization": "Bearer {access_token}",
"Accept": "application/json",
"Content-Type": "application/json"
}
{ "Authorization": "Bearer {access_token}", "Accept": "application/json", "Content-Type": "application/json" }{ "Authorization": "Bearer {access_token}", "Accept": "application/json", "Content-Type": "application/json" }
Request Body 6 fields
{
"erp_id": "VEND-045",
"name": "Shree Steel Suppliers Pvt Ltd",
"email": "accounts@shreesteel.com",
"mobile": "9123456780",
"address": "Plot 14, MIDC Industrial Area, Pune",
"status": "Active"
}
{ "erp_id": "VEND-045", "name": "Shree Steel Suppliers Pvt Ltd", "email": "accounts@shreesteel.com", }{ "erp_id": "VEND-045", "name": "Shree Steel Suppliers Pvt Ltd", "email": "accounts@shreesteel.com", "mobile": "9123456780", "address": "Plot 14, MIDC Industrial Area, Pune", "status": "Active" }
Success Response 5 fields
{
"success": true,
"status": "success",
"message": "Vendor created successfully!",
"timestamp": "2026-08-12 11:30:45",
"erp_id": "VEND-045"
}
{ "success": true, "status": "success", "message": "Vendor created successfully!", }{ "success": true, "status": "success", "message": "Vendor created successfully!", "timestamp": "2026-08-12 11:30:45", "erp_id": "VEND-045" }
Error Response 6 fields
{
"success": false,
"status": "failed",
"error": "Validation failed.",
"message": "The provided data is invalid.",
"timestamp": "2026-08-12 11:30:45",
"errors": {
"erp_id": [
"erp_id is required."
],
"name": [
"name is required."
]
}
}
{ "success": false, "status": "failed", "error": "Validation failed.", }{ "success": false, "status": "failed", "error": "Validation failed.", "message": "The provided data is invalid.", "timestamp": "2026-08-12 11:30:45", "errors": { "erp_id": [ "erp_id is required." ], "name": [ "name is required." ] } }
cURL Example
curl -X POST \
https://devconnect.aumtics.com/api/v1/sap/vendor \
-H 'Authorization: Bearer {access_token}' \
-H 'Accept: application/json' \
-H 'Content-Type: application/json' \
-d '{
"erp_id": "VEND-045",
"name": "Shree Steel Suppliers Pvt Ltd",
"email": "accounts@shreesteel.com",
"mobile": "9123456780",
"address": "Plot 14, MIDC Industrial Area, Pune",
"status": "Active"
}'
curl -X POST \ https://devconnect.aumtics.com/api/v1/sap/vendor \ -H 'Authorization: Bearer {access_token}' \ -H 'Accept: application/json' \ -H 'Content-Type: application/json' \ -d '{ "erp_id": "VEND-045", "name": "Shree Steel Suppliers Pvt Ltd", "email": "accounts@shreesteel.com", "mobile": "9123456780", "address": "Plot 14, MIDC Industrial Area, Pune", "status": "Active" }'
POST
/sap/item-master
Create/Update Item Master
3. Create/Update Item Master
/sap/item-master
Purpose: This API is used to create or update an Item master in the Prime.
Usage: You must call this API after successfully authenticating and receiving an
Required fields:
Note: SAP keeps every item type in a single item table, so Finished Goods, Semi-Finished, Raw Material, BOP and Consumable items are all sent to this one endpoint. The item is classified as RM / BOP / Consumable afterwards on the basis of
Field rules:
Usage: You must call this API after successfully authenticating and receiving an
access_token. It allows your application to push item master records into Prime from your ERP.Required fields:
erp_id, name, item_group, part_no, unit, warehouse_code.Note: SAP keeps every item type in a single item table, so Finished Goods, Semi-Finished, Raw Material, BOP and Consumable items are all sent to this one endpoint. The item is classified as RM / BOP / Consumable afterwards on the basis of
item_group, so item_group must always be sent.erp_id is the unique key – sending an erp_id that already exists will update that item instead of creating a new one. A duplicate erp_id is rejected with a 422 – if the same erp_id somehow exists on more than one record, clean up the duplicates before sending it again.Field rules:
sku – optional, send the erp_id value if no separate SKU exists. unit – Pcs / Kg / Nos / Mtr / Ltr etc. assembly_part – send yes for Semi-Finished items and no for Finished Goods, Raw Material, BOP and Consumables. warehouse_code is the item's default warehouse. status – Active or Inactive; when it is not sent, no status is stored.Endpoint
https://devconnect.aumtics.com/api/v1/sap/item-master
https://devconnect.aumtics.com/api/v1/sap/item-master
Headers
{
"Authorization": "Bearer {access_token}",
"Accept": "application/json",
"Content-Type": "application/json"
}
{ "Authorization": "Bearer {access_token}", "Accept": "application/json", "Content-Type": "application/json" }{ "Authorization": "Bearer {access_token}", "Accept": "application/json", "Content-Type": "application/json" }
Request Body 13 fields
{
"erp_id": "ITEM-00001",
"name": "MS Flat 25x6 mm",
"item_group": "Raw Materials",
"part_no": "PART-0001",
"sku": "SKU-0001",
"unit": "Kg",
"hsn": "72111990",
"description": "Mild Steel Flat Bar, 25mm width, 6mm thickness",
"assembly_part": "no",
"manufacturer": "SAIL - Steel Authority of India",
"vendor": "Shree Steel Suppliers Pvt Ltd",
"warehouse_code": "RMSH",
"status": "Active"
}
{ "erp_id": "ITEM-00001", "name": "MS Flat 25x6 mm", "item_group": "Raw Materials", }{ "erp_id": "ITEM-00001", "name": "MS Flat 25x6 mm", "item_group": "Raw Materials", "part_no": "PART-0001", "sku": "SKU-0001", "unit": "Kg", "hsn": "72111990", "description": "Mild Steel Flat Bar, 25mm width, 6mm thickness", "assembly_part": "no", "manufacturer": "SAIL - Steel Authority of India", "vendor": "Shree Steel Suppliers Pvt Ltd", "warehouse_code": "RMSH", "status": "Active" }
Success Response 5 fields
{
"success": true,
"status": "success",
"message": "Item master created successfully!",
"timestamp": "2026-08-12 11:30:45",
"erp_id": "ITEM-00001"
}
{ "success": true, "status": "success", "message": "Item master created successfully!", }{ "success": true, "status": "success", "message": "Item master created successfully!", "timestamp": "2026-08-12 11:30:45", "erp_id": "ITEM-00001" }
Error Response 6 fields
{
"success": false,
"status": "failed",
"error": "Validation failed.",
"message": "The provided data is invalid.",
"timestamp": "2026-08-12 11:30:45",
"errors": {
"erp_id": [
"erp_id is required."
],
"name": [
"name is required."
],
"item_group": [
"item_group is required."
],
"part_no": [
"part_no is required."
],
"unit": [
"unit is required."
],
"warehouse_code": [
"warehouse_code is required."
]
}
}
{ "success": false, "status": "failed", "error": "Validation failed.", }{ "success": false, "status": "failed", "error": "Validation failed.", "message": "The provided data is invalid.", "timestamp": "2026-08-12 11:30:45", "errors": { "erp_id": [ "erp_id is required." ], "name": [ "name is required." ], "item_group": [ "item_group is required." ], "part_no": [ "part_no is required." ], "unit": [ "unit is required." ], "warehouse_code": [ "warehouse_code is required." ] } }
cURL Example
curl -X POST \
https://devconnect.aumtics.com/api/v1/sap/item-master \
-H 'Authorization: Bearer {access_token}' \
-H 'Accept: application/json' \
-H 'Content-Type: application/json' \
-d '{
"erp_id": "ITEM-00001",
"name": "MS Flat 25x6 mm",
"item_group": "Raw Materials",
"part_no": "PART-0001",
"sku": "SKU-0001",
"unit": "Kg",
"hsn": "72111990",
"description": "Mild Steel Flat Bar, 25mm width, 6mm thickness",
"assembly_part": "no",
"manufacturer": "SAIL - Steel Authority of India",
"vendor": "Shree Steel Suppliers Pvt Ltd",
"warehouse_code": "RMSH",
"status": "Active"
}'
curl -X POST \ https://devconnect.aumtics.com/api/v1/sap/item-master \ -H 'Authorization: Bearer {access_token}' \ -H 'Accept: application/json' \ -H 'Content-Type: application/json' \ -d '{ "erp_id": "ITEM-00001", "name": "MS Flat 25x6 mm", "item_group": "Raw Materials", "part_no": "PART-0001", "sku": "SKU-0001", "unit": "Kg", "hsn": "72111990", "description": "Mild Steel Flat Bar, 25mm width, 6mm thickness", "assembly_part": "no", "manufacturer": "SAIL - Steel Authority of India", "vendor": "Shree Steel Suppliers Pvt Ltd", "warehouse_code": "RMSH", "status": "Active" }'
POST
/sap/bom
Create/Update BOM
4. Create/Update BOM
/sap/bom
Purpose: This API is used to create or update a Bill of Materials in the Prime.
Usage: Call it whenever a BOM is created or changed in your ERP. Send the SAP product tree (
Required fields:
Header fields:
Component fields:
Structure:
Note: the root
Usage: Call it whenever a BOM is created or changed in your ERP. Send the SAP product tree (
OITT header + ITT1 lines) as it is, the whole tree every time – the components stored against this BOM are replaced by what you send, so a component that moved to a different parent is handled correctly.Required fields:
Code on the root, and Code + Qty on every entry of Components. All other fields are optional.Header fields:
Code – the item code of the BOM (unique key). Name, Qty, TreeType (Production / Assembly / Sales / Template), ToWH – the warehouse the finished item goes to, PriceList.Component fields:
Type (Item / Resource / Text), Code, Name, Qty – per one unit of its parent; may be negative for a scrap / by-product line, Wh – the warehouse the component is issued from, UOM, IssueMethod (Backflush / Manual), PriceList, UnitPrice, and an optional nested Components list.Structure:
Components may nest to any depth (FG → SF → SF → RM). Prime turns the tree into one BOM per manufactured item: every node that has components gets its own BOM, and a semi-finished child is linked to its own BOM as a sub-part. A raw material, BOP or consumable is always a leaf.Note: the root
Code is the unique key – sending it again updates that BOM. The tree does not say what kind of item each code is – that is taken from the item_group of its item master – so every Code in the tree must already exist as an item master: send your item masters before the BOM. If any item is still missing, the BOM is stored but not built in Prime, and it is sent again once the items arrive.Endpoint
https://devconnect.aumtics.com/api/v1/sap/bom
https://devconnect.aumtics.com/api/v1/sap/bom
Headers
{
"Authorization": "Bearer {access_token}",
"Accept": "application/json",
"Content-Type": "application/json"
}
{ "Authorization": "Bearer {access_token}", "Accept": "application/json", "Content-Type": "application/json" }{ "Authorization": "Bearer {access_token}", "Accept": "application/json", "Content-Type": "application/json" }
Request Body 7 fields
{
"Code": "FG000016",
"Name": "PEDAL BRAKE AAGM (46500-AAG-A100)",
"Qty": 1,
"TreeType": "Production",
"ToWH": "FGWH",
"PriceList": "Last Purchase price",
"Components": [
{
"Type": "Item",
"Code": "PM000001",
"Name": "STRETCH FILM 50 MICRON",
"Qty": 0.003,
"Wh": "ASSYWH",
"UOM": "KGS",
"IssueMethod": "Backflush",
"PriceList": "Last Purchase price",
"UnitPrice": 174
},
{
"Type": "Item",
"Code": "SF000025",
"Name": "PEDAL BRAKE AAGM POWDER COATED",
"Qty": 1,
"Wh": "PWDWH",
"UOM": "NOS",
"IssueMethod": "Backflush",
"PriceList": "Last Purchase price",
"UnitPrice": 60.5892,
"Components": [
{
"Type": "Item",
"Code": "CN000001",
"Name": "Powder PP Matt Black(NH 105)",
"Qty": 0.003,
"Wh": "PWDWH",
"UOM": "KG",
"IssueMethod": "Backflush",
"PriceList": "New Price List01",
"UnitPrice": 0
},
{
"Type": "Item",
"Code": "SF000067",
"Name": "PEDAL BRAKE AAGM WELDED",
"Qty": 1,
"Wh": "PWDWH",
"UOM": "NOS",
"IssueMethod": "Backflush",
"PriceList": "Last Purchase price",
"UnitPrice": 67.1966,
"Components": [
{
"Type": "Item",
"Code": "BP000001",
"Name": "PEDAL A 2.6 MM",
"Qty": 1,
"Wh": "WELDWH",
"UOM": "NOS",
"IssueMethod": "Backflush",
"PriceList": "Price List 01",
"UnitPrice": 0
},
{
"Type": "Item",
"Code": "CN000004",
"Name": "MIG WIRE 0.8 MM LAYERED",
"Qty": 0.01,
"Wh": "WELDWH",
"UOM": "KGS",
"IssueMethod": "Backflush",
"PriceList": "Price List 01",
"UnitPrice": 0
},
{
"Type": "Item",
"Code": "SF000026",
"Name": "PIPE FOR PBK AAGM BENDED",
"Qty": 1,
"Wh": "CNCWH",
"UOM": "NOS",
"IssueMethod": "Backflush",
"PriceList": "Price List 01",
"UnitPrice": 0,
"Components": [
{
"Type": "Item",
"Code": "RM000152",
"Name": "Pipe Micro Alloy Steel \u00d8 20X2x350 MM",
"Qty": 1,
"Wh": "CNCWH",
"UOM": "NOS",
"IssueMethod": "Backflush",
"PriceList": "Last Purchase price",
"UnitPrice": 23.6
},
{
"Type": "Item",
"Code": "SC000004",
"Name": "MS Scrap",
"Qty": -0.008,
"Wh": "SCRWH",
"UOM": "KGS",
"IssueMethod": "Backflush",
"PriceList": "Last Purchase price",
"UnitPrice": 38.5
}
]
}
]
}
]
}
]
}
{ "Code": "FG000016", "Name": "PEDAL BRAKE AAGM (46500-AAG-A100)", "Qty": 1, }{ "Code": "FG000016", "Name": "PEDAL BRAKE AAGM (46500-AAG-A100)", "Qty": 1, "TreeType": "Production", "ToWH": "FGWH", "PriceList": "Last Purchase price", "Components": [ { "Type": "Item", "Code": "PM000001", "Name": "STRETCH FILM 50 MICRON", "Qty": 0.003, "Wh": "ASSYWH", "UOM": "KGS", "IssueMethod": "Backflush", "PriceList": "Last Purchase price", "UnitPrice": 174 }, { "Type": "Item", "Code": "SF000025", "Name": "PEDAL BRAKE AAGM POWDER COATED", "Qty": 1, "Wh": "PWDWH", "UOM": "NOS", "IssueMethod": "Backflush", "PriceList": "Last Purchase price", "UnitPrice": 60.5892, "Components": [ { "Type": "Item", "Code": "CN000001", "Name": "Powder PP Matt Black(NH 105)", "Qty": 0.003, "Wh": "PWDWH", "UOM": "KG", "IssueMethod": "Backflush", "PriceList": "New Price List01", "UnitPrice": 0 }, { "Type": "Item", "Code": "SF000067", "Name": "PEDAL BRAKE AAGM WELDED", "Qty": 1, "Wh": "PWDWH", "UOM": "NOS", "IssueMethod": "Backflush", "PriceList": "Last Purchase price", "UnitPrice": 67.1966, "Components": [ { "Type": "Item", "Code": "BP000001", "Name": "PEDAL A 2.6 MM", "Qty": 1, "Wh": "WELDWH", "UOM": "NOS", "IssueMethod": "Backflush", "PriceList": "Price List 01", "UnitPrice": 0 }, { "Type": "Item", "Code": "CN000004", "Name": "MIG WIRE 0.8 MM LAYERED", "Qty": 0.01, "Wh": "WELDWH", "UOM": "KGS", "IssueMethod": "Backflush", "PriceList": "Price List 01", "UnitPrice": 0 }, { "Type": "Item", "Code": "SF000026", "Name": "PIPE FOR PBK AAGM BENDED", "Qty": 1, "Wh": "CNCWH", "UOM": "NOS", "IssueMethod": "Backflush", "PriceList": "Price List 01", "UnitPrice": 0, "Components": [ { "Type": "Item", "Code": "RM000152", "Name": "Pipe Micro Alloy Steel \u00d8 20X2x350 MM", "Qty": 1, "Wh": "CNCWH", "UOM": "NOS", "IssueMethod": "Backflush", "PriceList": "Last Purchase price", "UnitPrice": 23.6 }, { "Type": "Item", "Code": "SC000004", "Name": "MS Scrap", "Qty": -0.008, "Wh": "SCRWH", "UOM": "KGS", "IssueMethod": "Backflush", "PriceList": "Last Purchase price", "UnitPrice": 38.5 } ] } ] } ] } ] }
Success Response 5 fields
{
"success": true,
"status": "success",
"message": "BOM created successfully!",
"timestamp": "2026-08-12 11:30:45",
"erp_id": "FG000016"
}
{ "success": true, "status": "success", "message": "BOM created successfully!", }{ "success": true, "status": "success", "message": "BOM created successfully!", "timestamp": "2026-08-12 11:30:45", "erp_id": "FG000016" }
Error Response 6 fields
{
"success": false,
"status": "failed",
"error": "Validation failed.",
"message": "The provided data is invalid.",
"timestamp": "2026-08-12 11:30:45",
"errors": {
"Code": [
"Code is required."
],
"Components.0.Qty": [
"Every component must have a Qty."
],
"Components.1.Components.0.Code": [
"Every component must have a Code."
]
}
}
{ "success": false, "status": "failed", "error": "Validation failed.", }{ "success": false, "status": "failed", "error": "Validation failed.", "message": "The provided data is invalid.", "timestamp": "2026-08-12 11:30:45", "errors": { "Code": [ "Code is required." ], "Components.0.Qty": [ "Every component must have a Qty." ], "Components.1.Components.0.Code": [ "Every component must have a Code." ] } }
cURL Example
curl -X POST \
https://devconnect.aumtics.com/api/v1/sap/bom \
-H 'Authorization: Bearer {access_token}' \
-H 'Accept: application/json' \
-H 'Content-Type: application/json' \
-d '{
"Code": "FG000016",
"Name": "PEDAL BRAKE AAGM (46500-AAG-A100)",
"Qty": 1,
"TreeType": "Production",
"ToWH": "FGWH",
"PriceList": "Last Purchase price",
"Components": [
{
"Type": "Item",
"Code": "PM000001",
"Name": "STRETCH FILM 50 MICRON",
"Qty": 0.003,
"Wh": "ASSYWH",
"UOM": "KGS",
"IssueMethod": "Backflush",
"PriceList": "Last Purchase price",
"UnitPrice": 174
},
{
"Type": "Item",
"Code": "SF000025",
"Name": "PEDAL BRAKE AAGM POWDER COATED",
"Qty": 1,
"Wh": "PWDWH",
"UOM": "NOS",
"IssueMethod": "Backflush",
"PriceList": "Last Purchase price",
"UnitPrice": 60.5892,
"Components": [
{
"Type": "Item",
"Code": "CN000001",
"Name": "Powder PP Matt Black(NH 105)",
"Qty": 0.003,
"Wh": "PWDWH",
"UOM": "KG",
"IssueMethod": "Backflush",
"PriceList": "New Price List01",
"UnitPrice": 0
},
{
"Type": "Item",
"Code": "SF000067",
"Name": "PEDAL BRAKE AAGM WELDED",
"Qty": 1,
"Wh": "PWDWH",
"UOM": "NOS",
"IssueMethod": "Backflush",
"PriceList": "Last Purchase price",
"UnitPrice": 67.1966,
"Components": [
{
"Type": "Item",
"Code": "BP000001",
"Name": "PEDAL A 2.6 MM",
"Qty": 1,
"Wh": "WELDWH",
"UOM": "NOS",
"IssueMethod": "Backflush",
"PriceList": "Price List 01",
"UnitPrice": 0
},
{
"Type": "Item",
"Code": "CN000004",
"Name": "MIG WIRE 0.8 MM LAYERED",
"Qty": 0.01,
"Wh": "WELDWH",
"UOM": "KGS",
"IssueMethod": "Backflush",
"PriceList": "Price List 01",
"UnitPrice": 0
},
{
"Type": "Item",
"Code": "SF000026",
"Name": "PIPE FOR PBK AAGM BENDED",
"Qty": 1,
"Wh": "CNCWH",
"UOM": "NOS",
"IssueMethod": "Backflush",
"PriceList": "Price List 01",
"UnitPrice": 0,
"Components": [
{
"Type": "Item",
"Code": "RM000152",
"Name": "Pipe Micro Alloy Steel \u00d8 20X2x350 MM",
"Qty": 1,
"Wh": "CNCWH",
"UOM": "NOS",
"IssueMethod": "Backflush",
"PriceList": "Last Purchase price",
"UnitPrice": 23.6
},
{
"Type": "Item",
"Code": "SC000004",
"Name": "MS Scrap",
"Qty": -0.008,
"Wh": "SCRWH",
"UOM": "KGS",
"IssueMethod": "Backflush",
"PriceList": "Last Purchase price",
"UnitPrice": 38.5
}
]
}
]
}
]
}
]
}'
curl -X POST \ https://devconnect.aumtics.com/api/v1/sap/bom \ -H 'Authorization: Bearer {access_token}' \ -H 'Accept: application/json' \ -H 'Content-Type: application/json' \ -d '{ "Code": "FG000016", "Name": "PEDAL BRAKE AAGM (46500-AAG-A100)", "Qty": 1, "TreeType": "Production", "ToWH": "FGWH", "PriceList": "Last Purchase price", "Components": [ { "Type": "Item", "Code": "PM000001", "Name": "STRETCH FILM 50 MICRON", "Qty": 0.003, "Wh": "ASSYWH", "UOM": "KGS", "IssueMethod": "Backflush", "PriceList": "Last Purchase price", "UnitPrice": 174 }, { "Type": "Item", "Code": "SF000025", "Name": "PEDAL BRAKE AAGM POWDER COATED", "Qty": 1, "Wh": "PWDWH", "UOM": "NOS", "IssueMethod": "Backflush", "PriceList": "Last Purchase price", "UnitPrice": 60.5892, "Components": [ { "Type": "Item", "Code": "CN000001", "Name": "Powder PP Matt Black(NH 105)", "Qty": 0.003, "Wh": "PWDWH", "UOM": "KG", "IssueMethod": "Backflush", "PriceList": "New Price List01", "UnitPrice": 0 }, { "Type": "Item", "Code": "SF000067", "Name": "PEDAL BRAKE AAGM WELDED", "Qty": 1, "Wh": "PWDWH", "UOM": "NOS", "IssueMethod": "Backflush", "PriceList": "Last Purchase price", "UnitPrice": 67.1966, "Components": [ { "Type": "Item", "Code": "BP000001", "Name": "PEDAL A 2.6 MM", "Qty": 1, "Wh": "WELDWH", "UOM": "NOS", "IssueMethod": "Backflush", "PriceList": "Price List 01", "UnitPrice": 0 }, { "Type": "Item", "Code": "CN000004", "Name": "MIG WIRE 0.8 MM LAYERED", "Qty": 0.01, "Wh": "WELDWH", "UOM": "KGS", "IssueMethod": "Backflush", "PriceList": "Price List 01", "UnitPrice": 0 }, { "Type": "Item", "Code": "SF000026", "Name": "PIPE FOR PBK AAGM BENDED", "Qty": 1, "Wh": "CNCWH", "UOM": "NOS", "IssueMethod": "Backflush", "PriceList": "Price List 01", "UnitPrice": 0, "Components": [ { "Type": "Item", "Code": "RM000152", "Name": "Pipe Micro Alloy Steel \u00d8 20X2x350 MM", "Qty": 1, "Wh": "CNCWH", "UOM": "NOS", "IssueMethod": "Backflush", "PriceList": "Last Purchase price", "UnitPrice": 23.6 }, { "Type": "Item", "Code": "SC000004", "Name": "MS Scrap", "Qty": -0.008, "Wh": "SCRWH", "UOM": "KGS", "IssueMethod": "Backflush", "PriceList": "Last Purchase price", "UnitPrice": 38.5 } ] } ] } ] } ] }'
Notes
- All secured endpoints require Bearer {token}.
- Test authentication using Postman or /testing route.
- Masters APIs use erp_id as the unique key — sending an erp_id that already exists updates the record instead of creating a new one.
- A newly created record returns HTTP 201; an updated record returns HTTP 200.
HTTP Status Codes
| Code | Meaning |
|---|---|
| 200 | OK – Success |
| 201 | Created – New resource created |
| 204 | No Content Success, no data |
| 400 | Bad Request |
| 401 | Unauthorized |
| 403 | Forbidden |
| 404 | Not Found |
| 422 | Validation Error |
| 500 | Server Error |