The Spanish version is the authoritative reference. View in Spanish
Docupath: Gosocket → Docupath
Gosocket acts as a client of the Docupath REST API: it sends tax PDFs to the Finn (finance) vertical pipeline, which processes them with AI without templates, extracts the structured data and validates it. The result is exported in Docupath AI Format (DIF) and mapped to Gosocket's native XML, which Docupath delivers to Gosocket via the Docupath → Gosocket flow.
Process actors
Environments
| Environment | Base URL | Portal |
|---|---|---|
| DEV / Testing | https://api.docupathdev.app | https://gosocket.docupathdev.app |
| PRD / Production | https://api.docupath.app | https://gosocket.docupath.app |
Process flow
Step 1 — Authentication
Gosocket obtains an access_token via OAuth 2.0 Client Credentials (POST /v1/oauth/token) before each session. Credentials are generated from the Docupath portal under Settings → Destination Format & APIs. The token expires in ~1 hour and can be renewed with the refresh_token without re-authenticating.
Step 2 — Send document
POST /v1/documents with the PDF and metadata as multipart/form-data. Gosocket generates a unique external_id and a batch batch_id; both are included in the metadata and Docupath stores them to return them to Gosocket in Flow ②. The additional_metadata.client_id field identifies the organization in Docupath and is different from the OAuth client_id.
Step 3 — Processing and delivery
Docupath processes the document with the Finn vertical (extraction, validation, DIF → XML export). Once complete, it delivers the result to Gosocket via flow ② (UploadZipDocument). Documents with processing errors are managed from the Docupath private portal.