====== Onboarding ====== Target: Registering a new customer in the Peppol network (Access Point and SMP) and ensures that the customer can securely send and receive documents through their Access Point in compliance with OpenPeppol rules. ===== Activities on the ESO9 PEPPOL company’s side ===== ==== Register new customer ==== Register a new customer in the web application https://eso9peppol.cz/register. ==== Register customer’s data into internal application ==== Check user data from previous step and create customer in internal application (name, VAT NO, address, contact e-mail). ==== Contract with ESO9Peppol company ==== Sign contract. ==== Assign Participant ID ==== * Create customer’s Participant ID based on BIS 3-0 rules **or** * Get customer’s Participant ID (customer has Participant ID from different authority) ==== Register customer to selected SMP provider ==== and setup supported document types. * First, register at the test SMP * After successful testing, register at production SMP ==== Register customer to ESO9 PEPPOL Access Point ==== * Generate WebHook secret string and store it in internal application * Generate password to access AP and store it in internal application * Make both informations available to customer ===== Activities on ESO9 customer’s side ===== Supported ESO9 version at least 7.2. ==== Set Up parameters ==== * ''%%AP_URL%%'' - test or production URL, see PublicAPI * ''%%AP_PWD%%'' - password for AP access (length 15) * ''%%WEBHOOK_SECRET%%'' - secret string for my WebHook, see WebHook (length 20) * ''%%CreateDocIDTypDok%%'' - document type ID for creating documents from PEPPOL. All documents imported from PEPPOL will be created with this document type. * ''%%CreateDocIDVzorDok%%'' - document template ID for creating documents from PEPPOL. All documents imported from PEPPOL will be created with this document template. * ''%%CreateDocUserID%%'' - User ID with which the document imported from PEPPOL will be created. ==== Set Up Participant ID ==== Add Participant ID to all bussiness partners with whom the domestic company will exchange documents via the Peppol network. Participant ID is part of Subjekt’s form in ESO9 application. ==== Install WebHook ==== ESO9 provides WebHook as Docker image or Windows IIS web. Installing a webhook in Windows IIS is easier, but it is not suitable for a large number of running applications. On the other hand, installing a webhook into a Docker container is more complicated, but it can be used to serve multiple applications at once. Details… ==== Set up downloader ==== Downloader is the component responsible for downloading a document from the AP and creating a document in the ESO9 application. Downloader is implemented by a stored procedure ''%%spPeppolDocDownloader%%'' and it is an integral part of distribution ESO9 Start. Downloader is called from WebHook under a dedicated user account ''%%peppolDocCreate%%''. Can be called also as a database JOB or just manually. Depends on customer’s requests. The default behavior is to call the Downloader from WebHook, so documents are created in the application automatically and in real time. ==== Set up sender ==== Sender is the component responsible for sending documents from the ESO9 application to the AP. It is an integral part of distribution ESO9 Start and is configured with the application parameters from the first point. ==== Add export page ==== Add export page implements manual sending of a document to the PEPPOL network. page relative URL is: ''%%nastaveni/peppol.htm%%''. URL example: Export Peppol ===== Activities on non-ESO9 customer’s side (REST API) =====