---
title: "Vista previa factura de venta"
method: POST
path: "/invoices/preview"
tags: ["Facturas de venta"]
---

# Vista previa factura de venta

`POST /invoices/preview`

Endpoint que permite generar la url para consultar el pdf de la vista previa de la creación de la factura de venta.

## Request body

- object
  - `date` string, required — Fecha de la factura. Formato yyyy-MM-dd.
  - `dueDate` string, required — Fecha de vencimiento de la factura. Formato yyyy-MM-dd.
  - `anotation` string — Notas de la factura, visibles en el PDF o documento impreso. Longitud máxima permitida: 500.
  - `termsConditions` string — Términos y condiciones de la factura. Longitud máxima permitida: 500.
  - `client` object, required — Objecto que contiene el id del cliente asociado a la factura. Se puede enviar directamente el id del cliente en este atributo.
  - `numberTemplate` object — Objeto que contiene la información de la numeración de la factura. Para numeraciones automáticas solo debe incluir el id de la numeración, para numeraciones manuales se debe enviar como mínimo el id de la numeración y el número de la factura. Si no se envía este atributo la aplicación intenta crear la factura con la numeración preferida que tiene configurada la empresa. Si no es posible retorna error. Para la creación de tickets de venta (México) es necesario enviar la numeración de tipo Ticket de venta. Para la creación de Documento equivalente P.O.S. (Colombia) es necesario enviar la numeración de tipo Documento equivalente POS.
    - `id` string — ID de la numeración
    - `prefix` string — Prefijo de la factura (enviar en caso de que la numeración sea manual, opcional)
    - `number` string — Número de la factura (enviar en caso de que la numeración sea manual, requerido)
  - `items` object[], required — Array de objetos item (productos/servicios) asociados a la factura. Cada objeto debe incluir: id (number, obligatorio): identificador del producto o servicio que se vende; price (double, obligatorio): precio de venta; reference (string) : referencia del producto/servicio; description (string): descripción del producto/servicio; tax (objeto) : array de objetos tax que indican la información del impuesto; quantity (obligatorio): cantidad vendida del producto o servicio; discount (decimal): porcentaje de descuento aplicado al producto, éste no debe incluir el símbolo %, únicamente su tasa Para costa rica, el atributo discount pasa a ser un objeto compuesto por los atributos: nature (indica la naturaleza del descuento) y discount (indica la tasa del descuento). El precio del producto/servicio no debe incluir impuestos ni descuentos; importRequest (string) : Solo para Mexico se puede enviar el número de pedimento si el item lo tiene activo, este debe contener 21 caracteres y debe seguir el formato: 99 99 9999 9999999. Utilizando 2 espacios para separar cada conjunto de caracteres.
    - `id` string — Identificador del producto
    - `name` string — Nombre del producto
    - `discount` number — Porcentaje de descuento aplicado al producto
    - `observations` string — Observaciones acerca del producto
    - `tax` object[] — Array de objetos tax que indican los impuestos aplicados al producto al momento de la compra
      - `id` string — Identificador único que representa un impuesto específico.
    - `price` number — Precio de compra del producto
    - `quantity` number — Cantidad de productos que fueron comprados.
  - `currency` object — Objecto que incluye la información de la moneda y tasa de cambio asociada a la factura. Solo se debe incluir si la compañía tiene activa la funcionalidad de multimoneda y tiene configurada la moneda seleccionada. Debe incluir el código de la moneda (de tres letras según ISO) y la tasa de cambio.

## Response `200`

200 OK

## Other responses

- `400` — Bad request

---

[API](https://skmtc.net/alegra/apis/ingresos.md) · [All operations](https://skmtc.net/alegra/apis/ingresos/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/alegra/ingresos/revisions/cd52d3f68f1b/schema)