Dos niveles según lo que necesites: Básica para validar que tus comprobantes cuadran con SUNAT, y Completa para automatizar todo el ciclo — comparación, detalle de comprobantes y declaración.
Básica
«¿Mis libros cuadran con SUNAT?»
6 llamadas · ~1 día de trabajo
Queda fuera: corregir, ver el detalle de cada comprobante y declarar.
Eso se sigue haciendo a mano en la web de SmartTax.
Los dos niveles resuelven preguntas distintas: la Básica te dice si cuadras;
la Completa además te deja cerrar el periodo. El nivel que elijas cambia los pasos
que ves más abajo.
Básica
Completa
Llamadas
6
20
Esfuerzo
~1 día
1–2 semanas
Incluye
Subir el archivo PLE/SIRE
Confirmar y monitorear el procesamiento
Ejecutar la comparación contra SUNAT
Resultado agregado (coincide / solo SUNAT / solo tus registros)
Todo lo de la Básica, más:
Detalle línea por línea + descarga XML/PDF/CDR
Listado de comprobantes recibidos
Ciclo completo de declaración a SUNAT
Eliminar y regenerar un preliminar bloqueado
No incluye
Detalle línea por línea, descarga de archivos, declarar a SUNAT vía API — eso se hace en la web de SmartTax.
Reemplaza por completo el uso manual de la web de SmartTax desde el ERP.
Seis llamadas en orden estricto; las 2 marcadas en azul son de sondeo — se repiten hasta que el estado cambia.El camino feliz es la fila superior. Si hay que corregir un preliminar ya generado, el orden importa: eliminar → esperar COMPLETADO → recién ahí regenerar. Saltarse la espera es el error más común con este endpoint nuevo.
Antes de empezar
Entorno de pruebas
Toda la integración se arma y se prueba en UAT:https://api-uat.smarttax.pe/api/v1/sire
Los ejemplos de esta guía apuntan ahí.
Producción
https://api.smarttax.pe/api/v1/sire — recién cuando la integración
esté validada en UAT. Es el mismo contrato: solo cambia el host y la API key.
Autenticación
API key en el query string: ?key={API_KEY}. Va en todas las llamadas de esta guía; no se usa header Authorization.
Única excepción
El PUT del paso 2 sube el archivo a una URL firmada de Google Cloud Storage. Esa URL ya viene autenticada: no lleva la API key ni ningún otro credencial.
Formato
Todo es POST con cuerpo JSON (salvo el paso 2 y las descargas directas, que son GET).
Python · preparación
ABAP — según tu sistema
Escenario
Qué usar
ECC / NetWeaver clásico (la mayoría de instalaciones on-premise)
cl_http_client — la clase HTTP estándar, disponible sin add-ons. Es la que se usa en todos los ejemplos de esta guía.
S/4HANA reciente (2021+)
cl_web_http_client / if_web_http_client — API más moderna, mismo concepto. El código de abajo es el patrón universal; solo cambia el nombre de la clase y de los métodos (get_http_body → set_text, etc.).
SAP PI/PO ya instalado
No se hace en ABAP directo: se modela como un canal REST/HTTP_AAE en un iFlow. El JSON de esta guía es el que va en el mapping del lado SmartTax.
SAP BTP / Integration Suite (CPI)
Igual que PI/PO: un iFlow con adaptador REST. Útil si SmartTax necesita ser un paso dentro de un flujo más grande.