Skip to main content

์›นํ›… ์„ค์ •

์›นํ›…์„ ์‚ฌ์šฉํ•˜๋ ค๋ฉด ๋‹ค์Œ ๋‹จ๊ณ„๋ฅผ ๋”ฐ๋ฅด์„ธ์š”
  1. ์›นํ›… URL์„ ํ”Œ๋Ÿฌ๊ทธ ๋Œ€์‹œ๋ณด๋“œ(๋น„์ฆˆ๋‹ˆ์Šค ์„ค์ • -> ์›นํ›… & API)์—์„œ ์„ค์ •ํ•ฉ๋‹ˆ๋‹ค
  2. ์ˆ˜์‹ ํ•  ์ด๋ฒคํŠธ ์œ ํ˜•์„ ์„ ํƒํ•ฉ๋‹ˆ๋‹ค

์ง€์› ์ด๋ฒคํŠธ

ํ”Œ๋Ÿฌ๊ทธ API์—์„œ ์ง€์›ํ•˜๋Š” ์›นํ›… ์ด๋ฒคํŠธ

์˜๋ขฐ ์ด๋ฒคํŠธ

  • ์ œ๋ชฉ ๋ณ€๊ฒฝ
  • ๋‹จ๊ณ„ ๋ณ€๊ฒฝ
  • ์˜ˆ์ƒ ๊ฒฌ์  ๋ณ€๊ฒฝ
  • ๋ฌธ์˜ ์ผ์‹œ ๋ณ€๊ฒฝ
  • ์—ฐ๊ฒฐ ๊ณ ๊ฐ ๋ณ€๊ฒฝ

๊ฒฌ์ ์„œ ์ด๋ฒคํŠธ

  • ์ œ๋ชฉ ๋ณ€๊ฒฝ
  • ๊ฒฌ์ ์ผ์ž ๋ณ€๊ฒฝ
  • ๊ฒฌ์ ๋ฒˆํ˜ธ ๋ณ€๊ฒฝ
  • ๋‹ด๋‹น์ž ์ •๋ณด ๋ณ€๊ฒฝ
  • ์ˆ˜์‹ ์ž ์ •๋ณด ๋ณ€๊ฒฝ
  • ๊ฒฌ์ ์„œ ์ƒํƒœ ๋ณ€๊ฒฝ
  • ํ†ตํ™” ๋ณ€๊ฒฝ
  • VAT ์˜ต์…˜ ๋ณ€๊ฒฝ
๊ฐ ์ด๋ฒคํŠธ๋Š” ์‚ฌ์šฉ์ž๊ฐ€ ์›นํ›… ์„ค์ •์—์„œ ๊ฐœ๋ณ„์ ์œผ๋กœ ์„ ํƒํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค. ํ•„์š”ํ•œ ์ด๋ฒคํŠธ๋งŒ ์„ ํƒํ•˜์—ฌ ๋ถˆํ•„์š”ํ•œ ์•Œ๋ฆผ์„ ์ค„์ผ ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.

์›นํ›… ํŽ˜์ด๋กœ๋“œ ๊ตฌ์กฐ

๋ชจ๋“  ์›นํ›…์€ ๋‹ค์Œ๊ณผ ๊ฐ™์€ ๊ธฐ๋ณธ ๊ตฌ์กฐ๋ฅผ ๊ฐ€์ง‘๋‹ˆ๋‹ค:
{
  "event_type": "inquiry",
  "timestamp": "2024-01-15T10:30:45.123456",
  "changed_fields": ["name", "status"],
  "data": {
     // ์ด๋ฒคํŠธ ๊ด€๋ จ ๋ฐ์ดํ„ฐ
  }
}

ํ•„๋“œ ์„ค๋ช…

ํ•„๋“œํƒ€์ž…์„ค๋ช…
event_typestring๋ฐœ์ƒํ•œ ์ด๋ฒคํŠธ ์œ ํ˜• (โ€œinquiryโ€ ๋˜๋Š” โ€œestimateโ€)
timestampstring์ด๋ฒคํŠธ ๋ฐœ์ƒ ์‹œ๊ฐ„ (ISO 8601 ํ˜•์‹)
changed_fieldsarray๋ณ€๊ฒฝ๋œ ํ•„๋“œ ๋ชฉ๋ก
dataobject์ด๋ฒคํŠธ์™€ ๊ด€๋ จ๋œ ์‹ค์ œ ๋ฐ์ดํ„ฐ

์ด๋ฒคํŠธ๋ณ„ ํŽ˜์ด๋กœ๋“œ ์˜ˆ์‹œ

์˜๋ขฐ ๋ณ€๊ฒฝ ์ด๋ฒคํŠธ

  {
    "event_type": "inquiry",
    "timestamp": "2024-01-15T10:30:45.123456",
    "changed_fields": ["name", "status", "inquiry_date", "estimate", "client"],
    "data": {
      "id": 1234,
      "name": "๋ชจ๋ฐ”์ผ ์•ฑ ๊ฐœ๋ฐœ ํ”„๋กœ์ ํŠธ ์˜๋ขฐ",
      "status": {
        "id": 2,
        "title": "๊ฒ€ํ†  ์ค‘"
      },
      "estimate": "15000000",
      "inquiry_date": "2024-01-15T09:00:00",
      "client": {
        "id": 567,
        "company_name": "(์ฃผ)ํ…Œํฌ์Šคํƒ€ํŠธ์—…",
        "ceo_name": "๊น€๋Œ€ํ‘œ",
        "email": "ceo@techstartup.co.kr",
        "contact": "010-1234-5678",
        "in_charge": "๋ฐ•๋งค๋‹ˆ์ €"
      }
    }
  }

๊ฒฌ์ ์„œ ๋ณ€๊ฒฝ ์ด๋ฒคํŠธ

  {
    "data": {
      "id": 886,
      "note": "ํ”„๋กœ์ ํŠธ ๊ด€๋ จ ๋ฉ”๋ชจ",
      "title": "๋ชจ๋ฐ”์ผ ์•ฑ ๊ฐœ๋ฐœ ๊ฒฌ์ ์„œ",
      "status": "ํ™•์ •",
      "has_vat": true,
      "vat_type": "๋ถ€๊ฐ€์„ธ ๋ณ„๋„",
      "total_vat": 0.0,
      "currency_code": "KRW",
      "discount_rate": 0,
      "estimate_date": "2024-01-16",
      "unique_number": "202401-001",
      "discount_amount": 0.0,
      "final_total_amount": 0.0,
      "total_supply_amount": 0.0,
      "total_category_amount": 0.0,
      "total_discount_amount": 0.0,
      "inquiry": {
        "id": 32030,
        "name": "๋ชจ๋ฐ”์ผ ์•ฑ ๊ฐœ๋ฐœ ํ”„๋กœ์ ํŠธ ์˜๋ขฐ"
      },
      "language": "KOR",
      "receiver": {
        "id": 853,
        "email": "customer@company.com",
        "contact": "010-1234-5678",
        "ceo_name": "๊น€๋Œ€ํ‘œ",
        "company_name": "(์ฃผ)ํ…Œํฌ์Šคํƒ€ํŠธ์—…",
        "company_address": "์„œ์šธํŠน๋ณ„์‹œ ๊ฐ•๋‚จ๊ตฌ ํ…Œํ—ค๋ž€๋กœ 123",
        "business_registration_number": "123-45-67890"
      },
      "supplier": {
        "id": 853,
        "email": "supplier@pluuug.com",
        "ceo_name": "๋ฐ•ํ”Œ๋Ÿฌ๊ทธ",
        "company_name": "ํ”Œ๋Ÿฌ๊ทธ๊ฐœ๋ฐœ",
        "company_address": "์„œ์šธํŠน๋ณ„์‹œ ์„œ์ดˆ๊ตฌ ํ”Œ๋Ÿฌ๊ทธ๋กœ 456",
        "business_registration_number": "987-65-43210"
      },
      "in_charge": {
        "id": 164,
        "name": "์ด๋‹ด๋‹น",
        "email": "manager@pluuug.com",
        "phone": "0507-1234-5678"
      },
      "category_set": [
        {
          "id": 2546,
          "type": "ํ’ˆ๋ชฉ",
          "title": "๊ฐœ๋ฐœ๋น„",
          "item_set": [
            {
              "id": 3706,
              "unit": "์ผ",
              "title": "UI/UX ๋””์ž์ธ",
              "quantity": 0.0,
              "unit_cost": 0.0,
              "total_cost": 0.0,
              "description": "๋ชจ๋ฐ”์ผ ์•ฑ UI/UX ๋””์ž์ธ",
              "number_of_people": 1
            }
          ],
          "information_type": null,
          "item_display_name": "ํ•ญ๋ชฉ",
          "total_item_amount": 0.0,
          "unit_display_name": "๋‹จ์œ„",
          "display_item_image": false,
          "information_content": null,
          "quantity_display_name": "์ˆ˜๋Ÿ‰",
          "unit_cost_display_name": "๋‹จ๊ฐ€",
          "total_cost_display_name": "๊ธˆ์•ก",
          "description_display_name": "์„ค๋ช…",
          "number_of_people_display_name": "์ธ์›"
        }
      ]
    },
    "timestamp": "2024-01-15T14:22:15.789012",
    "event_type": "estimate",
    "changed_fields": ["title", "status", "unique_number", "estimate_date", "currency_code", "vat_type", "in_charge", "receiver"]
  }

์ธ์ฆ

์›นํ›… ์š”์ฒญ์˜ ๋ณด์•ˆ์„ ์œ„ํ•ด Authorization ํ—ค๋”์— ํ† ํฐ์„ ํฌํ•จํ•˜์—ฌ ์ „์†กํ•ฉ๋‹ˆ๋‹ค.

์ธ์ฆ ๋ฐฉ๋ฒ•

์›นํ›… ์š”์ฒญ์€ ๋‹ค์Œ๊ณผ ๊ฐ™์€ Authorization ํ—ค๋”๋ฅผ ํฌํ•จํ•ฉ๋‹ˆ๋‹ค:
Authorization: Bearer your-webhook-token
์›นํ›… ์—”๋“œํฌ์ธํŠธ์—์„œ๋Š” ์ด ํ† ํฐ์„ ๊ฒ€์ฆํ•˜์—ฌ ์š”์ฒญ์˜ ์œ ํšจ์„ฑ์„ ํ™•์ธํ•ด์•ผ ํ•ฉ๋‹ˆ๋‹ค.