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, for example:
- Automatically listing all current offers from TANSS.
- Creating new offers or contracts based on input data.
- Retrieving details of a specific offer.
- Updating existing contract information.
Such automation can streamline sales and contract management processes within an organization using the TANSS platform.
Properties
| Name | Meaning |
|---|---|
| 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) |
| API Token | API token from TANSS authentication, required for authorization. |
| Angebots-/Vertrags-ID | ID of the offer or contract, required for "getOffer" and "updateContract" operations. |
| Vertragsfelder (Contract Fields) | Collection of fields for creating or updating offers/contracts. Includes: - Titel (Title): string - Beschreibung (Description): string - Unternehmen-ID (Company ID): number - Betrag (Amount): number - Währung (Currency): EUR, USD, CHF - Startdatum (Start Date): dateTime - Enddatum (End Date): dateTime - 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. The structure depends on the operation:
- For listing offers, it returns an array of offer objects.
- For creating or retrieving an offer or contract, it returns the created or fetched object.
- For updating a contract, it returns the updated contract data.
No binary data output is produced by this node.
Dependencies
- Requires access to the TANSS API endpoint.
- Needs an API token credential obtained via TANSS authentication.
- The base URL for the TANSS API is provided through the node credentials configuration.
- Network connectivity to the TANSS backend API is necessary.
Troubleshooting
- Missing Credentials: If no API token or credentials are provided, the node throws an error "Keine Anmeldedaten gefunden!" (No login data found!). Ensure the API token is correctly set.
- Empty Fields for Create/Update: When creating or updating offers/contracts, if no fields are specified, the node throws errors like "Keine Felder für die Angebotserstellung angegeben." (No fields specified for offer creation). Always provide required fields 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 include the operation name and the original error message, e.g., "Fehler beim Ausführen von listOffers: ...". Check network connectivity, API token validity, and API endpoint availability.
Links and References
- TANSS API Documentation (Replace with actual URL if available)
- n8n Documentation on Creating Custom Nodes
- General REST API usage best practices