Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Simplify to tables + samples only; remove internal code/file references and implementation caveats

This page helps an Office of First Filing (OFF) that currently answers WIPO DAS over the legacy TDA/PDX XML protocol figure out what to return instead if it implements the modern "OFF Services" REST interface.

Offices that still use TDA/PDX are connected to DAS through their own TDA/PDX endpoint

...

and

...

keep using their own numeric codes — nothing changes for them. This page

...

is purely

...

a migration reference: for each legacy TDA/PDX code, what should the equivalent REST response look like?

...

This only concerns the OFF↔DAS exchange. See 5.1.2.- Responses from DAS to OSF via notification endpoint and 5.1.3.- Responses from DAS to OSF via GET for what reaches the requesting office (OSF

...

).

This REST interface is still a draft. It is retrieval-only (registration is not covered) and is not required or supported by WIPO DAS today — treat the table below as "what to implement," not as an already-available service.

Sample exchange over the new REST interface

Sources: - das-app/src/app/das-tda-error-messages.ts — literal legacy TDA/PDX message text (left-hand columns below) - das/documents/postman/sampleYamlFileOffServices-draftSample_20260225.yaml — draft spec for the modern OFF Services REST interface (right-hand columns below)

⚠️ Status of the REST side: draft, not yet live. In the current DAS backend, the only code touching this interface is a mock/test harness (forward-retrieval-request-mock-service.ts, used by the internal automation-test suite) — no production office implements it yet. Treat the REST columns below as "what an OFF should implement", not as an already-observed behaviour.

⚠️ Scope: retrieval only. The draft's PdxRequest.operationCategory only allows retrieval — registration-related TDA codes (9, 10, 14, 15) have no REST equivalent defined and are out of scope here.

...

Instead of a numeric TDA/PDX code, the an OFF 's implementing REST endpoint reports status with plain fields:

Code Block
themeDefault
languageyamljson
POST /v1/requests/notifications
{
  "systemId": "<office code>",
  "notificationCategory": "document availability",
  "dateTime": "2026-02-25T12:23:24Z",
  "totalQuantity": 1,
  "documentNotificationRetrievalStatusBag": [
    {
requestStatusCategory: pending | success | error   # coarse bucket
statusMessage: free text         "requestAckId": "USIB20210523120902",
      "requestStatusCategory": "error",
        "errorCode": null,
   # the actual "reason", e.g.statusMessage": "unmatched access code"
errorCode: string (loosely typed, no}
 fixed enum)
POST /v1/requests/notifications (DocumentNotificationRetrievalStatus), or returned directly on GET /v1/requests/retrievals (PdxResponse). The statusMessage vocabulary documented in the draft is word-for-word identical to the literal strings DAS already uses internally in das-status.ts (see 5.1.3, section B) — so an OFF implementing this spec should reuse exactly those strings.
]
}

TDA/PDX code → REST equivalent

...

TDA/PDX codeStatus typeTDA/PDX meaning as suppliedREST requestStatusCategoryREST statusMessage to sendNotes
0FWA-status, PDX-statusNo Error / Successfulsuccessready for download → delivered (two-stage)Report ready for download once the file/URL is available, delivered once retrieved
1FWA/PDX/DAS-statusApplication number provided was not founderrordocument number not available⚠️ This code is ambiguous even in the legacy protocol itself — some implementations also use it for may also represent "document withdrawn" or a generic missing-field condition . Pick the REST statusMessage that matches — send the message matching the actual situation, not just the historical code value
2FWA-status, PDX-statusFile is not availableerrordocument awaiting security clearanceClosest (best available match)⚠️ Gap: ; the REST vocabulary doesn't distinguish does not distinguish a temporary "awaiting clearance" (temporary) from "clearance permanently refused"from a permanent refusal
3PDX-statusDocuments was not founderrordocument incompleteDirect equivalent
4FWA-statusDocument content could not be retrievedn/an/aNot used in practical use — "Probably not used as practice — TDA Error 3 is similar"covers the same situation
5PDX-statusNot published, no authorization to permit access filederrordocument awaiting security clearance(best available match)Same ⚠️ Gap: same REST phrase as code 2 above — the draft has no separate "not authorized for public access" message exists
6FWA-statusDelay in translationn/an/aNot in practical use — "Probably never used"used in practice
7PDX-statusOversize document/CD will be mailedn/a(no equivalent)Not applicable under REST: large files are handled via presigned-URL upload/download (as in our registration/retrieval Postman collections), so there's no "oversize/CD mailed" concept any more
8FWA-statusRequest less than 1000 pages per transactionn/an/aNot used in practical use — "Probably not used, instead TDA Error 7 was reported"practice — TDA code 7 is reported instead
9DAS-statusRegisteredn/an/aDAS-internal Internal status only, not a counterpart reply code from an OFF — no action needed
10DAS-statusNot Registeredn/an/aDAS-internal Internal only
11PDX-statusDas Access Code invaliderrorunmatched access codeDirect equivalent
12PDX-statusRequest under processing, response sent laterpendingawaiting off responseThis is really just the default Default pending state while the OFF works on the request, not a distinct error
13PDX-statusApplication number does not correspond with bibliographic datan/an/aRarely used — DAS rejects an OSF request with mismatched data before it would reach this point
14DAS-statusSuccessfully Registered DAS to OFF onlyn/an/aRegistration-only — out of scope (this draft interface covers retrieval only)
15DAS-statusSuccessfully Updated DAS to OFF onlyn/an/aRegistration-only — out of scope
16DAS-statusDas Access Code and Priority Date did not matcherrorunmatched document date and access codeExact equivalent — the draft has a dedicated phrase for this combined case
17DAS-statusPriority Date did not matcherrorunmatched document dateDirect equivalent
18DAS-statusDas Access Code did not matcherrorunmatched access codeDirect equivalent
19DAS-statusPriority Date was not provided by OFFerrorinvalid document details(closest match)Closest available match — there is no separate ⚠️ Gap: the REST vocabulary doesn't distinguish "missing" from vs. "mismatched" date ; unmatched document date would also be defensible — needs clarification with DAS Support before an OFF implements itmessage
-1FWA-fault, PDX-faultSystem not available, scheduled downtime(synchronous reported as a system error, not this vocabulary)—Use the synchronous error shape instead: code: TDA_SYSTEM_ERROR, message: "TDA SYSTEM ERROR" on the request itself (HTTP 500), per the draft's exampleOfError500
-2FWA-fault, PDX-faultSystem not available, back-end problem(synchronous reported as a system error, not this vocabulary)—Same as -1
-3PDX-faultReceived document cannot be importedn/a(no equivalent)Not No longer applicable under REST: this code exists only because the legacy protocol exchanges XML payloads. The REST interface exchanges structured JSON with no embedded document content, so there's nothing to "fail to import" in this senseplain identification data, not document content
-4FWA-fault, PDX-faultXML input processing failuren/a(no equivalent)Same reasoning as -3
-5FWA-fault, PDX-faultXML output processing failuren/a(no equivalent)Same reasoning as -3

Synchronous (request-level) errors — not part of the TDA code family

Sample of a system-level error (request rejected before it is even processed)

Code Block
themeDefault
languagejson
{
  "code": "TDA_SYSTEM_ERROR",
  "message": "TDA SYSTEM ERROR",
  "details": [
    { "message": "Unexpected internal error", "code": 500 }
  ]
}

Other examples of this shapeSeparately from the status-message vocabulary above, the draft defines a plain request-validation error shape for when DAS calls the OFF's endpoint with bad/missing parameters (this is plumbing-level, not a translation of a TDA business code):

Code Block
themeDefault
languagejson
{
  "code": 400,
  "message": "Invalid input data or document",
  "errorMessage": "DAS Access Code cannot be blank"
}
requesterOffice, documentNumber, documentDate, dasAccessCode, and requestAckId. Note the schema types code as an integer (echoing the HTTP status: 400/401/500), while the file's own notification-endpoint examples inconsistently use string codes (INVALID_INPUT_DATA, INVALID_TOKEN, TDA_SYSTEM_ERROR) for the same concept — flagged here as a draft inconsistency to resolve before this spec is finalized, not something to replicate.