API Authentication for Partner vs. Business Implementations
Each Commenda Global Indirect Tax API organization receives an API token, whether the organization manages multiple corporations (Partner Implementation) or a single corporation (Business Implementation). Include this token on each request asAuthorization: Bearer <api_token>.
Corporations
In Commenda’s system, a corporation refers to a distinct legal entity or business that the API interacts with. Users can set up corporations in two main ways:- Partner Implementations: For users managing multiple businesses (such as merchants or clients), each entity they handle is treated as a separate corporation within the API. This is useful when different legal entities require separate records or compliance processes.
- Business Implementations: For users building the API for their own company, only one corporation needs to be created, representing the user’s business.
Use Case Labels
- Partner Implementations: For users managing multiple corporations.
- Business Implementations: For users managing a single corporation for their own business.
Corporations and Their Relationship with Other Resources
Most resources in the system, such as customers, transactions, registrations, filings, and files, are linked to a specific corporation. When working with these resources, provide thecorporation_id for context where the endpoint requires it. You can retrieve all corporations associated with your organization by using the GET /corporations endpoint.