docsgen by Piensa IT

Work permit

The authorization for a high-risk task: risk class, validity window, verified controls and signatures.

permiso-de-trabajo, with the premium design: the paper that authorizes starting a risky task and is filed afterwards.

"permit": {
  "number": "PT-2026-0091", "date": "2026-10-14",                 // required
  "claseDeRiesgo": "Trabajo en alturas",                          // required
  "lugar": "Cubierta del bloque 3, nivel 12",
  "descripcion": "Reemplazo de dos luminarias perimetrales…",
  "vigencia": { "inicio": "2026-10-14 07:30", "fin": "2026-10-14 17:00" },  // required
  "controls": [
    { "descripcion": "Línea de vida certificada", "estado": "Cumple" },
    { "descripcion": "Barandas perimetrales en buen estado", "estado": "No cumple",
      "observacion": "Tramo norte con dos tornillos faltantes…" }
  ],
  "personal": [
    { "descripcion": "Jhon Fredy Arbeláez", "documento": "CC 71.555.222",
      "certificacion": "Avanzado · vence 2027-04" }
  ]
},
"signatures": [ /* at least one, with its stamp */ ]              // required
  • The validity window is printed, never judged. The document never says «vigente» (“valid”) or «vencido» (“expired”): that would depend on when the paper is read, and a filed permit is always read later. The times are printed as they arrive.
  • A control that is not met stands out in bold capitals, not by color alone: these papers are printed in black and white and photocopied. «Cumple», «No aplica» and «No requiere» are treated as neutral and are not highlighted — a highlighted “not applicable” would read as a problem where there is none.
  • estado is free text: whoever verified the control decides whether it was met, not the engine.
  • Without controls it says «Sin controles verificados» (“No controls verified”) instead of leaving an empty table: an auditor needs to tell “there was nothing to verify” from “someone forgot to write it down”.
  • Signatures are the ones described in the work order: optional stroke and a timestamp that arrives as data.
  • Required: permit.number, permit.date, permit.claseDeRiesgo, both ends of permit.vigencia and at least one signature: without the risk class you don’t know which controls were due, without the window you don’t know when it was good for, and without a signature nobody authorized anything.
  • It also comes on half-letter with "plantilla": "media-carta": the same permit on small paper, with columns scaled to it.
  • And in four more palettes —corporativa (blue), profesional (green), minimalista (violet) and basica (orange)—: the same sheet with a different accent on the title, the table headers and the bands. The default design is still premium, in grey, and the other paper sizes come in it.
  • It also accepts notes, fields and sideNotes.

Example: permiso-de-trabajo.json.