API Documentation
v1Complete reference for the Aumtics APIs — 9 endpoints across 5 categories. Learn how to authenticate, send requests and handle responses.
Base URL
https://connect.aumtics.com/api/v1/
Authentication
Bearer Token
Content Type
application/json
Last Updated
August 20, 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://connect.aumtics.com/api/v1/oauth/token
https://connect.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://connect.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://connect.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://connect.aumtics.com/api/v1/oauth/revoke
https://connect.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://connect.aumtics.com/api/v1/oauth/revoke \
-H 'Authorization: Bearer {access_token}'
curl -X POST \ https://connect.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://connect.aumtics.com/api/v1/testing
https://connect.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://connect.aumtics.com/api/v1/testing \
-H 'Authorization: Bearer {access_token}'
curl -X GET \ https://connect.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://connect.aumtics.com/api/v1/sap/sales-orders
https://connect.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://connect.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://connect.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://connect.aumtics.com/api/v1/sap/ar-invoice
https://connect.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://connect.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://connect.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://connect.aumtics.com/api/v1/sap/production-order
https://connect.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://connect.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://connect.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" } ] }'
Master Data APIs
Create or update client, vendor and item master records in Prime.
3
Endpoints
Master Data APIs
Create or update client, vendor and item master 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://connect.aumtics.com/api/v1/sap/client
https://connect.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://connect.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://connect.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://connect.aumtics.com/api/v1/sap/vendor
https://connect.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://connect.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://connect.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://connect.aumtics.com/api/v1/sap/item-master
https://connect.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 Material",
"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 Material", }{ "erp_id": "ITEM-00001", "name": "MS Flat 25x6 mm", "item_group": "Raw Material", "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://connect.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 Material",
"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://connect.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 Material", "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" }'
Notes
- All secured endpoints require Bearer {token}.
- Test authentication using Postman or /testing route.
- Master Data 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 |