Hướng dẫn

Đồng bộ thu hoạch sang ERP / kế toán

Đưa phiếu thu hoạch đã xác nhận sang hệ thống của bạn ngay khi có, không trùng, không sót.

  1. 1. Nghe sự kiện thu hoạch

    harvest.batch.created khi phiếu được xác nhận; harvest.batch.verified khi cán bộ xác minh sản lượng thực.

    harvest.batch.createdharvest.batch.verified

  2. 2. Chống trùng

    Lưu X-Nextfarm-Delivery (= webhook-id) đã xử lý; webhook có thể giao lại cùng tin.

  3. 3. Đối soát định kỳ

    Mỗi đêm kéo phiếu theo trạng thái để bù tin lỡ khi hệ thống của bạn ngừng.

    Lệnh mẫu
    curl "https://api-prod.nextfarm.vn/api/v1/harvest/harvest-records?status=confirmed&page=1&page_size=100" -H "Authorization: Bearer nfk_..."

  4. 4. Ghi ngược (tuỳ chọn)

    Khai phiếu thu hoạch từ hệ thống của bạn bằng scope harvest.harvest.create, luôn kèm Idempotency-Key.

    POST /api/v1/harvest/harvest-records