vsmsconnect — API — fiscal-records

← all endpoints

GET/api/v1/businesses/:businessId/fiscal-records/:requestId auth: jwt (administrator | view_audit)

Fetches a previously fiscalised invoice directly from the TaxCore V-SDC by its 8-character RequestId (stored in InvoicePayments.FiscalRequestId after fiscalisation). Proxies to TaxCore GET /api/v3/invoices/{requestId} using mTLS (cert + pfxPassword + PAC). The encryptedInternalData field is stripped server-side before the response is returned to the client.

handlers: FiscalRecordsController.getByRequestId

Inputs

namerequireddefaultdescription
businessId path
uuid		yes—Target business UUID.
requestId path
string (^[A-Z0-9]{8}$)		yes—8-character uppercase alphanumeric V-SDC RequestId — e.g. 'JNSMBCXG'.

Outputs

200
APIResponseDataObject<FiscalInvoiceRecordDTO>
Fiscal invoice record retrieved from V-SDC, with encryptedInternalData stripped.
404
APIError
BUSINESS_NOT_FOUND | FISCAL_RECORD_NOT_FOUND (V-SDC returned 404 for the RequestId).
422
APIError
CERTIFICATE_NOT_CONFIGURED (cert/PAC/password missing) | VSDC_URL_NOT_FOUND_IN_CERT (TaxCoreApiUrl not extracted from the cert).
502
APIError
FISCAL_ERROR — V-SDC returned an unexpected error.