> Cải tiến quy trình liên tục > Khoản phải thu > Microsoft Dynamics 365 > Mẫu dữ liệu

Mẫu dữ liệu phải thu của bạn

Microsoft Dynamics 365

Thuộc tính phải thu(21) Hoạt động trong quy trình phải thu(15) Hướng dẫn trích xuất dữ liệu(2)

Mẫu dữ liệu phải thu của bạn

Mẫu này cung cấp khung dữ liệu để sơ đồ hóa quy trình từ hóa đơn đến thu tiền trong Microsoft Dynamics 365. Mẫu nêu rõ các trường dữ liệu và mốc quan trọng cần có để tạo event log chất lượng cao cho process mining. Làm theo cấu trúc này giúp bạn thấy rõ các khoản thanh toán chậm và tinh gọn quy trình thu hồi công nợ.

Các trường dữ liệu cần thiết để phân tích sổ cái
Các mốc quy trình tiêu chuẩn cần theo dõi
Hướng dẫn trích xuất dữ liệu kỹ thuật cho Microsoft Dynamics 365

Chưa quen với nhật ký sự kiện? Tìm hiểu cách tạo nhật ký sự kiện cho process mining.

Tải mẫu xuống

Thuộc tính phải thu

Đây là các trường dữ liệu nên đưa vào event log để phân tích hiệu quả quản lý khoản phải thu.

5 Bắt buộc 8 Nên có 8 Không bắt buộc

	Tên	Mô tả
	Dấu thời gian sự kiện EventTimestamp	Ngày và giờ chính xác khi hoạt động diễn ra.
Mô tả Thuộc tính này ghi lại thời điểm cụ thể một sự kiện được lưu trong hệ thống. Dữ liệu này dùng để tính khoảng thời gian giữa các hoạt động, xác định thời gian xử lý của quy trình và sắp xếp sự kiện theo thứ tự. Trong D365, trường này thường là CreatedDateTime hoặc TransDate kết hợp với thành phần thời gian. Vì sao điều này quan trọng Dấu thời gian rất quan trọng để tính mọi KPI dựa trên thời gian, chẳng hạn như thời gian chu kỳ hóa đơn và thời gian từ lúc ghi sổ đến khi gửi hóa đơn. Lấy dữ liệu ở đâu Thường là các trường CreatedDateTime hoặc TransDate trong nhiều bảng Ví dụ 2023-10-15T08:30:00Z2023-10-15T14:45:22Z2023-11-01T09:00:00Z
	Hoạt động Activity	Sự kiện hoặc tác vụ cụ thể được thực hiện trên hóa đơn.
Mô tả Thuộc tính này mô tả bước diễn ra trong quy trình, chẳng hạn như Ghi sổ hóa đơn, Nhận thanh toán hoặc Mở tranh chấp. Trong Microsoft Dynamics 365, các bước này thường được xác định từ loại giao dịch (TransType) hoặc bảng ghi nhận bản ghi, chẳng hạn như CustSettlement cho khoản thanh toán. Thuộc tính này rất cần thiết để trực quan hóa sơ đồ quy trình. Vì sao điều này quan trọng Thuộc tính này xác định các nút trong sơ đồ quy trình, đồng thời hỗ trợ phân tích luồng quy trình và tìm các biến thể. Lấy dữ liệu ở đâu Lấy từ enum TransType hoặc ngữ cảnh bảng (CustTrans, CustSettlement, v.v.) Ví dụ Đã ghi sổ hóa đơnĐã nhận thanh toánĐã gửi thư thu hồi công nợĐã ghi sổ thông báo tiền lãi
	Số hóa đơn InvoiceNumber	Mã định danh duy nhất của chứng từ hóa đơn tài chính.
Mô tả Số hóa đơn là khóa chính để theo dõi vòng đời khoản phải thu trong Microsoft Dynamics 365. Mã này liên kết đơn hàng bán ban đầu, hóa đơn đã ghi sổ, các khoản thanh toán tiếp theo và mọi hoạt động thu hồi công nợ thành một trường hợp duy nhất. Khi phân tích, thuộc tính này đóng vai trò mã định danh trường hợp để dựng lại luồng quy trình từ đầu đến cuối. Vì sao điều này quan trọng Đây là đơn vị phân tích cơ bản của khoản phải thu, giúp công cụ process mining nhóm các sự kiện rời rạc thành một trường hợp thống nhất. Lấy dữ liệu ở đâu CustInvoiceJour.InvoiceId hoặc CustTrans.Invoice Ví dụ INV-2023-001CIV-88921US-004321DE-99120
	Hệ thống nguồn SourceSystem	Tên hệ thống nơi dữ liệu được tạo ra.
Mô tả Thuộc tính này cho biết hệ thống lưu trữ dữ liệu gốc. Trong trường hợp này, đó là Microsoft Dynamics 365. Thuộc tính này hữu ích khi kết hợp dữ liệu từ nhiều phiên bản ERP hoặc công cụ thu thập bên ngoài vào một chế độ xem duy nhất. Nhờ đó, nhà phân tích có thể lọc hoặc phân nhóm quy trình theo môi trường phát sinh dữ liệu. Vì sao điều này quan trọng Thuộc tính này giúp đảm bảo nguồn gốc và khả năng truy xuất dữ liệu, nhất là khi có nhiều hệ thống. Lấy dữ liệu ở đâu Được gán cố định khi trích xuất hoặc lấy từ chuỗi kết nối Ví dụ D365 F&O ProdD365 FinanceDynamics AX 2012
	Lần cập nhật dữ liệu gần nhất LastDataUpdate	Thời điểm dữ liệu được trích xuất hoặc làm mới.
Mô tả Thuộc tính này cho biết lần gần nhất dữ liệu được lấy từ Microsoft Dynamics 365. Qua đó, người dùng có thể biết dữ liệu phân tích còn mới hay không và KPI có còn đáng tin cậy hay không. Công cụ trích xuất thường tự tạo giá trị này khi chạy truy vấn. Vì sao điều này quan trọng Thuộc tính này cho biết độ trễ của dữ liệu, giúp người dùng đánh giá mức độ cập nhật của các bảng điều khiển. Lấy dữ liệu ở đâu Được tạo bởi ETL hoặc tập lệnh trích xuất Ví dụ 2023-11-05T00:00:00Z2023-11-05T12:00:00Z
	Đơn vị kinh doanh BusinessUnit	Đơn vị hoặc bộ phận phụ trách hóa đơn.
Mô tả Thuộc tính này phân nhóm dữ liệu theo cơ cấu nội bộ, chẳng hạn như bộ phận Điện tử hoặc bộ phận Dịch vụ. Trong D365, đây thường là chiều tài chính gắn với giao dịch. Thuộc tính này hỗ trợ bảng điều khiển Thời gian phát hành hóa đơn bằng cách cho phép so sánh giữa các đơn vị. Vì sao điều này quan trọng Giúp so sánh nội bộ để tìm ra bộ phận hoạt động hiệu quả nhất. Lấy dữ liệu ở đâu Các chiều tài chính (DefaultDimension) trong CustInvoiceJour Ví dụ BU-001Sales-NorthServices-Global
	Được tự động hóa IsAutomated	Cờ cho biết hoạt động có do tài khoản hệ thống thực hiện hay không.
Mô tả Thuộc tính này xác định một bước do người dùng hay tác vụ xử lý hàng loạt tự động thực hiện. Giá trị được tính bằng cách so sánh thuộc tính Người dùng với danh sách tài khoản hệ thống đã biết, chẳng hạn “Workflow” hoặc “Batch”. Thuộc tính này hỗ trợ KPI Tỷ lệ đối trừ thủ công. Vì sao điều này quan trọng Cần thiết để xác định cơ hội tự động hóa và đo lường mức độ tự động hóa hiện tại. Lấy dữ liệu ở đâu Được xác định dựa trên logic của trường User Ví dụ truefalse
	Mã công ty CompanyCode	Mã định danh pháp nhân trong D365.
Mô tả Thuộc tính này thể hiện DataAreaId trong D365, tương ứng với pháp nhân hoặc công ty nơi giao dịch diễn ra. Thuộc tính này cần thiết để lọc dữ liệu trong môi trường có nhiều công ty, đồng thời giúp phân biệt các số hóa đơn trùng nhau giữa các công ty. Vì sao điều này quan trọng Cần thiết để phân biệt dữ liệu giữa nhiều pháp nhân và phân tích theo khu vực. Lấy dữ liệu ở đâu Trường DataAreaId trong tất cả các bảng Ví dụ USMFDEMFGBSI
	Ngày đến hạn DueDate	Ngày dự kiến nhận được khoản thanh toán.
Mô tả Ngày đến hạn là hạn thanh toán theo điều khoản đã thỏa thuận. So sánh ngày này với ngày thanh toán thực tế giúp xác định khoản thanh toán có đúng hạn hay không và tính số ngày phải thu (DSO). Đây là trường tiêu chuẩn trong bản ghi giao dịch khách hàng. Vì sao điều này quan trọng Cần thiết để tính tỷ lệ thanh toán đúng hạn và phân tích hóa đơn quá hạn. Lấy dữ liệu ở đâu CustTrans.DueDate Ví dụ 2023-11-302023-12-15
	Người dùng User	ID người dùng của cá nhân hoặc tài khoản hệ thống thực hiện hoạt động.
Mô tả Thuộc tính này cho biết ai thực hiện bước cụ thể trong quy trình, dựa trên các trường CreatedBy hoặc ModifiedBy. Thuộc tính này giúp phân tích việc sử dụng tài nguyên, xác định nhu cầu đào tạo và phân biệt tác vụ tự động của hệ thống với thao tác thủ công của người dùng. Vì sao điều này quan trọng Giúp phân tích hiệu suất sử dụng tài nguyên và tính tỷ lệ tự động hóa. Lấy dữ liệu ở đâu Trường CreatedBy trong các bảng giao dịch Ví dụ Quản trị viênJSmithWorkflowAgentBSmith
	Nhóm khách hàng CustomerGroup	Phân loại hoặc phân khúc của khách hàng.
Mô tả Thuộc tính này phân khách hàng vào các nhóm như bán buôn, bán lẻ hoặc giao dịch nội bộ. Bạn có thể dùng thuộc tính này để so sánh, chẳng hạn xem phân khúc nào có chu kỳ thanh toán dài hơn hoặc tỷ lệ tranh chấp cao hơn. Trong D365, đây là trường CustGroup. Vì sao điều này quan trọng Giúp so sánh hiệu quả quy trình giữa các phân khúc thị trường. Lấy dữ liệu ở đâu CustTable.CustGroup Ví dụ Bán buônBán lẻGiao dịch nội bộXuất khẩu
	Số tiền hóa đơn InvoiceAmount	Tổng giá trị tiền tệ của hóa đơn.
Mô tả Thuộc tính này thể hiện giá trị tài chính của hóa đơn. Bạn có thể dùng thuộc tính này để tính tổng khoản phải thu và ưu tiên thu hồi các khoản có giá trị lớn. Trường này thường nằm trong bảng nhật ký hóa đơn. Vì sao điều này quan trọng Cần thiết để phân tích tác động tài chính và xác định các điểm nghẽn có giá trị lớn. Lấy dữ liệu ở đâu CustInvoiceJour.InvoiceAmount Ví dụ 1500.00250.5010000.00
	Tài khoản khách hàng CustomerAccount	Mã định danh duy nhất hoặc số tài khoản của khách hàng.
Mô tả Tài khoản khách hàng xác định đơn vị được lập hóa đơn. Trong D365, đây là trường AccountNum. Nhóm dữ liệu theo thuộc tính này giúp phân tích hành vi thanh toán, tần suất tranh chấp và thời gian đối trừ của từng khách hàng. Vì sao điều này quan trọng Cần thiết để xác định khách hàng có rủi ro cao và so sánh hiệu quả theo từng khách hàng. Lấy dữ liệu ở đâu CustInvoiceJour.InvoiceAccount hoặc CustTrans.AccountNum Ví dụ US-001DE-550CUST-9921
	Đã đối trừ IsCleared	Cờ cho biết hóa đơn đã được thanh toán đầy đủ hay chưa.
Mô tả Thuộc tính dạng đúng/sai này cho biết số dư hóa đơn đã về 0 nhờ thanh toán hoặc xóa nợ hay chưa. Bạn có thể dùng thuộc tính này để nhanh chóng lọc hồ sơ đang mở và đã đóng khi tính Thời gian chu kỳ hóa đơn trung bình. Vì sao điều này quan trọng Phân biệt hồ sơ đang xử lý với hồ sơ đã hoàn tất. Lấy dữ liệu ở đâu Được xác định dựa trên việc trường CustTrans.Closed có ngày hay không Ví dụ truefalse
	Điều khoản thanh toán PaymentTerms	Mã quy định lịch thanh toán đã thỏa thuận.
Mô tả Thuộc tính này lưu mã quy định thời điểm đến hạn thanh toán, chẳng hạn Net30 hoặc Net60. Bạn có thể dùng thuộc tính này để xem khách hàng có tuân thủ điều khoản riêng hay không và kiểm tra ngày đến hạn đã được tính chính xác chưa. Vì sao điều này quan trọng Giúp làm rõ ngày đến hạn và xác định điều khoản thanh toán có quá dễ dãi hay quá nghiêm ngặt không. Lấy dữ liệu ở đâu CustInvoiceJour.Payment hoặc CustTable.PaymTermId Ví dụ Net30Net45CODEOM
	ID đơn đặt hàng bán SalesOrderId	Mã tham chiếu của đơn đặt hàng bán liên quan đến hóa đơn.
Mô tả Thuộc tính này liên kết hóa đơn với đơn đặt hàng bán ban đầu. Nếu có dữ liệu từ quy trình Order-to-Cash, bạn có thể phân tích chéo giữa các quy trình và tìm hiểu nguyên nhân từ các bước trước dẫn đến vấn đề lập hóa đơn. Vì sao điều này quan trọng Liên kết quy trình lập hóa đơn với quy trình bán hàng. Lấy dữ liệu ở đâu CustInvoiceJour.SalesId Ví dụ SO-10022SO-55912
	Là giấy báo có IsCreditMemo	Cờ cho biết chứng từ có phải là giấy báo có hay không.
Mô tả Thuộc tính dạng đúng/sai này cho biết giao dịch có phải là giấy báo có phát hành cho khách hàng hay không. Thuộc tính này được dùng để tính Tỷ lệ phát hành giấy báo có và loại hóa đơn thông thường khỏi phân tích làm lại. Vì sao điều này quan trọng Hỗ trợ trực tiếp cho bảng điều khiển Giấy báo có và tần suất làm lại. Lấy dữ liệu ở đâu Được xác định từ CustInvoiceJour.InvoiceAmount < 0 hoặc TransType Ví dụ truefalse
	Lý do tranh chấp DisputeReason	Mã lý do được gán khi một hồ sơ đang có tranh chấp.
Mô tả Thuộc tính này ghi nhận lý do phân loại khiến hóa đơn bị tranh chấp, chẳng hạn như “Sai lệch giá” hoặc “Hàng hóa hư hỏng”. Thuộc tính này rất cần thiết cho bảng điều khiển Vòng đời xử lý tranh chấp, giúp xác định nguyên nhân gốc rễ gây chậm thanh toán. Vì sao điều này quan trọng Giúp phân tích nguyên nhân gốc rễ của KPI Thời gian xử lý tranh chấp. Lấy dữ liệu ở đâu CustTrans.ReasonRefRecId hoặc bảng hồ sơ thu hồi công nợ liên quan Ví dụ Sai lệch giáHàng hóa hư hỏngThiếu đơn đặt hàngChất lượng dịch vụ
	Ngày hết hạn chiết khấu tiền mặt CashDiscountDate	Ngày cuối cùng được hưởng chiết khấu khi thanh toán sớm.
Mô tả Thuộc tính này cho biết hạn cuối để khách hàng được hưởng chiết khấu khi thanh toán sớm. So sánh ngày này với ngày thanh toán giúp tính KPI Tỷ lệ bỏ lỡ chiết khấu và đánh giá hiệu quả của ưu đãi. Vì sao điều này quan trọng Cần thiết cho bảng điều khiển Tối ưu hóa chiết khấu thanh toán sớm. Lấy dữ liệu ở đâu CustTrans.CashDisc hoặc được tính từ CashDiscCode Ví dụ 2023-11-102023-11-15
	Số ngày quá hạn DaysOverdue	Số ngày thanh toán trễ so với ngày đến hạn.
Mô tả Chỉ số này tính khoảng chênh lệch giữa ngày thanh toán và ngày đến hạn. Giá trị dương cho biết thanh toán trễ, còn giá trị âm cho biết thanh toán sớm. Nhờ đó, bạn có thể xem chi tiết hiệu quả thanh toán thay vì chỉ dựa vào cờ đúng/sai. Vì sao điều này quan trọng Giúp phân tích sâu hơn KPI Tỷ lệ thanh toán đúng hạn. Lấy dữ liệu ở đâu Được tính bằng: PaymentDate - DueDate Ví dụ 50-230
	Tiền tệ Currency	Mã tiền tệ của giao dịch hóa đơn.
Mô tả Thuộc tính này cho biết hóa đơn được phát hành bằng loại tiền tệ nào, chẳng hạn USD hoặc EUR. Thuộc tính này cần thiết để quy đổi giá trị tài chính khi phân tích dữ liệu trên nhiều khu vực. Vì sao điều này quan trọng Cần thiết để hiểu cách phân bổ giá trị trong hệ thống có nhiều loại tiền tệ. Lấy dữ liệu ở đâu CustInvoiceJour.CurrencyCode Ví dụ USDEURGBPJPY

Bắt buộc Nên có Không bắt buộc

Hoạt động trong quy trình phải thu

Đây là các bước và mốc chính cần ghi lại trong event log để khám phá chính xác quy trình tất toán thanh toán.

8 Nên có 7 Không bắt buộc

	Hoạt động	Mô tả
	Đã ghi nhận thanh toán một phần	Ghi nhận khoản thanh toán chưa đủ để trả hết số dư hóa đơn chưa thanh toán. Thường dẫn đến việc tiếp tục thu hồi phần còn lại.
Vì sao điều này quan trọng Giúp phân biệt thanh toán theo đợt với tất toán toàn bộ. Đây là thông tin quan trọng để dự báo dòng tiền chính xác. Lấy dữ liệu ở đâu Bảng CustSettlement liên kết khoản thanh toán (CustTrans) với hóa đơn (CustTrans), trong đó SettlementAmount < InvoiceAmount. Thu thập Ghi nhận khi giao dịch X được thực hiện trong CustSettlement Loại sự kiện explicit
	Đã ghi sổ hóa đơn	Ghi nhận hóa đơn lần đầu vào sổ tài chính. Hoạt động này ghi lại việc phát sinh nghĩa vụ tài chính trong bảng CustInvoiceJour.
Vì sao điều này quan trọng Đánh dấu thời điểm chính thức bắt đầu vòng đời khoản phải thu và bắt đầu tính hạn thanh toán. Đây là mốc cần thiết để tính số ngày phải thu bình quân (DSO). Lấy dữ liệu ở đâu Bảng CustInvoiceJour. Trường CreatedDateTime hoặc InvoiceDate dùng làm dấu thời gian. Thu thập Ghi nhận khi giao dịch được ghi sổ vào CustInvoiceJour Loại sự kiện explicit
	Đã gửi hóa đơn	Sự kiện gửi hóa đơn cho khách hàng qua email, bản in hoặc EDI. Thường có thể suy ra sự kiện này khi số đếm 'Printed' tăng hoặc từ nhật ký quản lý in.
Vì sao điều này quan trọng Chậm trễ giữa lúc ghi sổ và gửi hóa đơn làm rút ngắn thời gian thanh toán thực tế của khách hàng, khiến khoản thanh toán có vẻ bị trễ. Lấy dữ liệu ở đâu Suy ra khi CustInvoiceJour.PrintedOriginals đổi từ 0 thành 1, hoặc theo dõi qua bảng PrintJobHeader nếu bật ghi nhật ký. Thu thập So sánh trường trạng thái trước và sau, hoặc xem nhật ký PrintJobHeader Loại sự kiện inferred
	Đã gửi nhắc thanh toán	Ghi nhận việc gửi thư thu hồi công nợ chính thức cho khách hàng. Dữ liệu được lấy từ Nhật ký thư thu hồi công nợ.
Vì sao điều này quan trọng Đánh dấu thời điểm bắt đầu các hoạt động thu hồi công nợ chủ động. Phân tích tần suất giúp tối ưu chiến lược nhắc nợ và giảm chi phí hành chính. Lấy dữ liệu ở đâu Bảng CustCollectionLetterJour. Ghi nhận ngày mã thư được ghi sổ cho giao dịch hóa đơn cụ thể. Thu thập Ghi nhận khi giao dịch được ghi sổ vào CustCollectionLetterJour Loại sự kiện explicit
	Đã mở vụ việc tranh chấp	Tạo vụ việc trong mô-đun Quản lý vụ việc và liên kết với hóa đơn, cho biết khách hàng có ý kiến phản đối. Sự kiện này tạm dừng quy trình thu hồi công nợ thông thường.
Vì sao điều này quan trọng Tranh chấp là một trong những nguyên nhân chính gây chậm thanh toán. Theo dõi tranh chấp giúp phát hiện vấn đề chất lượng ở các quy trình trước đó, chẳng hạn như định giá hoặc thực hiện đơn hàng. Lấy dữ liệu ở đâu Bảng CaseDetailBase, trong đó Category liên quan đến Collections/AR và RefRecId liên kết với thông tin hóa đơn. Thu thập Ghi nhận khi giao dịch X được thực hiện trong Case Management Loại sự kiện explicit
	Đã nhận đủ tiền thanh toán	Ghi sổ giao dịch thanh toán đủ số dư còn lại của hóa đơn. Đây là sự kiện ghi nhận dòng tiền vào.
Vì sao điều này quan trọng Đây là sự kiện thành công quan trọng nhất. Dùng để tính tỷ lệ thanh toán đúng hạn và đánh giá hiệu quả của điều khoản chiết khấu. Lấy dữ liệu ở đâu Bảng CustTrans có Type là 'Payment', liên kết với hóa đơn qua CustSettlement và đưa số dư về 0. Thu thập Ghi nhận khi giao dịch được ghi sổ vào CustTrans và tất toán Loại sự kiện explicit
	Đã phát hành giấy báo có	Ghi sổ giấy báo có để bù trừ số tiền trên hóa đơn ban đầu. Thường phát sinh sau khi giải quyết tranh chấp hoặc xử lý hàng trả lại.
Vì sao điều này quan trọng Tần suất cao cho thấy thất thoát doanh thu và vấn đề chất lượng ở các khâu trước. Khác với thanh toán, đây là hình thức tất toán không bằng tiền mặt. Lấy dữ liệu ở đâu Bảng CustTrans với Type là 'Credit Note', hoặc CustInvoiceJour có InvoiceAmount âm. Thu thập Ghi nhận khi giao dịch được ghi sổ vào CustTrans Loại sự kiện explicit
	Đã tất toán hóa đơn	Thay đổi trạng thái cuối cùng, khi số dư hóa đơn về 0 và giao dịch được đánh dấu là 'Closed' trong hệ thống.
Vì sao điều này quan trọng Thời điểm kết thúc hoàn toàn của một trường hợp trong quy trình. Dùng để tính tổng thời gian chu kỳ. Lấy dữ liệu ở đâu Trường CustTrans.Closed (ngày). Trường này được điền khi tổng số tiền tất toán bằng số tiền hóa đơn. Thu thập Suy ra từ trường ngày CustTrans.Closed Loại sự kiện inferred
	Đã đối chiếu sao kê ngân hàng	Sự kiện đối chiếu trong đó khoản thanh toán đã ghi nhận ở khoản phải thu được khớp với một dòng trên sao kê ngân hàng đã nhập.
Vì sao điều này quan trọng Xác nhận tiền thực sự đã vào ngân hàng. Chậm trễ ở đây cho thấy quy trình Quản lý tiền mặt và ngân hàng chưa hiệu quả. Lấy dữ liệu ở đâu Trạng thái khớp trong BankReconciliationLine hoặc BankAccountTrans. Cần có mô-đun Advanced Bank Reconciliation. Thu thập Ghi nhận khi giao dịch được khớp trong Bank Reconciliation Loại sự kiện explicit
	Đã giải quyết tranh chấp	Đóng vụ việc tranh chấp để hóa đơn có thể tiếp tục đến bước thanh toán hoặc ghi có. Đánh dấu kết thúc quy trình con xử lý ngoại lệ.
Vì sao điều này quan trọng Khoảng thời gian từ lúc mở đến lúc giải quyết là KPI quan trọng để đo hiệu quả xử lý hành chính. Lấy dữ liệu ở đâu Bảng CaseDetailBase, khi Status chuyển thành Closed/Resolved. Thu thập So sánh trường trạng thái trước và sau trong CaseDetailBase Loại sự kiện inferred
	Đã nhận cam kết thanh toán	Cam kết cụ thể do nhân viên thu hồi công nợ ghi nhận, trong đó khách hàng hứa thanh toán trước một ngày nhất định. Dữ liệu được lấy từ mô-đun Quản lý thu hồi công nợ.
Vì sao điều này quan trọng Đo lường hiệu quả của các cuộc gọi thu hồi công nợ. So sánh ngày cam kết với ngày thanh toán thực tế cho thấy mức độ đáng tin cậy trong cam kết của khách hàng. Lấy dữ liệu ở đâu Bảng CustPromiseToPay. Liên kết với giao dịch khách hàng qua TransRecId. Thu thập Ghi nhận khi tạo bản ghi trong CustPromiseToPay Loại sự kiện explicit
	Đã quá hạn thanh toán	Mốc được tính khi ngày hiện tại đã qua ngày đến hạn của hóa đơn nhưng hóa đơn vẫn chưa thanh toán hết. Mốc này đánh dấu hóa đơn quá hạn.
Vì sao điều này quan trọng Mốc này rất quan trọng để phân tích tuổi nợ và kích hoạt quy trình thu hồi công nợ. Nó phân định giai đoạn lập hóa đơn thông thường với giai đoạn quản lý thu hồi công nợ. Lấy dữ liệu ở đâu Tính bằng cách so sánh CustInvoiceJour.DueDate với thời điểm mô phỏng hiện tại hoặc dấu thời gian thanh toán. Thu thập Xác định bằng cách so sánh trường DueDate với thời điểm hiện tại Loại sự kiện calculated
	Đã tạo thông báo tiền lãi	Tạo thông báo tiền lãi cho các khoản thanh toán quá hạn. Đây là khoản phạt tài chính áp dụng cho tài khoản khách hàng.
Vì sao điều này quan trọng Cho thấy khoản nợ quá hạn nghiêm trọng. Phân tích giúp xác định liệu khoản phạt có thúc đẩy thanh toán nhanh hơn hay làm ảnh hưởng đến quan hệ khách hàng. Lấy dữ liệu ở đâu Bảng CustInterestJour. Bảng này ghi lại thông báo tiền lãi được tạo cho từng giao dịch khách hàng. Thu thập Ghi nhận khi giao dịch được ghi sổ vào CustInterestJour Loại sự kiện explicit
	Đã xóa nợ khoản thanh toán	Ghi nhận hóa đơn không thể thu hồi và xóa số dư bằng bút toán xóa nợ. Đây là một khoản lỗ tài chính.
Vì sao điều này quan trọng Trạng thái kết thúc của quy trình thu hồi công nợ không thành công. Cần thiết để phân tích tỷ lệ nợ xấu và hiệu quả của chính sách tín dụng. Lấy dữ liệu ở đâu Bảng CustTrans với Type là 'WriteOff', hoặc GeneralJournalEntry được đánh dấu cụ thể bằng mã lý do xóa nợ. Thu thập Ghi nhận khi giao dịch được ghi sổ với loại WriteOff Loại sự kiện explicit
	Đang xem xét tranh chấp	Cho biết vụ việc tranh chấp đã chuyển từ trạng thái 'Opened' sang 'In Process'. Mốc này thể hiện thời gian đội ngũ xử lý vụ việc.
Vì sao điều này quan trọng Điểm nghẽn ở giai đoạn này làm kéo dài chu kỳ chuyển đổi tiền mặt. Mốc này giúp tách thời gian chờ khỏi thời gian xử lý thực tế. Lấy dữ liệu ở đâu Suy ra từ thay đổi trong trường CaseDetailBase.Status hoặc các mục trong bảng CaseLog tương ứng với quá trình chuyển trạng thái. Thu thập So sánh trường trạng thái trước và sau trong CaseDetailBase Loại sự kiện inferred

Nên có Không bắt buộc

Hướng dẫn trích xuất dữ liệu

Cách lấy dữ liệu từ Microsoft Dynamics 365

Các bước

Cấu hình tài nguyên Azure: Tạo Azure SQL Database làm đích Bring Your Own Database (BYOD). Đảm bảo chuỗi kết nối có thông tin đăng nhập với quyền đọc/ghi.
Cấu hình Data Management trong D365: Vào System Administration > Workspaces > Data Management. Chọn ô 'Configure Entity Export to Database'. Nhập chuỗi kết nối ở bước trước để đăng ký cơ sở dữ liệu bên ngoài.
Chọn các thực thể cần thiết: Tạo Export Project mới trong không gian làm việc Data Management. Thêm các thực thể tiêu chuẩn sau vào dự án: CustInvoiceJournalHeaderEntity, CustTransactionEntity, CustSettlementEntity, CustCollectionLetterJournalHeaderEntity, CaseDetailEntity, CaseAssociationEntity, CustInterestJournalEntity, BankAccountTransEntity và CustPromiseToPayEntity.
Ánh xạ nguồn sang đích: Đảm bảo ánh xạ chính xác tất cả các trường, đặc biệt là RecId và CreatedDateTime vì đây là các trường quan trọng để sắp xếp sự kiện theo trình tự.
Chạy lần xuất dữ liệu đầu tiên: Chạy thủ công tác vụ xuất dữ liệu (Job type: Export) để tải toàn bộ dữ liệu lịch sử vào Azure SQL Database. Kiểm tra phần tóm tắt thực thi để xác nhận mọi bản ghi đã được chuyển thành công.
Lên lịch cập nhật tăng dần: Thiết lập tác vụ dữ liệu định kỳ để chạy dự án xuất dữ liệu (chẳng hạn 4 giờ một lần hoặc mỗi đêm), dùng 'Incremental push' để chỉ cập nhật các bản ghi đã thay đổi.
Kết nối với Azure SQL: Dùng SQL Server Management Studio (SSMS) hoặc công cụ tương tự để kết nối với Azure SQL Database BYOD.
Chạy tập lệnh chuyển đổi: Chạy tập lệnh SQL trong phần Query bên dưới trên các bảng BYOD. Tập lệnh này hợp nhất dữ liệu từ nhiều bảng thành một cấu trúc event log duy nhất.
Kiểm tra và trích xuất: Kiểm tra tính nhất quán của kết quả (xem các bước xác thực). Xuất tập kết quả thành tệp CSV hoặc Parquet để nạp vào ProcessMind.

Cấu hình

Phương thức xuất dữ liệu: Bring Your Own Database (BYOD) hoặc Azure Data Lake Storage Gen2 (ADLS).
Cách làm mới dữ liệu: Dùng Full push cho lần tải đầu tiên và Incremental push cho các lần cập nhật định kỳ để giảm ảnh hưởng đến hiệu năng.
Thực thể cần thiết: CustInvoiceJournalHeaderEntity (hóa đơn), CustSettlementEntity (thanh toán/đối trừ), CustCollectionLetterJournalHeaderEntity (thư nhắc thanh toán), CaseDetailEntity (tranh chấp), BankAccountTransEntity (đối chiếu ngân hàng).
Bộ lọc công ty: Lọc theo cột 'DataAreaId' nếu chỉ phân tích một số pháp nhân cụ thể.
Khoảng thời gian: Nên dùng dữ liệu cuốn chiếu 12 tháng, dựa trên 'InvoiceDate' hoặc 'TransDate'.
Theo dõi thay đổi: Cần bật tính năng này trên các bảng SQL trong D365 để xuất dữ liệu tăng dần hiệu quả.

Truy vấn mẫu sql

/* SQL Transformation Script for D365 BYOD Tables */
/* Target: Azure SQL Database containing exported entities */

WITH InvoiceBasics AS (
    SELECT 
        InvoiceNumber AS InvoiceId,
        InvoiceDate,
        DueDate,
        InvoiceAccount AS CustomerAccount,
        SalesId,
        DataAreaId AS CompanyCode,
        InvoiceAmount,
        Currency
    FROM dbo.CustInvoiceJournalHeaderEntity
    WHERE InvoiceDate >= DATEADD(month, -12, GETDATE())
)

/* 1. Invoice Posted */
SELECT 
    T1.InvoiceId AS InvoiceNumber,
    'Invoice Posted' AS Activity,
    CAST(T1.InvoiceDate AS DATETIME) AS EventTimestamp,
    'D365 F&O' AS SourceSystem,
    GETDATE() AS LastDataUpdate,
    T1.CustomerAccount,
    NULL AS CustomerGroup,
    T1.InvoiceAmount,
    T1.DueDate,
    NULL AS [User],
    NULL AS BusinessUnit,
    T1.CompanyCode,
    1 AS IsAutomated
FROM InvoiceBasics T1

UNION ALL

/* 2. Invoice Dispatched (Inferred from Document Date as Proxy if Print Log unavailable) */
SELECT 
    T1.InvoiceId,
    'Invoice Dispatched' AS Activity,
    DATEADD(minute, 5, CAST(T1.InvoiceDate AS DATETIME)) AS EventTimestamp,
    'D365 F&O' AS SourceSystem,
    GETDATE() AS LastDataUpdate,
    T1.CustomerAccount,
    NULL,
    T1.InvoiceAmount,
    T1.DueDate,
    NULL,
    NULL,
    T1.CompanyCode,
    1
FROM InvoiceBasics T1

UNION ALL

/* 3. Due Date Passed (Synthetic Event) */
SELECT 
    T1.InvoiceId,
    'Due Date Passed' AS Activity,
    CAST(T1.DueDate AS DATETIME) AS EventTimestamp,
    'D365 F&O' AS SourceSystem,
    GETDATE() AS LastDataUpdate,
    T1.CustomerAccount,
    NULL,
    T1.InvoiceAmount,
    T1.DueDate,
    NULL,
    NULL,
    T1.CompanyCode,
    1
FROM InvoiceBasics T1
WHERE GETDATE() > T1.DueDate

UNION ALL

/* 4. Payment Reminder Sent */
SELECT 
    Inv.InvoiceId,
    'Payment Reminder Sent' AS Activity,
    CL.JournalDate AS EventTimestamp,
    'D365 F&O' AS SourceSystem,
    GETDATE() AS LastDataUpdate,
    Inv.CustomerAccount,
    NULL,
    Inv.InvoiceAmount,
    Inv.DueDate,
    CL.CreatedBy AS [User],
    NULL,
    Inv.CompanyCode,
    0
FROM dbo.CustCollectionLetterJournalHeaderEntity CL
JOIN dbo.CustCollectionLetterLineEntity CLL ON CL.JournalNumber = CLL.JournalNumber AND CL.DataAreaId = CLL.DataAreaId
JOIN InvoiceBasics Inv ON CLL.InvoiceId = Inv.InvoiceId AND CLL.DataAreaId = Inv.CompanyCode

UNION ALL

/* 5. Promise to Pay Received */
SELECT 
    Inv.InvoiceId,
    'Promise to Pay Received' AS Activity,
    PTP.PromiseDate AS EventTimestamp,
    'D365 F&O' AS SourceSystem,
    GETDATE() AS LastDataUpdate,
    Inv.CustomerAccount,
    NULL,
    Inv.InvoiceAmount,
    Inv.DueDate,
    NULL,
    NULL,
    Inv.CompanyCode,
    0
FROM dbo.CustPromiseToPayEntity PTP
JOIN InvoiceBasics Inv ON PTP.Invoice = Inv.InvoiceId AND PTP.DataAreaId = Inv.CompanyCode

UNION ALL

/* 6. Dispute Case Opened */
SELECT 
    Inv.InvoiceId,
    'Dispute Case Opened' AS Activity,
    CD.CreatedDateTime AS EventTimestamp,
    'D365 F&O' AS SourceSystem,
    GETDATE() AS LastDataUpdate,
    Inv.CustomerAccount,
    NULL,
    Inv.InvoiceAmount,
    Inv.DueDate,
    CD.CreatedBy AS [User],
    NULL,
    Inv.CompanyCode,
    0
FROM dbo.CaseDetailEntity CD
JOIN dbo.CaseAssociationEntity CA ON CD.CaseId = CA.CaseId AND CD.DataAreaId = CA.DataAreaId
JOIN InvoiceBasics Inv ON CA.RefRecId = Inv.InvoiceId /* Logic assumes linking via Invoice Number or manual mapping might be needed depending on RefTableId */
WHERE CA.RefEntityName = 'CustInvoiceTable'

UNION ALL

/* 7. Dispute Under Review */
SELECT 
    Inv.InvoiceId,
    'Dispute Under Review' AS Activity,
    CD.ModifiedDateTime AS EventTimestamp,
    'D365 F&O' AS SourceSystem,
    GETDATE() AS LastDataUpdate,
    Inv.CustomerAccount,
    NULL,
    Inv.InvoiceAmount,
    Inv.DueDate,
    CD.ModifiedBy AS [User],
    NULL,
    Inv.CompanyCode,
    0
FROM dbo.CaseDetailEntity CD
JOIN dbo.CaseAssociationEntity CA ON CD.CaseId = CA.CaseId AND CD.DataAreaId = CA.DataAreaId
JOIN InvoiceBasics Inv ON CA.RefRecId = Inv.InvoiceId
WHERE CD.Status = 'InProcess'

UNION ALL

/* 8. Dispute Resolved */
SELECT 
    Inv.InvoiceId,
    'Dispute Resolved' AS Activity,
    CD.ClosedDateTime AS EventTimestamp,
    'D365 F&O' AS SourceSystem,
    GETDATE() AS LastDataUpdate,
    Inv.CustomerAccount,
    NULL,
    Inv.InvoiceAmount,
    Inv.DueDate,
    CD.ModifiedBy AS [User],
    NULL,
    Inv.CompanyCode,
    0
FROM dbo.CaseDetailEntity CD
JOIN dbo.CaseAssociationEntity CA ON CD.CaseId = CA.CaseId AND CD.DataAreaId = CA.DataAreaId
JOIN InvoiceBasics Inv ON CA.RefRecId = Inv.InvoiceId
WHERE CD.Status = 'Closed'

UNION ALL

/* 9. Credit Memo Issued */
SELECT 
    T1.InvoiceId,
    'Credit Memo Issued' AS Activity,
    T1.InvoiceDate AS EventTimestamp,
    'D365 F&O' AS SourceSystem,
    GETDATE() AS LastDataUpdate,
    T1.CustomerAccount,
    NULL,
    T1.InvoiceAmount,
    T1.DueDate,
    NULL,
    NULL,
    T1.CompanyCode,
    0
FROM dbo.CustInvoiceJournalHeaderEntity T1
WHERE T1.InvoiceAmount < 0

UNION ALL

/* 10. Interest Note Generated */
SELECT 
    Inv.InvoiceId,
    'Interest Note Generated' AS Activity,
    IJ.InterestDate AS EventTimestamp,
    'D365 F&O' AS SourceSystem,
    GETDATE() AS LastDataUpdate,
    Inv.CustomerAccount,
    NULL,
    Inv.InvoiceAmount,
    Inv.DueDate,
    IJ.CreatedBy AS [User],
    NULL,
    Inv.CompanyCode,
    1
FROM dbo.CustInterestJournalEntity IJ
JOIN InvoiceBasics Inv ON IJ.AccountDisplayValue = Inv.CustomerAccount AND IJ.DataAreaId = Inv.CompanyCode
/* Note: Direct link to specific Invoice ID is often via CustInterestTrans, requiring an additional join */

UNION ALL

/* 11. Partial Payment Posted */
SELECT 
    Inv.InvoiceId,
    'Partial Payment Posted' AS Activity,
    Sett.TransDate AS EventTimestamp,
    'D365 F&O' AS SourceSystem,
    GETDATE() AS LastDataUpdate,
    Inv.CustomerAccount,
    NULL,
    Sett.SettleAmountCur AS InvoiceAmount,
    Inv.DueDate,
    Sett.CreatedBy AS [User],
    NULL,
    Inv.CompanyCode,
    0
FROM dbo.CustSettlementEntity Sett
JOIN dbo.CustTransactionEntity Trans ON Sett.TransRecId = Trans.RecId
JOIN InvoiceBasics Inv ON Trans.Invoice = Inv.InvoiceId AND Trans.DataAreaId = Inv.CompanyCode
WHERE ABS(Sett.SettleAmountCur) < ABS(Trans.AmountCur) AND Sett.SettleAmountCur <> 0

UNION ALL

/* 12. Full Payment Received */
SELECT 
    Inv.InvoiceId,
    'Full Payment Received' AS Activity,
    Sett.TransDate AS EventTimestamp,
    'D365 F&O' AS SourceSystem,
    GETDATE() AS LastDataUpdate,
    Inv.CustomerAccount,
    NULL,
    Sett.SettleAmountCur AS InvoiceAmount,
    Inv.DueDate,
    Sett.CreatedBy AS [User],
    NULL,
    Inv.CompanyCode,
    0
FROM dbo.CustSettlementEntity Sett
JOIN dbo.CustTransactionEntity Trans ON Sett.TransRecId = Trans.RecId
JOIN InvoiceBasics Inv ON Trans.Invoice = Inv.InvoiceId AND Trans.DataAreaId = Inv.CompanyCode
WHERE ABS(Sett.SettleAmountCur) >= ABS(Trans.AmountCur)

UNION ALL

/* 13. Bank Statement Matched */
SELECT 
    Inv.InvoiceId,
    'Bank Statement Matched' AS Activity,
    Bank.TransDate AS EventTimestamp,
    'D365 F&O' AS SourceSystem,
    GETDATE() AS LastDataUpdate,
    Inv.CustomerAccount,
    NULL,
    Bank.AmountCur AS InvoiceAmount,
    Inv.DueDate,
    NULL,
    NULL,
    Inv.CompanyCode,
    1
FROM dbo.BankAccountTransEntity Bank
JOIN dbo.CustSettlementEntity Sett ON Bank.Voucher = Sett.OffsetTransVoucher AND Bank.DataAreaId = Sett.DataAreaId
JOIN dbo.CustTransactionEntity Trans ON Sett.TransRecId = Trans.RecId
JOIN InvoiceBasics Inv ON Trans.Invoice = Inv.InvoiceId

UNION ALL

/* 14. Payment Written Off */
SELECT 
    Inv.InvoiceId,
    'Payment Written Off' AS Activity,
    Trans.TransDate AS EventTimestamp,
    'D365 F&O' AS SourceSystem,
    GETDATE() AS LastDataUpdate,
    Inv.CustomerAccount,
    NULL,
    Trans.AmountCur AS InvoiceAmount,
    Inv.DueDate,
    Trans.CreatedBy AS [User],
    NULL,
    Inv.CompanyCode,
    0
FROM dbo.CustTransactionEntity Trans
JOIN InvoiceBasics Inv ON Trans.Invoice = Inv.InvoiceId AND Trans.DataAreaId = Inv.CompanyCode
WHERE Trans.TransactionType = 'WriteOff'

UNION ALL

/* 15. Invoice Cleared */
SELECT 
    Inv.InvoiceId,
    'Invoice Cleared' AS Activity,
    Trans.ClosedDate AS EventTimestamp,
    'D365 F&O' AS SourceSystem,
    GETDATE() AS LastDataUpdate,
    Inv.CustomerAccount,
    NULL,
    Inv.InvoiceAmount,
    Inv.DueDate,
    NULL,
    NULL,
    Inv.CompanyCode,
    1
FROM dbo.CustTransactionEntity Trans
JOIN InvoiceBasics Inv ON Trans.Invoice = Inv.InvoiceId AND Trans.DataAreaId = Inv.CompanyCode
WHERE Trans.ClosedDate IS NOT NULL AND Trans.ClosedDate <> '1900-01-01'

Các bước

Cài đặt điều kiện cần: Đảm bảo máy chạy tập lệnh đã cài Python 3.x. Cài các thư viện cần thiết bằng pip: pandas, requests và msal (nếu dùng Microsoft Authentication Library, dù tập lệnh này dùng REST trực tiếp cho đơn giản).
Đăng ký ứng dụng Azure: Đăng ký ứng dụng trong Azure Active Directory (Entra ID) để cấp quyền truy cập Dynamics 365. Ghi lại Client ID, Client Secret và Tenant ID. Đảm bảo ứng dụng có quyền API cho Dynamics ERP (OData).
Cấu hình tập lệnh: Mở tập lệnh Python được cung cấp. Cập nhật từ điển config ở đầu tập lệnh bằng D365 URL, Client ID, Client Secret, Tenant ID và Company Code đích (dataAreaId) của bạn.
Xác định khoảng ngày: Sửa các biến start_date và end_date trong tập lệnh để xác định khoảng thời gian trích xuất. Nên dùng khoảng thời gian cuốn chiếu từ 90 đến 180 ngày gần nhất cho các lần tải tăng dần.
Chạy trích xuất: Chạy tập lệnh. Tập lệnh xác thực với Azure AD, lấy access token và lần lượt truy vấn nhiều thực thể OData (CustomerInvoices, PaymentJournals, CaseDetails, v.v.) để lấy dữ liệu.
Xử lý dữ liệu: Tập lệnh tự chuyển đổi dữ liệu, chẳng hạn đổi tên cột cho khớp với lược đồ ProcessMind, tính các sự kiện 'Due Date Passed' dựa trên ngày hệ thống, đồng thời phân biệt thanh toán một phần và thanh toán đủ dựa trên số tiền giao dịch.
Gộp và sắp xếp: Tập lệnh nối tất cả dataframe hoạt động thành một nhật ký sự kiện, rồi sắp xếp theo InvoiceNumber và EventTimestamp.
Xuất dữ liệu: Dataframe cuối cùng được xuất thành tệp CSV có tên AR_Event_Log.csv. Kiểm tra tệp đã được tạo trong thư mục chứa tập lệnh.
Kiểm tra dữ liệu: Mở tệp CSV, kiểm tra ngày theo định dạng ISO (YYYY-MM-DD HH:MM:SS) và xác nhận mọi cột bắt buộc đều có dữ liệu.
Tải lên: Nhập tệp CSV đã tạo vào ProcessMind bằng trình hướng dẫn tải tệp tiêu chuẩn. Ánh xạ cột InvoiceNumber thành Mã trường hợp, Activity thành Hoạt động và EventTimestamp thành dấu thời gian.

Cấu hình

Kích thước lô: Tập lệnh dùng kích thước trang mặc định (thường là 1.000 bản ghi) do máy chủ kiểm soát. Tập lệnh tự xử lý phân trang bằng thuộc tính @odata.nextLink.
Bộ lọc ngày: Tham số $filter của OData giới hạn dữ liệu truy xuất theo khoảng thời gian liên quan (chẳng hạn InvoiceDate ge 2023-01-01T00:00:00Z). Cách này giúp tăng đáng kể hiệu năng.
Lọc theo công ty: D365 lưu dữ liệu của nhiều pháp nhân. Tập lệnh lọc theo dataAreaId để chỉ trích xuất dữ liệu của đơn vị kinh doanh liên quan.
Xác thực: Dùng OAuth 2.0 (Client Credentials Flow). Bạn cần Client Secret và App Registration hợp lệ.
Chọn thực thể: Tập lệnh dùng các thực thể tiêu chuẩn như CustomerInvoices, CustomerPaymentJournalLines và CaseDetail. Nếu tổ chức của bạn dùng thực thể tùy chỉnh, cần cập nhật các điểm cuối trong từ điển endpoints.
Sự kiện được tính toán: Các sự kiện như 'Đã qua hạn thanh toán' được tính khi chạy tập lệnh vì chúng không tạo ra giao dịch riêng trong cơ sở dữ liệu.

Truy vấn mẫu python

import requests
import pandas as pd
import datetime
from datetime import  timedelta
import json

class=class="hl-string">"hl-comment"># === CONFIGURATION ===
config = {
    class="hl-string">"resource": class="hl-string">"https://[YourOrg].operations.dynamics.com",
    class="hl-string">"tenant_id": class="hl-string">"[Your-Tenant-ID]",
    class="hl-string">"client_id": class="hl-string">"[Your-Client-ID]",
    class="hl-string">"client_secret": class="hl-string">"[Your-Client-Secret]",
    class="hl-string">"company_code": class="hl-string">"USMF",  class=class="hl-string">"hl-comment"># Example Company Code
    class="hl-string">"start_date": class="hl-string">"2023-01-01T00:00:00Z"
}

class=class="hl-string">"hl-comment"># === AUTHENTICATION ===
def get_token(config):
    token_url = fclass="hl-string">"https://login.microsoftonline.com/{config['tenant_id']}/oauth2/token"
    payload = {
        class="hl-string">'grant_type': class="hl-string">'client_credentials',
        class="hl-string">'client_id': config[class="hl-string">'client_id'],
        class="hl-string">'client_secret': config[class="hl-string">'client_secret'],
        class="hl-string">'resource': config[class="hl-string">'resource']
    }
    response = requests.post(token_url, data=payload)
    if response.status_code == 200:
        return response.json().get(class="hl-string">'access_token')
    else:
        raise Exception(fclass="hl-string">"Auth Failed: {response.text}")

class=class="hl-string">"hl-comment"># === ODATA FETCHER ===
def get_odata_data(token, entity_url, filter_str):
    headers = {class="hl-string">'Authorization': fclass="hl-string">'Bearer {token}', class="hl-string">'Accept': class="hl-string">'application/json'}
    results = []
    next_link = fclass="hl-string">"{config['resource']}/data/{entity_url}?$filter={filter_str}&$format=json"
    
    while next_link:
        print(fclass="hl-string">"Fetching: {next_link}")
        try:
            res = requests.get(next_link, headers=headers)
            if res.status_code != 200:
                print(fclass="hl-string">"Error fetching data: {res.text}")
                break
            data = res.json()
            results.extend(data.get(class="hl-string">'value', []))
            next_link = data.get(class="hl-string">'@odata.nextLink', None)
        except Exception as e:
            print(fclass="hl-string">"Exception: {e}")
            break
    return pd.DataFrame(results)

class=class="hl-string">"hl-comment"># === MAIN EXTRACTION ===
def main():
    token = get_token(config)
    all_events = []
    company_filter = fclass="hl-string">"dataAreaId eq '{config['company_code']}'"
    date_filter = fclass="hl-string">"InvoiceDate ge {config['start_date']}"

    class=class="hl-string">"hl-comment"># 1. INVOICE BASIC EVENTS (Posted, Dispatched, Credit Memo, Cleared)
    class=class="hl-string">"hl-comment"># Entity: CustomerInvoices (or SalesInvoiceHeaders)
    print(class="hl-string">"Processing Invoices...")
    df_inv = get_odata_data(token, class="hl-string">"CustomerInvoices", fclass="hl-string">"{company_filter} and {date_filter}")
    
    if not df_inv.empty:
        class=class="hl-string">"hl-comment"># Activity: Invoice Posted
        posted = df_inv.copy()
        posted[class="hl-string">'Activity'] = class="hl-string">'Invoice Posted'
        posted[class="hl-string">'EventTimestamp'] = posted[class="hl-string">'InvoiceDate']
        all_events.append(posted)

        class=class="hl-string">"hl-comment"># Activity: Invoice Dispatched (Assumed same day as posted if not tracked separately)
        dispatched = df_inv.copy()
        dispatched[class="hl-string">'Activity'] = class="hl-string">'Invoice Dispatched'
        dispatched[class="hl-string">'EventTimestamp'] = dispatched[class="hl-string">'InvoiceDate']  class=class="hl-string">"hl-comment"># Often inferred
        all_events.append(dispatched)

        class=class="hl-string">"hl-comment"># Activity: Credit Memo Issued
        credit_memos = df_inv[df_inv[class="hl-string">'InvoiceAmount'] < 0].copy()
        credit_memos[class="hl-string">'Activity'] = class="hl-string">'Credit Memo Issued'
        credit_memos[class="hl-string">'EventTimestamp'] = credit_memos[class="hl-string">'InvoiceDate']
        all_events.append(credit_memos)

        class=class="hl-string">"hl-comment"># Activity: Invoice Cleared (Closed)
        class=class="hl-string">"hl-comment"># Note: ClosedDate might need to be cast to datetime
        cleared = df_inv[df_inv[class="hl-string">'ClosedDate'].notnull()].copy()
        if not cleared.empty:
            cleared[class="hl-string">'Activity'] = class="hl-string">'Invoice Cleared'
            cleared[class="hl-string">'EventTimestamp'] = cleared[class="hl-string">'ClosedDate']
            all_events.append(cleared)

        class=class="hl-string">"hl-comment"># Activity: Due Date Passed (Calculated)
        class=class="hl-string">"hl-comment"># Logic: If not closed, and DueDate < Now
        now = datetime.datetime.now()
        overdue = df_inv[(df_inv[class="hl-string">'ClosedDate'].isnull())].copy()
        class=class="hl-string">"hl-comment"># Convert DueDate to datetime objects for comparison
        overdue[class="hl-string">'DueDate_DT'] = pd.to_datetime(overdue[class="hl-string">'DueDate'])
        overdue = overdue[overdue[class="hl-string">'DueDate_DT'] < now]
        if not overdue.empty:
            overdue[class="hl-string">'Activity'] = class="hl-string">'Due Date Passed'
            class=class="hl-string">"hl-comment"># Timestamp is the day it became overdue
            overdue[class="hl-string">'EventTimestamp'] = overdue[class="hl-string">'DueDate'] 
            all_events.append(overdue)

    class=class="hl-string">"hl-comment"># 2. PAYMENTS (Partial, Full, WriteOff)
    class=class="hl-string">"hl-comment"># Entity: CustomerPaymentJournalLines
    print(class="hl-string">"Processing Payments...")
    class=class="hl-string">"hl-comment"># Note: Filter by TransDate usually
    df_pay = get_odata_data(token, class="hl-string">"CustomerPaymentJournalLines", fclass="hl-string">"{company_filter}")
    
    if not df_pay.empty:
        class=class="hl-string">"hl-comment"># Activity: Partial vs Full Payment
        class=class="hl-string">"hl-comment"># Logic requires comparing payment amount to invoice balance. simplified here based on Amount
        class=class="hl-string">"hl-comment"># Assuming we join with invoices later, strictly classifying based on available fields
        class=class="hl-string">"hl-comment"># Here we assume a field class="hl-string">'PaymentStatus' or we treat all as Partial unless marked Settled
        
        class=class="hl-string">"hl-comment"># Full Payment
        full_pay = df_pay.copy()
        full_pay[class="hl-string">'Activity'] = class="hl-string">'Full Payment Received'
        full_pay[class="hl-string">'EventTimestamp'] = full_pay[class="hl-string">'TransDate']
        all_events.append(full_pay)
        
        class=class="hl-string">"hl-comment"># Partial Payment (In a real scenario, this requires logic checking settlement vs invoice total)
        class=class="hl-string">"hl-comment"># Adding a duplicate row for demonstration of structure
        partial_pay = df_pay[df_pay[class="hl-string">'Amount'] < 1000].copy() class=class="hl-string">"hl-comment"># Placeholder logic
        partial_pay[class="hl-string">'Activity'] = class="hl-string">'Partial Payment Posted'
        partial_pay[class="hl-string">'EventTimestamp'] = partial_pay[class="hl-string">'TransDate']
        all_events.append(partial_pay)

        class=class="hl-string">"hl-comment"># Activity: Payment Written Off
        class=class="hl-string">"hl-comment"># Filter by specific Transaction Type or Journal Name
        write_off = df_pay[df_pay[class="hl-string">'JournalName'].str.contains(class="hl-string">'WriteOff', case=False, na=False)].copy()
        write_off[class="hl-string">'Activity'] = class="hl-string">'Payment Written Off'
        write_off[class="hl-string">'EventTimestamp'] = write_off[class="hl-string">'TransDate']
        all_events.append(write_off)

    class=class="hl-string">"hl-comment"># 3. COLLECTIONS (Reminders, Promise to Pay)
    class=class="hl-string">"hl-comment"># Entity: CollectionLetterJournals
    print(class="hl-string">"Processing Collections...")
    df_col = get_odata_data(token, class="hl-string">"CollectionLetterJournals", fclass="hl-string">"{company_filter}")
    if not df_col.empty:
        reminders = df_col.copy()
        reminders[class="hl-string">'Activity'] = class="hl-string">'Payment Reminder Sent'
        reminders[class="hl-string">'EventTimestamp'] = reminders[class="hl-string">'LetterDate']
        all_events.append(reminders)

    class=class="hl-string">"hl-comment"># Entity: CustomerPromiseToPay
    df_promise = get_odata_data(token, class="hl-string">"CustomerPromiseToPay", fclass="hl-string">"{company_filter}")
    if not df_promise.empty:
        promises = df_promise.copy()
        promises[class="hl-string">'Activity'] = class="hl-string">'Promise to Pay Received'
        promises[class="hl-string">'EventTimestamp'] = promises[class="hl-string">'CreatedDateTime']
        all_events.append(promises)

    class=class="hl-string">"hl-comment"># 4. DISPUTES (Opened, Review, Resolved)
    class=class="hl-string">"hl-comment"># Entity: CaseDetails (requires filtering for Collections/Dispute category)
    print(class="hl-string">"Processing Disputes...")
    df_case = get_odata_data(token, class="hl-string">"CaseDetails", fclass="hl-string">"{company_filter} and Category eq 'Collections'")
    if not df_case.empty:
        class=class="hl-string">"hl-comment"># Opened
        opened = df_case.copy()
        opened[class="hl-string">'Activity'] = class="hl-string">'Dispute Case Opened'
        opened[class="hl-string">'EventTimestamp'] = opened[class="hl-string">'CreatedDateTime']
        all_events.append(opened)

        class=class="hl-string">"hl-comment"># Under Review (In Process)
        in_process = df_case[df_case[class="hl-string">'Status'] == class="hl-string">'InProcess'].copy()
        in_process[class="hl-string">'Activity'] = class="hl-string">'Dispute Under Review'
        in_process[class="hl-string">'EventTimestamp'] = in_process[class="hl-string">'ModifiedDateTime']
        all_events.append(in_process)

        class=class="hl-string">"hl-comment"># Resolved (Closed)
        resolved = df_case[df_case[class="hl-string">'Status'] == class="hl-string">'Closed'].copy()
        resolved[class="hl-string">'Activity'] = class="hl-string">'Dispute Resolved'
        resolved[class="hl-string">'EventTimestamp'] = resolved[class="hl-string">'ClosedDateTime']
        all_events.append(resolved)

    class=class="hl-string">"hl-comment"># 5. INTEREST
    class=class="hl-string">"hl-comment"># Entity: InterestNotes
    print(class="hl-string">"Processing Interest Notes...")
    df_interest = get_odata_data(token, class="hl-string">"InterestNotes", fclass="hl-string">"{company_filter}")
    if not df_interest.empty:
        interest = df_interest.copy()
        interest[class="hl-string">'Activity'] = class="hl-string">'Interest Note Generated'
        interest[class="hl-string">'EventTimestamp'] = interest[class="hl-string">'NoteDate']
        all_events.append(interest)

    class=class="hl-string">"hl-comment"># 6. BANK RECONCILIATION
    class=class="hl-string">"hl-comment"># Entity: BankReconciliationLines (Placeholder for matching)
    print(class="hl-string">"Processing Bank Reconciliation...")
    class=class="hl-string">"hl-comment"># This entity availability varies by version
    df_bank = get_odata_data(token, class="hl-string">"BankReconciliationLines", fclass="hl-string">"{company_filter}")
    if not df_bank.empty:
        matched = df_bank[df_bank[class="hl-string">'Reconciled'] == True].copy()
        matched[class="hl-string">'Activity'] = class="hl-string">'Bank Statement Matched'
        matched[class="hl-string">'EventTimestamp'] = matched[class="hl-string">'TransactionDate']
        class=class="hl-string">"hl-comment"># Need to join with Invoice via Payment Reference ideally
        class=class="hl-string">"hl-comment"># For this script, we assume InvoiceNumber is present or mapped
        all_events.append(matched)

    class=class="hl-string">"hl-comment"># === UNIFICATION & EXPORT ===
    if not all_events:
        print(class="hl-string">"No events extracted.")
        return

    final_df = pd.concat(all_events, ignore_index=True)

    class=class="hl-string">"hl-comment"># Map columns to schema
    class=class="hl-string">"hl-comment"># Note: Column names class="hl-string">'InvoiceNumber', class="hl-string">'InvoiceAccount' etc. depend on exact Entity schema
    class=class="hl-string">"hl-comment"># You may need to rename based on your D365 entity fields, e.g., class="hl-string">'InvoiceNum' -> class="hl-string">'InvoiceNumber'
    schema_map = {
        class="hl-string">'InvoiceNumber': class="hl-string">'InvoiceNumber',
        class="hl-string">'InvoiceId': class="hl-string">'InvoiceNumber', class=class="hl-string">"hl-comment"># Alternative common name
        class="hl-string">'InvoiceAccount': class="hl-string">'CustomerAccount',
        class="hl-string">'CustomerAccount': class="hl-string">'CustomerAccount',
        class="hl-string">'InvoiceAmount': class="hl-string">'InvoiceAmount',
        class="hl-string">'Amount': class="hl-string">'InvoiceAmount', class=class="hl-string">"hl-comment"># Fallback for payments
        class="hl-string">'CurrencyCode': class="hl-string">'Currency',
        class="hl-string">'DueDate': class="hl-string">'DueDate',
        class="hl-string">'CreatedBy': class="hl-string">'User',
        class="hl-string">'BusinessUnit': class="hl-string">'BusinessUnit',
        class="hl-string">'DataAreaId': class="hl-string">'CompanyCode'
    }
    
    class=class="hl-string">"hl-comment"># Normalize columns
    for col in final_df.columns:
        if col in schema_map:
            final_df.rename(columns={col: schema_map[col]}, inplace=True)

    class=class="hl-string">"hl-comment"># Add constant fields
    final_df[class="hl-string">'SourceSystem'] = class="hl-string">'Microsoft D365'
    final_df[class="hl-string">'LastDataUpdate'] = datetime.datetime.now().isoformat()
    
    class=class="hl-string">"hl-comment"># Select final columns (fill missing with None)
    required_cols = [
        class="hl-string">'InvoiceNumber', class="hl-string">'Activity', class="hl-string">'EventTimestamp', class="hl-string">'SourceSystem', class="hl-string">'LastDataUpdate',
        class="hl-string">'CustomerAccount', class="hl-string">'CustomerGroup', class="hl-string">'InvoiceAmount', class="hl-string">'DueDate', class="hl-string">'User',
        class="hl-string">'BusinessUnit', class="hl-string">'CompanyCode', class="hl-string">'IsAutomated'
    ]
    
    for col in required_cols:
        if col not in final_df.columns:
            final_df[col] = None
            
    output_df = final_df[required_cols]
    
    class=class="hl-string">"hl-comment"># Export
    output_df.to_csv(class="hl-string">"AR_Event_Log.csv", index=False)
    print(class="hl-string">"Extraction complete. Saved to AR_Event_Log.csv")

if __name__ == class="hl-string">"__main__":
    main()

Sẵn sàng bắt đầu?

Bắt đầu cải thiện hoạt động tài chính bằng cách áp dụng mẫu dữ liệu này ngay hôm nay. Nhóm của chúng tôi sẵn sàng giúp bạn đối chiếu dữ liệu Microsoft Dynamics 365 với các yêu cầu này.

Quay lại hướng dẫn cải tiến

Tải mẫu xuống

Cải thiện khoản phải thu và tăng dòng tiền ngay hôm nay

Tham gia cùng các nhóm đang giảm DSO từ 15 đến 20 ngày trên Microsoft Dynamics 365

Bắt đầu dùng thử miễn phí

Không cần thẻ tín dụng, thiết lập trong 5 phút

Mẫu dữ liệu phải thu của bạn

Mẫu dữ liệu phải thu của bạn

Thuộc tính phải thu

Hoạt động trong quy trình phải thu

Hướng dẫn trích xuất dữ liệu

Xuất thực thể qua Data Management Framework của D365

Các bước

Cấu hình

Truy vấn mẫu sql

Trích xuất sự kiện phải thu qua Python OData API

Các bước

Cấu hình

Truy vấn mẫu python

Sẵn sàng bắt đầu?

Cải thiện khoản phải thu và tăng dòng tiền ngay hôm nay