Referencia / SUNAT
Descarga de comprobantes Serie F
Comprobantes de serie F en PDF, XML o JSON, con tu clave SOL.
POST
/api/sunat/download/factura/external/{pdf|xml|json} Para qué sirve: Recuperar el comprobante que te emitió un proveedor para conciliarlo con tu contabilidad.
Autenticación
-
X-API-Keystring cabecera requerido -
X-API-Key: tu_token -
Authorizationstring cabecera -
Authorization: Bearer tu_token
Cualquiera de las dos sirve. El token se genera desde el panel de cliente. Ir al panel →
Parámetros del cuerpo
-
ruc-empresastring requerido - Credencial de tu clave SOL, la aportas tú. Ejemplo:
20123456789 -
usuario-solstring requerido - Credencial de tu clave SOL, la aportas tú. Ejemplo:
USUARIO01 -
clave-solstring requerido - Credencial de tu clave SOL, la aportas tú. Ejemplo:
•••••••• -
ruc-emisorstring requerido - RUC de quien emitió el comprobante. Ejemplo:
20987654321 -
seriestring requerido - Serie del comprobante. Ejemplo:
F001 -
numerostring requerido - Número correlativo. Ejemplo:
184
Respuesta
Campos principales que devuelve esta consulta:
archivo PDF, XML o JSON
Códigos de estado
- 200 OK
- Consulta resuelta. Descuenta una petición del plan.
- 401 Token inválido o vencido
- Falta la cabecera de autenticación o el token no es válido.
- 403 Sin acceso
- El plan no cubre este servicio o la suscripción no está activa.
- 404 No encontrado
- La consulta se ejecutó pero no hubo resultados. También descuenta.
- 429 Límite alcanzado
- Se agotaron las consultas del período.
- 500 Error del servicio
- Fallo al consultar la fuente oficial. No se guarda en caché.