Preguntas frecuentes
Lo que se pregunta antes de integrar
Respuestas cortas, cada una con la guía que la desarrolla. Si la tuya no está, ladocumentación tiene el detalle.
Empezar
- ¿Qué es Emitay?
- Una API REST para emitir comprobantes electrónicos ante SUNAT. Envías lo que vendiste; Emitay calcula los impuestos, numera, arma el XML, lo firma, lo envía a SUNAT y te avisa del resultado. Leer la introducción
- ¿Necesito un certificado digital para probar?
- No. Con una llave de prueba los comprobantes se firman con un certificado de prueba y van al ambiente beta de SUNAT, sin valor tributario. La llave se entrega al registrar tu empresa. Seguir el inicio rápido
- ¿Qué necesito para emitir con valor tributario?
- El certificado digital de tu empresa, un usuario secundario SOL y una llave de producción. Para guías de remisión, además, las credenciales de la API de SUNAT para guías. Pasar a producción
- ¿En qué lenguaje puedo integrarlo?
- En cualquiera que haga peticiones HTTP. La documentación muestra cada petición con curl, para PowerShell y en TypeScript. Ver los ejemplos
Emitir
- ¿Qué comprobantes puedo emitir?
- Facturas, boletas de venta, notas de crédito y de débito, guías de remisión de remitente y de transportista, y comprobantes de retención y de percepción. Emitir comprobantes
- ¿Tengo que esperar a SUNAT en cada petición?
- No. La API responde de inmediato con el comprobante numerado y firmado, en estado pendiente. Si prefieres esperar el veredicto en la misma llamada, puedes pedirlo con una espera acotada de hasta 30 segundos. El veredicto de SUNAT
- ¿Qué pasa si SUNAT está caído?
- Emitay reintenta el envío por su cuenta. El comprobante queda pendiente hasta que SUNAT responde, y te enteras por un webhook o consultándolo. Estados de un comprobante
- ¿Un comprobante con errores consume un número de la serie?
- No. Un comprobante inválido se rechaza antes de numerarse, con el campo que falla y el motivo. Un comprobante ya emitido sí conserva su número aunque SUNAT lo rechace. Cómo responde la API a un error
- ¿Cómo evito emitir dos veces el mismo comprobante?
- Con una llave de idempotencia por comprobante. Si repites la petición con la misma llave, la API devuelve el comprobante que ya creó. Idempotencia
Después de emitir
- ¿Cómo me entero de la respuesta de SUNAT?
- De tres formas: con un webhook firmado que llega a tu servidor, consultando el comprobante, o esperando en la misma llamada. Recibir webhooks
- ¿Puedo usar mi propio diseño de factura?
- Sí. El PDF se diseña en un editor visual, con tu logo, y se descarga en A4 o en formato ticket de 80 o 58 mm. PDF y layouts
- ¿Emitay le envía el comprobante a mi cliente?
- Sí, por correo, con el PDF, el XML firmado y el CDR adjuntos. Puedes enviarlo a pedido o activar el envío automático cuando SUNAT acepta. Enviar por correo
- ¿Cómo anulo un comprobante?
- Con una sola llamada, hasta el sétimo día calendario posterior a su emisión y si no se entregó al cliente. Pasado el plazo, o si ya se entregó, corresponde una nota de crédito. Anular un comprobante
Seguridad y cumplimiento
- ¿Emitay es un PSE o un OSE?
- No. Cada empresa emite con su propio certificado digital y su propio usuario SOL, y los comprobantes van directamente a los servicios de SUNAT. Emitay no está inscrito como PSE ni como OSE. Qué es Emitay y qué no
- ¿Cómo se guardan mi certificado y mi clave SOL?
- Cifrados. No se escriben en registros y la API nunca los devuelve. Pasar a producción
- ¿Puedo manejar varias empresas?
- Sí. Cada empresa tiene sus credenciales y sus llaves, y sus datos están aislados de los de las demás. La llave con que llamas decide qué empresa emite. Autenticación y modos