# Store API Integration Guide

## 1. Overview

The Keeta Store API empowers developer applications to maintain real-time synchronization with store operations.

### 1.1 Webhook

Keeta's webhook notification service delivers real-time alerts for critical store operational changes. The platform pushes these events to your registered endpoint using standardized payloads containing unique identifiers and contextual details.

| **eventId** | **Event Description** |
|  --- | --- |
| 1101 | Store Business Hours Change Notification |
| 1102 | Store Status Change Notification |


### 1.2 **Store Management API**

For comprehensive specifications of the Store Management API, please refer to the [Store Api Reference](/apis/standard/shop). The API suite provides granular control over store configurations through these core endpoints:

| **URL Endpoints** | **Functionality** |
|  --- | --- |
| /api/open/scm/shop/base/get | Retrieves comprehensive store metadata. |
| /api/open/scm/shop/business/hour/effective/get | Queries the store's standard weekly operating schedule, including time ranges for each weekday. |
| /api/open/scm/shop/special/business/hour/effective/get | Retrieves special operating schedules typically used for holiday periods or exceptional events. |
| /api/open/scm/shop/picture/main/update | Updates the store's primary display image used in high-visibility contexts including search results, homepage recommendations, and store header banners, requiring strict adherence to resolution and format guidelines. |
| /api/open/scm/shop/contact/update | Updates the store's official contact telephone number. |
| /api/open/scm/shop/status/open | Transitions a store from suspended status (Status 4) back to operational status (Status 3), triggering real-time availability updates across platforms. |
| /api/open/scm/shop/status/rest | Places an actively operating store into suspended status (Status 4), immediately disabling order acceptance capabilities. |
| /api/open/scm/shop/business/hour/effective/update | Modifies the regular business hours configuration. |
| /api/open/scm/shop/special/business/hour/effective/update | Modifies temporary operating hours for specific dates. |


## 2. Workflow of Change the Store Status


```mermaid

flowchart TD
    A((Start)) --> |Create Store| B[Store Registration<br>in Progress]
    B --> |Requires approval<br/>from all modules| C[Ready to Open]
    C --> D[Merchant Opens Store<br/>for Business]
    D --> E[Live and Operating]
    
    E --> G[Merchant Sets<br/>Rest]
    G --> I[Store Resting]
    I --> |Store non-cooperation<br/>or closure| J[Store Going<br/>Offline]
    J --> F[Merchant Initiates<br>Reopening]
    F --> E
    
    I --> H[Merchant Resume<br/>Operation]
    H --> E
    
    %% 右侧独立框
    K[API Operation]
    L[Keeta Backend<br/>Operation] 
    M[Store Status]
    
    %% 样式定义
    classDef blueBox fill:#b3d9ff,stroke:#333,stroke-width:1px
    classDef pinkBox fill:#FFDDDD,stroke:#333,stroke-width:1px
    classDef orangeBox fill:#ffd8a8,stroke:#333,stroke-width:1px
    classDef white fill:#ffffff,stroke:#333,stroke-width:1px
    
    %% 应用样式
    class A white
    class B,C,E,I,J,M blueBox
    class D,F,L pinkBox
    class G,H,K orangeBox
```