Skip to main content
After all Export Items have been processed and updated, you must complete the Export Job by sending a final status to Pleo. This finalises the export workflow.

​
Prerequisites

Before you begin:

​
Steps

​
1. Determine Final Outcome

Evaluate the results of all Export Items:
ConditionEvent
All items successfulcompleted
Some items failedcompleted_with_errors
Unrecoverable failurefailed

​
2. Build Event Payload

All items successful 
{
  "exportJobId": "JOB_ID",
  "event": "completed"
}
Partial success 
{
  "exportJobId": "JOB_ID",
  "event": "completed_with_errors"
}
Fatal failure 
{
  "exportJobId": "JOB_ID",
  "event": "failed",
  "failureReason": "ERP unavailable",
  "failureReasonType": "service_unreachable"
}

​
3. Send Event

curl -X POST https://api.pleo.io/v3/export-job-events \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "exportJobId": "JOB_ID",
    "event": "completed"
  }'

​
4. Handle Response

if response.success:
    stopRetrying()
else:
    retryOrLogError()
  • Retry on transient failures
  • Ensure the event is sent only once per final state

​
Pleo Web App

Completing the Export Job triggers the user-visible update in Pleo.
  • Export status is shown in the Export queue
  • Users can review failed items and error details
Export Job Completed with Errors
In the message banner at the top of your screen, click the Review errors link to see the reasons why Export Items failed.
Export Job Completed with Errors - View Error

​
Result

After completing this step:
  • Pleo marks the Export Job as completed based on the submitted event (completed, completed_with_errors, or failed)
  • Export Job status is visible in the Export queue
  • Export Item results (success and failure) are surfaced to users
  • Failed items include error details for review and correction
  • No further Export Item updates can be made for this job

​
What Comes Next?

this how-to is part of:
Export Integration Workflow Guide