Preguntas frecuentes
¿Qué necesita mi empresa para emitir comprobantes reales?
Sección titulada «¿Qué necesita mi empresa para emitir comprobantes reales?»Tres cosas, que se configuran una sola vez al darte de alta: el certificado digital de tu empresa, un usuario SOL secundario (nunca la clave SOL principal) y las series que vas a usar (F001, B001…). Con eso recibes tu clave sk_live_. Ver Autenticación.
¿A nombre de quién salen las facturas y boletas?
Sección titulada «¿A nombre de quién salen las facturas y boletas?»Siempre a nombre de tu empresa: llevan tu RUC, tu razón social, tu nombre comercial, tu dirección, tu logo y la firma digital de tu propio certificado. Nunca salen a nombre de Faktura.
¿Desde qué lenguaje o sistema puedo conectarme?
Sección titulada «¿Desde qué lenguaje o sistema puedo conectarme?»Desde cualquier sistema capaz de hacer peticiones HTTPS con JSON: PHP (Laravel, Symfony…), Node.js, Python, C# (.NET), Java, Go, Ruby, sistemas POS de escritorio o web, ERPs y tiendas en línea. En cada endpoint del portal tienes ejemplos listos en cURL, PHP (Laravel) y Node.js, además de las colecciones para Postman y Bruno.
¿Puedo probar sin emitir comprobantes reales?
Sección titulada «¿Puedo probar sin emitir comprobantes reales?»Sí. Con una clave sk_test_ todo va a SUNAT beta: los comprobantes se firman y se envían igual, pero no tienen valor tributario y sus números no se cruzan con los de producción. Además, el entorno de pruebas es privado por empresa: ningún otro integrador puede ver los comprobantes que emitas con tu clave sk_test_. Ver Introducción.
¿Qué cambia en mi código para pasar de pruebas a producción?
Sección titulada «¿Qué cambia en mi código para pasar de pruebas a producción?»Solo dos valores de configuración (variables de entorno): la URL base (https://faktura.cgallardo.me en lugar de https://faktura-test.cgallardo.me) y la API key (sk_live_… en lugar de sk_test_…). Los endpoints, los campos del JSON y las respuestas son idénticos.
¿Cuánto tarda SUNAT en aceptar un comprobante?
Sección titulada «¿Cuánto tarda SUNAT en aceptar un comprobante?»La API responde al instante con 201 y status: "pending", y el número ya es tuyo. El envío a SUNAT ocurre en segundo plano y suele resolverse en unos segundos. Ver Estados y envío a SUNAT.
¿Cómo sé que SUNAT lo aceptó?
Sección titulada «¿Cómo sé que SUNAT lo aceptó?»Registra un webhook y Faktura te avisa (document.accepted, document.rejected…), o consulta GET /v1/documents/{id} hasta ver un estado final.
¿Qué pasa si SUNAT está caído?
Sección titulada «¿Qué pasa si SUNAT está caído?»Faktura reintenta sola, con espera creciente, hasta obtener respuesta. Tu sistema no tiene que reenviar nada: el comprobante sigue pending con su número ya asignado.
Un comprobante quedó en failed, ¿qué hago?
Sección titulada «Un comprobante quedó en failed, ¿qué hago?»failed significa que no llegó a SUNAT por una causa ajena a su contenido, como un usuario SOL incorrecto. Corrige la causa y reenvíalo. Uno rejected no se reenvía: su contenido es inválido y corresponde emitir otro.
¿Puedo emitir una boleta sin pedir el DNI?
Sección titulada «¿Puedo emitir una boleta sin pedir el DNI?»Sí, con customer.doc_type: "NONE", si la boleta es en soles y no supera S/ 700.00. Por encima de ese monto, o en dólares, el cliente debe identificarse. Ver Emitir una boleta.
¿Puedo emitir con una fecha anterior?
Sección titulada «¿Puedo emitir con una fecha anterior?»Sí, con issue_date, hasta 3 días atrás y nunca una fecha futura: sirve para ventas registradas sin conexión. Ver el ejemplo de contingencia.
¿Cómo anulo un comprobante?
Sección titulada «¿Cómo anulo un comprobante?»Con POST /v1/documents/{id}/void si está dentro del plazo de anulación, o con una nota de crédito si ya pasó o si el cliente devuelve solo una parte. Ver cuál usar.
¿Cómo evito emitir dos veces la misma venta si se corta la conexión?
Sección titulada «¿Cómo evito emitir dos veces la misma venta si se corta la conexión?»Envía siempre la cabecera Idempotency-Key con un valor único por venta. Si repites la petición con la misma clave y el mismo cuerpo, la API devuelve el mismo comprobante en lugar de crear otro. Ver Idempotencia.
¿Los enlaces del PDF vencen?
Sección titulada «¿Los enlaces del PDF vencen?»Los enlaces públicos (links.public_pdf y links.public_ticket) se pueden compartir sin API key y vencen a los 7 días. El PDF con tu API key (GET /v1/documents/{id}/pdf) no vence.
¿La consulta de RUC consulta a SUNAT en línea?
Sección titulada «¿La consulta de RUC consulta a SUNAT en línea?»No. Consulta el padrón reducido de SUNAT actualizado diariamente en Faktura, por lo que responde en milisegundos incluso si SUNAT presenta intermitencias. as_of indica la fecha del padrón. Ver Consultar un RUC.