Guía técnica · SUNAT · Perú
Un año completo por cliente, en una sola consulta.
Los recibos por honorarios se pueden descargar por API en las dos direcciones —los que emitió el contribuyente y los que le emitieron— con su PDF y su XML firmado. Suena directo, pero hay detalles del formulario de SUNAT que, si no los conoces, te dejan con datos incompletos sin que te des cuenta.
Las dos direcciones
Hay que distinguir dos casos, y sirven a públicos distintos:
Son consultas distintas, con parámetros distintos. El que arma solo una se queda con la mitad de la película.
Las trampas
El formulario no te deja pedir rangos largos. Pero ese límite vive en el JavaScript de la página, no en el servidor.
La consecuencia: por API se puede pedir un año completo en una sola consulta. Quien no lo sabe, trocea en muchas peticiones y multiplica el trabajo por nada.
La búsqueda exige varios campos que van en blanco pero tienen que enviarse. Si los omites, SUNAT responde un error que no tiene nada que ver con la causa real.
La consecuencia: un mensaje de error engañoso que te manda a buscar el problema donde no está, durante horas.
En los emitidos, una columna es "a quién le facturé"; en los recibidos, esa misma posición es "quién me facturó".
La consecuencia: si usas el mismo parseo para ambas, guardas el RUC del cliente donde va el del proveedor y al revés. Datos cruzados que parecen bien hasta que alguien concilia.
Si no quieres pelear con esto
Los recibos por honorarios —emitidos y recibidos— son uno de ocho módulos de un proyecto listo para incorporar a tu sistema, probado contra SUNAT en producción:
S/ 200, un solo pago, licencia para todos tus proyectos.
Preguntas frecuentes
Sí, en las dos direcciones: los que el contribuyente emitió y los que le emitieron. De cada recibo se obtiene el PDF y el XML firmado, más un listado con la descripción del servicio y los importes ya separados. Funciona sin navegador, con login en aproximadamente un segundo.
Para ambas. Los recibos emitidos aplican a personas naturales que prestan servicios. Los recibidos sirven también para empresas, que son las que reciben recibos de cuarta categoría y tienen que retener el 8%. Por eso conviene consultar las dos direcciones según el tipo de contribuyente.
Sí. El formulario del portal limita el rango de fechas, pero ese límite es solo del navegador, no del servidor. Por API se puede pedir un año completo en una sola consulta, lo que reduce mucho el trabajo por cliente.
Sí. De cada recibo se obtiene el PDF (la representación) y el XML firmado, que es el comprobante con valor fiscal. Si tienes que conservar uno a largo plazo, es el XML. El listado además trae la descripción del servicio y los importes ya separados, listos para cargar a un sistema contable.
S/ 200, un solo pago, licencia para todos tus proyectos. Te paso el Yape y te envío el proyecto al momento. Si tienes una duda técnica antes de comprar, pregúntala: la respondo yo.
Escribir al +51 972 309 300Lima, Perú · Respondo yo, no un bot.