Headless de verdad
No es un plugin ni un webhook de salida. Todo lo que hace la aplicación pasa por la misma API REST: si la interfaz puede hacerlo, tu código también.
Para desarrolladores
Una API que hace todo lo que hace el producto
Integra ventas, comprobantes SUNAT, stock y compras con lo que ya usas, o construye encima. Está en todos los planes, incluido el gratuito, y no hay una capa de integración que mantener.
GET /api/v1/items
curl https://api.sales.nietux.com/api/v1/items \
-H "Authorization: Bearer ntx_..."Por qué es distinta
Abierta por diseño, no como concesión
En el mercado peruano la API suele ser un extra del plan más caro. Acá es la misma superficie con la que está construido el producto, y viene desde el plan gratuito.
API keys revocables
Cifradas y show-once: se muestran una sola vez al crearlas. Se revocan desde el panel sin tocar el resto de tus integraciones.
Rate limit por key
100 peticiones por minuto por credencial. Alcanza para sincronizar catálogo y emitir en lote, y frena un bucle tuyo antes de que se lleve puesta tu propia cuenta.
Aislamiento por empresa
Toda consulta filtra por la empresa activa de quien llama. No hay forma de leer datos de otro comercio, ni por accidente.
OpenAPI navegable
Referencia navegable en /api/docs y la especificación cruda en /api/openapi.json, generadas del código - no un documento que quedó viejo hace tres releases.
Un solo modelo de datos
La API escribe el mismo stock que descuenta el punto de venta y el mismo catálogo que publica la tienda. No hay copias que sincronizar.
Una venta completa
Registrar una venta es un POST
Los impuestos, la serie y el correlativo se resuelven del lado del servidor según la configuración de cada producto: tu código no calcula IGV ni decide detracciones.
Ventas y comprobantes
Cotizaciones, notas de venta, boletas y facturas, con su serie, su correlativo y su estado fiscal.
Catálogo e inventario
Productos con variantes, precios, impuestos por producto, stock por establecimiento y movimientos de kardex.
Clientes y contactos
Contactos con validación de RUC y DNI, direcciones y su historial de compras.
POST /api/v1/sales
{
"documentType": "BOLETA",
"establishmentId": "0199c8f0-...",
"paymentCondition": "CONTADO",
"customer": { "docType": "1", "docNumber": "70123456" },
"lines": [
{ "presentationId": "0199c8f2-...", "quantity": 2 }
]
}Preguntas frecuentes
Sobre la API
¿La API está incluida en el plan gratuito?
Sí. No es un complemento del plan más caro: la API está en todos los planes, incluido el gratuito. Puedes construir e integrar sin pagar nada.
¿Cómo autentico mis llamadas?
Con una API key con prefijo ntx_, en el header Authorization como Bearer token o en X-API-Key. La misma API acepta el JWT de la aplicación web: la autenticación es una sola.
¿Puedo construir mi propia tienda contra la API?
Para eso está. Puedes empezar con la plantilla en tu subdominio y reemplazarla después por un frontend propio sin migrar datos: ambos leen el mismo catálogo y el mismo stock.
¿Hay ambiente de pruebas?
Sí. Un usuario puede pertenecer a varias empresas, así que puedes crear una aparte con el plan gratuito y usarla como entorno de integración, con sus propias API keys y sin tocar tus datos reales.
¿Hay límites de uso?
Cada API key acepta hasta 100 peticiones por minuto. Lo que registres por API no va por una vía aparte: son las mismas ventas, el mismo stock y las mismas series que la interfaz.
¿La API ya envía los comprobantes a SUNAT?
Sí. POST /sales registra la venta con su serie y su correlativo, y POST /sales/{id}/emit la envía a SUNAT y devuelve el estado fiscal. Requiere que la conexión con SUNAT esté hecha, que la gestionamos nosotros con tu Clave SOL.
Empieza hoy con el plan gratuito
Creas la cuenta con tu RUC en dos minutos, cargas tus productos y esa misma tarde estás cobrando en el local y con tu tienda publicada. Sin tarjeta.
- Sin tarjeta
- Sin vencimiento
- Vendes desde el primer día