Overview
This node integrates with the TANSS API to manage contracts and offers. It supports operations such as creating new offers, retrieving offer details, listing all offers, creating contracts, and updating existing contracts. This node is useful for automating contract and offer management workflows, such as syncing contract data from TANSS into other systems or triggering actions based on contract status changes.
For example, you can use this node to:
- Retrieve detailed information about a specific offer by its ID.
- Create a new offer or contract with specified fields like title, amount, and dates.
- Update an existing contract’s details.
- List all available offers to process them further in your workflow.
Properties
| Name | Meaning |
|---|---|
| Operation | The action to perform: createOffer, getOffer, listOffers, createContract, updateContract |
| API Token | API token from TANSS authentication (required for all operations) |
| Angebots-/Vertrags-ID | ID of the offer or contract (required for getOffer and updateContract operations) |
Additional properties for createOffer, createContract, and updateContract operations:
| Name | Meaning |
|---|---|
| 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) |
Output
The node outputs JSON data representing the response from the TANSS API for the selected operation. The structure depends on the operation:
- For getOffer and listOffers, it returns offer details or a list of offers.
- For createOffer and createContract, it returns the newly created offer or contract data.
- For updateContract, it returns the updated contract data.
No binary data output is produced by this node.
Dependencies
- Requires an active TANSS API endpoint URL and a valid API token credential for authentication.
- The node expects the base URL of the TANSS API to be provided via credentials.
- No additional external dependencies beyond the TANSS API and n8n's HTTP request helper.
Troubleshooting
- Missing Credentials Error: If no API token or credentials are found, the node will throw an error "Keine Anmeldedaten gefunden!" Ensure that the API token is correctly configured in the node credentials.
- Empty Fields Error: When creating or updating offers/contracts, if no fields are provided, errors like "Keine Felder für die Angebotserstellung angegeben." or "Keine Felder zum Aktualisieren angegeben." will occur. 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 include the operation name and the original error message. Check network connectivity, API token validity, and correct IDs.
Links and References
- TANSS API Documentation (Replace with actual link if available)
- n8n HTTP Request Node documentation for understanding request options: https://docs.n8n.io/nodes/n8n-nodes-base.httpRequest/