pdfgen - генерация PDF счета и акта из HTML шаблона с помощью PowerShell и wkhtmltopdf

How it works

Генерация и отправка ПДФ по почте выполняется помощью скрипта PowerShell. Получив из своей БД/СРМ/учетной системы данные о заказах и суммах, а также реквизиты клиентов, в виде структуры JSON, передаем данные в функцию Generate-PDF предварительно сконвертировав JSON в PowerShell PSObject. Функция Generate-PDF читает указанный при вызове шаблон и заменяет в нем параметры на значения из структуры данных и сохраняет в промежуточном HTML, который потом с помощью утилиты wkhtmltopdf конвертирует в PDF файл.

• invoice.html - шаблон счета
• act.html - шаблон акта
• generate-pdf.ps1 - скрипт с функциями:

Generate-MyCloudPDF  # генерация одного файла ПДФ
ConvertTextTo-Number # вспомогательная функция по преобразованию суммы в текстовое выражение 
Generate-MonthlyDocs # генерация и отправка по эл.почте счетов и актов для массива клиентов

Структура входного JSON или PSObject:

var json = [{
        "Id" : "",
        "EDRPOU" : "",
        "Name" : "",
        "LegalAddress" : "",
        "PostAddress" : "",
        "Phone" : "",
        "BankRequisites" : "р/р 26005052634833 в АТ КБ ПРИВАТБАНК МФО 300711",
        "ContractNumber" : "",
        "ContractDate" : "",
        "SignedName" : "ФИО",                       
        "SignedPost" : "Директор",                  
        "Represented"  :  "директора Иванова П.С.", 
        "Balance" : 0,
        "Emails" : "one@email,two@email,three@email",
        "InvoiceNumber" : "",
        
        "Order" : [{
          "Name" : "Оренда серверу.." ,    
          "Amount" : 0,                    
          "Price" : 100,                   
          "TotalPrice" : 100              
        },
        {
          ...
        }],
        
        "ActNumber" : "",

        "Accrual" : [{
          "Name" : " Оренда серверу..",     
          "Amount" : 0,                     
          "Price" : 100,                    
          "Rental" : 100,                   
          "BilledFrom" : "01.01.2020",
          "BilledTo" : "31.01.2020"
        },
        {
            ...
        }],
        
        "SellerName" : "Продавець",
        "SellerVOsobi" : "директора Продавця Ф.О.",
        "SellerEDRPOU" : "" ,
        "SellerBank" : "",
        "SellerBankAcc" : "",
        "SellerBankDep" : "",
        "SellerBankMFO" : "",
        "SellerLegalAddress" : "",
        "SellerPostAddress" : "",
        "SellerPhone" : "",
        "SellerSignedBy" : "Продавець Ф.О.",
        "SellerSignedPost" : "директор",
        "Tags" : [{
                "Name" : "метка"
        },
        {
         ...
        }]
    },
    {
       ...
    }]

# OR create PSObject directly

$x = New-Object PSObject -Property @{
        # данные клиента
        Id = $Id
        EDRPOU = $EDRPOU
        Name = $Name
        LegalAddress = $RegisteredAddress
        PostAddress = $AddressForCorrespondence
        Phone = $ContactPhoneNumber
        BankRequisites = $BankRequisites
        ContractNumber = $ContractNumber
        ContractDate = $ContractDate
        SignedName = $SignedName   # подписал  - "ФИО"
        SignedPost = $SignedPost   # должность - "Директор"
        Represented  = $Represented  # в лице "директора Иванова П.С." - для акта

        InvoiceNumber = $InvoiceNumber
        ActNumber = $ActNumber
        Balance = $Balance
        Emails = "one@email,two@email,three@email"
        
        # массив строк заказа, для счета на предоплату на текущий месяц
        Order = @(new-object PSObject -Property @{
          Name = $OrderItemName     # название позиции в заказе, Оренда серверу..
          Amount = $Amount          # кол-во
          Price = $Price            # цена за ед
          TotalPrice = $TotalPrice  # общая сумма (с учетом скидок и тп)
        },...) 
        

        # массив строк для Акта - за что начислено абонплату за предідущий период
        Accrual = @(new-object PSObject -Property @{
          Name = $OrderItemName     # название позиции в заказе, Оренда серверу..
          Amount = $Amount          # кол-во
          Price = $Price            # цена за ед
          TotalPrice = $TotalPrice  # общая сумма (с учетом скидок и тп)
        },...)
        # данные продавца
        SellerName = $SellerName
        SellerVOsobi = $SellerRepresented
        SellerEDRPOU = $SellerEDRPOU 
        SellerBank = $SellerBankRequisites
        SellerBankAcc = $SellerBankAcc
        SellerBankDep = $SellerBankDep
        SellerBankMFO = $SellerBankMFO
        SellerLegalAddress = $SellerLegalAddress
        SellerPostAddress = $SellerPostAddress
        SellerPhone = $SellerPhone
        SellerSignedBy = $SellerSignedName
        SellerSignedPost = $SellerSignedPost
        Tags = @(new-object -PSObject -Property @{
               Name = "метка" 
        },...)
    }

Setup

• установить wkhtmltopdf ( загрузка аткуальной версии отсюда https://wkhtmltopdf.org/ )
• скопировать в папку, например c:\gendoc\templates, файлы шаблона act.html invoice.html и файл скрипта generate-pdf.ps1
• изменить файл generate-pdf.ps1 - установить рабочий каталог куда складываются файлы PDF и обновить параметры подключения к SMTP серверу

Usage

1. Генерация одного документа

$json = get-your-clients-from-db-and-return-json-array
$x = ConvertFrom-Json $json -Depth 3
. .\generate-pdf.ps1
Generate-MyCloudPDF -ClientInfo $x[0] -Template templates\invoice.html -DocumentDate (Get-Date) -OutputFilename invoice.pdf

2. Массовая генерация для массива заказов клиентов и отправка по эл.почте

$json = get-your-clients-from-db-and-return-json-array
$x = ConvertFrom-Json $json -Depth 3
. .\generate-pdf.ps1
Generate-MonthlyDocs  # сгенерить и отправить на почту