Skip to content
Guide

Search the Guide

Enter a query to search the Guide.

Íslenska
Menu
On this page

Getting started

This page takes an administrator through the first setup of Electronic Documents, from installing the extension until the first document is sent and the first document is received. Each step links to the page that describes it in detail. Follow the order, because the later steps build on the earlier ones.

Overview

This must be in place before you start:

  • Licence. The extension is installed and the company has a licence in the Rue de Net App Center. Access is checked when you open eDoc Setup and the assisted setup.
  • Permissions. Users who post invoices or work with electronic documents have the EDOCS permission set. A user without it can still post an invoice, but no electronic document is created and the user only gets a message about it.
  • Company registration number. The Registration No. field in Company Information is filled in. Electronic Documents uses it to identify your company as the sender and to check that received documents are addressed to it.
  • Access to a message broker. A username and password from InExchange, Unimaze or Deloitte, or eDocs Exchange if files are moved over FTP or through a folder.

How it works

Installing the extension creates data exchange definitions, XSLT templates and posting texts, including STANDARD. Everything else you set up yourself: delivery sites, tax categories, settings, and the link between customers and vendors and the delivery sites.

Note that after the extension is installed, Def. Vendor Posting Text and Invoice Rounding Account are empty and there are no delivery sites, and Run Install Code Manually doesn't fill them in. Assisted setup (step 3) creates them. Otherwise, select STANDARD in Def. Vendor Posting Text and set up delivery sites and tax categories.

Setup in the right order

  1. Install the extension and assign permissions. Assign the EDOCS permission set to everyone who posts sales and service invoices or works with electronic documents. Check: The user can open the eDoc Worksheet.
  2. Register your company identity. Fill in Registration No. and GLN in Company Information. See Master data. Check: Registration No. contains your company's registration number.
  3. Run the assisted setup. Open Assisted Setup and choose Setup Electronic Documents from Rue de Net. There you create delivery sites, test the connection with Test Connection, and choose Invoice Rounding Account, Def. Vendor Posting Text and number series. The setup also creates the tax categories Z (0%), AA (11%) and S (24%). See Assisted setup of Electronic Documents. Check: Read Finished - Summary before you choose Finish. Finish doesn't stop you even if something is missing, so the ✖ marks in the summary tell you what is left.
  4. Complete the setup card. Open eDoc Setup. Set Vendor SSN Field and Customer SSN Field to the field that holds the registration number, for example 25 (Registration No.). The default is field 1 (No.), which only works if your vendor and customer numbers are the registration numbers themselves. Check that Def. Vendor Posting Text is filled in and that tax categories have an exemption reason if the standard is TS236. See eDoc Setup, Tax categories and Posting text setup. Check: The setup card opens without asking about tax categories that are missing exemption reasons.
  5. Link customers to delivery sites. Select Delivery Site on the customer card, or select customers in the customer list and choose Verify & Assign Delivery Site if the delivery site is with Unimaze or InExchange. If the delivery site uses JSON Metadata (REST), customers also need Fallback E-Mail, see JSON metadata. See Verify recipients and Customer eDoc settings. Check: The customer has Delivery Site filled in.
  6. Prepare vendors. Make sure each vendor's registration number is in the field you chose in step 4. Choose Create mappings on the setup card to create item mappings from historic purchase lines. See Master data, Register mappings and Vendor eDoc settings. Check: Mappings shows mappings for your main vendors.
  7. Set up the job queue. Create a job queue entry that runs object number 10041560 and turn on Automatic Processing on the delivery sites the job queue should handle. Without a parameter it fetches, sends and converts documents to BC and updates the Unimaze status. See Job queue entry and Delivery sites. Check: The job queue entry runs without errors and new documents appear in the eDoc Worksheet.
  8. Send and receive the first document. See the next section.

First task

  1. Post a sales invoice for a customer that has a Delivery Site. An electronic document of type Invoice -out is created. See Send an electronic invoice.
  2. Open the eDoc Worksheet and choose Send files for all Delivery Sites, or wait for the job queue. The status becomes Sent OK!.
  3. Choose Fetch files for all Delivery Sites to fetch received documents. Then choose Check Documents. A document without errors gets the status Checked OK!. See Receive a purchase invoice.
  4. Choose Convert to BC Documents. The status becomes Converted to BC Document and a purchase invoice is ready to post. See Convert a document to BC.

If a document isn't created, isn't sent or gets the status Checked with Errors!, see Help and Resolve errors.

Benefits

When you set things up in this order, the first documents go through, and errors that come up later are about single documents, not the basic setup. A skipped step shows up quickly: without your company's registration number nothing can be sent, without the right SSN fields vendors aren't found on received documents, and without a delivery site on the customer no electronic document is created at posting.