Create a product

post https://app.pennylane.com/api/external/v1/products

This endpoint allows you to create a product based on a specific payload. You can even provide your own id.

Responses

Response body

object

product

object

required

created_at

date-time

The time the product has been created

label

string

Product label

description

string

Product description

vat_rate

string

Product VAT rate. A 20% VAT in France is FR_200.

FR_1_05 FR_1_75 FR_09 FR_21 FR_40 FR_55 FR_60 FR_65 FR_85 FR_92 FR_100 FR_130 FR_15_385 FR_196 FR_200 AD_10 AD_45 AD_95 AT_100 AT_130 AT_200 BE_60 BE_120 BE_210 BG_90 BG_200 CH_25 CH_26 CH_37 CH_38 CH_77 CH_81 CY_50 CY_90 CY_190 CZ_100 CZ_120 CZ_150 CZ_210 DE_70 DE_190 DK_250 EE_90 EE_200 EE_220 ES_40 ES_100 ES_210 FI_100 FI_140 FI_240 FI_255 GB_50 GB_200 GR_60 GR_130 GR_240 HR_50 HR_130 HR_250 HU_50 HU_180 HU_270 IE_48 IE_90 IE_135 IE_210 IE_230 IT_40 IT_50 IT_100 IT_220 LT_50 LT_90 LT_210 LU_30 LU_70 LU_80 LU_130 LU_140 LU_160 LU_170 LV_50 LV_120 LV_210 MC_09 MC_21 MC_55 MC_85 MC_100 MC_200 MT_50 MT_70 MT_180 MU_150 NL_90 NL_210 PL_50 PL_80 PL_230 PT_60 PT_130 PT_230 RO_50 RO_90 RO_190 SE_60 SE_120 SE_250 SI_50 SI_95 SI_220 SK_100 SK_200 exempt extracom intracom_21 intracom_55 intracom_85 intracom_100 crossborder FR_100_construction FR_200_construction

unit

string

The kind of unit which applies to the amount

currency

string

Product currency (ISO 4217). Default is EUR.

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 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 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 SOS SRD STD SVC SYP SZL THB TJS TMT TND TOP TRY TTD TWD TZS UAH UGX UYU UZS VEF VND VUV WST XAF XCD XDR XOF XPF YER ZAR ZMK ZMW ZWL

reference

string | null

Product reference

source_id

string

Product identifier (is unique)

updated_at

date-time

The last time the product has been updated

price_before_tax

number

Product price without taxes

price

number

Product price including taxes

substance

string | null

v2_id

integer

The corresponding identifier for this resource in the V2 API.
This field is provided to facilitate migration from V1 to V2 API by allowing mapping
between V1 and V2 identifiers. When transitioning to V2 endpoints, use this value
instead of the V1 id or source_id.

Language

Credentials

OAuth2


xxxxxxxxxx
11
1
curl --request POST \
2
     --url https://app.pennylane.com/api/external/v1/products \
3
     --header 'accept: application/json' \
4
     --header 'content-type: application/json' \
5
     --data '
6
{
7
  "product": {
8
    "vat_rate": "FR_1_05"
9
  }
10
}
11
'


xxxxxxxxxx
17
 
1
{
2
  "product": {
3
    "created_at": "2023-08-30T10:08:08.146343Z",
4
    "label": "Pack 1",
5
    "description": "This is the package level 1",
6
    "vat_rate": "FR_1_05",
7
    "unit": "piece",
8
    "currency": "EUR",
9
    "reference": "REF-453",
10
    "source_id": "0e67fc3c-c632-4feb-ad34-e18ed5fbf66a",
11
    "updated_at": "2023-08-30T10:08:08.146343Z",
12
    "price_before_tax": 10,
13
    "price": 12,
14
    "substance": "string",
15
    "v2_id": 1234
16
  }
17
}

201Product has been created successfully

400Bad Request

401Access token is missing or invalid

403Forbidden

422Unprocessable Entity