What can you do with it?
Manage supplier invoices, suppliers, and customers through SAP S/4HANA, including creating and managing supplier invoices, retrieving supplier information, and processing business partner data for comprehensive enterprise resource planning operations.
How to use it?
Basic Command Structure
/your-saps4hana-connection [action] [required-parameters] [optional-parameters]
Parameters
Required:
action
- The operation to perform (create-invoice, get-invoice, search-invoices, delete-invoice, get-supplier, search-suppliers)
Optional:
invoice-document
- Invoice document number
company-code
- Company code (e.g., 1000)
supplier-id
- Supplier ID
document-date
- Document date
posting-date
- Posting date
invoice-amount
- Invoice amount
currency
- Currency code (e.g., USD, EUR)
Create Supplier Invoice
Create a new supplier invoice in SAP S/4HANA
Parameters:
invoice-document
(required) - Invoice document number
company-code
(required) - Company code
supplier-id
(required) - Supplier ID
document-date
(required) - Document date (YYYY-MM-DD)
posting-date
(required) - Posting date (YYYY-MM-DD)
invoice-amount
(required) - Invoice amount
currency
(required) - Currency code
purchase-order
(optional) - Purchase order number
purchase-order-item
(optional) - Purchase order item number
quantity
(optional) - Quantity
Example:
/your-saps4hana-connection
action: create-invoice
invoice-document: 1234567890
company-code: 1000
supplier-id: SUPPLIER123
document-date: 2025-01-15
posting-date: 2025-01-15
invoice-amount: 1500.00
currency: USD
purchase-order: 4500001234
purchase-order-item: 10
quantity: 100
Response:
{
"InvoiceDocument": "1234567890",
"CompanyCode": "1000",
"SupplierID": "SUPPLIER123",
"DocumentDate": "2025-01-15",
"PostingDate": "2025-01-15",
"InvoiceAmount": "1500.00",
"Currency": "USD"
}
Get Supplier Invoice
Retrieve details of a specific supplier invoice using its unique ID
Parameters:
invoice-document
(required) - Invoice document number
Example:
/your-saps4hana-connection
action: get-invoice
invoice-document: 1234567890
Response:
{
"InvoiceDocument": "1234567890",
"CompanyCode": "1000",
"SupplierID": "SUPPLIER123",
"DocumentDate": "2025-01-15",
"PostingDate": "2025-01-15",
"InvoiceAmount": "1500.00",
"Currency": "USD"
}
Search Supplier Invoices
Search for supplier invoices based on specific criteria
Parameters:
filter-criteria
(required) - Search filter criteria (e.g., SupplierID eq ‘SUPPLIER123’)
Example:
/your-saps4hana-connection
action: search-invoices
filter-criteria: SupplierID eq 'SUPPLIER123'
Response:
{
"value": [
{
"InvoiceDocument": "1234567890",
"CompanyCode": "1000",
"SupplierID": "SUPPLIER123",
"DocumentDate": "2025-01-15",
"PostingDate": "2025-01-15",
"InvoiceAmount": "1500.00",
"Currency": "USD"
},
{
"InvoiceDocument": "1234567891",
"CompanyCode": "1000",
"SupplierID": "SUPPLIER123",
"DocumentDate": "2025-01-16",
"PostingDate": "2025-01-16",
"InvoiceAmount": "2000.00",
"Currency": "USD"
}
]
}
Delete Supplier Invoice
Delete a specific supplier invoice using its unique ID
Parameters:
invoice-document
(required) - Invoice document number to delete
Example:
/your-saps4hana-connection
action: delete-invoice
invoice-document: 1234567890
Response:
{
"message": "Supplier invoice deleted successfully."
}
Get Supplier
Retrieve details of a specific supplier using their unique ID
Parameters:
supplier-id
(required) - Supplier business partner ID
Example:
/your-saps4hana-connection
action: get-supplier
supplier-id: SUPPLIER123
Response:
{
"BusinessPartner": "SUPPLIER123",
"BusinessPartnerFullName": "ABC Supplies Inc.",
"BusinessPartnerCategory": "Organization",
"Address": {
"StreetName": "123 Main St",
"CityName": "Anytown",
"PostalCode": "12345",
"Country": "US"
}
}
Search Suppliers
Search for suppliers based on specific criteria
Parameters:
filter-criteria
(required) - Search filter criteria (e.g., BusinessPartnerCategory eq ‘Organization’)
Example:
/your-saps4hana-connection
action: search-suppliers
filter-criteria: BusinessPartnerCategory eq 'Organization'
Response:
{
"value": [
{
"BusinessPartner": "SUPPLIER123",
"BusinessPartnerFullName": "ABC Supplies Inc.",
"BusinessPartnerCategory": "Organization",
"Address": {
"StreetName": "123 Main St",
"CityName": "Anytown",
"PostalCode": "12345",
"Country": "US"
}
},
{
"BusinessPartner": "SUPPLIER124",
"BusinessPartnerFullName": "XYZ Industries",
"BusinessPartnerCategory": "Organization",
"Address": {
"StreetName": "456 Elm St",
"CityName": "Othertown",
"PostalCode": "67890",
"Country": "US"
}
}
]
}
Notes
SAP S/4HANA uses OData APIs for data operations. All invoice operations require valid company codes and supplier IDs. Filter criteria use OData query syntax with operators like eq (equals), ne (not equals), and contains. Date formats should be in YYYY-MM-DD format. Currency codes must be valid ISO currency codes.