---
title: "Obtener una plantilla"
method: GET
path: "/documents/templates/{templateId}"
tags: ["Plantillas"]
---

# Obtener una plantilla

`GET /documents/templates/{templateId}`

## Request

- Base URL: `https://www.facture.ar/api`
- URL: `https://www.facture.ar/api/documents/templates/{templateId}`
- Auth: API key in header `x-api-key`

## Path parameters

- `templateId` string, required

## Response `200`

Plantilla

- object
  - `template` Template
    - `id` string
    - `userId` string
    - `name` string
    - `cuitId` string, nullable: CUIT emisor. Obligatorio en modo automático y en las recurrentes
    - `ptoVta` integer, nullable
    - `mode` 'manual' | 'automatic'
    - `concepto` 1 | 2 | 3
    - `ivaRate` 0 | 2.5 | 5 | 10.5 | 21 | 27
    - `pricesIncludeIva` boolean
    - `receiverDocType` 'CUIT' | 'CUIL' | 'DNI' | 'null', nullable: Cliente fijo: todas las facturas de la plantilla van a él
    - `receiverDocNumber` string, nullable
    - `receiverName` string, nullable
    - `receiverCondicionIva` integer, nullable
    - `receiverEmail` string, email, nullable
    - `items` object[], nullable: Líneas fijas, para las facturas recurrentes
      - `description` string, required
      - `quantity` number, required
      - `unitPrice` number, required
    - `priceList` object[], nullable: Precios para documentos que no los traen (remitos)
      - `description` string, required
      - `unitPrice` number, required
    - `instructions` string, nullable: Lo que la IA tiene que saber para leer este tipo de documento
    - `columnMapping` object, nullable: Columnas de la planilla → campos de la factura
      - `headerRow` integer
      - `columns` object: Campo → nombre de la columna. Campos: receiverName, receiverDoc, receiverEmail, receiverCondicionIva, receiverAddress, description, quantity, unitPrice, lineTotal, ivaRate, reference, date, concepto
      - `groupBy` string, nullable
      - `pricesIncludeIva` boolean
    - `paymentTermDays` integer, nullable
    - `sendEmail` boolean: Mandarle la factura al cliente por email
    - `emailCopyTo` string, email, nullable
    - `recurrence` 'monthly' | 'null', nullable: monthly: emite las líneas fijas todos los meses en dayOfMonth
    - `dayOfMonth` integer, nullable
    - `active` boolean
    - `nextRunAt` string, date-time, nullable
    - `lastRunAt` string, date-time, nullable
    - `createdAt` string, date-time
    - `updatedAt` string, date-time

## Other responses

- `404`: La plantilla no existe

---

[API](https://skmtc.dev/facture/apis/facturear-api.md) · [All operations](https://skmtc.dev/facture/apis/facturear-api/llms.txt) · [OpenAPI document](https://skmtc.dev/facture/apis/facturear-api/revisions/b572c5908978?raw)