# वेबहुक
*** ## पंजीकरण आप यहाँ एक वेबहुक पंजीकृत कर सकते हैं **`सेटिंग्स`** **>** **`इंटीग्रेशन्स और 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" %} यदि आपको अतिरिक्त घटना विषयों के लिए समर्थन चाहिए, तो कृपया संपर्क करें [सपोर्ट](https://www.boxhero.io/docs/documentation/hi/resources/contact). {% endhint %} ### `txs/new` जब कोई इन्वेंटरी लेन-देन होता है (स्टॉक इन / स्टॉक आउट / स्टॉक समायोजित करें / स्टॉक स्थानांतरित करें), तब ट्रिगर होता है। {% hint style="warning" %} **नोट:** यह घटना *नहीं* बल्क संपादन या आयात के माध्यम से बनाई गई समायोजनों के लिए ट्रिगर होती है (उदाहरण: Excel के माध्यम से आइटम जोड़ते या अपडेट करते समय)। {% endhint %}
क्षेत्रआवश्यकविवरण필수여부विवरण팀모드
idtrueलेन-देन की अद्वितीय IDtrue히스토리의 고유한 ID전체
typetrueलेन-देन का प्रकार
(in, out, adjust, move)		true

히스토리의 유형.

  • 입고 : in
  • 출고 : out
  • 조정 : adjust
  • 이동 : move
전체
पार्टनरfalsePartnerfalse
partner.idfalseसाझेदार की अद्वितीय IDfalse
partner.namefalseसाझेदार का नामfalse
partner.deletedfalseक्या साझेदार हटाया गया हैfalse
from_locationfalseस्रोत स्थानfalse
from_location.idfalseस्रोत स्थान की अद्वितीय IDfalse
from_location.namefalseस्रोत स्थान का नामfalse
from_location.deletedfalseक्या स्रोत स्थान हटाया गया हैfalse
to_locationtrueगंतव्य स्थानfalse
to_location.idtrueगंतव्य स्थान की अद्वितीय IDfalse
to_location.nametrueगंतव्य स्थान का नामfalse
to_location.deletedtrueक्या गंतव्य स्थान हटाया गया हैfalse
itemstrueलेन-देन में लाइन आइटमtrue히스토리를 구성하는 제품별 항목모든 모드
items.idtrueआइटम की अद्वितीय IDtrue제품의 고유 ID모든 모드
items.nametrueआइटम का नामtrue제품의 이름모든 모드
items.quantitytrueस्टॉक इन/आउट/समायोजित/स्थानांतरित होने के कारण इन्वेंटरी परिवर्तनtrue해당 제품의 입고/출고/조정/이동 수량모든 모드
items.deletedtrueक्या आइटम हटाया गया हैtrue삭제된 제품 여부
items.from_location_new_stock_levelfalseलेन-देन के बाद स्रोत स्थान पर स्टॉक स्तरfalse
items.to_location_new_stock_leveltrueलेन-देन के बाद गंतव्य स्थान पर स्टॉक स्तरfalse
transaction_timetrueलेन-देन का समय (जैसे स्टॉक इन/आउट समय)false
created_attrueवह समय जब लेन-देन बनाया गया थाfalse
created_bytrueवह सदस्य जिसने लेन-देन बनायाfalse
created_by.idtrueसदस्य की अद्वितीय IDfalse
created_by.nametrueसदस्य का नामfalse
created_by.deletedtrueक्या सदस्य हटाया गया हैfalse
count_of_itemstrueआइटमों की संख्याfalse
total_quantitytrueइन्वेंटरी परिवर्तन की कुल मात्राfalse
urltrueलेन-देन विवरण पृष्ठ देखने के लिए URL पताfalse
memofalseलेन-देन से संबंधित नोट्स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" } ``` #### उदाहरण वेबहुक पेलोड – `स्टॉक स्थानांतरित करें` घटना 
{
  "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": "2025-04-25T05:42:27.545Z",
  "created_at": "2025-04-25T05:42:27.545Z",
  "created_by": {
    "id": 176829,
    "name": "Tony Lee",
    "deleted": false
  },
  "count_of_items": 1,
  "total_quantity": 1,
  "url": "https://web.boxhero-app.com/team/150581/mode/2#/ltx/3692714"
}
### `txs/edit` जब कोई मौजूदा इन्वेंटरी लेन-देन (स्टॉक इन / स्टॉक आउट / स्टॉक समायोजित करें / स्टॉक स्थानांतरित करें) **संपादित किया जाता है**.
क्षेत्रआवश्यकविवरण필수여부विवरण팀모드
idtrueलेन-देन की अद्वितीय IDtrue히스토리의 고유한 ID전체
typetrueलेन-देन का प्रकार
(in, out, adjust, move)		true

히스토리의 유형.

  • 입고 : in
  • 출고 : out
  • 조정 : adjust
  • 이동 : move
전체
पार्टनरfalsePartnerfalse
partner.idfalseसाझेदार की अद्वितीय IDfalse
partner.namefalseसाझेदार का नामfalse
partner.deletedfalseक्या साझेदार हटाया गया हैfalse
from_locationfalseस्रोत स्थानfalse
from_location.idfalseस्रोत स्थान की अद्वितीय IDfalse
from_location.namefalseस्रोत स्थान का नामfalse
from_location.deletedfalseक्या स्रोत स्थान हटाया गया हैfalse
to_locationtrueगंतव्य स्थानfalse
to_location.idtrueगंतव्य स्थान की अद्वितीय IDfalse
to_location.nametrueगंतव्य स्थान का नामfalse
to_location.deletedtrueक्या गंतव्य स्थान हटाया गया हैfalse
itemstrueलेन-देन में लाइन आइटमtrue히스토리를 구성하는 제품별 항목모든 모드
items.idtrueआइटम की अद्वितीय IDtrue제품의 고유 ID모든 모드
items.nametrueआइटम का नामtrue제품의 이름모든 모드
items.quantitytrueलेन-देन के कारण मात्रा परिवर्तन (in/out/adjust/move)true해당 제품의 입고/출고/조정/이동 수량모든 모드
items.deletedtrueक्या आइटम हटाया गया हैtrue삭제된 제품 여부
items.from_location_new_stock_levelfalseलेन-देन के बाद स्रोत स्थान पर स्टॉक स्तरfalse
items.to_location_new_stock_leveltrueलेन-देन के बाद गंतव्य स्थान पर स्टॉक स्तरfalse
transaction_timetrueलेन-देन का समय (जैसे स्टॉक इन/आउट समय)false
created_attrueवह समय जब लेन-देन बनाया गया थाfalse
created_bytrueवह सदस्य जिसने लेन-देन बनायाfalse
created_by.idtrueसदस्य की अद्वितीय IDfalse
created_by.nametrueसदस्य का नामfalse
created_by.deletedtrueक्या सदस्य हटाया गया हैfalse
count_of_itemstrueआइटमों की संख्याfalse
total_quantitytrueइन्वेंटरी परिवर्तन की कुल मात्राfalse
urltrueलेन-देन विवरण पृष्ठ देखने के लिए URL पताfalse
memofalseलेन-देन से संबंधित नोट्स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आइटम IDtrue히스토리의 고유한 ID전체
नामआइटम का नामtrue

히스토리의 유형.

  • 입고 : in
  • 출고 : out
  • 조정 : adjust
  • 이동 : move
전체
skuSKUfalse
बारकोडबारकोडfalse
photo_urlफोटो URLfalse
लागतलागत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आइटम IDtrue히스토리의 고유한 ID전체
नामआइटम का नामtrue

히스토리의 유형.

  • 입고 : in
  • 출고 : out
  • 조정 : adjust
  • 이동 : move
전체
skuSKUfalse
बारकोडबारकोडfalse
photo_urlफोटो URLfalse
लागतलागत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आइटम IDtrue히스토리의 고유한 ID전체
#### उदाहरण पेलोड **– आइटम हटाया गया** ```json { "id": 26122826 } ```