Works PDF

Overview

Works-PDF is a service that can work between pdf-service and client requests. In works-pdf, there have multiple APIs to generate multiple PDFs. The service fetches data from multiple services, combines them, and sends the request to the PDF service to generate PDF.

It also has the functionality to generate an Excel file when payment is initiated. It listens to expense-payment-create topic and payment data.

Dependency

• MDMS

• PDF

• Project

• Estimates

• Muster Roll

• Contract

• Organization

• Localization

• Expense

• Expense calculator

• Bankaccount

• Filestore

Key Functionality

• It fetches data from multiple Create multiple PDFs like estimate, muster, project, etc.

• When a payment is created it generates excel files based on the payment bills, because listening to payment create topic.

• User can regenerate the payment excel using the same payment id.

Code

Works-PDF

Deployment

• Helm Chart

• Environment

  • Add all pdf configurations under pdf-service data config and format config

  • Add file type 'application/zip' under xlsx format in egov-filestore allowed-file-formats-map.

PDF Configs

• Estimates PDF - Data Config, Format Config

• Muster Roll PDF - Data Config, Format Config

• Project PDF - Data Config, Format Config

• Work order PDF - Data Config, Format Config

Roll Action

API EndPoints	Roles
/egov-pdf/download/estimate/estimates	ESTIMATE_CREATOR ESTIMATE_VERIFIER TECHNICAL_SANCTIONER ESTIMATE_APPROVER ESTIMATE_VIEWER
/egov-pdf/download/musterRoll/muster-roll	MUSTER_ROLL_APPROVER ORG_ADMIN MUSTER_ROLL_VERIFIER
/egov-pdf/download/project/project-details	PROJECT_VIEWER
/egov-pdf/download/workOrder/work-order	ORG_ADMIN WORK_ORDER_VIEWER WORK_ORDER_APPROVER
/egov-pdf/bill/_generate	BILL_ACCOUNTANT
/egov-pdf/bill/_search	BILL_ACCOUNTANT

Account creation for deductions

Create accounts for purchase and wage bills, for head codes where category is deduction.

E.g. this is the head code object

{
      "id": "5",
      "code": "LC",
      "category": "deduction",
      "service": "works.purchase",
      "description": "Labour Cess",
      "active": true,
      "effectiveFrom": 1682164954037,
      "effectiveTo": null
}

And tenantId is pg.citya

The format of referenceId is Deduction_{tanentId}_{headcode}

Then create a bank account with the field referenceId value Deduction_pg.citya_LC