UcmCommonApi 1.21.0

UcmCommonApi

UcmCommonApi is a proprietary SDK for interacting with the UCM system.

Important Notice

This package is proprietary software owned by Trafinoil. It is not open-source and is subject to the terms of the license agreement provided with the package.

Usage

To use this package, you must have explicit permission from Trafinoil. Unauthorized use, reproduction, or distribution of this package is strictly prohibited.

Contact Information

For inquiries about using this package, obtaining a license, or any other questions, please contact Trafinoil directly:

• Website: https://www.trafinoil.cz

Legal

Copyright © 2025 Trafinoil. All rights reserved.

This software is protected by copyright law and international treaties. Unauthorized reproduction or distribution of this software, or any portion of it, may result in severe civil and criminal penalties, and will be prosecuted to the maximum extent possible under the law.

ChangeLog

1.21.0 - 25.05.2026 - BREAKING: UpdateKsefDocumentsRequest: rename CartageGuid → CollectionGuid ([JsonPropertyName("collectionGuid")]), oba CollectionGuid + PremiseGuid nyní required + non-nullable (Guid, ne Guid?). Dispečer-side DS-872 v2: ksef_documents tabulka má nově ukládat všechny tři identifikátory (driver_collection_stop_guid, collection_guid, premise_guid); validace required|uuid|guidExists:svozka|provozovna. 1.20.0 - 22.05.2026 - UpdateKsefDocumentsRequest: odstraněn CollectionDocumentGuid (Filip DS-872 potvrdil, že cdg ukazuje na PDF "písemné informace" = CollectionDocument, NE na driver_svoz_zastavka → nelze použít jako fallback). Přidány optional CartageGuid + PremiseGuid fields, které mohou na server straně sloužit jako fallback lookup (WHERE svoz_id = cartageGuid AND prov_id = premiseGuid) když primary driverCollectionStopGuid v prijata_svozka neexistuje (race condition / emergency-closed scenarios). 1.19.0 - 22.05.2026 - UpdateKsefDocumentsRequest: přidání optional CollectionDocumentGuid fieldu jako fallback identifikátor stop-events pro methodType=1 premises (ručně dispečer-přidané stopy, kde prijata_svozka.guid není D2-generated) 1.18.0 - 18.05.2026 - QueryRequestAsync/RequestAsync: ošetření non-JSON odpovědi (try/catch okolo deserializace v 200-OK větvi, body preview + content-type v chybě) místo neošetřené JsonException 1.1.1 - 04.10.2025 - Přidání GuidEmptyStringToNullConverter pro podporu parsování prázdných stringů jako null pro guid?