Implementering af dokumentannullering (void)

For at implementere en proces til annullering (void) af et dokument skal du gøre følgende:

I første omgang foregår processen på samme måde som ved bogføring af en almindelig kvittering. Du kan finde dokumentationen for denne proces under Grundlæggende dokumentoverførselsproces.

For at markere et dokument som et ugyldigt (eller annulleret) dokument (obligatorisk indstilling i flere lande) skal du indstille følgende egenskaber.

Du finder disse egenskaber i dokumentobjektet (RetailForce.Fiscalisation.Model.Document.Document)

• Indstil egenskaben cancellationDocument = true
• Tilføj en dokumentreference med egenskaben DocumentReference
• Tilbagestil dokumentet (sæt alle værdier til negative) i forhold til det annullerede dokument (det dokument, du ønsker at annullere). Det betyder, at hvis det dokument, der skal annulleres, har en omsætning på 20 EUR, har annulleringsdokumentet en omsætning på -20 EUR.

Eksempel på C#-kode:

public Document CancelDocument(TrustedFiscalModule fiscalModule, Document documentToCancel, string storeNumber, string terminalNumber)
        {
            // check parameter
            if (fiscalModule == null) throw new ArgumentNullException(nameof(fiscalModule));
            if (documentToCancel == null) throw new ArgumentNullException(nameof(documentToCancel));

            // revert all values of the document (can also be done by pos software)
            Document cancelDocument = fiscalModule.RevertDocument(documentToCancel);
            // set CancellationDocument property to true
            cancelDocument.CancellationDocument = true;
            // now set document cancellation reference
            cancelDocument.DocumentReference = new DocumentReference()
            {
                DocumentType = DocumentType.Receipt,
                DocumentBookDate = documentToCancel.BookDate,
                DocumentId = documentToCancel.DocumentId,
                DocumentGuid = documentToCancel.DocumentGuid, // not necessary
                ReferenceType = ReferenceType.Cancellation,
                DocumentNumber = documentToCancel.DocumentNumber,
                FiscalDocumentNumber = documentToCancel.FiscalDocumentNumber,
                StoreNumber = storeNumber,
                TerminalNumber = terminalNumber
            };
            cancelDocument.BookDate = DateTime.Now;
            cancelDocument.DocumentGuid = Guid.NewGuid();
            cancelDocument.DocumentId = "NEWID";
            cancelDocument.DocumentNumber = "NEWNUMBER";

            return cancelDocument;
        }

For detaljerede oplysninger om dokumentobjektmodulet henvises til dokumentationen om dokumentobjektmodellen.

Denne artikel er oversat automatisk.