Skip to main content

ONESOURCE: AR — Issuing

Gosocket is the platform ONESOURCE uses to issue tax documents in Latin America through a REST API with OAuth 2.0 authentication. All countries use the generic Gosocket DTE mapping.

Process actors​

ONESOURCE
Integrator — generates the DTE and consumes the Gosocket API to issue documents in 15 countries
Gosocket
Platform — validates the DTE, routes it to the country tax authority and stores the status and resulting files
Tax Authority
Country tax authority — authorizes or rejects the electronic document

Step 1 — Authentication​

Obtain an access token before each session. See createToken for endpoint details, headers and response.

Step 2 — Send document​

Method: SendDocumentToAuthority — POST

  • The standard integration DTE is sent (generic mapping, applies to all countries).
  • When applicable, the billerId parameter is included → see Folio Manager Configuration.
  • Success criterion: the response combines success: true + success code in the code field.
  • The integration operates with async: false (synchronous) for Argentina; the final status is returned in the same SendDocumentToAuthority response.

Step 3 — Query status​

Method: GetDocument — POST

Invoked regardless of whether the flow is synchronous or asynchronous. It returns the updated tax status, document IDs, dates, issuer/receiver data and download URLs.

note

The download URLs (XML, PDF, attachments) must be enabled for the company. If they are not available in the response, contact the Gosocket support team.

Key parameters: GlobalDocumentId, CountryDocumentId, SenderCode, DateFrom, DateTo, Country.

Step 4 — Download files​

Use the URLs obtained in GetDocument or call the download methods directly:

DownloadDocumentXmlPOSTDownloads the document XML.DownloadDocumentPdfPOSTDownloads the document PDF.DownloadDocumentJsonPOSTDownloads the document JSON.

Step 5 — Events and cancellations​

Applies depending on the country. Check the documentation for each method:

ChangeDocumentStatusPOSTReports events on the documents.ChangeDocumentAuthorityStatusPOSTChanges the status before the Tax Authority.
note

Check the full cancellation flow reference in the ChangeDocumentStatus documentation.

Folio Manager​

The Folio Manager API is used by ONESOURCE in: CL and CO. Under evaluation: CR, PY, UY.

See Folio Manager Configuration for the full endpoint reference.