Ebben a cikkben megtudhatja, hogyan tölthet fel digitális nyugtákat a RetailForce Cloud-ba a FiscalClient segítségével (ha nem fiskalizálással használja), és hogyan szerezhet letöltési linket az ügyfele számára.
Ez a funkció a client 1.2-es verziójától elérhető, és a digitális nyugtákhoz megfelelő offline funkciót is biztosít.
A funkció használatához a Digital Receipt (teljes termék) licencet aktiválni kell az adott client konfigurációjában.
Használat a FiscalClient/FiscalService segítségével
A FiscalClient használata esetén a digitális nyugták átvitelére a következő 2 módszer áll rendelkezésre:
Fájlnév használatával történő módszer
/// <summary>
/// Uploads digital receipt with digital receipt metadata.
/// </summary>
/// <param name="uniqueClientId">The client id of the client where the digital receipt should be uploaded.</param>
/// <param name="filename">The name of the file to be uploaded. The file must exist and must be readable.</param>
/// <param name="receiptMetaData">The metadata of the file.</param>
/// <returns>A unique url to download the file for the customer.</returns>
/// <exception cref="ArgumentNullException">Thrown if parameter <paramref name="uniqueClientId"/> is set to <see cref="Guid.Empty"/>.</exception>
/// <exception cref="ArgumentNullException">Thrown if parameter <paramref name="filename"/> is null or <see cref="string.Empty"/>.</exception>
/// <exception cref="FileNotFoundException">Thrown if given filename is not found.</exception>
/// <exception cref="UnauthorizedAccessException"><paramref name="filename" /> specified a directory.-or- The caller does not have the required permission. </exception>
/// <exception cref="IOException">An I/O error occurred while opening the file. </exception>
public string UploadDigitalReceipt(Guid uniqueClientId, string filename, ReceiptMetaData receiptMetaData)
Ez a funkció lehetővé teszi a digitális nyugta feltöltését a merevlemezen található fájl (fájlnév) segítségével.
Paraméterek
- uniqueClientId: a fiskális ügyfél egyedi ID-je.
- filename: a feltöltendő PDF-fájl neve (az elérési útvonalat is beleértve).
- ReceiptMetaData: a digitális nyugta Metadata-ja.
Visszatérési érték: a megjelenítéshez szükséges URL.
Streaming módszer
/// <summary>
/// Uploads digital receipt with digital receipt metadata.
/// </summary>
/// <param name="uniqueClientId">The client id of the client where the digital receipt should be uploaded.</param>
/// <param name="file">The stream of the file to be uploaded.</param>
/// <param name="receiptMetaData">The metadata of the file.</param>
/// <returns>A unique url to download the file for the customer.</returns>
/// <exception cref="ArgumentNullException">Thrown if parameter <paramref name="uniqueClientId"/> is set to <see cref="Guid.Empty"/>.</exception>
/// <exception cref="ArgumentNullException">Thrown if parameter <paramref name="file"/> is set to null.</exception>
public string UploadDigitalReceipt(Guid uniqueClientId, Stream file, ReceiptMetaData receiptMetaData)
Ez a függvény lehetővé teszi a digitális nyugta feltöltését egy fájlfolyam (vagy több stream) átvitelével.
Paraméterek
- uniqueClientId: az adóügyi ügyfél egyedi ID-je.
- file: a PDF-fájl tartalmát tartalmazó stream (a streamnek a fájl elején kell lennie)
- ReceiptMetaData: a digitális nyugta Metadata-ja
Visszatérési érték: a megjelenítéshez szükséges URL.
Használat a nuget-implementáción keresztül
A Fiskaclient (TrustedFiscalModule) közvetlen implementációjának használata esetén a nuget-en keresztül csak egy FileStream-et használó metódus áll rendelkezésre:
/// <summary>
/// Uploads digital receipt (if proper license exists).
/// </summary>
/// <param name="receiptMetaData">The metadata for the receipt.</param>
/// <param name="file">The pdf file as stream.</param>
/// <returns>An url to request the file in the cloud.</returns>
/// <remarks>If <paramref name="receiptMetaData"/> is set to null, only bookDate is set to Now, other values are not set.</remarks>
/// <exception cref="ArgumentNullException">Thrown if parameter <paramref name="file"/> is set to null.</exception>
public string UploadDigitalReceipt(Stream file, ReceiptMetaData receiptMetaData)
Ezzel a függvénnyel a digitális nyugta feltölthető egy (vagy több) stream átvitelével.
Paraméterek
- file: a PDF-fájl tartalmát tartalmazó stream (a streamnek a fájl elején kell lennie)
- ReceiptMetaData: a digitális nyugta Metadata-ja
Visszatérési érték: a megjelenítéshez szükséges URL.
ReceiptMetaData
A ReceiptMetaData objektum tartalmazza a digitális nyugta Metadata-adatait, amelyek a következő adatokat tartalmazzák:
- DocumentType: a dokumentum típusa (számla, nyugta, befizetés stb.); nem adóügyi dokumentumok esetén használja a [1100] MiscellaneousNonFiscal értéket
- CustomDocumentType: a digitális nyugta opcionális, egyéni dokumentumtípusa (nem adóügyi dokumentumtípus)
- DocumentGuid: a nyugta DocumentGuid-ja (nem tévesztendő össze a fiskalizációs rendszer DocumentGuid-jával). A Cloud ezt használja a nyugta azonosítójának: ugyanazzal a DocumentGuid-dal történő újbóli feltöltés felülírja a korábbi nyugtát. Ha nincs beállítva, a nyugta véletlenszerű azonosítót kap, és nem hivatkozható rá a CancelledDocumentGuid segítségével.
- retailForceReceiptId: a rövid (8 karakteres) egyedi nyugtaazonosító
- DocumentNumber: a dokumentum száma
- DocumentId: a dokumentum egyedi azonosítója
- BookDate: a dokumentum dátuma
- Amount: az utalvány bruttó összege
- Partner: értékesítési dokumentum esetén az ügyfél, egyéb dokumentumok esetén a megfelelő partner (beszállító, ügyfél, ...)
- Felhasználók: a dokumentum felhasználói (ID, caption); a Cloud-ban található „Felhasználó” keresés használja
- ItemIdArray: a nyugtán szereplő tételszámok; a Cloudban található „Tétel” keresés használja
- ItemCodeArray: a bizonylaton szereplő tételkódok (pl. EAN); a Cloudban található „Tétel” keresés használja
- PaymentCardNumberMaskedArray: a fizetések maszkolt kártyaszámai (a kártyaszámokat nem szabad teljes formában elküldeni)
- ProcessId: több nyugtát kapcsol össze; az azonos ProcessId-vel rendelkező nyugtákat a Cloud-ban összekapcsolt nyugtákként jelöli meg, és együtt tekinthetők meg
- CancelledDocumentGuid: törlés esetén a törölt nyugta DocumentGuid-ja. A Cloud ezután a nyugtát töröltként jelöli meg.
Az objektum leírása a Document Object Model dokumentációjában található. (A release letöltési szakaszában).
Ezt a cikket automatikusan lefordították.
Hozzászólások
0 hozzászólás
Hozzászólások írásához jelentkezzen be.