ONESOURCE — Integración
ONESOURCE es la plataforma de cumplimiento fiscal de Thomson Reuters (TR). TR utiliza Gosocket para emitir y recibir documentos fiscales en 15 países mediante una API REST con autenticación OAuth 2.0.
¿Qué hace la integración Gosocket + ONESOURCE?
Países soportados
| País | Código | Certificado | taxEntity |
|---|---|---|---|
| Argentina | ar | ❌ No requiere | ❌ No requiere |
| Bolivia | bo | ✅ .pfx / .p12 | ✅ Token ISIPASS |
| Brasil | br | ✅ .pfx / .p12 | ✅ Credenciales NDD + emails recepción |
| Chile | cl | ✅ .pfx | ❌ No requiere |
| Colombia | co | ✅ .pfx | ❌ No requiere |
| Costa Rica | cr | ✅ .p12 | ✅ Credenciales ATV (comprobantes) |
| Ecuador | ec | ✅ .p12 / .pfx | ❌ No requiere |
| El Salvador | sv | ✅ .pfx / .p12 | ✅ Credenciales MH |
| Guatemala | gt | ✅ .pfx / .p12 | ✅ Credenciales SAT |
| México | mx | ✅ CSD .cer + .key | ❌ No requiere |
| Panamá | pa | ✅ X.509 v3 | ✅ RUC + código DGI |
| Paraguay | py | ✅ .pfx | ✅ idCSS + css SIFEN |
| Perú | pe | ✅ .pfx / .p12 | ✅ Credenciales SOL (SUNAT) |
| República Dominicana | do | ✅ .pfx / .p12 | ✅ certification (boolean) |
| Uruguay | uy | ✅ .pfx | ❌ No requiere |
Chile es el país de referencia ONESOURCE: las credenciales del Partner (partnerId / apiKeyUser) se crean para Chile y se reutilizan para todos los demás países.
¿Para quién es esta documentación?
Esta documentación está dirigida a:
- Arquitectos e ingenieros de ONESOURCE que diseñan e implementan la integración fiscal con Gosocket
- Equipos técnicos de Thomson Reuters que incorporan, configuran y dan soporte a las cuentas en la plataforma
- Partners técnicos que operan la integración en producción para los 15 países
Mecanismo de integración
La integración usa API REST con autenticación OAuth 2.0. ONESOURCE actúa como Partner: obtiene un JWT con sus credenciales de Partner (partnerId + apiKeyUser), crea cuentas cliente de forma asíncrona vía Onboarding, y emite documentos con SendDocumentToAuthority usando el mapping genérico DTE de Gosocket. La recepción opera por polling con GetReceivedDocument. Para Chile y Colombia, la emisión requiere folios gestionados por el Folio Manager.
Consulta Cómo funciona para el detalle del modelo de Partner, los flujos y el ciclo de onboarding.
Por dónde empezar
Si es la primera vez que trabajas con esta integración, sigue este orden:
- Lee Cómo funciona para entender el modelo de Partner, el onboarding asíncrono y los flujos de emisión y recepción
- Obtén las credenciales de Partner en Onboarding
- Crea la primera cuenta cliente con createAccount y verifica el resultado con getProcess
- Revisa los Flujos para la secuencia de llamadas de emisión y recepción
- Si operas en CL o CO, configura el Folio Manager antes de emitir
Secciones de esta documentación
Cómo funcionaGuíaModelo de Partner, onboarding asíncrono, flujos de emisión y recepción, y Folio Manager.OnboardingAPI RESTCredenciales del Partner y métodos para crear y gestionar cuentas cliente.Parámetros por PaísReferenciaCampos condicionales taxEntity y certificateRootDto específicos por país.Flujos de ProcesoFlujosEmisión (AR) y recepción (AP): autenticación, envío, consulta de estado y eventos.Folio ManagerAPI RESTConfiguración del Folio Manager para gestión de rangos y folios (CL, CO).