Bank accounts3

Bank Establishments1

Billing email templates1

Billing Subscriptions6

Categories5

Category Groups4

Changelogs10

Commercial Documents9

Company1

Customer Invoice Templates1

Customer Invoices24

Customers18

E-Invoices1

Exports6

File Attachments1

Fiscal years1

Journals3

Ledger Accounts4

Ledger Attachments1

Ledger Entries6

Ledger Entry Lines7

Mandates14

Numberings1

PA Registrations1

Products4

Purchase Requests3

Quotes11

Supplier Invoices14

Suppliers6

Transactions11

Trial balance1

Users1

Webhooks5

Purchase Requests

Import a purchase order.

Changed on Nov 3, 2026

Import a purchase order. This will create a purchase request with an existing purchase order attached. The purchase request will be automatically validated.

ℹ️ This endpoint requires the following scope: purchase_requests:all

post/api/external/v2/purchase_requests/imports

Request

Base URL
https://app.pennylane.com
URL
https://app.pennylane.com/api/external/v2/purchase_requests/imports
Auth
OAuth 2
Authorization code: https://app.pennylane.com/oauth/authorize
Token URL: https://app.pennylane.com/oauth/oauth/token scopes: purchase_requests:all

Headers

X-Company-Idstring

Example:12345

Numeric ID of the company to act on. Required when authenticating with a firm token. Ignored when the token is already bound to a company.

Request body

file_attachment_idinteger required

File attachment id. This file attachment must contain the purchase order to import.

reasonstring required

Reason of the purchase request

estimated_delivery_datestring date

Estimated delivery date (ISO 8601)

supplier_idinteger required

Supplier identifier

purchase_order_numberstring required

Purchase order number

currency'EUR' | 'USD' | 'GBP' | 'AED' | 'AFN' | 'ALL' | 'AMD' | 'ANG' | 'AOA' | 'ARS' | 'AUD' | 'AWG' | 'AZN' | 'BAM' | 'BBD' | 'BDT' | 'BGN' | 'BHD' | 'BIF' | 'BMD' | 'BND' | 'BOB' | 'BRL' | 'BSD' | 'BTN' | 'BWP' | 'BYN' | 'BYR' | 'BZD' | 'CAD' | 'CDF' | 'CHE' | 'CHF' | 'CLF' | 'CLP' | 'CNY' | 'COP' | 'CRC' | 'CUC' | 'CUP' | 'CVE' | 'CZK' | 'DJF' | 'DKK' | 'DOP' | 'DZD' | 'EGP' | 'ERN' | 'ETB' | 'FJD' | 'FKP' | 'GEL' | 'GGP' | 'GHS' | 'GIP' | 'GMD' | 'GNF' | 'GTQ' | 'GYD' | 'HKD' | 'HNL' | 'HRK' | 'HTG' | 'HUF' | 'IDR' | 'ILS' | 'IMP' | 'INR' | 'IQD' | 'IRR' | 'ISK' | 'JEP' | 'JMD' | 'JOD' | 'JPY' | 'KES' | 'KGS' | 'KHR' | 'KMF' | 'KPW' | 'KRW' | 'KWD' | 'KYD' | 'KZT' | 'LAK' | 'LBP' | 'LKR' | 'LRD' | 'LSL' | 'LTL' | 'LVL' | 'LYD' | 'MAD' | 'MDL' | 'MGA' | 'MKD' | 'MMK' | 'MNT' | 'MOP' | 'MRO' | 'MRU' | 'MUR' | 'MVR' | 'MWK' | 'MXN' | 'MYR' | 'MZN' | 'NAD' | 'NGN' | 'NIO' | 'NOK' | 'NPR' | 'NZD' | 'OMR' | 'PAB' | 'PEN' | 'PGK' | 'PHP' | 'PKR' | 'PLN' | 'PYG' | 'QAR' | 'RON' | 'RSD' | 'RUB' | 'RWF' | 'SAR' | 'SBD' | 'SCR' | 'SDG' | 'SEK' | 'SGD' | 'SHP' | 'SLL' | 'SLE' | 'SOS' | 'SRD' | 'STD' | 'SVC' | 'SYP' | 'SZL' | 'THB' | 'TJS' | 'TMT' | 'TND' | 'TOP' | 'TRY' | 'TTD' | 'TWD' | 'TZS' | 'UAH' | 'UGX' | 'UYU' | 'UZS' | 'VEF' | 'VES' | 'VND' | 'VUV' | 'WST' | 'XAF' | 'XCD' | 'XDR' | 'XOF' | 'XPF' | 'YER' | 'ZAR' | 'ZMK' | 'ZMW' | 'ZWL'

currency_amount_before_taxstring required

Purchase request currency amount before tax (total value before tax of the purchase request in the currency of the purchase request)

currency_amountstring required

Purchase request currency amount (total value of the purchase request in the currency of the purchase request)

amountstring

Purchase request amount in euros (total value of the purchase request in euros). If the currency is euro, currency_amount and amount are identical.

currency_taxstring required

Purchase request taxable amount (in purchase request currency)

taxstring

Purchase request taxable amount (in euros). If the currency is euro, currency_tax and tax are identical.

Example request

{
  "file_attachment_id": 42,
  "reason": "I need a computer to be able to create purchase requests",
  "estimated_delivery_date": "2023-08-30",
  "supplier_id": 42,
  "purchase_order_number": "PR20230001",
  "currency_amount_before_tax": "100.00",
  "currency_amount": "120.00",
  "amount": "120.00",
  "currency_tax": "20.00",
  "tax": "20.00",
  "delivery_address": {
    "address": "8 rue de la paix",
    "postal_code": "75002",
    "city": "Paris",
    "country_alpha2": "FR"
  },
  "purchase_request_lines": [
    {
      "currency_amount": "120.00",
      "amount": "120.00",
      "currency_tax": "20.00",
      "tax": "20.00",
      "label": "Demo label",
      "quantity": 12,
      "unit_price": "8.34",
      "vat_rate": "FR_200"
    }
  ]
}

Response

The imported Purchase Request

idinteger required

Purchase request identifier

purchase_order_numberstring nullable required

Purchase order number

status'to_be_validated' | 'approved' | 'rejected' | 'invoiced' required

reasonstring required

Reason of the request

estimated_delivery_datestring date nullable required

Estimated delivery date for the purchase request

amountstring string required

currency_amountstring required

Purchase Request currency amount (total value of the purchase request in the currency of the purchase request)

currency_amount_before_taxstring required

Purchase Request currency amount before tax (total value before tax of the purchase request in the currency of the purchase request)

exchange_ratestring required

Purchase request exchange rate (used to convert the purchase request to euros. If the purchase request currency is euro it will be 1.0)

currency_taxstring required

Purchase request taxable amount (in euros. If the currency is euro, currency_amount and amount are identical)

taxstring required

Purchase request taxable amount (in purchase request currency)

created_atstring date-time required

The time the purchase request has been created

updated_atstring date-time required

The last time the purchase request has been updated

Example response

{
  "id": 1,
  "purchase_order_number": "PR20230001",
  "supplier": {
    "id": 2,
    "url": "https://app.pennylane.com/api/external/v2/suppliers/2"
  },
  "delivery_address": {
    "address": "8 rue de la paix",
    "postal_code": "75002",
    "city": "Paris",
    "country_alpha2": "FR"
  },
  "reason": "I need a computer to be able to create purchase requests",
  "estimated_delivery_date": "2023-12-31",
  "amount": "1234.56",
  "currency_amount": "1234.56",
  "currency_amount_before_tax": "1200.23",
  "exchange_rate": "1.0",
  "currency_tax": "34.33",
  "tax": "34.33",
  "purchase_order": {
    "filename": "Bon-de-commande_n°2025-1.pdf",
    "url": "https://www.pennylane.com/Bon-de-commande_n%C2%B02025-1.pdf"
  },
  "linked_invoices": {
    "items": [
      {
        "id": 42,
        "url": "https://app.pennylane.com/api/external/v2/supplier_invoices/42"
      }
    ]
  },
  "created_at": "2023-08-30T10:08:08.146343Z",
  "updated_at": "2023-08-30T10:08:08.146343Z"
}

Changes

Nov 3, 2026871f863307e5 Revision changes
- warning
  added the new VES enum value to the response property for the response status
- info
  added the new optional header request parameter X-Company-Id
- info
  added the new DE_intracom_exempt_BU0233 enum value to the request property //
- info
  added the new ES_intracom_sales_goods enum value to the request property //
- info
  added the new ES_intracom_sales_services enum value to the request property //
- info
  added the new ES_isp_purchases_100 enum value to the request property //
- info
  added the new ES_isp_purchases_210 enum value to the request property //
- info
  added the new ES_isp_sales enum value to the request property //
- info
  added the new ES_suplido enum value to the request property //
- info
  added the new VES enum value to the request property

Operation history