Manual de consulta integrada DE COMPROBANTE DE PAGO …

1 Manual DE consulta integrada DE COMPROBANTE DE PAGO POR SERVICIO WEB Manual de Usuario Descripci n breve Se detal l a l a s ecuenci a de pas os para uti lizar el s ervi ci o a trav s de l a herrami enta Pos tman. 1 Manual DE consulta integrada DE COMPROBANTE DE PAGO POR SERVICIO WEB consulta integrada consulta integrada de validez de COMPROBANTE de pago a trav s de servicio web. Este Manual contiene tres secciones: A. Generaci n de Credenciales: describe c mo poder generar las credenciales para obtener un token desde la opci n de Men Sol. B. Generaci n de Token: describe c mo generar un token con las credenciales obtenidas en la secci n anterior. C. Uso del Servicio Web de consulta integrada : describe c mo hacer una invocaci n al servicio de consulta integrada con el token y los par metros de consulta .

2 2 Manual DE consulta integrada DE COMPROBANTE DE PAGO POR SERVICIO WEB A. GENERACI N DE CREDENCIALES Ingresar a la opci n Credenciales de API1 SUNAT Se inicia la sesi n en el SUNAT Operaciones en L nea (SOL) con su n mero de RUC, usuario y contrase a: Seguidamente, se ingresa a la opci n Empresas / comprobantes de pago / consulta de Validez de comprobantes de Pago/ consulta de Validez de comprobantes de Pago / Credenciales de API SUNAT/ 1 Una API es el mecani s mo m s ti l para conectar dos s oftwares entre s para el i ntercambi o de mens aj es o datos en formato es t ndar como XML o JSON. 3 Manual DE consulta integrada DE COMPROBANTE DE PAGO POR SERVICIO WEB Al ingresar a la opci n Credenciales de API SUNAT : i) Si no se ha habilitado anteriormente, el sistema consulta si deseamos habilitar el n mero de RUC para el consumo del API SUNAT: Se presiona el bot n HABILITAR y a continuaci n se le mostrar la pantalla para Registrar la aplicaci n que acceder al API SUNAT.

3 Ii) Si el n mero de RUC ya estuviera habilitado por el consumo del API SUNAT, el sistema nos enviar directamente a la pantalla para Registrar la aplicaci n que acceder al API SUNAT. Registrar las aplicaciones que acceder n al API SUNAT El sistema solicita ingresar el nombre y la URL de la aplicaci n que acceder al API SUNAT: 4 Manual DE consulta integrada DE COMPROBANTE DE PAGO POR SERVICIO WEB Se registra el nombre y la URL y selecciona el bot n REGISTRAR El sistema agrega la aplicaci n a la lista de aplicaciones registradas: El Id y la Clave son las credenciales con que el aplicativo acceder al API SUNAT. Editar una aplicaci n registrada - Editar nombre o URL de la aplicaci n Se presiona el bot n de la aplicaci n que se quiere editar; para lo cual, el sistema pide editar los datos de la aplicaci n: Una vez editados los datos de la aplicaci n, se presiona el bot n GUARDAR.

4 Eliminar una aplicaci n registrada Se selecciona el bot n de la aplicaci n que se quiere eliminar. El sistema elimina la aplicaci n de la lista de aplicaciones registradas. Generar nueva credencial para la aplicaci n que acceder al API SUNAT Se selecciona el bot n de la aplicaci n a la que se desea generar una nueva credencial, con lo cual el sistema muestra un nuevo Id y clave para la aplicaci n . 5 Manual DE consulta integrada DE COMPROBANTE DE PAGO POR SERVICIO WEB B. GENERACI N DE TOKEN Para la generaci n de token se deber haber creado las credenciales (client_id y client_secret) seg n lo indicado en la secci n anterior (se realiza por nica vez). Se deber acceder a la siguiente URL, como POST : Donde: client_id: Es el client_id generado en men sol. En el cuerpo(Body) de la consulta deber ser de tipo x-www-form-urlencoded y enviar los siguientes keys: grant_type client_credentials scope client_id (client_id generado en men sol) client_secret (client_secret generado en men sol) *Donde grant_type y scope son valores fijos Y como datos de respuesta se tendr access_token (token generado) token_type (tipo de token) expires_in (tiempo de expiraci n del token - El tiempo de expiraci n es en segundos.)

5 Conclu do el tiempo podr generar un nuevo token) 6 Manual DE consulta integrada DE COMPROBANTE DE PAGO POR SERVICIO WEB A continuaci n, se muestra un ejemplo de generaci n de token usando la herramienta REST POSTMAN 3: URL y el tipo de env o: Tipo del cuerpo(Body) del env o y keys: Respuesta de la consulta : 3 Di s poni bl e para los s is temas operati vos : Wi ndows , Mac y Li nux. 7 Manual DE consulta integrada DE COMPROBANTE DE PAGO POR SERVICIO WEB C. USO DEL SERVICIO DE consulta integrada Para uso del servicio se deber haber generado previamente el token en la secci n anterior, este servicio permite saber la validaci n de un COMPROBANTE de pago. El URL del servicio de consulta integrada es de tipo POST y es el siguiente: Donde: RUC: Es el ruc de qui n realiza la consulta .

6 En las Cabeceras (Headers) se deber enviar lo siguiente: Authorization Bearer + token Se debe enviar la palabra Bearer concatenado con un espacio y luego el token generado. En el cuerpo(Body) de la consulta deber ser de tipo raw -JSON(application/json) y enviar las siguientes propiedades en formato JSON: Propiedad Tipo Longitud Descripci n Obligatorio numRuc String 11 N mero de RUC emisor COMPROBANTE Si codComp String an2 C digo de tipo de COMPROBANTE Si numeroSerie String an4 N mero de serie del COMPROBANTE Si numero Integer N mero del COMPROBANTE Si fechaEmision date dd/mm/yyyy Fecha de emisi n del COMPROBANTE Si monto decimal n(8,2) Monto total del COMPROBANTE *Solo para electr nico Y como datos de respuesta se tendr : Propiedad Tipo Descripci n success boolean Estado consulta message String Mensaje del estado de la operaci n Integer Estado del COMPROBANTE String Estado del contribuyente String Condici n Domiciliaria del Contribuyente Array Observaciones errorCode String C digo de Error 8 Manual DE consulta integrada DE COMPROBANTE DE PAGO POR SERVICIO WEB A continuaci n, se muestra un ejemplo de la consulta de un COMPROBANTE : URL y el tipo de env o: Tipo del cuerpo(Body) del env o y datos: En el header enviamos como key Authorization con el valor de la palabra Bearer m s el token, separado con un espacio.

7 9 Manual DE consulta integrada DE COMPROBANTE DE PAGO POR SERVICIO WEB Respuesta de la consulta : 10 Manual DE consulta integrada DE COMPROBANTE DE PAGO POR SERVICIO WEB ANEXO (DESCRIPCION DE CODIGO) Estado del COMPROBANTE (estadoCp) "0" : "NO EXISTE" ( COMPROBANTE no i nformado), "1" : "ACEPTADO": ( COMPROBANTE aceptado), "2" : "ANULADO : (Comuni cado en una baj a), "3" : "AUTORIZADO": (con autori zaci n de i mprenta), "4" : "NO AUTORIZADO": (no autori zado por i mprenta). Estado del contribuyente (estadoRuc) "00" : "ACTIVO", "01" : "BAJA PROVISIONAL", "02" : "BAJA PROV. POR OFICIO", "03" : "SUSPENSION TEMPORAL", "10" : "BAJA DEFINITIVA", "11" : "BAJA DE OFICIO", "22" : " ", Condici n de Domicilio del Contribuyente (condDomiRuc) "00" : "HABIDO", "09" : "PENDIENTE", "11" : "POR VERIFICAR", "12" : "NO HABIDO", "20" : "NO HALLADO", 11 Manual DE consulta integrada DE COMPROBANTE DE PAGO POR SERVICIO WEB Ti p o de COMPROBANTE (codComp) C digo Descripci n 01 FACTURA 03 BOLETA DE VENTA 04 LIQUIDACI N DE COMPRA 07 NOTA DE CREDITO 08 R1 R7 NOTA DE DEBITO RECIBO POR HONORARIOS NOTA DE CREDITO DE RECIBOS 12 Manual DE consulta integrada DE COMPROBANTE DE PAGO POR SERVICIO WEB Consideraciones: 1.

8 Json Malformado: el postman indica que el json no est estructurado correctamente.