> ## Documentation Index > Fetch the complete documentation index at: https://developers.tiendadepuntos.com/llms.txt > Use this file to discover all available pages before exploring further. # Crear un ítem de puntos > Crea un ítem en el catálogo del comercio. Mandá `points` (puntos fijos) **o** `amount` (equivalencia en pesos, que se convierte con la regla del comercio). Si mandás los dos, se ignora `amount`. Si no mandás ninguno, la API responde 400. El ítem se crea disponible en todas las sucursales. Guardá el `id` de la respuesta: es con lo que después identificás el ítem. ## OpenAPI ````yaml /api-reference/openapi.json post /external/point-items openapi: 3.0.0 info: title: API de Tienda de Puntos description: >- API pública de Tienda de Puntos. Permite sumar puntos por compra, consultar clientes, validar canjes y consumir cupones desde tu POS, ERP o e-commerce. Todas las llamadas se autentican con el header `x-api-key`. version: 0.0.1 contact: {} servers: - url: https://api.tiendadepuntos.com description: Producción - url: https://apidev.tiendadepuntos.com description: QA security: - ApiKeyAuth: [] tags: [] paths: /external/point-items: post: tags: - Ítems de puntos summary: Crear un ítem de puntos description: >- Crea un ítem en el catálogo del comercio. Mandá `points` (puntos fijos) **o** `amount` (equivalencia en pesos, que se convierte con la regla del comercio). Si mandás los dos, se ignora `amount`. Si no mandás ninguno, la API responde 400. El ítem se crea disponible en todas las sucursales. Guardá el `id` de la respuesta: es con lo que después identificás el ítem. operationId: ExternalPointItemController_create parameters: [] requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/CreateExternalPointItemDto' responses: '201': description: Ítem creado. content: application/json: schema: type: object properties: success: type: boolean example: true status: type: integer example: 201 message: type: string example: Request was successful data: $ref: '#/components/schemas/ExternalPointItemOutputDto' required: - success - status - message '400': description: El cuerpo o los parámetros no pasaron la validación. content: application/json: schema: type: object properties: statusCode: type: integer example: 400 timestamp: type: string format: date-time example: '2026-07-31T14:05:12.431Z' path: type: string example: /external/tags/add method: type: string example: POST message: type: string example: Error de validación errors: type: array nullable: true items: type: object data: type: object nullable: true '401': description: >- Falta el header `x-api-key` (`Api Key is required`), o está presente pero no corresponde a ningún comercio (`Api key is invalid`). content: application/json: schema: type: object properties: statusCode: type: integer example: 401 timestamp: type: string format: date-time example: '2026-07-31T14:05:12.431Z' path: type: string example: /external/tags/add method: type: string example: POST message: type: string example: Api key is invalid errors: type: array nullable: true items: type: object data: type: object nullable: true '404': description: La key es válida y el recurso pedido no existe. content: application/json: schema: type: object properties: statusCode: type: integer example: 404 timestamp: type: string format: date-time example: '2026-07-31T14:05:12.431Z' path: type: string example: /external/tags/add method: type: string example: POST message: type: string example: Client not found errors: type: array nullable: true items: type: object data: type: object nullable: true security: - ApiKeyAuth: [] components: schemas: CreateExternalPointItemDto: type: object properties: name: type: string description: Nombre del ítem, tal como lo va a ver el cajero en Suma directa. example: Café latte maxLength: 255 points: type: number description: >- Puntos fijos que otorga el ítem, sin importar su precio. Mandá `points` **o** `amount`: si mandás los dos, se ignora `amount`. example: 50 amount: type: number description: >- Equivalencia en pesos del ítem. Tienda de Puntos la convierte a puntos con la regla de conversión del comercio, igual que una compra por ese monto. example: 3500 required: - name ExternalPointItemOutputDto: type: object properties: id: type: number description: >- ID del ítem en Tienda de Puntos. Es el identificador que tenés que guardar de tu lado para después pedir la simulación de puntos. example: 87 name: type: string description: Nombre del ítem. example: Café latte points: type: number description: >- Puntos fijos que otorga. Viaja en `null` si el ítem se definió por monto. example: 50 nullable: true amount: type: number description: >- Equivalencia en pesos. Viaja en `null` si el ítem se definió por puntos. example: 3500 nullable: true branchId: type: number description: >- Sucursal a la que está limitado el ítem. Los ítems creados por esta API son globales del comercio y viajan en `null`. example: 1972 nullable: true createdAt: format: date-time type: string description: Fecha de alta. example: '2026-09-21T14:32:11.000Z' updatedAt: format: date-time type: string description: Fecha de la última modificación. example: '2026-09-21T14:32:11.000Z' required: - id - name - points - amount - branchId - createdAt - updatedAt securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key description: >- API key del comercio. Se genera desde el panel de Tienda de Puntos, en Configuración → Integraciones. ````