http://server/dbconnector/api/v1

Header parameters: pkod, lickod parameters required for API use.

The billing API is asynchronous. Submitted requests will be placed in a queue. There is a separate API call to query the processing status. The response are in XML. The queue is processed by a timed processor. New items that are queued during processing are added to the next processing period.

http://server/dbconnector/api/v1/postxml

The aim of the call is to make the module of the Dbconnector of the SUP System, which is based on an externally produced invoicing command in the form of the Outgoing invoices to import XML scheme, accessible on a webpage as well.

 Megjegyzés

The submitting method is asynchronous. Requests submitted in XML will be placed in a queue, the processing status should be questioned later. In case of appropriate server settings, the PDF image of the invoice will be returned to the buyer with the successful processing status.

Parameter (required)
   XML : The ivoicing request (any invoice attachments must be pre-uploaded)

Result
   XML - <Token> : In case of successful submission, the received data should be retained. The result of the processing can be requested with this ID.

CURL.EXE    ^
  -X POST   ^
     http://server:8080/dbconnector/api/v1/postxml ^
  -H pkod:SajatSupPartnerKod  ^
  -H lickod:SajatSupLicKod    ^
  -H "Content-Type: text/html; charset=UTF-8" ^
  --data-ascii @testUpload.xml

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<DbConnectorResponse>
    <Success>true</Success>
    <StatusCode>200</StatusCode>
    <Token>7085BEEC-93B0-4FE1-88BB-F531EDAC38D6</Token>
</DbConnectorResponse>

An attachment can be optionally uploaded for the invoice. The following file formats can be uploaded: JPG, PDF.  If the prepared invoice is in PDF format, the attachments are embedded in a PDF.

Attachments must be uploaded to the server before the invoice XML is submitted. The identifiers (tokens) received in response must be placed in a comma-listed list in <Elojegyzett_Szamlak><Szamlak><Szamla><Csatolmanyok> data tag.

CURL.EXE    ^
  -X POST   ^
     http://server:8080/dbconnector/api/v1/upload ^
  -H pkod:SajatSupPartnerKod  ^
  -H lickod:SajatSupLicKod    ^
  -F file=@testupload.jpg

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<DbConnectorResponse>
    <Success>true</Success>
    <StatusCode>200</StatusCode>
    <Message>File feltöltés sikeres</Message>
    <Token>74cc7200-b9fc-4fd8-a1cf-8942c09afc35</Token>
</DbConnectorResponse>

http://server/dbconnector/api/v1/getstatus

The purpose of this call is to enquire about the processing status of an XML document submitted to the processing queue. To identify a request, a token that is returned in the XML should be used.

In case of successful processing, it returns the number in the SUP system (log | invoice number) as well as the PDF image of the invoice- encoded in base 64 format.

Parameter (required)
   token : The token received when submitting XML.

Result
   XML - <BizonylatAzon> : Identifier of the invoice in SUP system ( acc.group| invoice number).
   XML - <DocumentType>, <DocumentData>   : The PDF file of the completed invoice (with appropriate settings).

CURL.EXE    ^
  -X GET    ^
     http://server:8080/dbconnector/api/v1/getstatus?token=7085BEEC-93B0-4FE1-88BB-F531EDAC38D6  ^
  -H pkod:SajatSupPartnerKod   ^
  -H lickod:SajatSupLicKod

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<DbConnectorResponse>
    <Success>false</Success>
    <StatusCode>290</StatusCode>
    <Message>A tetel feldolgozasra var</Message>  <!-- waiting for processing  --> 
</DbConnectorResponse>

 <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<DbConnectorResponse>
    <Success>true</Success>
    <StatusCode>200</StatusCode>
    <BizonylatAzon>411|KI-0001/22</BizonylatAzon>
</DbConnectorResponse>