Saltar al contenido principal

Facturar para varias empresas

Si tu aplicación emite comprobantes para varias empresas (varios RUC), cada empresa tiene sus propias credenciales, pero no necesitas un cliente HTTP por cada una. Crea un FileSender por empresa y haz que todos compartan el mismo SunatClient: así reutilizas las conexiones y cada empresa conserva su propio token para las guías de remisión.

Cómo funciona​

  • FileSender es una empresa: solo guarda las URLs y las credenciales. Es liviano; puedes tener uno por empresa o crearlo en cada petición.
  • SunatClient es la conexión: mantiene las conexiones HTTP y una caché de tokens OAuth de las guías de remisión. Los tokens se guardan por client_id + usuario, así que las empresas no se mezclan aunque compartan cliente.
  • Es seguro en concurrencia: puedes usar el mismo SunatClient desde varios hilos. Los tokens se piden de uno en uno, para que dos llamadas simultáneas no revoquen el token de la otra.

Un cliente, varias empresas​

En los ejemplos, 20123456789 es una segunda empresa de ejemplo y las credenciales son valores de ejemplo de producción.

import io.github.project.openubl.xsender.Credentials;
import io.github.project.openubl.xsender.FileSender;
import io.github.project.openubl.xsender.URLs;
import io.github.project.openubl.xsender.sunat.SunatClient;

// Uno para toda la aplicación
SunatClient sunatClient = new SunatClient();

FileSender softgreen = new FileSender(
URLs.production(),
Credentials.builder()
.username("12345678912USUARIOSOL")
.password("CLAVE_A")
.clientId("client-id-a") // solo para guías de remisión
.clientSecret("client-secret-a")
.build(),
sunatClient);

FileSender otraEmpresa = new FileSender(
URLs.production(),
Credentials.builder()
.username("20123456789USUARIOSOL")
.password("CLAVE_B")
.build(),
sunatClient);

softgreen.sendFile(xmlFirmadoDeSoftgreen);
otraEmpresa.sendFile(xmlFirmadoDeOtraEmpresa);

Con new FileSender(urls, credentials) (dos argumentos) cada FileSender crea su propio SunatClient. Con muchas empresas, usa el constructor de tres argumentos para compartir uno.

Si necesitas otra configuración HTTP, SunatClient acepta tu propio java.net.http.HttpClient:

SunatClient sunatClient = new SunatClient(
HttpClient.newBuilder()
.connectTimeout(Duration.ofSeconds(30))
.build(),
SunatClient.SUNAT_SECURITY_API_URL // dónde se piden los tokens de las guías
);

Tener en cuenta​

  • Las guías de remisión necesitan además el client_id y el client_secret de la API de cada empresa. Revisa Guías de remisión.
  • Cada empresa firma con su certificado: compartir el cliente no cambia la firma. Firma el XML de cada empresa con su propio certificado digital antes de enviarlo. Revisa Firma digital.
  • Consultas: los servicios de consulta y validación se llaman sobre el SunatClient con las credenciales de cada empresa. Revisa Consultar y validar comprobantes.
  • En Spring Boot, Quarkus o Jakarta EE puedes inyectar el SunatClient compartido y crear un FileSender por empresa con él. Revisa Integrar con frameworks Java.