SAP Service Layer (Purchases) icon

SAP Service Layer (Purchases)

Todas las entidades de Purchases de SAP Service Layer
Join our community

Actions88

Overview

This node integrates with the SAP Service Layer to manage various purchase-related documents in SAP Business One. Specifically, for the Purchase Invoice resource and the Close operation, it allows users to close a purchase invoice by its unique identifier (DocEntry). Closing a purchase invoice typically means marking it as finalized or completed in the SAP system, preventing further modifications.

Common scenarios where this node is beneficial include:

  • Automating the workflow of purchase invoice processing by programmatically closing invoices once all validations or approvals are done.
  • Integrating SAP purchase invoice lifecycle management into broader automation pipelines.
  • Ensuring data consistency by closing invoices after external systems confirm receipt or payment.

Example use case:

  • After receiving and validating a purchase invoice from a supplier, an automation workflow uses this node to close the invoice in SAP, signaling that no further changes are expected.

Properties

Name Meaning
DocEntry The unique numeric identifier of the purchase invoice to be closed (required).

Output

The node outputs the JSON response returned by the SAP Service Layer API after attempting to close the purchase invoice. This typically includes details about the updated invoice status or any error messages.

The output structure is:

{
  "json": {
    // Response object from SAP Service Layer for the close operation
  },
  "pairedItem": {
    "item": <index_of_input_item>
  }
}

If the operation fails, the json field contains an error property with the error message.

No binary data output is produced by this node.

Dependencies

  • Requires connection to an SAP Business One Service Layer endpoint.
  • Needs credentials including base URL, username, password, and company database name.
  • The node performs a login request to obtain session cookies before making API calls.
  • The SAP Service Layer API must support the /PurchaseInvoices({DocEntry})/Close POST endpoint.

Troubleshooting

  • Authentication errors: If login fails, verify the provided SAP credentials and company database name.
  • Invalid DocEntry: Ensure the DocEntry number corresponds to an existing purchase invoice in SAP.
  • Network issues: Check connectivity to the SAP Service Layer endpoint and firewall settings.
  • API errors: The SAP Service Layer may return errors if the invoice cannot be closed due to business rules (e.g., already closed, canceled, or linked documents).
  • Error messages from the SAP API are passed through in the output's error field; review these messages for specific causes.

Links and References

Discussion