Skip to main content

​
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)

​
Tools

​
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.