Overview
This node integrates with the TANSS API to manage contracts and offers. It allows users to create new offers, retrieve specific offers, list all offers, create new contracts, and update existing contracts. This is useful for automating contract and offer management workflows within n8n, such as generating proposals, tracking contract statuses, or synchronizing contract data with other systems.
Practical examples:
- Automatically create a new sales offer when a lead reaches a certain stage.
- Retrieve details of an existing offer to display or process further.
- List all current offers for reporting or auditing purposes.
- Create a new contract once an offer is accepted.
- Update contract details like status or amount based on external events.
Properties
| Name | Meaning |
|---|---|
| Operation | The action to perform: "Angebot erstellen" (create offer), "Angebot abrufen" (get offer), "Angebote auflisten" (list offers), "Vertrag erstellen" (create contract), "Vertrag aktualisieren" (update contract). |
| API Token | API token from TANSS authentication used to authorize requests. |
| Angebots-/Vertrags-ID | ID of the offer or contract, required for retrieving or updating specific records. |
| Vertragsfelder | Collection of fields describing the offer or contract details. Available fields include: |
| - Titel | Title of the offer/contract. |
| - Beschreibung | Description of the offer/contract. |
| - Unternehmen-ID | ID of the associated company. |
| - Betrag | Contract amount. |
| - Währung | Currency of the contract amount. 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). |
Output
The node outputs JSON data representing the response from the TANSS API for the selected operation. This includes:
- For creating offers or contracts: the newly created object with its details.
- For retrieving an offer: the offer's detailed data.
- For listing offers: an array of offer objects.
- For updating contracts: the updated contract object.
No binary data output is produced by this node.
Dependencies
- Requires an active TANSS API credential with a valid API token.
- The node expects the base URL of the TANSS API to be provided via credentials.
- Network access to the TANSS API endpoints is necessary.
Troubleshooting
- Missing Credentials: If no API credentials are found, the node throws an error "Keine Anmeldedaten gefunden!" Ensure that the API token credential is configured correctly in n8n.
- 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 will throw 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 correct input parameters.
Links and References
- TANSS API Documentation (not provided here; refer to your internal or vendor documentation)
- n8n Documentation: Creating Custom Nodes
- General REST API usage in n8n: HTTP Request Node