Enrich Accounting Entry

Enrich Accounting Entry V2

curl --request POST \
  --url https://external.pleo.io/v2/accounting-entries:enrich \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "receipts": [
    "JVBERi0xLjQKJeLjz9MKMSAwIG9iago8PAovVHlwZSAvQ2F0YWxvZwo+PgplbmRvYmoK",
    "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNk+M9QDwADhgGAWjR9awAAAABJRU5ErkJggg=="
  ],
  "tags": [
    "ef6f10a1-e608-418b-99f1-08150a9ae129",
    "c111b173-d9da-4117-ab70-8f4b8acf496d"
  ]
}
'

import requests

url = "https://external.pleo.io/v2/accounting-entries:enrich"

payload = {
    "receipts": ["JVBERi0xLjQKJeLjz9MKMSAwIG9iago8PAovVHlwZSAvQ2F0YWxvZwo+PgplbmRvYmoK", "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNk+M9QDwADhgGAWjR9awAAAABJRU5ErkJggg=="],
    "tags": ["ef6f10a1-e608-418b-99f1-08150a9ae129", "c111b173-d9da-4117-ab70-8f4b8acf496d"]
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    receipts: [
      'JVBERi0xLjQKJeLjz9MKMSAwIG9iago8PAovVHlwZSAvQ2F0YWxvZwo+PgplbmRvYmoK',
      'iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNk+M9QDwADhgGAWjR9awAAAABJRU5ErkJggg=='
    ],
    tags: ['ef6f10a1-e608-418b-99f1-08150a9ae129', 'c111b173-d9da-4117-ab70-8f4b8acf496d']
  })
};

fetch('https://external.pleo.io/v2/accounting-entries:enrich', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://external.pleo.io/v2/accounting-entries:enrich",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'receipts' => [
        'JVBERi0xLjQKJeLjz9MKMSAwIG9iago8PAovVHlwZSAvQ2F0YWxvZwo+PgplbmRvYmoK',
        'iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNk+M9QDwADhgGAWjR9awAAAABJRU5ErkJggg=='
    ],
    'tags' => [
        'ef6f10a1-e608-418b-99f1-08150a9ae129',
        'c111b173-d9da-4117-ab70-8f4b8acf496d'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://external.pleo.io/v2/accounting-entries:enrich"

	payload := strings.NewReader("{\n  \"receipts\": [\n    \"JVBERi0xLjQKJeLjz9MKMSAwIG9iago8PAovVHlwZSAvQ2F0YWxvZwo+PgplbmRvYmoK\",\n    \"iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNk+M9QDwADhgGAWjR9awAAAABJRU5ErkJggg==\"\n  ],\n  \"tags\": [\n    \"ef6f10a1-e608-418b-99f1-08150a9ae129\",\n    \"c111b173-d9da-4117-ab70-8f4b8acf496d\"\n  ]\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://external.pleo.io/v2/accounting-entries:enrich")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"receipts\": [\n    \"JVBERi0xLjQKJeLjz9MKMSAwIG9iago8PAovVHlwZSAvQ2F0YWxvZwo+PgplbmRvYmoK\",\n    \"iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNk+M9QDwADhgGAWjR9awAAAABJRU5ErkJggg==\"\n  ],\n  \"tags\": [\n    \"ef6f10a1-e608-418b-99f1-08150a9ae129\",\n    \"c111b173-d9da-4117-ab70-8f4b8acf496d\"\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://external.pleo.io/v2/accounting-entries:enrich")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"receipts\": [\n    \"JVBERi0xLjQKJeLjz9MKMSAwIG9iago8PAovVHlwZSAvQ2F0YWxvZwo+PgplbmRvYmoK\",\n    \"iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNk+M9QDwADhgGAWjR9awAAAABJRU5ErkJggg==\"\n  ],\n  \"tags\": [\n    \"ef6f10a1-e608-418b-99f1-08150a9ae129\",\n    \"c111b173-d9da-4117-ab70-8f4b8acf496d\"\n  ]\n}"

response = http.request(request)
puts response.read_body

{
  "data": {
    "receiptStatus": "ADDED_TO_RECEIPT_INBOX"
  }
}

POST

accounting-entries:enrich

Enrich Accounting Entry V2

curl --request POST \
  --url https://external.pleo.io/v2/accounting-entries:enrich \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "receipts": [
    "JVBERi0xLjQKJeLjz9MKMSAwIG9iago8PAovVHlwZSAvQ2F0YWxvZwo+PgplbmRvYmoK",
    "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNk+M9QDwADhgGAWjR9awAAAABJRU5ErkJggg=="
  ],
  "tags": [
    "ef6f10a1-e608-418b-99f1-08150a9ae129",
    "c111b173-d9da-4117-ab70-8f4b8acf496d"
  ]
}
'

import requests

url = "https://external.pleo.io/v2/accounting-entries:enrich"

payload = {
    "receipts": ["JVBERi0xLjQKJeLjz9MKMSAwIG9iago8PAovVHlwZSAvQ2F0YWxvZwo+PgplbmRvYmoK", "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNk+M9QDwADhgGAWjR9awAAAABJRU5ErkJggg=="],
    "tags": ["ef6f10a1-e608-418b-99f1-08150a9ae129", "c111b173-d9da-4117-ab70-8f4b8acf496d"]
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    receipts: [
      'JVBERi0xLjQKJeLjz9MKMSAwIG9iago8PAovVHlwZSAvQ2F0YWxvZwo+PgplbmRvYmoK',
      'iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNk+M9QDwADhgGAWjR9awAAAABJRU5ErkJggg=='
    ],
    tags: ['ef6f10a1-e608-418b-99f1-08150a9ae129', 'c111b173-d9da-4117-ab70-8f4b8acf496d']
  })
};

fetch('https://external.pleo.io/v2/accounting-entries:enrich', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://external.pleo.io/v2/accounting-entries:enrich",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'receipts' => [
        'JVBERi0xLjQKJeLjz9MKMSAwIG9iago8PAovVHlwZSAvQ2F0YWxvZwo+PgplbmRvYmoK',
        'iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNk+M9QDwADhgGAWjR9awAAAABJRU5ErkJggg=='
    ],
    'tags' => [
        'ef6f10a1-e608-418b-99f1-08150a9ae129',
        'c111b173-d9da-4117-ab70-8f4b8acf496d'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://external.pleo.io/v2/accounting-entries:enrich"

	payload := strings.NewReader("{\n  \"receipts\": [\n    \"JVBERi0xLjQKJeLjz9MKMSAwIG9iago8PAovVHlwZSAvQ2F0YWxvZwo+PgplbmRvYmoK\",\n    \"iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNk+M9QDwADhgGAWjR9awAAAABJRU5ErkJggg==\"\n  ],\n  \"tags\": [\n    \"ef6f10a1-e608-418b-99f1-08150a9ae129\",\n    \"c111b173-d9da-4117-ab70-8f4b8acf496d\"\n  ]\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://external.pleo.io/v2/accounting-entries:enrich")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"receipts\": [\n    \"JVBERi0xLjQKJeLjz9MKMSAwIG9iago8PAovVHlwZSAvQ2F0YWxvZwo+PgplbmRvYmoK\",\n    \"iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNk+M9QDwADhgGAWjR9awAAAABJRU5ErkJggg==\"\n  ],\n  \"tags\": [\n    \"ef6f10a1-e608-418b-99f1-08150a9ae129\",\n    \"c111b173-d9da-4117-ab70-8f4b8acf496d\"\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://external.pleo.io/v2/accounting-entries:enrich")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"receipts\": [\n    \"JVBERi0xLjQKJeLjz9MKMSAwIG9iago8PAovVHlwZSAvQ2F0YWxvZwo+PgplbmRvYmoK\",\n    \"iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNk+M9QDwADhgGAWjR9awAAAABJRU5ErkJggg==\"\n  ],\n  \"tags\": [\n    \"ef6f10a1-e608-418b-99f1-08150a9ae129\",\n    \"c111b173-d9da-4117-ab70-8f4b8acf496d\"\n  ]\n}"

response = http.request(request)
puts response.read_body

{
  "data": {
    "receiptStatus": "ADDED_TO_RECEIPT_INBOX"
  }
}

Authorizations

Authorization

string

header

required

JWT Bearer token authentication. Include the token in the Authorization header as: Bearer <token>

Query Parameters

string

Email address of the Pleo user who made the purchase. Used as an optional matching parameter.

performed_at

string

ISO 8601 timestamp of when the purchase was authorised (i.e. when the transaction happened). Either performed_at or settled_at must be provided.

settled_at

string

ISO 8601 timestamp of when the purchase was settled (i.e. when the funds were transferred). Either performed_at or settled_at must be provided.

amount

integer<int64>

required

Transaction amount in minor units (e.g. 1500 represents €15.00).

currency

string

required

ISO 4217 currency code of the transaction (e.g. EUR, GBP, DKK).

card_last_four_digits

string

required

Last four digits of the Pleo card used for the transaction. Used as a matching parameter to identify the correct accounting entry.

merchant_name

string

required

Name of the merchant as it appears on the transaction.

Body

application/json

Request body containing receipts and optional tags

receipts

string[]

required

List of Base64 encoded ByteArray as string

Example:

[
  "JVBERi0xLjQKJeLjz9MKMSAwIG9iago8PAovVHlwZSAvQ2F0YWxvZwo+PgplbmRvYmoK",
  "iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNk+M9QDwADhgGAWjR9awAAAABJRU5ErkJggg=="
]

Response

No matching accounting entry found. The receipt has been stored in the Receipt Inbox for manual resolution.

data

object

The result of an enrichment request.

Show child attributes

Enrichment Workflow Quick Guide Overview

⌘I

ABOUT THE PLEO API

ACCOUNTING ENTRIES API

EXPORT API

TAGS API

ENRICHMENT API

TAX CODE API

APP MARKETPLACE API

EMPLOYEES API

CHART OF ACCOUNTS API

WEBHOOK SUBSCRIPTIONS API

COMPANIES API

VENDORS API

PLEO.IO API (DEPRECATED)

Enrich Accounting Entry

Authorizations

Query Parameters

Body

Response