FAQ's sobre la API de Factura Electrónica – Preguntas frecuentes

08 minutos de lectura.

Una API es una interfaz de programación de aplicaciones. Actúa como mediador entre dos aplicaciones diferentes y les ayuda a interactuar entre sí. En el sistema de factura electrónica, un contribuyente genera una factura electrónica en su respectivo software y reporta estas facturas en el Portal de Registro de Facturas (IRP). El IRP procesará la factura electrónica a través de la API. Estas son algunas de las preguntas frecuentes de la API de la factura electrónica.

Última actualización

30 de junio de 2021
El CBIC ha emitido una notificación en la que se solicita la exención de la sanción impuesta por el incumplimiento de las disposiciones relativas al código QR dinámico para las facturas B2C entre el 1 de diciembre de 2020 y el 30 de septiembre de 2021.

1 de junio de 2021
El CBIC ha notificado mediante la Notificación del Impuesto Central no.23 del 1 de junio de 2021 que el sistema de facturación electrónica no se aplicará a un departamento gubernamental y a una autoridad local.

30 de marzo de 2021

El CBIC ha emitido una notificación que pretende eximir de la sanción impuesta por el incumplimiento de las disposiciones del código QR dinámico para las facturas B2C entre el 1 de diciembre de 2020 y el 30 de junio de 2021, siempre que dicha persona cumpla con las disposiciones de dicha notificación a partir del 1 de julio de 2021.

Preguntas frecuentes

¿Dónde puede un contribuyente o un PSG obtener credenciales para acceder a las API y cómo??

Un contribuyente o proveedor de servicios de pago puede obtener sus credenciales en https://einv-apisandbox.nic.in/ portal. Deben registrarse en el portal utilizando la pestaña de inicio de sesión.

¿Dónde puede un contribuyente/SGP obtener la URL o los puntos finales de las API??

Un contribuyente/PSG debe iniciar sesión en el portal de pruebas para obtener los puntos finales de las API para el sistema sandbox.

La empresa X tiene unidades de negocio en diferentes estados con diferentes GSTIN bajo el mismo PAN. ¿Pueden utilizarse las mismas credenciales de la API para acceder a diferentes lugares??

Existen dos tipos de credenciales para iniciar sesión en el sistema de factura electrónica: i. ID del cliente y secreto del cliente: Se proporciona al contribuyente notificado y puede utilizarse para todas las unidades de negocio registradas en diferentes estados bajo el mismo PAN. ii. Nombre de usuario y contraseña: deben crearse por separado para cada GSTIN.

Para quiénes están disponibles las API de factura electrónica para el acceso?

Las API de factura electrónica están disponibles para:

  • Contribuyentes registrados con una facturación superior a Rs.500 millones de euros
  • Los PSG registrados
¿Quién puede generar el IRN en el sistema de facturación electrónica??

La facturación electrónica se ha notificado actualmente para los contribuyentes registrados con un volumen de negocios superior a Rs.500 millones de euros en el año fiscal 19-20, con excepciones como las unidades de las Zonas Económicas Especiales (SEZ), los seguros, la banca, las instituciones financieras, las NBFC, las GTA, el servicio de transporte de pasajeros y la venta de entradas de cine. Sólo estos contribuyentes notificados tendrán que generar el IRN para sus suministros/ventas.

¿Dónde se puede encontrar la clave pública del sistema de factura electrónica??

Se puede obtener la clave pública del sistema de factura electrónica accediendo al portal de pruebas.

¿Puede un contribuyente generar facturas electrónicas utilizando el IRN?? ¿Hay algún cambio en los procesos de generación de la factura electrónica tras la implantación de los sistemas de factura electrónica??

Sí, un contribuyente puede generar facturas electrónicas utilizando el IRN. No habrá ningún cambio en la generación de los procesos de la factura electrónica.

¿Es necesario que el contribuyente genere un token para cada transacción??

No se recomienda crear un nuevo token para cada transacción. Una vez generado el token, puede utilizarse varias veces hasta que caduque. En caso de que se realice una nueva solicitud, el sistema devolverá el token válido anterior junto con el tiempo de caducidad. Para hacer una nueva solicitud, el contribuyente puede referirse al token ya generado por el sistema. Si el token ha caducado, puede levantar uno nuevo.

¿Qué ocurre si se realiza la misma solicitud varias veces??

No se recomienda realizar la misma solicitud varias veces. Pero, si un contribuyente lo hace, el sistema de factura electrónica puede bloquear la solicitud del usuario durante una hora aproximadamente.

¿Cuál es la intención de utilizar «Forzar la actualización del token de acceso» en la API de autenticación??

Un contribuyente puede utilizar «Force Refresh Access Token» para generar un nuevo token sólo 10 minutos antes de la expiración del token anterior para evitar el fracaso de una transacción después de la expiración de un token.

¿Se puede utilizar el mismo token para generar facturas electrónicas y facturas electrónicas??

Sí, se puede utilizar el mismo token para generar tanto facturas electrónicas como facturas electrónicas. Pero, lo mismo debe hacerse dentro de la expiración del token.

¿Puede un contribuyente imprimir el código QR en su factura??

Sí, un contribuyente puede hacerlo utilizando la API «Generar IRN» antes de emitirlo a la contraparte.

Cómo se puede verificar una factura firmada?

Una factura firmada puede ser verificada por:

Utilizar la API «Generar IRN» para recuperar la factura firmada. Los detalles de la factura firmada se proporcionan según el estándar JWT y JWS, que contiene los parámetros de la firma de datos y del algoritmo de firma.

Además, para verificar la factura firmada y el código QR, se requiere la clave pública del certificado que se utilizó para firmar. La clave pública es la misma que se utilizó para cifrar la contraseña y la clave de la aplicación. La clave para el entorno de la caja de arena está disponible para su descarga en el portal del desarrollador de la API de la caja de arena de la factura electrónica.*Se utiliza el algoritmo RSA SHA256 para las firmas digitales.

¿Qué algoritmo se utiliza para encriptar/desencriptar los datos??

Se utiliza el algoritmo simétrico AES256 (AES/ECB/PKCS7Padding) y el algoritmo asimétrico (RSA/ECB/PKCS1Padding) junto con el SEK, para cifrar las cargas útiles de solicitud de los métodos POST API y para descifrar las cargas útiles de respuesta.

Durante cuánto tiempo es válido el token de autenticación?

Un token de autenticación es válido durante seis horas en el sistema de producción. Pero, para que el desarrollador pueda realizar pruebas efectivas, se establece una hora en la caja de arena.

¿Cuántas rondas de pruebas de la API deben realizarse en el sistema sandbox para obtener el acceso a la producción??

Cada API debe probarse en el entorno sandbox. Cada API tendrá que tener al menos 50 casos de éxito y 50 de fracaso. Se proporcionará un informe MIS generado por el sistema en la aplicación «Prueba de desarrolladores API», para averiguar cuántos casos son probados por los contribuyentes. Sobre la base de este informe, el sistema decidirá si un contribuyente está calificado para el acceso a la producción o no.

¿Por qué aparece el error «Invalid Auth Token» al generar una factura electrónica a través de la API??

El Auth Token para generar la factura electrónica estará activo durante seis horas desde el primer inicio de sesión con éxito. Aunque se vuelva a llamar a la Auth API antes de seis horas, se devolverá el mismo token y no se restablecerá la hora. Por lo tanto, hay que generar un nuevo token de autentificación cuando expira después de seis horas.

Haga clic aquí para leer las preguntas frecuentes sobre el sistema de facturación electrónica.

Deja un comentario