@ireceipt.pro/js NPM

@ireceipt-pro/js

Create PDF files or images from your HTML template.

GitHub last commit GitHub release

Examples

More information and examples are available on https://dashboard.ireceipt.pro

Get Started

For the library to work, you will need an API key, which you can get at https://dashboard.ireceipt.pro. You can also find public template IDs there or create your own.

import { IReceiptPRO } from '@ireceipt.pro/js';

const irp = new IReceiptPRO(process.env.IRETAILPRO_API_KEY);

irp.createJpgFromPublicTemplate("invoice_universal_vzrt6k1s", {
  "invoice": {
    "number": "13",
    "date": "2023-10-03",
    "table": {
      "headers": [
        "NAME",
        "PRICE",
        "QTY",
        "AMOUNT"
      ],
      "rows": [
        {
          "values": [
            "Gorgeous Fresh Car",
            "$100.99",
            "6",
            "$605.94"
          ]
        },
        {
          "values": [
            "Incredible Rubber Bike",
            "$356.00",
            "1",
            "$356.00"
          ]
        },
        {
          "values": [
            "UX Services",
            "$100.00",
            "2",
            "$200.00"
          ]
        },
        {
          "values": [
            "Development Service",
            "$2000.00",
            "1",
            "$2000.00"
          ]
        }
      ]
    },
    "total": "$3161.94",
    "terms": [
      "Payment is due within 5 days",
      "Payment method CARD",
      "Card Details:",
      "Card Number: 4242-4242-4242-4242",
      "Sergey Dudko"
    ]
  },
  "from": {
    "companyName": "IReceipt PRO",
    "lines": [
      "Identification Number: 55891434",
      "911 Reece Freeway",
      "32390 Kraig Station",
      "East Rhea",
      "IR",
      "support@ireceipt.pro"
    ]
  },
  "to": {
    "companyName": "Morissette - Bogisich",
    "lines": [
      "969 Harber Expressway",
      "South Aishaton",
      "GB"
    ]
  },
  "localization": {
    "invoice": "INVOICE",
    "bill_to": "BILL TO",
    "date": "DATE",
    "total": "Total",
    "terms_and_conditions": "TERMS & CONDITIONS"
  }
}, {
  "width": 796,
  "height": 1126
})

Use

Available methods for generating PDF files and JPG, PNG, WEBP images from public or your personal templates:

method	description
`createJpgFromPublicTemplate`	Create JPG Image from public template
`createPdfFromPublicTemplate`	Create PDF File from public template
`createPngFromPublicTemplate`	Create PNG Image from public template
`createWebpFromPublicTemplate`	Create WEBP Image from public template
`createJpgFromPrivateTemplate`	Create JPG Image from private template
`createPdfFromPrivateTemplate`	Create PDF File from private template
`createPngFromPrivateTemplate`	Create PNG Image from private template
`createWebpFromPrivateTemplate`	Create WEBP Image from private template

All methods have the same arguments, for example:

const buffer: Buffer | ArrayBuffer = await createJpgFromPublicTemplate(templateId, args, size);

argument	description	required	example
`templateId`	template id, you can find it on https://dashboard.ireceipt.pro	true	`gift_card_template_1`
`args`	arguments for substitution in the template	true	`{"amount": "$25","name": "Gift Card","code": "#1234567890","color": "#ebfdff"}`
`size`	the size of the file being created	false	`{"width": 796,"height": 1126}`