Overview
This node integrates with the TANSS API to manage contracts and offers. It allows users to create, retrieve, list, and update contract and offer data within the TANSS system. Typical use cases include automating contract creation workflows, updating contract statuses, retrieving offer details for processing, or listing all available offers for reporting or further automation.
For example, a user can automate the creation of a new contract by providing relevant contract details such as title, amount, and dates, then send this data directly to the TANSS API. Similarly, it can fetch existing offer information or update contract records without manual intervention.
Properties
| Name | Meaning |
|---|---|
| API Token | API token from TANSS authentication used to authorize requests. |
| Vertragsfelder | Collection of fields describing the contract or offer. Includes: |
| - Titel | Title of the offer or contract. |
| - Beschreibung | Description of the offer or contract. |
| - Unternehmen-ID | ID of the associated company. |
| - Betrag | Contract amount. |
| - Währung | Currency of the contract. Options: EUR, USD, CHF. |
| - Startdatum | Start date of the contract. |
| - Enddatum | End date of the contract. |
| - Status | Status of the contract. Options: Entwurf (Draft), Aktiv (Active), Abgeschlossen (Completed), Storniert (Cancelled). |
Note: The "Vertragsfelder" property is required when creating or updating offers/contracts.
Output
The node outputs an array of JSON objects representing the response from the TANSS API for each input item processed. The structure of the JSON depends on the operation performed:
- For creation operations (
createOffer,createContract), the output contains the newly created offer or contract data. - For retrieval operations (
getOffer), the output contains the requested offer details. - For listing operations (
listOffers), the output contains an array of offers. - For update operations (
updateContract), the output contains the updated contract data.
No binary data output is produced by this node.
Dependencies
- Requires an active TANSS API endpoint URL configured in credentials.
- Requires an API token credential for authenticating requests to the TANSS API.
- The node uses HTTP methods (GET, POST, PUT) to interact with the TANSS backend API.
Troubleshooting
- Missing Credentials: If no API credentials are found, the node throws an error "Keine Anmeldedaten gefunden!" Ensure that valid TANSS API credentials are configured in n8n.
- Empty Fields on Create/Update: When creating or updating offers/contracts, if no fields are provided, the node throws errors like "Keine Felder für die Vertragserstellung angegeben." or "Keine Felder zum Aktualisieren angegeben." Always provide necessary contract fields.
- Unknown Operation: 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 endpoint availability.
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/