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.