How to Unarchive Vendors

This how-to covers unarchiving a Pleo Vendor whose matching AS vendor is active again. Run this after How to Fetch and Match Vendors found a matching Pleo Vendor in ARCHIVED state for an active AS vendor.

Prerequisites

Before you begin:

You have completed How to Fetch and Match Vendors and found a matching Pleo Vendor in ARCHIVED state
Your integration is authenticated using one of the supported authentication methods
Your integration can call Pleo’s Vendors API endpoints

Scenario

This how-to continues from the How to Fetch and Match Vendors scenario: “Nordic Freight” (EXT-002) is active in the AS, but its matching Pleo Vendor is ARCHIVED.

Steps

1. Unarchive the Vendor

API Endpoint: POST /v1/vendors/{id}:activate Example Pseudo:

if matchedVendor.state == "ARCHIVED":
    activateRequest.externalId = vendor.externalId
    activateRequest.code       = vendor.code
    POST activateRequest to Pleo /v1/vendors/{matchedVendor.id}:activate

The “Nordic Freight” Vendor is unarchived in this example.

OAuth 2.0
API Key

curl -X POST "https://external.staging.pleo.io/v1/vendors/c3d4e5f6-a789-012a-3456-cde78a90babc:activate" \
  -H "Authorization: Bearer <access_token>" \
  -H "Content-Type: application/json;charset=UTF-8" \
  -d '{
        "externalId": "EXT-002",
        "code": "1002"
      }'

curl --request POST \
  -u "pls_1ab2cd3e4f5g6h7a89b012c34de56f78_gabc90:" \
  -H "Accept: application/json;charset=UTF-8" \
  -H "Content-Type: application/json;charset=UTF-8" \
  "https://external.staging.pleo.io/v1/vendors/c3d4e5f6-a789-012a-3456-cde78a90babc:activate" \
  -d '{
        "externalId": "EXT-002",
        "code": "1002"
      }' \
| jq

This endpoint returns 204 No Content on success. The Vendor’s state is now ACTIVE.

What it looks like in Pleo Web App

Select Accounting from the main left-hand navigation.
Select Export from the sub-menu.
Click on a row to open the details panel for that expense.
Select the Vendor drop-down menu and type “Nordic” to search.

“Nordic Freight” is now searchable in the Vendor field on an expense, confirming it is no longer archived.

Vendor dropdown on an expense showing unarchived Nordic Freight

Handling Edge Cases

Vendor is already ACTIVE: treat the call as a no-op rather than an error. This can happen if a previous sync run partially completed. See Handling Edge Cases on How to Create Vendors for partial-failure and unknown-outcome handling, which applies here too.

Result

Vendor	AS Status	Pleo State Before	Action	Final Pleo State
Nordic Freight (EXT-002)	Active	Archived	Unarchived	Active

What Comes Next?

this how-to is part of:

Vendor Sync Workflow Guide

Get Started

Integration Design

Workflow Guides

How-to's

How to Unarchive Vendors

Prerequisites

Scenario

Steps

1. Unarchive the Vendor

What it looks like in Pleo Web App

Handling Edge Cases

Result

What Comes Next?

​Prerequisites

​Scenario

​Steps

​1. Unarchive the Vendor

​What it looks like in Pleo Web App

​Handling Edge Cases

​Result

​What Comes Next?

​Related Reading

Prerequisites

Scenario

Steps

1. Unarchive the Vendor

What it looks like in Pleo Web App

Handling Edge Cases

Result

What Comes Next?

Related Reading