Goods Receipt / Dispatch

API Description

This API allows the customer to query the GR (Goods Receipt) and Dispatch information from Tenaris. It provides tracking of material shipments and delivery confirmations.

| Operation | Description | Specification |

| GET /dispatch | Retrieve dispatch information | GET |

Dispatch Types

| Type | Description |

| DI | Direct Dispatch - Material shipped directly from mill to customer |

| ST | Stock Transfer - Material moved between Tenaris warehouses |

| RT | Return - Material returned from customer |

Environments

Static mock:

URL https://customerapi-dev.azure-api.net/public/dispatch

Sandbox:

URL https://customerapi-dev.azure-api.net/sb/dispatch

Production:

URL https://customerapi-dev.azure-api.net/dispatch

Query Parameters

| Parameter | Type | Description |

| pageSize | integer | Number of results per page (default: 10) |

| pageNumber | integer | Page number to retrieve |

| dateFrom | string | Filter dispatches from this date (YYYY-MM-DD) |

| dateTo | string | Filter dispatches to this date (YYYY-MM-DD) |

| orderId | string | Filter by order ID |

| type | string | Filter by dispatch type (DI, ST, RT) |

Test this operation

curl -X GET "https://customerapi-dev.azure-api.net/sb/dispatch?pageSize=10&pageNumber=1&dateFrom=2024-01-01" \

-H "Authorization: Bearer {access_token}"

Response:

{

"page": {"pageSize": 10, "pageNumber": 1, "pageLimit": 3, "code": 200},

"results": [

{

"id": "DSP-0001234",

"type": "DI",

"orderId": "ORD-00012345",

"dispatchDate": "2024-02-10",

"carrier": "LOGISTICS INC.",

"trackingNumber": "TRK-9876543",

"items": [

{

"product": {"id": "21336", "description": "5 1/2\" 20.00# 2.00FT.-DONASID--TXP BTC"},

"quantity": 50,

"uom": "ST"

}

],

"destination": {"id": "30004", "description": "TENARIS BAY CITY, INC."}

}

]

}

Errors

| ERROR | DESCRIPTION |

| 401 | ERROR IN TOKEN VALIDATION. There is an issue with the token used in the request. |

| 403 | USER NOT AUTHORIZED. There is an error in the credentials. |

| 404 | PAGING PARAMETERS ERROR. Bad request. |

| 500 | GENERAL ERROR. Server side error. |