API Reference

Here you can read all references to integrate Wurth Api.

Wurth clients API let you implement a fast automation you need for your business. Contact us to get access and crendentials, then you can start creating your own business logic system.

The APIs return always a response with information about success or failure with at least two parameters:

  • result: 'ok' on success, 'ko' on failure.
  • error: empty string on success, string with relative error on failure.

API Reference

Every Wurth API call uses the same endpoint prefix: 

https://api.wuerth.it/api/v1

Authorization

You need to pass your Account relative Bearer Token on every call you make to Wurth API

We provide two different tokens:

  • Test API Token: this is the sandbox token (every POST, PUT, PATCH, DELETE will not affect your production data).
  • Production API Token: this is the production token.

Authorization
curl 'https://wurthapi.me/api/v1/get-version' -H 'authorization: Bearer TEST-agVd3VydGg=gaV'

Responses

Wurth API completely fits the HTTP verb.

Every response return a status code based on the request success or failure.

API's endpoint return anyway a JSON response.

Response Types
200 - OK Standard response for successful HTTP requests
400 - Bad Request The server cannot or will not process the request due to an apparent client error
401 - Unauthorized You are not authorized (maybe bad token or disabled account)
404 - Not Found This can happen if you try to execute a GET on a not existing resource
429 - Too Many Requests This can happen also if our servers are full loaded so we can't serve your request
500, 502, 503, 504 - Server Errors All this errors are not your fault but they are caused by our servers

Error handling

You can face different kind of errors.

  • 5xx status codes: these errors are caused by our servers. We suggest you to implement queues with failover for your critical API calls.
  • 4xx status code: Resource not found. You will get a JSON response anyway that better describe the error and result.

Another important issue is about 5xx status codes and/or servers problems. When you call APIs that are critical for your business and they have to be executed anyway, we suggest you to create queues to handling this kind of requests with a good failover. This is just to be sure that critical calls has been successful or they will be executed later.

4xx sample response:

sample endpoint: /api/v1/get-product/{product_no} 

{
    "result": "ko",
    "error": "PRODUCT_NOT_FOUND",
    "version": "1"
}

Error Types

Here you can find all error messages that you can find in the JSON error value: 

{
    "result": "ko",
    "error": "ERROR_MESSAGE",
}
Error message Reason
OPERATION_NOT_ALLOWED requested operation is not allowed
USER_DISABLED_OR_NOT_FOUND The user is disabled or does not exists
NOT_SECURE_PROTOCOL You are calling an endpoint without using https protocol (our APIs works only on https protocol for security reason)
VALIDATION_GET_DATA_FAILED You are sending malformed GET or Query String data to the endpoint
VALIDATION_POST_DATA_FAILED You are sending malformed POST data to the endpoint
INVALID_TOKEN Your used token is invalid
USER_DISABLED_OR_INVALID_TOKEN Your used token is invalid or the relative user is disabled
ARTICLE_NOT_FOUND You are searching for an article that does not exists
ARTICLE_NOT_FOUND_OR_MALFORMED_ARTICLENO You are searching for an article that does not exists or malformed article number
PRODUCT_NOT_FOUND You are searching for an article that does not exists
USER_HAVE_NOT_INVOICES_POS_DIR User have not an invoices dir
USER_INVOICES_POS_DIR_IS_EMPTY User invoices directory is empty
ORDER_NOT_FOUND You are searching for an order that does not exists
INVOICE_NOT_FOUND You are searching for an invoice that does not exists
TRANSPORT_DELIVERY_DOCUMENT_NOT_FOUND You are searching for a transport delivery document that does not exists
NOT_ENOUGH_PRIVILEGES Your privileges are not enough to make this request

Invoices data and download

Use these APIs to retrieve informations, data and to download your invoices (if allowed by your account).

You need to pass your Account relative Bearer Token on every call you make to this API

API Reference

Every Wurth API call uses the same endpoint prefix: 

https://api.wuerth.it/api/v1

Get invoice infos

Use this APIs to retrieve invoice infos with every article details.

You need to pass your Account relative Bearer Token on every call you make to this API

Remember: every URL parameters must be url encoded!

  • billingDocumentNo (required): The Wuerth billing document number

Note: you can use the "num_billingdocument" value as billingDocumentNo parameter returned from the "Get order infos" API.

API Reference

Method: GET 

https://api.wuerth.it/api/v1/invoice/{billingDocumentNo}
Example
curl 'https://api.wuerth.it/api/v1/invoice/4277189651' -H 'authorization: Bearer TEST-agVd3VydGg=gaV'
Result
{
    "result": "ok",
    "error": "",
    "version": "1",
    "invoice": {
        "billingDocumentNo": "4277189651",
        "invoicePositions": [
            {
                "dat_billing": "2020-03-03 00:00:00",
                "num_billingdocument": "4277189651",
                "num_billingdocumentitem": "1",
                "dat_orderentry": "2020-02-11 00:00:00",
                "num_order": "2093486753",
                "num_orderitem": "30",
                "num_customerorder": "20720820",
                "ids_customer": "511170754",
                "dsc_product": "464180642",
                "dsc_material": "464180642 090   50",
                "dsc_presentation": "090",
                "dsc_packagesize": "00050",
                "amt_netvalue": "8.31",
                "amt_freightcost": "0",
                "qty_order": "12",
                "qty_invoice": "12",
                "amt_kilonetweight": "1.96",
                "transportdeliverynumber": "8331481022"
            },
            {
                "dat_billing": "2020-03-03 00:00:00",
                "num_billingdocument": "4277189651",
                "num_billingdocumentitem": "2",
                "dat_orderentry": "2020-02-28 00:00:00",
                "num_order": "2094763235",
                "num_orderitem": "10",
                "num_customerorder": "19167505",
                "ids_customer": "511170754",
                "dsc_product": "024701260",
                "dsc_material": "024701260 092  100",
                "dsc_presentation": "092",
                "dsc_packagesize": "00100",
                "amt_netvalue": "31.5",
                "amt_freightcost": "0",
                "qty_order": "100",
                "qty_invoice": "100",
                "amt_kilonetweight": "4.62",
                "transportdeliverynumber": "8331264358"
            },
            ...
        ]
    }
}

Products info data

Use these APIs to retrieve informations about products, articles and prices.

You need to pass your Account relative Bearer Token on every call you make to this API

API Reference

Every Wurth API call uses the same endpoint prefix: 

https://api.wuerth.it/api/v1

Get product

Use these APIs to retrieve information about a product passed as argument.

You need to pass your Account relative Bearer Token on every call you make to this API

Remember: every product may have multiple available articles.

API Reference

Method: GET 

https://api.wuerth.it/api/v1/get-product/{product_no}
Example
curl 'https://api.wuerth.it/api/v1/get-product/07023220' -H 'authorization: Bearer TEST-agVd3VydGg=gaV'
Result
{
	"result": "ok",
	"error": "",
	"version": "1",
	"product": {
		"productno": "07023220",
		"articles": [
			{
				"articleno": "07023220  061    1",
				"longdescription": "Trapano a percussione SB 13-XE",
				"productno": "07023220",
				"alternative_article": null,
				"wuerth_classification_name": null,
				"description": "TRAPANO A PERCUSS.SB13-XE I.S.C.",
				"eancode": "4038898328650",
				"statusid": "5",
				"status": "Active",
				"imagethumbnailurl": "https://media.wuerth.com/stmedia/shop/348px/44129.jpg",
				...
			},
			{
				"articleno": "07023220  989    1",
				"longdescription": "Trapano a percussione SB 13-XE",
				"productno": "07023220",
				"alternative_article": null,
				"wuerth_classification_name": null,
				"description": "TRAPANO A PERCUSS.SB13-XE I.S.C.",
				"eancode": "4048539244812",
				"statusid": "5",
				"status": "Active",
				"imagethumbnailurl": "https://media.wuerth.com/stmedia/shop/348px/44129.jpg",
				...
			}
		]
	}
}

Search product

Use it to search a product by term, category or other parameters. Search results can be paginated.
This API will give you the relative articles for every product matching your filters.

Set filters with query string at the end of API Endpoint

You need to pass your Account relative Bearer Token on every call you make to this API

Remember: every product may have multiple available articles.

Max results per page: 10

Filters: (query string parameters)

  • term (optional):The search term
  • page (optional):The pagination parameter (min: 1) (default: 1)
  • eancode (optional):Filter by eancode
  • cat_level1 (optional):Category level 1 name
  • cat_level1_id (optional):Category level 1 ID
  • cat_level2 (optional):Category level 2 name
  • cat_level2_id (optional):Category level 2 ID
  • cat_level3 (optional):Category level 3 name
  • cat_level3_id (optional):Category level 3 ID
  • cat_level4 (optional):Category level 4 name
  • cat_level4_id (optional):Category level 4 ID
  • cat_level5 (optional):Category level 5 name
  • cat_level5_id (optional):Category level 5 ID
API Reference

Method: GET 

https://api.wuerth.it/api/v1/search-product
Example
curl 'http://wurthapi.me/api/v1/search-product?page=1&term=Levigatrice&eancode=&cat_level1=Utensili&cat_level1_id=&cat_level2=Utensili%20elettrici&cat_level2_id=&cat_level3=Levigatrici%20e%20lucidatrici%20elettriche&cat_level3_id=&cat_level4=Levigatrice%20roto-orbitale%20elettrica&cat_level4_id=&cat_level5=&cat_level5_id=' -H 'authorization: Bearer TEST-agVd3VydGg=gaV'
Result
{
	"result": "ok",
	"error": "",
	"version": "1",
	"page": 1,
    "totalPagesCount": 7,
	"products": [
		{
			"productno": "07021290",
			"articles": [
				{
					"articleno": "07021290  989    1",
					"longdescription": "Levigatrice roto-orbitale ETS 150-E twin",
					"productno": "07021290",
					"alternative_article": null,
					"wuerth_classification_name": null,
					"description": "LEVIGATRICE ROTO-ORB. ETS 150-E TWIN",
					"eancode": "4050641245731",
					"statusid": "5",
					"status": "Active",
					"imagethumbnailurl": "https://media.wuerth.com/stmedia/shop/348px/43800.jpg",
                    ...
				},
				{
					"articleno": "07021290  961    1",
					"longdescription": "Levigatrice roto-orbitale ETS 150-E twin",
					"productno": "07021290",
					"alternative_article": null,
					"wuerth_classification_name": null,
					"description": "LEVIGATRICE ROTO-ORB. ETS 150-E TWIN",
					"eancode": "4047376942851",
					"statusid": "5",
					"status": "Active",
					"imagethumbnailurl": "https://media.wuerth.com/stmedia/shop/348px/43800.jpg",
                    ...
				}
			]
		},
		{
			"productno": "07021280",
			"articles": [
				{
					"articleno": "07021280  961    1",
					"longdescription": "Levigatrice roto-orbitale ETS 125-E",
					"productno": "07021280",
					"alternative_article": null,
					"wuerth_classification_name": null,
					"description": "LEVIGATRICE ROTO-ORBITALE ETS125-E",
					"eancode": "4047376942844",
					"statusid": "5",
					"status": "Active",
					"imagethumbnailurl": "https://media.wuerth.com/stmedia/shop/348px/43749.jpg",
                    ...
				}
			]
		}
	]
}

Get product price

Use these APIs to retrieve product price infos.

All prices are in Euros (EUR)

You need to pass your Account relative Bearer Token on every call you make to this API

Remember: every URL parameters must be url encoded!

API Reference

Method: GET 

https://api.wuerth.it/api/v1/get-product-price
Query params:
  • customerno (optional): Specify the customer NO to query
  • dealercode (optional): Specify the customer dealer to query
  • product_no (optional - required if partno not specified): Specify the product NO to query
  • partno (optional - required if product_no not specified): Specify the product part NO to query
Example
curl --request GET \
  --url 'http://api.wuerth.it/api/v1/get-product-price?customerno=511017427&product_no=07023220' \
  --header 'authorization: Bearer *****'
Result
{
  "result": "ok",
  "error": "",
  "version": "1",
  "customerno": "511195052",
  "product": {
    "productno": "07023220",
    "priceInfos": {
      "unit": 1,
      "discount": "60",
      "priceperpu": 565.16
    }
  }
}

Get article

Use these APIs to retrieve information about an article passed as argument.

You need to pass your Account relative Bearer Token on every call you make to this API

Remember: every URL parameters must be url encoded!

API Reference

Method: GET 

https://api.wuerth.it/api/v1/get-article/{article_no}
Example
curl 'https://api.wuerth.it/api/v1/get-article/07012290%20%20989%20%20%20%201' -H 'authorization: Bearer TEST-agVd3VydGg=gaV'
Result
{
	"result": "ok",
	"error": "",
	"version": "1",
	"article": {
		"articleno": "07012290  989    1",
		"longdescription": "Trapano a percussione SB 13-XE",
		"productno": "07023220",
		"description": "TRAPANO A PERCUSS.SB13-XE I.S.C.",
		"eancode": "4048539244812",
		"statusid": "5",
		"status": "Active",
		"imagethumbnailurl": "https://media.wuerth.com/stmedia/shop/348px/44129.jpg",
		...
	}
}

Get articles by part

Use it to retrieve articles informations by the partner product code

All prices are in Euros (EUR)

You need to pass your Account relative Bearer Token on every call you make to this API

Remember: every URL parameters must be url encoded!

  • partno (required - string): The customer product NO
API Reference

Method: GET 

https://api.wuerth.it/api/v1/articles-by-part/{partno}
Example
curl --location 'http://localhost:8080/api/v1/articles-by-part/QALIT449900395XX12X' \
--header 'Authorization: ••••••'
Result
{
    "result": "ok",
    "error": "",
    "version": "1",
    "product": {
        "productno": "00395  12",
        "minDeliveryQty": 500,
        "minPackageSize": 500,
        "articles": [
            {
                "articleno": "00395  12 092 1000",
                "longdescription": "Vite a testa piana svasata con intaglio DIN 963, acciaio 4.8, zincato, passivato bianco (A2K)",
                "productno": "00395  12",
                "alternative_article": null,
                "wuerth_classification_name": "DIN 963 acciaio 4.8 zincato",
                "description": "VITE-TPS-INTAGL-DIN963-4.8-(A2K)-M5X12",
                "eancode": "4045727040690",
                "statusid": "5",
                "status": "Active",
                "iseshopvisible": "yes",
                "isspeciaarticle": "no",
                "isprintrelevant": "yes",
                "level1": "Elementi di fissaggio",
                "level1id": "35",
                "level1imageid": "1320293",
                "level2": "Viti metriche/pollice",
                "level2id": "3511",
                "level2imageid": "14821877",
                "level3": "Viti a testa piana svasata",
                "level3id": "351112",
                "level3imageid": "146396",
                "level4": "Vite, testa svasata con intaglio",
                "level4id": "35111212",
                "level4imageid": "1337730",
                "level5": "DIN 963 acciaio 4.8 zincato ",
                "level5id": "3511121210",
                "level5imageid": null,
                "eclass40": "EC_40_23110103",
                "eclass41": "EC_41_23110103",
                "eclass50": "EC_50_23110103",
                "eclass51": "EC_51_23110103",
                "eclass601": "EC_601_23110103",
                "eclass61": "EC_61_23110103",
                "eclass62": "EC_62_23110103",
                "eclass70": "EC_70_23110103",
                "eclass71": "EC_71_23110103",
                "eclass80": "EC_80_23110103",
                "unspsc50301": "UN_151101_31161513",
                "unspsc151101": "UN_50301_31161513",
                "unspsc70401": "UN_70401_31161513",
                "imagebigurl": "https://media.wuerth.com/stmedia/shop/800px/1337730.jpg",
                "imagethumbnailurl": "https://media.wuerth.com/stmedia/shop/348px/1337730.jpg",
                "catalogpdfpageurl": null,
                "imagebigfile": null,
                "thumbnailfile": null,
                "catalogpdfpagefile": null,
                "imagebigremotelastupdate": null,
                "thumbremotelastupdate": null,
                "pdfremotelastupdate": null,
                "imagebiglocallastupdate": null,
                "thumblocallastupdate": null,
                "pdflocallastupdate": null,
                "eshopmklevel1": "35",
                "eshopmklevel2": "3511",
                "eshopmklevel3": "351112",
                "eshopmklevel4": "35111212",
                "eshopmklevel5": "3511120126",
                "msdspdfurl": null,
                "msdspdflocallastupdate": null,
                "extended_description": null,
                "squared_images": null,
                "loaddate": "2025-09-16 02:35:17",
                "lastupdate": "2025-09-16 02:35:17",
                "priceInfos": {
                    "unit": 1,
                    "discount": "60",
                    "priceperpu": 0.5,
                    "packagePrice": 500
                }
            },
            {
                "articleno": "00395  12 005  500",
                "longdescription": "Vite a testa piana svasata con intaglio DIN 963, acciaio 4.8, zincato, passivato bianco (A2K)",
                "productno": "00395  12",
                "alternative_article": null,
                "wuerth_classification_name": "DIN 963 acciaio 4.8 zincato",
                "description": "VITE-TPS-INTAGL-DIN963-4.8-(A2K)-M5X12",
                "eancode": "4011231061858",
                "statusid": "5",
                "status": "Active",
                "iseshopvisible": "yes",
                "isspeciaarticle": "no",
                "isprintrelevant": "yes",
                "level1": "Elementi di fissaggio",
                "level1id": "35",
                "level1imageid": "1320293",
                "level2": "Viti metriche/pollice",
                "level2id": "3511",
                "level2imageid": "14821877",
                "level3": "Viti a testa piana svasata",
                "level3id": "351112",
                "level3imageid": "146396",
                "level4": "Vite, testa svasata con intaglio",
                "level4id": "35111212",
                "level4imageid": "1337730",
                "level5": "DIN 963 acciaio 4.8 zincato ",
                "level5id": "3511121210",
                "level5imageid": null,
                "eclass40": "EC_40_23110103",
                "eclass41": "EC_41_23110103",
                "eclass50": "EC_50_23110103",
                "eclass51": "EC_51_23110103",
                "eclass601": "EC_601_23110103",
                "eclass61": "EC_61_23110103",
                "eclass62": "EC_62_23110103",
                "eclass70": "EC_70_23110103",
                "eclass71": "EC_71_23110103",
                "eclass80": "EC_80_23110103",
                "unspsc50301": "UN_151101_31161513",
                "unspsc151101": "UN_50301_31161513",
                "unspsc70401": "UN_70401_31161513",
                "imagebigurl": "https://media.wuerth.com/stmedia/shop/800px/1337730.jpg",
                "imagethumbnailurl": "https://media.wuerth.com/stmedia/shop/348px/1337730.jpg",
                "catalogpdfpageurl": null,
                "imagebigfile": null,
                "thumbnailfile": null,
                "catalogpdfpagefile": null,
                "imagebigremotelastupdate": null,
                "thumbremotelastupdate": null,
                "pdfremotelastupdate": null,
                "imagebiglocallastupdate": null,
                "thumblocallastupdate": null,
                "pdflocallastupdate": null,
                "eshopmklevel1": "35",
                "eshopmklevel2": "3511",
                "eshopmklevel3": "351112",
                "eshopmklevel4": "35111212",
                "eshopmklevel5": "3511120126",
                "msdspdfurl": null,
                "msdspdflocallastupdate": null,
                "extended_description": null,
                "squared_images": null,
                "loaddate": "2025-09-16 02:35:17",
                "lastupdate": "2025-09-16 02:35:17",
                "priceInfos": {
                    "unit": 1,
                    "discount": "60",
                    "priceperpu": 0.5,
                    "packagePrice": 250
                }
            }
        ]
    }
}

Get articles by dealer and part

Use it to retrieve articles informations for an associated dealercode by the partner product code

All prices are in Euros (EUR)

You need to pass your Account relative Bearer Token on every call you make to this API

Remember: every URL parameters must be url encoded!

  • dealercode (required - string): The dealer code
  • partno (required - string): The customer product NO
API Reference

Method: GET 

https://api.wuerth.it/api/v1/articles-by-dealer-and-part/{dealercode}/{partno}
Example
curl 'https://api.wuerth.it/api/v1/articles-by-dealer-and-part/502900/QALIT44990713112108' -H 'authorization: *****'
Result
{
  "result": "ok",
  "error": "",
  "version": "1",
  "product": {
    "productno": "0713112108",
    "minDeliveryQty": 1,
    "minPackageSize": 1,
    "articles": [
      {
        "articleno": "0713112108060    1",
        "longdescription": "Chiave a bussola da 1/4\" misure metriche, esecuzione lunga",
        "productno": "0713112108",
        "alternative_article": null,
        "wuerth_classification_name": "Chiave a bussola da 1/4 poll. metrica esag. lunga",
        "description": "BUSSOLA ZEBRA ESAG.LUNGA ATT1/4  8MM",
        ...
        "priceInfos": {
          "unit": 1,
          "discount": "60",
          "priceperpu": 36.03,
          "packagePrice": 36.03
        }
      },
      {
        "articleno": "0713112108060   10",
        "longdescription": "Chiave a bussola da 1/4\" misure metriche, esecuzione lunga",
        "productno": "0713112108",
        "alternative_article": null,
        "wuerth_classification_name": "Chiave a bussola da 1/4 poll. metrica esag. lunga",
        "description": "BUSSOLA ZEBRA ESAG.LUNGA ATT1/4  8MM",
        ...
        "priceInfos": {
          "unit": 1,
          "discount": "60",
          "priceperpu": 36.03,
          "packagePrice": 360.3
        }
      }
    ]
  }
}

Full catalog generation

Use these APIs to place a full catalog generation request.

  • on_ready_url (required): an HTTPS URL that the system will call with GET once the catalog generation is completed.
  • customerno (optional): Specify the customer NO for which to generate the catalog
  • dealercode (optional): Specify the customer dealer for which to generate the catalog

Important: Once the catalog file generation is completed, APIs will call the on_ready_url, with "temp_download_url" query string parameter to allow an external system to download the catalog file (Ex. using wget, curl ecc.).

Response fields:
  • full_catalog_request_expiration: specify the request expiration. You won't be able to place another full catalog generation request if this expiration is not passed. (UNIX timestamp)

You need to pass your Account relative Bearer Token on every call you make to this API

Remember: every URL parameters must be url encoded!

API Reference

Method: POST

Accept: application/json 

https://api.wuerth.it/api/v1/full-catalog-generate-download-url
Body params:
  • on_ready_url (required): an HTTPS URL that the system will call with GET once the catalog generation is completed (appending query param: "temp_download_url").
  • customerno (optional): Specify the customer NO for which to generate the catalog
  • dealercode (optional): Specify the customer dealer for which to generate the catalog
Example
curl --request POST \
  --url https://api.wuerth.it/api/v1/full-catalog-generate-download-url \
  --header 'authorization: *****' \
  --header 'content-type: application/json' \
  --data '{
  "dealercode": "532600",
  "customerno": "511017427",
  "on_ready_url": "https://company.ext/hook"
}'
Response
{
    "result": "ok",
    "error": "",
    "version": "1",
    "full_catalog_request_expiration": 1756373256
}

Orders info data

Use these APIs to retrieve informations about orders.

You need to pass your Account relative Bearer Token on every call you make to this API

API Reference

Every Wurth API call uses the same endpoint prefix: 

https://api.wuerth.it/api/v1

Get orders list by date ranges

Use these APIs to retrieve orders list by date ranges.

You need to pass your Account relative Bearer Token on every call you make to this API

Remember: every URL parameters must be url encoded!

  • startDate (required): The range start date. Format: YYYYMMDD
  • endDate (required): The range end date. Format: YYYYMMDD

API Reference

Method: GET 

https://api.wuerth.it/api/v1/orders/list/by-date-ranges/{startDate}/{endDate}
Example
curl 'https://api.wuerth.it/api/v1/orders/list/by-date-ranges/20200601/20200701' -H 'authorization: Bearer TEST-agVd3VydGg=gaV'
Result
{
    "result": "ok",
    "error": "",
    "version": "1",
    "orders": [
        {
            "num_order": "2094839880",
            "dat_orderentry": "2020-03-02 00:00:00",
            "orderTotalAmount": 5.32
        },
        {
            "num_order": "2094807685",
            "dat_orderentry": "2020-03-02 00:00:00",
            "orderTotalAmount": 1.17
        },
		...
    ]
}

Get orders infos

Use these APIs to retrieve orders infos and every relative articles inside the order.

You need to pass your Account relative Bearer Token on every call you make to this API

Remember: every URL parameters must be url encoded!

  • orderNo (required): The Wuerth order number

Note: you can use the returned "num_billingdocument" as parameter for the "Get invoice infos" API.

API Reference

Method: GET 

https://api.wuerth.it/api/v1/order/{orderNo}
Example
curl 'https://api.wuerth.it/api/v1/order/2095049757' -H 'authorization: Bearer TEST-agVd3VydGg=gaV'
Result
{
    "result": "ok",
    "error": "",
    "version": "1",
    "order": {
        "orderNo": "2095049757",
        "orderTotalAmount": "22.68",
        "orderPositions": [
            {
                "dat_orderentry": "2020-03-04 00:00:00",
                "num_order": "2095049757",
                "num_orderitem": "20",
                "ids_customer": "511170754",
                "dsc_product": "031024",
                "dsc_presentation": "092",
                "dsc_packagesize": "00050",
                "dsc_material": "031024    092   50",
                "amt_order": "3.12",
                "amt_netorder": "3.12",
                "amt_orderdiscount": "0",
                "amt_orderfreightcost": "0",
                "num_customerorder": "20721205",
                "qty_order": "19",
                "att_customermaterial": "0.001079.P",
                "num_billingdocument": "4277189651"
                "ddt_number": "1026329455"
            },
            {
                "dat_orderentry": "2020-03-04 00:00:00",
                "num_order": "2095049757",
                "num_orderitem": "10",
                "ids_customer": "511170754",
                "dsc_product": "024702550",
                "dsc_presentation": "092",
                "dsc_packagesize": "00010",
                "dsc_material": "024702550 092   10",
                "amt_order": "13.44",
                "amt_netorder": "13.44",
                "amt_orderdiscount": "0",
                "amt_orderfreightcost": "0",
                "num_customerorder": "20721205",
                "qty_order": "4",
                "att_customermaterial": "0.055979.Q",
                "num_billingdocument": "4277189651"
                "ddt_number": "1026329455"
            },
            ...
        ]
    }
}

Transport Delivery Documents API

Use these APIs to retrieve informations and data about transport delivery documents.

You need to pass your Account relative Bearer Token on every call you make to this API

API Reference

Every Wurth API call uses the same endpoint prefix: 

https://api.wuerth.it/api/v1

Get delivery document infos

Use this APIs to retrieve transport delivery document infos with every article details.

You need to pass your Account relative Bearer Token on every call you make to this API

Remember: every URL parameters must be url encoded!

  • transportDeliveryNumber (required): The Transport Delivery Number

Note: you can use the "transportdeliverynumber" value as transportDeliveryNumber parameter returned from the "Get invoice infos" API.

API Reference

Method: GET 

https://api.wuerth.it/api/v1/transport-delivery-document/{transportDeliveryNumber}
Example
curl 'https://api.wuerth.it/api/v1/transport-delivery-document/8331431602' -H 'authorization: Bearer TEST-agVd3VydGg=gaV'
Result
{
    "result": "ok",
    "error": "",
    "version": "1",
    "transportDeliveryDocument": {
        "deliveryDate": "2020-12-10 00:00:00",
        "deliveryNumber": "8814678254",
        "positions": [
            {
                "deliveryLineNumber": "10",
                "quantity": "1",
                "orderNumber": "2112871314",
                "orderLineNumber": "000001",
                "orderDate": "2020-12-03 00:00:00",
                "articleNumber": "07002363  961    1",
                "articleName": "SMERIGLIATR.A BATT.EWS18-A/125MM-2X4,0AH",
                "harmonizedSystemCode": "846729510000",
                "barcode": "4058794429763",
                "countryOfOrigin": "QU",
                "customerOrderNumber": "121820061",
                "customerOrderLineNumber": null,
                "customerOrderDate": "2020-12-03 00:00:00",
                "customerArticleNumber": null
            },
            {
                "deliveryLineNumber": "20",
                "quantity": "1",
                "orderNumber": "2112871314",
                "orderLineNumber": "000103",
                "orderDate": "2020-12-03 00:00:00",
                "articleNumber": "0706235018990    1",
                "articleName": "MOTORE",
                "harmonizedSystemCode": "846799000000",
                "barcode": "4052712101205",
                "countryOfOrigin": "QU",
                "customerOrderNumber": "121820061",
                "customerOrderLineNumber": null,
                "customerOrderDate": "2020-12-03 00:00:00",
                "customerArticleNumber": null
            },
            ...
        ]
    }
}

Get DDT PDF

Use this APIs to retrieve DDT PDF.

You need to pass your Account relative Bearer Token on every call you make to this API

Remember: every URL parameters must be url encoded!

  • transportDeliveryNumber (required): The Transport Delivery Number

Note: you can use the "transportdeliverynumber" value as transportDeliveryNumber parameter returned from the "Get invoice infos" API.

API Reference

Method: GET 

https://api.wuerth.it/api/v1/get-ddt-pdf/{transportDeliveryNumber}
Example
curl --request GET \
  --url http://api.wuerth.it/api/v1/get-ddt-pdf/5270977990 \
  --header 'authorization: ••••••'
Result
{
  "result": "ok",
  "error": "",
  "version": "1",
  "ddt_pdf": "base64 encoded PDF file"
}

Get delivery documents list by date ranges

Use this APIs to retrieve transport delivery documents list by date ranges.

You need to pass your Account relative Bearer Token on every call you make to this API

Remember: every URL parameters must be url encoded!

  • startDate (required): The range start date. Format: YYYYMMDD
  • endDate (required): The range end date. Format: YYYYMMDD

API Reference

Method: GET 

https://api.wuerth.it/api/v1/transport-delivery-documents/list/by-date-ranges/{startDate}/{endDate}
Example
curl 'https://api.wuerth.it/api/v1/transport-delivery-documents/list/by-date-ranges/20201001/20210131' -H 'authorization: Bearer TEST-agVd3VydGg=gaV'
Result
{
    "result": "ok",
    "error": "",
    "version": "1",
    "transportDeliveryDocuments": [
        {
            "deliverynumber": "8814045665",
            "deliverydate": "2020-10-02 00:00:00"
        },
        {
            "deliverynumber": "8814115679",
            "deliverydate": "2020-10-12 00:00:00"
        },
        {
            "deliverynumber": "8814227080",
            "deliverydate": "2020-10-22 00:00:00"
        },
        ...
    ]
}

Vending Machines Withdrawals API

Use these APIs to retrieve informations and data about withdrawals.

You need to pass your Account relative Bearer Token on every call you make to this API

API Reference

Every Wurth API call uses the same endpoint prefix: 

https://api.wuerth.it/api/v1

Get Vending Machine WIS Withdrawals

Use this API to query executed WIS withdrawals.

  • customerno (string - optional): Specify the customer NO for which to query withdrawals
  • dealercode (string - optional): Specify the customer dealer for which to query withdrawals
  • startDate (YYYYMMDD - optional/required with endDate): Specify a start date for filtering
  • endDate (YYYYMMDD - optional/required with startDate): Specify an end date for filtering
Notes:
omitting startDate/endDate will cause the system to return the current month withdrawals

API Reference

Method: GET

Accept: application/json 

https://api.wuerth.it/api/v1/vending-machines/get-wis-withdrawals
Example
curl --request GET \
  --url 'https://api.wuerth.it/api/v1/vending-machines/get-wis-withdrawals?customerno=511187150&startDate=20251015&endDate=20251015' \
  --header 'authorization: Bearer *****'
Response
{
  "result": "ok",
  "error": "",
  "version": "1",
  "withdrawals": [
    {
      "customerid": "511187150",
      "automatid": "24855",
      "statisticid": "195062199",
      "eventdate": "2025-10-15 05:03:20",
      "automatuserid": "MAGAZZINO 2",
      "name": "MAGAZZINO 2",
      "automatloginid": "5984151",
      "fk_articlenumber": "0875033020961    1",
      "art_description": "NASTRO-VKP-3-30MM-(10-20MM)-L6M",
      "custmatno": null,
      "amount": "1",
      "costcenter": null,
      "commission": "BIRSAN ANCUTA IONELA TT3388",
      "priceInfos": {
        "unit": 1,
        "priceperpu": 40.2
      }
    },
    {
      "customerid": "511187150",
      "automatid": "24855",
      "statisticid": "195062200",
      "eventdate": "2025-10-15 05:03:20",
      "automatuserid": "MAGAZZINO 2",
      "name": "MAGAZZINO 2",
      "automatloginid": "5984151",
      "fk_articlenumber": "0875033010961    1",
      "art_description": "NASTRO-VKP-3-30MM-(4-10MM)-L12M",
      "custmatno": null,
      "amount": "1",
      "costcenter": null,
      "commission": "BIRSAN ANCUTA IONELA TT3388",
      "priceInfos": {
        "unit": 1,
        "priceperpu": 47.7
      }
    },
    ...
  ]
}