On this page

What the service doesn't do, and limits

docsgen doesn't calculate, number, generate CUFE or store documents, and today it serves one document per call.

What the service doesn’t do, and won’t do

It doesn’t calculate. Amounts arrive prepared by you and are drawn here: it doesn’t add, doesn’t apply VAT, doesn’t derive any figure. If you send a total that doesn’t add up with the lines, it is printed exactly as it arrived.

It may look like a limitation, and it is a guarantee. A generator that “corrects” the figures of whoever calls it ends up being responsible for a wrong figure on a signed document, and that responsibility must stay where the data lives: in your system.

It doesn’t generate CUFE or CUDE, authorized numbering, or build the QR content. That is produced by the technology provider authorized by the DIAN; here it arrives as data and is drawn. When it is missing, the document says so —«Sin CUFE» (“No CUFE”), «Sin resolución» (“No resolution”)— instead of filling the gap with something that looks right.

It doesn’t assign sequential numbers. You bring the number. Numbering would mean being the source of truth for your company’s legal numbering, and we don’t want that role.

It doesn’t store the document. It is composed, delivered and forgotten.

Today’s limits

  • One document per call. A direct response is enough for that. Batch generation —the three hundred payslips of the month— needs a different mechanism, with background processing and a download link. It is planned; if you need it, say so when you start.
  • Twelve document types, the ones in the table on the home page.
  • The first call after a while without use takes a few seconds. The service goes to sleep when nobody calls it and starts up on its own; from then on it responds in milliseconds. If your process has a short timeout, account for that first start-up.