AcumatiCares
L’un des plus grands attraits de la plate-forme Acumatica est son API robuste et facile à utiliser. Ici, je vais vous montrer comment vous pouvez étendre un point de terminaison de service Web et ajouter des entités personnalisées à un objet. Un de nos clients avait l’obligation d’apporter des détails fiscaux d’un autre système dans un document de vente au comptant.
Dans certains cas, la déclaration des transactions d’un autre système comme Lightspeed doit être saisie en tant que documents de vente au comptant dans Acumatica sans les recalculer. Nous voulions éviter les écarts de valeurs décimales dus à des recalculs au sein d’un autre système. L’objectif était d’attirer les taux d’imposition et les montants imposables de Lightspeed tel quel dans Acumatica. Le résultat souhaité est dans la capture d’écran ci-dessous et les étapes suivantes vous y parviendront.
Il y a une section de détails fiscaux dans le document De ventes au comptant, mais il n’a pas été exposé par l’API.
Si vous utilisez Acumatica 2020R2 ou version ultérieure, vous devrez prendre le point de terminaison par défaut dans la version 20.200.001 et l’étendre. Donnez au point de terminaison un nom et un numéro de version. En règle générale, je fais correspondre le numéro de version de celui que j’étends, comme vous pouvez le voir dans l’exemple ci-dessous dans la version 20.200.001 de point de terminaison.
J’essaie de faire correspondre le numéro de version du point de terminaison avec celui que j’étends à des fins de cohérence :
Une fois que le point de terminaison a été étendu, vous allez au niveau supérieur de l’objet (Ventes au comptant), et cliquez sur INSERT, vous verrez l’écran d’entrée suivant.
Je remplis les informations requises pour créer un objet de détail fiscal au niveau de détail :
À partir de là, j’ajoute les champs nécessaires à l’objet de détails nouvellement défini qui existe déjà dans Acumatica.
Afin de tester l’API étendue, nous tirons parti de l’utilitaire Postman qui est utilisé dans la certification Integrations d’Acumatica. En utilisant Postman, je confirme que l’objet TaxDetails fonctionne comme prévu.
Et voici le code auquel vous pouvez accéder dans Github avec un lien vers le GIST.
GIST : https://gist.github.com/kulvirTAC/669fc94ff72abf7f2364db9df3389791
Comme vous pouvez le voir, il s’agit d’un processus assez simple et simple, qui est très efficace en utilisant une approche low code / no code que la plate-forme Acumatica fournit pour des tâches de développement triviales. Toute la bonté d’une API REST robuste avec la flexibilité de l’étendre avec des objets personnalisés et d’extraire des champs existants.
Bon codage!
