Start a mass dispatch

You start and send a mass dispatch from WorkZone Client. The mass dispatch process consists of the three steps:

  1. Start a mass dispatch
  2. Validate the recipient list
  3. Approve and send a mass dispatch
Prerequisite:
  • You must be assigned the MASSDISPATCH access code to start a mass dispatch process.
  • You must be assigned the MASSDISPATCHSEND access code to be able to send a mass dispatch.
  • You have prepared a Recipient list and a Letter template and saved them on a case. This case is now the dispatch case, where you manage the mass dispatch.

Start a mass dispatch

  1. In WorkZone Client, open the dispatch case that the recipient list and the letter template are saved on.
  2. Click Process > Start Mass Dispatch.
  3. Enter a title of the mass dispatch process in the Title field. The title will be used as the name of the Mass dispatch process and as the title of the email that is sent to the recipient's inbox in e-Boks. By default, the title of the current case is used. When you select a letter, the title changes to the name of the letter automatically. You can change the title.
  4. In the Recipient list field, select the recipient list you want to use. Select the Excel workbook that holds the recipients you want to send the letter to. See Recipient list.
  5. In the Letter field, select the letter template you want to use.
  6. In the Excluded CPR status codes field, select the status codes that you want to exclude from the dispatch, for example, 80, Inactive, emigrated or 90, Inactive, dead.
  7. For example, if you select 80, Inactive, emigrated, recipients with this status code will not receive a letter even if they are included in the recipient list. The validation report will list the recipients that have been excluded from the mass dispatch because of their status code.

  8. Select a dispatch sequence in the Dispatch sequence field. The dispatch sequence must only contain an e-Boks dispatcher as this is the only dispatcher that Mass dispatch supports.
  9. Note: If you see the message "The recipient with id <CPR number> is not subscribing to the material ID <material ID>", you are trying to send the message to a recipient who is not registered as an e-Boks user.
  10. Select a material in the e-Boks material field. The materials on the list are defined by your organization and e-Boks. For example, you may be able to select a material that enables the recipients to reply to the message that you are about to send.
  11. Select the Send to case handler for approval check box, if you want the case handler to review and approve the mass dispatch. Note that the case handler must have the MASSDISPATCHSEND access code to review and approve a mass dispatch. If you leave the check box cleared, you will, as the process owner be the approver of the mass dispatch.
  12. On the Recipient cases tab, select the Add case parties check box if you want to automatically add recipients as parties on recipient cases. Select the role that you want to be assigned to the case parties in the Party role field.
  13. Select the Create recipient cases check box if you want to create a new case for each of the recipients in the mass dispatch and save the letter on the new cases. New cases will not be created for the recipients that have references to existing cases in the Cases sheet (using a foreign key column).
  14. Select the Copy facets from case template check box if you want to copy the facets that are specified on the case template to the recipient cases. If the check box is already selected, it means that the Mass dispatch process has already been configured to copy the facets by default.
  15. Add the required information about the case title, case group, and specify the case template that you want to base the creation of new recipient cases on.

    When recipient cases are created, they will get the case title and the case group that you have specified on the Recipient cases tab. Other information can also be retrieved from the Files.Schema sheet and from the selected case template. In the case template, you can specify additional metadata that you want to be added to the recipient cases, for example a case text or case state.

Case title template

Specify how you want the case titles of the new recipient cases to be created. You can use the aliases from the Contacts.Schema sheet to define the title template. Specify the aliases in curly brackets. The aliases must not include spaces.

{name1} {name2} — {namecode}

This could, for example, result in the case title: Amy Duke — 210206-8621

Note: The title that you specify in the Case title template field overwrites the title that is specified in the Cases sheet.

Case group

Select the case group you want to apply to new recipient cases. Other case data are either taken from the recipient list or from the case template that you select in the Case template field.

Note: The case group that you specify in the Case group field overwrites the case group that is specified in the Cases sheet.

Case template

Select a case template you want to use as the template for new recipient cases. In the case template, you can specify which metadata that you want to be added to new cases by default, for example read and write access, case type, case state, or case text.

See Create a case template.

The case that you use as the case template must have the case group TEMPLATES, Template case group to be available for selection in the Case template field.

  1. On the Recipients tab, select the Add document parties check box if you want to automatically add recipients as parties on the letter documents. Select the role that will be assigned to the case parties in the Party role field.
  2. Enter a title template for the letter document in the Letter title template field. It is required that you fill in this field. You can use the aliases from the Contacts.Schema sheet to define the title template. Specify the aliases in curly brackets in the same way as you did with the case title template, for example, Letter: {name1} {name2} — {namecode}, which results in the letter title: Letter: Amy Duke — 210206-8621.
  3. Optionally, change the prefilled values in the Document type, Document state, and Document group fields. The values will be applied to generated documents.
  4. Optionally, you can specify a date, by which the letter document must be answered, in the Reply deadline field. The deadline will be applied to generated documents.
  1. Click Start to start the mass dispatch. The validation of the recipient list will start.
  2. Click the Processes tab and double-click the process to open it in the preview pane where you can follow the progress and open tasks that are related to the process.
  3. If the validation of the recipient list fails, you will receive a Validate mass dispatch task, see Validate the recipient list. If the validation is successful, the mass dispatch process continues directly to the approval step and you will, as the process owner, receive an Approve mass dispatch task. See Approve and send a mass dispatch.

Validate the recipient list

When you click Start in the Start mass dispatch dialog box, the Mass dispatch process starts validating the recipients in the recipient list. If there are errors in the recipient list, you as the process owner will receive a Validate mass dispatch smarttask/smartmail.

  1. Open the task from the preview pane in WorkZone Client or as a smartmail in Outlook similarly to other processes. The task contains the letter template, the recipient list, and a validation report.
  1. In the smarttask/smartmail, you have the following options:
  • Click Repeat if you want to repeat the validation after you have corrected errors in the recipient list. You can base your corrections on the error descriptions listed in the validation report. You can repeat this step until you are satisfied with the recipient list.
  • Click Cancel to cancel the mass dispatch and delete the validation report from the dispatch case.
  • Click Accept to accept the content of the recipient list and move on to the approval of the mass dispatch.

For information about working with tasks, see Work with tasks in the WorkZone Process User Guide.

Correct errors in the recipient list

  1. In the Validate mass dispatch task, click the validation report to open it.
  2. Preview or open the report. The report lists the recipients that do not fulfill the requirements for the recipient list and an error description next to the recipients.

The report lists all errors in the recipient list. Examples of errors may be:

  • Requirements to the structure of the recipient list are not fulfilled. Check and correct errors in the Excel sheet based on the error messages listed in the validation report. See Recipient list.
  • Contacts in the recipient list do not exist as WorkZone contacts.
  • Some required fields in the recipient list do not have values in WorkZone. In this case, you can either remove Required from the field in the recipient list if it is not required information, or you can add the missing information to the contacts in WorkZone.
  • For a list of errors and possible solutions, see Error handling.

  1. Click Repeat in the Validate mass dispatch task to repeat the validation until you are satisfied with the recipient list.
  2. Click Accept when you are satisfied with the recipient list and ready to proceed with the mass dispatch.

When you click Accept, a sample letter is generated based on the letter template and one recipient from the recipient list. As the process owner you will receive an Approve mass dispatch smarttask/smartmail. See Approve and send a mass dispatch.

Correct errors in the letter template

If there are errors in the letter template, the dispatch will fail and you will receive a Mass dispatch failed task/smartmail with the error.

,

If the letter template does not contain the same fields as the fields that are defined in the recipient list, you can either add or remove the fields from the letter template in Microsoft Word or remove the fields from the recipient list. The fields must match.

  1. Click Done to close the Mass dispatch failed task. The mass dispatch will be canceled.
  2. Correct the errors in the template and start the Mass dispatch process again.

Approve and send a mass dispatch

As the process owner you will receive an Approve mass dispatch task/smartmail when the recipient list is validated successfully and there are no errors in the letter template.

  1. Open the task from the preview pane in WorkZone Client or as a smartmail in Outlook similarly to other processes. The task contains a sample letter , the recipient list, and the letter template.
  2. In the task, you have the following options:
  • Click Approve if you are satisfied with the sample letter and want to start dispatching the letters.
  • Click Repeat if you made corrections to the sample letter or the recipient list. The validation is repeated and you will receive a new approval task with a new sample letter.
  • Click Cancel to cancel the mass dispatch. All documents that have been generated are deleted from the dispatch case.
  • Click Forward if you want to forward the approval to another user.
    Note: If the contact information is updated after you have approved a mass dispatch, the updated contact information will not be merged with the letter. You need to execute the mass dispatch validation process again to use the latest updated information.

About the approval deadline

The deadline for approving a mass dispatch is 25 hours. However, if the mass dispatch is approved after the approval deadline, it will not affect the mass dispatch. The dispatch of the messages will always start when the dispatch is approved, even if the approval deadline is exceeded.

It is currently not possible to change the approval deadline.

What happens after approval?

When you approve the mass dispatch, WorkZone creates the letters and merges data in to the merge fields in the letters. WorkZone sends the letters to e-Boks. When e-Boks has dispatched all the letters, receipts are returned to WorkZone and History documents are generated. The generated letters and history documents are saved on the dispatch case or on individual recipient cases if you have specified existing cases in the recipient list and/or defined that new cases are created based on the options on the Recipient cases tab in the Start mass dispatch dialog box.

Note: If e-Boks returns an error in the receipt, the error will be handled according to the same rules as configured for SmartPost. See e-Boks errors in the WorkZone Process Administrator Guide.

Save letters on the dispatch case

If you do not specify a recipient case for each of the recipients in the recipient list, the letters will be saved on the dispatch case together with a Mass dispatch history document for the entire dispatch and history documents for each of the dispatches. The individual history document is saved as a supplementary document on the letter document. See History documents.

Save letters on recipient cases

In the Cases sheet in the recipient list, you can specify a recipient case for each of the recipients or you can specify individual field values for case creation. Creation of new cases requires that you have you have selected the Create recipient cases check box and have filled in the options on the Recipient cases tab in the Start mass dispatch dialog box, see the steps 10-11.

Depending on how the case sheet in recipient list is defined and your settings on the Recipient cases tab when you started the mass dispatch, the following happens:

  • If there is no case specified in the recipient list, and you have selected the Create recipient cases check box and specified the options for new recipient cases on the Recipient cases tab, the letters and history documents will be saved on newly created cases. See the steps 10-11 under Start a mass dispatch.
  • If a case is specified for each recipient in the recipient list and the cases exist, the letters and history documents will be saved on the specified cases. See Cases sheet.
  • If a case is specified but it does not exist in WorkZone, the validation will generate an error for the recipient which will be shown in the validation report.

If you have selected an e-Boks material that enables recipients to reply to a letter that was sent with mass dispatch (see Start a mass dispatch step 8), the reply will be saved on the same recipient case as the letter.

Letter date

The date on which the letter document is saved in WorkZone is inserted as letter date in the Letter date field on the document in WorkZone.

History documents

When a mass dispatch process is complete, a history document is generated and saved on the dispatch case. The history document provides a summary of the actions that were executed during the mass dispatch process, who executed them and when. This history document is similar to history documents for other process types.

Example: A history document for the complete mass dispatch in PDF format.

In addition to the history document, WorkZone generates history documents in CSV format. The CSV file is generated for the completed dispatch and lists all the recipients with information about the individual dispatches. Another CSV file is generated for each individual dispatch, which only shows information about the current dispatch.

You can open the history documents in Excel to view information about the dispatches. If needed, you can save the CSV file as an Excel workbook to process it further in Excel.

Example: A history document for the complete mass dispatch in CSV format.

Example: A history document for an individual mass dispatch in CSV format.

The history documents in CSV format contain the following information:

Field Description
RecipientCode The ID of the recipient, for example a CPR or CVR number.
EboksSubscriber If the value is True, the recipient is registered as a Digital Post user.
RecordKey_Value The document number of the letter that was sent to the recipient.
ExternalId

The external ID, which is used to track the delivery of the dispatch.

If the message is sent through e-Boks and the field contains an ID, it means that the dispatch is completed and that e-Boks has acknowledged the receipt of the message.

Note: You cannot use the external ID to track delivery of a dispatch to NgDP. In this release, the field only applies directly to e-Boks. The format of the message_id is different in NgDP.
ShipmentDate

The dispatch date and time of the letter.

ReceiptDate The date and time for when e-Boks received the letter and generated a receipt.

ShipmentState

Shows the status of the dispatch that was sent to each recipient. If the dispatch was successful, the status will be Completed. If it has failed, an error code and a description will be shown in the Dispatch Error field.

The default value in the ShipmentDate field is Not specified. The value only changes if the dispatch to the recipient is started. If the dispatch is not started, the value in the ShipmentState field remains Not specified. If the dispatch to a recipient has not been started, it may be because the recipient is not subscribing to Digital Post, or the recipient is subscribing to Digital Post, but an error occurred before the dispatch was started.

See the Digital Post subscription status for a recipient in the EboksSubscriber field.

ShipmentError

An error code and a description will be shown next to each recipient who did not receive the letter.

LetterTitle

The title of the dispatched letter.

CaseNumber

The case number of the case that the letter was saved on. The history document will show the case number of the dispatch case if you have decided to save all letters on this case. If you have decided to create recipient cases, the history document shows the case numbers of the recipient cases.

Save letters on the dispatch case

If you have decided to save all the generated letters on the dispatch case, the history document for each dispatch will be saved as a supplementary document on the letter as shown below. The history document for the entire dispatch is also saved on the dispatch case.

Save letters on recipient cases

If you have decided to save the generated letters on individual recipient cases, the history document for each dispatch is saved on the recipient case as a supplementary document to the letter. The history document for the entire dispatch is saved on the dispatch case.