Basic Rules XML Exchange

HTTP, HTTPS XML accounting system exchange and A-TMS

Transmission of orders in XML format can be configured in the accounting system, like automatically sending requests every few minutes, or XML order files can be loaded manually by importing XML orders in the application.

Accounting system sends XML request by schedule

Correctly formatted XML file, containing ApiKey and ApiSecret. The optimal exchange interval is 5-20 minutes.

A-TMS performs processing and returns the answer

XML with the result of the exchange: "OK" on success, "ERROR" or a detailed description on error.

Accounting system receives data and exchange status

If there is no "OK" response, the request should be repeated on schedule. Orders with the answer "OK" should be marked as successfully transferred, and should not retransmitted.

HTTPS Requests

For a request you need to send to the address
https://atmsapi.alfasoft.by/v2/DataExchange/xml/[SERVICE_NAME]
(See. SPECIFIC REQUESTS) POST request with XML data in the request body.
If you cannot use HTTPS, you can use the same address via HTTP, but the data will not be secured during transmission.

Request XML file format

Tag <Body> can be an arbitrary tag, if required by the accounting system, it name is ignored.
Unknown tags will be ignored. APIKey & APISecret can be obtained by contacting A-TMS support team.
[email protected]

<?xml version="1.0" encoding="utf-8" ?> 
<Body>
  <APIKey>QWERTYUIOP</APIKey>
  <APISecret>ASDFGHJKL</APISecret>
  <!-- HERE XML REQUEST DATA, See DESCRIPTION OF SPECIFIC REQUESTS -->
</Body>

XML file response format

<?xml version="1.0" encoding="utf-8" ?> 
<Body>
  <APIKey>QWERTYUIOP</APIKey> 
  <!-- DETAILS OF ANSWER, FOR EXAMPLE ON ORDERS -->
</Body>