Saltar al contenido principal
POST
/
v1
/
templates
Subir una plantilla
curl --request POST \
  --url https://reporter.sandbox.lerian.net/v1/templates \
  --header 'Content-Type: multipart/form-data' \
  --form template='@example-file' \
  --form outputFormat=TXT \
  --form 'description=Lista de titulares'
{
  "id": "0196b270-a315-7137-9408-3f16af2685e1",
  "outputFormat": "TXT",
  "description": "Lista de titulares",
  "fileName": "0196b270-a315-7137-9408-3f16af2685e1.tpl",
  "createdAt": "2025-05-09T00:27:28.405080783Z",
  "updatedAt": "2025-05-09T00:27:28.405080783Z"
}
¿Necesitas un ejemplo para probar este punto de conexión? Haz clic aquí para descargar un archivo .tpl de ejemplo.

Encabezados

​
Authorization
string

El token de autorización en formato 'Bearer '.

Importante: Este encabezado es obligatorio si su entorno tiene habilitado Access Manager. Para obtener más información, consulte la documentación de Access Manager.

​
Content-Type
string

Tipo de contenido de la solicitud. Importante: para este endpoint debe ser multipart/form-data.

​
X-Organization-id
string

The unique identifier of the Organization associated with the request.

​
X-Idempotency
string

Clave de idempotencia opcional que el cliente debe reutilizar cuando reintente exactamente la misma operación.

Si se omite, la solicitud se procesa normalmente, pero no debe asumirse deduplicación entre reintentos a menos que la API devuelva explícitamente la clave generada.

Consulte Reintentos e idempotencia para más detalles.

Cuerpo

multipart/form-data
​
template
file
requerido

Archivo .tpl que creaste como definición de la plantilla.

​
outputFormat
enum<string>
requerido

Formato del informe que generará la plantilla.

Opciones disponibles:
HTML,
CSV,
XML,
PDF,
TXT
Ejemplo:

"TXT"

​
description
string
requerido

Descripción breve de la plantilla.

Ejemplo:

"Lista de titulares"

Respuesta

Indica que la plantilla se creó correctamente.

La respuesta incluye el header X-Idempotency-Replayed.

Si el valor es false, la solicitud fue recién procesada. Si el valor es true, la respuesta es una repetición de una solicitud procesada anteriormente.

La respuesta también puede incluir warnings cuando la validación de esquema no pudo validar completamente una o más fuentes de datos referenciadas por la plantilla. La plantilla se crea de todas formas.

Consulte Reintentos e idempotencia para más detalles.

Detalles de la plantilla que se creó o actualizó.

​
id
string

ID único que identifica la plantilla (formato UUID).

​
outputFormat
string

Formato de salida generado (por ejemplo, HTML, CSV, PDF, TXT, XML).

​
description
string

Describe brevemente para qué sirve la plantilla o qué contiene.

​
fileName
string

Nombre del archivo de plantilla tal como está guardado en el sistema. Sigue el formato <template_id>.tpl.

​
createdAt
string

Marca de tiempo que indica cuándo se creó la plantilla.

​
updatedAt
string

Marca de tiempo que indica la última vez que se actualizó la plantilla.

​
warnings
object[]

Se devuelve cuando la validación de esquema no pudo validar completamente una o más fuentes de datos referenciadas por la plantilla. La operación de creación o actualización se completa de todas formas. Ausente cuando no se produjeron advertencias.