FIX.Platform.Client 1.14.52

dotnet add package FIX.Platform.Client --version 1.14.52
                    
NuGet\Install-Package FIX.Platform.Client -Version 1.14.52
                    
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="FIX.Platform.Client" Version="1.14.52" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="FIX.Platform.Client" Version="1.14.52" />
                    
Directory.Packages.props
<PackageReference Include="FIX.Platform.Client" />
                    
Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add FIX.Platform.Client --version 1.14.52
                    
#r "nuget: FIX.Platform.Client, 1.14.52"
                    
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package FIX.Platform.Client@1.14.52
                    
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=FIX.Platform.Client&version=1.14.52
                    
Install as a Cake Addin
#tool nuget:?package=FIX.Platform.Client&version=1.14.52
                    
Install as a Cake Tool

FIX.Platform.Client

Official .NET client for the FIX Fiscal platform API.

Install

dotnet add package FIX.Platform.Client

Usage

using FIX.Platform.Client;
using FIX.Platform.Client.Generated;
using FIX.Platform.Models.Domain;
using FIX.Platform.Models.Enums;
using FIX.Platform.Models.Types;

// Runnable Quickstart for FIX.Platform.Client. Set FIX_API_KEY before running:
//   $env:FIX_API_KEY = "fix_..."   (PowerShell)
//   export FIX_API_KEY=fix_...     (bash)
// Get a key from your organization's FIX dashboard, or via fix.ApiKeys once authenticated another way.

var apiKey = Environment.GetEnvironmentVariable("FIX_API_KEY");
if (string.IsNullOrEmpty(apiKey))
{
    Console.WriteLine("Set the FIX_API_KEY environment variable to a real API key before running this sample.");
    return;
}

FixCore fix = new("https://go.fixfiscal.ro", apiKey); // baseUrl shown for clarity, it is the default

var receipt = new Receipt.Emit
{
    Kind = ReceiptType.Fiscal,
    Lines =
    [
        new SaleLine.Emit
        {
            Item = new Item.Snapshot { Name = "Bottled water" },
            SaleIdentifier = "SKU-001",
            GrossUnitPrice = new MonetaryAmount { Amount = 119m, CurrencyCode = "RON" },
            Vat = VatRate.RoNormal_2025,
        }
    ],
    Payments =
    [
        new PaymentRecord.CreateRequest
        {
            Amount = new MonetaryAmount { Amount = 119m, CurrencyCode = "RON" },
            Method = PaymentMethod.BankCard,
            Status = PaymentStatus.Paid,
            ProcessingDateTime = DateTime.UtcNow,
        }
    ],
};

Console.WriteLine("Emitting receipt...");

try
{
    var emitted = await fix.Receipt.EmitAsync(receipt);
    Console.WriteLine($"Emitted: {emitted}");
}
catch (ApiException<ProblemDetails> ex)
{
    // Typed errors: ApiException<T> carries the deserialized error body (ProblemDetails, ValidationProblem, ...).
    Console.WriteLine($"{ex.StatusCode} {ex.Result.Title}: {ex.Result.Detail}");
}
catch (ApiException ex)
{
    // ReadResponseAsString defaults to false per generated client (skips buffering the raw body); opt in per-client
    // when you need it, e.g.: fix.Receipt.ReadResponseAsString = true;
    Console.WriteLine($"{ex.StatusCode} {ex.Message}");
}

fix.Dispose();

Authentication

FixCore authenticates with either an API key or a user JWT, never both (passing both throws).

API key, for integrations. Get one from your organization's FIX dashboard (Settings → Account), or issue one via fix.ApiKeys from a JWT session. A key acts as its owning user. A key pinned to an organization is already scoped to it; an unpinned one selects its organization with OrganizationId, like a user.

JWT, to act as a user. Log in with a password, or pass a token you already have:

using var fix = new FixCore("https://go.fixfiscal.ro");
var login = await fix.LoginAsync(email, password);    // sets fix.Token
fix.OrganizationId = login.Enrollments.First().Id;     // required when the account belongs to several organizations

var key = await fix.ApiKeys.CreateAsync(new ApiKey.CreateRequest { Name = "my-integration" });

// Or with a token obtained elsewhere:
using var session = new FixCore("https://go.fixfiscal.ro", token: jwt, organizationId: organizationId);

fix.Auth and fix.ApiKeys accept only a JWT. The SDK never renews a token: a login token is valid for 7 days, and once it (or any token you supplied) expires, requests fail with 401, so log in again or assign a new fix.Token.

Every controller on the platform is exposed as a property on FixCore (fix.Receipt, fix.FiscalEntity, fix.Item, fix.Tenant, ...). For a controller without a dedicated property, construct its generated client directly: fix.GetApiClient<SaleChannelClient>().

Models and SmartEnums

Requests and responses are the platform's own types from the FIX.Platform.Models package (installed with this one), nested under their entity: Receipt.Emit, Receipt.GetResponse, SaleLine.Emit, PaymentRecord.CreateRequest, ...

Enumerations are SmartEnums: use them like enums, and read the behavior they carry directly from the value.

var method = PaymentMethod.BankCard;                 // assign like an enum member
var parsed = PaymentMethod.FromName("BankCard");     // or TryFromName / FromValue
foreach (var rate in VatRate.List)                   // every member
    Console.WriteLine($"{rate.Name}: {rate.Rate}");  // members carry their data (rate, flags, codes)

They serialize by name ("BankCard"), exactly as the API documents them.

Notes

  • The generated clients (under the FIX.Platform.Client.Generated namespace) are regenerated from the platform's OpenAPI document on every FIX.Platform.Backend build — do not hand-edit them.
  • Failures throw FIX.Platform.Client.Generated.ApiException, carrying the HTTP status code and response body.
Product Compatible and additional computed target framework versions.
.NET net10.0 is compatible.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
1.14.52 0 11/16/2026
1.14.51 0 11/15/2026
1.14.34 100 11/11/2026
Loading failed