Cập nhật cơ hội

Endpoint

PUT /api/v6.1/opportunity

Ví dụ yêu cầu

curl --location --request PUT 'https://demo.getflycrm.com/api/v6.1/opportunity' \
--header 'Content-Type: application/json' \
--header 'X-API-KEY: YOUR_API_KEY' \
--header 'Cookie: v6_getflycrm_session=YOUR_SESSION_TOKEN' \
--data-raw '{
    "campaign_code": "CD0008",
    "account_code": "KH/2024/119270",
    "account_name": "Khách hàng XYZ",
    "account_phone": "0123456789",
    "account_email": "[email protected]",
    "contact_name": "Người liên hệ A",
    "contact_email": "[email protected]",
    "contact_phone": "0987654321",
    "recipient_username": "user_example",
    "current_opportunity_code": "CH2055057",
    "opportunity_status": 31,
    "description": "Ghi chú cập nhật cơ hội"
}'

Tham số yêu cầu

Trường	Kiểu	Bắt buộc	Mô tả
current_opportunity_id	integer	Có*	ID cơ hội hiện tại cần cập nhật
current_opportunity_code	string	Có*	Mã cơ hội hiện tại cần cập nhật
campaign_id	integer	Có*	ID chiến dịch chứa cơ hội
campaign_code	string	Có*	Mã chiến dịch chứa cơ hội
account_code	string	Không	Mã khách hàng
account_name	string	Không	Tên khách hàng
account_phone	string	Không	Số điện thoại khách hàng
account_email	string	Không	Email khách hàng
contact_name	string	Không	Tên người liên hệ
contact_email	string	Không	Email người liên hệ
contact_phone	string	Không	Điện thoại người liên hệ
recipient_username	string	Không	Tên đăng nhập người nhận xử lý mới
opportunity_status	integer	Không	ID giai đoạn cơ hội trong chiến dịch (lấy từ API Trạng thái chiến dịch)
opportunity_status_name	string	Không	Tên giai đoạn cơ hội (thay thế cho opportunity_status)
amount	numeric	Không	Giá trị cơ hội
probability	numeric	Không	Xác suất chốt đơn (%)
est_finish_date	timestamp	Không	Ngày dự kiến hoàn thành
description	string	Không	Ghi chú mô tả cơ hội
define_fields	object	Không	Các trường dữ liệu tự định nghĩa

Lưu ý:

• Chỉ cần cung cấp một trong hai: current_opportunity_id hoặc current_opportunity_code để xác định cơ hội.
• Chỉ cần cung cấp một trong hai: campaign_id hoặc campaign_code để xác định chiến dịch.
• Để đổi giai đoạn cơ hội đơn giản hơn, dùng API chuyên biệt Đổi giai đoạn cơ hội.

Phản hồi mẫu

{
  "message": "Cập nhật thành công",
  "data": {
    "id": 2055057,
    "description": "Ghi chú cập nhật",
    "account_id": 11973,
    "contact_id": 9753,
    "recipient": 1,
    "receipt_date": 1751013960,
    "updated_at": 1751013960,
    "opportunity_code": "CH2055057",
    "opportunity_name": "Người liên hệ A - Khách hàng XYZ",
    "opportunity_status": 31,
    "create_user": null,
    "amount": 0,
    "actual_amount": 0,
    "campaign_id": 8,
    "probability": 0,
    "status": 0,
    "copy_source_opportunity": null,
    "copy_source_campaign": null,
    "est_finish_date": null,
    "finished_date": null,
    "type_source": "",
    "source_content": "",
    "created_at": 1751013849
  }
}

Ghi chú

• Chỉ cần cung cấp một trong hai: current_opportunity_id hoặc current_opportunity_code để xác định bản ghi cần cập nhật.
• Chỉ cần cung cấp một trong hai: campaign_id hoặc campaign_code để xác định chiến dịch liên quan.
• Để lấy danh sách giai đoạn (opportunity_status) hợp lệ trong chiến dịch, dùng API Trạng thái chiến dịch.
• Nếu chỉ cần đổi giai đoạn cơ hội mà không thay đổi thông tin khác, dùng API chuyên biệt Đổi giai đoạn cơ hội.