# Webhook
***
## पंजीकरण
आप यहाँ एक वेबहुक पंजीकृत कर सकते हैं **`सेटिंग्स`** **>** **`इंटीग्रेशन्स और API`** अपने BoxHero टीम में।
## डिलीवरी और पुनः प्रयास व्यवहार
जब कोई घटना होती है, BoxHero एक HTTP `POST` अनुरोध आपके पंजीकृत वेबहुक एंडपॉइंट पर भेजता है। अनुरोध बॉडी में घटना का वर्णन करने वाला JSON पेलोड होता है।
* यदि आपका सर्वर **HTTP 200 OK**के साथ प्रतिक्रिया देता है, तो घटना को सफलतापूर्वक डिलीवर माना जाता है।
* यदि आपका सर्वर **कोई भी गैर-200 स्थिति कोड**के लिए, BoxHero इसे एक अस्थायी विफलता मानता है और 3 बार तक डिलीवरी पुनः प्रयास करता है।
## वेबहुक पेलोड संरचना
सभी वेबहुक घटनाएँ अनुरोध बॉडी में निम्न JSON संरचना के साथ डिलीवर की जाती हैं:
```json
{
"id": "1234", // घटना की अद्वितीय ID
"topic": "txs/new", // घटना विषय
"version": 1, // पेलोड स्कीमा संस्करण
"payload": { // घटना-विशिष्ट डेटा
...
},
"created_time": "2025-08-06T09:20:48.623Z" // घटना घटित होने का टाइमस्टैम्प (ISO 8601)
}
```
***
## घटना क्रम
BoxHero **क्रम** की डिलीवरी के क्रम की गारंटी नहीं देता। उदाहरण के लिए, एक `item/new` घटना एक `item/delete` घटना के बाद उसी आइटम के लिए आ सकती है।
इसमें `created_time` क्षेत्र घटना पेलोड में वास्तविक घटना समय को दर्शाता है। घटनाओं को विश्वसनीय रूप से संभालने के लिए अपने वेबहुक हैंडलर में idempotent और क्रम-सहिष्णु लॉजिक लागू करें।
## घटना विषय
{% hint style="info" %}
यदि आपको अतिरिक्त घटना विषयों के लिए समर्थन चाहिए, तो कृपया संपर्क करें [सपोर्ट](/docs/documentation/hi/resources/contact.md).
{% endhint %}
### `txs/new`
जब कोई इन्वेंटरी लेन-देन होता है (स्टॉक इन / स्टॉक आउट / स्टॉक समायोजित करें / स्टॉक स्थानांतरित करें), तब ट्रिगर होता है।
{% hint style="warning" %}
**नोट:** यह घटना *नहीं* बल्क संपादन या आयात के माध्यम से बनाई गई समायोजनों के लिए ट्रिगर होती है (उदाहरण: Excel के माध्यम से आइटम जोड़ते या अपडेट करते समय)।
{% endhint %}
क्षेत्र
आवश्यक
विवरण
필수여부
विवरण
팀모드
id
true
लेन-देन की अद्वितीय ID
true
히스토리의 고유한 ID
전체
type
true
लेन-देन का प्रकार (in, out, adjust, move)
true
히스토리의 유형.
입고 : in
출고 : out
조정 : adjust
이동 : move
전체
पार्टनर
false
Partner
false
partner.id
false
साझेदार की अद्वितीय ID
false
partner.name
false
साझेदार का नाम
false
partner.deleted
false
क्या साझेदार हटाया गया है
false
from_location
false
स्रोत स्थान
false
from_location.id
false
स्रोत स्थान की अद्वितीय ID
false
from_location.name
false
स्रोत स्थान का नाम
false
from_location.deleted
false
क्या स्रोत स्थान हटाया गया है
false
to_location
true
गंतव्य स्थान
false
to_location.id
true
गंतव्य स्थान की अद्वितीय ID
false
to_location.name
true
गंतव्य स्थान का नाम
false
to_location.deleted
true
क्या गंतव्य स्थान हटाया गया है
false
items
true
लेन-देन में लाइन आइटम
true
히스토리를 구성하는 제품별 항목
모든 모드
items.id
true
आइटम की अद्वितीय ID
true
제품의 고유 ID
모든 모드
items.name
true
आइटम का नाम
true
제품의 이름
모든 모드
items.quantity
true
स्टॉक इन/आउट/समायोजित/स्थानांतरित होने के कारण इन्वेंटरी परिवर्तन
### `txs/edit`
जब कोई मौजूदा इन्वेंटरी लेन-देन (स्टॉक इन / स्टॉक आउट / स्टॉक समायोजित करें / स्टॉक स्थानांतरित करें) **संपादित किया जाता है**.
क्षेत्र
आवश्यक
विवरण
필수여부
विवरण
팀모드
id
true
लेन-देन की अद्वितीय ID
true
히스토리의 고유한 ID
전체
type
true
लेन-देन का प्रकार (in, out, adjust, move)
true
히스토리의 유형.
입고 : in
출고 : out
조정 : adjust
이동 : move
전체
पार्टनर
false
Partner
false
partner.id
false
साझेदार की अद्वितीय ID
false
partner.name
false
साझेदार का नाम
false
partner.deleted
false
क्या साझेदार हटाया गया है
false
from_location
false
स्रोत स्थान
false
from_location.id
false
स्रोत स्थान की अद्वितीय ID
false
from_location.name
false
स्रोत स्थान का नाम
false
from_location.deleted
false
क्या स्रोत स्थान हटाया गया है
false
to_location
true
गंतव्य स्थान
false
to_location.id
true
गंतव्य स्थान की अद्वितीय ID
false
to_location.name
true
गंतव्य स्थान का नाम
false
to_location.deleted
true
क्या गंतव्य स्थान हटाया गया है
false
items
true
लेन-देन में लाइन आइटम
true
히스토리를 구성하는 제품별 항목
모든 모드
items.id
true
आइटम की अद्वितीय ID
true
제품의 고유 ID
모든 모드
items.name
true
आइटम का नाम
true
제품의 이름
모든 모드
items.quantity
true
लेन-देन के कारण मात्रा परिवर्तन (in/out/adjust/move)
true
해당 제품의 입고/출고/조정/이동 수량
모든 모드
items.deleted
true
क्या आइटम हटाया गया है
true
삭제된 제품 여부
items.from_location_new_stock_level
false
लेन-देन के बाद स्रोत स्थान पर स्टॉक स्तर
false
items.to_location_new_stock_level
true
लेन-देन के बाद गंतव्य स्थान पर स्टॉक स्तर
false
transaction_time
true
लेन-देन का समय (जैसे स्टॉक इन/आउट समय)
false
created_at
true
वह समय जब लेन-देन बनाया गया था
false
created_by
true
वह सदस्य जिसने लेन-देन बनाया
false
created_by.id
true
सदस्य की अद्वितीय ID
false
created_by.name
true
सदस्य का नाम
false
created_by.deleted
true
क्या सदस्य हटाया गया है
false
count_of_items
true
आइटमों की संख्या
false
total_quantity
true
इन्वेंटरी परिवर्तन की कुल मात्रा
false
url
true
लेन-देन विवरण पृष्ठ देखने के लिए URL पता
false
memo
false
लेन-देन से संबंधित नोट्स
false
संशोधन
true
लेन-देन का वर्तमान संस्करण नंबर, 1 से शुरू
false
#### उदाहरण वेबहुक पेलोड – संपादित `स्टॉक इन` लेनदेन
```json
{
"id": 16160911,
"type": "in",
"to_location": {
"id": 52766,
"name": "Warehouse 3",
"deleted": false
},
"items": [
{
"id": 14277699,
"name": "belif Cleansing Gel Oil Enriched",
"quantity": 2,
"deleted": false,
"to_location_new_stock_level": 3
},
{
"id": 14277698,
"name": "belif Aqua Bomb Jelly Cleanser",
"quantity": 2,
"deleted": false,
"to_location_new_stock_level": 5
}
],
"transaction_time": "2023-04-25T05:42:27.545Z",
"created_at": "2023-08-14T05:14:29.499Z",
"created_by": {
"id": 201345,
"name": "corp",
"deleted": false
},
"count_of_items": 2,
"total_quantity": 4,
"url": "https://web.boxhero-app.com/team/149058/mode/0#/tx/16160911"
}
```
#### उदाहरण वेबहुक पेलोड – संपादित `स्टॉक स्थानांतरित करें` लेनदेन
```json
{
"id": 3692714,
"type": "move",
"from_location": {
"id": 52765,
"name": "Warehouse 2",
"deleted": false
},
"to_location": {
"id": 52766,
"name": "Warehouse 3",
"deleted": false
},
"items": [
{
"id": 14873303,
"name": "Auto liner 3.5mm",
"quantity": 1,
"deleted": false,
"from_location_new_stock_level": -1,
"to_location_new_stock_level": 1
}
],
"transaction_time": "2023-04-25T05:42:27.545Z",
"created_at": "2023-04-25T05:42:27.545Z",
"created_by": {
"id": 176829,
"name": "Joy Kim",
"deleted": false
},
"count_of_items": 1,
"total_quantity": 1,
"url": "https://web.boxhero-app.com/team/150581/mode/2#/ltx/3692714"
}
```
### `txs/delete`
जब कोई इन्वेंटरी लेन-देन **हटाया जाता है**.
| क्षेत्र | विवरण |
| ------- | ------------------------------------------ |
| id | लेन-देन की अद्वितीय ID |
| संशोधन | लेन-देन का वर्तमान संस्करण नंबर, 1 से शुरू |
#### उदाहरण वेबहुक पेलोड – हटाया गया लेन-देन
```json
/{
"id": 27036740,
"revision": 2
}
```
### `item/new`
जब टीम की इन्वेंटरी में एक नया आइटम जोड़ा जाता है, तब भेजा जाता है।
{% hint style="warning" %}
**नोट**: यह घटना *नहीं* ट्रिगर होती है जब **`Add Item Variants`** सुविधा का उपयोग किया जाता है या आइटम्स को **`Import Excel`**.
{% endhint %}
क्षेत्र
विवरण
필수여부
विवरण
팀모드
id
आइटम ID
true
히스토리의 고유한 ID
전체
नाम
आइटम का नाम
true
히스토리의 유형.
입고 : in
출고 : out
조정 : adjust
이동 : move
전체
sku
SKU
false
बारकोड
बारकोड
false
photo_url
फोटो URL
false
लागत
लागत
false
मूल्य
मूल्य
false
attrs
विशेषताएँ
false
#### **उदाहरण पेलोड – आइटम बनाया गया**
```json
{
"id": 26122826,
"name": "belif Peat Miracle Revital Cream",
"sku": "SKU-YH2361KI",
"barcode": "2002074321218",
"photo_url": "https://d3l9wd8kivvlqy.cloudfront.net/ap-northeast-2/image-up-ap-northeast-2/30b0cc84-601d-493d-87fd-b7e8b5825601",
"cost": "50000",
"price": "65000",
"attrs": [
{
"id": 413101,
"name": "Category",
"type": "text",
"value": "Foundation"
},
{
"id": 459264,
"name": "Expiration date",
"type": "date",
"value": "2027-08-07"
},
{
"id": 668272,
"name": "Safety Stock",
"type": "number",
"value": 33
}
]
}
```
### `item/edit`
जब कोई मौजूदा आइटम संपादित किया जाता है, तब भेजा जाता है।
{% hint style="warning" %}
**नोट**: यह घटना *नहीं* ट्रिगर होती है *f*के माध्यम से किए गए बल्क संपादनों **`डेटा सेंटर`**** > ****`Item`** या **`Import Excel`** फ़ंक्शन के माध्यम से।
{% endhint %}
क्षेत्र
विवरण
필수여부
विवरण
팀모드
id
आइटम ID
true
히스토리의 고유한 ID
전체
नाम
आइटम का नाम
true
히스토리의 유형.
입고 : in
출고 : out
조정 : adjust
이동 : move
전체
sku
SKU
false
बारकोड
बारकोड
false
photo_url
फोटो URL
false
लागत
लागत
false
मूल्य
मूल्य
false
attrs
विशेषताएँ
false
#### **उदाहरण पेलोड – आइटम अपडेट किया गया**
```json
{
"id": 26122826,
"name": "belif Peat Miracle Revital Cream",
"sku": "SKU-YH2361KI",
"barcode": "2002074321218",
"photo_url": "https://d3l9wd8kivvlqy.cloudfront.net/ap-northeast-2/image-up-ap-northeast-2/30b0cc84-601d-493d-87fd-b7e8b5825601",
"cost": "50000",
"price": "65000",
"attrs": [
{
"id": 413101,
"name": "Category",
"type": "text",
"value": "Foundation"
},
{
"id": 459264,
"name": "Expiration date",
"type": "date",
"value": "2027-08-07"
},
{
"id": 668272,
"name": "Safety Stock",
"type": "number",
"value": 33
}
]
}
```
### `item/delete`
जब किसी आइटम को टीम की इन्वेंटरी से हटाया जाता है, तब भेजा जाता है।
{% hint style="warning" %}
**नोट**: यह घटना *नहीं* ट्रिगर होती है **`डेटा सेंटर`**** > ****`Item`**.
{% endhint %}
क्षेत्र
विवरण
필수여부
विवरण
팀모드
id
आइटम ID
true
히스토리의 고유한 ID
전체
#### उदाहरण पेलोड **– आइटम हटाया गया**
```json
{
"id": 26122826
}
```
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://www.boxhero.io/docs/documentation/hi/integrations/open-api/webhook.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.