Docs
Product Repository APIProduct

Create one or multiple local products for a shop

Security groups:Local Product Creators
POST
/shops/{shopId}/products/local

Creates one or multiple local products for this shop. Returns an error if any productId in the payload already exists in this shop.

Authorization

bearerAuth
AuthorizationBearer <token>

In: header

Path Parameters

shopId*integer

The shop ID.

Formatint64
Range1 <= value

Query Parameters

eligibleApplications?array<>

Validate this product against the listed eClear applications. Each application has a defined set of required fields; if all required fields are present, the product is tagged for that application. Tags appear in applicationTags on the product response.

Request Body

application/json

The productId must be unique within this shop. Each productId is a key in the request body map. For example, to create products myId1 and myId2:

{
  "myId1": {
    "languageAttributes": {...},
    "customsCodes": {...}
  },
  "myId2": {
    "languageAttributes": {...},
    "customsCodes": {...}
  }
}

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/shops/5632/products/local" \  -H "Content-Type: application/json" \  -d '{    "tablet_ab103": {      "languageAttributes": {        "de": {          "productName": "Samsung Galaxy Tab S7 FE, 12,4 Zoll, 64 GB interner Speicher,  4 GB RAM, Wi-Fi, Android Tablet inklusive S pen, Mystic Black\\n",          "productDescription": "Genieße die brillanten Farben des 31,50 cm / 12,4-Zoll-Displays*  des Galaxy Tab S7 FE Wi-Fi. Der lebendige Bildschirm lässt Details  erstrahlen, und das Kinoerlebnis wird durch den unglaublichen Sound  by AKG verstärkt. Ausgestattet mit einem leistungsstarken Snapdragon  750G Chipset sorgt das Galaxy Tab S7 FE Wi-Fi für flüssiges und  schnelles Streaming und Gaming. Du kannst mühelos Multitasking betreiben  und bis zu drei Apps auf einmal starten Stunde um Stunde vergeht, bevor  du den 10.090 mAh-Akku** (typisch) aufladen musst. Beim Anschauen von  Videos hält er bis zu 13 Stunden durch, sodass du genug Zeit für einen  Serienmarathon hast. Der mitgelieferte S Pen mit niedriger Latenz bietet  ein weiches Schreibgefühl. Mehr: In Echtzeit wandelt er Hand-in  Druckschrift und du kannst Text einfach bearbeiten, dann legst du ihn  an der Magnethalterungab, sodass er sich selbst auflädt. Tauche in die  Farbpracht des 31, 50 cm / 12, 4 Displays* des Galaxy Tab S7 FE Wi-Fi |  Tab S7 FE 5G ein. Erlebe aufregende Film-Momente mit Sound by AKG und  freue dich auf ein farbenfrohes Display, das jede Menge Details förmlich  zum Leben erweckt. Die Dual-Lautsprecher und Dolby Atmos können außerdem  für einen raumfüllenden Surround Sound sorgen, sodass du das Gefühl hast,  mitten im Geschehen zu sein.\\n"        },        "en": {          "productName": "Samsung Galaxy Tab S7 Fe, 12.4 Inch, 64 GB Internal Memory, 4 GB RAM,  Wi-Fi, Android Tablet including S Pen, Mystic Black\\n",          "productDescription": "Enjoy the brilliant colours of the Galaxy Tab S7 FE Wi-Fi  12.4 inch / 31.50 cm display. The vivid screen lets details  shine and the cinema experience is enhanced by the incredible  sound by AKG Equipped with a powerful Snapdragon 750G chip set,  the Galaxy Tab S7 FE Wi-Fi ensures smooth and fast streaming and  gaming. You can effortlessly multitask and launch up to three  apps at once Hour after hour before you need to recharge the  10.090 mAh battery (typical). When watching videos, it lasts up  to 13 hours, so you have enough time for a series marathon. The  included low-latency S pen provides a smooth writing experience.  More: In real time, it converts handwriting into print font and  you can easily edit text, then put it on the magnetic holder so  that it recharges itself. Immerse yourself in the colour splendour  of the 31.50 cm / 12.4 inch display of the Galaxy Tab S7 FE Wi-Fi  | Tab S7 FE 5G. Experience exciting movie moments with Sound by AKG  and look forward to a colourful display that literally brings any  amount of detail to life. The dual speakers and Dolby Atmos can  also provide a room-filling surround sound, so you feel like  you\'re in the middle of the action.\\n",          "productTags": [            "Computers",            "PCs & Laptops"          ]        }      },      "customsCodes": {        "customsTariffCode": "84713090",        "taricCode": "8471309000",        "eClearCode": {          "code": 123456789,          "taxonomy": "TARIC"        }      },      "manufacturerName": "Samsung",      "productUids": {        "asin": "B09BJV8MBW"      },      "customs": {        "physicalMeasure": {          "unit": "gram",          "amount": 610        },        "countryOfOrigin": "KR",        "btiId": "DE-845623895",        "measureCondition": {          "taric": [            "X110",            "Y200"          ]        }      },      "merchantProductAttributes": {        "fileName": "file-name1.png",        "url": "example1.com"      }    }  }'
{
  "tablet_ab103": "http://{server_url}/products/global/tablet_ab103",
  "tablet_ab102": "http://{server_url}/products/global/tablet_ab102"
}
{
  "code": "BadRequest",
  "message": "Bad request.",
  "status": "BAD_REQUEST"
}
{
  "code": "Unauthorized",
  "message": "Not authorized.",
  "status": "UNAUTHORIZED"
}
{
  "code": "Forbidden",
  "message": "API key no longer has access to the account, or their user level doesn’t allow access to the endpoint.",
  "status": "FORBIDDEN"
}
{
  "code": "NotFound",
  "message": "The requested resource could not be found. Either no object exists with the ID provided in the path, or the path is incorrect.",
  "status": "NOT_FOUND"
}
{
  "code": "PAYLOAD_TOO_LARGE",
  "message": "Request body too large.",
  "status": "PAYLOAD_TOO_LARGE",
  "timestamp": "2024-06-21T12:36:37.900574"
}
{
  "status": "UNSUPPORTED_MEDIA_TYPE",
  "code": "UNSUPPORTED_MEDIA_TYPE",
  "message": "Unsupported Media Type client error, the server refuses to accept the request because the payload format is in an unsupported format.",
  "timestamp": "2024-06-21T12:36:37.900574",
  "path": "/path"
}
{
  "code": "LIMIT_EXCEEDED",
  "message": "Usage limit exceeded for free trial subscription.",
  "status": "TOO_MANY_REQUESTS",
  "detail": "The free trial monthly limit of 100 checks has been exceeded. Please upgrade to a paid subscription.",
  "instance": "3b4dcb40-0b6b-4820-bfaa-41267b3826ea"
}