Skip to content

API Default Company Configuration in Merci Cloud ERP

Overview

In Merci Cloud ERP, we have enabled API-based data fetching for reports, dashboards, and mobile app modules. Since multiple companies can exist within a single financial year setup, it's essential to designate one default company for API data connections.

To support this, a new field has been introduced in the Company Master:
API Default Co?

This setting ensures that the selected company will act as the primary data source for all API calls.

Why This Matters

  • In scenarios where multiple companies are configured under the same financial year, API data retrieval can become ambiguous.
  • By marking one company as the API Default, the system knows exactly where to fetch data from for:
  • Dashboards
  • Reports
  • Mobile App Modules
  • This avoids data inconsistencies and ensures a streamlined API experience.

How It Works

  1. Go to: Company Master → Open the desired company.
  2. Scroll to the Other Info section.
  3. Set the field API Default Co? to YES for the company you wish to designate as the default for API calls.
  4. Only one company should have this flag set to YES at any given time.

⚠️ If more than one company is marked as the API Default, the system will prioritize based on internal logic, which might lead to unpredictable behavior.

UI Reference

Below is a visual reference showing the API Default Co? setting:

Marked company will act as the default data source for all API-based requests.

Notes

  • This setting does not affect other internal reports or operations within the ERP.
  • Intended only for external integrations via APIs.
  • You can update or switch the default company anytime based on operational needs.

Best Practices

  • Assign the API Default flag only to the primary operational company for the current financial year.
  • Avoid switching this frequently to prevent disruption in API responses.
  • Document the default selection in your technical or admin SOPs for clarity.

Need Help?

If you have any questions about this setting or API integration in general, feel free to contact our support team or refer to the API Integration Guide.