¿Cómo funciona la integración ONESOURCE?

ONESOURCE (Thomson Reuters) actúa como Partner sobre la plataforma Gosocket. TR construye y envía los documentos fiscales en el formato DTE de Gosocket; Gosocket se encarga de validarlos, enrutarlos a la entidad tributaria del país correspondiente y almacenar el resultado.

---

El modelo de partner

ONESOURCE opera bajo un modelo de credenciales únicas de Partner (Chile) que se reutilizan para los 15 países de la integración. Cada cliente (empresa) tiene su propio accountId y sus propias ApiKeys, pero todas las operaciones se autorizan con el token del Partner.

---

Flujo de incorporación de un cliente nuevo

Antes de emitir o recibir documentos, cada empresa debe ser incorporada a la plataforma. El onboarding es asíncrono:

1. createToken

El Partner obtiene un JWT de 2 horas usando sus credenciales (partnerId + apiKeyUser). Chile siempre es el país del path.

2. createAccount

Crea la cuenta de la empresa con TaxId, razón social, usuario admin, método de autenticación y certificado digital. Devuelve un trackId.

3. getProcess

Sondea el trackId hasta que status = Ok. Al completar entrega el accountId y las ApiKeys del cliente.

---

Flujo de emisión (AR)

1. createTokenPOSTObtiene el JWT de autenticación del Partner.2. SendDocumentToAuthorityPOSTEnvía el DTE a Gosocket, que lo enruta a la entidad tributaria del país.3. GetDocumentPOSTConsulta el estado tributario del documento y obtiene las URLs de descarga.

Argentina: síncrono vs asíncrono

Argentina es el único país con soporte de async: true/false. ONESOURCE siempre usa async: false (síncrono), por lo que el estado final llega en la misma respuesta del SendDocumentToAuthority.

---

Flujo de recepción (AP)

1. GetReceivedDocumentPOSTConsulta los documentos recibidos en el Inbox del receptor.2. ConfirmReceivedDocumentPOSTConfirmación obligatoria de la recepción. Sin este paso, el documento queda pendiente.3. ChangeDocumentStatusPOSTInforma el evento de recepción ante la ET (aceptación / rechazo comercial). Obligatorio en CL, CO.

---

Folio Manager (CL y CO)

Para Chile y Colombia, la emisión de documentos requiere folios descargados previamente desde la entidad tributaria. El Folio Manager gestiona este ciclo:

billerId

Identificador del gestor de folios para una empresa y tipo de documento. Se crea con AddBiller y se referencia en SendDocumentToAuthority.

Rango primario

Bloque de folios descargado desde el SII (CL) o equivalente (CO). Se gestiona con DownloadPrimaryRangeET.

Subrango

Partición del rango primario asignada al uso activo. Se recarga automáticamente cuando alcanza el umbral configurado.

Recarga automática

Cada 2 horas el sistema verifica si los subrangos activos están por debajo del threshold y, si es así, recarga con el tamaño configurado en SaveBillerConfiguration.