Overview
This node integrates with the TANSS API to manage contracts and offers. It supports operations such as creating, retrieving, listing offers, and creating or updating contracts. This node is useful for automating contract and offer management workflows, such as syncing contract data from TANSS into other systems, generating new offers programmatically, or updating contract statuses.
A practical example would be automatically listing all current offers in TANSS to display them in a dashboard or creating a new offer based on user input collected elsewhere in an automated workflow.
Properties
| Name | Meaning |
|---|---|
| API Token | API token obtained from TANSS authentication, used to authorize requests to the TANSS API. |
| Operation | The action to perform. Options: - Angebot erstellen (Create Offer) - Angebot abrufen (Get Offer) - Angebote auflisten (List Offers) - Vertrag erstellen (Create Contract) - Vertrag aktualisieren (Update Contract) |
| Angebots-/Vertrags-ID | ID of the offer or contract, required for "getOffer" and "updateContract" operations. |
| Vertragsfelder | Collection of fields describing the offer or contract details, used when creating or updating. Fields include: - Titel (Title) - Beschreibung (Description) - Unternehmen-ID (Company ID) - Betrag (Amount) - Währung (Currency): EUR, USD, CHF - Startdatum (Start Date) - Enddatum (End Date) - Status: 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. For example:
- When listing offers, it returns an array of offer objects.
- When creating or updating, it returns the created or updated offer/contract object.
- When retrieving a single offer, it returns that offer's details.
No binary data output is produced by this node.
Dependencies
- Requires access to the TANSS API endpoint, configured via credentials containing the base URL and an API key.
- The user must provide a valid API token from TANSS authentication as an input property.
- Network connectivity to the TANSS backend API is necessary.
Troubleshooting
- Missing Credentials: If no credentials are found, the node throws an error "Keine Anmeldedaten gefunden!" Ensure the API credential is properly configured in n8n.
- Empty Fields for Create/Update: Creating or updating offers/contracts without specifying any fields results in errors like "Keine Felder für die Angebotserstellung angegeben." Always provide the required fields in the "Vertragsfelder" collection.
- Invalid Operation: Selecting an unsupported operation triggers an error indicating the operation is not recognized.
- API Request Failures: Errors during HTTP requests return messages prefixed with "Fehler beim Ausführen von [operation]:". Check the API token validity, network connection, and API endpoint accessibility.
Links and References
- TANSS API documentation (not provided here; consult your TANSS API provider)
- n8n documentation on creating custom nodes and using credentials: https://docs.n8n.io/