Skip to content

Working with B2Brouter

After setup is complete, users can send documents through B2Brouter from Document Dispatch.

Send a document with B2Brouter

  1. Open a supported source document in Business Central.
  2. Start sending from the Document Dispatch FactBox or action group.
  3. Ensure a dispatch profile with output type B2Brouter is used.
  4. In the B2Brouter dialog, review the attachments and preview.
  5. Confirm the send.

If validation is active, the document is validated in the dialog flow. If the file does not meet requirements, sending is stopped and the entry is not sent.

Validation behavior

  • Validation can run automatically in the dialog when Automatic Validation on Dialog is enabled.
  • When validation fails, the document must be corrected and attached again before sending.

JSON payload behavior

When a B2Brouter JSON schema is used, the request body is created from the configured schema lines.

  • Fields configured as Number are written as numeric values.
  • Fields configured as Boolean are written as true/false values.
  • Fields configured as String are written as text values.
  • Optional fields with no value are not included in the JSON output.

For contact delivery settings in JSON mode, transport_type_code and document_type_code are taken from the dispatch profile setup.

Queue processing and delayed flow

B2Brouter entries are processed through the standard queue flow.

  • Immediate sending can be triggered from user actions.
  • Delayed entries are processed in background queue runs.
  • During delayed processing, entries are prepared and then sent in queue batches.

If delayed sending from the FactBox is active and a B2Brouter send returns an error, the queue entry stays available for retry by using delayed processing.

Status behavior

The queue entry status reflects the current process step:

  • Processing Sending after successful transfer start.
  • Sent when the dispatch process is completed.
  • Error if validation or transfer fails.

You can refresh provider feedback from the queue and keep the latest response for review.

B2Brouter actions in the queue

For B2Brouter queue entries, these actions are available:

  • B2Brouter Information: opens the stored B2Brouter response details.
  • Update B2Brouter Status: requests the current status from B2Brouter and updates the stored information.

FactBox status counter

If enabled in module setup, the FactBox can display a B2Brouter counter for the current record.

  • Selecting the counter opens filtered queue entries for that record and output type.

See also