Skip to main content
The Export Job must be completed only after all Export Items have been updated. This step communicates the overall result of the export batch to Pleo.

Implementation

See the corresponding how-to article for API usage and step-by-step instructions:

Purpose

  • Finalise Export Job processing.
  • Reflect the aggregated outcome of all Export Items.
  • Enable auditing, visibility, and downstream workflows.

Export Job Status Events

Post an Export Job Event using one of the following outcomes:
ConditionEventAdditional Fields
All Export Items successfulcompleted
Some items failedcompleted_with_errorsfailureReason, failureReasonType
All items failedfailedfailureReason, failureReasonType

failureReasonType Guidance

  • Default value: accounting_system_validation_failure
  • Use specialised values when defined in Integration Specifications.

Implementation Guidance

  • Send the Export Job Event only once processing is fully complete.
  • Ensure all Export Item statuses are final before completing the job.
  • Do not complete jobs prematurely.
Completing the Export Job signals to Pleo that:
  • Processing has finished.
  • Results can be surfaced to users.
  • Follow-up workflows may begin.

Expected Outcome

At the end of this step:
  • The Export Job reflects the true batch outcome.
  • Users can review results in Pleo.
  • The export lifecycle is complete.

Upstream Dependencies

  • Export Job has been claimed (status = in_progress)
  • Fetch Export Item Data (data layer)
  • Bookkeeping method resolved
  • Accounts Mapping – determines which GL accounts are debited and credited
  • Data Mapping – ensures amounts, dates, dimensions, identifiers, and VAT/tax information are recorded correctly
  • Attachment Handling – links receipts and supporting documentation
  • Accounting Periods – assigns entries to the correct accounting period
  • Posting Behaviour – determines whether entries are created as drafts or finalised
  • Export Item status update – updates outcome of Export Item (successful or failed)

What Comes Next?