- VTEX no emite comprobantes ante SUNAT. La boleta o factura sale de otro sistema, y su número se registra en el pedido.
- Emite cuando se aprueba el pago. Registra la factura en el pedido cuando entra a «Preparando envío»: VTEX lo pasa a Facturado.
- Lo registrado tiene que sumar exactamente el valor del pedido, con el envío. Si no, el pedido no avanza.
- Si el comprador compró como empresa, va factura a su RUC; si no, boleta a su DNI.
- Un pedido cancelado con boleta ya entregada se corrige con nota de crédito. Un pedido Facturado ya no se cancela en VTEX: las devoluciones van con nota de crédito por devolución.
VTEX no emite el comprobante
VTEX lleva el pedido desde el pago hasta el despacho, pero no tiene facturación electrónica peruana. En su flujo, el comprobante es algo que llega de afuera: tu ERP, tu sistema de facturación o una persona que lo escribe a mano. La propia ayuda de VTEX lo explica así: en la etapa de preparación hay que agregar la factura a la plataforma para que el pedido pase a la siguiente.
Por eso, en una tienda VTEX del Perú, facturar es en realidad dos trabajos: emitir el comprobante ante SUNAT y registrarlo en el pedido de VTEX.
Los estados del pedido y qué hacer en cada uno
Estos son los estados de VTEX que importan para facturar, con el nombre que usa su API:
| Estado en VTEX | Qué significa | Qué haces con SUNAT |
|---|---|---|
Pago aprobado payment-approved | El pago se confirmó | Emites la boleta o factura |
Listo para preparación ready-for-handling | Hay que empezar a preparar el pedido | Si no emitiste antes (por ejemplo, un pago manual), emites ahora |
Preparando envío handling | Los productos están reservados hasta que llegue la factura | Registras el comprobante en el pedido |
Facturado invoiced | El pedido se cerró y pasó al transportista | Nada: ya está |
Cancelado canceled | El pedido no se completó | Si ya habías emitido, nota de crédito o baja |
El pedido se queda en «Preparando envío» hasta que alguien registra la factura. La ayuda de VTEX tiene un artículo entero para los pedidos que «no avanzan» de ese estado: casi siempre es porque nadie les cargó el comprobante.
¿Boleta o factura?
La regla de SUNAT es la de siempre: factura a quien tiene RUC y compra para su negocio, boleta al consumidor final. Lo que cambia en VTEX es dónde está el dato:
- Si tu checkout permite comprar como empresa, el pedido trae los datos corporativos: el RUC y la razón social. Con eso va factura.
- Si compró como persona, el pedido trae su documento: va boleta a su DNI. Por encima de S/ 700, la boleta tiene que llevar el nombre y el DNI del cliente.
Una tienda de equipos de oficina en VTEX recibe dos pedidos el mismo día: una silla de S/ 459 de una persona y diez sillas de S/ 4,590 de una consultora que marcó «comprar como empresa». A la persona le va boleta con su DNI; a la consultora, factura con su RUC, para que pueda usar el IGV.
Si no tienes activada la compra como empresa en tu checkout, las empresas no tienen dónde dejar su RUC y terminan recibiendo boleta. Eso se corrige con una nota de crédito y una factura nueva: mejor activarlo antes. Más detalle en la guía de factura electrónica.
Los plazos de SUNAT
| Comprobante | Plazo para que llegue a SUNAT |
|---|---|
| Factura | El día de emisión o hasta 3 días calendario después |
| Boleta | En el resumen diario, hasta 7 días calendario después |
Los días son calendario: el fin de semana cuenta. En una tienda online, donde los pedidos entran también el sábado y el domingo, emitir al aprobarse el pago es la forma más simple de no pasarse. Las reglas completas están en las guías de factura y de boleta electrónica.
Cómo pasar el pedido a Facturado
Con el comprobante emitido, se registra en el pedido de VTEX mientras está en «Preparando envío». Se puede hacer a mano en el Admin, en el detalle del pedido, o por la API de VTEX que usan los ERP. En los dos casos van los mismos datos:
| Dato | Qué poner |
|---|---|
| Número | El de tu boleta o factura, por ejemplo B001-00004471 |
| Valor | El total del pedido, con el envío incluido |
| Fecha de emisión | La del comprobante |
| Enlace (opcional) | Una dirección donde el comprador pueda ver o verificar su comprobante |
VTEX es estricto: la suma de las facturas tiene que ser igual al valor total del pedido. Si registras menos, el pedido no pasa a Facturado y puede volver a «Pago aprobado» esperando el resto. Cada factura, además, tiene que tener un número único.
Las 3 formas de hacerlo
| Forma | Cómo funciona | Le conviene a… |
|---|---|---|
| A mano | Emites en el portal de SUNAT o en otro sistema, y copias número, valor y fecha en cada pedido de VTEX | Quien recibe pocos pedidos a la semana |
| Tu ERP | El ERP emite ante SUNAT con un proveedor autorizado y registra la factura en VTEX por API | Quien ya tiene un ERP integrado a VTEX |
| Un conector de facturación | Escucha los estados del pedido, emite al aprobarse el pago y registra la factura en «Preparando envío» | Quien vende todos los días y no tiene ERP integrado |
A mano funciona mientras los pedidos son pocos. El problema aparece en campaña: el fin de semana se acumulan pedidos en «Preparando envío» y facturas con el plazo corriendo.
Cancelaciones y devoluciones
Aquí VTEX y SUNAT van por caminos distintos, y conviene tenerlo claro:
- Pedido cancelado antes de Facturado, con el comprobante ya emitido. En SUNAT el comprobante sigue vivo. Si el cliente ya lo recibió (en una tienda online, casi siempre por correo), va una nota de crédito por anulación de la operación. Si todavía no lo recibió y no pasaron 7 días calendario, también se puede dar de baja.
- Pedido Facturado. VTEX ya no deja cancelarlo: según su ayuda, los pedidos solo se cancelan antes de estar facturados. Si el cliente devuelve productos, la devolución se registra aparte y en SUNAT va una nota de crédito por devolución, total o por los ítems devueltos.
La tienda de oficina emite la boleta B001-00004480 al aprobarse el pago de una silla, y el cliente la recibe por correo. Una hora después, el cliente cancela. Como ya tiene la boleta, la tienda emite la nota de crédito BC01-00000031 por anulación de la operación. El Registro de Ventas del mes queda en cero para esa venta.
Los motivos de la nota de crédito y cuándo usar baja están en la guía cómo anular una boleta o factura electrónica.
Errores comunes (y cómo evitarlos)
- Registrar el valor sin el envío. La factura en VTEX tiene que sumar el total del pedido, envío incluido.
- Esperar a «Preparando envío» para emitir. Si el pedido tarda en prepararse, la factura puede pasarse de los 3 días. Emite al aprobarse el pago y registra después.
- No tener la compra como empresa en el checkout. Las empresas reciben boleta y hay que corregirlo con nota de crédito y factura nueva.
- Cancelar en VTEX y olvidarse de SUNAT. El comprobante sigue contando como venta hasta que emites la nota de crédito.
- Repetir el número del comprobante en dos pedidos. Cada pedido lleva su propio comprobante; VTEX pide números únicos.
Preguntas frecuentes
¿VTEX emite boletas o facturas electrónicas SUNAT?
No. VTEX gestiona el pedido, el pago y el despacho, pero no emite comprobantes ante SUNAT. La boleta o factura se emite en otro sistema y su número se registra en el pedido de VTEX.
¿Por qué mi pedido VTEX no pasa a Facturado?
Porque falta registrar la factura en el pedido mientras está en «Preparando envío», o porque lo registrado no suma el valor total del pedido. VTEX exige que las facturas sumen exactamente lo que vale el pedido.
¿Cuándo debo emitir la boleta de un pedido VTEX?
Lo más seguro es emitirla cuando se aprueba el pago, que es cuando la venta queda firme. La factura tiene que llegar a SUNAT dentro de los 3 días calendario siguientes, y las boletas se informan en el resumen diario hasta 7 días calendario después.
¿Cómo sé si el cliente de VTEX quiere factura?
Si tu checkout permite comprar como empresa, el pedido trae los datos corporativos: RUC y razón social. Con esos datos va factura; si compró como persona, boleta a su DNI.
¿Qué hago si cancelan un pedido VTEX que ya tenía boleta?
Si el cliente ya recibió la boleta, se corrige con una nota de crédito por anulación de la operación que apunta a esa boleta. Si todavía no la recibió y estás dentro de los 7 días, también se puede dar de baja.
¿Se puede cancelar un pedido VTEX que ya está Facturado?
No. VTEX solo deja cancelar pedidos antes de Facturado. Si el cliente devuelve productos de un pedido facturado, la devolución se registra aparte y en SUNAT va una nota de crédito por devolución.
Esta guía es un resumen informativo, no asesoría tributaria. BillerPro es un sistema privado: no es SUNAT ni VTEX. Las reglas de SUNAT y el flujo de pedidos de VTEX se verificaron en fuentes oficiales el 23 de octubre de 2026.
¿Quieres que esto pase solo?
BillerPro se conecta a tu tienda VTEX con una clave y un hook: emite la boleta o factura al aprobarse el pago, la registra en el pedido cuando entra a «Preparando envío» y, si el pedido se cancela, emite la nota de crédito. Desde S/ 149 al mes, con el certificado digital incluido.
Fuentes oficiales
- VTEX · Order flow and status (flujo y estados del pedido)
- VTEX · El pedido no avanza después de «Preparando envío»
- VTEX · Orders API (Order invoice notification)
- Reglamento de Comprobantes de Pago (RS 007-99/SUNAT) · artículo 4
- Resolución de Superintendencia N.° 000003-2023/SUNAT (envío de la factura en 3 días calendario)
- SUNAT · Consulta de validez del comprobante de pago electrónico