Skip to main content
Directo in Begin Directo in Begin Directo API writes each person’s hours and approved absences into Directo, so nobody types them in again. Begin sends them unconfirmed: payroll checks them in Directo and confirms them there.
Directo appears in Settings → Integrations once Begin support has turned it on for your workspace. Your Directo also needs its XML Direct interface, which you order from Directo: one input for absences and one for resources. Ask Directo to allow updates on the key, and to set payroll to read hours from resource documents.

Connect Directo

1

Get the key

A Directo user with SUPER rights opens the employee card the key was made for, then Admin → XML interfaces, and reveals the key.
2

Save it in Begin

Open Settings → Integrations → Directo API, choose Connect, paste the key into XML Direct token and choose Connect.
3

Choose the document numbers

Enter a First document number that Directo will never use for anything else, such as 900000001. Begin numbers its documents upward from it.
4

Map hours and absences

In Field mappings, give each hour type the Directo item code it is paid as, and each absence policy its Directo absence type. Turn on Hours and pay and Absences.
Each person’s export code in Begin must be their employee code in Directo. People without one are left out and counted in the run.

What Directo receives

Each run writes one resource document with the person’s hours and one absence document with their absences, per person and pay period. In the hours document a row is one day and one item code; in the absence document a row is one absence. Running the same month again updates those documents rather than adding new ones. Hours that are no longer in Begin go to Directo as zero.
Directo lets Begin change a document but not delete one, and only until it is confirmed. If an absence Begin already sent is cancelled, Run history names the document: check it in Directo and remove the absence if it is still there. A confirmed document is left as it is, and the run says so.

Check the first result

Run one month from Manual run for a couple of people, then open the documents in Directo before you confirm anything or turn on Sync on a schedule. If you only need a file to import by hand, use Directo (the hours file) instead: it needs no XML Direct.

Next

Run the integration

Choose a month, run it and check the result.

Choose an integration

Compare providers and connection methods.

Still need help?

Contact support

Email the Begin team and we’ll get back to you.

Ask Begin AI

Open the AI assistant and get instant answers based on these docs.