Overview
The "TANSS Verträge" node manages contracts and offers via the TANSS API. It supports creating, retrieving, listing, and updating offers and contracts. This node is useful for automating contract lifecycle management within workflows, such as generating new offers, fetching existing offer details, listing all offers, creating new contracts, or updating contract information.
Practical examples:
- Automatically create a new sales offer when a lead reaches a certain stage.
- Retrieve detailed information about an existing offer to display or process further.
- List all current offers for reporting or synchronization with other systems.
- Create a new contract once an offer is accepted.
- Update contract status or details based on external events.
Properties
| Name | Meaning |
|---|---|
| API Token | API token from TANSS authentication used to authorize requests. |
| Vertragsfelder | Collection of contract/offer fields used when creating or updating offers/contracts: |
| - 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). |
| Angebots-/Vertrags-ID | ID of the offer or contract, required for retrieving or updating specific records. |
| Operation | The action to perform. Options include: Angebot erstellen (createOffer), Angebot abrufen (getOffer), Angebote auflisten (listOffers), Vertrag erstellen (createContract), Vertrag aktualisieren (updateContract). |
Output
The node outputs JSON data representing the response from the TANSS API for the performed operation. The structure depends on the operation:
- For creation operations (
createOffer,createContract), the output contains the newly created offer or contract details. - For retrieval (
getOffer) and listing (listOffers), it returns the corresponding offer(s) data. - For update (
updateContract), it returns the updated contract information.
No binary data output is produced by this node.
Dependencies
- Requires access to the TANSS API endpoint.
- Needs an API token credential from TANSS authentication configured in n8n credentials.
- The base URL for the TANSS API is obtained from the stored credentials.
- Network connectivity to the TANSS backend API is necessary.
Troubleshooting
- Missing Credentials: If no API token credential is found, the node throws an error "Keine Anmeldedaten gefunden!" Ensure the API token credential is properly set up.
- Empty Fields for Creation/Update: 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." Always provide at least one field in the "Vertragsfelder" collection.
- Invalid 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 return messages prefixed with "Fehler beim Ausführen von [operation]:". Check network connectivity, API token validity, and request parameters.
Links and References
- TANSS API Documentation (not provided here; refer to your internal or official TANSS API docs)
- n8n Documentation on creating custom nodes and using credentials: https://docs.n8n.io/
- General REST API usage in n8n: https://docs.n8n.io/integrations/builtin/core-nodes/n8n-nodes-base.http-request/