Skip to content

Service tickets — interface (customer view)

Status as of 20.11.2026. The German version follows below: Service-Tickets — Schnittstelle (Kundensicht). French, Spanish, Italian and Dutch follow after it: interface (vue client), interfaz (vista del cliente), interfaccia (vista cliente), interface (klantweergave).

For IT and integration partners

Technical reference for the administration interface of the uSuite. It describes only what an access of a customer, a site or a service partner sends and receives. Operating steps: Service tickets in the uSuite.

Built, not yet rolled out

The changes on this page are built and in acceptance on the test site; they are not yet rolled out. They take effect with an update of the uSuite administration service.

Both routes sit behind the administration HTTP API, are authorised by the same JWT check as the existing routes and write a log line per change. No new route, no new right.

POST /vorgang — create a ticket

Field Meaning
seriennummer Device. Optional: without it, the ticket is created without a device.
knoten Only without a device: path of a customer or site node the access may see. Without knoten, the access’s own node is used in the current state.
kategorie stoerung, auskunft, wartung or reklamation. Other categories are assigned by the URG service: 403. Without kategorie (and without the earlier field anlass) the ticket is a question (auskunft).
titel Short text, 3 to 120 characters. Required.
beschreibung Details, at most 2,000 characters. Optional.
dublette "dublette": "neu" creates the ticket despite a duplicate notice.
dubletteVon vorgangId of an open ticket from the duplicate notice: the new ticket is closed at once and linked to it.
trotzdem true creates the ticket despite a query about contact data (see 409).

stoerung and wartung need a device. Without a device, auskunft and reklamation are possible.

Answer When
201 { "vorgang": { … } } with kategorie and status (see below).
400 schluessel vorgang.kategorie (unknown category), vorgang.ohneGeraet (fault or maintenance without a device), vorgang.ohneOrt (no node), vorgang.knotenKunde (node is neither customer nor site), vorgang.dubletteVon (not an open ticket from the notice).
403 schluessel vorgang.kategorieKunde: this category is assigned by the URG service.
404 Device or node unknown or not visible to this access — the same answer for both.
409 Duplicate notice: an open ticket of the same category exists for the same device (without a device: for the same node). Body: fehler, hinweis, schluessel vorgang.dublette, dublette: true, dubletten — at most ten entries with vorgangId, titel, kategorie, status, angelegtAm (milliseconds). Send again with "dublette": "neu" or with dubletteVon.
409 Query about contact data: titel or beschreibung contains, for example, an e-mail address or a phone number. Body: fehler, hinweis, schluessel kundentext.nachfrage, nachfrage: true, hinweise (wort, grund, stelle). If intended, send again with "trotzdem": true.

In the current state the duplicate notice has no time window: every open ticket counts.

POST /vorgang/{vorgangId}/handlung — changed actions

For accesses with the right to edit cases in their area.

handlung New or changed
annehmen Sets the phase analyse (status inAnalyse).
phase New. phase: analyse or bearbeitung; only while the ticket is in progress. Same value again: 409.
warten phase required: kunde, teil, entwicklung or beobachten; otherwise 400 vorgang.wartephase. entwicklung only once the URG service has linked a development item, otherwise 400. text (reason) as before.
schliessen phase required: geloest or geschlossen; otherwise 400 vorgang.schliessphase. text (reason) as before.
zuweisen New. an: e-mail address of an active account with service rights in the access’s own area that may see the ticket; otherwise 400 vorgang.zuweisenZiel — an account outside this area gets the same answer as an unknown one. Upper and lower case do not matter.

Answer 200: { "vorgang": { … }, "handlungen": [ … ] } — handlungen lists the actions this access may use next.

GET /vorgaenge — open tickets

Read route of the console interface of the uSuite, authorised like its other routes. Answer 200 with vorgaenge: the open tickets this access may see, in working order — overdue tickets first, then by severity and deadline. At most 500 entries, also if more tickets are overdue; anzahl then counts the overdue tickets that are not included. The answer also has a size limit: if the entries are too large, the history of each ticket is shortened step by step to the most recent entries; if that is not enough, entries at the end of the list are left out (the working order stays).

Field Meaning
abgeschnitten true if vorgaenge does not contain all open tickets: the list was shortened, or not all open tickets could be read.
anzahl New. { "offen", "gezeigt", "vollstaendigGelesen" }, plus weitereDringende and verlaufGekuerzt only when they apply — offen: open tickets read for this access; gezeigt: entries in vorgaenge; vollstaendigGelesen: false if not all open tickets could be read (then offen is not complete either); weitereDringende: overdue tickets that are not in vorgaenge; verlaufGekuerzt: true if the size limit applied.
verlaufGekuerzt in a ticket New. { "gezeigt", "gesamt" } — only on a ticket whose verlauf was shortened: gezeigt is the number of entries in verlauf (the most recent), gesamt the number of entries in the full history.

bilanz counts all open tickets read, not only those in vorgaenge.

Fields in every answer

The answers of POST /vorgang, POST /vorgang/{vorgangId}/handlung, GET /vorgaenge and GET /geraet/{seriennummer}/vorgaenge carry for every ticket:

Field Values
kategorie stoerung, auskunft, wartung, ersatzteil, schulung, reklamation, aenderungswunsch
status neu, inAnalyse, inBearbeitung, wartetKunde, wartetTeil, wartetEntwicklung, beobachten, geloest, geschlossen; wartetOhneAngabe for older tickets set to waiting without a reason
phase analyse, bearbeitung, kunde, teil, entwicklung, beobachten, geloest, geschlossen
einsatz { "termin", "art" } (vor-ort or fern) when the URG service has entered a service call

For tickets created before this change, kategorie and status are derived when read; stored tickets are not rewritten. Internal working fields of the URG service are not part of these answers.

Customer and partner accesses receive a ticket only with released fields and released entries of the case history. Every other field stays internal — also one that is added later. Creating and editing a ticket do not send an e-mail.


Service-Tickets — Schnittstelle (Kundensicht)

Stand 20.11.2026.

Für IT und Integrationspartner

Technische Referenz der Verwaltungsschnittstelle der uSuite. Sie beschreibt nur, was ein Zugang eines Kunden, eines Standorts oder eines Servicepartners sendet und erhält. Bedienung: Service-Tickets in der uSuite.

Gebaut, noch nicht ausgerollt

Die Änderungen auf dieser Seite sind gebaut und auf der Testseite in Abnahme; sie sind noch nicht ausgerollt. Sie gelten mit einem Update des Verwaltungsdienstes der uSuite.

Beide Routen liegen hinter der HTTP-Verwaltungsschnittstelle, werden mit derselben JWT-Prüfung wie die bestehenden Routen berechtigt und schreiben je Änderung eine Protokollzeile. Keine neue Route, kein neues Recht.

POST /vorgang — ein Ticket anlegen

Feld Bedeutung
seriennummer Gerät. Freiwillig: ohne Gerät entsteht ein Ticket ohne Gerät.
knoten Nur ohne Gerät: Pfad eines Kunden- oder Standortknotens, den der Zugang sehen darf. Ohne knoten gilt im aktuellen Stand der eigene Knoten des Zugangs.
kategorie stoerung, auskunft, wartung oder reklamation. Andere Kategorien vergibt der URG-Service: 403. Ohne kategorie (und ohne das frühere Feld anlass) ist das Ticket eine Frage (auskunft).
titel Kurzfassung, 3 bis 120 Zeichen. Pflicht.
beschreibung Einzelheiten, höchstens 2.000 Zeichen. Freiwillig.
dublette "dublette": "neu" legt das Ticket trotz Dublettenhinweis an.
dubletteVon vorgangId eines offenen Tickets aus dem Dublettenhinweis: das neue Ticket wird sofort geschlossen und damit verbunden.
trotzdem true legt das Ticket trotz Rückfrage zu Kontaktdaten an (siehe 409).

stoerung und wartung brauchen ein Gerät. Ohne Gerät gehen auskunft und reklamation.

Antwort Wann
201 { "vorgang": { … } } mit kategorie und status (siehe unten).
400 schluessel vorgang.kategorie (unbekannte Kategorie), vorgang.ohneGeraet (Störung oder Wartung ohne Gerät), vorgang.ohneOrt (kein Knoten), vorgang.knotenKunde (Knoten ist weder Kunde noch Standort), vorgang.dubletteVon (kein offenes Ticket aus dem Hinweis).
403 schluessel vorgang.kategorieKunde: diese Kategorie vergibt der URG-Service.
404 Gerät oder Knoten unbekannt oder für diesen Zugang nicht sichtbar — für beides dieselbe Antwort.
409 Dublettenhinweis: für dasselbe Gerät (ohne Gerät: denselben Knoten) gibt es ein offenes Ticket derselben Kategorie. Körper: fehler, hinweis, schluessel vorgang.dublette, dublette: true, dubletten — höchstens zehn Einträge mit vorgangId, titel, kategorie, status, angelegtAm (Millisekunden). Erneut senden mit "dublette": "neu" oder mit dubletteVon.
409 Rückfrage zu Kontaktdaten: titel oder beschreibung enthält zum Beispiel eine E-Mail-Adresse oder eine Telefonnummer. Körper: fehler, hinweis, schluessel kundentext.nachfrage, nachfrage: true, hinweise (wort, grund, stelle). Ist das gewollt, erneut senden mit "trotzdem": true.

Im aktuellen Stand hat der Dublettenhinweis kein Zeitfenster: jedes offene Ticket zählt.

POST /vorgang/{vorgangId}/handlung — geänderte Handlungen

Für Zugänge mit dem Recht, Vorgänge in ihrem Bereich zu bearbeiten.

handlung Neu oder geändert
annehmen Setzt die Phase analyse (Status inAnalyse).
phase Neu. phase: analyse oder bearbeitung; nur solange das Ticket in Arbeit ist. Derselbe Wert noch einmal: 409.
warten phase Pflicht: kunde, teil, entwicklung oder beobachten; sonst 400 vorgang.wartephase. entwicklung erst, wenn der URG-Service einen Entwicklungsvorgang verknüpft hat, sonst 400. text (Begründung) wie bisher.
schliessen phase Pflicht: geloest oder geschlossen; sonst 400 vorgang.schliessphase. text (Begründung) wie bisher.
zuweisen Neu. an: Mailadresse eines aktiven Kontos mit Servicerecht im eigenen Bereich des Zugangs, das das Ticket sehen darf; sonst 400 vorgang.zuweisenZiel — ein Konto außerhalb dieses Bereichs erhält dieselbe Antwort wie ein unbekanntes. Groß- und Kleinschreibung zählen nicht.

Antwort 200: { "vorgang": { … }, "handlungen": [ … ] } — handlungen nennt die Handlungen, die dieser Zugang als Nächstes ausführen darf.

GET /vorgaenge — offene Tickets

Leseroute der Konsolenschnittstelle der uSuite, berechtigt wie deren übrige Routen. Antwort 200 mit vorgaenge: die offenen Tickets, die dieser Zugang sehen darf, in Arbeitsreihenfolge — überfällige Tickets zuerst, dann nach Schwere und Frist. Höchstens 500 Einträge, auch wenn mehr Tickets überfällig sind; anzahl zählt dann die überfälligen Tickets, die fehlen. Die Antwort hat außerdem eine Größengrenze: Sind die Einträge zu groß, wird der Verlauf jedes Tickets stufenweise auf die jüngsten Einträge gekürzt; reicht das nicht, fallen Einträge am Ende der Liste weg (die Arbeitsreihenfolge bleibt).

Feld Bedeutung
abgeschnitten true, wenn vorgaenge nicht alle offenen Tickets enthält: die Liste ist gekürzt, oder es konnten nicht alle offenen Tickets gelesen werden.
anzahl Neu. { "offen", "gezeigt", "vollstaendigGelesen" }, dazu weitereDringende und verlaufGekuerzt nur, wenn sie zutreffen — offen: für diesen Zugang gelesene offene Tickets; gezeigt: Einträge in vorgaenge; vollstaendigGelesen: false, wenn nicht alle offenen Tickets gelesen werden konnten (dann ist auch offen nicht vollständig); weitereDringende: überfällige Tickets, die nicht in vorgaenge stehen; verlaufGekuerzt: true, wenn die Größengrenze gegriffen hat.
verlaufGekuerzt in einem Ticket Neu. { "gezeigt", "gesamt" } — nur an einem Ticket, dessen verlauf gekürzt ist: gezeigt ist die Zahl der Einträge in verlauf (die jüngsten), gesamt die Zahl der Einträge des ganzen Verlaufs.

bilanz zählt alle gelesenen offenen Tickets, nicht nur die in vorgaenge.

Felder in jeder Antwort

Die Antworten von POST /vorgang, POST /vorgang/{vorgangId}/handlung, GET /vorgaenge und GET /geraet/{seriennummer}/vorgaenge tragen für jedes Ticket:

Feld Werte
kategorie stoerung, auskunft, wartung, ersatzteil, schulung, reklamation, aenderungswunsch
status neu, inAnalyse, inBearbeitung, wartetKunde, wartetTeil, wartetEntwicklung, beobachten, geloest, geschlossen; wartetOhneAngabe für ältere Tickets, die ohne Angabe auf Warten gesetzt wurden
phase analyse, bearbeitung, kunde, teil, entwicklung, beobachten, geloest, geschlossen
einsatz { "termin", "art" } (vor-ort oder fern), wenn der URG-Service einen Einsatz eingetragen hat

Für Tickets von vor dieser Änderung werden kategorie und status beim Lesen abgeleitet; gespeicherte Tickets werden nicht umgeschrieben. Interne Arbeitsfelder des URG-Service sind nicht Teil dieser Antworten.

Kunden- und Partnerzugänge erhalten ein Ticket nur mit freigegebenen Feldern und freigegebenen Einträgen der Fallgeschichte. Jedes andere Feld bleibt intern — auch eines, das später hinzukommt. Anlegen und Bearbeiten eines Tickets verschicken keine E-Mail.


Tickets de service — interface (vue client)

État au 20.11.2026.

Pour l’informatique et les partenaires d’intégration

Référence technique de l’interface d’administration de l’uSuite. Elle décrit uniquement ce qu’un accès d’un client, d’un site ou d’un partenaire de service envoie et reçoit. Utilisation : Tickets de service dans l’uSuite.

Développé, pas encore déployé

Les modifications de cette page sont développées et en réception sur le site de test ; elles ne sont pas encore déployées. Elles s’appliquent avec une mise à jour du service d’administration de l’uSuite.

Les deux routes se trouvent derrière l’interface HTTP d’administration, sont autorisées par le même contrôle JWT que les routes existantes et écrivent une ligne de journal par modification. Aucune nouvelle route, aucun nouveau droit.

POST /vorgang — créer un ticket

Champ Signification
seriennummer Appareil. Facultatif : sans appareil, le ticket est créé sans appareil.
knoten Uniquement sans appareil : chemin d’un nœud client ou site visible pour l’accès. Sans knoten, le nœud propre de l’accès est utilisé dans l’état actuel.
kategorie stoerung, auskunft, wartung ou reklamation. Les autres catégories sont attribuées par le service URG : 403. Sans kategorie (et sans l’ancien champ anlass), le ticket est une question (auskunft).
titel Résumé, 3 à 120 caractères. Obligatoire.
beschreibung Détails, au plus 2 000 caractères. Facultatif.
dublette "dublette": "neu" crée le ticket malgré l’avertissement de doublon.
dubletteVon vorgangId d’un ticket ouvert de l’avertissement : le nouveau ticket est clôturé aussitôt et lié à celui-ci.
trotzdem true crée le ticket malgré la question sur des coordonnées (voir 409).

stoerung et wartung nécessitent un appareil. Sans appareil, auskunft et reklamation sont possibles.

Réponse Quand
201 { "vorgang": { … } } avec kategorie et status (voir ci-dessous).
400 schluessel vorgang.kategorie (catégorie inconnue), vorgang.ohneGeraet (panne ou maintenance sans appareil), vorgang.ohneOrt (aucun nœud), vorgang.knotenKunde (le nœud n’est ni client ni site), vorgang.dubletteVon (pas un ticket ouvert de l’avertissement).
403 schluessel vorgang.kategorieKunde : cette catégorie est attribuée par le service URG.
404 Appareil ou nœud inconnu ou non visible pour cet accès — même réponse dans les deux cas.
409 Avertissement de doublon : un ticket ouvert de la même catégorie existe pour le même appareil (sans appareil : pour le même nœud). Corps : fehler, hinweis, schluessel vorgang.dublette, dublette: true, dubletten — au plus dix entrées avec vorgangId, titel, kategorie, status, angelegtAm (millisecondes). Renvoyer avec "dublette": "neu" ou avec dubletteVon.
409 Question sur des coordonnées : titel ou beschreibung contient par exemple une adresse e-mail ou un numéro de téléphone. Corps : fehler, hinweis, schluessel kundentext.nachfrage, nachfrage: true, hinweise (wort, grund, stelle). Si c’est voulu, renvoyer avec "trotzdem": true.

Dans l’état actuel, l’avertissement de doublon n’a pas de fenêtre de temps : tout ticket ouvert compte.

POST /vorgang/{vorgangId}/handlung — actions modifiées

Pour les accès autorisés à traiter les dossiers de leur périmètre.

handlung Nouveau ou modifié
annehmen Fixe la phase analyse (statut inAnalyse).
phase Nouveau. phase : analyse ou bearbeitung ; seulement tant que le ticket est en cours. Même valeur une seconde fois : 409.
warten phase obligatoire : kunde, teil, entwicklung ou beobachten ; sinon 400 vorgang.wartephase. entwicklung uniquement une fois que le service URG a relié un dossier de développement, sinon 400. text (motif) comme avant.
schliessen phase obligatoire : geloest ou geschlossen ; sinon 400 vorgang.schliessphase. text (motif) comme avant.
zuweisen Nouveau. an : adresse e-mail d’un compte actif du propre périmètre de l’accès, disposant des droits de service et autorisé à voir le ticket ; sinon 400 vorgang.zuweisenZiel — un compte hors de ce périmètre reçoit la même réponse qu’un compte inconnu. Majuscules et minuscules sont indifférentes.

Réponse 200 : { "vorgang": { … }, "handlungen": [ … ] } — handlungen liste les actions que cet accès peut effectuer ensuite.

GET /vorgaenge — tickets ouverts

Route de lecture de l’interface console de l’uSuite, autorisée comme ses autres routes. Réponse 200 avec vorgaenge : les tickets ouverts que cet accès peut voir, dans l’ordre de travail — les tickets en retard d’abord, puis par gravité et échéance. Au plus 500 entrées, même si davantage de tickets sont en retard ; anzahl compte alors les tickets en retard qui manquent. La réponse a aussi une limite de taille : si les entrées sont trop grandes, l’historique de chaque ticket est raccourci par étapes aux entrées les plus récentes ; si cela ne suffit pas, des entrées en fin de liste sont omises (l’ordre de travail est conservé).

Champ Signification
abgeschnitten true si vorgaenge ne contient pas tous les tickets ouverts : la liste est raccourcie, ou tous les tickets ouverts n’ont pas pu être lus.
anzahl Nouveau. { "offen", "gezeigt", "vollstaendigGelesen" }, plus weitereDringende et verlaufGekuerzt seulement s’ils s’appliquent — offen : tickets ouverts lus pour cet accès ; gezeigt : entrées dans vorgaenge ; vollstaendigGelesen : false si tous les tickets ouverts n’ont pas pu être lus (offen n’est alors pas complet non plus) ; weitereDringende : tickets en retard absents de vorgaenge ; verlaufGekuerzt : true si la limite de taille s’est appliquée.
verlaufGekuerzt dans un ticket Nouveau. { "gezeigt", "gesamt" } — seulement sur un ticket dont le verlauf a été raccourci : gezeigt est le nombre d’entrées dans verlauf (les plus récentes), gesamt le nombre d’entrées de l’historique complet.

bilanz compte tous les tickets ouverts lus, pas seulement ceux de vorgaenge.

Champs de chaque réponse

Les réponses de POST /vorgang, POST /vorgang/{vorgangId}/handlung, GET /vorgaenge et GET /geraet/{seriennummer}/vorgaenge contiennent pour chaque ticket :

Champ Valeurs
kategorie stoerung, auskunft, wartung, ersatzteil, schulung, reklamation, aenderungswunsch
status neu, inAnalyse, inBearbeitung, wartetKunde, wartetTeil, wartetEntwicklung, beobachten, geloest, geschlossen ; wartetOhneAngabe pour les tickets plus anciens mis en attente sans indication
phase analyse, bearbeitung, kunde, teil, entwicklung, beobachten, geloest, geschlossen
einsatz { "termin", "art" } (vor-ort ou fern) lorsque le service URG a saisi une intervention

Pour les tickets créés avant cette modification, kategorie et status sont déduits à la lecture ; les tickets enregistrés ne sont pas réécrits. Les champs de travail internes du service URG ne font pas partie de ces réponses.

Les accès clients et partenaires reçoivent un ticket uniquement avec les champs autorisés et les entrées autorisées de l’historique. Tout autre champ reste interne — y compris un champ ajouté plus tard. Créer et traiter un ticket n’envoient pas d’e-mail.


Tickets de servicio — interfaz (vista del cliente)

Estado a 20.11.2026.

Para TI y socios de integración

Referencia técnica de la interfaz de administración de la uSuite. Describe solo lo que envía y recibe un acceso de un cliente, una ubicación o un socio de servicio. Manejo: Tickets de servicio en la uSuite.

Desarrollado, aún no desplegado

Los cambios de esta página están desarrollados y en recepción en el sitio de pruebas; todavía no se han desplegado. Se aplican con una actualización del servicio de administración de la uSuite.

Ambas rutas están detrás de la interfaz HTTP de administración, se autorizan con la misma comprobación JWT que las rutas existentes y escriben una línea de registro por cambio. Ninguna ruta nueva, ningún derecho nuevo.

POST /vorgang — crear un ticket

Campo Significado
seriennummer Equipo. Opcional: sin equipo, el ticket se crea sin equipo.
knoten Solo sin equipo: ruta de un nodo de cliente o de ubicación visible para el acceso. Sin knoten, en el estado actual se usa el nodo propio del acceso.
kategorie stoerung, auskunft, wartung o reklamation. Las demás categorías las asigna el servicio de URG: 403. Sin kategorie (y sin el campo anterior anlass) el ticket es una pregunta (auskunft).
titel Resumen, de 3 a 120 caracteres. Obligatorio.
beschreibung Detalles, como máximo 2.000 caracteres. Opcional.
dublette "dublette": "neu" crea el ticket pese al aviso de duplicado.
dubletteVon vorgangId de un ticket abierto del aviso de duplicado: el ticket nuevo se cierra de inmediato y se vincula a él.
trotzdem true crea el ticket pese a la consulta sobre datos de contacto (ver 409).

stoerung y wartung necesitan un equipo. Sin equipo son posibles auskunft y reklamation.

Respuesta Cuándo
201 { "vorgang": { … } } con kategorie y status (véase abajo).
400 schluessel vorgang.kategorie (categoría desconocida), vorgang.ohneGeraet (avería o mantenimiento sin equipo), vorgang.ohneOrt (sin nodo), vorgang.knotenKunde (el nodo no es ni cliente ni ubicación), vorgang.dubletteVon (no es un ticket abierto del aviso).
403 schluessel vorgang.kategorieKunde: esta categoría la asigna el servicio de URG.
404 Equipo o nodo desconocido o no visible para este acceso — la misma respuesta en ambos casos.
409 Aviso de duplicado: existe un ticket abierto de la misma categoría para el mismo equipo (sin equipo: para el mismo nodo). Cuerpo: fehler, hinweis, schluessel vorgang.dublette, dublette: true, dubletten — como máximo diez entradas con vorgangId, titel, kategorie, status, angelegtAm (milisegundos). Enviar de nuevo con "dublette": "neu" o con dubletteVon.
409 Consulta sobre datos de contacto: titel o beschreibung contiene, por ejemplo, una dirección de correo electrónico o un número de teléfono. Cuerpo: fehler, hinweis, schluessel kundentext.nachfrage, nachfrage: true, hinweise (wort, grund, stelle). Si es intencionado, enviar de nuevo con "trotzdem": true.

En el estado actual, el aviso de duplicado no tiene ventana de tiempo: cuenta todo ticket abierto.

POST /vorgang/{vorgangId}/handlung — acciones modificadas

Para accesos con derecho a tramitar casos en su ámbito.

handlung Nuevo o modificado
annehmen Fija la fase analyse (estado inAnalyse).
phase Nuevo. phase: analyse o bearbeitung; solo mientras el ticket está en curso. El mismo valor otra vez: 409.
warten phase obligatoria: kunde, teil, entwicklung o beobachten; si no, 400 vorgang.wartephase. entwicklung solo cuando el servicio de URG ha vinculado un caso de desarrollo; si no, 400. text (motivo) como antes.
schliessen phase obligatoria: geloest o geschlossen; si no, 400 vorgang.schliessphase. text (motivo) como antes.
zuweisen Nuevo. an: correo electrónico de una cuenta activa del propio ámbito del acceso, con derechos de servicio, que pueda ver el ticket; si no, 400 vorgang.zuweisenZiel — una cuenta fuera de este ámbito recibe la misma respuesta que una desconocida. Mayúsculas y minúsculas dan igual.

Respuesta 200: { "vorgang": { … }, "handlungen": [ … ] } — handlungen enumera las acciones que este acceso puede ejecutar a continuación.

GET /vorgaenge — tickets abiertos

Ruta de lectura de la interfaz de consola de la uSuite, autorizada como sus demás rutas. Respuesta 200 con vorgaenge: los tickets abiertos que este acceso puede ver, en orden de trabajo — primero los tickets vencidos, luego por gravedad y plazo. Como máximo 500 entradas, aunque haya más tickets vencidos; anzahl cuenta entonces los tickets vencidos que faltan. La respuesta tiene además un límite de tamaño: si las entradas son demasiado grandes, el historial de cada ticket se acorta por etapas a las entradas más recientes; si no basta, se omiten entradas al final de la lista (el orden de trabajo se mantiene).

Campo Significado
abgeschnitten true si vorgaenge no contiene todos los tickets abiertos: la lista está acortada o no se pudieron leer todos los tickets abiertos.
anzahl Nuevo. { "offen", "gezeigt", "vollstaendigGelesen" }, más weitereDringende y verlaufGekuerzt solo cuando proceden — offen: tickets abiertos leídos para este acceso; gezeigt: entradas en vorgaenge; vollstaendigGelesen: false si no se pudieron leer todos los tickets abiertos (entonces offen tampoco está completo); weitereDringende: tickets vencidos que no están en vorgaenge; verlaufGekuerzt: true si se aplicó el límite de tamaño.
verlaufGekuerzt en un ticket Nuevo. { "gezeigt", "gesamt" } — solo en un ticket cuyo verlauf se acortó: gezeigt es el número de entradas en verlauf (las más recientes), gesamt el número de entradas del historial completo.

bilanz cuenta todos los tickets abiertos leídos, no solo los de vorgaenge.

Campos de cada respuesta

Las respuestas de POST /vorgang, POST /vorgang/{vorgangId}/handlung, GET /vorgaenge y GET /geraet/{seriennummer}/vorgaenge contienen para cada ticket:

Campo Valores
kategorie stoerung, auskunft, wartung, ersatzteil, schulung, reklamation, aenderungswunsch
status neu, inAnalyse, inBearbeitung, wartetKunde, wartetTeil, wartetEntwicklung, beobachten, geloest, geschlossen; wartetOhneAngabe para tickets más antiguos puestos en espera sin indicación
phase analyse, bearbeitung, kunde, teil, entwicklung, beobachten, geloest, geschlossen
einsatz { "termin", "art" } (vor-ort o fern) cuando el servicio de URG ha registrado una intervención

Para los tickets creados antes de este cambio, kategorie y status se derivan al leer; los tickets guardados no se reescriben. Los campos de trabajo internos del servicio de URG no forman parte de estas respuestas.

Los accesos de clientes y socios reciben un ticket solo con los campos autorizados y las entradas autorizadas del historial. Cualquier otro campo permanece interno, también uno que se añada más adelante. Crear y tramitar un ticket no envían ningún correo electrónico.


Ticket di assistenza — interfaccia (vista cliente)

Stato al 20.11.2026.

Per IT e partner di integrazione

Riferimento tecnico dell’interfaccia di amministrazione dell’uSuite. Descrive solo ciò che un accesso di un cliente, di una sede o di un partner di assistenza invia e riceve. Uso: Ticket di assistenza nell’uSuite.

Realizzato, non ancora distribuito

Le modifiche di questa pagina sono realizzate e in collaudo sul sito di prova; non sono ancora state distribuite. Si applicano con un aggiornamento del servizio di amministrazione dell’uSuite.

Entrambe le route si trovano dietro l’interfaccia HTTP di amministrazione, sono autorizzate con lo stesso controllo JWT delle route esistenti e scrivono una riga di registro per ogni modifica. Nessuna nuova route, nessun nuovo diritto.

POST /vorgang — creare un ticket

Campo Significato
seriennummer Dispositivo. Facoltativo: senza dispositivo il ticket viene creato senza dispositivo.
knoten Solo senza dispositivo: percorso di un nodo cliente o sede visibile per l’accesso. Senza knoten, nello stato attuale si usa il nodo proprio dell’accesso.
kategorie stoerung, auskunft, wartung o reklamation. Le altre categorie le assegna l’assistenza URG: 403. Senza kategorie (e senza il campo precedente anlass) il ticket è una domanda (auskunft).
titel Sintesi, da 3 a 120 caratteri. Obbligatorio.
beschreibung Dettagli, al massimo 2.000 caratteri. Facoltativo.
dublette "dublette": "neu" crea il ticket nonostante l’avviso di duplicato.
dubletteVon vorgangId di un ticket aperto dell’avviso: il nuovo ticket viene chiuso subito e collegato a esso.
trotzdem true crea il ticket nonostante la richiesta sui dati di contatto (vedi 409).

stoerung e wartung richiedono un dispositivo. Senza dispositivo sono possibili auskunft e reklamation.

Risposta Quando
201 { "vorgang": { … } } con kategorie e status (vedi sotto).
400 schluessel vorgang.kategorie (categoria sconosciuta), vorgang.ohneGeraet (guasto o manutenzione senza dispositivo), vorgang.ohneOrt (nessun nodo), vorgang.knotenKunde (il nodo non è né cliente né sede), vorgang.dubletteVon (non è un ticket aperto dell’avviso).
403 schluessel vorgang.kategorieKunde: questa categoria la assegna l’assistenza URG.
404 Dispositivo o nodo sconosciuto o non visibile per questo accesso — stessa risposta in entrambi i casi.
409 Avviso di duplicato: esiste un ticket aperto della stessa categoria per lo stesso dispositivo (senza dispositivo: per lo stesso nodo). Corpo: fehler, hinweis, schluessel vorgang.dublette, dublette: true, dubletten — al massimo dieci voci con vorgangId, titel, kategorie, status, angelegtAm (millisecondi). Inviare di nuovo con "dublette": "neu" o con dubletteVon.
409 Richiesta sui dati di contatto: titel o beschreibung contiene, ad esempio, un indirizzo e-mail o un numero di telefono. Corpo: fehler, hinweis, schluessel kundentext.nachfrage, nachfrage: true, hinweise (wort, grund, stelle). Se è voluto, inviare di nuovo con "trotzdem": true.

Nello stato attuale l’avviso di duplicato non ha una finestra temporale: conta ogni ticket aperto.

POST /vorgang/{vorgangId}/handlung — azioni modificate

Per gli accessi autorizzati a gestire le pratiche del proprio ambito.

handlung Nuovo o modificato
annehmen Imposta la fase analyse (stato inAnalyse).
phase Nuovo. phase: analyse o bearbeitung; solo finché il ticket è in lavorazione. Stesso valore di nuovo: 409.
warten phase obbligatoria: kunde, teil, entwicklung o beobachten; altrimenti 400 vorgang.wartephase. entwicklung solo dopo che l’assistenza URG ha collegato una pratica di sviluppo, altrimenti 400. text (motivazione) come prima.
schliessen phase obbligatoria: geloest o geschlossen; altrimenti 400 vorgang.schliessphase. text (motivazione) come prima.
zuweisen Nuovo. an: indirizzo e-mail di un account attivo del proprio ambito dell’accesso, con diritti di assistenza, che può vedere il ticket; altrimenti 400 vorgang.zuweisenZiel — un account fuori da questo ambito riceve la stessa risposta di uno sconosciuto. Maiuscole e minuscole non contano.

Risposta 200: { "vorgang": { … }, "handlungen": [ … ] } — handlungen elenca le azioni che questo accesso può eseguire dopo.

GET /vorgaenge — ticket aperti

Rotta di lettura dell’interfaccia console dell’uSuite, autorizzata come le sue altre rotte. Risposta 200 con vorgaenge: i ticket aperti che questo accesso può vedere, in ordine di lavoro — prima i ticket scaduti, poi per gravità e scadenza. Al massimo 500 voci, anche se i ticket scaduti sono di più; anzahl conta allora i ticket scaduti che mancano. La risposta ha anche un limite di dimensione: se le voci sono troppo grandi, la cronologia di ogni ticket viene abbreviata per gradi alle voci più recenti; se non basta, vengono omesse voci in fondo all’elenco (l’ordine di lavoro resta).

Campo Significato
abgeschnitten true se vorgaenge non contiene tutti i ticket aperti: l’elenco è abbreviato, oppure non è stato possibile leggere tutti i ticket aperti.
anzahl Nuovo. { "offen", "gezeigt", "vollstaendigGelesen" }, più weitereDringende e verlaufGekuerzt solo quando si applicano — offen: ticket aperti letti per questo accesso; gezeigt: voci in vorgaenge; vollstaendigGelesen: false se non è stato possibile leggere tutti i ticket aperti (allora anche offen non è completo); weitereDringende: ticket scaduti che non sono in vorgaenge; verlaufGekuerzt: true se è intervenuto il limite di dimensione.
verlaufGekuerzt in un ticket Nuovo. { "gezeigt", "gesamt" } — solo su un ticket il cui verlauf è stato abbreviato: gezeigt è il numero di voci in verlauf (le più recenti), gesamt il numero di voci della cronologia completa.

bilanz conta tutti i ticket aperti letti, non solo quelli in vorgaenge.

Campi di ogni risposta

Le risposte di POST /vorgang, POST /vorgang/{vorgangId}/handlung, GET /vorgaenge e GET /geraet/{seriennummer}/vorgaenge contengono per ogni ticket:

Campo Valori
kategorie stoerung, auskunft, wartung, ersatzteil, schulung, reklamation, aenderungswunsch
status neu, inAnalyse, inBearbeitung, wartetKunde, wartetTeil, wartetEntwicklung, beobachten, geloest, geschlossen; wartetOhneAngabe per ticket meno recenti messi in attesa senza indicazione
phase analyse, bearbeitung, kunde, teil, entwicklung, beobachten, geloest, geschlossen
einsatz { "termin", "art" } (vor-ort o fern) quando l’assistenza URG ha inserito un intervento

Per i ticket creati prima di questa modifica, kategorie e status vengono derivati in lettura; i ticket salvati non vengono riscritti. I campi di lavoro interni dell’assistenza URG non fanno parte di queste risposte.

Gli accessi di clienti e partner ricevono un ticket solo con i campi autorizzati e le voci autorizzate della cronologia. Ogni altro campo resta interno, anche uno aggiunto in seguito. Creare e gestire un ticket non inviano alcuna e-mail.


Servicetickets — interface (klantweergave)

Stand 20.11.2026.

Voor IT en integratiepartners

Technische referentie van de beheerinterface van de uSuite. Ze beschrijft alleen wat een toegang van een klant, een locatie of een servicepartner verstuurt en ontvangt. Bediening: Servicetickets in de uSuite.

Gebouwd, nog niet uitgerold

De wijzigingen op deze pagina zijn gebouwd en worden op de testsite geaccepteerd; ze zijn nog niet uitgerold. Ze gelden met een update van de beheerdienst van de uSuite.

Beide routes liggen achter de HTTP-beheerinterface, worden met dezelfde JWT-controle als de bestaande routes geautoriseerd en schrijven per wijziging een logregel. Geen nieuwe route, geen nieuw recht.

POST /vorgang — een ticket aanmaken

Veld Betekenis
seriennummer Apparaat. Optioneel: zonder apparaat ontstaat een ticket zonder apparaat.
knoten Alleen zonder apparaat: pad van een klant- of locatieknooppunt dat de toegang mag zien. Zonder knoten geldt in de huidige stand het eigen knooppunt van de toegang.
kategorie stoerung, auskunft, wartung of reklamation. Andere categorieën kent de URG-service toe: 403. Zonder kategorie (en zonder het eerdere veld anlass) is het ticket een vraag (auskunft).
titel Samenvatting, 3 tot 120 tekens. Verplicht.
beschreibung Details, hoogstens 2.000 tekens. Optioneel.
dublette "dublette": "neu" maakt het ticket ondanks de duplicaatmelding aan.
dubletteVon vorgangId van een open ticket uit de duplicaatmelding: het nieuwe ticket wordt meteen gesloten en daaraan gekoppeld.
trotzdem true maakt het ticket aan ondanks de vraag over contactgegevens (zie 409).

stoerung en wartung hebben een apparaat nodig. Zonder apparaat zijn auskunft en reklamation mogelijk.

Antwoord Wanneer
201 { "vorgang": { … } } met kategorie en status (zie hieronder).
400 schluessel vorgang.kategorie (onbekende categorie), vorgang.ohneGeraet (storing of onderhoud zonder apparaat), vorgang.ohneOrt (geen knooppunt), vorgang.knotenKunde (knooppunt is klant noch locatie), vorgang.dubletteVon (geen open ticket uit de melding).
403 schluessel vorgang.kategorieKunde: deze categorie kent de URG-service toe.
404 Apparaat of knooppunt onbekend of niet zichtbaar voor deze toegang — voor beide hetzelfde antwoord.
409 Duplicaatmelding: voor hetzelfde apparaat (zonder apparaat: hetzelfde knooppunt) bestaat een open ticket van dezelfde categorie. Body: fehler, hinweis, schluessel vorgang.dublette, dublette: true, dubletten — hoogstens tien items met vorgangId, titel, kategorie, status, angelegtAm (milliseconden). Opnieuw versturen met "dublette": "neu" of met dubletteVon.
409 Vraag over contactgegevens: titel of beschreibung bevat bijvoorbeeld een e-mailadres of een telefoonnummer. Body: fehler, hinweis, schluessel kundentext.nachfrage, nachfrage: true, hinweise (wort, grund, stelle). Is dat bedoeld, opnieuw verzenden met "trotzdem": true.

In de huidige stand heeft de duplicaatmelding geen tijdvenster: elk open ticket telt.

POST /vorgang/{vorgangId}/handlung — gewijzigde handelingen

Voor toegangen met het recht om meldingen in hun gebied te behandelen.

handlung Nieuw of gewijzigd
annehmen Zet de fase analyse (status inAnalyse).
phase Nieuw. phase: analyse of bearbeitung; alleen zolang het ticket in behandeling is. Dezelfde waarde nogmaals: 409.
warten phase verplicht: kunde, teil, entwicklung of beobachten; anders 400 vorgang.wartephase. entwicklung pas als de URG-service een ontwikkelingsmelding heeft gekoppeld, anders 400. text (reden) zoals voorheen.
schliessen phase verplicht: geloest of geschlossen; anders 400 vorgang.schliessphase. text (reden) zoals voorheen.
zuweisen Nieuw. an: e-mailadres van een actief account binnen het eigen gebied van de toegang, met servicerechten, dat het ticket mag zien; anders 400 vorgang.zuweisenZiel — een account buiten dit gebied krijgt hetzelfde antwoord als een onbekend account. Hoofd- en kleine letters maken niet uit.

Antwoord 200: { "vorgang": { … }, "handlungen": [ … ] } — handlungen noemt de handelingen die deze toegang hierna mag uitvoeren.

GET /vorgaenge — open tickets

Leesroute van de console-interface van de uSuite, geautoriseerd zoals de andere routes daarvan. Antwoord 200 met vorgaenge: de open tickets die deze toegang mag zien, in werkvolgorde — achterstallige tickets eerst, dan op ernst en termijn. Hoogstens 500 items, ook als meer tickets achterstallig zijn; anzahl telt dan de achterstallige tickets die ontbreken. Het antwoord heeft ook een groottegrens: zijn de items te groot, dan wordt de geschiedenis van elk ticket stapsgewijs ingekort tot de meest recente items; is dat niet genoeg, dan vallen items aan het einde van de lijst weg (de werkvolgorde blijft).

Veld Betekenis
abgeschnitten true als vorgaenge niet alle open tickets bevat: de lijst is ingekort, of niet alle open tickets konden worden gelezen.
anzahl Nieuw. { "offen", "gezeigt", "vollstaendigGelesen" }, plus weitereDringende en verlaufGekuerzt alleen als ze van toepassing zijn — offen: voor deze toegang gelezen open tickets; gezeigt: items in vorgaenge; vollstaendigGelesen: false als niet alle open tickets konden worden gelezen (dan is ook offen niet volledig); weitereDringende: achterstallige tickets die niet in vorgaenge staan; verlaufGekuerzt: true als de groottegrens is toegepast.
verlaufGekuerzt in een ticket Nieuw. { "gezeigt", "gesamt" } — alleen bij een ticket waarvan de verlauf is ingekort: gezeigt is het aantal items in verlauf (de meest recente), gesamt het aantal items van de volledige geschiedenis.

bilanz telt alle gelezen open tickets, niet alleen die in vorgaenge.

Velden in elk antwoord

De antwoorden van POST /vorgang, POST /vorgang/{vorgangId}/handlung, GET /vorgaenge en GET /geraet/{seriennummer}/vorgaenge bevatten voor elk ticket:

Veld Waarden
kategorie stoerung, auskunft, wartung, ersatzteil, schulung, reklamation, aenderungswunsch
status neu, inAnalyse, inBearbeitung, wartetKunde, wartetTeil, wartetEntwicklung, beobachten, geloest, geschlossen; wartetOhneAngabe voor oudere tickets die zonder opgave op wachten zijn gezet
phase analyse, bearbeitung, kunde, teil, entwicklung, beobachten, geloest, geschlossen
einsatz { "termin", "art" } (vor-ort of fern) wanneer de URG-service een inzet heeft ingevoerd

Voor tickets van vóór deze wijziging worden kategorie en status bij het lezen afgeleid; opgeslagen tickets worden niet herschreven. Interne werkvelden van de URG-service maken geen deel uit van deze antwoorden.

Toegangen van klanten en partners krijgen een ticket alleen met vrijgegeven velden en vrijgegeven items van de geschiedenis. Elk ander veld blijft intern — ook een veld dat later wordt toegevoegd. Een ticket aanmaken en behandelen versturen geen e-mail.