Warehouse Management Interface WMS Direct – enter data only once and directly at the point of origin

Users of Directo business software who deal with warehouse management and production can simplify and automate their workflows by using the new interface WMS Direct.

WMS Direct is a new standard interface in Directo business software for managing logistics and warehouse documents with external WMS solutions (WMS = Warehouse Management System). Using this powerful new interface allows you to handle various warehouse processes completely paperless in an external application (goods receipt, order picking, inventories, production, etc.). With WMS Direct, you can do this quickly, easily, and securely. In short, it saves your time and minimizes the risk of errors.

WMS Direct features:

1. Goods receipt – quickly and securely enter data for incoming goods using a scanner (scanners are not included in the WMS Direct monthly fee), which automatically posts the information to the Receipt document in Directo.
2. Goods dispatch – quickly and accurately enter data for outgoing goods, automatically generating the necessary information in the Delivery document in Directo. You can also initiate the creation and confirmation of invoices for already dispatched but unbilled goods.
3. Inventory – quickly and safely correct errors, eliminate shortages, and perform stocktaking using scanners.
4. Write-offs – allows marking defective products in real time, sending information from the warehouse or production directly to Directo.
5. Inter-warehouse movements – convenient, fast, and error-free transfer of goods between warehouses.
6. Ability to develop scanner solutions with Directo production module documents.
7. And many more possibilities to automate your warehouse data management.

In summary, WMS Direct means that warehouse-related data is always entered only once, directly at the point and time of origin.

The WMS Direct interface costs €199/month (excluding VAT). See the price list. The number of transactions and devices accessing the interface is not limited per monthly package.
NB! This amount only covers the use of the WMS Direct solution in Directo software; necessary scanners and other hardware are additional (not a service provided by Directo).

WMS Direct is developed for seamless cooperation with WMS solutions, and users do not need to worry about obsolescence or changes due to technological evolution, as all updates are included in the monthly fee. Installation costs are also included in the monthly fee.

WMS Direct can be used with any warehouse management system if the service provider is willing to develop their software to allow integration with Directo. To order the service, contact us, and we will help you start integrating Directo with your current WMS software or recommend reliable WMS providers we have worked with, who already have the necessary developments for using the WMS Direct interface.

Some WMS service providers with experience in WMS Direct:

• VTMF
  • Alo Toom
  • +372 501 8161
  • alo@vtmf.ee
  • general email: wmsterminal@vtmf.ee
  • #scanner solution
• RIS
  • Raino Einroos
  • +372 5015625
  • raino@ris.ee
  • general email: ris@ris.ee
  • #scanner solution
• Tovacom
  • Jüri Vau
  • +372 5066007
  • jyri.vau@tovacom.com
  • #warehouse service

2 - Create receipt based on purchase order number, and create receipt if no purchase order exists
4 - Rows can be added to delivery only if the item exists in the original delivery

The interface assumes that documents are created in Directo. If a document is created via the interface, all required information (account, objects, projects, etc.) must be provided, as the interface cannot behave like the Directo UI. The interface is standard, i.e., uniform for all clients, and all developments are the same for all clients. Output interfaces show all records, and restrictions can be applied using query filters. To reduce data volume, it is necessary to use the TimeStamp (ts) filter.

Compared to usual xmlcore interfaces, WMS Direct uses a new common endpoint. Accordingly, there are some differences to consider.

Access endpoint (Base URL): https://login.directo.ee/xmlcore/wmsd/xmlcore.asp
Access requires a token. Finding the token. The token replaces the older appkey and database name method. The token must be sent via POST in the variable TOKEN (similar to an HTML form submission) to the URL to get results. Incorrect or incorrectly sent tokens return <result type=“5” desc=“Unauthorized”/>

If the TOKEN variable is not used, the response is <err>token required</err>

CURL example

curl --location 'https://login.directo.ee/xmlcore/wmsd/xmlcore.asp' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'token=••••••' \
--data-urlencode 'get=1' \
--data-urlencode 'what=xxxxx' \
--data-urlencode 'ts=xx.xx.xxxx'

To find the interface XML key:
1. Log in to Directo with a user having SUPER rights
2. Open the employee card 'XML'

3. Go to the Admin tab

4. Go to the XML interfaces section
5. On the line WMS Direct click the button to view the key

Test web interface: https://login.directo.ee/xmlcore/wmsd/webupload.html

Output and Input for Postman can be downloaded here and then imported as a Postman Collection for testing.

Schema: https://login.directo.ee/xmlcore/wmsd/ws_artiklid.xsd
what=item
get=1
Filter “class”,“code”,“type”,“barcode”,“supplier”,“supplieritem”,“closed”,“ts”

Schema: https://login.directo.ee/xmlcore/wmsd/xml_IN_artiklid.xsd
what=item
put=1

Schema: https://login.directo.ee/xmlcore/wmsd/ws_artikliklassid.xsd
what=itemclass
get=1
Filter “code”,“master”

For entering info into batch/sn additional fields for a specific article batch. Batch must already exist. Do not use field qty!!!
Schema: https://login.directo.ee/xmlcore/wmsd/xml_IN_sn_lisavaljad.xsd
what=sndatafield
put=1

For retrieving batch/sn additional field info by batch/sn and article code Schema: https://login.directo.ee/xmlcore/wmsd/ws_sn_lisavaljad.xsd
what=sndatafield
get=1

Filter: “code”,“class”,“sn”

Needed to get batch/sn structure info

Schema: https://login.directo.ee/xmlcore/wmsd/ws_sn_lisavalja_klassid.xsd
what=sndatafieldclass
get=1
Filter “code”,“class”

type explanation: 1=number; 3=time; 4=option (See also: Lisaväljad)

Schema: https://login.directo.ee/xmlcore/wmsd/ws_retseptid.xsd
what=recipe
get=1
Filter “code”,“ts”

Only outputs. Can query stock by TimeStamp using ts filter. Using ts filter shows also items whose quantity changed to zero during the period. Without ts, only quantities greater than zero are shown. First time, load all stock without using ts filter!

Schema: https://login.directo.ee/xmlcore/wmsd/ws_laoseis.xsd
what=stocklevel
get=1
Filter “code”,“stock”,“ts”

Note:

• Shelves must be mandatory in the database per WarehouseId
• Shows only actual stock
• If Projects are used, also shows stock by Shelf and Project

Schema: https://login.directo.ee/xmlcore/wmsd/ws_laoseis_riiul.xsd
what=shelfstocklevel
get=1
Filter “code”,“stock”,“shelf”,“ts”

Article history is intended for viewing the movement history (in-out movements) of an item.

Schema: https://login.directo.ee/xmlcore/wmsd/ws_artikli_ajalugu.xsd
what=itemhistoryrow
get=1
Filter “code”,“stock”,“type”,“date1”,“date2”

Schema: https://login.directo.ee/xmlcore/wmsd/ws_laod.xsd
what=stock
get=1
Filter “code”,“closed”

https://login.directo.ee/xmlcore/wmsd/ws_kliendid.xsd
what=customer
get=1
Filter “code”,“loyaltycard”,“regno”,“email”,“phone”,“closed”,“ts”,“class”

https://login.directo.ee/xmlcore/wmsd/ws_hankijad.xsd
what=supplier
get=1
Filter “code”,“class”,“regno”,“email”,“type”,“closed”,“ts”

Schema: https://login.directo.ee/xmlcore/wmsd/ws_kasutajad.xsd
what=user
get=1
Filter “code”,“internalcode”,“idnumber”,“closed”,“email”,“ts”

Schema: https://login.directo.ee/xmlcore/wmsd/ws_objektid.xsd
what=object
get=1
Filter “code”,“master”,“type”,“level”,“ts”

Schema: https://login.directo.ee/xmlcore/wmsd/ws_projektid.xsd
what=project
get=1
Filter “code”,“customer”,“supplier”,“orderer”,“contract”,“closed”,“ts”

Schema: https://login.directo.ee/xmlcore/wmsd/ws_riiulid.xsd
what=shelf
get=1
Filter “stock”

Schema: https://login.directo.ee/xmlcore/wmsd/ws_tookeskused.xsd
what=workcenter
get=1
Filter “code”

Sales order documents are informative and output-only.

Schema: https://login.directo.ee/xmlcore/wmsd/ws_tellimused.xsd
what=order
get=1

Warehouse delivery statuses need to be set up (example of use)

Schema: https://login.directo.ee/xmlcore/wmsd/ws_lahetused.xsd
what=delivery
get=1
Filter “number”,“ordernumber”,“customercode”,“status”,“stock”,“confirmed”,“ts”

In the delivery interface, existing delivery documents can be modified.
Schema: https://login.directo.ee/xmlcore/wmsd/xml_IN_lahetused.xsd
what=delivery
put=1

• When using serial numbers, the interface must initially “split” the row, i.e., assign a line number to the existing item; the interface checks the relation to the old row
  • If multiple rows with the same rn are sent, both are saved: <rows> <row item=“8000-5669” rn=“2” qty=“1.000” serialnumber=“ZZZ”/> <row item=“8000-5669” rn=“2” qty=“1.000” serialnumber=“AAA”/> </rows> Original row is deleted!
• To change status, only the document header can be sent without rows
• If the delivery document is deleted and the interface attempts to save, error “Not Found” and type=11 occurs
• When confirming delivery with confirm=2, an invoice is also created; the response returns the invoice number

The delivery number locates the order and triggers the invoice creation procedure for all delivered but unbilled items. The interface returns the created invoice number.
In delivery input, confirm=2 means confirm and create confirmed invoice (not direct invoice!).

If a delivery needs to be locked so that the document cannot be modified in Directo while the WMS system is processing it, statuses and Directo setting “Delivery statuses that lock the delivery” must be used.

The receipt interface is for creating Receipt documents based on Purchase Orders. It is recommended to post the entire document at once to avoid complexity, though posting line by line is possible.

Schema: https://login.directo.ee/xmlcore/wmsd/ws_sissetulekud.xsd
what=stockreceipt
get=1
Filter “number”,“date1”,“date2”,“supplier”,“confirmed”,“status”,“ts”,“stock”

The receipt interface allows modification of existing documents. To create a new document, the relation to the purchase order must be posted exactly (see Exceptions).
Schema: https://login.directo.ee/xmlcore/wmsd/xml_IN_sissetulekud.xsd
what=stockreceipt
put=1

• If same row number (rn) is sent, it overwrites. Applies also to SN
• If original document has one product per row but multiple batches arrive, send multiple rows with same rn; both rows are saved as in example:
  • <rows> <row item=“8000-5669” rn=“2” qty=“1.000” serialnumber=“ZZZ”/> <row item=“8000-5669” rn=“2” qty=“1.000” serialnumber=“AAA”/> </rows> Original row deleted
• Interface does not check if product is SN-tracked
• Adding/modifying receipt rows:
  • omit row number for new rows
  • include row number for existing rows; interface checks relation to old row
• If a receipt exists in Directo, all fields received, even if not modified, must be included
• Fields required by system if missing:
  • Supplier name (from supplier card)
  • Warehouse (from transport parameter, default stock)
  • Currency (from transport parameter or EUR)
  • Currency rate
  • Account (from transport parameter ladu_sis_kreedit)
  • Country (from supplier card)
  • Transaction type (from supplier card)
  • Delivery method (from supplier card)
  • Payment term (from supplier card)
• To create a new receipt linked to a purchase order, header must include PO number and rows must reference correct PO line number - orn = purchase order line
• PO number in receipt header must not be repeated in rows; rows may reference other POs (see example)

  • <?xml version="1.0" encoding="utf-8"?>
    <stockreceipts>
      <stockreceipt number="100001" supplier="0001" suppliername="Directo OÜ" stock="TL1" user="SUPER" purchaseorder="100001">
        <rows>
          <row item="0001" qty="10" orn="1" />
          <row item="0002" qty="10" purchaseorder="100002" orn="1" />
        </rows>
      </stockreceipt>
    </stockreceipts>

To perform inventory:

• Create inventory documents in Directo without rows (recommended)
• Allocate warehouses once counting is finished
• If using multiple scanners:
  • Create chain main document with no items
  • Create inventory documents for one chain
  • Add comment for document use

NB! If inventory document number is missing, interface creates a new document!

Schema: https://login.directo.ee/xmlcore/wmsd/ws_inventuurid.xsd
what=taking
get=1
Filter “number”,“chain”,“stock”,“confirmed”,“ts”

Interface allows adding and modifying existing inventory documents.
Schema: https://login.directo.ee/xmlcore/wmsd/xml_IN_inventuurid.xsd
what=taking
put=1

• If document missing, interface creates new
• To delete a row, add delete=1; row and item accuracy required

Before inventory:

• Create document in Directo (header only). Recommended to make inventory chain main document in Directo but not mandatory
• No warehouse split if quantities sent via interface
• Always send with row number (row number is ID!)
• Document must be confirmed in Directo and warehouse split done

Movement interfaces can be used for transfers between warehouses, rearrangement within shelves (shelf-based inventory)

Directo displays status info on movement document; status field not in schema

Status field in Directo

Field parentmovement
Used when one movement is part of a series of sequential movements. Links each movement to its original or previous movement (“parent”).

Allows:

• tracking entire chain from start (e.g., original withdrawal or receipt)
• identifying warehouse or inventory at start
• linking related movements for reporting or traceability

Example: Item moved from warehouse (movement A) to intermediate (movement B) to final destination (movement C)

• B parentmovement points to A
• C parentmovement points to B

This allows system (or API) to trace back to original movement.

Field optional for simple movements; important for complex or multi-step movements.

Can modify and add movement documents.
Schema https://login.directo.ee/xmlcore/wmsd/xml_IN_liikumised.xsd
what=movement
put=1

• If existing number provided, update occurs
• If movement number not in Directo, new document created
• External ID can be used for new document; system tries to create document with series “DOK” or configured series. Avoid using external ID for creation!!!
• Fields qty and receivedqty mandatory and must be equal

To lock a movement document during WMS processing, statuses and Directo setting “Warehouse movement statuses that lock the movement” must be used.

Schema https://login.directo.ee/xmlcore/wmsd/ws_liikumised.xsd
what=movement
get=1
Filter “number”,“fromstock”,“tostock”,“confirmed”,“ts”

Schema: https://login.directo.ee/xmlcore/wmsd/ws_tootmised.xsd
what=production
get=1
Filter “number”,“productiondate”,“status”,“kinnitatud”,“ts”

Can modify and add production documents.
Schema: https://login.directo.ee/xmlcore/wmsd/xml_IN_tootmised.xsd
what=production
put=1

Schema https://login.directo.ee/xmlcore/wmsd/ws_otellimused.xsd
what=purchaseorder
get=1
Filter “number”,“date1”,“date2”,“supplier”,“confirmed”,“status”,“type”,“ts”,“stock”

To create receipt from purchase order, post exactly same data and ensure receipt references PO lines!

Schema: https://login.directo.ee/xmlcore/wmsd/ws_mahakandmised.xsd
what=writeoff
get=1
Filter “number”,“status”,“project”,“stock”,“ts”

Add and modify documents. See also projektid
Schema: https://login.directo.ee/xmlcore/wmsd/xml_IN_mahakandmised.xsd
what=writeoff
put=1

• Row account taken from Article class WRITE-OFF ACCOUNT

Schema https://login.directo.ee/xmlcore/wmsd/ws_arved.xsd
what=invoice
get=1
Filter “number”,“customercode”,“transactiondate”,“date1”,“date2”,“ts”,“status”

Add and modify documents.
https://login.directo.ee/xmlcore/wmsd/xml_IN_arved.xsd
what=invoice
put=1

Default parameters not required.

Schema: https://login.directo.ee/xmlcore/wmsd/ws_tagastused.xsd
what=stockreturn
get=1
Filter number, customercode, status, project, stock, confirmed, ts

Create and modify documents.
Schema: https://login.directo.ee/xmlcore/wmsd/xml_IN_tagastused.xsd
what=stockreturn
put=1

• Input creates new document if no return exists with given number
• If return exists: header overwritten, rows deleted and re-added
• If posting confirm=1, document confirmed and cannot be changed
• see also projektid

Interface outputs information about all deletions in Directo!
Schema: https://login.directo.ee/xmlcore/wmsd/ws_kustutamised.xsd
what=delete
get=1
Filters: document, ts

Document filter explanations:

type=“0” means success