Aller au contenu
Documentation TrakIT

ReopenWO

Rouvre les ordres de travail clôturés ou annulés que vous listez, comme le fait Re-open Work Order sur la page Ordre de travail. Utilisez-le pour revenir sur un CloseWO ou un CancelWO, ou pour rouvrir un ordre de travail que TrakIT a clôturé de lui-même.

Comment se connecter et lire la réponse : Authentification, Réponses.

POST /api/v1/ReopenWO
Token: your-token
Content-Type: application/json
[48211, 48212, 48299]
Champ Obligatoire Signification
Le corps Oui Une liste JSON d’identifiants d’ordres de travail, des nombres entiers. Pas un objet : la liste elle-même est le corps.

TrakIT rouvre les ordres de travail un par un, dans l’ordre de la liste. Chacun est rouvert ou refusé séparément : un refus n’arrête pas les autres et ne revient pas sur ceux déjà rouverts. Les autres ordres de travail de leurs dossiers ne sont pas rouverts.

Règles

Section intitulée « Règles »

Pour la requête :

Règle Info en cas d’échec
L’en-tête Token contient un jeton valide. Token missing in header, Token invalid or expired, ou une autre réponse listée dans Jeton de connexion
L’utilisateur est un administrateur système avec un accès à l’API. API User must be SysAdmin with API Access
Le corps est une liste d’au moins un identifiant. No WO IDs supplied

Pour chaque ordre de travail, dans le Info de son élément dans RetInfo :

Règle Info en cas d’échec
Un ordre de travail a cet identifiant. No such work order
L’ordre de travail est clôturé ou annulé. Work Order(s) already open
Les validations de votre société pour Save WO Header, Save Job Header et Re-Open WO sont satisfaites. Leurs propres messages

Réponse

Section intitulée « Réponse »

RetInfo contient un élément pour chaque identifiant, dans l’ordre où vous les avez envoyés. RowsAffected est le nombre d’ordres de travail rouverts. Code vaut 1 quand au moins un a été rouvert, et 0 quand aucun ne l’a été ; Info est vide dans les deux cas. Lisez toujours les éléments.

{
  "Code": 1,
  "Info": "",
  "RetInfo": [
    { "WOID": 48211, "Success": true, "Info": "" },
    { "WOID": 48212, "Success": false, "Info": "Work Order(s) already open" },
    { "WOID": 48299, "Success": false, "Info": "No such work order" }
  ],
  "RowsAffected": 1,
  "Scalar": null,
  "Identity": 0
}
Champ Signification
WOID L’identifiant de l’ordre de travail, tel que vous l’avez envoyé.
Success true quand l’ordre de travail a été rouvert, false quand il a été refusé.
Info La raison du refus de l’ordre de travail. Vide quand il a été rouvert.

Notes

Section intitulée « Notes »
  • Un ordre de travail rouvert prend le statut Active (0 dans GetWO), et perd sa date de clôture ainsi que l’utilisateur qui l’avait clôturé ou annulé. Son journal d’audit indique Reopened via API.
  • TrakIT exécute ensuite les actions de votre société pour Re-Open WO. Aucune notification n’est envoyée.
  • Rouvrir un ordre de travail annulé ne le remet pas dans le suivi des retards et ne lui lie pas de nouveau ses mouvements de parc.
  • Si une requête expire, vous pouvez la renvoyer : les ordres de travail déjà rouverts sont refusés avec Work Order(s) already open et restent ouverts.