Documentație · Pentru dezvoltatori

Integrare POS bancar: comanda POS și răspunsul BONOK

Trimite suma către terminal și tratează explicit răspunsul acceptat, respins sau necunoscut înainte de emiterea bonului.

Comanda pentru terminalul bancar

Comanda documentată este disponibilă în ediția PLUS. Valoarea reprezintă suma cu două zecimale, transmisă fără separator zecimal. Exemplu: 1000 reprezintă 10,00 RON.

Exemplu · trimitere 10,00 RON

POS^1000;

Acest articol păstrează protocolul clasic al integrării POS. Pentru metodele de transport și convențiile versiunii utilizate, consultă și ghidul general pentru integratori.

Interpretează răspunsul BONOK

Răspuns	Semnificație	Acțiunea aplicației
`BONOK=1`	Plata a fost acceptată.	Continuă fluxul de emitere a bonului.
`BONOK=0`	Plata nu a fost acceptată.	Anunță operatorul; nu emite bonul ca plată acceptată.
`BONOK=-1`	Rezultat necunoscut sau informație neprimită în timp util.	Cere verificarea tranzacției pe terminal și confirmarea operatorului.

Validarea manuală în interfața de vânzare

Exemplul original permite operatorului să activeze validarea manuală a tranzacției, cu acțiunile Acceptă și Invalidează. La BONOK=1, aplicația continuă automat; la BONOK=0, anunță respingerea; la BONOK=-1, solicită verificarea rezultatului.

În exemplul documentat, așteptarea răspunsului este de cel mult 2–3 minute. Acest interval ilustrează fluxul respectiv; configurează timpul de așteptare conform versiunii și terminalului integrate.

Exemplu original de validare manuală a tranzacției POS — Exemplu original de interfață: confirmarea manuală intervine când rezultatul tranzacției trebuie verificat. Apasă pe imagine pentru dimensiunea originală.

Câmpurile fișierului de răspuns

Prima linie conține BONOK=1, BONOK=0 sau BONOK=-1. Pentru un răspuns de succes, articolul original enumeră următoarele câmpuri:

Structura câmpurilor · valorile sunt furnizate de integrare

BONOK=1
RaspunsTranzactie=
IdComerciant=
IdTerminal=
NrBatch=
NrTranzactie=
CodAutorizare=
Suma=
DataTranzactie=
OraTranzactie=
TipCard=

Continuă cu ghidul potrivit

Pregătire POS

Activarea comunicației și parametrii de la bancă.

Configurare POS

Documentație API

Transport, joburi și răspunsuri pentru integrare.

Vezi documentația

Ai nevoie de ajutor?

Trimite către suport@fiscalnet.ro versiunea FiscalNET, modelul echipamentului, tipul conexiunii și mesajul exact afișat.