Saltar al contenido principal

ONESOURCE: AR — Emisión

Gosocket es la plataforma que ONESOURCE utiliza para emitir 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. Ver createToken para el detalle del endpoint, headers y respuesta.

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.
  • 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.

nota

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.
nota

Consulta la referencia completa del flujo de cancelación en la documentación de ChangeDocumentStatus.

Folio Manager​

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

Consulta Configuración de Folio Manager para la referencia completa de endpoints.