Overview
Generate invoices, cash receipts, payslips, reports and contracts as finished PDFs from your own application with a single HTTP call.
Everything you see in the docsgen catalog —invoices, collection accounts, receipts, contracts— can also come out of another system, without anyone logging in here to fill anything in. Your application sends the data and gets the finished PDF back.
These guides explain how, what to send and what to expect. They are written for the technical team building the connection.
The service is live
Write to us and we will hand over your key; with it, your first call returns a PDF today.
POST https://docsgen.piensait.com/api/documents
That is the stable address. If we ever move the service somewhere else, you won’t notice.
First things first: there is nothing to install
You don’t copy this project into yours, install a package or keep a library up to date. What you integrate is one HTTP call: you send a JSON with the document type and its data, and the response is the PDF.
That means it doesn’t matter what your system is written in. PHP, .NET, Java, Python, Node, a no-code automation: if it can make a POST, it can generate documents.
It also means the design improves without you doing anything. When we refine a template or add a format, your documents look better on the next call; there is no version to upgrade and no deployment to coordinate.
Why we don’t hand you the code
We could give you a library to install. We deliberately don’t.
The engine that draws the documents lives in a single place. If every application took its own copy, in six months there would be half a dozen similar engines and no two alike: the same document would look different depending on who generated it, and fixing something would mean fixing it six times. It already happened to us inside this very project with the footer of nine templates, which ended up different in each one.
A single engine behind one call is what makes your invoice and ours look the same.
Which documents you can request today
| Type | What it is |
|---|---|
factura |
The graphic representation of an electronic sales invoice |
nota-credito |
The graphic representation of an electronic credit note |
nota-debito |
The graphic representation of an electronic debit note |
cuenta-de-cobro |
The document of someone who is not required to issue invoices (collection account) |
recibo-de-caja |
Incoming money, with the invoices it is applied to |
estado-de-cuenta |
What a customer owes at a cutoff date: movements, aging and balance |
colilla-de-nomina |
What was earned, what was deducted and the net pay of one person in a payroll period |
informe |
A table with the columns, rows and totals you send, portrait or landscape |
entrada-de-inventario |
What arrives at a warehouse, with its items, lots, serial numbers and signatures |
salida-de-inventario |
What leaves a warehouse and why, with the signatures of who delivers and who receives |
traslado-de-inventario |
A transfer between two warehouses, with its departure and arrival dates |
contrato |
Any template with placeholders: leases, employment contracts, minutes, letters |
The rest of the catalog —quotation, sales order, purchase order and company— is not available through this channel yet. It can be viewed and downloaded from the docsgen application, but it does not respond to a call. Those formats are queued to move to the same engine; we will tell you which ones and when before you commit to anything.
We say it this plainly because this is the kind of detail that ruins an integration when it is discovered late.
Where to go next
- Quickstart: the call, from curl and from your server, and the four steps to get started.
- Authentication: keys, and why they never go to the browser.
- Errors: what each status code means and what to do.
- What goes inside
data: amounts, fields, logo, legal notes and more. - Choosing the design: designs, POS receipts and styles.
- What the service doesn’t do, and limits.
- Document types: credit and debit notes, cash receipt, account statement, payslip, report, inventory movements and contracts.
- The API reference.
