Workflow

Upload item/article master data

Customer creates purchase order

Customer updates purchase order

Customer cancels purchase order

Customer and supplier confirms delivery planning

Supplier set shipment final

Customer receive goods

OSCA DC Order Interface API (1.0.0)

Download OpenAPI specification: Download

E-mail: interfaces@setlog-support.com

Setlog Service for import purchase orders

Upload items

PUT/item

Upload new or changed itmes from ERP-System into your OSCA System.

Authorizations: http

parameter name:

Request Body Schema: application/json

array of Item

Responses

› 200 The items are saved successfully.

Response Schema

array of object

array of object

array of object

object

The metadata of the execution of the request

› 400 This means that the entity has the required fields but some fields are missing during the process. This can occur, when you define default fields but they are not taken.

Response Schema

object

The metadata of the execution of the request

array of object

array of object

array of object

› 401 This means that you are unauthorized.

Response Schema

value

object

› 422 This means that the request is not well-formed, or syntactically incorrect, or violates schema.

Response Schema

value

string

PUT/item

Item/Article Upload

{
  "item": [
    {
      "itemNumber" : "51874863",
      "itemText" : "Wood Nature Table",
      "unit" : "Pcs",
      "customsTariffNumber" : "39498387263",
      "ean" : "3457436723"
    },
    {
      "itemNumber" : "51874865",
      "itemText" : "Wood Nature Chair",
      "unit" : "Pcs",
      "customsTariffNumber" : "39498387263",
      "ean" : "3457436724"
    }
  ]
}

curl 'Item/Article Upload'

curl --location --request PUT 'https://uat-osca-dc.setlog.com/order-interface/api/item' \
--header 'Authorization: Basic {ORDER_IMPORT_BASIC_AUTH}' \
--header 'Content-Type: application/json' \
--data-raw '{
  "item": [
    {
      "itemNumber" : "51874863",
      "itemText" : "Wood Nature Table",
      "unit" : "Pcs",
      "customsTariffNumber" : "39498387263",
      "ean" : "3457436723"
    },
    {
      "itemNumber" : "51874865",
      "itemText" : "Wood Nature Chair",
      "unit" : "Pcs",
      "customsTariffNumber" : "39498387263",
      "ean" : "3457436724"
    }
  ]
}'

Item/Article Full Upload

{
  "item": [
    {
      "itemNumber" : "51874873",
      "itemText" : "Wood Nature Chair DarkBrown",
      "brand" : "Mando",
      "collection" : "2025",
      "theme" : "Mount",
      "productType" : "Chairs",
      "productGroup" : "Private Living Room",
      "mainProductGroup" : "Living Room",
      "unit" : "Pcs",
      "quantityPerUnit" : 1,
      "weight" : 0.005,
      "volume" : 0.006,
      "style" : "S464",
      "styleText" : "Style New",
      "material" : "M554-54",
      "materialText" : "Wood",
      "materialComposition" : "Wood & Synthetics",
      "commodity" : "C2",
      "season" : "2025",
      "customsTariffNumber" : "39498387263",
      "customsCategory" : "CC2",
      "color" : "4567",
      "colorText" : "DarkBrown",
      "weightUnitId" : 1,
      "volumeUnitId" : 1,
      "ean" : "3457436723",
      "dimension" : "97x45x54",
      "batchNumberRequired": false,
      "dangerousGoods" : null,
      "nos" : false,
      "countryOfOrigin": "CN",
      "customAttributes": {
        "ean128": "(01)98239829349857(3103)007653"
      }
    },
    {
      "itemNumber" : "51874874",
      "itemText" : "Wood Nature Chair Beige",
      "brand" : "Mando",
      "collection" : "2025",
      "theme" : "Mount",
      "productType" : "Chairs",
      "productGroup" : "Private Living Room",
      "mainProductGroup" : "Living Room",
      "unit" : "Pcs",
      "quantityPerUnit" : 1,
      "weight" : 0.005,
      "volume" : 0.006,
      "style" : "S464",
      "styleText" : "Style New",
      "material" : "M554-54",
      "materialText" : "Wood",
      "materialComposition" : "Wood & Synthetics",
      "commodity" : "",
      "season" : "2025",
      "customsTariffNumber" : "39498387263",
      "customsCategory" : "",
      "color" : "4568",
      "colorText" : "Beige",
      "weightUnitId" : 1,
      "volumeUnitId" : 1,
      "ean" : "3457436724",
      "dimension" : "97x45x54",
      "batchNumberRequired": false,
      "dangerousGoods" : null,
      "nos" : false,
      "countryOfOrigin": "CN",
      "customAttributes": {
        "ean128": "(01)98239829349234(3103)001456"
      }
    }
  ]
}