Overview
This node integrates with the TANSS API to manage contracts and offers. It supports operations such as creating, retrieving, listing, and updating offers and contracts. This is useful for automating contract management workflows, syncing contract data from TANSS into n8n, or triggering downstream processes based on contract status changes.
For example, you can:
- Retrieve details of a specific offer by its ID.
- List all available offers.
- Create new offers or contracts by providing relevant fields.
- Update existing contracts with new information.
Properties
| Name | Meaning |
|---|---|
| API Token | The API token obtained from TANSS authentication, used to authorize API requests. |
| Angebots-/Vertrags-ID | The ID of the offer or contract to retrieve or update (required for "getOffer" and "updateContract" operations). |
Output
The node outputs an array of JSON objects representing the response from the TANSS API for each input item processed. The structure depends on the operation:
- For getOffer and listOffers, the output JSON contains offer details retrieved from the API.
- For createOffer and createContract, the output JSON contains the newly created offer or contract data.
- For updateContract, the output JSON contains the updated contract data.
No binary data is produced by this node.
Dependencies
- Requires an active TANSS API endpoint URL configured in credentials.
- Requires an API token credential for authenticating requests.
- The node uses HTTP requests to communicate with the TANSS backend API.
Troubleshooting
- Missing Credentials Error: If no API credentials are found, the node throws an error "Keine Anmeldedaten gefunden!" Ensure that the API token credential is properly set up.
- Empty Fields Error: When creating or updating offers/contracts, if no fields are provided, the node throws errors like "Keine Felder für die Angebotserstellung angegeben." or "Keine Felder zum Aktualisieren angegeben." Make sure to provide necessary fields in the input.
- Unknown Operation Error: If an unsupported operation is selected, the node throws an error indicating the operation is not recognized.
- API Request Failures: Errors during API calls will be reported with messages like "Fehler beim Ausführen von [operation]: [error message]". Check network connectivity, API token validity, and correct IDs.
Links and References
- TANSS API Documentation (not provided here; refer to your internal TANSS API docs)
- n8n HTTP Request Node documentation for understanding request options: https://docs.n8n.io/nodes/n8n-nodes-base.httpRequest/