API Intégrations ERP

← Back to Help Center API & ERP 📖 Documentation API

Connect StageReturn to Your Business Tools

Connect StageReturn to your business software to check your equipment status,
synchronize repairs, serialized equipment, non-serialized equipment
and selected inventory changes.

In This Guide

Understand the StageReturn API
Generate and secure an API key
Understand ERP integrations
Discover available synchronizations
Manage ERP connections by warehouse
View compatible ERP systems
Monitor synchronization statuses and errors

1. What is the StageReturn API used for?

The StageReturn API allows external software or custom integrations to
retrieve information related to equipment and repairs.
It is designed for companies that want to connect StageReturn to their ERP,
internal tools, or asset management system.

Example :
A company already uses internal software to manage its equipment inventory.
It can use the StageReturn API to check the repair status of a piece of
equipment using its serial number.

2. Generate an API Key

API keys are generated from the StageReturn administration panel.
They allow your company to be identified whenever an external application sends requests to the API.

To access this section, open the administration panel and then the
API. Depending on your permissions, you can create view,
and manage your company's API keys.

Example :
A developer creates a StageReturn API key to connect an internal tool that automatically checks whether
a piece of equipment is under repair or ERP-immobilized.

3. API Key Security

An API key must be protected like a password. It must never be published on a website, shared publicly,
or sent to an unauthorized person.

Example :
An API key intended for an ERP integration should be stored in the secure configuration of the connected application,
not in a shared document or public message.

4. ERP Integrations

ERP integrations allow StageReturn to communicate with the business software already used by your company. The goal is to keep StageReturn as your incident reporting, traceability, and repair management platform while synchronizing selected information with your ERP system.

Available features may vary depending on the connected ERP. An integration can manage
serialized equipment, non-serialized equipment, ERP immobilizations,
and inventory changes.

Example :
A 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.

5. Available Synchronizations

Depending on the capabilities of the connected ERP, StageReturn can synchronize several types of information.

🔧

Repairs

A repair created in StageReturn can trigger an action or update the equipment availability in the ERP.

🏷️

Serialized Equipment

Equipment identified by a serial number can be located in the ERP and marked as unavailable when ERP immobilization is enabled.

📦

Non-Serialized Equipment

Quantity-managed equipment can be linked to an ERP item to synchronize inventory changes.

↕️

Inventory Changes

A reported missing quantity can be deducted from the ERP inventory and automatically restored when the equipment is reported as returned.

Example :
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. When they are reported as returned, the same quantity can be automatically restored.

6. ERP Immobilization

ERP immobilization is independent from the repair status. A repair can exist in StageReturn without necessarily making the equipment unavailable in an external ERP.

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.

Example :
A cosmetic repair is recorded in StageReturn, but the equipment remains available. On the other hand, a critical failure can immobilize the equipment in the ERP until the repair is completed.

7. ERP Connections by Warehouse

ERP connections can be assigned to one or more StageReturn warehouses. This organization makes it possible to separate locations, branches, inventory, and ERP accounts within the same company.

Example :
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.

8. Compatible ERP Systems

StageReturn is designed to progressively support multiple ERP connectors.
Each connector provides its own features and dedicated documentation.

Available Connector

Rentman

The Rentman integration synchronizes repairs, ERP immobilization for serialized equipment, and inventory changes for linked non-serialized equipment.

API token authentication
ERP immobilization of serialized equipment
Repair synchronization
Deduction of missing non-serialized equipment
Reintegration of returned equipment
Warehouse-based connection and synchronization

View the Rentman Documentation

Additional ERP integrations will be added over time.

9. Matching Equipment with the ERP

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.

If no matching item is found, the incident or repair remains recorded in StageReturn. Only the related ERP synchronization cannot be completed.
dans StageReturn. Seule la synchronisation ERP concernée ne peut pas être effectuée.

Example :
A piece of equipment is reported for repair in StageReturn, but its serial number does not exist in the ERP.
The repair record remains available in StageReturn, and the synchronization status indicates that no matching equipment was found.

10. Synchronization Logs and Monitoring

Integrations can display synchronization statuses, errors, the latest test results, and the date of the last synchronization.
This information allows administrators to verify that the connection is working correctly.

Example :
After entering the ERP connection settings, the administrator runs a connection test. If the credentials are invalid or the ERP cannot find the requested equipment, StageReturn displays a status explaining the issue.

Best Practices

Restrict API and integration access to authorized users.
Protect API keys and tokens as you would passwords.
Test ERP connections after every modification.
Verify the serial numbers of serialized equipment.
Verify the mappings for non-serialized equipment.
Enable ERP immobilization only when necessary.
Monitor synchronization errors and statuses.
Keep StageReturn as the single source of truth for incidents and repairs.

Key Takeaways

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.

Back to Help Center