Connecter Servex : les appels de service par l'API

S’applique àServexAcombaEntitésWorkOrder

Servex est un logiciel de gestion des appels de service qui travaille avec Acomba : ses clients, produits, fournisseurs et vendeurs sont ceux de la compagnie Acomba. Le connecteur lit et crée ses appels de service directement dans sa base de données, sans pont Acomba.

Comment ça se branche

• Par la base de données. Servex garde ses appels dans une base SQL Server. Le connecteur s'y connecte avec une chaîne de connexion, à travers l'agent installé chez le client, comme pour Acomba ; aucun port entrant à ouvrir, voir Installer l'agent.
• Avec l'équipe Conexio. Il n'y a pas de formulaire libre-service pour Servex dans le portail : la connexion se configure avec nous, à partir de la chaîne de connexion à la base de Servex. Écrivez-nous avec le nom de la compagnie Acomba jumelée.
• La même compagnie Acomba. Un appel de service pointe vers un client, des produits, des fournisseurs et un vendeur par leurs identifiants Acomba (NoUniqueSystemeSource, le CardPos). Les fiches se lisent par l'API Acomba de la compagnie, avec la même licence.

Ce que l'API expose

Appel	Ce que ça fait
GET /api/Entity/WorkOrder	lit les appels de service : un seul filtre à la fois (Id ou WorkOrderNumber en eq / in, LastModifiedDate en gt, ge, lt, le) ; $expand=ExtendedProperties pour le statut, les notes et le journal
POST /api/Entity/WorkOrder	crée un appel de service, avec ou sans lignes de produits ; le numéro d'appel est attribué par Servex et retourné
GET /api/Entity/WorkOrderStatus, WorkOrderType, WorkOrderTechnician, WorkOrderDispatcher	les listes de référence de Servex (numéro et libellé), pour remplir un appel

À la création, quatre champs sont obligatoires : CustomerId (CardPos du client Acomba), TechnicianNumber, DispatcherNumber (numéros des listes ci-dessus) et PaymentMethod (le mode de paiement par défaut de la compagnie, CompanyInfo.ARDefaultPaymentMode dans Acomba). Chaque ligne de produit doit porter ExtendedProperties.Cost. Les noms du technicien et du répartiteur, les types d'appel, la priorité et les codes de travail sont remplis par Servex à partir de sa configuration : inutile de les envoyer.

Le détail des champs, du modèle et des exemples : WorkOrder et la matrice Servex.

Limites à connaître

• $top et $skip ne s'appliquent pas à la lecture : la table complète (filtrée) est retournée.
• Les lignes de produits ne sont pas relues : un GET rend l'en-tête seulement.
• Pas de modification ni de suppression d'un appel par l'API.
• Un appel de service n'est pas une commande : voir Peut-on créer une commande dans Servex ?.