# Basic Concepts


- **PARAMETERS IN THE SOFTWARE SERVICE**   (SOFTWARE SERVICE --> Keeta)

  - **{baseURL}** 
    - The {baseURL} is the parameter that indicates the base address, i.e. the constant part of the address, where the routes will be called. 

  - **clientId** and **clientSecret**
    - **Keeta** is responsible for providing the credentials for authentication to be performed through the authentication endpoint. 
      > **IMPORTANT**: As described in the authentication section of the documentation, credentials are generated by Keeta, that is, **if several MERCHANTS use the same Software Service, the software will have a same clientId and clientSecret**.

  - **AppId**
    - It is the unique ID of Keeta which is generated by Keeta itself, it will be informed to all the Software Services that it will integrate.

  - **X-App-Signature**   
    - Keeta requires Software Service to generate a signature and include it in the header of each API request. Refer to the [Signature Calculation](https://api-docs.mykeeta.com/apis/opendelivery/section/signature-calculation) section for the complete algorithm specification.

- **PARAMETERS IN Keeta**    (Keeta --> SOFTWARE SERVICE)

  - **[GET /merchant](#tag/merchantEndpoints) endpoint URL:** 
    - Keeta must be provided with the URL to access the `GET /merchant` route to obtain the merchant's information. 

    > **IMPORTANT**: Each merchant that the Software Service works with must have a unique URL.
  - **apiKey**
    - If the GET /merchant endpoint is implemented using authentication, it is necessary that the Software Service provides the apiKey referring to the entered merchant.

  - **Order Event Webhook**
    - If both parties are going to work with sending order events via webhook, it is necessary to provide the URL of the webhook. Default webhook route:  `POST {baseURL}/newEvent`


- ### General Guidelines

  For general guidelines on the Keeta Open Delivery API, please refer directly to <a href="https://abrasel-nacional.github.io/docs/#section/General-Guidelines" target="_blank">Open Delivery General Guidelines</a>.


- ### Error Handling

  For error handling guidelines on the Keeta Open Delivery API, please refer directly to <a href="https://abrasel-nacional.github.io/docs/#section/Error-Handling" target="_blank">Open Delivery Error Handling</a>.