Saltar al contenido principal

ONESOURCE: AR — Emisión

ONESOURCE utiliza la plataforma Gosocket para emisión de documentos fiscales en Latinoamérica mediante API REST con autenticación OAuth 2.0. Todos los países usan el mapping genérico DTE de Gosocket.

Actores del proceso​

ONESOURCE
Integrador — genera el DTE y consume la API de Gosocket para emitir documentos en 15 países
Gosocket
Plataforma — valida el DTE, enruta a la entidad tributaria del país y almacena el estado y los archivos resultantes
Entidad Tributaria
Autoridad fiscal del país — autoriza o rechaza el documento electrónico

Paso 1 — Autenticación​

Obtener token de acceso antes de cada sesión de llamadas a la API.

  • Endpoint: POST /oauth2/token
  • Grant type: client_credentials
  • Scope: all

Paso 2 — Enviar documento​

Método: SendDocumentToAuthority — POST

  • Se envía el DTE de integración estándar (mapping genérico, aplica para todos los países).
  • Cuando aplica, se incluye el parámetro billerId → ver Folio Manager Configuration.
  • Criterio de éxito: combinación de success + code. ONESOURCE evalúa ambos campos actualmente.
  • Argentina permite elegir flujo síncrono o asíncrono con async: true/false; ONESOURCE usa siempre async: false (síncrono).

Paso 3 — Consultar estado​

Método: GetDocument — POST

Se invoca independientemente de si el flujo es síncrono o asíncrono. Devuelve el estado tributario actualizado, IDs del documento, fechas, datos del emisor/receptor y URLs de descarga.

📝 Las URLs de descarga (XML, PDF, adjuntos) deben estar habilitadas para la empresa. Si no están disponibles en la respuesta, contacta al equipo de Integraciones.

Parámetros clave: GlobalDocumentId, CountryDocumentId, SenderCode, DateFrom, DateTo, Country.

Paso 4 — Descargar archivos​

Usa las URLs obtenidas en GetDocument o llama directamente a los métodos de descarga:

DownloadDocumentXmlPOSTDescarga el XML del documento.DownloadDocumentPdfPOSTDescarga el PDF del documento.DownloadDocumentJsonPOSTDescarga el JSON del documento.

Paso 5 — Eventos y cancelaciones​

Aplica según país. Consulta la documentación de cada método:

ChangeDocumentStatusPOSTInforma eventos en los documentos.ChangeDocumentAuthorityStatusPOSTCambia el estado ante la Entidad Tributaria.

📋 Consulta la referencia completa del flujo de cancelación con el equipo de Integraciones.

Folio Manager​

La API de Folio Manager es usada por ONESOURCE en: CL y CO. En evaluación: CR, PY, UY.

Ver Folio Manager Configuration para la referencia completa de endpoints.