Servex : pas de commande dans l'API, mais un appel de service avec ses lignes

S’applique àServexAcombaEntitésWorkOrderCustomerOrderCustomerInvoice

Réponse courte

L'API n'expose pas les commandes de Servex. Ce qui est intégré, c'est l'appel de service (WorkOrder), en lecture et en création, avec ses lignes de produits. Il ressemble beaucoup à une transaction, et un client s'en sert déjà pour inscrire dans Servex les commandes reçues de sa plateforme web. Si votre besoin est « une commande dans Servex avec les lignes d'un document », c'est un appel de service qu'il faut créer.

Le montage

1. Lire les lignes du document : une facture, une commande ou une soumission de la compagnie Acomba se lit par l'API Acomba (GET /api/Entity/CustomerOrder, CustomerInvoice…), avec ses lignes. Voir Composer une requête.
2. Créer l'appel de service : POST /api/Entity/WorkOrder sur la connexion Servex, avec le client (CustomerId = NoUniqueSystemeSource du client Acomba), le technicien, le répartiteur, le mode de paiement, et ProductLines : une ligne par item, ProductId = NoUniqueSystemeSource du produit Acomba, quantités, prix, et ExtendedProperties.Cost (obligatoire). Le numéro d'appel est attribué par Servex et retourné.
3. Garder le lien : ExtendedProperties.ReferenceOrderNumber reçoit le numéro du document d'origine (par exemple le NoFacture de la commande Acomba), et ProblemNote ou ReferenceNote ce que vous voulez retrouver dans l'appel.

À savoir

• Un appel de service se crée mais ne se modifie pas par l'API, et ses lignes ne sont pas relues à l'extraction.
• Les numéros de technicien, de répartiteur et de statut viennent des listes de Servex (GET /api/Entity/WorkOrderTechnician, WorkOrderDispatcher, WorkOrderStatus).
• Tout le détail : Connecter Servex et WorkOrder.