FiscoBridge SDC v3 – Status & Environment Parameters Migration Guide (E-SDC)

This document explains how POS systems must migrate from obsolete v2 E-SDC endpoints to the current v3 standard.

In v3, both old endpoints are replaced and POS software must use two v3 endpoints:

  1. Status endpoint – device, secure element, fiscal counters
  2. Environment parameters endpoint – tax authority and environment configuration

This guide is intended for POS developers and POS resellers integrating with FiscoBridge E-SDC (local SDC).

Official documentation references (v3)

For detailed, authoritative API definitions, refer to the official FRCS documentation:

These links should be treated as the primary source of truth for request/response schemas.

1. What is being replaced (important)

Obsolete v2 endpoints

The following endpoints are obsolete and must not be used anymore:

  1. Device status
    • POST /api/Status/GetStatus
  2. Tax authority / environment parameters
    • GET /api/Status/GetTaxAuthorityParams

Both endpoints are fully replaced in v3.

2. New v3 endpoints (mandatory)

In v3, POS systems must use both of the following endpoints:

Purpose Endpoint Method
Device & fiscal status /api/v3/status GET
Environment & tax authority parameters /api/v3/environment-parameters GET

Both endpoints:

3. Migration summary (old → new)

Old v2 endpoint Status New v3 replacement
/api/Status/GetStatus Obsolete /api/v3/status
/api/Status/GetTaxAuthorityParams Obsolete /api/v3/environment-parameters

Both old endpoints must be removed from POS software.

4. Status endpoint migration

Old v2 request (obsolete)

POST /api/Status/GetStatus
Content-Type: application/json
Accept: application/json

{
  "GS": "GetStatus"
}

New v3 request

GET /api/v3/status
Accept: application/json

Key changes

5. Status response changes

5.1 JSON naming convention

Old v2 New v3
PascalCase camelCase

POS implementations must update JSON parsing or enable case-insensitive mapping.

6. Status field mapping (old → new)

Old v2 field New v3 field
IsPinRequired isPinRequired
AuditRequired auditRequired
DT sdcDateTime
LastInvoiceNumber lastInvoiceNumber
ProtocolVersion protocolVersion
SecureElementVersion secureElementVersion
HardwareVersion hardwareVersion
SoftwareVersion softwareVersion
DeviceSerialNumber deviceSerialNumber
Make make
Model model
MSSC mssc
GSC gsc

7. Replacement of GetTaxAuthorityParams (important)

Old v2 endpoint (obsolete)

GET /api/Status/GetTaxAuthorityParams
Accept: application/json

This endpoint previously returned:

New v3 replacement

GET /api/v3/environment-parameters
Accept: application/json

The Get-Environment-Parameters endpoint fully replaces Get-Tax-Authority-Params.

POS software must not call the old endpoint anymore.

8. Environment parameters response (v3)

The v3 environment parameters endpoint returns environment-level configuration, not device state.

Key fields

Field Description
organizationName Tax authority organization name
serverTimeZone Server time zone
street Street address
city City
country Country
environmentName Environment name (e.g. SANDBOX, PROD)
logo URL of official logo
ntpServer NTP server
supportedLanguages Supported languages
endpoints Related service URLs

POS software must treat these values as configurable, not hardcoded.

9. Separation of responsibilities (v3 design)

Endpoint Responsibility
/api/v3/status Device state, secure element, fiscal counters, tax rates
/api/v3/environment-parameters Tax authority & environment configuration

This separation is intentional and required.

10. Migration checklist for POS developers

  1. Remove usage of:
    • /api/Status/GetStatus
    • /api/Status/GetTaxAuthorityParams
  2. Implement:
    • GET /api/v3/status
    • GET /api/v3/environment-parameters
  3. Remove request bodies for status calls
  4. Update JSON parsing to camelCase
  5. Do not hardcode environment names or URLs
  6. Treat both v3 endpoints as mandatory
  7. Always refer to the official documentation links above

11. Summary

All new POS integrations must use both v3 endpoints.

End of document.