{"id":980,"date":"2026-06-07T14:26:52","date_gmt":"2026-06-07T14:26:52","guid":{"rendered":"https:\/\/www.stagereturn.com\/?page_id=980"},"modified":"2026-07-12T16:08:13","modified_gmt":"2026-07-12T16:08:13","slug":"api-integrations-erp","status":"publish","type":"page","link":"https:\/\/www.stagereturn.com\/en\/centre-aide\/api-integrations-erp\/","title":{"rendered":"API Int\u00e9grations ERP"},"content":{"rendered":"<style>\n.sr-guide-page{\n  max-width:980px;\n  margin:0 auto;\n  padding:150px 20px 70px;\n  font-family:inherit;\n  color:#252b3a;\n}\n\n.sr-back-link{\n  display:inline-block;\n  margin-bottom:18px;\n  color:#ff6a00;\n  font-weight:700;\n  text-decoration:none;\n}\n\n.sr-back-link:hover{\n  text-decoration:underline;\n}\n\n.sr-guide-badge{\n  display:inline-block;\n  background:#fff3e8;\n  color:#ff6a00;\n  font-weight:700;\n  padding:8px 16px;\n  border-radius:999px;\n  margin-bottom:18px;\n}\n\n.sr-api-doc-button{\n  display:inline-flex;\n  align-items:center;\n  gap:10px;\n  background:#fff;\n  color:#ff6a00;\n  border:2px solid #ff6a00;\n  font-weight:800;\n  font-size:15px;\n  padding:11px 20px;\n  border-radius:999px;\n  text-decoration:none;\n  box-shadow:0 10px 24px rgba(20,30,60,.08);\n  transition:all .25s ease;\n}\n\n.sr-api-doc-button:hover{\n  background:#ff6a00;\n  color:#fff;\n  transform:translateY(-2px);\n  box-shadow:0 14px 28px rgba(255,106,0,.22);\n}\n\n.sr-guide-hero{\n  text-align:center;\n  margin-bottom:42px;\n}\n\n.sr-guide-hero h1{\n  font-size:clamp(34px,5vw,56px);\n  line-height:1.1;\n  margin:0 0 18px;\n  color:#252b3a;\n}\n\n.sr-guide-hero p{\n  max-width:820px;\n  margin:0 auto;\n  font-size:18px;\n  line-height:1.7;\n  color:#4b5565;\n}\n\n.sr-guide-summary,\n.sr-guide-section,\n.sr-guide-cta{\n  background:#fff;\n  border-radius:24px;\n  padding:30px;\n  margin-bottom:24px;\n  box-shadow:0 14px 40px rgba(20,30,60,.10);\n  border:1px solid rgba(255,106,0,.12);\n}\n\n.sr-guide-summary h2,\n.sr-guide-section h2,\n.sr-guide-cta h2{\n  margin-top:0;\n  color:#252b3a;\n  font-size:28px;\n  line-height:1.25;\n}\n\n.sr-guide-summary ul{\n  margin:0;\n  padding-left:20px;\n  line-height:1.9;\n  color:#4b5565;\n}\n\n.sr-guide-section p,\n.sr-guide-cta p{\n  color:#4b5565;\n  line-height:1.75;\n  font-size:16.5px;\n}\n\n.sr-guide-section ul{\n  padding-left:20px;\n  line-height:1.9;\n  color:#4b5565;\n}\n\n.sr-example-box{\n  background:#fff3e8;\n  border-left:5px solid #ff6a00;\n  border-radius:16px;\n  padding:18px 20px;\n  margin-top:20px;\n  color:#3b4252;\n  line-height:1.7;\n}\n\n.sr-sync-grid{\n  display:grid;\n  grid-template-columns:repeat(2,minmax(0,1fr));\n  gap:16px;\n  margin-top:24px;\n}\n\n.sr-sync-card{\n  background:#f8f9fc;\n  border:1px solid rgba(37,43,58,.08);\n  border-radius:18px;\n  padding:22px;\n}\n\n.sr-sync-card h3{\n  margin:10px 0 8px;\n  color:#252b3a;\n  font-size:20px;\n}\n\n.sr-sync-card p{\n  margin:0;\n  font-size:15.5px;\n}\n\n.sr-sync-icon{\n  font-size:28px;\n  line-height:1;\n}\n\n.sr-erp-card{\n  margin-top:24px;\n  background:linear-gradient(135deg,#fff8f2,#fff);\n  border:1px solid rgba(255,106,0,.22);\n  border-radius:22px;\n  padding:26px;\n}\n\n.sr-erp-card h3{\n  margin:8px 0 10px;\n  color:#252b3a;\n  font-size:26px;\n}\n\n.sr-erp-label{\n  display:inline-block;\n  background:#ff6a00;\n  color:#fff;\n  font-weight:800;\n  font-size:13px;\n  padding:7px 11px;\n  border-radius:999px;\n}\n\n.sr-primary-button{\n  display:inline-block;\n  margin-top:10px;\n  background:#ff6a00;\n  color:#fff;\n  font-weight:800;\n  padding:13px 20px;\n  border-radius:999px;\n  text-decoration:none;\n  box-shadow:0 10px 24px rgba(255,106,0,.22);\n  transition:transform .2s ease,box-shadow .2s ease;\n}\n\n.sr-primary-button:hover{\n  transform:translateY(-2px);\n  box-shadow:0 14px 28px rgba(255,106,0,.28);\n}\n\n.sr-note{\n  margin-bottom:0;\n  font-size:15px!important;\n  font-style:italic;\n}\n\n.sr-guide-cta{\n  background:linear-gradient(135deg,#ff6a00,#ff8a1c);\n  color:#fff;\n}\n\n.sr-guide-cta h2,\n.sr-guide-cta p{\n  color:#fff;\n}\n\n.sr-guide-button{\n  display:inline-block;\n  margin-top:12px;\n  background:#fff;\n  color:#ff6a00;\n  font-weight:800;\n  padding:13px 20px;\n  border-radius:999px;\n  text-decoration:none;\n}\n\n@media(max-width:700px){\n  .sr-sync-grid{\n    grid-template-columns:1fr;\n  }\n}\n\n@media(max-width:640px){\n  .sr-guide-page{\n    padding:125px 14px 50px;\n  }\n\n  .sr-guide-summary,\n  .sr-guide-section,\n  .sr-guide-cta{\n    padding:24px;\n    border-radius:20px;\n  }\n\n  .sr-guide-hero p{\n    font-size:16.5px;\n  }\n\n  .sr-guide-summary h2,\n  .sr-guide-section h2,\n  .sr-guide-cta h2{\n    font-size:25px;\n  }\n\n  .sr-erp-card{\n    padding:22px;\n  }\n}\n<\/style>\n\n<section class=\"sr-guide-page\">\n\n <div class=\"sr-guide-hero\">\n\n    <div style=\"display:flex;justify-content:center;align-items:center;gap:16px;flex-wrap:wrap;margin-bottom:18px;\">\n        <a class=\"sr-back-link\" href=\"\/en\/centre-aide\/\" style=\"margin-bottom:0;\">\n            \u2190 Back to Help Center\n        <\/a>\n\n        <span class=\"sr-guide-badge\" style=\"margin-bottom:0;\">\n            API &amp; ERP\n        <\/span>\n\n        <a class=\"sr-api-doc-button\" href=\"\/en\/centre-aide\/documentation-api\/\">\n            <span>\ud83d\udcd6<\/span>\n            <span>Documentation API<\/span>\n        <\/a>\n    <\/div>\n\n    <h1>Connect StageReturn to Your Business Tools<\/h1>\n    <p>Connect StageReturn to your business software to check your equipment status,<br>\n    synchronize repairs, serialized equipment, non-serialized equipment<br>\n    and selected inventory changes.<\/p>\n  <\/div>\n\n  <div class=\"sr-guide-summary\">\n    <h2>In This Guide<\/h2>\n    <ul>\n      <li>Understand the StageReturn API<\/li>\n      <li>Generate and secure an API key<\/li>\n      <li>Understand ERP integrations<\/li>\n      <li>Discover available synchronizations<\/li>\n      <li>Manage ERP connections by warehouse<\/li>\n      <li>View compatible ERP systems<\/li>\n      <li>Monitor synchronization statuses and errors<\/li>\n    <\/ul>\n  <\/div>\n\n  <div class=\"sr-guide-section\">\n    <h2>1. What is the StageReturn API used for?<\/h2>\n    <p>The StageReturn API allows external software or custom integrations to<br>\n    retrieve information related to equipment and repairs.<br>\n    It is designed for companies that want to connect StageReturn to their ERP,<br>\n    internal tools, or asset management system.<\/p>\n\n    <div class=\"sr-example-box\">\n      <strong>Example :<\/strong><br>\n      A company already uses internal software to manage its equipment inventory.<br>\n      It can use the StageReturn API to check the repair status of a piece of<br>\n      equipment using its serial number.\n    <\/div>\n  <\/div>\n\n  <div class=\"sr-guide-section\">\n    <h2>2. Generate an API Key<\/h2>\n    <p>API keys are generated from the StageReturn administration panel.<br>\n    They allow your company to be identified whenever an external application sends requests to the API.<\/p>\n\n    <p>To access this section, open the administration panel and then the<br>\n    <strong>API<\/strong>. Depending on your permissions, you can create view,<br>\n    and manage your company's API keys.<\/p>\n\n    <div class=\"sr-example-box\">\n      <strong>Example :<\/strong><br>\n      A developer creates a StageReturn API key to connect an internal tool that automatically checks whether<br>\n      a piece of equipment is under repair or ERP-immobilized.\n    <\/div>\n  <\/div>\n\n  <div class=\"sr-guide-section\">\n    <h2>3. API Key Security<\/h2>\n    <p>An API key must be protected like a password. It must never be published on a website, shared publicly,<br>\n    or sent to an unauthorized person.<\/p>\n\n    <div class=\"sr-example-box\">\n      <strong>Example :<\/strong><br>\n      An API key intended for an ERP integration should be stored in the secure configuration of the connected application,<br>\n      not in a shared document or public message.\n    <\/div>\n  <\/div>\n\n  <div class=\"sr-guide-section\">\n    <h2>4. ERP Integrations<\/h2>\n    <p class=\"translation-block\">ERP integrations allow StageReturn to communicate with the business software already used by your company.\n\nThe goal is to keep StageReturn as your incident reporting, traceability, and repair management platform while synchronizing selected information with your ERP system.<\/p>\n\n    <p>Available features may vary depending on the connected ERP. An integration can manage<br>\n    serialized equipment, non-serialized equipment, ERP immobilizations,<br>\n    and inventory changes.<\/p>\n\n    <div class=\"sr-example-box translation-block\"><strong>Example :<\/strong><br>\nA company uses StageReturn to report incidents and its ERP to manage equipment availability. When equipment is ERP-immobilized or a missing quantity is reported, the information can be synchronized with the compatible ERP system.<\/div>\n  <\/div>\n\n  <div class=\"sr-guide-section\">\n    <h2>5. Available Synchronizations<\/h2>\n    <p class=\"translation-block\">Depending on the capabilities of the connected ERP, StageReturn can synchronize several types of information.<\/p>\n\n    <div class=\"sr-sync-grid\">\n      <div class=\"sr-sync-card\">\n        <div class=\"sr-sync-icon\">\ud83d\udd27<\/div>\n        <h3>Repairs<\/h3>\n        <p class=\"translation-block\">A repair created in StageReturn can trigger an action or update the equipment availability in the ERP.<\/p>\n      <\/div>\n\n      <div class=\"sr-sync-card\">\n        <div class=\"sr-sync-icon\">\ud83c\udff7\ufe0f<\/div>\n        <h3>Serialized Equipment<\/h3>\n        <p class=\"translation-block\">Equipment identified by a serial number can be located in the ERP and marked as unavailable when ERP immobilization is enabled.<\/p>\n      <\/div>\n\n      <div class=\"sr-sync-card\">\n        <div class=\"sr-sync-icon\">\ud83d\udce6<\/div>\n        <h3>Non-Serialized Equipment<\/h3>\n        <p class=\"translation-block\">Quantity-managed equipment can be linked to an ERP item to synchronize inventory changes.<\/p>\n      <\/div>\n\n      <div class=\"sr-sync-card\">\n        <div class=\"sr-sync-icon\">\u2195\ufe0f<\/div>\n        <h3>Inventory Changes<\/h3>\n        <p class=\"translation-block\">A reported missing quantity can be deducted from the ERP inventory and automatically restored when the equipment is reported as returned.<\/p>\n      <\/div>\n    <\/div>\n\n    <div class=\"sr-example-box translation-block\"><strong>Example :<\/strong><br>\n      Two cables are reported as missing in StageReturn. If these cables are linked to a compatible ERP item, the available inventory can be reduced by two.\n\nWhen they are reported as returned, the same quantity can be automatically restored.<\/div>\n  <\/div>\n\n  <div class=\"sr-guide-section\">\n    <h2>6. ERP Immobilization<\/h2>\n    <p class=\"translation-block\">ERP immobilization is independent from the repair status.\n\nA repair can exist in StageReturn without necessarily making the equipment unavailable in an external ERP.<\/p>\n\n    <p class=\"translation-block\">This separation provides greater flexibility: some repairs require the equipment to be blocked, while others are only used to document an incident or maintain a repair history.<\/p>\n\n    <div class=\"sr-example-box translation-block\"><strong>Example :<\/strong><br>\n     A cosmetic repair is recorded in StageReturn, but the equipment remains available.\n\nOn the other hand, a critical failure can immobilize the equipment in the ERP until the repair is completed.<\/div>\n  <\/div>\n\n  <div class=\"sr-guide-section\">\n    <h2>7. ERP Connections by Warehouse<\/h2>\n    <p class=\"translation-block\">ERP connections can be assigned to one or more StageReturn warehouses.\n\nThis organization makes it possible to separate locations, branches, inventory, and ERP accounts within the same company.<\/p>\n\n    <div class=\"sr-example-box translation-block\"><strong>Example :<\/strong><br>\n  A company operates one warehouse in Paris and another in Lyon. Each warehouse can maintain its own synchronization scope and be linked to the appropriate ERP account.<\/div>\n  <\/div>\n\n  <div class=\"sr-guide-section\">\n    <h2>8. Compatible ERP Systems<\/h2>\n    <p class=\"translation-block\">StageReturn is designed to progressively support multiple ERP connectors.\n<br \/>\nEach connector provides its own features and dedicated documentation.<\/p>\n\n    <div class=\"sr-erp-card\">\n      <span class=\"sr-erp-label\">Available Connector<\/span>\n      <h3>Rentman<\/h3>\n      <p class=\"translation-block\">The Rentman integration synchronizes repairs, ERP immobilization for serialized equipment, and inventory changes for linked non-serialized equipment.<\/p>\n\n      <ul>\n        <li>API token authentication<\/li>\n        <li>ERP immobilization of serialized equipment<\/li>\n        <li>Repair synchronization<\/li>\n        <li>Deduction of missing non-serialized equipment<\/li>\n        <li>Reintegration of returned equipment<\/li>\n        <li>Warehouse-based connection and synchronization<\/li>\n      <\/ul>\n\n      <p><a class=\"sr-primary-button\" href=\"\/en\/centre-aide\/integration-rentman\/\">View the Rentman Documentation<\/a><\/p>\n    <\/div>\n\n    <p class=\"sr-note\">Additional ERP integrations will be added over time.<\/p>\n  <\/div>\n\n  <div class=\"sr-guide-section\">\n    <h2>9. Matching Equipment with the ERP<\/h2>\n    <p class=\"translation-block\">To synchronize equipment correctly, StageReturn must be able to identify the corresponding item in the ERP. This match can be based on a serial number for serialized equipment or on a configured mapping for non-serialized equipment.<\/p>\n\n    <p>If no matching item is found, the incident or repair remains recorded in StageReturn. Only the related ERP synchronization cannot be completed.<br>\n    dans StageReturn. Seule la synchronisation ERP concern\u00e9e ne peut pas \u00eatre effectu\u00e9e.<\/p>\n\n    <div class=\"sr-example-box translation-block\"><strong>Example :<\/strong><br>\n      A piece of equipment is reported for repair in StageReturn, but its serial number does not exist in the ERP. \n<\/br>\nThe repair record remains available in StageReturn, and the synchronization status indicates that no matching equipment was found.<\/div>\n  <\/div>\n\n  <div class=\"sr-guide-section\">\n    <h2>10. Synchronization Logs and Monitoring<\/h2>\n    <p class=\"translation-block\">Integrations can display synchronization statuses, errors, the latest test results, and the date of the last synchronization.\n<\/br>\nThis information allows administrators to verify that the connection is working correctly.<\/p>\n\n    <div class=\"sr-example-box translation-block\"><strong>Example :<\/strong><br>\n      After entering the ERP connection settings, the administrator runs a connection test.\n\nIf the credentials are invalid or the ERP cannot find the requested equipment, StageReturn displays a status explaining the issue.<\/div>\n  <\/div>\n\n  <div class=\"sr-guide-section\">\n    <h2>Best Practices<\/h2>\n    <ul>\n      <li>Restrict API and integration access to authorized users.<\/li>\n      <li>Protect API keys and tokens as you would passwords.<\/li>\n      <li>Test ERP connections after every modification.<\/li>\n      <li>Verify the serial numbers of serialized equipment.<\/li>\n      <li>Verify the mappings for non-serialized equipment.<\/li>\n      <li>Enable ERP immobilization only when necessary.<\/li>\n      <li>Monitor synchronization errors and statuses.<\/li>\n      <li>Keep StageReturn as the single source of truth for incidents and repairs.<\/li>\n    <\/ul>\n  <\/div>\n\n  <div class=\"sr-guide-cta\">\n    <h2>Key Takeaways<\/h2>\n    <p class=\"translation-block\">The API and ERP integrations connect StageReturn to your business tools while maintaining clear, independent, and fully traceable tracking of incidents, repairs, and equipment movements.<\/p>\n\n    <p><a class=\"sr-guide-button\" href=\"\/en\/centre-aide\/\">Back to Help Center<\/a><\/p>\n  <\/div>\n\n<\/section>","protected":false},"excerpt":{"rendered":"<p>\u2190 Retour au centre d\u2019aide API &amp; ERP \ud83d\udcd6 Documentation API Connecter StageReturn \u00e0 vos outils m\u00e9tiers Connectez StageReturn \u00e0 vos logiciels m\u00e9tiers pour consulter l\u2019\u00e9tat de vos \u00e9quipements, synchroniser les r\u00e9parations, les \u00e9quipements s\u00e9rialis\u00e9s, les \u00e9quipements non s\u00e9rialis\u00e9s et certaines variations de stock. Dans ce guide Comprendre l\u2019API StageReturn G\u00e9n\u00e9rer et prot\u00e9ger une cl\u00e9 [&hellip;]<\/p>\n","protected":false},"author":1,"featured_media":0,"parent":949,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"","meta":{"footnotes":""},"class_list":["post-980","page","type-page","status-publish","hentry"],"_links":{"self":[{"href":"https:\/\/www.stagereturn.com\/en\/wp-json\/wp\/v2\/pages\/980","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.stagereturn.com\/en\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/www.stagereturn.com\/en\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/www.stagereturn.com\/en\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.stagereturn.com\/en\/wp-json\/wp\/v2\/comments?post=980"}],"version-history":[{"count":14,"href":"https:\/\/www.stagereturn.com\/en\/wp-json\/wp\/v2\/pages\/980\/revisions"}],"predecessor-version":[{"id":1103,"href":"https:\/\/www.stagereturn.com\/en\/wp-json\/wp\/v2\/pages\/980\/revisions\/1103"}],"up":[{"embeddable":true,"href":"https:\/\/www.stagereturn.com\/en\/wp-json\/wp\/v2\/pages\/949"}],"wp:attachment":[{"href":"https:\/\/www.stagereturn.com\/en\/wp-json\/wp\/v2\/media?parent=980"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}